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;
}