Solon詳解(二)- Solon的核心
阿新 • • 發佈:2020-08-17
Solon的核心
在上篇中我們成功運行了一個簡單的web應用;本篇將對它的啟動過程、擴充套件體系和應用屬性配置進行介紹。
(一)XApp.start(source, args, builder) 內部執行過程(即Solon的啟動過程)
- 例項化 XApp.global()
- 載入應用屬性配置
- 載入擴充套件資料夾
- 掃描外掛並排序記錄(外掛也可叫擴充套件元件)
- 執行builder函式(如果它不為null)
- 執行外掛
- 掃描source目錄並載入java bean
- 載入渲染關係
- 完成
瞭解這個過程非常之重要,尤其是有興致開發外掛的同學:你的外掛在執行之前,配置已經存在了,但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開發進一步展開介紹。