本文是一个技巧文章,内容很短,但是被提问的频率很高,所以记录下来,以待大家不时之需。
以下的代码,是通过原生的依赖注入来讲解的,其他的第三方框架,可以自己自定义扩展,效果是一样的,那咱们先来回顾下依赖注入,都有哪几种情况。
一、依赖注入有哪几种情况
关于依赖注入,其实我已经写了很多的文章,也录了很多的视频了,这里就不过多的解析什么了,无论是原理,还是好处,甚至是使用场景等等,如果你还不是很了解,可以看看我的视频。
https://www.bilibili.com/video/av58096866?p=5
https://www.bilibili.com/video/av73194514
上边的这个是基础和核心知识点,下边的是我直播的时候,手写的代码,可以根据自己的需要去查看。
总体来说,我一直讲的依赖注入的方式,都是面向抽象的 很常见的:一个类对应一个接口。那还有其他的注入情况么?当然还有很多,比如:
1、单独的一个类注入;
2、一个类继承了多个接口;
3、一个接口有多个实现类;
当然,除了上边这三个,还有单独类的 AOP 操作等等,一个类对应一个接口的情况,我们已经说了很多了,这里就不说了,一个类多个接口的,这个也不用说,其实就和一个类对应一个接口,是一个效果,那我们就先说说注入单独的一个类和,一个接口对应多个实现,这两种情况吧。
单独注入一个类很简单,大家都知道,依赖注入,其实就是实例化的过程,然后管理我们的对象的生命周期,降低耦合等等多个好处。
那我们既然是实例化的过程,简单啊,放到容器,直接使用它!
/// <summary> /// 1、定义一个单独类,不继承任何 /// </summary> public class OneSeparateService { /// <summary> /// 写一个方法,可以通过类型返回不同内容 /// </summary> /// <param name="type"></param> /// <returns></returns> public string SayHello(string type="") {
if (type == "English") { return "Hello"; } else { return "你好"; } } }
// 2、注入容器services.AddScoped<OneSeparateService>();
/// <summary>/// 3、构造函数注入/// </summary>/// <param name="oneSeparateService"></param>public WeatherForecastController(OneSeparateService oneSeparateService){ _oneSeparateService = oneSeparateService;}
// 4、调用 [HttpGet] public object Get() { // 依赖注入,就等于下边的直接new一个实例 //OneSeparateService oneSeparateService = new OneSeparateService(); return oneSeparateService.SayHello("English"); }我们只需要直接构造函数注入,即可使用,有种静态方法的意味,是不是很简单!当然很简单啦,因为今天我们不是说这个的,说这个仅仅是一个开胃菜,体会一下注入的过程而已。
好啦,热身完成,下面,我们就详细的说说如何实现一个接口多个实现类吧。
二、如何注入一对多
既然说到了一对多,那现在我们就来模式一下数据:
/// <summary> /// 1、定义一个接口 /// </summary> public interface IMoreImplService { string SayWelocome(); } /// <summary> /// 2、分别定义两个实现类 /// </summary> public class WelcomeChineseService : IMoreImplService { public string SayWelocome() { return "欢迎"; } }
public class WelcomeEnglishService : IMoreImplService { public string SayWelocome() { return "Welcome"; } }然后我们准备好了,该注入了,你可能会说,简单呀!直接注入然后调用不就好了:
services.AddScoped<IMoreImplService, WelcomeChineseService>();services.AddScoped<IMoreImplService, WelcomeEnglishService>();然后直接调用
public WeatherForecastController(IMoreImplService moreImplService) { _moreImplService = moreImplService; }
[HttpGet] public object Get() { return _moreImplService.SayWelocome(); }这个时候,是不是有点儿懵,嗯?那我现在到底调用的是哪个实现类呀,我们运行看看效果就知道了:
可以看到是 Welcome ,正好和我们的注入顺序是一致的,就是说,无论注入多少个,最终是最后一个生效,就好像 = new () 了好几次,把之前的实例给覆盖了一样,你应该懂了吧,不信的话,可以把注入的顺序换换,就知道啦。
请记住,刚刚我用的是 好像 字眼,真的是被覆盖掉了么,我们来看看就知道了,既然是注入了多个,我们就把多个实例都拿出来:
/// <summary> /// 1、将多个接口实例关系全部注入 /// </summary> /// <param name="moreImplServices"></param> public WeatherForecastController(IEnumerable<IMoreImplService> moreImplServices) { // 注意这里是复数 _moreImplServices = moreImplServices; }
[HttpGet] public object Get() { var result = ""; // 调用多次输出 foreach (var item in _moreImplServices) { result += item.SayWelocome() + "\n"; }
return result; }详细这个时候,你应该猜得出来答案了吧:
把两个实例都打印了出来,这就说明一个问题,我们在容器里,并不是在注入的时候,后来的把前边的给覆盖掉了,而是 本来容器里就有多个接口实例映射关系 ,只是我们在 controller 控制器里取的时候,只获取了最后一个而已!
那明白了这个问题,我们就很开心了,容器里还是都有的,我们还是可以按照我们的需要,取出想要的某一个,那我们就猜想了,如何区分呢,在文章开头,我们定义方法的时候,就是想着用一个 type ,那这里我们能不能用一个别名来做区分呢,欸,重头戏来了:
/// <summary> /// 定义一个服务工厂,Singleton注入 /// 注意这个不是真正意义上的工厂,只是提供服务的存取 /// </summary> public class SingletonFactory { // 定义一个字典,存储我们的接口服务和别名 Dictionary<Type, Dictionary<string, object>> serviceDict; public SingletonFactory() { serviceDict = new Dictionary<Type, Dictionary<string, object>>(); }
/// <summary> /// 根据别名,获取接口实例 /// </summary> /// <typeparam name="TService"></typeparam> /// <param name="id"></param> /// <returns></returns> public TService GetService<TService>(string id) where TService : class { // 获取接口的类型 var serviceType = typeof(TService); // out 方法,先获取某一个接口下的,<别名,实例>字典 if (serviceDict.TryGetValue(serviceType, out Dictionary<string, object> implDict)) { // 根据别名,获取接口的实例对象 if (implDict.TryGetValue(id, out object service)) { // 强类型转换 return service as TService; } } return null; }
/// <summary> /// 将实例和别名 匹配存储 /// </summary> /// <typeparam name="TService"></typeparam> /// <param name="service"></param> /// <param name="id"></param> public void AddService<TService>(TService service, string id) where TService : class { var serviceType = typeof(TService); // 对象实例判空 if (service != null) { // 如果不存在,则填充 if (serviceDict.TryGetValue(serviceType, out Dictionary<string, object> implDict)) { implDict[id] = service; } else { implDict = new Dictionary<string, object>(); implDict[id] = service; serviceDict[serviceType] = implDict; } } } }上边的代码相信应该能大致看的明白,看不明白也没关系,主要一句话概括,就是使用了一个服务,维护一个字典,利用泛型,先把对象实例和别名,分配存储到字典,然后再根据别名或者指定接口的对象实例,
就是把接口下的实现类,都 new 出来实例,然后匹配上别名,说白了,就是我们的 type,然后再输出出来。
那下一步,我们就需要先把这个单例服务给注入进去:
SingletonFactory singletonFactory = new SingletonFactory(); singletonFactory.AddService<IMoreImplService>(new WelcomeChineseService(), "Chinese"); singletonFactory.AddService<IMoreImplService>(new WelcomeEnglishService(), "English");
services.AddSingleton(singletonFactory);这个应该都能看的懂,唯一的小问题,可能会问,为啥要把我们的 singletonFactory 给 Singleton 注入?
因为我这是一个对象实例,只能是单例了,而且里边的多个服务因为已经new实例过了,所以没办法控制生命周期。
最后我们就来调用看看:
// 各自定义需要的多个字段private readonly IMoreImplService moreImplServiceChinese;private readonly IMoreImplService moreImplServiceEnglish;
public WeatherForecastController(SingletonFactory singletonFactory){ this.singletonFactory = singletonFactory;
// 根据别名获取服务 moreImplServiceChinese = singletonFactory.GetService<IMoreImplService>("Chinese"); moreImplServiceEnglish = singletonFactory.GetService<IMoreImplService>("English");}
[HttpGet("/welcome")]public object GetWelcome(){ return moreImplServiceChinese.SayWelocome();}结果我们不用看了,已经成功了,最后我们再来回顾一下这种写法的步骤:
1、定义一个单例服务类,将我们的多个对象new出来实例,和别名对应存储起来;
2、将单例类实例化后,注入服务容器;
3、控制器获取单例类,并根据别名获取相对应的服务;
到了这里,我们就已经完成了,是不是到了这里,感觉是已经完成了,但是又感觉哪里不是很舒服,比如这样注入的实例都是单例的,那这样不是很合适呀?
三、简单工厂模式注入【推荐】
如何才能适应不同的生命周期呢,我这里提供第二个方法:
// 先把多个实现类服务注入进去 services.AddScoped<WelcomeChineseService>(); services.AddScoped<WelcomeEnglishService>();
// 然后通过简单工厂模式,针对不同的 key 来获取指定的对象实例 services.AddScoped(factory => { Func<string, IMoreImplService> accesor = key => { if (key.Equals("Chinese")) { // 因为这里是从容器获取服务实例的,所以我们可以控制生命周期 return factory.GetService<WelcomeChineseService>(); } else if (key.Equals("English")) { return factory.GetService<WelcomeEnglishService>(); } else { throw new ArgumentException($"Not Support key : {key}"); } }; return accesor; });大家可以看一下,我们用的是 Scope 方式注入的,三种生命周期都可以,接下看就是调用了:
// 将我们的规则 Func 构造函数注入 private readonly Func<string, IMoreImplService> _serviceAccessor;
public WeatherForecastController(Func<string, IMoreImplService> serviceAccessor) { // 获取特定接口的服务访问器,然后根据别名获取 _serviceAccessor = serviceAccessor; // 这里的别名,你可以配置到 appsetting.json 文件里,动态的修改获取对象实例 // 然后再在接口中配置一个字段 string ImplementKeyName { get; } moreImplServiceChinese = _serviceAccessor("Chinese"); moreImplServiceEnglish = _serviceAccessor("English"); }
[HttpGet("/welcome")] public object GetWelcome() { return moreImplServiceChinese.SayWelocome() + "\n" + moreImplServiceEnglish.SayWelocome(); }为了演示效果,我把Service服务的构造函数,增加一个动态时间,来判断是否满足Scope需求,那现在我们就来看看效果吧:
public class WelcomeChineseService : IMoreImplService { public DateTime Now { get; set; } public WelcomeChineseService() { Now = DateTime.Now; } public string SayWelocome() { return "欢迎" + Now; } }好啦,最后我们来总结一下这个方法的优点:
1、可以实现一个接口对应多个实现类的注入和获取;
2、实例别名可以配置到 appsettings.json 里,动态获取指定服务;
3、可以指定生命周期;
4、更直观,更简单;
虽然这种简单工厂的写法,还是不够优雅,但是毕竟这种一个接口多个实现类的方法本身就不是很优雅,好啦,今天就分享到这里吧。