fengzhizi715 / PubSub

使用 Kotlin Coroutines 实现的 Local Pub/Sub、Event Bus、Message Bus

PubSub

使用 Kotlin Coroutines 实现的 Local Pub/Sub、Event Bus、Message Bus

下载

将它添加到项目的 root build.gradle 中：

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

然后在项目或者在 module 中添加：

implementation 'com.github.fengzhizi715.PubSub:core:v1.1.0'

Feature

• 支持事件发布和订阅
• 支持 Sticky Event/Retained Event
• 线程安全，可以在任何线程中发布/订阅事件，支持使用指定的线程进行事件订阅
• 支持延时发送事件
• 支持事件发送的异常处理

Usage

1. 定义 EventBus

可以定义全局的 EventBus 或者定义多个 EventBus

val eventBus: Broker by lazy {
    Broker(Dispatchers.IO)
}

2. 定义事件

class XXXEvent

3. 发送事件

eventBus.publish(XXXEvent())

发送 Sticky Event/Retained Event

eventBus.publish(XXXEvent(),true)

延时发送事件

GlobalScope.launch {
    eventBus.publish(XXXEvent(),false,2000)
}

4. 订阅事件

runBlocking{
    eventBus.subscribe<XXXEvent>("subscriber name", this, Dispatchers.IO) {
        ......
    }
}

订阅 Sticky Event/Retained Event

runBlocking{
    eventBus.subscribe<XXXEvent>("subscriber name", this, Dispatchers.IO,true) {
        ......
    }
}

5. 取消订阅

eventBus.unsubscribe("subscriber name")

取消所有的订阅

eventBus.unsubscribeAll()

6. 异常处理

runBlocking {
    eventBus.subscribe<ExceptionEvent>("subscriber name", this, Dispatchers.IO) { event ->
        event.error.printStackTrace()
        ......
    }
}