模仿的Spring中的消息事件：详解Spring事件驱动模型

专为JFinal设计，无任何第三方依赖，小巧玲珑。

JFinal-event 插件，老版本使用请查看文档 wiki

如梦技术VIP 限时￥99，欢迎加入

初始化插件

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

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

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

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

新建事件类

// 继承 ApplicationEvent
public class Test1Event extends ApplicationEvent {

    private static final long serialVersionUID = 6994987952247306131L;
    
    public Test1Event(Object source) {
        super(source);
    }

}

编写监听

@EventListener
public void listenTest1Event(Test1Event event) {
    System.out.println("Test1Event：" + event.getSource());
}

发送事件

EventKit.post(new Test1Event("hello1"));

@EventListener注解说明

示例

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

说明

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

@EventListener(events = Test1Event.class)
public void applicationEvent(ApplicationEvent event) {
    String xx = (String) event.getSource();
    System.out.println(Thread.currentThread().getName() + "\tsource:" + xx);
}

order排序，数值越小越先执行，默认为Integer.MAX_VALUE

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

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

使用的场景优势

请参考详解Spring事件驱动模型

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

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

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

欢迎拍砖~~~

更新说明

2018-10-09 v2.2.2

升级到jfinal 3.5 (不兼容老版本)支持新版本inject，升级到java 8优化部分代码。 DefaultBeanFactory改为jfinal 3.5 aop 创建，删除 DuangBeanFactory。 优化 ObjenesisBeanFactory 支持jfinal 3.5 inject

2018-08-14 v2.2.1

ApplicationEvent 添加泛型，方便类型转换。

2018-04-15 v2.2.0

插件添加手动注册监听类 plugin.register(Class<?> clazz), 多个类，多次调用register方法即可。

2018-03-02 v2.1.0

添加CtrlHolderEvent处理同步、异步中request、session、attr、header参数传递。 使用： 需先在Config中添加me.add(new CtrlHolderInterceptor());拦截器。 然后继承CtrlHolderEvent编写自己的事件类

CtrlHolder holder = event.getCtrlHolder();
holder.getPara("p");
holder.getAttr("x");
holder.getHeader("x");
holder.getSessionAttr("x");

2017-11-29 v2.0.4

添加ObjenesisBeanFactory处理不含有默认构造器的Bean 依赖objenesisjar包，下载地址：http://mvnrepository.com/artifact/org.objenesis/objenesis/2.6

2017-10-11 v2.0.3

用户反馈的问题 #IFX3Z 支持多包名，用;分割，如：net.dreamlu.a;net.dreamlu.b。 插件初始化时，没有扫描到监听时依然初始化成功。

2017-10-11 v2.0.2

2.x bug修复版

2017-10-11 v2.0.1

插件添加Bean工厂，方便IOC容器和自定义扩展。 默认为DefaultBeanFactory，可实现IBeanFactory自定义扩展。 plugin.beanFactory(new DuangBeanFactory());

2017-10-10 v2.0.0

基于注解和方法的兼听，简化使用，不兼容1.x 支持JFinal 3.1和3.1以上版本

2017-04-20 v1.5.1

基于rmi的远程Event

2017-03-22 v1.4.2

1. 更改默认线程池为SingleThreadExecutor，使异步执行有序化。
2. 添加EventThreadFactory，处理异步时的异常避免影响服务请求。 建议：如果event需要发送大量的异步事件，建议使用自定义线程池。 eventPlugin.threadPool(Executors.newCachedThreadPool(new EventThreadFactory()));

2017-02-15 v1.4.1

1. 添加自定义线程池EventPlugin.threadPool(ExecutorService executorService)方法

2016-08-19 v1.4.0

1. 升级到JFinal2.2，JFinal低版本用户请使用v1.2.0。
2. EventKit.postEvent(event)更改为EventKit.post(event)，postEvent不再建议使用。
3. 添加EventKit.post(tag, event)方法，@Listener(order = 2, tag = "save")添加tag。

2015-12-30 v1.3.0

1. 升级到JFinal2.1，JFinal低版本用户请使用v1.2.0

2015-08-20 v1.2.0

1. 解决部署时中文路径或者是空格找不到监听器

2015-07-05 v1.0

1. 调优，减少不必要的实例

2015-07-04 v0.4.2

1. 编译改为JDK1.6
2. 新增监听器执行顺序@Listener(order = 1) 越小越优先执行，Default is Integer.MAX_VALUE
3. 新增单个监听器的，同步或者异步开关@Listener(enableAsync = true)

交流群

如梦技术：237587118

捐助共勉

License

( The MIT License )