轻量级 Java 基础开发框架,Solon & Solon Cloud 1.5.40 发布
- 2021 年 10 月 2 日
- 笔记
- JAVA, solon, solon 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 的不同》
所谓更小:
内核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!";
}
}
附:项目地址
- Gitee://gitee.com/noear/solon
- Github://github.com/noear/solon
附:入门示例
- Solon 入门教程示例://gitee.com/noear/solon_demo
- Solon Api 入门教程示例://gitee.com/noear/solon_api_demo
- Solon Rpc 入门教程示例://gitee.com/noear/solon_rpc_demo
- Solon Auth 入门教程示例://gitee.com/noear/solon_auth_demo
- Solon Cloud 入门教程示例://gitee.com/noear/solon_cloud_demo
- Solon 进阶教程示例://gitee.com/noear/solon_advance_demo