Solon 是一個輕量的Java基礎開發框架。強調,剋制 + 簡潔 + 開放的原則;力求,更小、更快、更自由的體驗。支援:RPC、REST API、MVC、Job、Micro service、WebSocket、Socket 等多種開發模式。短小而精悍!
Solon Cloud 是一系列的介面標準和配置規範,算是 Solon 的分散式開發套件方案。
快速瞭解Solon的材料:
《Solon 特性簡集,相較於 Springboot 有什麼區別?》
《Solon Cloud 分散式服務開發套件清單,感覺受與 Spring Cloud 的不同》
所謂更小:
核心0.1m,最小的介面開發單位0.2m(相較於 Dubbo、Springboot 的依賴包,小到可以乎略不計)
所謂更快:
本機http helloworld測試,Qps可達12萬之多。可參考:《helloworld_wrk_test》
所謂更自由:(程式碼操控自由)
// 除了註解模式之外,還可以按需手動
//
//手動獲取配置(Props 為 Properties 增強版)
Props db = Solon.cfg().getProp("db");
//手動獲取容器裡的Bean
UserService userService = Aop.get(UserService.class);
//手動監聽http post請求
Solon.global().post("/user/update", x-> userService.updateById(x.paramMap()));
//手動新增個RPC服務
Solon.global().add("/rpc/", HelloService.class, true);
//手動獲取一個RPC服務消費端
HelloService helloService = Nami.builder().create(HelloService.class);
//手動為容器新增元件
Aop.wrapAndPut(DemoService.class);
本次版本主要變化:
1、外掛 solon.extend.sessionstate.jwt,增加 prefix、allowAutoIssue、allowUseHeader 配置項
solon.extend.sessionstate.jwt 可以更簡單的使用 JWT,像使用 sessionstate 一般。配置示例:
server.session:
timeout: 7200 #單位秒;(可不配,預設:7200)
state:
jwt:
name: TOKEN #變數名;(可不配,預設:TOKEN)
secret: "E3F9N2kRDQf55pnJPnFoo5+ylKmZQ7AXmWeOVPKbEd8=" #金鑰(使用 JwtUtils.createKey() 生成);(可不配,預設:xxx)
prefix: Bearer #令牌字首(可不配,預設:空)
allowExpire: true #充許超時;(可不配,預設:true);false,則token一直有效
allowAutoIssue: false #充許自動輸出;(可不配,預設:true);flase,則不向header 或 cookie 設定值(由使用者手動控制)
allowUseHeader: false #充許使用Header傳遞;(可不配,預設:使用 Cookie 傳遞);true,則使用 header 傳遞
可以通過,JwtUtils.createKey() 生成金鑰,例:
public class JwtTest {
@Test
public void test(){
System.out.println(JwtUtils.createKey());
}
}
應用示例:
@Mapping("api")
@Controller
public class API_test_login extends ApiBase {
@Mapping("test.login")
public String exec(Context ctx) {
//設定session
ctx.sessionSet("user_id", "12");
ctx.sessionSet("name", "noear");
//將session值,手動生成token並做為介面的結果輸出
return ctx.sessionState().sessionToken();
}
}
2、外掛 beetlsql-solon-plugin,升級 beetlsql 為 3.4.3(SQLManagerBuilder 增強了構建能力)
這個更新,主要是增加 beetlsql 的 SQLManagerBuilder 能力。
EventBus.subscribe(SQLManagerBuilder.class, e->{
e.setDbStyle(new OracleStyle());
//e.addIdAutoGen();
});
3、外掛 httputils-solon-plugin,新增 PreheatUtils 介面預熱小工具
PreheatUtils 是一個方便請求自己介面的小工具,便於在程式內部編寫預熱程式碼。
public class DemoApp {
public static void main(String[] args) {
Solon.start(DemoApp.class, args);
//請求自己的介面進行預熱
PreheatUtils.preheat("/cfg/get/?tag=water");
PreheatUtils.preheat("/cfg/set/", h -> h.data("value", "test").post());
}
}
4、新增 SolonProps::loadEnv 載入環境變數介面
使用Docker 或 K8s 部署時,容器可以新增環境配置。為了方便,提供了loadEnv介面,從而使用環境變數如果屬性變數。
public class DemoApp {
public static void main(String[] args) {
Solon.start(DemoApp.class, args, app->{
//載入環境變數(如果有則載入並替換profile的值)
app.cfg().loadEnv("water.");
//通過屬效能力,獲取連結池例項
HikariDataSource ds =app.cfg().getBean("water.ds.",HikariDataSource.class);
});
//
// 此程式碼的效果:1.本地可配置profile; 2.容器部署時可通過環境變數修改
//
}
}
5、新增 SolonApp::signalGet 獲取訊號介面
這個功能用處好像不大。。。但可以做些日誌。
public class DemoApp {
public static void main(String[] args) {
SolonApp app = Solon.start(DemoApp.class, args);
//獲取18080的埠訊號資訊,並列印
Signal signal = app.signalGet(18080);
System.out.println(signal);
}
}
6、solon.cloud CloudJob 增加 cron7x 可選屬性
@CloudJob(name = "DemoJob", cron7x = "0 * * * * ?")
public class DemoJob implements CloudJobHandler {
static final Logger log = LoggerFactory.getLogger(DemoJob.class);
@Override
public void handle(Context ctx) throws Throwable {
log.info("JobHandlerDemo1");
}
}
//或者
@CloudJob(name = "DemoJob", cron7x = "1m")
public class DemoJob implements CloudJobHandler {
static final Logger log = LoggerFactory.getLogger(DemoJob.class);
@Override
public void handle(Context ctx) throws Throwable {
log.info("JobHandlerDemo1");
}
}
7、solon.validation 增加更多註釋
8、外掛 mybatis-solon-plugin 升級 mybatis 為 3.5.7
9、外掛 solon.serialization.protostuff 升級 protostuff 為 1.7.4
10、外掛 solon.socketd.client.smartsocket 升級 smartsocket 1.5.10
11、外掛 solon.serialization.hession 升級 hessian 4.0.65
12、外掛 solon.auth AuthUtil 驗證許可權與角色前增加登入驗證
13、增加 qiniu-kodo-solon-plugin 物件儲存適配外掛
附:專案地址
附:入門示例
- Solon 入門教程示例:https://gitee.com/noear/solon_demo
- Solon Api 入門教程示例:https://gitee.com/noear/solon_api_demo
- Solon Rpc 入門教程示例:https://gitee.com/noear/solon_rpc_demo
- Solon Auth 入門教程示例:https://gitee.com/noear/solon_auth_demo
- Solon Cloud 入門教程示例:https://gitee.com/noear/solon_cloud_demo
- Solon 進階教程示例:https://gitee.com/noear/solon_advance_demo