首页 > 代码库 > MEF编程模型
MEF编程模型
- Contract由Contract name和Contract type组成,Contract两个参数可以省略可以implicit也可以explicit,implicit时name和type会自动推断
- 某些情况必须要指定contract name,最常见的情况是一个类export多个相同类型的成员,即使显示指定了contract name,Import和Export的contract type也要匹配
public class MyClass{ [Import("MajorRevision")] public int MajorRevision { get; set; }}public class MyExportClass{ [Export("MajorRevision")] //This one will match. public int MajorRevision = 4; [Export("MinorRevision")] public int MinorRevision = 16;}
- 通常应该对公共类或者成员声明导出和导入,其他声明也受支持,但如果导出或导入私有成员,受保护成员或者内部成员,将会损坏部件的隔离模型,因此建议不要这样做.
- 导入的类型:
- 动态导入:导入类可能需要与任何具有相同contract name的导出类匹配,此时可以使用dynamic关键字声明动态导入,contract会自动推导,如下示例代码,两个导出均与前面的导入匹配,但要注意如果这两个部件都加到了Catalog中,在执行组合时会抛异常:More than one export was found that matches the constraint:
public class MyClass{ [Import("TheString")] public dynamic MyAddin { get; set; }}[Export("TheString", typeof(IMyAddin))]public class MyLogger : IMyAddin { }[Export("TheString")]public class MyToolbar { }
- 延迟导入:导入类需要间接引用导入的对象,不会立即实例化该对象,此时可以使用Lazy<T>来声明延迟导入,Lazy关键字会使对象的创建延迟到使用时创建,如下示例代码,Lazy<IMyAddin>与IMyAddin被视为相同的contract type
public class MyClass{ [Import] public Lazy<IMyAddin> MyAddin { get; set; }}[Export(typeof(IMyAddin))]public class MyLogger : IMyAddin { }
- 必备导入:MEF容器创建部件时默认使用部件的无参构造函数,如果要使组合引擎使用其他构造函数,必须用ImportingConstructor标记此构造函数,每个部件只有一个构造函数供组合引擎使用,如果不指定默认构造函数和ImportingConstructor attribute或者提供了多个ImportingConstructor,都会产生错误.如果C#类没有任何构造函数,则会自动生成一个默认构造函数(无参),如果有其他构造函数就不会产生默认构造函数。
public class MyClass { private IMyAddin _theAddin; public MyClass() { } //This constructor will be used. //An import with contract type IMyAddin is //declared automatically. [ImportingConstructor] public MyClass(IMyAddin MyAddin) { _theAddin = MyAddin; }}
- 使用ImportingConstructor标记的构造函数的参数都会自动声明为必备导入.默认情况下会为所有参数自动推导contract type和contract name,但可以使用Import显示指定type和name:
[ImportingConstructor] public MyClass([Import(typeof(IMySubAddin))]IMyAddin MyAddin) { _theAddin = MyAddin; }
- 如果使用ImportingConstructor标记的构造函数的参数是集合类型,则导出将与集合中对象的类型匹配,此时必须使用ImportMany修饰参数
- 可选导入:默认情况下如果没有与导入匹配的导出,组合会失败,此时可以使用AllowDefault property指定导入为可选,这样组合也将成功,导入属性将被设为其属性类型的默认值
public class MyClass{ [Import(AllowDefault = true)] public Plugin thePlugin { get; set; } //If no matching export is avaliable, //thePlugin will be set to null.}
- 导入多个对象:如果要导入与多个contract匹配的导出,可以使用ImportMany attribute,用此attribute标记的导入始终是可选导入
public class MyClass{ [ImportMany] public IEnumerable<IMyAddin> MyAddin { get; set; }}
- 避免发现:为了使部件不作为目录的一部分不被发现,可以使用两种方式:
- 将部件类声明为abstract,抽象类不提供导出,即使使用Export标记了此类
- 使用PartNotDiscoverable attribute标记类,这样此部件不会被包括在任何目录中
[Export]public class DataOne{ //This part will be discovered //as normal by the catalog.}[Export]public abstract class DataTwo{ //This part will not be discovered //by the catalog.}[PartNotDiscoverable][Export]public class DataThree{ //This part will also not be discovered //by the catalog.}
- 元数据:导出提供的关于其自身的额外信息,元数据可以将导出对象的属性传递到导入部件,导入部件可以使用这些数据来决定使用哪些导出,或者只收集导出的信息而不构造导出。导入必须为延迟导入才能使用元数据
元数据视图:为了使用元数据通常会声明一个称为元数据视图的接口,该接口声明声明元数据将可用,元数据视图接口必须只有属性,并且这些属性有get访问器.通常在元数据视图中命名的所有属性都是必须的,并且不会将未提供这些属性的任何导出视为匹配。DefaultValue attribute指定属性是可选的.如果未包括属性,则将为其分配使用DefaultValue 指定的默认值//元数据视图public interface IPluginMetadata{ //元数据 string Name { get; } [DefaultValue(1)] int Version { get; }}[Export(typeof(IPlugin)), ExportMetadata("Name", "Logger"), ExportMetadata("Version", 4)]public class Logger : IPlugin{}[Export(typeof(IPlugin)), ExportMetadata("Name", "Disk Writer")] //Version is not required because of the DefaultValuepublic class DWriter : IPlugin{}public class Addin{ [Import] public Lazy<IPlugin, IPluginMetadata> plugin;}
- 许多情况下元数据与ImportMany attribute结合使用,以便分析各个可用的导入并选择实例化一个导入
public class User{ [ImportMany] public IEnumerable<Lazy<IPlugin, IPluginMetadata>> plugins; public IPlugin InstantiateLogger () { IPlugin logger = null; foreach (Lazy<IPlugin, IPluginMetadata> plugin in plugins) { if (plugin.Metadata.Name = "Logger") logger = plugin.Value; } return logger; }}
- 导入导出继承:导入始终由子类继承,而使用Export声明的导出则不会由子类继承,部件只有使用InheritedExport attribute标记自身,子类才能继承导出。InheritedExport只能作用于类级别,因此成员级别导出永远不会被继承.
如果存在于InheritedExport关联的元数据,该元数据也将被继承,子类无法修改继承的元数据,但通过使用相同contract重新声明InheritedExport,可以替换继承的元数据。注意contract必须相同否则相当于创建了一个新的导出[InheritedExport(typeof(IPlugin)), ExportMetadata("Name", "Logger"), ExportMetadata("Version", 4)]public class Logger : IPlugin{ //Exports with contract type IPlugin and //metadata "Name" and "Version".}public class SuperLogger : Logger{ //Exports with contract type IPlugin and //metadata "Name" and "Version", exactly the same //as the Logger class.}[InheritedExport(typeof(IPlugin)), ExportMetadata("Status", "Green")]public class MegaLogger : Logger { //Exports with contract type IPlugin and //metadata "Status" only. Re-declaring //the attribute replaces all metadata.}
- 自定义导出特性:通过继承Export或InheritedExport可以扩展export attribute,以包含元数据作为特性属性,自定义attribute可以指定contract type,contract name,或任何其他元数据。自定义的attribute类必须使用MetadataAttribute attribute标记,使用MetadataAttribute标记的类中的所有属性都被视为自定义attribute中定义的元数据,如果要创建可选元数据可以使用DefaultValue attribute.
[MetadataAttribute][AttributeUsage(AttributeTargets.Class, AllowMultiple=false)]public class MyAttribute : ExportAttribute{ public MyAttribute(string myMetadata) : base(typeof(IMyAddin)) { MyMetadata = myMetadata; } public string MyMetadata { get; private set; }}//隐式指定contract type和元数据[MyAttribute("theData")]public MyAddin myAddin { get; set; }
- 动态导入:导入类可能需要与任何具有相同contract name的导出类匹配,此时可以使用dynamic关键字声明动态导入,contract会自动推导,如下示例代码,两个导出均与前面的导入匹配,但要注意如果这两个部件都加到了Catalog中,在执行组合时会抛异常:More than one export was found that matches the constraint:
- 创建策略:分两种shared和non-shared,表示策略的枚举类型CreationPolicy有三个值Shared,NonShared,Any,Any会根据上下文选用适当的CreateionPolicy,默认为Shared.
- 导入和导出都可以使用CreatePolicy指定部件的创建策略
- 指定Shared或NonShared的导出将仅与指定相同值或指定Any的导入匹配
- 指定Shared或NonShared的导入将仅与指定相同值或指定Any的导出匹配
- 未指定CreationPolicy默认为Any,Any的策略默认为Shared
- 生命周期和释放:部件应该根据自身需要实现IDisposable接口,由于容器创建并维护部件的引用,所以只有容器才能调用部件的Dispose方法,容器本身也实现了IDisposable接口。容器也提供了ReleaseExport用于释放nonshared部件
IPartImportsSatisfiedNotification包含一个名为OnImportsSatisfied的方法。如果部件实现了此接口,当部件成功导入时,就会调用此方法,某些情况可以替代构造函数执行初始化操作
MEF编程模型
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。