说明
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 在应用生命周期提供的扩展机制,应用可以根据需要的事件时机点,订阅响应的事件。本地事件总线支持自定义的事件。
注意:
- 本地事件总线是基于应用生命周期的(应用的启停,插件的启停,bean 创建等),而不是基于业务,如果是涉及业务,可以使用使用作者的另一个作品 DamiBus。
- 要在事件发生前订阅事件,否则会错过时机,无法接收到事件消息。
应用生命周期
应用生命周期,是应用程序从 启动到最后停止的整个过程。应用生命周期当中存在一些关键点,可称为时机点。
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;}@Beanpublic void db1Test(@Db("db1") UserMapper mapper) { //这个注入,依赖“db1”的数据源return mapper.initUsers();}
}