JFinal 3.6 发布，五弹齐发迎新年

春节前处理完年前用户反馈的需求与改进，来年只需专注面向未来。 jfinal 3.6 有近 40 项增强与改进，部分功能与改进十分有价值，值得你拥有。

一、第一弹 JFinal 3.6

1、Controller 添加 set 方法

由于 setAttr 方法使用频率极高，为了进一步减少代码量、提升开发效率，新增了 set 方法，其使用方式与 setAttr 完全一样：

// 常见用法
set("user", user);

// 链式用法
set("user", user).set("article", article).render("index.html");

set 方法相对于 setAttr 可以减少五次按键，用户体验更好。原方法 setAttr 会永久保留。

2、Controller 添加 get 系方法

与 setAttr 方法同样高频使用的 getPara、getParaToXxx 方法也进行了同样改进，添加 get 系方法，进一步减少代码量，提升开发体验：

// get 系替代 getPara 系
get("title");

// getXxx 系替代 getParaToXxx 系
getInt("value");
getLong("counter");

当然，使用 action 注入比这更省代码：

// title、content 参数值会被自动注入
public void index(String title, String content) {
   service.save(title, content);
}

set 与 get 系方法的添加，持续表达着 jfinal 在提升开发效率、开发体验方面永不止步的追求，未来也将永远进行下去。

3、模板引擎添加 #switch 指令

#switch 指令特色之一是 #case 分支支持多参数：

#switch (month)
  #case (1, 3, 5, 7, 8, 10, 12)
    #(month) 月有 31 天
  #case (2)
    #(month) 月平年有28天，闰年有29天
  #default
    月份错误: #(month ?? "null")
#end

如上代码所示，#case 分支指令支持以逗号分隔的多个参数，这个功能就消解掉了 #break 指令的必要性，所以 enjoy 模板引擎是不需要 #break 指令的。

特色之二是 #case 参数支持任意表达式：

#case (a, b, x + y, "abc", "123")

上述代码中用逗号分隔的表达式先会被求值，然后再逐一与 #switch(value) 指令中的 value 进行比较，只要有一个值与其相等则该 case 分支会被执行。

#case 支持逗号分隔的多参数，从而无需引入 #break 指令，不仅减少了代码量，而且避免了忘写 #break 指令时带来的错误隐患。

4、模板引擎添加 #call 指令

使用 #call 指令，模板函数的名称与参数都可以动态指定，提升模板函数调用的灵活性，用法如下：

#call(funcName, p1, p2, ..., pn)

上述代码中的 funcName 为函数名，p1、p2、pn 为被调用函数所使用的参数。如果希望模板函数不存在时忽略其调用，添加常量值 true 在第一个参数位置即可：

#call(true, funcName, p1, p2, ..., pn)

5、Generator 生成器添加生成备注功能

数据库表字段中如果有备注可以生成在 getter、setter 方法之上，只需要一行配置即可：

generator.setGenerateRemarks(true);

生成备注以后，在开发时将鼠标指针放在方法名之上会自动弹出备注内容，消灭掉对数据表字段含义的记忆负担。

6、增强 Tx 事务拦拦截器

老版本 jfinal 应用在 Controller 上的 Tx 拦截器，如果使用 try catch 捕获异常，不太方便指定异常时响应的页面或者数据，通常需要使用一个全局拦截器统一管理。 jfinal 3.6 新版本改进后可以支持下面的用法：

@Before(Tx.class)
public void trans {
  try {
    service.justDoIt(...);
    render("ok.html");
  } catch (Exception e) {
    render("error.html");
    throw e;
  }
}

如上代码所示，在 catch 块中可以使用 render，也可以使用 renderJson 来灵活响应数据，注意最后别忘了 throw e 抛出异常，好让 Tx 拦截器感知异常并回滚事务。

7、Kv、Ret 添加 setIfNotNull 与 setIfNotBlank 方法

jfinal 俱乐部 QQ 群中经常发现小伙伴们的代码是下面这样的：

if (value != null) {
  kv.set("value", value);
}

if (StrKit.notBlank(value)) {
  kv.set("value", value);
}

用上 jfinal 3.6 以后，代码可以简化成下面这样的：

kv.setIfNotNull("value", value);

kv.setIfNotBlank("value", value);

这仍然是 jfinal 追求更高开发效率，更爽开发体验的继续表达。

8、Db 添加对 String 变量模板的支持

jfinal 3.0 针对于外部 sql 文件管理，添加了 #sql、#para、#namespace 三指令极简支持，小伙伴们已然爽翻了，没想到还有人提出了支持 String 变量管理 sql 的支持，用法是下面这样的：

String str = "select * from girls where age < #para(0) and weight < #para(1)";
SqlPara sp = Db.getSqlParaByString(str, 19, 50);
Db.find(sp);

确实有些小伙伴喜欢将简单 sql 写在 java 代码中，但同时又希望用上 enjoy 引擎来管理 sql。如果没有这个功能的支持，往往要使用 StringBuilder 进行 sql 拼接，代码将会十分丑陋，而且与 SQL 配套的 Object... paras 处理起来也麻烦很多。

9、Model、Db 添加 findAll()

为了避免 select * 被大量使用，以及该功能可通过 find("select * from t") 比较方便地被消解掉，jfinal 一直未提供 findAll() 方法。但对于有些项目中存在一些类似于 dic 字典表这种小规模数据的 table 就能省些代码，对于这类需求，可以这么用了：

List<dictionary> = dictionaryList = dictionary.findAll();

仍然是追求开发效率、开发体验的继续表达。

10、新增 onStart、onStop

新增 onStart()、onStop() 回调方法，分别替代 JFinalFilter 中的 afterJFinalStart()、beforeJFinalStop()，在减少代码量输出的同时，降低手动入错误的概率，而且还降低了记忆成本。

11、解决升到 JDK 8 以后的类型转换错误

jfinal 3.5 版本以 JDK 8 起步以后，Model、Db 中的 findById、deleteById 在某些情况下会出现类型转换异常， jfinal 3.6 版本将针对多主键/联合主键的 findById、deleteById 添加了后缀字符 's' 解决了该问题

所以，如果你的老项目中有涉及多主键联合主键的 findById、deleteById 方法的使用，需要改成下面的用法：

document.findByIds(1, 1);

Db.deleteByIds("user_role", "userId, roleId", 123, 456);

升级以后，如果有地主需要改的话，eclipse/IDEA 会提示要改的地方，所以升级很安全。

12、优化路由映射性能

新增 Routes.setMappingSuperClass(boolean) 方法，可以配置是否要对 Controller 的超类中的 public 方法进行路由映射，默认值为 false。该优化的效果是会随着 controller 数量的增加而增加的。

这里要注意一个或级问题，如果用到了 jfinal weixin 项目，并且用到了其中的 MsgController，需要配置一下：

public void configRoute(Routes me) {
  me.setMappingSuperClass(true);
}

因为 MsgController 中作为超类而存在的，其中的 index() 方法必须要被映射才能分发微信服务器发来的消息。

更多改进与增强可以在官网下载 changelog： http://www.jfinal.com

二、第二弹 JFinal Undertow 1.5

传送门： JFinal Undertow 1.5 发布，稳定、可靠服役于生产环境

三、第三弹 JFinal Weixin 2.3

传送门： JFinal Weixin 2.3 发布，早已支持微信小程序开发

四、第四弹 Enjoy 3.6

传送门： Enjoy 3.6 发布，Java 开发者专用超轻量级模板引擎

五、第五弹 Jetty Server 2019.1

传送门：Jetty Server 2019.1

ONE MORE THING ：jfinal 新版本资源已更新并发布在了 jfinal 官网，maven 中心库也已经上传，可以极速升级。俱乐部福利也更新了一波： https://www.jfinal.com/club 。 新福利计划也已出台： https://www.jfinal.com/club/1-2