来自:https://developer.android.com/guide/components/bound-services.html
绑定服务是客户端-服务器接口中的服务器。绑定服务可让组件(例如 Activity)绑定到服务、发送请求、接收响应,甚至执行进程间通信 (IPC)。 绑定服务通常只在为其他应用组件服务时处于活动状态,不会无限期在后台运行。
基础知识
绑定服务是Service
类的实现,可让其他应用与其绑定和交互。要提供服务绑定,你必须实现onBind()
回调方法。该方法返回的IBinder
对象定义了客户端用来与服务进行交互的编程接口。客户端可通过调用bindService()
绑定到服务。调用时,它必须提供ServiceConnection
的实现,后者会监控与服务的连接。bindService()
方法会立即无值返回,但当 Android 系统创建客户端与服务之间的连接时,会调用ServiceConnection
上的onServiceConnected()
,向客户端传递用来与服务通信的IBinder
。
多个客户端可同时连接到一个服务。不过,只有在第一个客户端绑定时,系统才会调用服务的onBind()
方法来检索IBinder
。系统随后无需再次调用onBind()
,便可将同一IBinder
传递至任何其他绑定的客户端。
当最后一个客户端取消与服务的绑定时,系统会将服务销毁(除非startService()
也启动了该服务)。
当你实现绑定服务时,最重要的环节是定义你的onBind()
回调方法返回的接口。
绑定到已启动服务
正如服务文档中所述,你可以创建同时具有已启动和绑定两种状态的服务。 也就是说,可通过调用startService()
启动该服务,让服务无限期运行;此外,还可通过调用bindService()
使客户端绑定到服务。
如果你确实允许服务同时具有已启动和绑定状态,则服务启动后,系统“绝对不会”在所有客户端都取消绑定时销毁服务。为此,你必须通过调用stopSelf()
或stopService()
显式停止服务。
尽管你通常应该实现onBind()
或onStartCommand()
,但有时需要同时实现这两者。例如,音乐播放器可能发现让其服务无限期运行并同时提供绑定很有用处。 这样一来,Activity 便可启动服务进行音乐播放,即使用户离开应用,音乐播放也不会停止。 然后,当用户返回应用时,Activity可绑定到服务,重新获得回放控制权。
绑定到服务
应用组件(客户端)可通过调用bindService()
绑定到服务。Android 系统随后调用服务的onBind()
方法,该方法返回用于与服务交互的IBinder
。
绑定是异步的。bindService()
会立即返回,“绝对不会”使IBinder
返回客户端。要接收IBinder
,客户端必须创建一个ServiceConnection
实例,并将其传递给bindService()
。ServiceConnection
包括一个回调方法,系统通过调用它来传递IBinder
。
注:只有 Activity、服务和内容提供程序可以绑定到服务——你无法从广播接收器绑定到服务。
因此,要想从你的客户端绑定到服务,你必须:
- 实现
ServiceConnection
。你的实现必须重写两个回调方法:
-
系统会调用该方法以传递服务的
onBind()
方法返回的IBinder
。 - Android 系统会在与服务的连接意外中断时(例如当服务崩溃或被终止时)调用该方法。当客户端取消绑定时,系统“绝对不会”调用该方法。
onServiceConnected()
onServiceDisconnected()
-
系统会调用该方法以传递服务的
- 调用
bindService()
以传递ServiceConnection
实现。 - 当系统调用您的
onServiceConnected()
回调方法时,您可以使用接口定义的方法开始调用服务。 - 要断开与服务的连接,请调用
unbindService()
。当您的客户端被销毁时,它将取消与服务的绑定,但您应该始终在完成与服务的交互时或您的 Activity 暂停时取消绑定,以便服务能够在未被占用时关闭。(下文更详细地阐述了绑定和取消绑定的适当时机。)
例如,以下代码段通过扩展 Binder 类将客户端与上面创建的服务相连,因此它只需将返回的IBinder
转换为LocalService
类并请求LocalService
实例:
LocalService mService;
private ServiceConnection mConnection = new ServiceConnection() {
// Called when the connection with the service is established
public void onServiceConnected(ComponentName className, IBinder service) {
// Because we have bound to an explicit
// service that is running in our own process, we can
// cast its IBinder to a concrete class and directly access it.
LocalBinder binder = (LocalBinder) service;
mService = binder.getService();
mBound = true;
}
// Called when the connection with the service disconnects unexpectedly
public void onServiceDisconnected(ComponentName className) {
Log.e(TAG, "onServiceDisconnected");
mBound = false;
}
};
客户端可通过将此ServiceConnection
传递至bindService()
绑定到服务。例如:
Intent intent = new Intent(this, LocalService.class);
bindService(intent, mConnection, Context.BIND_AUTO_CREATE);
bindService()
的第一个参数是一个Intent
,用于显式命名要绑定的服务(但Intent可能是隐式的)- 第二个参数是
ServiceConnection
对象 - 第三个参数是一个指示绑定选项的标志。它通常应该是
BIND_AUTO_CREATE
,以便创建尚未激活的服务。 其他可能的值为BIND_DEBUG_UNBIND
和BIND_NOT_FOREGROUND
,或0
(表示无)。
附加说明
以下是一些有关绑定到服务的重要说明:
- 您应该始终捕获
DeadObjectException
异常,它们是在连接中断时引发的。这是远程方法引发的唯一异常 - 对象是跨进程计数的引用
- 您通常应该在客户端生命周期的匹配引入 (bring-up) 和退出 (tear-down) 时刻期间配对绑定和取消绑定。 例如:
- 如果您只需要在 Activity 可见时与服务交互,则应在
onStart()
期间绑定,在onStop()
期间取消绑定。 - 如果您希望 Activity 在后台停止运行状态下仍可接收响应,则可在
onCreate()
期间绑定,在onDestroy()
期间取消绑定。请注意,这意味着您的 Activity 在其整个运行过程中(甚至包括后台运行期间)都需要使用服务,因此如果服务位于其他进程内,那么当您提高该进程的权重时,系统终止该进程的可能性会增加
注:通常情况下,切勿在 Activity 的
onResume()
和onPause()
期间绑定和取消绑定,因为每一次生命周期转换都会发生这些回调,您应该使发生在这些转换期间的处理保持在最低水平。此外,如果您的应用内的多个 Activity 绑定到同一服务,并且其中两个 Activity 之间发生了转换,则如果当前 Activity 在下一次绑定(恢复期间)之前取消绑定(暂停期间),系统可能会销毁服务并重建服务。(Activity文档中介绍了这种有关 Activity 如何协调其生命周期的 Activity 转换。) - 如果您只需要在 Activity 可见时与服务交互,则应在
如需查看更多显示如何绑定到服务的示例代码,请参阅 ApiDemos 中的 RemoteService.java
类。
管理绑定服务的生命周期
当服务与所有客户端之间的绑定全部取消时,Android 系统便会销毁服务(除非还使用 onStartCommand()
启动了该服务)。因此,如果您的服务是纯粹的绑定服务,则无需对其生命周期进行管理—Android 系统会根据它是否绑定到任何客户端代您管理。
不过,如果您选择实现onStartCommand()
回调方法,则您必须显式停止服务,因为系统现在已将服务视为已启动。在此情况下,服务将一直运行到其通过stopSelf()
自行停止,或其他组件调用stopService()
为止,无论其是否绑定到任何客户端。
此外,如果您的服务已启动并接受绑定,则当系统调用您的onUnbind()
方法时,如果您想在客户端下一次绑定到服务时接收onRebind()
调用(而不是接收onBind()
调用),则可选择返回true
。onRebind()
返回空值,但客户端仍在其onServiceConnected()
回调中接收IBinder
。下文图 1 说明了这种生命周期的逻辑。