1page.title=绑定服务
2parent.title=服务
3parent.link=services.html
4@jd:body
5
6
7<div id="qv-wrapper">
8<ol id="qv">
9<h2>本文内容</h2>
10<ol>
11  <li><a href="#Basics">基础知识</a></li>
12  <li><a href="#Creating">创建绑定服务</a>
13    <ol>
14      <li><a href="#Binder">扩展 Binder 类</a></li>
15      <li><a href="#Messenger">使用 Messenger</a></li>
16    </ol>
17  </li>
18  <li><a href="#Binding">绑定到服务</a></li>
19  <li><a href="#Lifecycle">管理绑定服务的生命周期</a></li>
20</ol>
21
22<h2>关键类</h2>
23<ol>
24  <li>{@link android.app.Service}</li>
25  <li>{@link android.content.ServiceConnection}</li>
26  <li>{@link android.os.IBinder}</li>
27</ol>
28
29<h2>示例</h2>
30<ol>
31  <li><a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/RemoteService.html">{@code
32      RemoteService}</a></li>
33  <li><a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/LocalService.html">{@code
34      LocalService}</a></li>
35</ol>
36
37<h2>另请参阅</h2>
38<ol>
39  <li><a href="{@docRoot}guide/components/services.html">服务</a></li>
40</ol>
41</div>
42
43
44<p>绑定服务是客户端-服务器接口中的服务器。绑定服务可让组件(例如 Activity)绑定到服务、发送请求、接收响应,甚至执行进程间通信 (IPC)。
45
46绑定服务通常只在为其他应用组件服务时处于活动状态,不会无限期在后台运行。
47</p>
48
49<p>本文向您介绍如何创建绑定服务,包括如何绑定到来自其他应用组件的服务。
50不过,您还应参阅<a href="{@docRoot}guide/components/services.html">服务</a>文档,了解有关一般服务的更多信息,例如:如何利用服务传送通知、如何将服务设置为在前台运行等等。
51
52</p>
53
54
55<h2 id="Basics">基础知识</h2>
56
57<p>绑定服务是 {@link android.app.Service}
58类的实现,可让其他应用与其绑定和交互。要提供服务绑定,您必须实现 {@link android.app.Service#onBind onBind()}
59回调方法。该方法返回的
60{@link android.os.IBinder}
61对象定义了客户端用来与服务进行交互的编程接口。</p>
62
63<div class="sidebox-wrapper">
64<div class="sidebox">
65  <h3>绑定到已启动服务</h3>
66
67<p>正如<a href="{@docRoot}guide/components/services.html">服务</a>文档中所述,您可以创建同时具有已启动和绑定两种状态的服务。
68也就是说,可通过调用
69{@link android.content.Context#startService startService()}
70启动该服务,让服务无限期运行;此外,还可通过调用 {@link
71android.content.Context#bindService bindService()} 使客户端绑定到服务。
72  <p>如果您确实允许服务同时具有已启动和绑定状态,则服务启动后,系统“绝对不会”<em></em>在所有客户端都取消绑定时销毁服务。
73为此,您必须通过调用
74{@link android.app.Service#stopSelf stopSelf()} 或 {@link
75android.content.Context#stopService stopService()} 显式停止服务。</p>
76
77<p>尽管您通常应该实现
78{@link android.app.Service#onBind onBind()}
79<em>或</em> {@link android.app.Service#onStartCommand onStartCommand()},但有时需要同时实现这两者。例如,音乐播放器可能发现让其服务无限期运行并同时提供绑定很有用处。
80这样一来,Activity 便可启动服务进行音乐播放,即使用户离开应用,音乐播放也不会停止。
81然后,当用户返回应用时,Activity 可绑定到服务,重新获得回放控制权。
82</p>
83
84<p>请务必阅读<a href="#Lifecycle">管理绑定服务的生命周期</a>部分,详细了解有关添加绑定已启动服务时该服务的生命周期信息。
85
86</p>
87</div>
88</div>
89
90<p>客户端可通过调用 {@link android.content.Context#bindService
91bindService()} 绑定到服务。调用时,它必须提供 {@link
92android.content.ServiceConnection} 的实现,后者会监控与服务的连接。{@link
93android.content.Context#bindService bindService()} 方法会立即无值返回,但当
94Android
95系统创建客户端与服务之间的连接时,会调用 {@link
96android.content.ServiceConnection} 上的 {@link
97android.content.ServiceConnection#onServiceConnected onServiceConnected()},向客户端传递用来与服务通信的
98{@link android.os.IBinder}。</p>
99
100<p>多个客户端可同时连接到一个服务。不过,只有在第一个客户端绑定时,系统才会调用服务的
101{@link android.app.Service#onBind onBind()}
102方法来检索 {@link android.os.IBinder}。系统随后无需再次调用
103{@link android.app.Service#onBind onBind()},便可将同一 {@link android.os.IBinder} 传递至任何其他绑定的客户端。</p>
104
105<p>当最后一个客户端取消与服务的绑定时,系统会将服务销毁(除非
106{@link android.content.Context#startService startService()} 也启动了该服务)。</p>
107
108<p>当您实现绑定服务时,最重要的环节是定义您的
109{@link android.app.Service#onBind onBind()} 回调方法返回的接口。您可以通过几种不同的方法定义服务的
110{@link android.os.IBinder}
111接口,下文对这些方法逐一做了阐述。</p>
112
113
114
115<h2 id="Creating">创建绑定服务</h2>
116
117<p>创建提供绑定的服务时,您必须提供 {@link android.os.IBinder},用以提供客户端用来与服务进行交互的编程接口。
118您可以通过三种方法定义接口:
119</p>
120
121<dl>
122  <dt><a href="#Binder">扩展 Binder 类</a></dt>
123  <dd>如果服务是供您的自有应用专用,并且在与客户端相同的进程中运行(常见情况),则应通过扩展
124{@link android.os.Binder}
125类并从 {@link android.app.Service#onBind onBind()}
126返回它的一个实例来创建接口。客户端收到 {@link android.os.Binder}
127后,可利用它直接访问 {@link android.os.Binder} 实现中乃至 {@link android.app.Service}
128中可用的公共方法。
129  <p>如果服务只是您的自有应用的后台工作线程,则优先采用这种方法。
130不以这种方式创建接口的唯一原因是,您的服务被其他应用或不同的进程占用。
131</dd>
132
133  <dt><a href="#Messenger">使用 Messenger</a></dt>
134  <dd>如需让接口跨不同的进程工作,则可使用
135{@link android.os.Messenger} 为服务创建接口。服务可以这种方式定义对应于不同类型
136{@link
137android.os.Message} 对象的 {@link android.os.Handler}。此 {@link android.os.Handler}
138是 {@link android.os.Messenger} 的基础,后者随后可与客户端分享一个 {@link android.os.IBinder},从而让客户端能利用 {@link
139android.os.Message}
140对象向服务发送命令。此外,客户端还可定义自有
141{@link android.os.Messenger},以便服务回传消息。
142  <p>这是执行进程间通信 (IPC) 的最简单方法,因为 {@link
143android.os.Messenger}
144会在单一线程中创建包含所有请求的队列,这样您就不必对服务进行线程安全设计。</p>
145  </dd>
146
147  <dt>使用 AIDL</dt>
148  <dd>AIDL(Android
149接口定义语言)执行所有将对象分解成原语的工作,操作系统可以识别这些原语并将它们编组到各进程中,以执行
150IPC。之前采用 {@link android.os.Messenger} 的方法实际上是以 AIDL
151作为其底层结构。如上所述,{@link android.os.Messenger}
152会在单一线程中创建包含所有客户端请求的队列,以便服务一次接收一个请求。不过,如果您想让服务同时处理多个请求,则可直接使用
153AIDL。
154在此情况下,您的服务必须具备多线程处理能力,并采用线程安全式设计。
155  <p>如需直接使用
156AIDL,您必须创建一个定义编程接口的 {@code .aidl} 文件。Android SDK
157工具利用该文件生成一个实现接口并处理 IPC
158的抽象类,您随后可在服务内对其进行扩展。</p>
159  </dd>
160</dl>
161
162  <p class="note"><strong>注:</strong>大多数应用“都不会”<strong></strong>使用
163AIDL
164来创建绑定服务,因为它可能要求具备多线程处理能力,并可能导致实现的复杂性增加。因此,AIDL
165并不适合大多数应用,本文也不会阐述如何将其用于您的服务。如果您确定自己需要直接使用
166AIDL,请参阅 <a href="{@docRoot}guide/components/aidl.html">AIDL</a>
167文档。</p>
168
169
170
171
172<h3 id="Binder">扩展 Binder 类</h3>
173
174<p>如果您的服务仅供本地应用使用,不需要跨进程工作,则可以实现自有
175{@link android.os.Binder}
176类,让您的客户端通过该类直接访问服务中的公共方法。</p>
177
178<p class="note"><strong>注:</strong>此方法只有在客户端和服务位于同一应用和进程内这一最常见的情况下方才有效。
179例如,对于需要将 Activity 绑定到在后台播放音乐的自有服务的音乐应用,此方法非常有效。
180
181</p>
182
183<p>以下是具体的设置方法:</p>
184<ol>
185  <li>在您的服务中,创建一个可满足下列任一要求的 {@link android.os.Binder} 实例:
186    <ul>
187      <li>包含客户端可调用的公共方法</li>
188      <li>返回当前 {@link android.app.Service}
189实例,其中包含客户端可调用的公共方法</li>
190      <li>或返回由服务承载的其他类的实例,其中包含客户端可调用的公共方法
191</li>
192    </ul>
193  <li>从 {@link
194android.app.Service#onBind onBind()} 回调方法返回此 {@link android.os.Binder} 实例。</li>
195  <li>在客户端中,从 {@link
196android.content.ServiceConnection#onServiceConnected onServiceConnected()} 回调方法接收
197{@link android.os.Binder},并使用提供的方法调用绑定服务。</li>
198</ol>
199
200<p class="note"><strong>注:</strong>之所以要求服务和客户端必须在同一应用内,是为了便于客户端转换返回的对象和正确调用其
201API。服务和客户端还必须在同一进程内,因为此方法不执行任何跨进程编组。
202
203</p>
204
205<p>例如,以下这个服务可让客户端通过
206{@link android.os.Binder} 实现访问服务中的方法:</p>
207
208<pre>
209public class LocalService extends Service {
210    // Binder given to clients
211    private final IBinder mBinder = new LocalBinder();
212    // Random number generator
213    private final Random mGenerator = new Random();
214
215    /**
216     * Class used for the client Binder.  Because we know this service always
217     * runs in the same process as its clients, we don't need to deal with IPC.
218     */
219    public class LocalBinder extends Binder {
220        LocalService getService() {
221            // Return this instance of LocalService so clients can call public methods
222            return LocalService.this;
223        }
224    }
225
226    &#64;Override
227    public IBinder onBind(Intent intent) {
228        return mBinder;
229    }
230
231    /** method for clients */
232    public int getRandomNumber() {
233      return mGenerator.nextInt(100);
234    }
235}
236</pre>
237
238<p>{@code LocalBinder} 为客户端提供 {@code getService()} 方法,以检索 {@code LocalService}
239的当前实例。这样,客户端便可调用服务中的公共方法。
240例如,客户端可调用服务中的 {@code getRandomNumber()}。</p>
241
242<p>点击按钮时,以下这个 Activity 会绑定到 {@code LocalService} 并调用
243{@code getRandomNumber()}:</p>
244
245<pre>
246public class BindingActivity extends Activity {
247    LocalService mService;
248    boolean mBound = false;
249
250    &#64;Override
251    protected void onCreate(Bundle savedInstanceState) {
252        super.onCreate(savedInstanceState);
253        setContentView(R.layout.main);
254    }
255
256    &#64;Override
257    protected void onStart() {
258        super.onStart();
259        // Bind to LocalService
260        Intent intent = new Intent(this, LocalService.class);
261        bindService(intent, mConnection, Context.BIND_AUTO_CREATE);
262    }
263
264    &#64;Override
265    protected void onStop() {
266        super.onStop();
267        // Unbind from the service
268        if (mBound) {
269            unbindService(mConnection);
270            mBound = false;
271        }
272    }
273
274    /** Called when a button is clicked (the button in the layout file attaches to
275      * this method with the android:onClick attribute) */
276    public void onButtonClick(View v) {
277        if (mBound) {
278            // Call a method from the LocalService.
279            // However, if this call were something that might hang, then this request should
280            // occur in a separate thread to avoid slowing down the activity performance.
281            int num = mService.getRandomNumber();
282            Toast.makeText(this, "number: " + num, Toast.LENGTH_SHORT).show();
283        }
284    }
285
286    /** Defines callbacks for service binding, passed to bindService() */
287    private ServiceConnection mConnection = new ServiceConnection() {
288
289        &#64;Override
290        public void onServiceConnected(ComponentName className,
291                IBinder service) {
292            // We've bound to LocalService, cast the IBinder and get LocalService instance
293            LocalBinder binder = (LocalBinder) service;
294            mService = binder.getService();
295            mBound = true;
296        }
297
298        &#64;Override
299        public void onServiceDisconnected(ComponentName arg0) {
300            mBound = false;
301        }
302    };
303}
304</pre>
305
306<p>上例说明了客户端如何使用 {@link android.content.ServiceConnection} 的实现和 {@link
307android.content.ServiceConnection#onServiceConnected onServiceConnected()}
308回调绑定到服务。下文更详细介绍了绑定到服务的过程。
309</p>
310
311<p class="note"><strong>注:</strong>上例并未显式取消与服务的绑定,但所有客户端都应在适当的时间(例如当 Activity 暂停时)取消绑定。
312</p>
313
314<p>如需查看更多示例代码,请参阅 <a href="{@docRoot}resources/samples/ApiDemos/index.html">ApiDemos</a> 中的 <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/LocalService.html">{@code
315LocalService.java}</a> 类和 <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/LocalServiceActivities.html">{@code
316LocalServiceActivities.java}</a> 类。</p>
317
318
319
320
321
322<h3 id="Messenger">使用 Messenger</h3>
323
324<div class="sidebox-wrapper">
325<div class="sidebox">
326  <h4>与 AIDL 比较</h4>
327  <p>当您需要执行 IPC 时,为您的接口使用 {@link android.os.Messenger}
328要比使用 AIDL 实现它更加简单,因为 {@link android.os.Messenger}
329会将所有服务调用排入队列,而纯粹的 AIDL
330接口会同时向服务发送多个请求,服务随后必须应对多线程处理。</p>
331  <p>对于大多数应用,服务不需要执行多线程处理,因此使用 {@link
332android.os.Messenger} 可让服务一次处理一个调用。如果您的服务必须执行多线程处理,则应使用 <a href="{@docRoot}guide/components/aidl.html">AIDL</a>
333来定义接口。</p>
334</div>
335</div>
336
337<p>如需让服务与远程进程通信,则可使用 {@link android.os.Messenger}
338为您的服务提供接口。利用此方法,您无需使用
339AIDL 便可执行进程间通信 (IPC)。</p>
340
341<p>以下是 {@link android.os.Messenger} 的使用方法摘要:</p>
342
343<ul>
344  <li>服务实现一个
345{@link android.os.Handler},由其接收来自客户端的每个调用的回调</li>
346  <li>{@link android.os.Handler} 用于创建 {@link android.os.Messenger}
347对象(对 {@link android.os.Handler} 的引用)</li>
348  <li>{@link android.os.Messenger} 创建一个 {@link android.os.IBinder},服务通过 {@link android.app.Service#onBind onBind()}
349使其返回客户端</li>
350  <li>客户端使用 {@link android.os.IBinder}
351将 {@link android.os.Messenger}(引用服务的 {@link android.os.Handler})实例化,然后使用后者将 {@link android.os.Message}
352对象发送给服务</li>
353  <li>服务在其 {@link
354android.os.Handler} 中(具体地讲,是在 {@link android.os.Handler#handleMessage
355handleMessage()} 方法中)接收每个 {@link android.os.Message}</li>
356</ul>
357
358
359<p>这样,客户端并没有调用服务的“方法”。而客户端传递的“消息”({@link android.os.Message}
360对象)是服务在其 {@link android.os.Handler}
361中接收的。</p>
362
363<p>以下是一个使用 {@link android.os.Messenger} 接口的简单服务示例:</p>
364
365<pre>
366public class MessengerService extends Service {
367    /** Command to the service to display a message */
368    static final int MSG_SAY_HELLO = 1;
369
370    /**
371     * Handler of incoming messages from clients.
372     */
373    class IncomingHandler extends Handler {
374        &#64;Override
375        public void handleMessage(Message msg) {
376            switch (msg.what) {
377                case MSG_SAY_HELLO:
378                    Toast.makeText(getApplicationContext(), "hello!", Toast.LENGTH_SHORT).show();
379                    break;
380                default:
381                    super.handleMessage(msg);
382            }
383        }
384    }
385
386    /**
387     * Target we publish for clients to send messages to IncomingHandler.
388     */
389    final Messenger mMessenger = new Messenger(new IncomingHandler());
390
391    /**
392     * When binding to the service, we return an interface to our messenger
393     * for sending messages to the service.
394     */
395    &#64;Override
396    public IBinder onBind(Intent intent) {
397        Toast.makeText(getApplicationContext(), "binding", Toast.LENGTH_SHORT).show();
398        return mMessenger.getBinder();
399    }
400}
401</pre>
402
403<p>请注意,服务就是在 {@link android.os.Handler}
404的 {@link android.os.Handler#handleMessage handleMessage()} 方法中接收传入的
405{@link android.os.Message},并根据 {@link android.os.Message#what} 成员决定下一步操作。</p>
406
407<p>客户端只需根据服务返回的 {@link
408android.os.IBinder} 创建一个 {@link android.os.Messenger},然后利用 {@link
409android.os.Messenger#send send()} 发送一条消息。例如,以下就是一个绑定到服务并向服务传递
410{@code MSG_SAY_HELLO} 消息的简单 Activity:</p>
411
412<pre>
413public class ActivityMessenger extends Activity {
414    /** Messenger for communicating with the service. */
415    Messenger mService = null;
416
417    /** Flag indicating whether we have called bind on the service. */
418    boolean mBound;
419
420    /**
421     * Class for interacting with the main interface of the service.
422     */
423    private ServiceConnection mConnection = new ServiceConnection() {
424        public void onServiceConnected(ComponentName className, IBinder service) {
425            // This is called when the connection with the service has been
426            // established, giving us the object we can use to
427            // interact with the service.  We are communicating with the
428            // service using a Messenger, so here we get a client-side
429            // representation of that from the raw IBinder object.
430            mService = new Messenger(service);
431            mBound = true;
432        }
433
434        public void onServiceDisconnected(ComponentName className) {
435            // This is called when the connection with the service has been
436            // unexpectedly disconnected -- that is, its process crashed.
437            mService = null;
438            mBound = false;
439        }
440    };
441
442    public void sayHello(View v) {
443        if (!mBound) return;
444        // Create and send a message to the service, using a supported 'what' value
445        Message msg = Message.obtain(null, MessengerService.MSG_SAY_HELLO, 0, 0);
446        try {
447            mService.send(msg);
448        } catch (RemoteException e) {
449            e.printStackTrace();
450        }
451    }
452
453    &#64;Override
454    protected void onCreate(Bundle savedInstanceState) {
455        super.onCreate(savedInstanceState);
456        setContentView(R.layout.main);
457    }
458
459    &#64;Override
460    protected void onStart() {
461        super.onStart();
462        // Bind to the service
463        bindService(new Intent(this, MessengerService.class), mConnection,
464            Context.BIND_AUTO_CREATE);
465    }
466
467    &#64;Override
468    protected void onStop() {
469        super.onStop();
470        // Unbind from the service
471        if (mBound) {
472            unbindService(mConnection);
473            mBound = false;
474        }
475    }
476}
477</pre>
478
479<p>请注意,此示例并未说明服务如何对客户端作出响应。如果您想让服务作出响应,则还需要在客户端中创建一个
480{@link android.os.Messenger}。然后,当客户端收到 {@link android.content.ServiceConnection#onServiceConnected
481onServiceConnected()} 回调时,会向服务发送一条
482{@link android.os.Message},并在其
483{@link android.os.Messenger#send send()} 方法的 {@link android.os.Message#replyTo}
484参数中包含客户端的 {@link android.os.Messenger}。</p>
485
486<p>如需查看如何提供双向消息传递的示例,请参阅 <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/MessengerService.html">{@code
487MessengerService.java}</a>(服务)和 <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/MessengerServiceActivities.html">{@code
488MessengerServiceActivities.java}</a>(客户端)示例。</p>
489
490
491
492
493
494<h2 id="Binding">绑定到服务</h2>
495
496<p>应用组件(客户端)可通过调用 {@link android.content.Context#bindService bindService()}
497绑定到服务。Android
498系统随后调用服务的 {@link android.app.Service#onBind
499onBind()} 方法,该方法返回用于与服务交互的 {@link android.os.IBinder}。</p>
500
501<p>绑定是异步的。{@link android.content.Context#bindService
502bindService()} 会立即返回,“绝对不会”<em></em>使 {@link android.os.IBinder}
503返回客户端。要接收 {@link android.os.IBinder},客户端必须创建一个 {@link
504android.content.ServiceConnection} 实例,并将其传递给 {@link android.content.Context#bindService
505bindService()}。{@link android.content.ServiceConnection} 包括一个回调方法,系统通过调用它来传递
506{@link android.os.IBinder}。</p>
507
508<p class="note"><strong>注:</strong>只有 Activity、服务和内容提供程序可以绑定到服务&mdash;您<strong>无法</strong>从广播接收器绑定到服务。
509</p>
510
511<p>因此,要想从您的客户端绑定到服务,您必须: </p>
512<ol>
513  <li>实现 {@link android.content.ServiceConnection}。
514    <p>您的实现必须重写两个回调方法:</p>
515    <dl>
516      <dt>{@link android.content.ServiceConnection#onServiceConnected onServiceConnected()}</dt>
517        <dd>系统会调用该方法以传递服务的 {@link android.app.Service#onBind onBind()}
518方法返回的 {@link android.os.IBinder}。</dd>
519      <dt>{@link android.content.ServiceConnection#onServiceDisconnected
520onServiceDisconnected()}</dt>
521        <dd>Android
522系统会在与服务的连接意外中断时(例如当服务崩溃或被终止时)调用该方法。当客户端取消绑定时,系统“绝对不会”<em></em>调用该方法。
523</dd>
524    </dl>
525  </li>
526  <li>调用 {@link
527android.content.Context#bindService bindService()} 以传递 {@link
528android.content.ServiceConnection} 实现。 </li>
529  <li>当系统调用您的 {@link android.content.ServiceConnection#onServiceConnected
530onServiceConnected()}
531回调方法时,您可以使用接口定义的方法开始调用服务。</li>
532  <li>要断开与服务的连接,请调用 {@link
533android.content.Context#unbindService unbindService()}。
534    <p>当您的客户端被销毁时,它将取消与服务的绑定,但您应该始终在完成与服务的交互时或您的 Activity 暂停时取消绑定,以便服务能够在未被占用时关闭。
535
536(下文更详细地阐述了绑定和取消绑定的适当时机。)
537</p>
538  </li>
539</ol>
540
541<p>例如,以下代码段通过<a href="#Binder">扩展
542Binder 类</a>将客户端与上面创建的服务相连,因此它只需将返回的 {@link android.os.IBinder}
543转换为 {@code LocalService} 类并请求 {@code
544LocalService} 实例:</p>
545
546<pre>
547LocalService mService;
548private ServiceConnection mConnection = new ServiceConnection() {
549    // Called when the connection with the service is established
550    public void onServiceConnected(ComponentName className, IBinder service) {
551        // Because we have bound to an explicit
552        // service that is running in our own process, we can
553        // cast its IBinder to a concrete class and directly access it.
554        LocalBinder binder = (LocalBinder) service;
555        mService = binder.getService();
556        mBound = true;
557    }
558
559    // Called when the connection with the service disconnects unexpectedly
560    public void onServiceDisconnected(ComponentName className) {
561        Log.e(TAG, "onServiceDisconnected");
562        mBound = false;
563    }
564};
565</pre>
566
567<p>客户端可通过将此 {@link android.content.ServiceConnection} 传递至 {@link android.content.Context#bindService bindService()}
568绑定到服务。例如:</p>
569
570<pre>
571Intent intent = new Intent(this, LocalService.class);
572bindService(intent, mConnection, Context.BIND_AUTO_CREATE);
573</pre>
574
575<ul>
576  <li>{@link android.content.Context#bindService bindService()}
577的第一个参数是一个
578{@link android.content.Intent},用于显式命名要绑定的服务(但 Intent 可能是隐式的)</li>
579<li>第二个参数是 {@link android.content.ServiceConnection} 对象</li>
580<li>第三个参数是一个指示绑定选项的标志。它通常应该是 {@link
581android.content.Context#BIND_AUTO_CREATE},以便创建尚未激活的服务。
582其他可能的值为 {@link android.content.Context#BIND_DEBUG_UNBIND}
583和 {@link android.content.Context#BIND_NOT_FOREGROUND},或 {@code 0}(表示无)。</li>
584</ul>
585
586
587<h3>附加说明</h3>
588
589<p>以下是一些有关绑定到服务的重要说明:</p>
590<ul>
591  <li>您应该始终捕获
592{@link android.os.DeadObjectException} 异常,它们是在连接中断时引发的。这是远程方法引发的唯一异常</li>
593  <li>对象是跨进程计数的引用 </li>
594  <li>您通常应该在客户端生命周期的匹配引入 (bring-up) 和退出 (tear-down) 时刻期间配对绑定和取消绑定。
595例如:
596    <ul>
597      <li>如果您只需要在 Activity 可见时与服务交互,则应在 {@link android.app.Activity#onStart onStart()}
598期间绑定,在 {@link
599android.app.Activity#onStop onStop()} 期间取消绑定。</li>
600      <li>如果您希望 Activity 在后台停止运行状态下仍可接收响应,则可在
601{@link android.app.Activity#onCreate onCreate()} 期间绑定,在 {@link android.app.Activity#onDestroy onDestroy()}
602期间取消绑定。请注意,这意味着您的 Activity 在其整个运行过程中(甚至包括后台运行期间)都需要使用服务,因此如果服务位于其他进程内,那么当您提高该进程的权重时,系统终止该进程的可能性会增加
603
604
605</li>
606    </ul>
607    <p class="note"><strong>注:</strong>通常情况下,<strong>切勿</strong>在 Activity 的 {@link android.app.Activity#onResume onResume()}
608和 {@link
609android.app.Activity#onPause onPause()}
610期间绑定和取消绑定,因为每一次生命周期转换都会发生这些回调,您应该使发生在这些转换期间的处理保持在最低水平。此外,如果您的应用内的多个 Activity 绑定到同一服务,并且其中两个 Activity 之间发生了转换,则如果当前 Activity 在下一次绑定(恢复期间)之前取消绑定(暂停期间),系统可能会销毁服务并重建服务。
611
612
613(<a href="{@docRoot}guide/components/activities.html#CoordinatingActivities">Activity</a>文档中介绍了这种有关 Activity 如何协调其生命周期的 Activity 转换。)
614
615</p>
616</ul>
617
618<p>如需查看更多显示如何绑定到服务的示例代码,请参阅 <a href="{@docRoot}resources/samples/ApiDemos/index.html">ApiDemos</a> 中的 <a href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/RemoteService.html">{@code
619RemoteService.java}</a> 类。</p>
620
621
622
623
624
625<h2 id="Lifecycle">管理绑定服务的生命周期</h2>
626
627<p>当服务与所有客户端之间的绑定全部取消时,Android
628系统便会销毁服务(除非还使用 {@link android.app.Service#onStartCommand onStartCommand()} 启动了该服务)。因此,如果您的服务是纯粹的绑定服务,则无需对其生命周期进行管理&mdash;Android
629系统会根据它是否绑定到任何客户端代您管理。
630</p>
631
632<p>不过,如果您选择实现 {@link android.app.Service#onStartCommand
633onStartCommand()}
634回调方法,则您必须显式停止服务,因为系统现在已将服务视为<em>已启动</em>。在此情况下,服务将一直运行到其通过 {@link android.app.Service#stopSelf()}
635自行停止,或其他组件调用 {@link
636android.content.Context#stopService stopService()}
637为止,无论其是否绑定到任何客户端。</p>
638
639<p>此外,如果您的服务已启动并接受绑定,则当系统调用您的 {@link android.app.Service#onUnbind onUnbind()} 方法时,如果您想在客户端下一次绑定到服务时接收
640{@link android.app.Service#onRebind
641onRebind()} 调用(而不是接收 {@link
642android.app.Service#onBind onBind()} 调用),则可选择返回
643{@code true}。{@link android.app.Service#onRebind
644onRebind()} 返回空值,但客户端仍在其 {@link android.content.ServiceConnection#onServiceConnected onServiceConnected()} 回调中接收
645{@link android.os.IBinder}。下文图 1
646说明了这种生命周期的逻辑。</p>
647
648
649<img src="{@docRoot}images/fundamentals/service_binding_tree_lifecycle.png" alt="" />
650<p class="img-caption"><strong>图 1.  </strong>允许绑定的已启动服务的生命周期。
651</p>
652
653
654<p>如需了解有关已启动服务生命周期的详细信息,请参阅<a href="{@docRoot}guide/components/services.html#Lifecycle">服务</a>文档。</p>
655
656
657
658
659