Solon详解（二）- Solon的核心

Solon详解系列文章：

Solon详解（一）- 快速入门

Solon详解（二）- Solon的核心

Solon详解（三）- Solon的web开发

Solon详解（四）- Solon的事务传播机制

Solon详解（五）- Solon扩展机制之Solon Plugin

Solon详解（六）- Solon的校验扩展框架使用与扩展

Solon的核心

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

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

1. 实例化 XApp.global()
2. 加载应用属性配置
3. 加载扩展文件夹
4. 扫描插件并排序记录（插件也可叫扩展组件）
5. 运行builder函数（如果它不为null）
6. 运行插件
7. 扫描source目录并加载java bean
8. 加载渲染关系
9. 完成

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

（二）XPlugin 插件体系

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服务（网友@tyk提供）
org.noear:solon.boot.websocket	boot插件,对java-websocket适配，提供websocket服务
org.noear:solon.boot.smartsocket	boot插件,对smart-bsocket适配，提供socket服务
org.noear:solon.extend.jetty.jsp	扩展插件,为jetty添加jsp支持（不建议使用jsp）（网友@khb提供）
org.noear:solon.extend.undertow.jsp	扩展插件,为undertow添加jsp支持（不建议使用jsp）（网友@tyk提供）
静态文件支持插件::	说明
org.noear:solon.extend.staticfiles	扩展插件,添加静态文件支持（监视 resources/static 文件夹）
切面支持插件::	说明
org.noear:solon.extend.aspect	扩展插件,添加XDao、XService注解支持；进而支持事务和缓存注解
数据操作支持插件::	说明
org.noear:solon.extend.data	扩展插件,实现事务和缓存的注解支持
验证操作支持插件::	说明
org.noear:solon.extend.validation	扩展插件,实现验证类注解支持
Yaml配置支持插件::	说明
org.noear:solon.extend.properties.yaml	扩展插件,添加yml配置文件支持
Session插件::	说明（可将boot插件的session state服务，自动换掉）
org.noear:solon.extend.sessionstate.local	扩展插件,本地session
org.noear:solon.extend.sessionstate.redis	扩展插件,分布式session（其于redis构建）
序列化插件::	说明
org.noear:solon.serialization.fastjson*	序列化插件，对 fastjson 适配，提供json视图输出 或 序列化输出
org.noear:solon.serialization.snack3*	序列化插件，对 snack3 适配，提供json视图输出 或 序列化输出
org.noear:solon.serialization.hession*	序列化插件，对 hession 适配，提供 hession 序列化输出
org.noear:solon.serialization.jackson	序列化插件，对 jackson 适配，提供json视图输出 或 序列化输出
视图插件::	说明（可置多个视图插件）
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视图输出
rpc client::	说明
org.noear:solonclient	solon rpc client 与solon 的 rpc service 配对
外部框架适配::	说明
org.noear:cron4j-solon-plugin	cron4j 适配插件
org.noear:dubbo-solon-plugin	dubbo 适配插件
org.noear:mybatis-solon-plugin	mybatis 适配插件
org.noear:weed3-solon-plugin	weed3 适配插件

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

（三）应用属性配置文件

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

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

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

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

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

b.端口配置（以使用 application.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默认没有对接外部日志框架，而是通过事件总线接收应用内所有的异常。

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

i.页面跳转

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

（四）其它配置说明

a.自定义属性

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

user.name: "lie lai"

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

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

c.如何获取属性配置

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

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

d.属性转对象

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

//注解模式
//
@XConfiguration  // XConfiguration或别的类注解，都可
public class test{
    //注入字段，在任何托管Bean里有效
    //
    @XInject("${user}")
    UserModel user;

    //注入参数，只在@XConfiguration类有效
    //
    @XBean
    public Xxxxx buildXxxx(@XInject("${test.db1}") HikariDataSource dataSource){    

    }
}

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

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