发布/订阅
机制来对代码进行解耦。
简化项目的集中通讯(仅仅通过几行代码就可以解耦各个类),
移除了一些不必要的依赖,加速移动应用的开发。 关于大项目,如果还是用Java/Android原生的调用, 两个Activity之间的通讯, 还用
startActivity()/startActivityForResult()
这类通信方式的话, 代码会非常的冗余
, 例如Activity和Fragment之间的通讯就需要不断地调用相关的函数
; 使用EventBus
可以解除这些耦合; 否则如果代码耦合性非常大的话, 会大大增加后期维护的难度!
Event
可以是任意对象,
用来描述传递的数据
或事件类型
;
一般Event是由开发者按照需求自己定义
的,
里面封装要传递的事件类型和数据
;约定
来制定事件订阅者
以简化使用
;
在3.0之前,EventBus还没使用注解
的方式,
消息处理的方法
也仅限于:
onEvent
、onEventMainThread
、onEventBackgroundThread
、onEventSync
,
分别代表四种线程模型
;
在3.0之后,消息处理的方法
可以随便取名
,
但是需要
添加一个注解@Subscribe,
并且要指定线程的模型;Subscriber
有事件发生
可以在任意线程、任意位置
发送事件,
直接调用EventBus
的post(Object)
方法即可;EventBus.getDefault()
方法,实例化EventBus对象ThreadMode ThreadMode指定了会调用的函数, 只能有以下四种(因为每个订阅事件都是和一个线程模型相关的):
PostThread、 BackgroundThread、 MainThread、 Async
事件的处理时间
不应太长,
不然会影响事件的发送线程
;
而这个线程可能是UI线程
;onEvent
,
一般在UI线程
使用,
如果堵塞时间较长
则会影响其他线程的刷新
,
引起界面的卡顿
;
打个比方说你在UI线程中卡了两秒等下UI就不动,不刷新了按下Activity1中的Button, 会跳转到Activity2; 按下Activity2中的button, 会通过EventBus去通知Activity1; Activity1会通过OnEvent接收, 如果接收到Activity2发送过来消息, 然后触发Toast;
接下来新建一个项目,根据官方GitHub添加依赖,
implementation 'org.greenrobot:eventbus:3.1.1'
下面是主布局(Activity1):
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<Button
android:id="@+id/bt_toAc2"
android:text="跳转到Activity2"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
</LinearLayout>
public class MyEvent {
public String msg;
public MyEvent() {}
public MyEvent(String msg) {
this.msg = msg;
}
}
/**
* 注册onEvent(),
* 注意写上注解!
*/
@Subscribe
public void onEvent(MyEvent event) {
popOutToast("接收到Event:" + event.msg);
}
/**
* 封装弹出短时Toast提示
* @param text 企图弹出的文本内容
*
*/
private void popOutToast(String text) {
Toast.makeText(MainActivity.this,text,Toast.LENGTH_SHORT).show();
}
EventBus.getDefault().register(this);
@Override
protected void onDestroy() {
super.onDestroy();
EventBus.getDefault().unregister(this);
}
public class MainActivity extends AppCompatActivity {
private Button mButton;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//使用EventBus的接收方法的活动,需要注册
EventBus.getDefault().register(this);
mButton = findViewById(R.id.bt_toAc2);
mButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Intent intent = new Intent(MainActivity.this, SecondActivity.class);
startActivity(intent);
}
});
}
/**
* 注册onEvent(),
* 注意写上注解!
*/
@Subscribe
public void onEvent(MyEvent event) {
popOutToast("接收到Event:" + event.msg);
}
@Override
protected void onDestroy() {
super.onDestroy();
EventBus.getDefault().unregister(this);
}
/**
* 封装弹出短时Toast提示
* @param text 企图弹出的文本内容
*
*/
private void popOutToast(String text) {
Toast.makeText(MainActivity.this,text,Toast.LENGTH_SHORT).show();
}
}
创建第二个活动SecondActivity,布局:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<Button
android:id="@+id/bt_sendMsg"
android:text="发送消息"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
</LinearLayout>
java:
public class SecondActivity extends AppCompatActivity {
private Button mButton;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_second);
mButton = findViewById(R.id.bt_sendMsg);
mButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
EventBus.getDefault().post(new MyEvent("洞妖洞妖我是栋二!!!"));
}
});
}
}
运行效果图:
Activity1:
跳到Activity2,点击按钮,弹出Toast:
EventBus.getDefault().register(this);
系列的注册与反注册代码,
同onEvent()
系列的接收函数是紧密绑定的;
用时缺一不可,不用时存一不可,同生同灭;
也就是说一个活动注册onEvent()
系列的接收函数了,
则必须用EventBus.getDefault().register(this);
去注册,
不然会报错;
而一个活动它没有写onEvent()
系列的接收函数,
却用EventBus.getDefault().register(this);
去注册了,
同样也会报错! @Subscribe
public void onEvent(MyEvent event) {
//消耗时间模拟
try {
Thread.sleep(3000);
} catch (InterruptedException e) {
e.printStackTrace();
}
popOutToast("接收到Event:" + event.msg);
}
接着运行项目的话, 会发现我们在Activity2中点击发送消息的按钮之后, 要等到3秒钟,主线程才会刷新UI(弹出Toast), 这样子在实际运用中用户体验很差;
发送
和接收
都是在同一个线程
主线程
/ UI线程
中进行;使用:基于PostThread
的代码,
加多一行(threadMode = ThreadMode.MAIN)
即可:
//MainThread
@Subscribe(threadMode = ThreadMode.MAIN)
public void onEvent(MyEvent event) {
//消耗时间模拟
try {
Thread.sleep(3000);
} catch (InterruptedException e) {
e.printStackTrace();
}
popOutToast("接收到Event:" + event.msg);
}
后台线程
中执行,
对应的函数名是onEventBackgroundThread
;后台线程
专门
用来
处理onEventBackgroundThread
方法及其对应的事件
的;
也就是说,
比如现在主线程里面有一个post
,
它会对应执行到后台的一个onEventBackgroundThread()
;onEventBackgroundThread()
;
来了第二个post,
就对应第二个onEventBackgroundThread()
;onEventBackgroundThread()
;
是按照post
的顺序依次执行的;
如果前面一个post对应的onEventBackgroundThread()
;没有执行完,
这时候又post
了一下,
那么对应的后面的这个onEventBackgroundThread()
会等待前面一个onEventBackgroundThread()
执行完,它才执行;
//BackgroundThread
@Subscribe(threadMode = ThreadMode.BACKGROUND)
public void onEvent(MyEvent event) {
Log.d(TAG, "onEvent Start!!!!!!!! ");
//消耗时间模拟
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
Log.d(TAG, "onEvent End!!!!!!!! ");
// popOutToast("接收到Event:" + event.msg);
}
MainThread
的,
再运行,连续点击三次,
同样是能体现一一对应,顺序执行,前者执行,后者等待阻塞的特性: @Subscribe(threadMode = ThreadMode.MAIN)
public void onEvent(MyEvent event) {
Log.d(TAG, "onEvent Start!!!!!!!! ");
//消耗时间模拟
try {
Thread.sleep(3000);
} catch (InterruptedException e) {
e.printStackTrace();
}
Log.d(TAG, "onEvent End!!!!!!!! ");
// popOutToast("接收到Event:" + event.msg);
}
占用资源多、占用时间长
的任务是不合适的,
既不规范,也影响体验; PostThread
/MainThread
缺点:
执行在主线程,
事件的个数,事件的耗时,
都需要做比较严格的限制
;BackgroundThread
缺点:
运行在后台线程,不占用主线程资源,
比PostThread
/MainThread
好那么一点,
但是还是没有解决——
多个(>= 2
个)事件时,
一次处理一个,依次处理,
前者执行,后者等待阻塞
的问题,
不适合事件
中有耗时较长的任务
;adj.异步的;
sync n.同时,同步;
每次POST一下框架都会去取一个线程来执行
),
但最好限制线程的数目
(线程过多,CPU使用大,设备耗电快);
每次POST一下框架都会去取一个线程来执行
,
线程池中线程之间互相不干扰
,可以同时运行
;
更改代码:
//AsyncThread
@Subscribe(threadMode = ThreadMode.ASYNC)
public void onEvent(MyEvent event) {
Log.d(TAG, "onEvent Start!!!!!!!! ");
//消耗时间模拟
try {
Thread.sleep(3000);
} catch (InterruptedException e) {
e.printStackTrace();
}
Log.d(TAG, "onEvent End!!!!!!!! ");
}
执行效果:
这次我们可以看到, 事件的处理就没有—— 一次处理一个,依次处理,前者
执行中
,后者等待阻塞
的特性了, 因为各个post的事件, 都有各自独立的线程去处理, 所以事件的处理运行是同时的、异步的;
PostThread
/MainThread
缺点:
一般执行在主线程,
事件的个数,事件的耗时,
都需要做比较严格的限制
;BackgroundThread
缺点:
运行在后台线程,不占用主线程资源,
比PostThread
/MainThread
好那么一点,
但是还是没有解决——
多个(>= 2
个)事件时,
一次处理一个,依次处理,
前者执行,后者等待阻塞
的问题,
不适合事件
中有耗时较长的任务
;以上三种线程都是不适合跑耗时操作的;
Async
adj.异步的;
核心:异步,同时,高效
;
每次POST一下框架都会去取一个线程来执行
),
但最好限制线程的数目
(线程过多,CPU使用大,设备耗电快);
每次POST一下框架都会去取一个线程来执行
,
线程池中线程之间互相不干扰
,可以同时运行
补充:
priority
)就是字面上的意义,
值越高,优先级越高;sticy
即粘性发送,
发送方法
即EventBus.getDefault().postSticky(new MyEvent());
注销粘性event
的方法EventBus.getDefault().removeStickyEvent(new MyEvent());
发送(postSticky
)的时候,
项目中有多少Fragment、Activity等载体,
事件MyEvent就发送多少份;
粘性
其意义在于,
无论项目中载体类中
是否使用EventBus.getDefault().register(this);
对EventBus注册过,
都会对其发送事件,
若载体注册了,则接收处理该粘性事件;
若载体未注册,则该粘性事件会缓存起来,
一旦载体注册,马上接收处理事件
;
但由于这种粘性发送在项目比较大的时候 需要占用一定量的缓存资源, 所以一般使用较少;
EventBus.getDefault().register(this);
系列的注册与反注册代码,
同onEvent()
系列的接收函数是紧密绑定的;
用时缺一不可,不用时存一不可,同生同灭;
也就是说一个活动注册onEvent()
系列的接收函数了,
则必须用EventBus.getDefault().register(this);
去注册,
不然会报错;
而一个活动它没有写onEvent()
系列的接收函数,
却用EventBus.getDefault().register(this);
去注册了,
同样也会报错!状态
/ 指令
,无需传递数据时,
event自定义类内容可以为空;
比如一个只需要传递“清空位置信息列表”这个指令的事件,
可以这么定义:
就是定义一个Event类,但是内容为空; 即 无需传递数据, 仅仅event类的类名已经具备传递的事件、指令意义;
Fragment
或者Activity
需要接收处理
多个Event
时候,
通过建立多个注解方法
,并以不同的event 形参
,
来区分
处理,接收到不同的event
时,该做的对应的逻辑
;