Solon 已有120個生態擴展插件,此次更新主要爲細節打磨:
1、插件 mybatis-solon-plugin 增加 mappers、typeAliases 單行配置支持
之前的多行模式:
mybatis.db1:
typeAliases: #支持包名 或 類名(.class 結尾)
- "webapp.model"
mappers: #支持包名 或 類名(.class 結尾)或 xml(.xml結尾)
- "webapp.dso.mapper"
新增加的單行模式支持:
mybatis.db1.typeAliases: "webapp.model" #如有多項逗號隔開
mybatis.db1.mappers: "webapp.dso.mapper"
2、添加 DownloadedFile 類,用於下載文件輸出
@Controller
public class DownController {
@Mapping("down1")
public DownloadedFile down() {
InputStream stream = new ByteArrayInputStream("{code:1}".getBytes(StandardCharsets.UTF_8));
//之前複用了上傳用的 UploadedFile 類,類名感覺不太對路
DownloadedFile file = new DownloadedFile("text/json", stream, "test.json");
return file;
}
@Mapping("down2")
public File down2() {
String filePath = Utils.getResource("static/debug.htm").getFile();
File file = new File(filePath); //也可能用File直接輸出
return file;
}
}
3、將不確定的插件移到_hatch下,之後會有孵化插件的概念
4、重新調整內核的異常處理鏈,進行讓 Filter 可以統一獲取異常處理
public class TestApp {
public static void main(String[] args) {
Solon.start(TestApp.class, args, app -> {
app.filter((ctx, chain) -> {
//1.開始計時(用於計算響應時長)
long start = System.currentTimeMillis();
try {
chain.doFilter(ctx);
//2.狀態404與未處理
if (ctx.status() == 404 || ctx.getHandled() == false) {
ctx.setHandled(true);
ctx.output("沒有:(");
}
} catch (Throwable e) {
//3.異常捕促與控制
e.printStackTrace();
ctx.output("出錯了:(");
}
//4.獲得接口響應時長
long times = System.currentTimeMillis() - start;
System.out.println("用時:"+ times);
});
});
}
}
//此處調整,解決控制器異常無法被過濾器獲取的問題。
5、調整 solon.extend.cors 插件的 CrossHandler 接口,並增加 exposedHeaders(..)
public class TestApp {
public static void main(String[] args) {
Solon.start(App.class, args, app -> {
//添加全局跨域控制
app.before(new CrossHandler()
.allowCredentials(true)
.allowedMethods("*")
.allowedHeaders("*")
.allowedOrigins("*")
.exposedHeaders("sign,token"));
});
}
}
6、插件 sa-token-solon-plugin,升級 sa-token 到 1.27.0
7、插件 beetlsql-solon-plugin,升級 beetlsql 到 3.11.0-RELEASE
8、增加自動打印異常的全局控制 enableErrorAutoprint
@Slf4j
public static class DemoApp{
public statis void main(String[] args){
Lo LoggerFactory.getLogger(DemoApp.class);
Solon.start(DemoApp.class, args, app->{
//默認是true,轉到日誌框架後,關掉
app.enableErrorAutoprint(false); //控制進入EventBus的異常打印
//訂閱進入EventBus的異常
app.onError(e->{
Context ctx = Context.current();
if(ctx){
//經常有人會疑問:爲什麼框架不把異常直接轉到日誌框架?
//下面就是好處:可以定製它,比如記錄異常時的上下文參數,你排查時方便
MDC.put("tag0", ctx.path());
log.error(">Params: {}\r\nError: {}", ctx.paramMap(), e);
}else{
log.error(e);
}
});
});
}
}
Solon 內核的原則是“零外部依賴”,未處理的異常是發送到EventBus的。需要用戶訂閱處理,例:app.onError(e->...)。現在,默認就能看到異常打印了。
關於 Solon
Solon 是一個輕量的Java基礎開發框架。強調,剋制 + 簡潔 + 開放的原則;力求,更小、更快、更自由的體驗。支持:RPC、REST API、MVC、Job、Micro service、WebSocket、Socket 等多種開發模式。短小而精悍!
關於 Solon Cloud
Solon Cloud 是一系列的接口標準和配置規範,相當於DDD模式裏的防腐層概念。是 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);
Hello world:
//Handler 模式:
public class App{
public static void main(String[] args){
SolonApp app = Solon.start(App.class,args);
app.get("/",(c)->c.output("Hello world!"));
}
}
//Controller 模式:(mvc or rest-api)
@Controller
public class App{
public static void main(String[] args){
Solon.start(App.class,args);
}
//限定 put & post 方法類型
@Put
@Post
@Mapping("/")
public String hello(String name){
return "Hello " + name;
}
}
//Remoting 模式:(rpc)
@Mapping("/")
@Remoting
public class App implements HelloService{
public static void main(String[] args){
Solon.start(App.class,args);
}
@Override
public String hello(){
return "Hello world!";
}
}
附:項目地址
附:入門示例
- 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 Socketd 入門教程示例:https://gitee.com/noear/solon_socketd_demo
- Solon 進階教程示例:https://gitee.com/noear/solon_advance_demo