β

JFinal 3.5 发布,将能上的菜先上了

Harries Blog™ 22 阅读

j final 新功能经过 6 个月的酝酿、 开发 ,在大幅度的创新来临之前,jfinal 3.5 这一版先稳一稳,趁着国庆长假,将能上的菜先上了。

jfinal 3.5 这一版针对这 6 个月以来用户反馈最强烈、最频繁的 需求 进行了开发,同时对原有 代码 进行了极其精致的优化与打磨。

jfinal 3.5 诸多内部优化值得升级使用,诸多基础性调整为下一步进化做好准备。

1、Controller 依赖注入

jfinal 3.5 添加了 Controller 依赖注入功能,使用前需要 配置 启用该功能:

public void configConstant(Constants me) {
    me.setInjectDependency(true);
}

然后在 Controller 中只需对属性使用 @Inject 注解即可:

public class MyController extends Controller {

    @Inject
    Service service;

    public void index() {
        service.justDoIt();
    }
}

添加该功能主要目标是为了 自动化 触发 业务层 AOP 与进一步减少代码量,如上代码中的 Service 中使用的 @Before 配置的拦截器会自动生效,而老版本需要手动 enhance 一次。

2、Interceptor 依赖注入

@Inject 还可以向拦截器属性注入依赖对象,用法与 Controller 之中完全一样:

public class MyInterceptor implements Interceptor {

    @Inject
    Service service;

    public void intercept(Invocation inv) {
        service.justDoIt();
    }
}

jfinal 依赖注入功能与 spring 有着 本质 的不同,jfinal 依赖注入的核心目标是为了实现 AOP 自动化与节省代码量,而且与 IO C 毫无关系,更不需要 IOC 容器。极简设计,实现该功能只用了 243 行代码。

3、Aop 任意时空支持 AOP 及 Inject

jfinal 3.5 添加了 Aop 工具类用来全面取代老版本中的 Enhancer,可在任意地方通过 Aop.get(&hell ip ;) 方法创建 AOP 代理对象,实现 AOP 功能的同时进行依赖注入:

Service service = Aop.get(Service.class);

以上代码会创建 Service 对象,如果 Service 中使用了 @Before 配置过拦截器将会自动生效,如果 Service 中的属性使用了 @Inject,则会被注入依赖对象。还可通过  Aop.inject(…) 方法来注入依赖对象:

Service service = new Service();
service = Aop.inject(service);

以上代码会为 service 中的 @Inject 属性注入依赖对象 ,Aop.inject(…) 方法相对于 Aop.get(…) 少一个对象创建过程。Aop 可以在 Controller、Interceptor 之外快捷使用 AOP、Inject 功能。

4、主干版本加入 action 参数 注入功能

由于老版本照顾了 java 1.6、1.7 用户 编译 级别为 1.6,action 参数注入功能做到了 jfinal-java8 分支版本之中。 jfinal 3.5 最低要求 JDK 1.8,  action 参数注入功能自然也就做到了主干之中:

public class LoginController extends Controller {
    public void index(String userName, String password) {
        Ret ret = service.login(userName, password);
        renderJson(ret);
    }
}

以上 index() 这个 action 被注入了 userName、password 形参,省去了对 getPara、getFile 系列方法的调用代码,将进一步提升开发效率。该功能还支持 File、Model、RawData、Date 等常用类型,还可以通过扩展 IParaGetter 接口实现注入任意类型的 数据 。本功能由 @玛雅牛 大神贡献,再次感谢 @玛雅牛。

5、 jetty server 模块升级为 2018.11 版本

jetty server 模块升级到 jetty 最新版 9.4.12.v20180830, 由于是 java 8 起步,用户可自由升级 jetty 到未来的更高版本。升级后的 jetty server 支持所有版本的 eclipse ,支持 IDE A 热加载,并且统一 eclipse、IDEA 启动参数:

JFinal.start("src/main/webapp", 80, "/", 5);

老版本 jetty server 无法在部分高版本 eclipse 中使用,无法在 IDEA 下支持热加载,jetty server 最新版 maven 坐标如下:

<dependency>
    <groupId>com.jfinal</groupId>
    <artifactId>jetty-server</artifactId>
    <version>2018.11</version>
</dependency>

6、Not Action 注解

NotAction 注解用于 Controller 上原本为 action 的方法之上,可以强制该方法不成为 action:

public abstract class BaseController extends Controller
    
    @NotAction
    public void getLoginUser() {
        ......
    }
}

以上代码中的 getLoginUser() 将不会成为 action,不会生成访问路由,老版本中的 @Before(NotAction.class) 可改用 @NotAction 注解实现。

7、Controller 添加 getRawData()

getRawData() 便于接收客户端发送过来的 json 或者 xml 数据:

public void index() {
    String jsonStr = getRawData();
    User user = FastJson.getJson().parse(jsonStr, User.class);
}

getRawData() 有助于提升 API 型项目的开发体验,在减少代码的同时进一步提升开发效率。

8、Controller 添加 getKv()

getKv() 将表单参数封装成 Kv/ HashMap 对象,方便使用其中的一些工具方法:

public void index() {
    renderJson(getKv());
}

9、enjoy 模板支持自定义 Field表达式

如下代码将支持 object.field 表达式访问  isField() 方法:

Engine.addFieldGetterToLast(new FieldGetters.IsMethodFieldGetter());

通过扩展 IFieldGetter 接口,可以自由 定制 object.field 表达式的获取方式。

10、改进 ClassPathSource

解决 URL.open Connection () 在 linux 下打开文件句柄不能及时关闭的问题。

上述是一些看得到、感知得到的增强与改进,此外还有超过 50 项的内部优化、打磨是看不到的,后续会在 changelog 中整理出来。精益求精的 jfinal 3.5 版本,值得你升级。

One More Thing:

近几天俱乐部将会在线直播讲解 jfinal 3.5 与 club 1.6 的新功能与新用法。与 jfinal 3.5 一同发布的还有俱乐部专享项目 jfinal club 1.6,该项目提供一套极简的权限 管理 以及内容管理后台,截图与功能介绍猛击  传送门
,现在就加入俱乐部获取专享福利: http ://www.jfinal.com/club

作者:Harries Blog™
追心中的海,逐世界的梦
原文地址:JFinal 3.5 发布,将能上的菜先上了, 感谢原作者分享。

发表评论