Solon —— 容器

说明

Solon 的核心概念有 IoC、AOP 和本地事件总线。有人常常有误解以为 IoC 和 AOP 是 Spring 提出的，其实这两种思想在Spring 之前就已经有了，但 Spring 把这两个思想在技术上落地和推广做得很好，让 Ioc 和 AOP 广为人知。

核心概念

IoC

Ioc 的全称是 Inversion of Control，是控制反转或者反转控制的意思。它是一种思想，主要解决的是对象创建和管理的问题，用于解耦依赖。Ioc有时也被称为 DI （Dependency Injection），依赖注入。在使用 IoC 的过程中，我们是通过容器来创建和管理对象的，我们也是从容器中获取对象，所以，有时我们会听到 IoC 就是容器的说法，可能只是简化的一种说法。

AOP

AOP， 全称 Aspect Oriented Programming，是面向切面编程。AOP 的目的是将横切关注点（如日志记录、事务管理、权限控制、接口限流、接口幂等等）从核心业务逻辑中分离出来，通过动态代理、字节码操作等技术，实现代码的复用和解耦，提高代码的可维护性和可扩展性。其中涉及的核心有代理，切点，切面。

本地事件总线

本地事件总线是 Solon 在应用生命周期提供的扩展机制，应用可以根据需要的事件时机点，订阅响应的事件。本地事件总线支持自定义的事件。

注意：

1. 本地事件总线是基于应用生命周期的（应用的启停，插件的启停，bean 创建等），而不是基于业务，如果是涉及业务，可以使用使用作者的另一个作品 DamiBus。
2. 要在事件发生前订阅事件，否则会错过时机，无法接收到事件消息。

应用生命周期

应用生命周期，是应用程序从 启动到最后停止的整个过程。应用生命周期当中存在一些关键点，可称为时机点。

SolonApp 的应用生命周期如下图所示，其中时机点包括有：一个初始化函数时机点 + 六个应用事件时机点 + 三个插件生命时机点 + 两个容器生命时机点。

作者的这张图画的很细致，一步步的把这个图走完，能加深对 Solon 的理解。

一个初始化函数时机点

应用开发时可扩展的时机。

@SolonMain
public class App {
    public static void main(String[] args) {
        Solon.start(App.class, args, (app) -> {
            //应用初始化时机点
        });
    } 
}

六个应用事件时机点

应用开发时可扩展的时机。

事件	说明	备注
6.AppInitEndEvent	应用初始化完成事件	只支持手动订阅
8.AppPluginLoadEndEvent	应用插件加载完成事件	只支持手动订阅
b.AppBeanLoadEndEvent	应用Bean加载完成事件（即扫描完成）
e.AppLoadEndEvent	应用加载完成事件（即启动完成）
	::运行
g.AppPrestopEndEvent	应用预停止事件
j.AppStopEndEvent	应用停止事件

三个插件生命时机点

插件开发时可扩展的时机。

接口	执行时机	说明
7.start	在应用初始化完成后执行	启动
f.prestop	在 ::stop 前执行	预停止
h.stop	在 Solon::stop 时执行	停止（启用安全停止时，prestop 后等几秒再执行 stop）

两个容器生命时机点

Solon 内部的时机点，应用开发不可扩展。

接口	执行时机	说明
d.start	在扫描完成之后执行	启动
i.stop	在 Solon::stop 时执行，在插件（h.stop）后执行	停止

Bean 生命周期

被容器托管的 Bean，它的生命周期只限定在容器内部。

::new()

就是调用构造函数，是在 Bean 被扫描时，且符合条件才会执行。

注意，这个时候，Bean 还注册到容器中，还不能使用注入的字段（还未注入）。如果要初始化，推荐使用@Init 函数。

@Inject

开始执行注入。之后就会注册到容器，并通知订阅者。

start() 或 @Init

执行初始化动作，在 AppContext::start() 开始处被执行。如果使用 start() 需要实现 LifecycleBean 接口。此时 Bean 扫描已完成，理论上所有的 Bean 都已进入容器（某些特殊的 Bean 是在 AppContext.start() 时才生产的），并且所有 Bean 的字段都已完成注入。

postStart()

开始之后，AppContext::start() 结束处被执行，一般用于启动一些任务。如果使用 postStart() 需要实现 LifecycleBean 接口。

preStop()

预停止，AppContext::preStop() 时被执行。一般用来做分布式服务注销之类。如果使用 preStop() 需要实现 LifecycleBean 接口。

stop() 或 @Destroy

停止，AppContext::stop() 时被执行。一般用来做安全停止。如果使用 stop() 需要实现 LifecycleBean 接口。

容器应用

在 Solon 中，我们可以自由的选择用注解的方式，还是手动的方式来实现想要的功能。但在这里我们主要讲解注解的使用方式。

扫描

扫描一般是深度遍历指定“包名”下的 .class 文件获取类名，再通过类名从类加载器里获取元信息。

默认情况下，主类所在包名新的类都会扫描。如果需要修改导入的范围可以使用 @Import 注解，增加扫描的包名，或者导入需要的类名。

构建 / 注入

在 Solon 中，我们通过Singleton，Configuration，Bean，Component，Controller，Remoting等方式产生Bean，在Bean 对象中，我们可以 @Inject 注解注入字段。在构建和注入中需要注意的可能是条件构建和依赖注入的部分了。

注解	说明
@Inject *	注入托管对象（by type）
@Inject(“name”)	注入托管对象（by name）
@Inject(“${name}”)	注入配置（可由基础类型或结构体接收）
@Singleton	单例申明（Solon 默认是单例）
@Singleton(false)	非单例
@Configuration	托管配置组件类（与 @Inject, @Bean 共同完成初始化配置、构建托管对象等）
@Bean	配置托管对象（作用在 @Configuration 类的函数上，才有效）
@Component	托管组件（支持自动代理，v2.5.2 开始支持自动代理）
@Controller	控制器组件类（支持函数拦截）
@Remoting	远程控制器类（有类代理；即RPC服务端）

条件构建

条件构建的意思是满足了指定条件才会构建。通过使用 @Condition 来实现，它包含如下的属性：

属性	说明
onClass	有类（只能一个；其实没必要多个）
onClassName	有类名
onProperty	有属性
onMissingBean	没有 Bean
onMissingBeanName	没有 Bean Name
onBean	有 Bean
onBeanName	有 Bean Name

更多细节，查看官网 https://solon.noear.org/article/434 。

依赖注入

依赖注入的意思是，在构建时需要使用到其他 Bean 对象。依赖注入通常使用@Configuration，配合@Bean 来实现，其中 @Bean 的函数通过参数注入的方式来获取需要的 Bean 对象。另外就是使用手动模式通过异步订阅的方式获取依赖的 Bean 对象。

以下注入的例子来自官网，更多细节，查看官网 https://solon.noear.org/article/587 。

@Configuration
public class DemoConfig {
    @Bean(name="db1", typed=true)
    public DataSource db1(@Inject("${demo.db1}") DataSource ds){ 
        return ds;
    }
    
    @Bean
    public void db1Test(@Db("db1") UserMapper mapper) { //这个注入，依赖“db1”的数据源
        return mapper.initUsers();
    }
}