Android 自己开发的消息事件小项目DBus

1,140 阅读5分钟
原文链接: mp.weixin.qq.com

作者 | android阿杜

地址 | http://blog.csdn.net/fesdgasdgasdg/article/details/79121783

声明 | 本文是 android阿杜 原创,已获授权发布,未经原作者允许请勿转载

DBus项目突出的特点

1、注册消息事件的类可以是任意类(可能别人的项目也是),不限定是Activity等特殊的类。在使用时,保证register和unRegister一对方法成对调用。 如果只调用register方法,而忘记调用unRegister方法了,则DBus会一直持有此对象引用,可能会引起内存泄漏。2、支持使用特定方法名的函数接收消息;支持通过注解的方式标识某方法,使其变成消息接收方法。 使用下面方法设置是否使用方法名限定模式的方法,默认值为false,即使用注解方式。DBus.isUseMethodNameFind(true);//默认值为false 注意:使用特定方法名或注解方式,二选一,不可兼得。一旦设置,立即生效。3、使用方法名限定的方式,记住如下限定规则: a、记得打开方法名限定开关:DBus.isUseMethodNameFind(true);b、方法名只能是以onUIEvent或onThreadEvent开头; c、如果方法名以onUIEvent开头,表明此方法的执行是在UI线程,可以更新UI控件;d、如果方法名以onThreadEvent开头,表明此方法是在子线程执行的,不可更新UI,但可做耗时操作。 e、方法只能有一个参数。并且方法的参数类型必须是DData类型,不管消息发送处传递的是DData类还是子类对象。f、父类或接口的方法无效,必须是当前类里面定义的方法。

示例方法:private void onUIEventXXX(DData data){}当然,建议的写法是:public void onUIEventXXX(DData data){//公共,无返回值}

以下是非限定条件:a、方法的修饰符任意,可以是友好的、public、private、protected、static、final等; b、方法的返回值任意,可以是void、int、String等;c、上面说了方法名限定开头,但不限定结尾,比喻可以是onUIEventForVideo(DData data)。 4、使用注解方式,有以下规则:a、关闭方法名限定开关:DBus.isUseMethodNameFind(false);其实默认就是false的。 b、必须在方法前面设置注解@DBusInject(),注解有两个参数port和thread。port:为必填项,参数值自定义设置。如果此方法的注解port值与发送处DData对象的port值一致,才能收到发送的消息。 thread:选填项,参考DThreadType常量值,参数值为0或1,分别代表主线程和子线程。即此方法是在UI线程还是在子线程执行。默认值为0,在主线程执行。即可以更新UI控件。 c、方法只能有一个参数。并且方法的参数类型必须是DData类型,不管消息发送处传递的是DData类还是子类对象。(同上)d、父类或接口的方法无效,必须是当前类里面定义的方法。(同上) 以下是非限定条件:a、[亮点]方法名任意;比喻haha(DData data); b、方法的修饰符任意,可以是友好的、public、private、protected、static、final等;(同上)c、方法的返回值任意,可以是void、int、String等;(同上)

示例方法:@DBusInject(port = 1, thread = DThreadType.CHILD_THREAD)private static int haha(DData data){return 23;}当然,建议的写法是:@DBusInject(port = 1)public void updateTextView(DData data){//公共,无返回值,方法名有意义,默认在UI线程执行}

DBus项目环境集成

这个应该不用说,做过android的朋友都知道。1、把DBus源码搬进你的项目中。 2、把DBus库打包成jar包,方到你项目的libs中,记得添加引用。3、把DBus库打包成aar,方到你项目的libs中,记得添加引用。当然,用aar没意义,因为DBus项目中没有资源文件。

DBus使用教程

一、订阅者:1、订阅消息:在类的初始化方法注册事件,比喻Activity的onCreate方法中注册:DBus.getBus().register(this);

2、取消订阅在类的结束方法反注册,比喻Activity的onDestory方法中反注册:DBus.getBus().unRegister(this);

3、在当前类的某位置添加接收消息的方法:根据你对开关DBus.isUseMethodNameFind(boolean)的设置,选择合适的方法:

public void onUIEventImageView(DData data){//示例方法,非标准//如果data是你自定义的子类YourData yData = (YourData)data;}

@DBusInject(port = 23)public void dBusUpdateImageView(DData data){//示例方法,非标准//如果data是你自定义的子类YourData yData = (YourData)data;}

二、发布者:可以在任意线程、任意位置发送消息。只要你确保接收消息的对象没有调用unRegister反注册方法,就能100%接收到消息。注意DData构造函数的port参数,及注解中的port参数。发送消息示例:1、最简方式:

DBus.getBus().post(new DData(0));

2、携带参数:

DData data = new DData(0);data.str1 = "成功";data.int1 = 40;DBus.getBus().post(data);

3、携带自定义类的参数(注意:MyData extends DData):

MyData data = new MyData(54);data.str1 = "成功";data.int1 = 40;data.myValue = "自定义属性";DBus.getBus().post(data);

哪些订阅者能收到消息?

1、如果是注解方式,即DBus.isUseMethodNameFind(false)则@DBusInject(port)和DBus.getBus().post(new DData(port));两处port值相等的地方才能够收到消息。 2、如果是方法名限定方式,即DBus.isUseMethodNameFind(true)则所有的订阅者类中,以onUIEvent和onThreadEvent开头的所有方法都能够收到消息。

此时,你可以在具体的方法里面判断自定义的port值规则或DData里面的值,以决定哪些具体的方法才能够处理此事件。 3、已经反注册的订阅者不会收到任何消息,无管是注解方式,还是方法名限定方式。因为DBus已经不再持有反注册的订阅者对象了。

地址

CSDN地址:

http://blog.csdn.net/fesdgasdgasdg/article/details/79121783GitHub地址:https://github.com/mengzhinan/DBus

感谢各位码友支持!不要问为什么项目叫DBus,请原谅我自私的用了字母D。

推荐技术文...

来自大学生投稿:一个适合新手上手的商城项目

分享我学习 Androd 开发过程中写的小项目

一个三本学生的面试之旅