说明 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 的理解。
一个初始化函数时机点 应用开发时可扩展的时机。
1 2 3 4 5 6 7 8 @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 。
1 2 3 4 5 6 7 8 9 10 11 12 @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) { return mapper.initUsers(); } }