輕量級 Java 基礎開發框架,Solon & Solon Cloud 1.5.53 發佈

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 的不同》

《Solon 的想法與架構筆記》

所謂更小:

內核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!";
    }
}

附:項目地址

附:入門示例

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章