輕量級 Java 基礎開發框架，Solon & Solon Cloud 1.5.52 釋出

阿新 • • 發佈：2021-10-27

Solon 已有120個生態擴充套件外掛，此次更新主要為細節打磨：

外掛 mybatis-solon-plugin 增加 mappers 單行配置支援

之前的多行模式：

mybatis.db1:
    typeAliases:    #支援包名 或 類名（.class 結尾）
        - "webapp.model"
    mappers:        #支援包名 或 類名（.class 結尾）或 xml（.xml結尾）
        - "webapp.dso.mapper"

新增加的單行模式支援：

mybatis.db1.typeAliases:  "webapp.model"
mybatis.db1.mappers: "webapp.dso.mapper"

新增 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);

        return file;
    }
}

將不確定的外掛移到_hatch下

重新調整核心的異常處理鏈，進行讓 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);
            });
        });
    }
}

//此處調整，解決控制器異常無法被過濾器獲取的問題。

設整 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"));
        });
    }
}

外掛 sa-token-solon-plugin，升級 sa-token 到 1.27.0
外掛 beetlsql-solon-plugin，升級 beetlsql 到 3.11.0-RELEASE

關於 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!";
    }
}