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>

开源推荐

上一篇:Spring boot webflux 中实现 RequestContextHolder


下一篇:Spring boot 微服务核心组件集 mica v1.0.1 发布