本文来自chowpan的投稿
IMXEventBus
功能列表:
以订阅/发布的模式实现跨组件通信,也即通信模块。类似NSNotification的通信功能。
生命周期管理:注册的事件订阅者可自动释放,也可手动管理其释放时机。
优先级处理:触发事件时,通过预设值的优先级,决定执行订阅者回调的先后顺序。
订阅者回调在主线程/非主线程执行的控制。
Debug模式下:增加输出所有Event信息。
如何使用:
1.)导入:
1.Cocoapods:pod 'IMXEventBus', '~> 1.0.0'
2.手动导入:本库无依赖其它三方库,直接将IMXEventBus文件夹拖入项目即可。
2.)头文件引入:
#import "IMXEventBusKit.h"
3.)功能使用:
1. 注册:
简略模式:
//默认值://优先级:Default;回调执行:非主线程[IMXEventSubscriber addTarget:self name:@"login_eventName" action:^(IMXEventUserInfo *info) { NSLog(@"callback info:%@ thread:%@",[info description], [NSThread currentThread]); }];
全参模式:
[IMXEventSubscriber addTarget:self name:@"login_eventName" priority:IMXEventSubscriberPriorityDefault inMainTread:YES action:^(IMXEventUserInfo *info) {NSLog(@"callback info:%@ thread:%@",[info description],[NSThread currentThread]); }];
默认情况下,优先级是default,回调均是在非主线程下执行。
2. 触发事件:
简略模式:
//默认值://被触发的事件:不强制在主线程中执行回调[IMXEventPoster postEventName:@"login_eventName" object:@{@"userName":@"demo"}];
全参模式:
[IMXEventPoster postEventName:@"login_eventName" object:nil forceMain:YES];
默认情况下,firceMain:NO。即所有被触发的监听对象,其回调执行均参考自身属性isInMainThread;否则均强制在主线程执行。
3. Debug:
功能汇总(仅在Debug模式下,log处理):
注:仅输出之前的Event调用情况,无法检测输出之后的log,故输出的数目不代表最终数据。
重复添加target对应的同一事件时,会打印或者弹出log提示。
post时,无对应的监听者存在,会打印或者弹出log提示。
Debug模式下:输出所有Event信息。(便于检测当前无订阅者的僵尸事件以及未被触发的事件)
开启Debug功能:默认不开启。
[IMXEventDebug_share enableDebug:YES]; IMXEventDebug_share.debugType = IMXEventDebugTypeAlert;
无论如何设置,Debug功能仅在Debug模式下起作用。
要点及图谱:
注册事件、触发事件、移除事件等操作均针对同一队列操作:所有操作均嵌入异步串行队列之中,保证了资源存取的线程安全。
事件监听者对象分别由3个不同优先级的NSMapTable队列存储:以Target:Model方式存储,对应Target由于生命周期问题释放后,那么事件队列中相关条目会被自动释放。但无法实时检测到,故发布事件时均需巡检一次。
触发事件时:轮询3个不同优先级对类,执行每个监听者对象的回调:执行操作均放在并行队列中,并创建信号量控制线程的数量。且并行队列嵌入在串行队列中,保证3个对类按其优先级顺序执行。
图谱1:类图结构
图谱2:事件注册流程图
图谱3:事件触发流程图
结构描述:
一、数据:
1. IMXEventSubscribModel:订阅者对象
数据
actionBlock:post触发时执行该回调
priority:优先级,决定订阅者对象预置入哪个队列以及后续执行序列。(在IMXEventBus中使用)
isInMainThread:是否在主线程/非主线程执行actionBlock
target:弱引用形式,暂未使用场景
行为
actionWIthInfo:forceMainThread::回调执行最终实现
2. IMXEventUserInfo:poster传输数据
数据
userInfo:字典对象
待扩展
二、逻辑处理:
1. IMXEvent:事件
功能:单一事件对象。
注册订阅者对象
响应poster触发事件
即管理和调度订阅者队列
数据
eventName:事件名称,唯一标识一个事件。
mapHigh、mapDefault、mapLow:私有属性。订阅者队列。NSMaptable定制,target释放,对应记录也自动释放的特性。
行为
hasContainedSubscribModelForKey::检查各队列中是否包含Key对应的订阅者。
registSubscribModel:forKey::注册订阅者至对应队列。
postEventWithDeliveryData:isInMain:事件出发,逐个执行事件中各队列的订阅者行为。
并行队列嵌入至串行队列:保证3个优先级队列顺序执行。
并行队列:保证单个事件队列中各订阅者行为并行执行。
信号量处理:控制线程数量,并行数。
deleteEntryForTarget::删除事件中Target对应的一条订阅者记录。
isEmptyMap:各优先级对应的队列是否全为空
2. IMXEventBus:单例模式,事件集合。
数据
events:事件集合。所有针对该集合的处理均在异步线程中串行执行,非阻塞主线程行为。
行为
registSubscribModel:markEvent:priority:inMainTread:action::注册订阅者
publishEvent:delivery:isFromMainTread::触发事件
unregistSubscribModelFromTarget:: 解注册Target对应的订阅者:若解除后事件无相关订阅者,则移除该Event对象。
removeEvent:: 移除事件
三、public文件:
1. IMXEventSubscriber:注册订阅者
主要是针对IMXEventBus注册接口的封装。如将优先级和是否主线程执行回调统一置常用值为默认值。
2. IMXEventPoster:post触发事件
主要是针对IMXEventBus发布接口的封装。将是否主线程执行回调统一置常用值为默认值。
待完善:
Target子类化对象中与Target本身存在有同名事件处理问题(过滤去重功能)。
延时触发事件。
条件触发。
其它
参考:
更新Pods开源库
1.提交code至github,或改version或保持不变(更改版本时不需要第3步骤)。
2.pod trunk register
'' --description=''
3.pod trunk delete IMXEventBus 1.0.0
4.pod trunk push --allow-warnings
5.使用时:pod setup更新