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

附：项目地址

• Gitee：https://gitee.com/noear/solon
• Github：https://github.com/noear/solon

附：入门示例

• Solon 入门教程示例：https://gitee.com/noear/solon_demo
• Solon Api 入门教程示例：https://gitee.com/noear/solon_api_demo
• Solon Rpc 入门教程示例：https://gitee.com/noear/solon_rpc_demo
• Solon Auth 入门教程示例：https://gitee.com/noear/solon_auth_demo
• Solon Cloud 入门教程示例：https://gitee.com/noear/solon_cloud_demo
• Solon 进阶教程示例：https://gitee.com/noear/solon_advance_demo