Solon Ioc 的魔法之注解注入器（也可叫虚空注入器）

很多人惊叹于 Solon 的注入能力，一个注解怎可注万物？？？

一、注解注入器

Solon Ioc 的四大魔法之一：注解注入器（BeanInjector<T extends Annotation>）。在扫描时，Solon 会检查相关组件的字段或者参数，上面有没有注解？如果有注解，有没有对应的注入器注册过？如果有，则执行注入器。

1、什么是注解？

注解一般也叫元数据，是一种代码级别的说明性内容。编译器在编译时，可以借助注解产生很多魔法效果；Solon Ioc 在运行时，也借助注解产生了很多魔法效果。

其中，注解注入器便是 Solon Ioc 的四大魔法之一。

2、注入器接口是怎么样的？

@FunctionalInterface public interface BeanInjector<T extends Annotation> {     void doInject(VarHolder vh, T anno); } 

其中：

• vh，用于接收变量数据
• anno，则是申明的注解

3、Solon Ioc 的注入器注册接口

void beanInjectorAdd(Class<T> annoClz, BeanInjector<T> injector); void beanInjectorAdd(Class<T> annoClz, Class<?> targetClz, BeanInjector<T> injector); 

二、为什么也可叫“虚空”注入器？

这个是因为，Solon 的注入是执行一个接口，而不是即定的内容。内容，可以是现成的，也可以是动态构建的。所以很“虚空”。

1、分解内置的的 @Inject 注解实现

@Inject 的简单使用示例

//主入配置 @Component public class DemoService{     @Inject("${track.url}")     String trackUrl;          @Inject("${track.db1}")     HikariDataSource trackDs; }  //注入 bean @Component public class DemoService{     @Inject     private static TrackService trackService;           @Inject("userService")     private UserService userService; } 

注入器的能力实现剖析（简单的示意实现，框架的实现比这个复杂）

context.beanInjectorAdd(Inject.class, (vh, anno) -> {     //申明：是否必须要注入?     vh.required(anno.required());          if (Utils.isEmpty(anno.value)) {         //没有值，说明是 bean type 注入         vh.content().getBeanAsync(vh.type(), bean->{ //vh.content() 即 context。在“热插拨”时可能会不同             vh.setValue(bean);         });     } else {         if(anno.value().startsWith("${")) {             //说明是配置注入             String val = vh.content().cfg().getByExpr(anno.value());             vh.setValue(val);         } else {             //说明是 bean name 注入             vh.content().getBeanAsync(anno.value(), bean->{                 vh.setValue(bean);             });         }     } }); 

2、“类型增强”注入器。魔法的升级！

Solon 内置的注入器，你不喜欢？

想换掉实现行不行？行！完全换掉代码太多，想为特定的类型增加注入行不行？也行！比如，我们设计了一个 EsMapper<T> 用于操作 Elasticsearch。然后可以自由的扩展：

public interface AuthorMapper extends EsMapper<Author> { } public interface CommentMapper extends EsMapper<Comment> { } public interface ContactMapper extends EsMapper<Contact> { } public interface DocumentMapper extends EsMapper<Document> { } 

估计还会想扩展更多的子类？“类型增强” 注入器在手，一切我有。

EsMapperFactory  esMapperFactory;  context.beanInjectorAdd(Inject.class, EsMapper.class, (vh, anno) -> {     EsMapper mapper = esMapperFactory.create(vh.getType());     vh.setValue(mapper); }); 

可以再借用容器的“缓存”特性，同类型的注入性能就提高了：

EsMapperFactory  esMapperFactory;  context.beanInjectorAdd(Inject.class, EsMapper.class, (vh, anno) -> {     EsMapper mapper = vh.context().getBean(vh.getType());     if (mapper == null) {         mapper = esMapperFactory.create(vh.type());                  vh.context().wrapAndPut(mapper.getClass(), bean); //有可能被代理了，类型与 vh.getType() 不同         vh.context().wrapAndPut(vh.getType(), bean);     }     vh.setValue(mapper); }); 

如果有“多源”的概念，我们还可以支持 @Inject("name")：

EsMapperFactory  esMapperFactory;  context.beanInjectorAdd(Inject.class, EsMapper.class, (vh, anno) -> {     EsMapper mapper = null;     if (Utils.isEmpty(anno.value)) {         //按类型取         mapper = vh.context().getBean(vh.getType());     } else {         //按名字取         mapper = vh.context().getBean(anno.value());     }          if (mapper == null) {         mapper = esMapperFactory.create(anno.value(), vh.type());                  if (Utils.isEmpty(anno.value)) {             //按类注型注入；就按类型缓存             vh.context().wrapAndPut(mapper.getClass(), bean); //有可能被代理了，类型与 vh.getType() 不同             vh.context().wrapAndPut(vh.getType(), bean);         } else {             //按类名字注入；就按名字缓存             vh.context().wrapAndPut(anno.value(), bean);         }     }     vh.setValue(mapper); }); 

现在我们可以用了（吃饭喽，下班喽！）：

//主入配置 @Component public class DemoService{     @Inject     DocumentMapper documentMapper;          @Inject("es2")     DocumentMapper documentMapper2; }