轻量级 Java 基础开发框架，Solon & Solon Cloud 1.5.52 发布

Solon 已有120个生态扩展插件，此次更新主要为细节打磨：

• 插件 mybatis-solon-plugin 增加 mappers 单行配置支持

  之前的多行模式：

  mybatis.db1:
      typeAliases:    #支持包名 或 类名（.class 结尾）
          - "webapp.model"
      mappers:        #支持包名 或 类名（.class 结尾）或 xml（.xml结尾）
          - "webapp.dso.mapper"
  

  新增加的单行模式支持：

  mybatis.db1.typeAliases:  "webapp.model"
  mybatis.db1.mappers: "webapp.dso.mapper"
  

• 添加 DownloadedFile 类，用于下载文件输出时用

  @Controller
  public class DownController {
      @Mapping("down1")
      public DownloadedFile down() {
          InputStream stream = new ByteArrayInputStream("{code:1}".getBytes(StandardCharsets.UTF_8));
  
          //之前复用了 UploadedFile 类，名了上感觉不太对路
          DownloadedFile file = new DownloadedFile("text/json", stream, "test.json"); 
  
          return file;
      }
  
      @Mapping("down2")
      public File down2() {
          String filePath = Utils.getResource("static/debug.htm").getFile();
  
          File file = new File(filePath);
  
          return file;
      }
  }
  

• 将不确定的插件移到_hatch下

• 重新调整内核的异常处理链，进行让 filter 可以统一获取异常处理

  public class TestApp {
      public static void main(String[] args) {
          Solon.start(TestApp.class, args, app -> {
              app.filter((ctx, chain) -> {
                  //1.开始计时（用于计算响应时长）
                  long start = System.currentTimeMillis();
                  try {
                      chain.doFilter(ctx);
  
                      //2.状态404与未处理
                      if (ctx.status() == 404 || ctx.getHandled() == false) {
                          ctx.setHandled(true);
                          ctx.output("没有：（");
                      }
                  } catch (Throwable e) {
                      //3.异常捕促与控制
                      e.printStackTrace();
  
                      ctx.output("出错了：（");
                  }
  
                  //4.获得接口响应时长
                  long times = System.currentTimeMillis() - start;
                  System.out.println("用时："+ times);
              });
          });
      }
  }
  
  //此处调整，解决控制器异常无法被过滤器获取的问题。
  

• 设整 CrossHandler 接口，并增加 exposedHeaders(..)

  public class TestApp {
      public static void main(String[] args) {
          Solon.start(App.class, args, app -> {
              //添加全局跨域控制
              app.before(new CrossHandler()
                      .allowCredentials(true)
                      .allowedMethods("*")
                      .allowedHeaders("*")
                      .allowedOrigins("*")
                      .exposedHeaders("sign,token"));
          });
      }
  }
  

• 插件 sa-token-solon-plugin，升级 sa-token 到 1.27.0

• 插件 beetlsql-solon-plugin，升级 beetlsql 到 3.11.0-RELEASE

关于 Solon

Solon 是一个轻量的Java基础开发框架。强调，克制 + 简洁 + 开放的原则；力求，更小、更快、更自由的体验。支持：RPC、REST API、MVC、Job、Micro service、WebSocket、Socket 等多种开发模式。短小而精悍！

关于 Solon Cloud

Solon Cloud 是一系列的接口标准和配置规范，相当于DDD模式里的防腐层概念。是 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 & post 方法类型
    @Put
    @Post
    @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 Socketd 入门教程示例：https://gitee.com/noear/solon_socketd_demo
• Solon 进阶教程示例：https://gitee.com/noear/solon_advance_demo