Autofac中文文档--一、注册组件--1注册概念
来源:互联网 发布:淘宝图片宽度 编辑:程序博客网 时间:2024/04/28 14:13
官方文档:http://docs.autofac.org/en/latest/register/registration.html
一、注册概念
使用Autofac 注册组件,通过创建一个ContainerBuilder并且告知builder 哪些组件公开哪些服务。
组件由反射(通过注册一个特殊的.net 类型或者开放的泛型)创建;通过提供现成的实例(你已创建的一个对象实例)创建;或由lambda表达式创建。ContainerBuilder有一系列的Register()方法,允许你实现以上这些设置。
通过使用ContainerBuilder中的As()方法,每个组件公开一个或多个服务。
// 创建组件/服务注册的容器var builder = new ContainerBuilder();// 注册类型公开接口builder.RegisterType<ConsoleLogger>().As<ILogger>();// 注册你创建的对象实例var output = new StringWriter();builder.RegisterInstance(output).As<TextWriter>();// 注册执行创建对象的表达式builder.Register(c => new ConfigReader("mysection")).As<IConfigReader>();// 编译容器完成注册且准备对象解析var container = builder.Build();// 现在你可以使用 Autofac 解析服务. 例如,这行将执行注册的lambda表达式对于 IConfigReader 服务.using(var scope = container.BeginLifetimeScope()){ var reader = container.Resolve<IConfigReader>();}
1、反射组件
1.1通过类型注册
var builder = new ContainerBuilder();builder.RegisterType<ConsoleLogger>();builder.RegisterType(typeof(ConfigReader));
当使用基于反射的组件,Autofac自动为你的类,匹配拥有最多参数的构造函数,此参数可以从容器中获得。
例如,你有一个拥有三个构造函数的类:
public class MyComponent{ public MyComponent() { /* ... */ } public MyComponent(ILogger logger) { /* ... */ } public MyComponent(ILogger logger, IConfigReader reader) { /* ... */ }}
现在,在你的容器中注册组件和服务:
var builder = new ContainerBuilder();builder.RegisterType<MyComponent>();builder.RegisterType<ConsoleLogger>().As<ILogger>();var container = builder.Build();using(var scope = container.BeginLifetimeScope()){ var component = container.Resolve<MyComponent>();}
当你解析你的组件时,Autofac 会发现已经注册了ILogger,但是没有注册IConfigReader。在这种情况下,第二个构造函数将会被选择,因为这是在容器中能够找到的拥有最多参数的一个构造函数。
基于反射的组件需要注意:由RegisterType注册的组件类型必须是一个具体类型。虽然组件可以公开抽象类和接口作为服务,但是你不能注册一个抽象类/接口 组件。如果你仔细想想是有道理的:在Autofac内部,Autofac创建一个你注册的对象实例。你不能new 一个抽象类或一个接口。你必须有一个实现对吧。
1.2指定一个构造函数
您可以手动选择一个特定的构造函数,来使用和覆盖注册组件自动选择的构造函数,使用UsingConstructor方法和一系列类型来表示构造函数的参数类型:
builder.RegisterType<MyComponent>() .UsingConstructor(typeof(ILogger), typeof(IConfigReader));
请注意,在解析时,您仍然需要提供必要的参数,否则,在你尝试解析对象时将出现一个错误。你可以在注册时传递参数或者在解析时传递参数。
2、实例组件
有时候,您可能希望提前生成一个对象的实例,并将它添加到容器供组件注册使用。你可以这样做,使用RegisterInstance
方法:
var output = new StringWriter();builder.RegisterInstance(output).As<TextWriter>();
当你这样做时有些事情需要考虑,Autofac自动处理注册组件的释放,还是你想要控制你的生命周期而不是Autofac为你调用Dispose在你的对象上。在这种情况下(你想控制生命周期),您需要使用ExternallyOwned方法注册实例:
var output = new StringWriter();builder.RegisterInstance(output) .As<TextWriter>() .ExternallyOwned();
当将Autofac集成到一个现有的应用程序(一个单例实例已经存在且需要在容器中作为组件使用)时,注册提供的实例也派上了用场,而不是把这些组件直接绑到单例上,它可以在容器中注册为一个实例:
builder.RegisterInstance(MySingleton.Instance).ExternallyOwned();
这将确保静态单例可以最终被淘汰,取而代之的是一个容器管理。
默认服务通过一个具体类型的实例公开。请参阅下面的“服务和组件”。
3、Lambda表达式组件
反射对于组件创建是一种非常好的默认选择。当组件创建逻辑不只是一个简单的构造函数调用时,事情将变得混乱。
Autofac 接受一个委托或者lambda表达式用于组件创建:
builder.Register(c => new A(c.Resolve<B>()));
表达式提供的参数c是组件上下文(一个IComponentContext对象) ,此处该组件被创建。您可以使用它来解析来自于容器的其他组件,从而帮助你创建组件。重要的是使用它,而不是一个闭包来访问容器,以便正确的支持内嵌容器和自定义清理。
使用上下文参数可以使用额外的依赖关系——在这个例子中,A需要参数为类型B的构造函数,可能有额外的依赖关系。
通过expression-created组件提供的默认服务是推断表达式的返回类型。
下面是一些需求的例子,通过反射组件创建非常笨拙,但是通过lambda表达式非常漂亮的处理了。
- 复杂参数
构造函数参数不能总是用简单的常量值声明。而不使用XML配置语法构造某种类型的值,使用代码:
builder.Register(c => new UserSession(DateTime.Now.AddMinutes(25)));
当然,会话到期你可能想在配置文件中指定一些事情。
- 属性注入
虽然Autofac 提供了一流的属性注入,你也可以使用表达式和属性初始化来填充特性:
builder.Register(c => new A(){ MyB = c.ResolveOptional<B>() });
这个ResolveOptional
方法将尝试解析值,但如果服务没有被注册,不会抛出一个异常。(你将得到一个异常如果服务被注册但是属性没有被解析)。这是解析服务的其中一种方式。
在大多数情况下不推荐使用属性注入。替代空对象模式,重新加载构造函数或构造函数参数的默认值,可以创造更清洁、“不变”的组件,可使用构造函数注入依赖项。
- 通过参数值选择一个实现(Selection of an Implementation by Parameter Value)
分离组件创建最大的好处就是具体类型可以变化,这通常是在运行是完成,而不仅仅是在配置时:
builder.Register<CreditCard>( (c, p) => { var accountId = p.Named<string>("accountId"); if (accountId.StartsWith("9")) { return new GoldCard(accountId); } else { return new StandardCard(accountId); } });
在这个例子中,CreditCard
通过两个类实现,GoldCard
and StandardCard
哪个类被实例化依赖于运行时提供的accountId。
在这个例子中,创建方法通过第二个参数p提供参数。
使用下面代码进行注册:
var card = container.Resolve<CreditCard>(new NamedParameter("accountId", "12345"));
如果使用委托创建CreditCard
实例声明和一个委托工厂,可以获得一个清洁,类型安全的语法。
4、公开通用组件(Open Generic Components)
Autofac 支持开放的泛型类型,使用RegisterGeneric()构造方法:
builder.RegisterGeneric(typeof(NHibernateRepository<>)) .As(typeof(IRepository<>)) .InstancePerLifetimeScope();
当容器需要一个匹配的服务类型时,autofac 将会映射到一个等价的接近的实现类型的版本。
// Autofac will return an NHibernateRepository<Task>var tasks = container.Resolve<IRepository<Task>>();
注册的专有服务类型(例如IRepository <Person>)将会重写通用的版本。
5、服务和组件(Services vs. Components)
当你注册组件时,必须告诉autofac组件公开哪个服务,默认,大多数注册仅仅公开自己作为注册类型。
// This exposes the service "CallLogger"builder.RegisterType<CallLogger>();
组件只能被它们公开的服务解析,在这个简单的示例中,它意味着:
// 这个将会正常工作,因为组件默认公开此类型scope.Resolve<CallLogger>();// 这个不会工作,因为我们没有注册也没有公开ILogger接口scope.Resolve<ILogger>();
你可以用任意数量的服务公开组件。
builder.RegisterType<CallLogger>() .As<ILogger>() .As<ICallInterceptor>();
一旦公开一个服务,可以解析基于服务的组件。但是请注意,一旦你公开一个组件作为一个特定的服务,默认的服务(组件类型)将被覆盖:
// 这些都将工作,因为我们在注册中公开了对应的服务scope.Resolve<ILogger>();scope.Resolve<ICallInterceptor>();// 这个将不再工作,因为我们制定了一个特殊的服务重写了组件scope.Resolve<CallLogger>();
如果你想将一个组件公开为一组服务以及使用默认服务,可以使用AsSelf方法:
builder.RegisterType<CallLogger>() .AsSelf() .As<ILogger>() .As<ICallInterceptor>();
现在,所有这些都将正常工作:
// These will all work because we exposed// the appropriate services in the registration:scope.Resolve<ILogger>();scope.Resolve<ICallInterceptor>();scope.Resolve<CallLogger>();
6、默认注册(Default Registrations)
如果多个组件公开同一个服务,autofac将使用最后注册的组件作为默认的服务提供者:
builder.Register<ConsoleLogger>().As<ILogger>();builder.Register<FileLogger>().As<ILogger>();
在这种情况下FileLogger将作为默认的ILogger服务提供者,因为它是最后注册的。
为了推翻这种情况,可以使用 PreserveExistingDefaults()
方法修改:
builder.Register<ConsoleLogger>().As<ILogger>();builder.Register<FileLogger>().As<ILogger>().PreserveExistingDefaults();
这种情况下,ConsoleLogger将作为默认的ILogger服务提供者,因为最后注册的FileLogger使用了PreserveExistingDefaults()。
7、注册配置(Configuration of Registrations)
可以使用XML或编程配置“modules”来提供一组注册或者在运行时改变注册。也可以使用Autofac modules提供一些动态注册生成或条件注册逻辑。
8、提供动态注册(Dynamically-Provided Registrations)
- Autofac中文文档--一、注册组件--1注册概念
- Autofac中文文档--一、注册组件--2传递注册参数
- Autofac中文文档--一、注册组件--4组件扫描
- Autofac官方文档(三)【注册组件之注册概念】
- Autofac中文文档--一、注册组件--3属性和方法注入
- Autofac官方文档(六)【注册组件之程序集扫描】
- Autofac官方文档(四)【注册组件之将参数传递给注册者】
- Autofac官方文档翻译——(二)组件注册(未完)
- Autofac官方文档(五)【注册组件之属性和方法注入】
- 【.Net码农】【MVC】Ioc容器Autofac系列(3)-- 三种注册组件的方式
- 注册组件
- ATL组件中文路径注册问题 (转)
- ATL组件中文路径注册问题辨析
- 【反射】——Autofac 类型注册
- Autofac中文文档--二、解析服务--1解析参数传递
- Autofac官方文档(一)【开始】
- vue组件1-全局注册
- 如何让com组件能注册到中文目录下
- 升级Win10系统后使用其杀软defender还有必要使用360安全卫士等其他杀毒软件吗?
- 2017京东在线笔试编程题之 买东西
- sql实现单表分类显示
- MySQL修改root密码的方法整理
- 快速排序
- Autofac中文文档--一、注册组件--1注册概念
- codeforces Round#369 div2-E ZS and The Birthday Paradox(逆元,组合)★
- 使用select函数提高服务器的处理能力——服务器端代码
- java中try、catch、finally返回语句执行顺序
- Tomcat7源码环境搭建
- 《GeekBand》STL与泛型编程03
- qt之QImage
- Android获取应用详情页系统通知状态
- H2数据库使用