Android轻量级事件通信方案

简介:

开发过程中,总会遇到一些需要通信的场景。
如果逻辑比较简单,通过常规的传参,回调,返回值等即可实现。
而如果调用层次较深(如跨模块,跨线程等),光靠传参和回调等手段,耦合度较高,
对于需要主动通知,通知多个组件等场景,更是捉襟见肘。
为解耦事件的发布与订阅主体,简化组件间通信,可引入事件通信机制。

事件通知包含哪些内容?
事件的定义,注册/注销,通知。
事件框架如何实现?
一个接口,一个事件管理类,足矣。
代码不足50行,名副其实的“轻量级”。

方案实现

定义接口
interface Observer {
    fun onEvent(event: Int, vararg args : Any?)
    fun listEvents(): IntArray
}

接口定义了两个方法:
listEvents: 返回关注的事件;
onEvent: 发生事件时回调此接口并返回事件和参数(可缺省)。

事件管理
object EventManager {
    private val HANDLER = Handler(Looper.getMainLooper())
    private val OBSERVER_ARRAY = SparseArray<LinkedList<Observer>>(16)

    @Synchronized
    fun register(observer: Observer?) {
        observer?.listEvents()?.forEach { event ->
            var observerList = OBSERVER_ARRAY.get(event)
            if (observerList == null) {
                observerList = LinkedList()
                OBSERVER_ARRAY.put(event, observerList)
            }
            if (observer !in observerList) {
                observerList.add(observer)
            }
        }
    }

    @Synchronized
    fun unregister(observer: Observer?) {
        observer?.listEvents()?.forEach { event ->
            OBSERVER_ARRAY.get(event)?.removeLastOccurrence(observer)
        }
    }

    @Synchronized
    fun notify(event: Int, vararg args: Any?) {
        OBSERVER_ARRAY.get(event)?.forEach { observer ->
            HANDLER.post { observer.onEvent(event, *args) }
        }
    }
}

HANDLER:事件通知器,使事件接口统一在UI线程回调;
OBSERVER_ARRAY:关联事件和观察者的容器。
SparseArray> 等价于 Map>,其key为事件, value为关注此事件的观察者。
register: 将Observer放入其所关注的事件对应的list;
notify: 遍历指定事件对应的list, 回调Observer的onEvent()。

如下图所示,将其展开,是一个多对多的十字结构:

简而言之,就是:一个事件可被多个观察者关注,一个观察者可关注多个事件。

使用方法

以一个简单的登录/注销场景为例:

1、定义事件
object Events {
    const val LOGIN = 1
    const val LOGOUT = 2
}
2、注册/注销
abstract class BaseActivity : AppCompatActivity(), Observer {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        EventManager.register(this)
    }

    override fun onDestroy() {
        super.onDestroy()
        EventManager.unregister(this)
    }

    override fun onEvent(event: Int, vararg args: Any?) {
    }

    override fun listEvents(): IntArray {
        return IntArray(0)
    }
}

像 Activity 和 Fragment 这种有固定生命周期的类,可以在Base添加注册和注销代码;
但并非每个子类都需要注册事件,所以可以先实现空方法,需要注册的子类自行重载即可。

3、订阅事件&处理回调
class MainActivity : BaseActivity() {
    public override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val switchAccountBtn: Button = findViewById(R.id.switch_account_btn)
        switchAccountBtn.setOnClickListener {
            if (!AccountManager.isLogin) {
                startActivity(LoginActivity::class.java)
            } else {
                AccountManager.logout()
            }
        }
    }

    private fun setViews(account: String?) {
        // update views
    }

    override fun listEvents(): IntArray {
        return intArrayOf(Events.LOGIN, Events.LOGOUT)
    }

    override fun onEvent(event: Int, vararg args: Any?) {
        when (event) {
            Events.LOGIN -> setViews(args[0] as String?)
            Events.LOGOUT -> setViews(null)
        }
    }
}

由于事件是在UI线程回调,所以可以直接更新UI;若需要做耗时处理,需要另起线程。

4、发送事件
object AccountManager {
    fun login(account: String, password: String) {
        // process login
        EventManager.notify(Events.LOGIN, account)
    }

    fun logout() {
        // process logout
        EventManager.notify(Events.LOGOUT)
    }
}

发送事件可以只发送事件,也可以同时携带参数。
参数类型,最初尝试用Bundle, 但是Bundle传参需要封装和拆解;
后来换用vararg,所以可以添加任意参数,使用也相对方便。

原理分析

从各种事件框架,到系统广播,到View的listener回调,思路都是类似的,但有各种不同的形式,从各种各样名字就可见一斑。
其中被对比的最多的是 观察者模式事件监听模式
若非要分类,该方案应该是后者。

作为对比,我们以 《JAVA与模式》之观察者模式 中介绍的个例子为参考,其类图如下:

其中,Subject为被观察对象,有的地方也用Observable。
被观察对象的状态(state)变化改变时, attach到此对象的观察者的update()会被回调。

前面举例的方案,结构图如下:

两者的共性在于,都是“订阅->通知”的一种模式。
两者的区别在于:一个关注物的变化,一个关注事的发生。

上面的例子中,大概流程如下:

整体还是比较简单的,页面创建时订阅消息,销毁时取消订阅;
从MainActivity到LoginActivity,再到AccountManager, 既跨页面也跨线程,
但由于EventManager持有MainActivity引用,所以可以方便地通知。
不单是Activity, Fragment等UI组件,任何对象都可以通过实现Observer接口成为观察者,然后通过EventManager订阅自己感兴趣的事件。

其他事项

生命周期

引用观察者的是个静态对象,所以观察者生命周期结束时需要确保取消订阅,以免内存泄漏。
如果观察者也是静态对象,则不用取消订阅。
如果不确定对象生命周期结束前是否可以取消订阅,可借助弱应用来防止内存泄漏:

class WeakObserver(target: Observer) : Observer {
    private val reference: WeakReference<Observer> = WeakReference(target)
    private val events: IntArray = target.listEvents()

    override fun onEvent(event: Int, vararg args: Any?) {
        reference.get()?.onEvent(event, *args)
    }

    override fun listEvents(): IntArray {
        return events
    }
}

WeakObserver和WeakHandle类似,都是通过实现接口以及弱应用来进行包装。

重复检查

当事件定义变多后,有可能一个不小心,事件的value就重复了。

object Events {
    const val LOGIN = 1
    const val LOGOUT = 2
    // ...
    const val SOMETHING = 2
}

若重复定义,可能会相互干扰。
为此,可编写单元测试检查事件的value是否重复:

    fun testDuplicate() {
        val fields = Events::class.java.declaredFields
        val events = fields.filter { it.type == Int::class.java }
        val eventSet = events.map { it.getInt(Events::class.java) }.toSet()
        Assert.assertEquals(events.size, eventSet.size)
    }

如上定义, 单元测试会报错:

junit.framework.AssertionFailedError: expected:<3> but was:<2>

查看事件

通过“Find Usages”快捷键,可以查看所有订阅者和事件发送的地方。

结语

说到事件框架,大家可能会想到EventBus。
相比而言,EventBus有粘性事件,可指定回调线程等特性;
而此方案则是轻量,以及清晰的事件管理。

本文主要是介绍事件通信的思想和一些实现技巧,旨在抛砖引入,欢迎各位读者批评指正。

附上演示Demo, 感兴趣的读者可以下载回来Run一下。
github地址: LigntEvent

相关文章
|
4月前
|
XML Java Android开发
Android Studio App开发之捕获屏幕的变更事件实战(包括竖屏与横屏切换,回到桌面与切换到任务列表)
Android Studio App开发之捕获屏幕的变更事件实战(包括竖屏与横屏切换,回到桌面与切换到任务列表)
38 0
|
7月前
|
存储 网络协议 物联网
Android集成MQTT教程:实现高效通信和实时消息传输
Android集成MQTT教程:实现高效通信和实时消息传输
587 0
|
7月前
|
编解码 物联网 开发工具
Android平台内网RTSP网关和轻量级RTSP服务的区别和联系
我们在对接轻量级RTSP服务的时候,遇到客户这样的使用场景:客户是用于车载自组网环境,确保多辆车之间可以相互看到对方的实时视频,以期可以了解到前方路况等关注的信息。
101 0
|
7月前
|
编解码 监控 开发工具
如何同时启动Android平台GB28181设备接入模块和轻量级RTSP服务模块?
为什么要设计GB28181设备接入模块?GB28181接入SDK,实现不具备国标音视频能力的 Android终端,通过平台注册接入到现有的GB/T28181—2016服务,可用于如智能监控、智慧零售、智慧教育、远程办公、生产运输、智慧交通、车载或执法记录仪等场景。Android终端除支持常规的音视频数据接入外,还可以支持移动设备位置(MobilePosition)订阅和通知、语音广播和语音对讲、云台控制和预置位查询等。
|
7月前
|
编解码 开发工具 Android开发
Android平台RTSP轻量级服务|RTMP推送摄像头或屏幕之音频接口设计
好多开发者在做Android平台录像或者RTSP轻量级服务、RTMP推送相关模块时,对需要设计哪些常用接口会心存疑惑,本文主要以大牛直播SDK(官方)为例,简单介绍下Android平台直播推送SDK所有音频相关的接口,感兴趣的开发者可以看看。
|
4月前
|
小程序 JavaScript 前端开发
微信小程序(十七)小程序监听返回键跳转事件(安卓返回也适用)
onUnload:function(){ wx.redirectTo({ url: '../index/index' }) wx.navigateTo({ url: '../index/index' }) wx.switchTab({ url: '../../member/member' }) }
297 0
|
7月前
|
编解码 开发工具 Android开发
Android平台如何实现外部RTSP|RTMP流注入轻量级RTSP服务模块(内网RTSP网关)
今天分享的是外部RTSP或RTMP流,拉取后注入到本地轻量级RTSP服务模块,供内网小并发场景下使用,这里我们叫做内网RTSP网关模块。
|
3月前
|
开发工具 Android开发
Android平台RTMP推送|轻量级RTSP服务|GB28181设备接入模块之实时快照保存JPG还是PNG?
Android平台RTMP推送|轻量级RTSP服务|GB28181设备接入模块之实时快照保存JPG还是PNG?
|
3月前
|
数据采集 编解码 图形学
Android平台Unity下如何通过WebCamTexture采集摄像头数据并推送至RTMP服务器或轻量级RTSP服务
Android平台Unity下如何通过WebCamTexture采集摄像头数据并推送至RTMP服务器或轻量级RTSP服务
|
4月前
|
XML Java Android开发
Android App事件交互Event之模仿京东App实现下拉刷新功能(附源码 可直接使用)
Android App事件交互Event之模仿京东App实现下拉刷新功能(附源码 可直接使用)
32 0
Android App事件交互Event之模仿京东App实现下拉刷新功能(附源码 可直接使用)