# jocean-event-api

**Repository Path**: isdom/jocean-event-api

## Basic Information

- **Project Name**: jocean-event-api
- **Description**: jocean : event's API
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2014-12-09
- **Last Updated**: 2023-02-22

## Categories & Tags

**Categories**: utils

**Tags**: None

## README

jocean-event-api
============

jocean's 异步事件库 API

2015-11-19: release 0.0.7 版本:
    
    1、依赖 idiom-0.1.3 release
    2、replace VisitorX by ActionX, replace Function replace by Func1
    3、从 jocean-j2se 中将 EventRegistry 迁移到 jocean-event-api，并更名为ReceiverRegistry
    4、将 receiver2observer 方法签名更新为 变参形式传入事件参数
    5、DefaultInvoker.invokers支持传入事件后缀suffix参数，添加在OnEvent注解表示的事件后，构成完整的绑定事件
    6、精简EventEngine接口:去掉createFromInnerState接口;改变create方法签名，添加参数name,用来指定EventReceiver名字(调试用途),而原来的flow不再是必选参数，可提供0个或多个reactors，reactor可实现
        EventNameAware, 
        EventHandlerAware,
        EndReasonProvider,
        EndReasonAware,
        ExectionLoopAware,
        FlowLifecycleListener,
        FlowStateChangedListener接口
    7、interface rename: EventReceiverSource
    8、新增 FlowStateChangedListener
    9、add constant BizStep: CURRENT_BIZSTEP, 当 flow的业务处理方法返回该常量时，代表不改变当前的BizStep(EventHandler)
    10、新增 GuardPaired 注解，自动化 PairedVisitor 实例在 事件机制中的使用 — 马明 (ming.ma) / githubweb
    11、使用 gradle 构建
    
2014-09-30： release 0.0.6 版本：
  
    1、添加异常EventUnhandleException，用于在事件处理方法中，不再进行当前事件处理的情况下，则可以抛出该异常。如果当前事件是通过实现了EventUnhandleAware接口的Eventable发射的，则事件框架会在稍后调用其对应的onEventUnhandle接口方法
    2、在EventUtils.buildInterfaceAdapter 实现中，处理Thread.currentThread().getContextClassLoader() 返回为 null 的情况，直接使用 intf.getClassLoader()。
  
2014-08-19： release 0.0.5 版本：
    
    1、对通过 buildInterfaceAdapter 产生的对象，默认实现 EventReceiver接口，并在对应接口方法被调用时，委托给 成员变量 receiver 执行
    2、增加自定义注解 GuardReferenceCounted ，并在 EventUtils.buildInterfaceAdapter中根据对应的 接口方法是是否有 GuardReferenceCounted(value=true) 注解，来选择 acceptEvent中传入的事件参数为简单字符串类型，还是 RefcountedGuardEventable 事件对象。
    3、添加 RefcountedGuardEventable 实现 对于单个事件指定 需要在事件送达处理单元后，对于实现了ReferenceCounted 接口的参数，立刻调用 retain 保护参数，并在事件处理完成或被Unhandle之前，调用 相关参数的release 方式进行资源释放
    4、添加 OnDelayed 注解，用来标示用于 delay 事件的处理方法，BizStep 在构造函数中，也会扫描并注册 OnDelayed标注的处理方法
    5、在 BizStep 构造函数中，检查自身是否有EventInvoker，并添加到 _handlers 中
    6、在 BizStep 中增加 delayed 方法，预定义延时事件处理方法。并增加 makePredefineDelayEvent用来根据预设的延时事件处理方法产生延时事件，注意：如果有多个预设延时事件处理方法，则需确保事件参数相同

2014-06-11： release 0.0.4 版本：
    
    1、将 AbstractFlow.fireDelayEventAndPush 变更为 public 方法
    2、http://rdassist.widget-inc.com:65480/browse/CHANNEL-103:改进 AbstractFlow 中的一次性定时器 启动和移除API，将内部保存定时器任务更改为由外部提供Collection<Detachable>来保存定时器任务

2014-05-22： release 0.0.3 版本：
    
    1、使用 buildInterfaceAdapter 传入的Class<?> 类型中的接口方法上的 OnEvent 注解获取事件名称