Jboot 一个更简单的分布式、微服务框架。

Jboot是一个基于 JFinal、JFinal-Undertow、Dubbo、Seata、Sentinel、ShardingSphere、Nacos 等开发的微服务框架，帮助开发者降低微服务、分布式开发门槛。爽爽开发，快乐生活。

支持 JDK8~JDK17。

Jboot v3.14.0 主要是新增了 Controller 返回值自动匹配渲染器、Controller 缓存（@Cacheable）、@Transactional() 事务注解等的支持，并优化多个细节。

Controller 缓存实例：

@Cacheable(name = "aaa", liveSeconds = 10)
public void json() {
    
    System.out.println("json() invoked!!!!!!!!!");
    
    Map<String, Object> data = new HashMap<>();
    data.put("age", 1);
    data.put("name", "张三");
    data.put("sex", 1);
    
    renderJson(data);
}

以上的代码中，在 10 秒钟内多次访问的时候，只有第一次访问到了 json() 方法，其余的都直接使用第一次的结果输出给浏览器。其中，缓存的名称为 "aaa"，key 为 class.method() 格式。我们可以通过 @Cacheable(name = "aaa", key="xxx") 来指定缓存的key值。

其中 key 里的内容还可以使用 #(方法参数名称) 和 @para('http参数名称') 的方式来定义 key。

例如：

@Cacheable(name = "aaa", key="#para('mykey')", liveSeconds = 10)
public void json() {
    
    System.out.println("json() invoked!!!!!!!!!");
    
    Map<String, Object> data = new HashMap<>();
    data.put("age", 1);
    data.put("name", "张三");
    data.put("sex", 1);
    
    renderJson(data);
}

当访问 http://127.0.0.1:8080/json?mykey=thekey 的时候，该缓存的 key 的内容为："thekey"。然而，在某些极端场景下，我们可能是不需要缓存的，配置如下：

@Cacheable(name = "aaa", liveSeconds = 10, unless = "para('type')==1")
public void json2() {
     System.out.println("json2() invoked!!!!!!!!!");
     Map<String, Object> data = new HashMap<>();
     data.put("age", 1);
     data.put("name", "张三");
     data.put("sex", 1);
     renderJson(data);
}

当访问 http://127.0.0.1:8080/json2?type=1 的时候，永远不会命中缓存。

Controller 返回值制动匹配渲染器实例：

@RequestMapping("/")
public MyController extends Controller{

    //自动使用 html 来渲染
    public String test1(){
        return "test1.html";
     }

     //自动使用文本来渲染
    public String test2(){
        return "test2...";
    }

    //渲染 404 错误
    public String test3(){
        return "error: 404";
    }

    //渲染 500 错误
    public String test4(){
        return "error: 500";
    }

    //自动 redirect 跳转
    public String test5(){
        return "redirect: /to/your/path";
    }

    //自动 forward action 重定向
    public String test6(){
        return "forward: /to/your/path";
    }

    //自动进行文件下载
    public File test7(){
        return new File('/file/path');
    }

    //渲染 json 内容
    public Object test8(){
        Map<String,Object> map = new HashMap<>();
        map.put("key","value....");
        return map;
    }

    //使用自动的 render 渲染
    public Object test9(){
        Render render = new TextRender("some text...");
        return render;
    }
        
}

@Transactional 注解实例

实例1：出现异常时回滚

@Transactional
public void test1() {
   //your code
   throw new RuntimeException("...");     
}

实例2：返回值为 false 时回滚

@Transactional(rollbackForFalse=true)
public boolean test2() {
   //your code
   return false;
}

实例3：返回值为 Ret.fail() 时回滚

@Transactional(rollbackForRetFail=true)
public Ret test3() {
   //your code
   return Ret.fail("message...");
}

实例4：返回值为 null 时回滚

@Transactional(rollbackForNull=true)
public Ret test3() {
   //your code
   return null;
}

@Transactional 的更多配置：

public @interface Transactional {

    /**
     * 使用哪个数据源
     *
     * @return
     */
    String config() default "";

    /**
     * 事务隔离级别
     *
     * @return
     */
    int transactionLevel() default -1;

    /**
     * return false 的时候，是否进行回滚
     *
     * @return
     */
    boolean rollbackForFalse() default false;

    /**
     * return ret.fail 的时候，是否进行回滚
     *
     * @return
     */
    boolean rollbackForRetFail() default false;


    /**
     * 返回 null 的时候，是否进行回滚
     *
     * @return
     */
    boolean rollbackForNull() default false;


    /**
     * 配置允许哪些异常不回滚
     *
     * @return
     */
    Class<? extends Throwable>[] noRollbackFor() default {};

    /**
     * 是否在新的线程里执行，在 Controller 的 Action 方法下配置无效
     * 在 Controller 里，不能以新的线程在运行
     *
     * @return
     */
    boolean inNewThread() default false;

    /**
     * 使用哪个线程池来运行线程，需要在启动的时候，通过 TransactionalManager 来配置线程池及其名称
     *
     * @return
     */
    String threadPoolName() default "";

    /**
     * 是否以阻塞的方式运行线程，这个配置只有在返回值 void 情况下配置生效
     * 有返回值的，此配置无效，默认都是阻塞运行线程的方式运行
     *
     * @return
     */
    boolean threadWithBlocked() default false;

}

更多细节，请查看 changelist.

Jboot v3.14.0  更新内容如下：

Jboot 开发文档：

http://www.jboot.com.cn

同时，Jboot 官方也推出了收费的、企业级快速开发框架 JbootAdmin （如下图所示），真诚的为各位开发者提供一站式、保姆式服务。请咨询海哥。

更多关于 JbootAdmin 请参考：http://www.jboot.com.cn/jbootadmin/feature.html 

<dependency>
    <groupId>io.jboot</groupId>
    <artifactId>jboot</artifactId>
    <version>3.14.0</version>
</dependency>

@RequestMapping("/")
public class HelloWorld extends JbootController {

    public void index(){
        renderText("hello world");
    }

    public static void main(String[] args){
        JbootApplication.run(args);
    }
}