BroadcastReceiver
- BroadcastReceiver，广播接收者，用来接收系统和应用的广播，并做出相应的处理，如电量过低时提示用户充电等；
- BroadcastReceiver 是 Android 的四大组件之一，分为 <code>普通广播</code>、<code>有序广播</code>、<code>粘性广播</code>；
- BroadcastReceiver 的使用步骤：
- 自定义一个类，继承自 BroadcastReceiver，并重写 onReceive() 方法，在该方法中对接收到的广播进行相应的处理；
- 注册广播地址：分为静态注册 (在 AndroidManifest.xml 中注册) 和动态注册 (在代码中注册)
- 发送广播：<code>普通广播 sendBroadcast()</code>、<code>有序广播 sendOrderedBroadcast()</code>、<code>粘性广播 sendStickyBroadcast()</code>
自定义广播
普通广播 (Normal Broadcast)
普通广播对于接收者来说是异步的，每个接收者都可以接收到广播，接收者不会相互干扰，也因此，接收者无法终止广播。
1. activity_main：
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="16dp"
tools:context=".MainActivity">
<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="发送自定义广播"
android:onClick="sendBroadcast"/>
</RelativeLayout>
2. MainActivity.java：
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
public void sendBroadcast(View view) {
// 1. 创建一个 Intent 对象；
Intent intent = new Intent();
// 2. 设置 Action;
intent.setAction("net.monkeychan.ACTION_SEND");
// 3. 发送普通广播
sendBroadcast(intent);
}
}
3. MyBroadcastReceiver.java：
// 自定义一个类，继承 BroadcastReceiver 类，并重写 onReceive() 方法
public class MyBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Log.i("MyBroadcastReceiver", "收到了自定义广播");
}
}
4. 在 AndroidManifest.xml 中注册 (静态注册)
MyBroadcastReceiver：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.monkeychan.broadcastreceivertest01">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name=".MyBroadcastReceiver">
<intent-filter>
<action android:name="net.monkeychan.ACTION_SEND" />
</intent-filter>
</receiver>
</application>
</manifest>
5. 效果演示：
点击按钮，发送广播：
多次点击，每点击一次就发送一次广播：
上面的程序是使用静态注册的，下面使用动态注册，布局文件无须作任何修改：
1. MainActivity.java：
public class MainActivity extends AppCompatActivity {
private MyBroadcastReceiver receiver;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 1. 创建一个自定义 BroadcastReceiver 的对象；
receiver = new MyBroadcastReceiver();
// 2. 创建一个 IntentFilter 对象，并进行设置
IntentFilter filter = new IntentFilter();
filter.addAction("net.monkeychan.ACTION_SEND");
// 3. 注册广播，该方法需要传入一个 BroadcastReceiver 类型的变量和一个 IntentFilter 类型的变量
registerReceiver(receiver,filter);
}
public void sendBroadcast(View view) {
// 1. 创建一个 Intent 对象；
Intent intent = new Intent();
// 2. 设置 Action;
intent.setAction("net.monkeychan.ACTION_SEND");
// 3. 发送普通广播
sendBroadcast(intent);
}
// 注意：动态注册的 BroadcastReceiver 在 Activity 或 Service 被销毁时必须解除注册
@Override
protected void onDestroy() {
super.onDestroy();
unregisterReceiver(receiver);
}
}
2. 使用动态注册的方式无须再在 AndroidManifest.xml 中注册广播地址：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.monkeychan.broadcastreceivertest01">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
3. 效果演示：
效果和使用静态注册一样。
静态注册和动态注册的区别
- 静态注册是在 AndroidManifest.xml 中注册，动态注册是在代码中注册；
- 静态注册是常驻型的，即使应用没有启动时也能接收广播；而动态注册的广播的生命周期受到其用来注册的 Activity 或 Service 的影响，当其用来注册的 Activity 或 Service 关闭时其广播也就失效了；
- 动态注册的广播在 Activity 或 Service 被销毁时必须解除注册，而静态注册的关闭则不用；
- 动态注册的优先级要比静态注册的优先级高。
有序广播 (Ordered Broadcast)
有序广播每次只将广播发送给优先级较高的接收者，优先级高的接收者可以决定是将广播发送给优先级低的接收者，还是终止这个广播。
下面我们自定义三个 BroadcastReceiver，并设置它们的优先级别依次降低，然后发送一条广播，看看效果如何。
1. MainActivity.java：
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
public void sendOrderedBroadcast(View view) {
// 1. 创建一个 Intent 对象，并设置其 Action
Intent intent = new Intent("net.monkeychan.action.OrderedBroadcast");
// 2. 往 Intent 对象里面存放数据
intent.putExtra("money", "我是大当家：给兄弟们每人发十两银子花花。");
// 3. 发送有序广播，该方法需要传入两个参数
/**
* @param intent Intent 对象
* @param receiverPermission 接收者所需要的权限，如果为 null，则接收者无须声明权限即可接收此广播，
* 如果不为 null，则接收者需要在注册时声明此权限才能接收到此广播
*/
sendOrderedBroadcast(intent, "net.monkeychan.permission.OrderedBroadcast");
}
}
2. 主界面布局文件，activity_main：
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="16dp"
tools:context=".MainActivity">
<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="发送有序广播"
android:onClick="sendOrderedBroadcast"/>
</RelativeLayout>
3. 自定义三个 BroadcastReceiver，继承自 BroadcastReceiver：
- FirstReceiver.java：
public class FirstReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 取出广播里的数据
String money = intent.getStringExtra("money");
Log.i("Receiver", "FirstReceiver 收到 MainActivity 的消息：" + money);
// 1. 创建一个 Bundle 对象
Bundle bundle = new Bundle();
// 2. 往 Bundle 里存放数据
bundle.putString("money", "我是二当家：大当家说了，给兄弟每人发八两银子花花。");
// 3. 将更改后的数据发送给下一个接收者
setResultExtras(bundle);
}
}
- SecondReceiver.java：
public class SecondReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 取出广播里的数据
String money = getResultExtras(true).getString("money");
Log.i("Receiver", "SecondReceiver 收到 FirstReceiver 的消息：" + money);
// 1. 创建一个 Bundle 对象
Bundle bundle = new Bundle();
// 2. 往 Bundle 里存放数据
bundle.putString("money", "我是三当家：大当家说了，给兄弟每人发五两银子花花。");
// 3. 将更改后的数据发送给下一个接收者
setResultExtras(bundle);
}
}
- ThirdReceiver.java：
public class ThirdReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 取出广播里的数据
String money = getResultExtras(true).getString("money");
Log.i("Receiver", "ThirdReceiver 收到 SecondReceiver 的消息：" + money);
}
}
4.为三个自定义的 BroadcastReceiver 注册广播地址，并设置它们各自的优先级，AndroidManifest.xml：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.monkeychan.broadcastreceivertest02">
<!-- 声明自定义权限 -->
<permission android:name="net.monkeychan.permission.OrderedBroadcast" />
<!-- 为三个 BroadcastReceiver 声明使用自定义权限 -->
<uses-permission android:name="net.monkeychan.permission.OrderedBroadcast" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<receiver android:name=".FirstReceiver">
<intent-filter android:priority="1000">
<action android:name="net.monkeychan.action.OrderedBroadcast" />
</intent-filter>
</receiver>
<receiver android:name=".SecondReceiver">
<intent-filter android:priority="999">
<action android:name="net.monkeychan.action.OrderedBroadcast" />
</intent-filter>
</receiver>
<receiver android:name=".ThirdReceiver">
<intent-filter android:priority="998">
<action android:name="net.monkeychan.action.OrderedBroadcast" />
</intent-filter>
</receiver>
</application>
</manifest>
我们在 <intent-filter> 标签里增加了 <code>android:priority</code> 属性，该属性用于为广播接收者设置优先级，其值范围为 -1000~1000，数值越高优先级越高。
5. 效果演示：
点击按钮，观察 logcat 日志：
上面我们说了，优先级高的接收者能够终止当前广播的传播，下面我们对上面的程序修改一下，在 SecondReceiver 终止当前广播的传播：
public class SecondReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 取出广播里的数据
String money = getResultExtras(true).getString("money");
Log.i("Receiver", "SecondReceiver 收到 FirstReceiver 的消息：" + money);
// // 1. 创建一个 Bundle 对象
// Bundle bundle = new Bundle();
// // 2. 往 Bundle 里存放数据
// bundle.putString("money", "我是三当家：大当家说了，给兄弟每人发五两银子花花。");
// // 3. 将更改后的数据发送给下一个接收者
// setResultExtras(bundle);
// 终止当前广播的传播
abortBroadcast();
}
}
效果演示：
可以看到，广播在 SecondReceiver 被终止了，优先级比 SecondReceiver 低的接收者无法接收到广播，但同级别的接收者可以接收到。
粘性广播 (Sticky Broadcast)
一般来说，当广播接收者的 onReceive() 方法的执行时间超过 10 秒，系统在资源不足时有可能将其结束掉而不让其执行。但是粘性广播没有这个限制，粘性广播的 Intent 会一直保持到广播结束，没有 10 秒的限制。
下面我们自定义一个 BroadcastReceiver，让其在接收到广播后循环 10 次，每次休眠 5 秒，并在休眠结束之后打印点东西：
1. 主界面布局文件，activity_main.xml：
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="16dp"
tools:context=".MainActivity">
<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="发送粘性广播"
android:onClick="sendStickyBroadcast"/>
</RelativeLayout>
2. 发送广播的代码，MainActivity.java：
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
public void sendStickyBroadcast(View view) {
// 创建一个 Intent 对象，并设置其 Action
Intent intent = new Intent("net.monkeychan.action.STICKYBROADCAST");
sendStickyBroadcast(intent);
}
}
3. 广播接收者，MyBroadcastReceiver.java：
// 自定义一个类，继承 BroadcastReceiver 类，并重写 onReceive() 方法
public class MyBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 广播接收者不能执行耗时操作
new Thread(new Runnable() {
@Override
public void run() {
for (int i = 0; i < 5; i++) {
SystemClock.sleep(5 * 1000);
Log.i("MyBroadcastReceiver", "收到了粘性广播" + i);
}
}
}).start();
}
}
4. 注册广播并声明权限，AndroidManifest.xml：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.monkeychan.broadcastreceivertest03">
<!-- 粘性广播需要声明权限 -->
<uses-permission android:name="android.permission.BROADCAST_STICKY"/>
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- 注册广播，并设置过滤器 -->
<receiver android:name=".MyBroadcastReceiver">
<intent-filter >
<action android:name="net.monkeychan.action.STICKYBROADCAST"/>
</intent-filter>
</receiver>
</application>
</manifest>
5. 效果演示：
点击按钮，注意，这里我们只点击了一次：
可以看到，当我们点击了一次按钮之后，发送了一个粘性广播，当接收者接收到广播之后，就会执行相应的操作，仔细留意，时间已经超过 10 秒，而广播仍在继续，为了使结果更加富有准确性，可以开多几个程序，使系统开销增大，观察广播超过 10 秒后是否仍在继续。
广播的生命周期
广播接收者的生命周期非常短暂，在接收到广播的时候创建，onReceive() 方法结束后销毁
广播的安全性
由于 BroadcastReceiver 的设计之初是从全局考虑的，可以方便应用程序和系统、应用程序之间、应用程序内的通信，所以对单个应用程序而难免存在安全方面的问题
，所以，为了避免安全问题，可以从以下几个方面入手：
- 发送广播时：
- 发送带权限的广播，在发送广播时指定权限，这样接收者就必须声明对应的权限才能接收到该广播；
- 指定接收广播的应用包名，Intent.setPackage("com.package.name")；
- 注册广播时：
- 注册广播时指定权限；
- 注册广播时使用 androd:exported="false"，声明不接收外部应用的广播；
- 使用本地广播 LocalBroadcastManager，其用于应用内部之间传播，不会泄露给外部应用：
// 1. 获取本地广播管理器对象
LocalBroadcastManager.getInstance(Context context);
// 2. 注册广播
registReceiver(BroadcastReceiver receiver, IntentFilter flter);
// 3. 发送广播
sendBroadcast(Intent); // 发送异步广播
// sendBroadcastSync(Intent intent); // 发送同步广播
// 4. 注销注册
unregisterReceiver(BroadcastReceiver receiver)
参考资料：
