IoC - Castle Windsor 2.1
找过一些Windsor教程的文章,博客园上TerryLee有写了不少,以及codeproject等也有一些例子,但都讲的不太明了。今天看到Alex Henderson写的一个系列,非常简单明了。下面是主要的内容
Part 1 - Simple configuration
Part 2 - Array Configuration
Part 3 - Dictionary configuration
Part 4 - Switching configurations
Part 5 - Configuration parameters
Part 6 - Switching between lifestyles
Part 7 - Switching implementations
Part 8 - Referencing implementations by key
Part 9 - Constructor Injection
Part 10 - Setter Injection
Part 11 - Factories
Part 12 - Decorators
Part 13 - Injecting Service Arrays
Part 14 - Startable Facility
基本示例
项目要引用Castle.Core.dll、Castle.MicroKernel.dll、Castle.Windsor.dll,引用namespace:
using Castle.Windsor;
using Castle.Windsor.Configuration.Interpreters;
假设有一个服务类TaxCalculator,用来计算税额:
配置
如果在Windsor容器创建对象实例时,需要注入的属性为数组,而不是上面Rate这样的单个值,怎么配置?
假如要注入的属性为:
假如,现在通过Windsor配置的服务类比较多,我建立了2份配置,一份用于测试,一份用于生产环境,如何方便的在这2份配置之间切换呢?可以在配置文件中使用include实现, 示例如下:
另外可以在配置文件中定义属性,然后在其他地方引用这些属性,例如定义属性:
生命周期 Lifestyle, Lifecycle
Windsor容器中的对象其生命周期有以下几种方式:
Singleton: 单例模式
Transient: 临时对象模式,每次都创建一个新对象返回给请求者
PerThread: 在当前执行线程上为单例模式
Pooled: 用一个对象池管理请求对象,从对象池中返回对象实例
Custom: 实现Castle.MicroKernel.Lifestyle.ILifestyleManager或从Castle.MicroKernel.Lifestyle.AbstractLifestyleManager继承,实现自定义的对象生命周期管理
默认情况下,组件的生命周期为单例模式,可以通过配置文件进行设置:
Windsor支持Castle.Core.IInitializable和System.IDisposable接口,如果类实现了IInitializable接口,容器在创建对象实例之后会执行接口的Initialize方法;如果类实现了IDisposable接口,则在销毁对象的时候会执行Dispose方法
构造器注入
前面示例我们用的都是setter注入,下面示例使用构造器注入
有一个用于字符串编码的接口,该接口有2个实现:
使用的代码如下:
我们自己写的类完全由我们自己控制,因此我们可以让他们能够通过Windsor容器管理,但对于某些第三方提供的服务程序,可能构造函数存在额外的依赖性,使得我们无法通过配置直接使用Windsor容器来管理,这种情况下可以使用Windsor的Factory Facilities实现一个工厂,告诉Windsor使用我们的工厂来创建特定的服务对象实例
比如我们实现了下面这样一个工厂类,用来创建一个ISmsService服务对象:
Part 1 - Simple configuration
Part 2 - Array Configuration
Part 3 - Dictionary configuration
Part 4 - Switching configurations
Part 5 - Configuration parameters
Part 6 - Switching between lifestyles
Part 7 - Switching implementations
Part 8 - Referencing implementations by key
Part 9 - Constructor Injection
Part 10 - Setter Injection
Part 11 - Factories
Part 12 - Decorators
Part 13 - Injecting Service Arrays
Part 14 - Startable Facility
基本示例
项目要引用Castle.Core.dll、Castle.MicroKernel.dll、Castle.Windsor.dll,引用namespace:
using Castle.Windsor;
using Castle.Windsor.Configuration.Interpreters;
假设有一个服务类TaxCalculator,用来计算税额:
public class TaxCalculator { private decimal _rate = 0.125M; public decimal Rate { set { _rate = value; } get { return _rate; } } public decimal CalculateTax(decimal gross) { return Math.Round(_rate * gross, 2); } }计算税额时的代码如下:
WindsorContainer container = new WindsorContainer(new XmlInterpreter()); TaxCalculator calculator = container.Resolveapp.config中的配置如下:(); decimal gross = 100; decimal tax = calculator.CalculateTax(gross); Console.WriteLine("Gross: {0}, Tax: {1}", gross, tax); Console.ReadKey();
运行程序,计算结果为12.5。可以在配置文件中为Rate属性指定其他值,例如:
上面的配置指定税率为0.25,因此计算结果为250.25
配置
如果在Windsor容器创建对象实例时,需要注入的属性为数组,而不是上面Rate这样的单个值,怎么配置?
假如要注入的属性为:
public DateTime[] Holidays { get { return _holidays; } set { _holidays = value; } }则可以如下配置:
如果要注入的属性为Dictionary类型,例如:- 2007-12-24
- 2007-12-25
- 2008-1-1
public Dictionary配置如下:Aliases { get { return _aliases; } set { _aliases = value; } }
注入的数组、Dictionary属性,我们都不需要初始化创建这个对象,Windsor在注入的时候会新建数组或者Dictionary对象设置给相应属性duck broke code
假如,现在通过Windsor配置的服务类比较多,我建立了2份配置,一份用于测试,一份用于生产环境,如何方便的在这2份配置之间切换呢?可以在配置文件中使用include实现, 示例如下:
include甚至可以包含assembly中的resource(嵌入assembly中的文件)
另外可以在配置文件中定义属性,然后在其他地方引用这些属性,例如定义属性:
使用属性:Live
我们可以针对同一个服务配置多个实现方式,使用id获取各个实现方式的对象实例:#{myProperty}
然后使用配置中的id来获取实例对象:file1.txt file2.txt
WindsorContainer container = new WindsorContainer(new XmlInterpreter()); FileReader defaultReader = container.Resolve我们可以使用container.Kernel.HasComponent(string key)方法在代码中判断特定的key是否有注册了服务(); FileReader file1Reader = container.Resolve ("reader.file1"); FileReader file2Reader = container.Resolve ("reader.file2");
生命周期 Lifestyle, Lifecycle
Windsor容器中的对象其生命周期有以下几种方式:
Singleton: 单例模式
Transient: 临时对象模式,每次都创建一个新对象返回给请求者
PerThread: 在当前执行线程上为单例模式
Pooled: 用一个对象池管理请求对象,从对象池中返回对象实例
Custom: 实现Castle.MicroKernel.Lifestyle.ILifestyleManager或从Castle.MicroKernel.Lifestyle.AbstractLifestyleManager继承,实现自定义的对象生命周期管理
默认情况下,组件的生命周期为单例模式,可以通过配置文件进行设置:
也可以给class添加上[Castle.Core.Transient]、[Castle.Core.PerThread]等属性来设置组件的生命周期,从而忽略配置文件中的设置
Windsor支持Castle.Core.IInitializable和System.IDisposable接口,如果类实现了IInitializable接口,容器在创建对象实例之后会执行接口的Initialize方法;如果类实现了IDisposable接口,则在销毁对象的时候会执行Dispose方法
构造器注入
前面示例我们用的都是setter注入,下面示例使用构造器注入
有一个用于字符串编码的接口,该接口有2个实现:
public interface IEncoder { string Encode(string source); } public class NullEncoder : IEncoder { public string Encode(string source) { return source; } } public class SillyEncoder : IEncoder { private char[] _mixedUp = "YACBDFEGIHJLKMONPRSQTUWVXZ".ToCharArray();然后有一个发送消息的类,其构造函数要求一个IEncode对象:
public string Encode(string source) { string upperSource = source.ToUpper(); char[] encoded = new char[source.Length]; for (int i = 0; i < encoded.Length; i++) { encoded[i] = MapCharacter(upperSource[i]); } return new string(encoded); }
private char MapCharacter(char ch) { if ((ch >= 'A') && (ch <= 'Z')) { return _mixedUp[ch - 'A']; } return ch; } }
public class MessageSender { private readonly IEncoder _encoder; private readonly string _from; public MessageSender(string from, IEncoder encoder) { _from = from; _encoder = encoder; } public void SendMessage(string to, string body) { Console.WriteLine("to: {0}\r\nfrom: {1}\r\n\r\n{2}", to, _from, _encoder.Encode(body)); } }使用Windsor可以实现:Windsor自动创建一个IEncoder对象提供给MessageSender的构造函数;在配置文件中需要指定from参数的值,否则Windsor将抛出异常无法创 建MessageSender对象
使用的代码如下:
WindsorContainer container = new WindsorContainer(new XmlInterpreter()); MessageSender sender = container.Resolve配置如下:(); sender.SendMessage("hammet", "castle is great!"); Console.ReadKey();
上面我们有2个IEncoder的实现,我们可以在配置文件中为MessageSender的构造函数指定使用哪一个实现类:MessageSender [email protected]
Factory FacilitiesMessageSender [email protected] ${encoder.null}
我们自己写的类完全由我们自己控制,因此我们可以让他们能够通过Windsor容器管理,但对于某些第三方提供的服务程序,可能构造函数存在额外的依赖性,使得我们无法通过配置直接使用Windsor容器来管理,这种情况下可以使用Windsor的Factory Facilities实现一个工厂,告诉Windsor使用我们的工厂来创建特定的服务对象实例
比如我们实现了下面这样一个工厂类,用来创建一个ISmsService服务对象:
public class SmsServiceFactory { private string _userName; private string _password; private int _retryAttempts = 3;然后我们使用下面的配置,通过Windsor Factory Facilities指定我们所使用的工厂类:
public SmsServiceFactory(string userName, string password) { _userName = userName; _password = password; } public int RetryAttempts { get { return _retryAttempts; } set { _retryAttempts = value; } }
public ISmsService CreateService() { SmsService service = new SmsService(); SmsService.SmsConfig config = new SmsService.SmsConfig(); config.SetCredentials(_userName, _password); config.RetryAttempts = _retryAttempts; service.SetConfig(config); return service; } }
使用的代码跟其他示例一样:joe secret
WindsorContainer container = new WindsorContainer(new XmlInterpreter()); ISmsService smsService = container.Resolve(); smsService.SendMessage("+465556555", "testing testing...1.2.3");