轻量级 Java 基础开发框架,Solon & Solon Cloud 1.5.40 发布

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

附:项目地址

附:入门示例