JFinal-event v2.3.0 发布,简化 Event 事件类

说明

JFinal-event 2.x 参考 Spring 4.2.xEvent 的使用方式而生,为 JFinal 用户带来更多方便。其核心目标是深层次解耦,为您节约更多时间,去陪恋人、家人和朋友 :)

年初 @idoz 提议实现类似 Spring 4.2 里的 PayloadApplicationEvent,其实我早就有此想法,一直没有抽出时间来折腾。

顺便在 码云上添加了 issues 3.0优化,有2点功能:

第一点,实现 PayloadApplicationEvent 不难。扩展个 EventType

class1 为 ApplicationEvent 类 或者 PayloadApplicationEvent类信息class2 为 ApplicationEvent 泛型,或者 Payload 中的类信息

第二点,将类扫描改为 annotation Processor 编译期处理(避免容器环境差异)

由于 @EventListener 注解可以在任何方法中,annotation Processor 需要扫描 *,然后 找出 对应的含有 @EventListener 方法的类,然后写入 META-INF/dream.events 文件中。

本次版本升级完成了第一点,第二点由于觉得更加适合底层框架去实现,从而方便扩展,对于 annotation Processor 感兴趣的朋友可以了解我的开源 mica-auto

更新说明

2019-04-08 v2.3.0

  • 升级到 jfinal 3.8。

  • 支持 @EventListener 方法可以无参数。

  • ObjenesisBeanFactory 和 jfinal Aop inject 冲突,去掉对 JFinal inject 支持,标记为弃用。

  • 新增 SourceClass 作为 event 事件源(同 Spring PayloadApplicationEvent),event模型不再需要实现 ApplicationEvent

  • @EventListener 注解新增 value 变量,功能同 events。

  • 修复 @EventListener events 参数类型判断bug。

初始化插件


// 初始化插件
EventPlugin plugin = new EventPlugin();
// 设置为异步,默认同步,或者使用`threadPool(ExecutorService executorService)`自定义线程池。
plugin.async();

// 设置扫描jar包,默认不扫描
plugin.scanJar();
// 设置监听器默认包,多个包名使用;分割,默认全扫描
plugin.scanPackage("net.dreamlu");
// bean工厂,默认为DefaultBeanFactory,可实现IBeanFactory自定义扩展
// 对于将@EventListener写在不含无参构造器的类需要使用`ObjenesisBeanFactory`(2.3.0 已经不推荐使用)
plugin.beanFactory(new ObjenesisBeanFactory());

// 手动启动插件,用于main方法启动,jfinal中不需要,添加插件即可。
plugin.start();

// 停止插件,用于main方法测试
plugin.stop();

新建事件类(任意模型即可 2.3.0支持)


public class AccountEvent {

private Integer id;
private String name;
private Integer age;

// 省略 get set

}

编写监听


@EventListener
public void listenTest1Event(AccountEvent event) {
   System.out.println("AccountEvent:" + event);
}

发送事件


AccountEvent event = new AccountEvent();
event.setId(1);
event.setName("张三");
event.setAge(18);

EventKit.post(event);

@EventListener注解说明

示例


@EventListener(events = Test1Event.class, order = 1, async = true, condition = "event.isExec()")

说明

  • valueevents支持的事件类型数组,用于将事件方法定义为ApplicationEvent或者自定义父类。


public class Test {

   // Test1Event, Test2Event 为 TestEvent 子类
   @EventListener({Test1Event.class, Test2Event.class})
   public void applicationEvent(TestEvent event) {
       System.out.println(Thread.currentThread().getName() + "\tevent:" + event);
   }
}
  • order排序,数值越小越先执行,默认为Integer.MAX_VALUE

  • async异步执行,需要插件开启async()或者自定义线程池。

  • condition表达式条件,使用event.xxxx,event.isExec() == true判定event的属性或者方法。

jar依赖

jar包下载http://central.maven.org/maven2/net/dreamlu/JFinal-event/

以上版本均已上传到maven仓库~


<dependency>
   <groupId>net.dreamlu</groupId>
   <artifactId>JFinal-event</artifactId>
   <version>2.3.0</version>
</dependency>

关注我们

扫描上面二维码,更多精彩内容每天推荐!

评论区

要输就输给追求

2019-04-08 22:33

感谢。这个插件非常有用

jounzhang

2019-04-09 10:19

1分钟没看懂,说明不值得用

北流家园网

2019-04-09 10:35

我也没看懂有什么用

JFinal

2019-04-09 11:38

终于升级了,赞

看来 jfinal undertow 中要添加 hot swap class prefix : net.dreamlu.

在使用 jfinal undertow 1.6 的时候需要自己配置一下
addHotSwapClassPrefix("net.dreamlu.");

也可以在 undertow.txt 中配置:
undertow.hotSwapClassPrefix = "net.dreamlu."

lyh061619

2019-04-09 14:29

好东西,终于升级了,强

Dreamlu

2019-04-09 14:32

@jounzhang @北流家园网 现在社会越来越浮躁了,作为一个开发者这样不好。把事件机制搞明白了自然就知道他是啥了,咱们拿html来举例,一个 a 标签被点击了(不阻止冒泡的情况下),你有多少个监听,就会触发多少次,相对应的他的各个父节点也会触发,原理就是这样。再例如:用户创建功能了,你发邮件、存积分、发短信、发钉钉等等,你只需要在你用户保存成功里发一个 event 出来,具体监听分而治之。JFinal-event 从第一版本到现在 已经有4年了,各大公司都有在用,也是我一直维护的动力。

Dreamlu

2019-04-09 14:34

@JFinal 想实现这个功能很久了,最近回长沙了还没工作抽了点时间更新了下,本来比这个实现要复杂,跟老婆爬了个岳麓山思考了下,回来删除了几个类,也符合JFinal极简风格。

JFinal

2019-04-09 17:15

@Dreamlu 我记得你是明年才回长沙的? 提前一年了?

錢勢惘導

2019-04-09 18:25

"ObjenesisBeanFactory 和 jfinal Aop inject 冲突"可以解释一下这句话吗?是用了jfinal Aop inject既不能用event了吗?

bobotianxia

2019-04-09 21:12

@Dreamlu 新版EventPlugin更好用了,非常棒!

Dreamlu

2019-04-09 21:23

@錢勢惘導 不是,ObjenesisBeanFactory 创建的 bean,不能用 jfinal Aop inject 增强,ObjenesisBeanFactory 的意义在于不需要无参构造器。inject 里 cglib 需要无参构造器。 所以把里面的去掉 jfinal Aop inject 了,再说我觉得 ObjenesisBeanFactory 已经没有存在的意义了,之前 是有朋友把 监听器 和 event 写在一个类里,老 ApplicationEvent 父类里没有默认构造器,现在 event 不需要继承了。

Dreamlu

2019-04-09 21:23

@bobotianxia 多谢支持~

Dreamlu

2019-04-09 21:24

@JFinal 回了,找了几个公司了还是阔以,麓谷这块公司挺多的。

JFinal

2019-04-09 22:43

@Dreamlu 长沙的公司能否用上 jfinal ?

flyinkeke

2019-04-10 12:35

太好用了,项目必备

jounzhang

2019-04-10 15:30

@Dreamlu 我错了,不该开这样的玩笑~

时间机制如何保证消息到达不丢失?比如系统宕机

Dreamlu

2019-04-10 15:46

@jounzhang 不是夸 jvm 的,其实相当于方法调用,系统宕机,你方法调用也处理不了。

jounzhang

2019-04-10 16:18

@Dreamlu 事件机制是不是用了多线程来处理的,也就是如果存在事务场景的话,就不能使用这个对吗?适用于非强一致性的触发场景

Dreamlu

2019-04-10 16:54

@jounzhang 对对,支持同步或异步,对事物要求比较严格的建议就同步了,事件里抛出异常也会回滚,异步的话就适合对事物不那么强的需求的场景。

北流家园网

2019-04-10 20:54

@Dreamlu 这个插件跟websocket有什么不同吗?event可以给页面推送消息吗?

Dreamlu

2019-04-11 09:25

@北流家园网 websocket 里可以结合 jfinal-event 来用,跟 web 没关系,我只是举例,纯后端业务解耦

热门分享

扫码入社