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

劉之西東發表於2021-10-02
Java框架Cloud

Solon 已有120個生態擴充套件外掛，此次版本以細節打磨為主：

  • 增加 mybatisplus-solon-plugin 外掛
    //至此，Solon 已完成國內外主流的5個ORM框架外掛適配
  • 外掛 solon.validation，註解 Whitelist、NotBlacklist、Logined 增加可繼承支援
    //
//Solon 具體輕量而完整的驗證能力及驗證擴充套件機制
//
@Logined
@Valid
public class ApiBaseLogined {
}


@Controller
public class DemoController extends ApiBaseLogined {
    @Numeric({"id"})
    @NotEmpty({"id","name","description"})
    @Mapping("addArchive")
    public void addArchive(Long id, String name, String description){
        //...
    }
    
    @Mapping("addArchiveItem")
    public void addArchiveItem(@Validated ItemModel item){
        //...
    }
}
  • 調整 路由規則，帶 * 號的印射關係排到後面
    @Controller
public class DemoController {
    @Mapping("/*")
    public void all(){
    }
    
    @Mapping("/add") //相對於*，具有優先匹配權
    public void add(){ 
    }
}
  • 調整 通訊埠被佔用時，改為丟擲異常
  • 國際化 增加 Content-Language 頭資訊支援，讓國際化控制更友好
  • 國際化 增加 上下文的 Locale 注入支援
    @Mapping("/demo")
public void demo(Locale locale){

}
  • 國際化 增加 I18nService 類
    @Controller
public class DemoController {
    I18nService i18nService = new I18nService("i18n.user");

    @Mapping("/demo")
    public String demo(Locale locale){
        return i18nService.get(locale, "user.name");
    }
}
  • 調整 solon.data.cache.CacheServiceDefault 內部類，更名為 LocalCacheService
    @Configuration
public class Config {
    @Bean
    public CacheService cache(){
        return new LocalCacheService();
    }
}
  • 外掛 solon.serialization.hession 更名為：外掛 solon.serialization.hessian
  • 調整序列化渲染方案，不再受accept header影響
  • 調整 驗證器 Numeric ，空為通過（是否充許為空由@NotEmpty處理）
  • 調整 Aop.get(type) 改為 return bean || null
  • 取消 Aop.getOrNull(type) 介面，由 Aop.get(type)
  • 新增 Aop.getOrNew(type) return bean; 替代舊的 Aop.get(type)
  • 介面 CloudFileService 增加 delete 方法
    @Controller
public class DemoController {
    @Bean
    public void put(UploadedFile file){
        //阿里雲 oss  或 AWS s3 或 七牛 圖片上傳（使用 Solon Cloud 介面會很簡便）
        CloudClient.file().putStream(Utils.guid(), file.content, "image/jpg");
    }
}
  • 修復 solon.extend.staticfiles 會出現 .htm 的mine 匹配 .xhtm 的情況
  • 優化不啟用快取的控制（基於程式碼控制，可根據啟動引數變化）
  • 優化不啟用事務的控制
  • 調整快取標籤引數使用策略，缺時出異常方便用者發現
  • 增加@Inject("${xx.xx.ary}") List ary 的支援
    @Controller
public class DemoController {
    @Inject("${project.linkes}")
    List<String> linkes;
    
    @Inject("${project.details}")
    Map<String,String> details;
}
  • 修復 Props 在 forEach 時，可能出現重複key的問題

關於 Solon

Solon 是一個輕量的Java基礎開發框架。強調，剋制 + 簡潔 + 開放的原則；力求，更小、更快、更自由的體驗。支援：RPC、REST API、MVC、Job、Micro service、WebSocket、Socket 等多種開發模式。短小而精悍！

Solon Cloud 是一系列的介面標準和配置規範，算是 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 方法型別
    @Put
    @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!";
    }
}

附：專案地址

附：入門示例

相關文章