Solon 框架详解（二）- Solon的核心

Solon 详解系列文章：
Solon 框架详解（一）- 快速入门
Solon 框架详解（二）- Solon的核心
Solon 框架详解（三）- Solon的web开发
Solon 框架详解（四）- Solon的事务传播机制
Solon 框架详解（五）- Solon扩展机制之Solon Plugin
Solon 框架详解（六）- Solon的校验框架使用、定制与扩展
Solon 框架详解（七）- Solon Ioc 的注解对比Spring及JSR330
Solon 框架详解（八）- Solon的缓存框架使用和定制
Solon 框架详解（九）- 渲染控制之定制统一的接口输出
Solon 框架详解（十）- Solon 的常用配置
Solon 框架详解（十一）- Solon Cloud 的配置说明

Solon 的核心

在上篇中我们成功运行了一个简单的web应用；本篇将对它的启动过程、扩展体系和应用属性配置进行介绍。

（一）Solon.start(source, args, builder) 内部执行过程（即Solon的启动过程）

• 1.实例化 Solon.global() 并加载配置
• 2.加载扩展文件夹
• 3.扫描插件并排序
• 4.运行 initialize 函数
• 5.推送 AppInitEndEvent [事件]
• 6.运行插件
• 7.推送 PluginLoadEndEvent [事件]
• 8.导入java bean(@Import)
• 9.扫描并加载java bean
• a.推送 BeanLoadEndEvent [事件]
• b.加载渲染印映关系
• c.执行bean加完成事件
• d.推送 AppLoadEndEvent [事件]
• e.结束

了解这个过程非常之重要，尤其是有兴致开发插件的同学：你的插件在运行之前，配置已经存在了，但java bean仍未加载。

（二）Plugin 插件体系

Solon 的插件也可以叫扩展组件，相当于Spring 的 starter。Solon已经提供了大量的基础插件，但对第三方的框架适配目前较少。

插件	说明
Boot 插件::	说明
org.noear:solon.boot.jlhttp*	boot插件,对jlhttp适配,提供http服务（不自带session state）
org.noear:solon.boot.jetty*	boot插件,对jetty适配,提供http服务（网友@khb提供）
org.noear:solon.boot.undertow*	boot插件,对undertow适配,提供http、websocket服务（网友@tyk提供）
org.noear:solon.boot.websocket	boot插件,对java-websocket适配，提供websocket服务
org.noear:solon.extend.jetty.jsp	扩展插件,为jetty添加jsp支持包（不建议使用jsp）（网友@khb提供）
org.noear:solon.extend.jetty.websocket	扩展插件,为jetty添加websoekct支持包
org.noear:solon.extend.undertow.jsp	扩展插件,为undertow添加jsp支持（不建议使用jsp）（网友@tyk提供）
SocketD boot插件::	说明
org.noear:solon.boot.socketd.jdksocket	boot插件,对jdk-socket适配，提供socketd服务
org.noear:solon.boot.socketd.netty	boot插件,对netty适配，提供socketd服务
org.noear:solon.boot.socketd.rsocket	boot插件,对rsocket适配，提供socketd服务
org.noear:solon.boot.socketd.smartsocket	boot插件,对smartboot-socket适配，提供socketd服务
org.noear:solon.boot.socketd.websocket	boot插件,对java-websocket适配，提供socketd服务
静态文件支持插件::	说明
org.noear:solon.extend.staticfiles	扩展插件,添加静态文件支持（监视 resources/static 文件夹）
切面支持插件::	说明
org.noear:solon.extend.aspect	扩展插件,添加Dao、Service注解支持；进而支持类的代理模式
数据操作支持插件::	说明
org.noear:solon.extend.data	扩展插件,实现事务和缓存的注解支持
验证操作支持插件::	说明
org.noear:solon.extend.validation	扩展插件,实现验证类注解支持
Yaml配置支持插件::	说明
org.noear:solon.extend.properties.yaml	扩展插件,添加yml配置文件支持
定时任务支持插件::	说明
org.noear:solon.extend.schedule	扩展插件,实现定时任务支持（和 cron4j-solon-plugin 风格不同）
远程关闭支持插件::	说明
org.noear:solon.extend.stop	扩展插件,实现远程关闭支持
Session插件::	说明（可将boot插件的session state服务，自动换掉）
org.noear:solon.extend.sessionstate.local	扩展插件,本地session
org.noear:solon.extend.sessionstate.redis	扩展插件,分布式session（其于redis构建）
org.noear:solon.extend.sessionstate.jwt	扩展插件,分布式session（其于jwt构建）
序列化插件::	说明
org.noear:solon.serialization.fastjson*	序列化插件，对 fastjson 适配，提供json视图输出 或 序列化输出
org.noear:solon.serialization.snack3*	序列化插件，对 snack3 适配，提供json视图输出 或 序列化输出
org.noear:solon.serialization.jackson	序列化插件，对 jackson 适配，提供json视图输出 或 序列化输出
org.noear:solon.serialization.hession*	序列化插件，对 hession 适配，提供 hession 序列化输出
org.noear:solon.serialization.protostuff*	序列化插件，对 protostuff 适配，提供 protostuff 序列化输出
视图插件::	说明（可置多个视图插件）
org.noear:solon.view.freemarker*	视图插件，对 freemarker 适配，提供html视图输出
org.noear:solon.view.jsp	视图插件，对 jsp 适配，提供html视图输出
org.noear:solon.view.velocity	视图插件，对 velocity 适配，提供html视图输出
org.noear:solon.view.thymeleaf	视图插件，对 thymeleaf 适配，提供html视图输出
org.noear:solon.view.beetl	视图插件，对 beetl 适配，提供html视图输出
org.noear:solon.view.enjoy	视图插件，对 enjoy 适配，提供html视图输出
Solon 与 Springboot 融合适配插件::	说明
org.noear:solon-springboot-starter	springboot 适配插件
Solon 第三方框架适配插件::	说明
org.noear:beetlsql-solon-plugin	beetlsql 适配插件
org.noear:mybatis-solon-plugin	mybatis 适配插件
org.noear:mybatis-sqlhelper-solon-plugin	mybatis-sqlhelper 适配插件
org.noear:weed3-solon-plugin	weed3 适配插件
org.noear:cron4j-solon-plugin	cron4j 适配插件
org.noear:quartz-solon-plugin	quartz 适配插件
org.noear:dubbo-solon-plugin	dubbo 适配插件
org.noear:feign-solon-plugin	feign 适配插件
org.noear:hasor-solon-plugin	hasor 适配插件
org.noear:luffy-solon-plugin	luffy 适配插件
org.noear:sureness-solon-plugin	sureness 适配插件
Solon Cloud 第三方框架适配插件::	说明（提供分布式与微服务开发支持）
org.noear:consul-solon-plugin	consul 适配插件（支持Solon cloud 配置服务、注册与发现服务）
org.noear:nacos-solon-plugin	nacos 适配插件（支持Solon cloud 配置服务、注册与发现服务）
org.noear:zookeeper-solon-plugin	zookeeper 适配插件（支持Solon cloud 配置服务、注册与发现服务）
org.noear:water-solon-plugin	water 适配插件（支持Solon cloud 配置服务、注册与发现服务、事件总线服务、日志服务、跟踪服务、锁服务）
org.noear:rabbitmq-solon-plugin	rabbitmq 适配插件（支持Solon cloud 事件总线服务）
org.noear:rocketmq-solon-plugin	rocketmq 适配插件（支持Solon cloud 事件总线服务）
org.noear:mqtt-solon-plugin	mqtt 适配插件（支持Solon cloud 事件总线服务）
org.noear:kafka-solon-plugin	kafka 适配插件（支持Solon cloud 事件总线服务）
org.noear:guava-solon-plugin	guava 适配插件（支持Solon cloud 融断服务）
org.noear:sentinel-solon-plugin	sentinel 适配插件（支持Solon cloud 融断服务）
org.noear:semaphore-solon-plugin	semaphore 适配插件（支持Solon cloud 融断服务）
org.noear:aliyun-oss-solon-plugin	aliyun-oss 适配插件（支持Solon cloud 分布式文件服务）
org.noear:aws-s3-solon-plugin	aws-s3 适配插件（支持Solon cloud 分布式文件服务）
org.noear:snowflake-id-solon-plugin	snowflake 算法适配插件（支持Solon cloud 分布式ID服务）
Nami框架（Remoting client）::	说明（通道 + 编码器）
org.noear:nami	Nami内核（支持http, socket, web socket）
org.noear:nami.channel.http.hutool	Nami http通道
org.noear:nami.channel.http.okhttp	Nami http通道
org.noear:nami.channel.socketd.jdksocket	Nami socketd通道-基于bio实现
org.noear:nami.channel.socketd.netty	Nami socketd通道-基于nio,netty实现
org.noear:nami.channel.socketd.rsocket	Nami socketd通道-基于rsocket实现
org.noear:nami.channel.socketd.smartsocket	Nami socketd通道-基于aio实现
org.noear:nami.channel.socketd.websocket	Nami socketd通道-基于websocket实现
org.noear:nami.coder.fastjson	Nami json编码器
org.noear:nami.coder.hessian	Nami hessian编码器
org.noear:nami.coder.jackson	Nami jackson编码器
org.noear:nami.coder.protostuff	Nami protostuff编码器
org.noear:nami.coder.snack3	Nami json编码器

怎么使用？直接在pom.xml中添加依赖即可。

（三）应用属性配置文件

Solon项目会使用一个全局的属性配置文件 app.properties 或者是 app.yml，在resources目录下。

Solon会根据在pom.xml中依赖的jar包进行自动配置，当我们要对这些jar包对应的框架进行配置又该怎么办呢？没错，可以在全局配置文件（app.properties 或者是 app.yml）中进行配置，如http server的端口配置等。

a.基础约定（不能改，为了简化套路）

//资源路径说明（不用配置；也不能配置）
resources/app.properties（ 或 app.yml 或 application.properties 或 application.yml ） 为应用配置文件
resources/static/ 为静态文件根目标
resources/WEB-INF/view/ 为视图模板文件根目标（支持多视图共存）

//调试模式：
启动参数添加：-debug=1 或 --debug=1

b.端口配置（以使用 app.yml 为例）

server.port: 8080

c.请求包大小限制

server.request.maxRequestSize: 2Mb

d.会话超时

server.session.timeout: 3600 #单位:s

e.视图引擎配置（可多引擎共享）

原则上不要加这些配置，更不要修改；想用哪个模板，加哪个组件即可（有利于简化套路）

#默认的配置（不需要改配置，除非要修改）
solon.view.mapping.htm: BeetlRender #简写
solon.view.mapping.shtm: EnjoyRender
solon.view.mapping.ftl: FreemarkerRender #默认的模板引擎
solon.view.mapping.jsp: JspRender
solon.view.mapping.html: ThymeleafRender
solon.view.mapping.vm: org.noear.solon.view.velocity.VelocityRender #引擎全名（一般用简写）

f.分布式session配置

当添加org.noear:solon.extend.sessionstate.redis组件时，即切换为分布式session，需要以下配置了（它基于redis包装；也可以基于接口自己造一个）：

# 当使用 sesstionstate.redis 的配置
server.session.state.redis.server: 127.0.0.1:6379
server.session.state.redis.password: xxx
server.session.state.redis.db: 31
server.session.state.redis.maxTotaol: 200

g.统一的日志

Solon默认没有对接外部日志框架，而是通过事件总线接收应用内所有的异常。

Solon.start(...).onEerror(err-> ..)

i.页面跳转

ctx.redirect("http://www.noear.org");
//or
Context.current().redirect("http://www.noear.org");

（四）其它配置说明

a.自定义属性

只要名字不冲突，随便加。例：

user.name: "lie lai"

b.属性引用（这个不支持；为了简化套路）

user.name: "lie lai"
message: "${user.name} 你好!" #这个不支持（有需要的时候，自己替换）

c.如何获取属性配置

//注解模式
@Inject("${user.name}")

//代码模式
Solon.cfg().get("user.name")

d.属性转对象

这个功能用起来会很方便，简化不少的代码编写。

//注解模式
//
@Configuration  // Configuration或别的类注解，都可
public class test{
    //注入字段，在任何托管Bean里有效
    //
    @Inject("${user}")
    UserModel user;
    
    //注入参数，只在@Configuration类有效
    //
    @Bean
    public Xxxxx buildXxxx(@Inject("${test.db1}") HikariDataSource dataSource){    
    
    }
}

//代码模式
UserModel user = Solon.cfg().getBean("user", UserModel.class);
HikariDataSource dataSource =  Solon.cfg().getBean("test.db1", HikariDataSource.class);

本篇到此结束，主要介绍了Solon中几个的问题：1，启动过程；2，扩展体系，3，应用属性配置，同时解决上篇中的几个问题，从下篇开始，将针对Solon的web开发进一步展开介绍。

附：Solon项目地址

• gitee: https://gitee.com/noear/solon
• github: https://github.com/noear/solon