Solon详解(二)- Solon的核心

Solon详解系列文章:
Solon详解(一)- 快速入门
Solon详解(二)- Solon的核心
Solon详解(三)- Solon的web开发

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 文件夹)
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-> ..)

(四)其它配置说明

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开发进一步展开介绍。

你可能感兴趣的:(Solon详解(二)- Solon的核心)