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

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

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

附:專案地址

附:入門示例