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">바인더 클래스 확장</a></li> 15 <li><a href="#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>Key 클래스</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>바인딩된 서비스란 클라이언트 서버 인터페이스 안의 서버를 말합니다. 바인딩된 서비스를 사용하면 구성 요소(활동 등)를 45서비스에 바인딩되게 하거나, 요청을 보내고 응답을 수신하며 심지어는 46프로세스간 통신(IPC)까지 수행할 수 있게 됩니다. 일반적으로 바인딩된 서비스는 다른 애플리케이션 47구성 요소를 도울 때까지만 살고 배경에서 무한히 실행되지 않습니다.</p> 48 49<p>이 문서는 다른 애플리케이션 구성 요소의 50서비스에 바인딩하는 방법을 포함하여 바인딩된 서비스를 만드는 방법을 보여줍니다. 하지만 일반적인 서비스에 관한 정보도 알아두는 것이 좋습니다. 51서비스에서 알림을 전달하는 방법이나 서비스를 전경에서 실행되도록 설정하는 방법 등 여러 가지 52추가 정보를 알아보려면 <a href="{@docRoot}guide/components/services.html">서비스</a> 문서를 참조하십시오.</p> 53 54 55<h2 id="Basics">기본 정보</h2> 56 57<p>바인딩된 서비스란 일종의 {@link android.app.Service} 클래스 구현으로, 58이를 통해 다른 애플리케이션이 이 서비스에 바인딩하여 상호 작용할 수 있도록 해주는 것입니다. 한 서비스에 대한 바인딩을 제공하려면, 59{@link android.app.Service#onBind onBind()} 콜백 메서드를 구현해야 합니다. 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>서비스를 시작되고 바인딩되도록 허용한 다음 서비스가 시작되면 73시스템은 클라이언트가 모두 바인딩을 해제해도 서비스를 소멸시키지 <em>않습니다</em>. 대신, 74직접 서비스를 확실히 중단시켜야 합니다. 그러려면 {@link android.app.Service#stopSelf stopSelf()} 또는 {@link 75android.content.Context#stopService stopService()}를 호출하면 됩니다.</p> 76 77<p>보통은 {@link android.app.Service#onBind onBind()} 78<em>또는</em> {@link android.app.Service#onStartCommand onStartCommand()} 79중 한 가지만 구현하지만, 둘 모두 구현해야 할 때도 있습니다. 예를 들어, 음악 플레이어의 경우 서비스를 무한히 실행하면서 80바인딩도 제공하도록 허용하는 것이 유용하다는 결론을 내릴 수 있습니다. 이렇게 하면, 한 액티비티가 서비스로 하여금 음악을 재생하도록 81시작한 다음 사용자가 애플리케이션을 떠나더라도 음악을 계속 재생하도록 할 수 있습니다. 그런 다음, 사용자가 애플리케이션으로 82다시 돌아오면 이 액티비티가 서비스를 바인딩하여 재생 제어권을 다시 획득할 수 있습니다.</p> 83 84<p><a href="#Lifecycle">바인딩된 서비스 수명 주기 관리 85</a> 관련 섹션을 꼭 읽어보십시오. 시작된 서비스에 바인딩을 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()} 메서드는 값 없이 즉시 반환됩니다. 94그러나 Android 시스템이 클라이언트와 서비스 사이의 95연결을 만드는 경우, 시스템은 {@link 96android.content.ServiceConnection#onServiceConnected onServiceConnected()}를 {@link 97android.content.ServiceConnection}에서 호출하여 클라이언트가 서비스와 통신하는 데 사용할 수 있도록 {@link android.os.IBinder}를 98전달하게 됩니다.</p> 99 100<p>여러 클라이언트가 한 번에 서비스에 연결될 수 있습니다. 그러나, 시스템이 서비스의 101{@link android.app.Service#onBind onBind()} 메서드를 호출하여 {@link android.os.IBinder}를 검색하는 경우는 첫 번째 클라이언트가 102바인딩되는 경우뿐입니다. 시스템은 그 후 같은 {@link android.os.IBinder}를 바인딩되는 추가 103클라이언트 모두에 전달하며 이때는 {@link android.app.Service#onBind onBind()}를 다시 호출하지 않습니다.</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">바인더 클래스 확장</a></dt> 123 <dd>서비스가 본인의 애플리케이션 전용이며 클라이언트와 같은 과정으로 실행되는 124경우(이런 경우가 흔함), 인터페이스를 생성할 때 {@link android.os.Binder} 클래스를 125 확장하고 그 인스턴스를 126{@link android.app.Service#onBind onBind()}에서 반환하는 방식을 사용해야 합니다. 클라이언트가 {@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">메신저 사용</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} 139를 공유할 수 있게 되어 클라이언트가 {@link 140android.os.Message} 개체를 사용해 서비스에 명령을 보낼 수 있게 해줍니다. 이외에도, 클라이언트가 자체적으로 {@link android.os.Messenger}를 141정의하여 서비스가 메시지를 돌려보낼 수 있도록 할 수도 있습니다. 142 <p>이것이 프로세스간 통신(IPC)을 수행하는 가장 간단한 방법입니다. {@link 143android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해서, 서비스를 스레드로부터 안전하게 144설계하지 않아도 되기 때문입니다.</p> 145 </dd> 146 147 <dt>AIDL 사용하기</dt> 148 <dd>AIDL(Android Interface Definition Language)은 개체를 운영 체제가 이해할 수 있는 149원시 데이터로 구성 해제한 다음 여러 프로세스에 걸쳐 집결하여 IPC를 수행하기 위해 150필요한 모든 작업을 수행합니다. 이전 기법은 {@link android.os.Messenger}를 사용했는데, 151사실 그 기본 구조가 AIDL을 기반으로 하고 있는 것입니다. 위에서 언급한 바와 같이 {@link android.os.Messenger}는 단일 스레드에 모든 클라이언트 요청 152대기열을 생성하므로 서비스는 한 번에 요청을 하나씩 수신합니다. 그러나, 153서비스가 동시에 여러 요청을 처리하도록 하고 싶은 경우에는 AIDL을 직접 사용해도 154됩니다. 이 경우, 서비스가 다중 스레딩을 할 수 있어야 하며 스레드로부터 안전하게 구축되었어야 합니다. 155 <p>AIDL을 직접 사용하려면 156프로그래밍 인터페이스를 정의하는 {@code .aidl} 파일을 생성해야 합니다. Android SDK 도구는 157이 파일을 사용하여 인터페이스를 구현하고 IPC를 처리하는 추상 클래스를 생성하고, 158그러면 개발자가 직접 이것을 서비스 내에서 확장하면 됩니다.</p> 159 </dd> 160</dl> 161 162 <p class="note"><strong>참고:</strong> 대부분의 애플리케이션의 경우, 163바인딩된 서비스를 생성하기 위해 AIDL를 사용해서는 <strong>안 됩니다</strong>. 164그러려면 다중 스레딩 기능이 필요할 수 있고, 따라서 더 복잡한 구현을 초래할 수 있기 때문입니다. 따라서 AIDL은 165대부분의 애플리케이션에 적합하지 않으므로 이 문서에서는 여러분의 서비스에 이를 이용하는 방법에 대해 다루지 않습니다. AIDL을 직접 사용해야 한다는 확신이 드는 경우, 166<a href="{@docRoot}guide/components/aidl.html">AIDL</a> 문서를 참조하십시오. 167</p> 168 169 170 171 172<h3 id="Binder">바인더 클래스 확장</h3> 173 174<p>서비스를 사용하는 것이 로컬 애플리케이션뿐이고 여러 프로세스에 걸쳐 작동할 필요가 없는 경우, 175나름의 {@link android.os.Binder} 클래스를 구현하여 176클라이언트로 하여금 서비스 내의 공개 메서드에 직접 액세스할 수 있도록 할 수도 있습니다.</p> 177 178<p class="note"><strong>참고:</strong> 이것은 클라이언트와 서비스가 179같은 애플리케이션 및 프로세스에 있는 경우에만 통하며, 이 경우가 가장 보편적입니다. 이 방식이 잘 통하는 경우를 예로 들면, 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 android.os.Binder}를 {@link 196android.content.ServiceConnection#onServiceConnected onServiceConnected()} 197콜백 메서드에서 받아 제공된 메서드를 사용해 서비스를 바인딩하기 위해 호출합니다.</li> 198</ol> 199 200<p class="note"><strong>참고:</strong> 서비스와 클라이언트가 같은 애플리케이션에 201있어야 하는 것은 그래야만 클라이언트가 반환된 개체를 캐스팅하여 해당 API를 적절하게 호출할 수 있기 때문입니다. 또한 202서비스와 클라이언트는 같은 프로세스에 있어야 하기도 합니다. 이 기법에서는 203여러 프로세스에 걸친 집결 작업을 전혀 수행하지 않기 때문입니다.</p> 204 205<p>예컨대, 어떤 서비스가 클라이언트에게 {@link android.os.Binder} 구현을 통해 서비스 내의 206메서드에 액세스할 수 있도록 한다고 합시다.</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 @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 LocalService}의 현재 인스턴스를 검색하기 위한 {@code getService()} 메서드 239를 제공합니다. 이렇게 하면 클라이언트가 서비스 내의 공개 메서드를 호출할 수 있습니다. 240 클라이언트는 예컨대 서비스에서 {@code getRandomNumber()}를 호출할 수 있습니다.</p> 241 242<p>다음은 버튼을 클릭했을 때 {@code LocalService}에 바인딩되며 {@code getRandomNumber()} 243를 호출하는 액티비티를 나타낸 것입니다.</p> 244 245<pre> 246public class BindingActivity extends Activity { 247 LocalService mService; 248 boolean mBound = false; 249 250 @Override 251 protected void onCreate(Bundle savedInstanceState) { 252 super.onCreate(savedInstanceState); 253 setContentView(R.layout.main); 254 } 255 256 @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 @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 @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 @Override 299 public void onServiceDisconnected(ComponentName arg0) { 300 mBound = false; 301 } 302 }; 303} 304</pre> 305 306<p>위 예시는 클라이언트가 307{@link android.content.ServiceConnection} 구현과 {@link 308android.content.ServiceConnection#onServiceConnected onServiceConnected()} 콜백을 사용하여 서비스에 바인딩하는 방법을 보여줍니다. 다음 309섹션에서는 서비스에 바인딩하는 이러한 과정에 대해 좀 더 자세한 정보를 제공합니다.</p> 310 311<p class="note"><strong>참고:</strong> 위 예시에서는 서비스에서 분명히 바인딩을 해제하지는 않습니다. 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">메신저 사용</h3> 323 324<div class="sidebox-wrapper"> 325<div class="sidebox"> 326 <h4>AIDL과 비교</h4> 327 <p>IPC를 수행해야 할 경우, 인터페이스에 대해 {@link android.os.Messenger}를 사용하는 것이 328AIDL로 구현하는 것보다 간단합니다. 왜냐하면 {@link android.os.Messenger}는 329모든 호출을 서비스에 대기시키지만 순수한 AIDL 인터페이스는 330서비스에 동시에 요청을 전송하여 다중 스레딩을 처리해야 하기 때문입니다.</p> 331 <p>대부분의 애플리이션에서는 서비스가 다중 스레딩을 수행할 필요가 없으므로 {@link 332android.os.Messenger}를 사용하면 호출을 한 번에 하나씩 처리할 수 있습니다. 서비스가 333다중 스레딩되는 것이 중요한 경우, 인터페이스를 정의하는 데 <a href="{@docRoot}guide/components/aidl.html">AIDL</a>을 사용해야 합니다.</p> 334</div> 335</div> 336 337<p>서비스가 원격 프로세스와 통신해야 한다면 서비스에 인터페이스를 제공하는 데 338{@link android.os.Messenger}를 사용하면 됩니다. 이 기법을 사용하면 339AIDL을 쓰지 않고도 프로세스간 통신(IPC)을 수행할 수 있게 해줍니다.</p> 340 341<p>다음은 {@link android.os.Messenger} 사용 방법을 간략하게 요약한 것입니다.</p> 342 343<ul> 344 <li>서비스가 클라이언트로부터 각 호출에 대해 콜백을 받는 {@link android.os.Handler}를 345구현합니다.</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}를 생성하여 서비스가 349{@link android.app.Service#onBind onBind()}로부터 클라이언트에게 반환하도록 합니다.</li> 350 <li>클라이언트는 {@link android.os.IBinder}를 사용하여 {@link android.os.Messenger} 351(서비스의 {@link android.os.Handler}를 참조)를 인스턴트화하고, 이를 이용하여 352{@link android.os.Message} 개체를 서비스에 전송합니다.</li> 353 <li>서비스가 각 {@link android.os.Message}를 {@link 354android.os.Handler}로 수신합니다. 구체적으로는 {@link android.os.Handler#handleMessage 355handleMessage()} 메서드를 사용합니다.</li> 356</ul> 357 358 359<p>이렇게 하면, 클라이언트가 서비스에서 호출할 "메서드"가 없습니다. 대신 클라이언트는 360"메시지"({@link android.os.Message} 개체)를 전달하여 서비스가 361{@link android.os.Handler}로 받을 수 있도록 합니다.</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 @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 @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}의 {@link android.os.Handler#handleMessage handleMessage()} 메서드에서 404서비스가 수신되는 {@link android.os.Message}를 받고 405{@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} 메시지를 서비스에 전달하는 간단한 액티비티입니다.</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 @Override 454 protected void onCreate(Bundle savedInstanceState) { 455 super.onCreate(savedInstanceState); 456 setContentView(R.layout.main); 457 } 458 459 @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 @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}를 생성해야 합니다. 481클라이언트가 {@link android.content.ServiceConnection#onServiceConnected 482onServiceConnected()} 콜백을 받으면 {@link android.os.Messenger#send send()}메서드의 {@link android.os.Message#replyTo} 매개변수에서 클라이언트의 {@link android.os.Messenger}를 포함하는 {@link android.os.Message}를 483서비스에 전송합니다. 484</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>애플리케이션 구성 요소(클라이언트)를 서비스에 바인딩하려면 497{@link android.content.Context#bindService bindService()}를 호출하면 됩니다. 그러면 Android 498system이 서비스의 {@link android.app.Service#onBind 499onBind()} 메서드를 호출하고, 이는 서비스와의 상호 작용을 위해 {@link android.os.IBinder}를 반환합니다.</p> 500 501<p>바인딩은 비동기식입니다. {@link android.content.Context#bindService 502bindService()}는 즉시 반환하고 클라이언트에게 {@link android.os.IBinder}를 반환하지 <em>않습니다</em>. 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> 서비스에 바인딩할 수 있는 것은 액티비티, 서비스 및 509콘텐츠 제공자뿐입니다. 브로드캐스트 수신자로부터는 서비스에 바인딩할 수 <strong>없습니다</strong>.</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>시스템이 이것을 호출하여 서비스의 518{@link android.app.Service#onBind onBind()} 메서드가 반환한 {@link android.os.IBinder}를 전달합니다.</dd> 519 <dt>{@link android.content.ServiceConnection#onServiceDisconnected 520onServiceDisconnected()}</dt> 521 <dd>Android 시스템이 이것을 호출하는 경우는 서비스로의 연결이 522예기치 못하게 끊어졌을 때, 즉 서비스가 충돌했거나 중단되었을 때 등입니다. 523클라이언트가 바인딩을 해제한다고 이것이 호출되지는 <em>않습니다</em>.</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>클라이언트가 소멸되면 이는 서비스에서 바인딩을 해제하게 되지만, 535서비스와 상호 작용을 마쳤을 때 또는 액티비티가 일시 중지되었을 때에는 항상 바인딩을 해제해야 합니다. 536이렇게 해야 서비스가 사용 중이 아닐 때에는 중지할 수 있습니다 537(바인딩과 바인딩 해제의 적절한 시기는 아래에서 좀 더 논의합니다).</p> 538 </li> 539</ol> 540 541<p>예를 들어, 다음 코드 조각은 위와 같이 542<a href="#Binder">바인더 클래스를 확장해서</a> 생성한 서비스와 클라이언트를 연결합니다. 그러므로 이것이 해야 하는 일은 반환된 543{@link android.os.IBinder}를 {@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}이 있으면 클라이언트는 568이것을 {@link android.content.Context#bindService bindService()}에 전달하여 서비스에 바인딩할 수 있습니다. 예:</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{@link android.content.Intent}입니다(인텐트는 578암시적일 수 있음).</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>항상 {@link android.os.DeadObjectException} 예외를 트래핑해야 합니다. 592이것은 연결이 끊어지면 발생합니다. 원격 메서드에 의해 발생하는 예외는 이것뿐입니다.</li> 593 <li>개체는 여러 프로세스에 걸쳐 감안된 참조입니다. </li> 594 <li>일반적으로, 클라이언트의 수명 주기를 595결합하고 분해하는 순간을 일치시키면서 바인딩과 바인딩 해제를 페어링해야 합니다. 예: 596 <ul> 597 <li>액티비티가 눈에 보이는 동안에만 서비스와 상호 작용해야 한다면 598{@link android.app.Activity#onStart onStart()}에는 바인딩하고 {@link 599android.app.Activity#onStop onStop()}에는 바인딩을 해제해야 합니다.</li> 600 <li> 601배경에서 중단되었을 때도 액티비티가 응답을 받게 하고 싶다면 {@link android.app.Activity#onCreate onCreate()}에는 바인딩하고 602{@link android.app.Activity#onDestroy onDestroy()} 중에는 바인딩을 해제합니다. 603이때, 사용자의 액티비티가 서비스가 실행되는 시간 전체에서(배경에서라도) 서비스를 사용한다는 것을 유념해야 합니다. 604서비스가 다른 프로세스에 있을 경우, 사용자가 프로세스의 가중치를 높이면 시스템이 605이를 중단할 가능성이 높아집니다.</li> 606 </ul> 607 <p class="note"><strong>참고:</strong> 일반적으로는, 액티비티의 {@link android.app.Activity#onResume onResume()}와 {@link 608android.app.Activity#onPause onPause()}에는 바인딩하거나 바인딩을 해제하지 <strong>말아야</strong> 합니다. 이러한 콜백은 모든 수명 주기 전환에서 발생하고 609이런 전환에서 발생하는 처리는 610최소한으로 유지해야 하기 때문입니다. 또한, 611사용자 애플리케이션의 여러 액티비티가 동일한 서비스에 바인딩되었고 612두 액티비티 사이에 전환이 있을 경우, 현재 액티비티의 바인딩이 해제된 후(일시중지 중) 다음 액티비티가 바인딩하기 전(재개 중)에 613서비스가 제거되었다가 다시 생성될 수 있습니다 (수명 주기를 조절하기 위한 이러한 액티비티 전환은 614<a href="{@docRoot}guide/components/activities.html#CoordinatingActivities">액티비티</a> 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()}와도 함께 시작된 경우는 예외). 629따라서, 서비스가 순전히 바인딩된 서비스일 경우에는 해당 서비스의 수명 주기를 관리하지 않아도 됩니다. 630클라이언트에 바인딩되었는지를 근거로 Android 시스템이 대신 관리해주기 때문입니다.</p> 631 632<p>그러나 {@link android.app.Service#onStartCommand 633onStartCommand()} 콜백 메서드를 구현하기로 선택하는 경우라면 서비스를 확실히 중지해야 합니다. 634서비스가 현재 <em>시작된 것</em>으로 간주되기 때문입니다. 이런 경우, 서비스는 클라이언트에 바인딩되었는지 여부와 관계없이 635{@link android.app.Service#stopSelf()}와 함께 스스로 중단되거나 다른 구성 요소가{@link 636android.content.Context#stopService stopService()}를 호출할 때까지 실행됩니다. 637</p> 638 639<p>또한, 서비스가 시작되고 바인딩을 허용할 경우 시스템이 640{@link android.app.Service#onUnbind onUnbind()} 메서드를 호출하면 641{@code true}를 선택적으로 반환할 수 있습니다. 다음에 클라이언트가 서비스에 바인딩할 때({@link 642android.app.Service#onBind onBind()}에 대한 호출을 수신하지 않고) {@link android.app.Service#onRebind 643onRebind()}에 대한 호출을 받을지 여부에 따라 결정됩니다. {@link android.app.Service#onRebind 644onRebind()}가 void를 반환하였지만 클라이언트가 645{@link android.content.ServiceConnection#onServiceConnected onServiceConnected()} 콜백에서 {@link android.os.IBinder}를 여전히 수신합니다. 646아래 그림 1은 이런 수명 주기의 논리를 나타냅니다.</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
