cn.xnatural.enet.event

类 EP

java.lang.Object

cn.xnatural.enet.event.EP

public class EP
extends Object

event publisher 事件发布器.事件分发中心 TODO 事件死锁. 事件执行链

字段概要

字段

限定符和类型	字段和说明
protected Executor	exec
protected org.slf4j.Logger	log
protected Map<String,List<Listener>>	lsMap 事件名 -> 监听器Listener
protected Pattern	p
protected Set<String>	trackEvents 需要追踪执行的事件名字

构造器概要

构造器

构造器和说明
EP()
EP(Executor exec)
EP(Executor exec, org.slf4j.Logger log)

方法概要

限定符和类型	方法和说明
EP	addListenerSource(Object source) 添加对象源(解析出监听器)
EP	addTrackEvent(String... eNames) 设置某个事件需要追踪执行
EP	delTrackEvent(String... eNames) 删除事件追踪
Set<String>	events() 所有事件名
boolean	exist(String... eNames) 是否存在事件监听器
protected Method	findMethod(Class clz, Predicate<Method> predicate)
Object	fire(EC ec)
Object	fire(EC ec, List<Listener> ls) 发布事件到各个监听者并执行
Object	fire(EC ec, Listener... ls)
Object	fire(String eName) fire(EC)
Object	fire(String eName, Consumer<EC> completeFn, Object... args) fire(EC)
Object	fire(String eName, Object... args) fire(EC)
EP	fireAsync(String eName) 强制异步 fire(EC)
EP	fireAsync(String eName, Consumer<EC> completeFn, Object... args) 强制异步 fire(EC)
EP	fireAsync(String eName, Object... args) 强制异步 fire(EC)
EP	fireAsyncDebug(String eName) 强制异步 fire(EC)
EP	fireAsyncDebug(String eName, Consumer<EC> completeFn, Object... args) 强制异步 fire(EC)
EP	fireAsyncDebug(String eName, Object... args) 强制异步 fire(EC)
Object	fireDebug(String eName) fire(EC)
Object	fireDebug(String eName, Consumer<EC> completeFn, Object... args) fire(EC)
Object	fireDebug(String eName, Object... args) fire(EC)
Object	fireSync(String eName) fire(EC)
Object	fireSync(String eName, Object... args) 强制同步 fire(EC)
Object	fireSyncDebug(String eName) fire(EC)
Object	fireSyncDebug(String eName, Object... args) 强制同步 fire(EC)
protected List<Listener>	getListeners(String eName) 获取 或 创建 监听器
protected void	init(Executor exec, org.slf4j.Logger log) 初始化
protected void	iterateMethod(Class clz, Consumer<Method>... fns)
EP	listen(String eName, BiFunction fn) 添加监听
EP	listen(String eName, boolean async, BiFunction fn) 添加监听
EP	listen(String eName, boolean async, float order, int limit, BiFunction fn) 添加监听
EP	listen(String eName, boolean async, float order, int limit, Function fn) 添加监听
EP	listen(String eName, boolean async, float order, int limit, Runnable fn) 添加监听
EP	listen(String eName, boolean async, Function fn) 添加监听
EP	listen(String eName, boolean async, Runnable fn) 添加监听
EP	listen(String eName, Function fn) 添加监听
EP	listen(String eName, Runnable fn) 添加监听
protected String	parseName(String name, Object source) 支持表达式 {attr}.eventName, {attr}会被替换成 对象中的属性attr的值
EP	removeEvent(String eName) 移除事件对应的所有监听器
EP	removeEvent(String eName, Object source) 只删除指定对象源中的事件监听
EP	removeSourceAllEvent(Object source) 移除对象源的所有监听器
protected void	resolve(Object source) 从一个对象中 解析出 所有带有 EL注解的方法 转换成监听器Listener 如果带有注解 EL的方法被重写, 则用子类的方法
protected void	sort(List<Listener> ls) 监听器排序

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

log

protected org.slf4j.Logger log

exec

protected Executor exec

lsMap

protected Map<String,List<Listener>> lsMap

事件名 -> 监听器Listener

trackEvents

protected Set<String> trackEvents

需要追踪执行的事件名字

p

protected Pattern p

构造器详细资料

EP

public EP()

EP

public EP(Executor exec)

EP

public EP(Executor exec,
          org.slf4j.Logger log)

方法详细资料

init

protected void init(Executor exec,
                    org.slf4j.Logger log)

初始化

参数:

exec - 线程池

fire

public Object fire(String eName)

fire(EC)

参数:

eName - 事件名

fireDebug

public Object fireDebug(String eName)

fire(EC)

参数:

eName - 事件名

fire

public Object fire(String eName,
                   Object... args)

fire(EC)

参数:

eName - 事件名

args - 监听器方法的参数列表

fireDebug

public Object fireDebug(String eName,
                        Object... args)

fire(EC)

参数:

eName - 事件名

args - 监听器方法的参数列表

fire

public Object fire(String eName,
                   Consumer<EC> completeFn,
                   Object... args)

fire(EC)

参数:

eName - 事件名

completeFn - 事件结束回调

args - 监听器方法的参数列表

fireDebug

public Object fireDebug(String eName,
                        Consumer<EC> completeFn,
                        Object... args)

fire(EC)

参数:

eName - 事件名

completeFn - 事件结束回调

args - 监听器方法的参数列表

fireSync

public Object fireSync(String eName)

fire(EC)

参数:

eName - 事件名

fireSyncDebug

public Object fireSyncDebug(String eName)

fire(EC)

参数:

eName - 事件名

fireSync

public Object fireSync(String eName,
                       Object... args)

强制同步 fire(EC)

参数:

eName - 事件名

args - 监听器方法的参数列表

fireSyncDebug

public Object fireSyncDebug(String eName,
                            Object... args)

强制同步 fire(EC)

参数:

eName - 事件名

args - 监听器方法的参数列表

fireAsync

public EP fireAsync(String eName)

强制异步 fire(EC)

参数:

eName - 事件名

fireAsyncDebug

public EP fireAsyncDebug(String eName)

强制异步 fire(EC)

参数:

eName - 事件名

fireAsync

public EP fireAsync(String eName,
                    Object... args)

强制异步 fire(EC)

参数:

eName - 事件名

args - 监听器方法的参数列表

fireAsyncDebug

public EP fireAsyncDebug(String eName,
                         Object... args)

强制异步 fire(EC)

参数:

eName - 事件名

args - 监听器方法的参数列表

fireAsync

public EP fireAsync(String eName,
                    Consumer<EC> completeFn,
                    Object... args)

强制异步 fire(EC)

参数:

eName - 事件名

completeFn - 事件结束回调

args - 监听器方法的参数列表

fireAsyncDebug

public EP fireAsyncDebug(String eName,
                         Consumer<EC> completeFn,
                         Object... args)

强制异步 fire(EC)

参数:

eName - 事件名

completeFn - 事件结束回调

args - 监听器方法的参数列表

fire

public Object fire(EC ec)

fire

public Object fire(EC ec,
                   Listener... ls)

fire

public Object fire(EC ec,
                   List<Listener> ls)

发布事件到各个监听者并执行

参数:

ec - EC 事件执行过程上下文

返回:

事件执行结果. Note: 取返回值时, 要注意是同步执行还是异步执行

exist

public boolean exist(String... eNames)

是否存在事件监听器

参数:

eNames - 事件名

返回:

true if exist

events

public Set<String> events()

所有事件名

addListenerSource

public EP addListenerSource(Object source)

添加对象源(解析出监听器)

参数:

source - 事件源

addTrackEvent

public EP addTrackEvent(String... eNames)

设置某个事件需要追踪执行

参数:

eNames - 事件名字(可以多个)

delTrackEvent

public EP delTrackEvent(String... eNames)

删除事件追踪

参数:

eNames - 事件名

removeEvent

public EP removeEvent(String eName,
                      Object source)

只删除指定对象源中的事件监听

参数:

eName - 事件名

source - 监听器对象源

返回:

EP

removeEvent

public EP removeEvent(String eName)

移除事件对应的所有监听器

参数:

eName - 事件名

返回:

EP

removeSourceAllEvent

public EP removeSourceAllEvent(Object source)

移除对象源的所有监听器

参数:

source - 监听器对象源

返回:

EP

listen

public EP listen(String eName,
                 boolean async,
                 float order,
                 int limit,
                 Runnable fn)

添加监听

参数:

eName - 事件名

async - 是否异步

order - 执行顺序, 越小越先执行

limit - 执行次数限制. <=0 不限制

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 boolean async,
                 float order,
                 int limit,
                 Function fn)

添加监听

参数:

eName - 事件名

async - 是否异步

order - 执行顺序, 越小越先执行

limit - 执行次数限制 <=0 不限制

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 boolean async,
                 float order,
                 int limit,
                 BiFunction fn)

添加监听

参数:

eName - 事件名

async - 是否异步

order - 执行顺序, 越小越先执行

limit - 执行次数限制. <=0 不限制

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 Runnable fn)

添加监听

参数:

eName - 事件名

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 boolean async,
                 Runnable fn)

添加监听

参数:

eName - 事件名

async - 是否异步

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 Function fn)

添加监听

参数:

eName - 事件名

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 boolean async,
                 Function fn)

添加监听

参数:

eName - 事件名

async - 是否异步

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 BiFunction fn)

添加监听

参数:

eName - 事件名

fn - 函数

返回:

EP

listen

public EP listen(String eName,
                 boolean async,
                 BiFunction fn)

添加监听

参数:

eName - 事件名

async - 是否异步

fn - 函数

返回:

EP

resolve

protected void resolve(Object source)

从一个对象中 解析出 所有带有 EL注解的方法 转换成监听器Listener 如果带有注解 EL的方法被重写, 则用子类的方法

参数:

source - 事件源

sort

protected void sort(List<Listener> ls)

监听器排序

getListeners

protected List<Listener> getListeners(String eName)

获取 或 创建 监听器

参数:

eName - 事件名

parseName

protected String parseName(String name,
                           Object source)

支持表达式 {attr}.eventName, {attr}会被替换成 对象中的属性attr的值

参数:

name - 事件名

source - 事件源

返回:

解析后的事件名

iterateMethod

protected void iterateMethod(Class clz,
                             Consumer<Method>... fns)

findMethod

protected Method findMethod(Class clz,
                            Predicate<Method> predicate)