您的位置：首页 > 移动开发 > Android开发

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

2018-01-21 18:24 260 查看

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

GitHub地址：https://github.com/mengzhinan/DBus

DBus一个简易、高效的消息框架。没看过EventBus的源码，但是个人感觉此项目够简洁高效、易懂易用!

DBus项目突出的特点：

1、注册消息事件的类可以是任意类(可能别人的项目也是)，不限定是Activity等特殊的类。 

只要你保证register和unRegister方法成对调用。 

否则DBus会一直持有此对象引用，可能会引起内存泄漏。 

2、支持使用特定方法名的函数接收消息；支持通过注解的方式标识某方法，使其变成消息接收的方法。 

如果方法前面有@DBusInject()注解，则此方法被当做DBus的注解方法处理； 

如果没有发现@DBusInject()注解，则在根据方法名限定规则来检查是否符合要求； 

方法名限定规则为以onUIEvent开头或者onThreadEvent开头，分别表示在主线程和子线程接收消息的方法。 

3、使用方法名限定的方式，记住如下限定规则： 

a、方法名只能是以onUIEvent或onThreadEvent开头； 

b、如果方法名以onUIEvent开头，表明此方法的执行是在UI线程，可以更新UI控件； 

c、如果方法名以onThreadEvent开头，表明此方法是在子线程执行的，不可更新UI，但可做耗时操作； 

d、方法只能有一个参数。并且方法的参数类型必须是DData类型，不管消息发送处传递的是DData类还是子类对象； 

e、父类或接口的方法无效，必须是当前类里面定义的方法。 

示例方法： 

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、必须在方法前面设置注解@DBusInject()，注解有两个参数port和thread。 

port：为必填项，参数值自定义设置。如果此方法的注解port值与发送处DData对象的port值一致，才能收到发送的消息。 

thread：选填项，参考DThreadType常量值，参数值为0、1和2，分别代表主线程、当前子线程和新的子线程。 
即此方法是在UI线程还是在子线程执行。默认值为0，在主线程执行，即可以更新UI控件。 

b、方法只能有一个参数。并且方法的参数类型必须是DData类型，不管消息发送处传递的是DData类还是子类对象。(同上) 

c、父类或接口的方法无效，必须是当前类里面定义的方法。(同上) 

以下是非限定条件： 

a、[亮点]方法名任意；比喻haha(DData data); 

b、方法的修饰符任意，可以是友好的、public、private、protected、static、final等；(同上) 

c、方法的返回值任意，可以是void、int、String等；(同上) 

示例方法： 

@DBusInject(port = 1, thread = DThreadType.CURRENT_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、在当前类的某位置添加接收消息的方法： 

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(1)); 

2、携带参数： 

DData data = new DData(DData.PORT_RECEIVE_METHOD_NAME, DData.THREAD_UI); 

data.str1 = "成功"; 

data.int1 = 40; 

DBus.getBus().post(data); 

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

MyData data = new MyData(DData.PORT_RECEIVE_ALL); 

data.str1 = "成功"; 

data.int1 = 40; 

data.myValue = "自定义属性"; 

DBus.getBus().post(data); 

注意事项，及哪些订阅者能收到消息： 

1、注意消息接收方法的方法名限定方式，有UI线程和子线程两种类型方法； 

2、注意消息接收方法的注解方式，有两个参数，端口和线程。port端口值建议大于0，至少不能等于DData.PORT_RECEIVE_METHOD_NAME = -1和DData.PORT_RECEIVE_ALL = 0两个常量值；thread值只建议使用DThreadType接口里面的3个常量值，分别表示0-UI线程，1-当前子线程，2-new子线程。 

3、发送方法DBus.getBus().post(data)的data参数，注意DData的构造函数public DData(int port, int thread){...}。 

port参数值： 

DData.PORT_RECEIVE_METHOD_NAME，表示只有方法名限定方式的消息接收方法能收到。 

DData.PORT_RECEIVE_ALL，表示所有的消息接收方法都能收到。 

如果不是以上值，则只有注解的方法，且port相等的才能收到。 

thread参数值： 

DData.THREAD_UI，表示只有UI线程的消息接收方法能收到。 

DData.THREAD_ALL，表示所有的消息接收方法都能收到。 

DData.THREAD_CHILD，表示只有子线程的消息接收方法能收到。 

此处两个参数很关键，可以双重限制已达到特殊的一部分方法能收到消息的目的。 

4、已经反注册的订阅者不会收到任何消息，无管是注解方式，还是方法名限定方式。因为DBus已经不再持有反注册的订阅者对象了。 

感谢各位码友支持！ 

不要问为什么项目叫DBus，请原谅我自私的用了字母D。

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签： android bus handler

相关文章推荐

新的分享

章节导航