首页 > 代码库 > BroadcastReceiver类

BroadcastReceiver类

java.lang.Object

   ?

android.content.BroadcastReceiver

已知直接子类

  • AppWidgetProvider
  • DeviceAdminReceiver,
  • WakefulBroadcastReceiver

类概述

基类代码会收到sendbroadcast()意图。
假设你不须要在应用程序发送广播,考虑使用localbroadcastmanager类取代下面描写叙述的更一般的设施。这会给你一个更有效的实现(没有跨进程通信的须要),相关的其他应用程序可以接收或发送你的广播。同意你避免思考不论什么安全问题。

你能够通过Context.registerReceiver() 动态注冊这一类的上下文的一个实例。或静态公布一个<receiver>标签在你的AndroidManifest.xml配置文件。


注意:
假设在Activity.onResume()动态注冊一个接收器,你应该在 Activity.onPause()取消它的活动。(暂停时你不会接受意图,这将降低不必要的系统开销)。

不要在Activity.onSaveInstanceState()取消活动。

由于这不会被称为是用户在历史堆向后移动。


广播能够接收两大类

  1. 正常广播( Context.sendBroadcast发送)是全然异步的。全部的广播接收者是执行在一个不确定的顺序。往往在同一时间。这是更有效的,但意味着接收机无法使用的结果或中止API包括在这里。
  2. 有序广播(Context.sendOrderedBroadcast发送)被传递到一个接收器在时间。因为每一个接收器执行反过来,它能够传播的结果到下一个接收器,或全然放弃广播这样不会被传递到其它的接收机。

    命令接收器能够执行在android:priority :匹配的意图过滤器优先级属性。具有同样优先级的接收器将执行在一个随意的顺序

即使在正常广播的情况下,系统可能在某些情况下,恢复一次传送广播接收机。特别是。接收器。可能须要一个创造的过程。仅仅有一个将执行在一个时间来避免超载的系统的新工艺。

然而在这样的情况下,非顺序的语义,觉得:这些接收器还不能返回的结果或中止其广播。请注意。虽然意图类用于发送和接收这些广播,广播机构的意图是从这里的意图是用来启动活动中全然分离 Context.startActivity()。没有办法让中看到或捕获用于startactivity()意图;相同。当你广播的意图,你将永远找不到或启动活动。这两个操作在语义上是很不同的:从一个意向活动是一个前台操作,改动什么用户当前交互;广播意图是后台操作,用户通常不知道。

BroadcastReceiver类(启动时作为一个组件通过一个明显的 <receiver>标签)是一个应用程序的整个生命周期的一个重要组成部分。


主题

了解怎样使用这个类来接收和解决的意图。阅读Intents and Intent Filters开发人员指南。


  1. 安全保障
    1. 接收器使用的Context API本身就是一种跨应用设施,所以你必须考虑其它的应用程序可能滥用他们。一些须要考虑的事情是:
      1. 意图命名空间是全局。确保意图动作名称和其它的字符串写入一个你自己的命名空间中,否则你可能会无意中与其它应用程序发生冲突。
      2. 你使用registerReceiver(BroadcastReceiver, IntentFilter)。不论什么应用程序能够发送广播接收器,注冊。

        你能够控制谁能够发送广播。它通过权限描写叙述例如以下。

      3. 当你公布一个接收器在你的应用程序清单并为其指定的intent过滤器,不论什么其它的应用程序能够发送广播,它无论你指定的过滤器。

        要防止其它人发送给它,使它无法使用android:exported="false".

      4. 当你使用sendBroadcast(Intent) 或相关的方法,通常不论什么其它应用程序能够接收这些广播节目。

        你能够通过广播接收权限控制谁能够接收。

        另外,通过ICE_CREAM_SANDWICH,,你也能够用Intent.setPackage限定广播在一个应用中存在

    2. 使用 LocalBroadcastManager时这些问题不存在。由于它从来没有意图去运行当前进程外。
    3. 訪问权限能够通过发送者或接收者广播一个运行。
    4. 强制许可发送时,你提供非空的权限 sendBroadcast(Intent, String) 或者sendOrderedBroadcast(Intent, String, BroadcastReceiver, android.os.Handler, int, String, Bundle)。仅仅有那些被授予此权限接收器(通过请求与 <uses-permission> 标签在AndroidManifest.xml)将可以接收广播。

    5. 强制接收时,注冊广播时候你提供非空权限——要么当调用registerReceiver(BroadcastReceiver, IntentFilter, String, android.os.Handler) 或者在你的AndroidManifest.xml静态 <receiver> 标签。

      仅仅有那些已被授予该权限的广播(通过在AndroidManifest.xml的 <uses-permission>标签。

      )将可以发送一个意图接收器。

    6. 看Security and Permissions 文档了解一般的权限和安全性。

  2. 接收生命周期
    1. 一个BroadcastReceiver对象仅仅有唯一有效的调用 onReceive(Context, Intent)。你从这个函数返回的代码,系统考虑该对象完毕还是失效。

    2. 在onReceive(Context, Intent)运行这具有重要的影响:不论什么须要异步操作是不可用的,由于你将须要从函数返回来处理异步操作,但在这一点上BroadcastReceiver不在活跃。异步操作完毕之前这种系统是免费的删除过程。
    3. 特别是,你可能不会显示一个对话框或绑定到一个服务于一个BroadcastReceiver。对于前者,你反而应该用NotificationManager API。对于后者,你能够使用Context.startService()将命令发送到服务。
  3. 过程生命周期
    1. 眼下正在运行中的boiadcastReceiver这一个过程。(也就是说,眼下在onReceive(Context, Intent) 方法执行)被觉得是一个前景的过程,将保持执行的系统除了极端的内存压力的情况下。
    2. 一旦你返回onreceive()。BroadcastReceiver不再活跃,和其宿主进程仅仅为执行在它的不论什么其它应用程序组件一样重要。这是特别重要的,由于假设仅仅是举办过程中(的应用程序,用户没有或不近期互动的一个常见的情况),然后在从onreceive()系统还将考虑其过程是空的,积极地杀死它使资源可用于其它更重要的过程。

    3. 这意味着更长的执行操作,你会常常在一个BroadcastReceiver把含有进程的积极为您的整个操作时间的同一时候使用一个服务。

嵌套类

BroadcastReceiver.PendingResult
状态的结果正在等待一个广播接收器


BroadcastReceiver类中方法

BroadcastReceiver类