Solon 是一個輕量的Java基礎開發框架。強調,剋制 + 簡潔 + 開放的原則;力求,更小、更快、更自由的體驗。支援:RPC、REST API、MVC、Job、Micro service、WebSocket、Socket 等多種開發模式。
Solon Cloud 是一系列的介面標準和配置規範,算是 Solon 的分散式開發套件方案。
快速瞭解Solon的材料:
《Solon 特性簡集,相較於 Springboot 有什麼區別?》
《Solon Cloud 分散式服務開發套件清單,感覺受與 Spring Cloud 的不同》
《Solon 生態外掛清單》,目前已有100多個生態外掛
所謂更小:
核心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);
本次版本主要變化:
1、增加 sa-token-solon-plugin 外掛,適配 sa-token 認證框架
應用樣例
@Controller
@Mapping("/test/")
public class TestController {
@SaCheckLogin
@SaCheckRole("super-admin")
@SaCheckPermission("user-add")
@Mapping("atCheck")
public AjaxJson atCheck() {
System.out.println("只有通過註解鑑權,才能進入此方法");
return AjaxJson.getSuccess();
}
@Mapping("atJurOr")
@SaCheckPermission(value = {"user-add", "user-all", "user-delete"}, mode = SaMode.OR)
public AjaxJson atJurOr() {
return AjaxJson.getSuccessData("使用者資訊");
}
}
2、增加 solon.extend.auth 外掛,Solon 自擴充套件的認證框架
適配樣例
@Configuration
public class Config {
@Bean
public AuthAdapter init() {
return new AuthAdapter()
.loginUrl("/login")
.authPathMatchers(new AuthPathMatchersImpl())
.authInterceptor(new AuthInterceptorImpl())
.authProcessor(new AuthProcessorImpl())
.authOnFailure((ctx, rst) -> {
ctx.render(Result.failure(403,"沒有許可權:("));
});
}
}
應用樣例
@Controller
@Mapping("/test/")
public class TestController {
@Mapping("/hello/")
public String hello() {
return "hello world!";
}
@AuthRoles("admin")
@Mapping("/admin/")
public String admin() {
return "hello admin!";
}
}
3、增加 solon-enjoy-web 快速開發套件(支援 enjob + activerecord 體驗)
jFinal 系列技術的愛好者,可以有不同的玩具了。solon-enjoy-web,支援 solon 完整的事務能力及快取能力
//配置預設資料來源
@Configuration
public class Config {
@Bean
public DataSource db1(@Inject("${test.db1}") HikariDataSource dataSource) {
return dataSource;
}
}
//應用示列
@Mapping("/demo/")
@Controller
public class DemoController {
@Mapping("")
public Object test(){
return Db.template("appx_get").findFirst();
}
@Cache(tags = "test2")
@Mapping("/test2")
public Object test2(){
AppxModel dao = new AppxModel().dao();
return dao.findById(4);
}
}
4、增加 異常訂閱轉換為正常輸出的能力
@Component
public class GlobalException implements EventListener<Throwable> {
@Override
public void onEvent(Throwable e) {
Context c = Context.current();
if (c != null) {
AjaxJson aj = null;
if (e instanceof SaTokenException) {
NotLoginException ee = (NotLoginException) e;
aj = AjaxJson.getNotLogin().setMsg(ee.getMessage());
} else if (e instanceof NotRoleException) {
NotRoleException ee = (NotRoleException) e;
aj = AjaxJson.getNotJur("無此角色:" + ee.getRole());
} else if (e instanceof NotPermissionException) {
NotPermissionException ee = (NotPermissionException) e;
aj = AjaxJson.getNotJur("無此許可權:" + ee.getCode());
} else if (e instanceof DisableLoginException) {
DisableLoginException ee = (DisableLoginException) e;
aj = AjaxJson.getNotJur("賬號被封禁:" + ee.getDisableTime() + "秒後解封");
} else {
aj = AjaxJson.getError(e.getMessage());
}
c.result = aj;
}
}
}
附:專案地址
附:入門示例
- Solon 入門教程示例:https://gitee.com/noear/solon_demo
- Solon Rpc 入門教程示例:https://gitee.com/noear/solon_rpc_demo
- Solon Cloud 入門教程示例:https://gitee.com/noear/solon_cloud_demo
- Solon 進階教程示例:https://gitee.com/noear/solon_advance_demo