El Lenguaje de definición de la interfaz de Android (AIDL) es similar a otros IDL: te permite definir la interfaz de programación que el cliente y el servicio acuerdan utilizar para comunicarse entre sí mediante la comunicación entre procesos (IPC).
Por lo general, en Android, un proceso no puede acceder a la memoria de otro proceso. Para hablar, tienen que descomponer sus objetos en primitivas que el sistema operativo pueda comprender y tienen que ordenar los objetos entre esos límites para ti. Es tedioso escribir el código para realizar ese ordenamiento, por lo que Android lo maneja por ti con AIDL.
Nota: El AIDL solo es necesario si permites que los clientes de diferentes aplicaciones accedan a tu servicio para IPC y deseas manejar varios subprocesos en tu servicio. Si no necesitas realizar una IPC simultánea en diferentes aplicaciones, crea tu interfaz implementando un Binder
.
Si deseas realizar una IPC, pero no necesitas controlar varios subprocesos, implementa la interfaz con un Messenger
.
Sin importar cuál utilices, asegúrate de comprender los servicios vinculados antes de implementar un AIDL.
Antes de comenzar a diseñar tu interfaz de AIDL, ten en cuenta que las llamadas a una interfaz de AIDL son llamadas de funciones directas. No debes realizar suposiciones sobre el subproceso en el que se produce la llamada. Lo que sucede es diferente según si la llamada proviene de un subproceso en el proceso local o un proceso remoto:
- Las llamadas realizadas desde el proceso local se ejecutan en el mismo subproceso que realiza la llamada. Si es el subproceso de la IU principal, ese subproceso continúa ejecutándose en la interfaz de AIDL. Si es otro subproceso, ese es el que ejecuta el código en el servicio. Por lo tanto, si solo los subprocesos locales acceden al servicio, puedes controlar completamente qué subprocesos se están ejecutando en él. Sin embargo, si ese es el caso, no uses AIDL en absoluto. En su lugar, crea la interfaz implementando un
Binder
. - Las llamadas desde un proceso remoto se despachan desde un grupo de subprocesos que la plataforma mantiene dentro de tu proceso. Prepárate para llamadas entrantes desde subprocesos desconocidos, y para que se produzcan varias llamadas al mismo tiempo. En otras palabras, una implementación de una interfaz de AIDL debe ser completamente segura para subprocesos. Las llamadas que se realizan desde un subproceso del mismo objeto remoto llegan en orden al extremo del receptor.
- La palabra clave
oneway
modifica el comportamiento de las llamadas remotas. Cuando se usa, una llamada remota no bloquea. Envía los datos de la transacción y se muestra de inmediato. La implementación de la interfaz finalmente recibe esto como una llamada normal del grupo de subprocesosBinder
como una llamada remota normal. Si se usaoneway
con una llamada local, no se produce ningún efecto y la llamada sigue siendo síncrona.
Cómo definir una interfaz de AIDL
Define la interfaz de AIDL en un archivo .aidl
con la sintaxis del lenguaje de programación Java y guárdala en el código fuente, en el directorio src/
, de la aplicación que aloja el servicio y cualquier otra aplicación que cree un vínculo con el servicio.
Cuando creas cada aplicación que contiene el archivo .aidl
, las herramientas del SDK de Android generan una interfaz IBinder
basada en el archivo .aidl
y la guardan en el directorio gen/
del proyecto. El servicio debe implementar la interfaz IBinder
según corresponda. Las aplicaciones cliente pueden vincularse al servicio y llamar a los métodos desde IBinder
para realizar IPC.
Para crear un servicio enlazado con AIDL, sigue estos pasos, que se describen en las siguientes secciones:
- Cómo crear el archivo
.aidl
Este archivo define la interfaz de programación con firmas de métodos.
- Implementa la interfaz
Las herramientas del SDK de Android generan una interfaz con el lenguaje de programación Java según tu archivo
.aidl
. Esta interfaz tiene una clase abstracta interna denominadaStub
que extiendeBinder
e implementa los métodos de la interfaz de AIDL. Debes extender la claseStub
e implementar los métodos. - Expón la interfaz a los clientes
Implementa un
Service
y anulaonBind()
para mostrar tu implementación de la claseStub
.
Precaución: Los cambios que realices en la interfaz de AIDL después de tu primer lanzamiento deben tener compatibilidad con versiones anteriores para evitar romper otras aplicaciones que usan tu servicio. Es decir, debido a que tu archivo .aidl
se debe copiar a otras aplicaciones para que estas accedan a la interfaz de tu servicio, debes mantener la compatibilidad con la interfaz original.
Crear el archivo .aidl
El AIDL usa una sintaxis simple que te permite declarar una interfaz con uno o más métodos que pueden tomar parámetros y mostrar valores. Los parámetros y los valores que se muestran pueden ser de cualquier tipo, incluso otras interfaces generadas con AIDL.
Debes desarrollar el archivo .aidl
con el lenguaje de programación Java. Cada archivo .aidl
debe definir una única interfaz y solo requiere la declaración de la interfaz y las firmas de los métodos.
De manera predeterminada, el AIDL admite los siguientes tipos de datos:
- Todos los tipos de primitivas en el lenguaje de programación Java (como
int
,long
,char
,boolean
, etc.) - Arrays de cualquier tipo, como
int[]
oMyParcelable[]
String
CharSequence
List
Todos los elementos de
List
deben pertenecer a uno de los tipos de datos admitidos que figuran en esta lista o una de las otras interfaces generadas con AIDL o los tipos Parcelable que declares. De manera opcional, unList
se puede usar como una clase de tipo parametrizado, comoList<String>
. La clase real concreta que el otro lado recibe siempre es unaArrayList
, aunque el método se genera para usar la interfazList
.Map
Todos los elementos de
Map
deben pertenecer a uno de los tipos de datos admitidos que figuran en esta lista o una de las otras interfaces generadas con AIDL o los tipos Parcelable que declares. No se admiten los mapas de tipos parametrizados, como los que tienen la formaMap<String,Integer>
. La clase real concreta que el otro lado recibe siempre es unaHashMap
, aunque el método se genera para usar la interfazMap
. Considera usar unBundle
como alternativa aMap
.
Debes incluir una instrucción import
para cada tipo adicional que no se haya mencionado anteriormente, incluso si se define en el mismo paquete que tu interfaz.
Cuando definas la interfaz de tu servicio, ten en cuenta lo siguiente:
- Los métodos pueden tomar cero o más parámetros, y pueden mostrar un valor o un resultado nulo.
- Todos los parámetros que no sean primitivos requieren una etiqueta direccional que indique en qué dirección van los datos:
in
,out
oinout
(consulta el siguiente ejemplo).Las primitivas,
String
,IBinder
y las interfaces generadas por AIDL sonin
de forma predeterminada y no pueden ser de otra manera.Precaución: Limita la dirección a lo que es realmente necesario, ya que el ordenamiento de parámetros es costoso.
- Todos los comentarios de código incluidos en el archivo
.aidl
se incluyen en la interfaz deIBinder
generada, excepto los comentarios antes de las declaraciones de importación y del paquete. - Las constantes de cadena y de int se pueden definir en la interfaz de AIDL, como
const int VERSION = 1;
. - Las llamadas a los métodos se envían a través de un código
transact()
, que normalmente se basa en un índice de métodos en la interfaz. Debido a que esto dificulta el control de versiones, puedes asignar de forma manual el código de la transacción a un método:void method() = 10;
. - Los argumentos anulables y los tipos de datos que se muestran deben anotarse con
@nullable
.
Este es un archivo .aidl
de ejemplo:
// IRemoteService.aidl package com.example.android; // Declare any non-default types here with import statements. /** Example service interface */ interface IRemoteService { /** Request the process ID of this service. */ int getPid(); /** Demonstrates some basic types that you can use as parameters * and return values in AIDL. */ void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat, double aDouble, String aString); }
Guarda el archivo .aidl
en el directorio src/
de tu proyecto. Cuando compilas tu aplicación, las herramientas del SDK generan el archivo de interfaz IBinder
en el directorio gen/
de tu proyecto. El nombre del archivo generado coincide con el del archivo .aidl
, pero con una extensión .java
. Por ejemplo, IRemoteService.aidl
genera IRemoteService.java
.
Si usas Android Studio, la generación incremental genera la clase binder casi inmediatamente.
Si no usas Android Studio, la herramienta Gradle generará la clase Binder la próxima vez que compiles tu aplicación. Compila tu proyecto con gradle assembleDebug
o gradle assembleRelease
apenas termines de escribir el archivo .aidl
para que tu código se pueda vincular con la clase generada.
Cómo implementar la interfaz
Cuando compilas tu aplicación, las herramientas del SDK de Android generan un archivo de interfaz .java
que lleva el nombre del archivo .aidl
. La interfaz generada incluye una subclase denominada Stub
que es una implementación abstracta de su interfaz superior, como YourInterface.Stub
, y declara todos los métodos del archivo .aidl
.
Nota: Stub
también define algunos métodos de ayuda, en particular asInterface()
, que toma un IBinder
, generalmente el que se pasa al método de devolución de llamada onServiceConnected()
de un cliente, y muestra una instancia de la interfaz del código auxiliar. Si quieres obtener más información para realizar esta conversión, consulta la sección Cómo llamar a un método de IPC.
Para implementar la interfaz generada a partir del .aidl
, extiende la interfaz Binder
generada, como YourInterface.Stub
, e implementa los métodos heredados del archivo .aidl
.
A continuación, se muestra un ejemplo de implementación de una interfaz llamada IRemoteService
, definida por el ejemplo anterior de IRemoteService.aidl
, con una instancia anónima:
Kotlin
private val binder = object : IRemoteService.Stub() { override fun getPid(): Int = Process.myPid() override fun basicTypes( anInt: Int, aLong: Long, aBoolean: Boolean, aFloat: Float, aDouble: Double, aString: String ) { // Does nothing. } }
Java
private final IRemoteService.Stub binder = new IRemoteService.Stub() { public int getPid(){ return Process.myPid(); } public void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat, double aDouble, String aString) { // Does nothing. } };
Ahora, binder
es una instancia de la clase Stub
(un Binder
), que define la interfaz de IPC del servicio. En el siguiente paso, esta instancia se expone a los clientes para que puedan interactuar con el servicio.
Ten en cuenta algunas reglas cuando implementes tu interfaz de AIDL:
- No se garantiza que las llamadas entrantes se ejecuten en el subproceso principal, por lo que debes considerar varios subprocesos desde el comienzo y desarrollar tu servicio adecuadamente a fin de que sea seguro para los subprocesos.
- De forma predeterminada, las llamadas a IPC son síncronas. Si sabes que el servicio tarda más de unos pocos milisegundos en completar una solicitud, no lo llames desde el subproceso principal de la actividad. Es posible que la aplicación deje de funcionar, lo que hará que Android muestre un diálogo de "La aplicación no responde". Llámala desde un subproceso independiente en el cliente.
- Solo los tipos de excepción enumerados en la documentación de referencia de
Parcel.writeException()
se envían de vuelta al llamador.
Exponer la interfaz a los clientes
Una vez implementada la interfaz de tu servicio, tienes que exponerla a los clientes para que puedan enlazarse con ella. Para exponer la interfaz de tu servicio, extiende Service
e implementa onBind()
para mostrar una instancia de tu clase que implemente el Stub
generado, como se explicó en la sección anterior. A continuación, se muestra un ejemplo de servicio que expone la interfaz de ejemplo IRemoteService
a los clientes.
Kotlin
class RemoteService : Service() { override fun onCreate() { super.onCreate() } override fun onBind(intent: Intent): IBinder { // Return the interface. return binder } private val binder = object : IRemoteService.Stub() { override fun getPid(): Int { return Process.myPid() } override fun basicTypes( anInt: Int, aLong: Long, aBoolean: Boolean, aFloat: Float, aDouble: Double, aString: String ) { // Does nothing. } } }
Java
public class RemoteService extends Service { @Override public void onCreate() { super.onCreate(); } @Override public IBinder onBind(Intent intent) { // Return the interface. return binder; } private final IRemoteService.Stub binder = new IRemoteService.Stub() { public int getPid(){ return Process.myPid(); } public void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat, double aDouble, String aString) { // Does nothing. } }; }
Ahora, cuando un cliente, como una actividad, llama a bindService()
para conectarse a este servicio, la devolución de llamada onServiceConnected()
del cliente recibe la instancia de binder
que muestra el método onBind()
del servicio.
El cliente también debe tener acceso a la clase de interfaz. Por lo tanto, si el cliente y el servicio están en aplicaciones separadas, la aplicación del cliente debe tener una copia del archivo .aidl
en su directorio src/
, que genera la interfaz android.os.Binder
y le proporciona al cliente acceso a los métodos del AIDL.
Cuando el cliente recibe el IBinder
en la devolución de llamada onServiceConnected()
, debe llamar a YourServiceInterface.Stub.asInterface(service)
para convertir el parámetro que se muestra al tipo YourServiceInterface
:
Kotlin
var iRemoteService: IRemoteService? = null val mConnection = object : ServiceConnection { // Called when the connection with the service is established. override fun onServiceConnected(className: ComponentName, service: IBinder) { // Following the preceding example for an AIDL interface, // this gets an instance of the IRemoteInterface, which we can use to call on the service. iRemoteService = IRemoteService.Stub.asInterface(service) } // Called when the connection with the service disconnects unexpectedly. override fun onServiceDisconnected(className: ComponentName) { Log.e(TAG, "Service has unexpectedly disconnected") iRemoteService = null } }
Java
IRemoteService iRemoteService; private ServiceConnection mConnection = new ServiceConnection() { // Called when the connection with the service is established. public void onServiceConnected(ComponentName className, IBinder service) { // Following the preceding example for an AIDL interface, // this gets an instance of the IRemoteInterface, which we can use to call on the service. iRemoteService = IRemoteService.Stub.asInterface(service); } // Called when the connection with the service disconnects unexpectedly. public void onServiceDisconnected(ComponentName className) { Log.e(TAG, "Service has unexpectedly disconnected"); iRemoteService = null; } };
Para acceder a otros ejemplos de código, consulta la clase
RemoteService.java
en
ApiDemos.
Cómo pasar objetos por IPC
En Android 10 (nivel de API 29 o versiones posteriores), puedes definir objetos Parcelable
directamente en AIDL. Aquí también se admiten los tipos que se admiten como argumentos de interfaz de AIDL y otros elementos parcelables. Esto evita el trabajo adicional de escribir manualmente el código de marshalling y una clase personalizada. Sin embargo, esto también crea un struct simple. Si se desean accesores personalizados o alguna otra funcionalidad, implementa Parcelable
.
package android.graphics; // Declare Rect so AIDL can find it and knows that it implements // the parcelable protocol. parcelable Rect { int left; int top; int right; int bottom; }
La muestra de código anterior genera automáticamente una clase Java con campos de números enteros left
, top
, right
y bottom
. Todo el código de marshalling relevante se implementa automáticamente, y el objeto se puede usar directamente sin tener que agregar ninguna implementación.
También puedes enviar una clase personalizada de un proceso a otro a través de una interfaz de IPC. Sin embargo, asegúrate de que el código de la clase esté disponible en el otro lado del canal de la IPC, y la clase debe ser compatible con la interfaz Parcelable
. Admitir Parcelable
es importante porque le permite al sistema Android descomponer objetos en primitivas que se pueden ordenar entre los procesos.
Para crear una clase personalizada que admita Parcelable
, haz lo siguiente:
- Haz que tu clase implemente la interfaz
Parcelable
. - Implementa
writeToParcel
, que toma el estado actual del objeto y lo escribe en unParcel
. - Agrega un campo estático llamado
CREATOR
a tu clase que sea un objeto que implemente la interfazParcelable.Creator
. - Por último, crea un archivo
.aidl
que declare tu clase parcelable, como se muestra en el siguiente archivoRect.aidl
.Si usas un proceso de compilación personalizado, no agregues el archivo
.aidl
a tu compilación. Al igual que en el caso del archivo de encabezado en lenguaje C, este archivo.aidl
no se compila.
El AIDL usa estos métodos y campos en el código que genera para ordenar tus objetos y anular el orden.
Por ejemplo, este es un archivo Rect.aidl
para crear una clase Rect
que se pueda convertir en parcelable:
package android.graphics; // Declare Rect so AIDL can find it and knows that it implements // the parcelable protocol. parcelable Rect;
Este es un ejemplo de cómo la clase Rect
implementa el protocolo Parcelable
.
Kotlin
import android.os.Parcel import android.os.Parcelable class Rect() : Parcelable { var left: Int = 0 var top: Int = 0 var right: Int = 0 var bottom: Int = 0 companion object CREATOR : Parcelable.Creator<Rect> { override fun createFromParcel(parcel: Parcel): Rect { return Rect(parcel) } override fun newArray(size: Int): Array<Rect?> { return Array(size) { null } } } private constructor(inParcel: Parcel) : this() { readFromParcel(inParcel) } override fun writeToParcel(outParcel: Parcel, flags: Int) { outParcel.writeInt(left) outParcel.writeInt(top) outParcel.writeInt(right) outParcel.writeInt(bottom) } private fun readFromParcel(inParcel: Parcel) { left = inParcel.readInt() top = inParcel.readInt() right = inParcel.readInt() bottom = inParcel.readInt() } override fun describeContents(): Int { return 0 } }
Java
import android.os.Parcel; import android.os.Parcelable; public final class Rect implements Parcelable { public int left; public int top; public int right; public int bottom; public static final Parcelable.Creator<Rect> CREATOR = new Parcelable.Creator<Rect>() { public Rect createFromParcel(Parcel in) { return new Rect(in); } public Rect[] newArray(int size) { return new Rect[size]; } }; public Rect() { } private Rect(Parcel in) { readFromParcel(in); } public void writeToParcel(Parcel out, int flags) { out.writeInt(left); out.writeInt(top); out.writeInt(right); out.writeInt(bottom); } public void readFromParcel(Parcel in) { left = in.readInt(); top = in.readInt(); right = in.readInt(); bottom = in.readInt(); } public int describeContents() { return 0; } }
El ordenamiento en la clase Rect
es sencillo. Observa los otros métodos en Parcel
para ver los otros tipos de valores que puedes escribir en un Parcel
.
Advertencia: Recuerda las implicaciones de seguridad de recibir datos de otros procesos. En este caso, Rect
lee cuatro números de Parcel
, pero depende de ti asegurarte de que estén dentro del intervalo aceptable de valores para lo que el emisor intente hacer. Para obtener más información sobre cómo mantener tu aplicación segura contra software malicioso, consulta Sugerencias de seguridad.
Métodos con argumentos Bundle que contienen Parcelables
Si un método acepta un objetoBundle
que se espera que contenga elementos parcelables, asegúrate de configurar el cargador de clases de Bundle
llamando a Bundle.setClassLoader(ClassLoader)
antes de intentar leer desde Bundle
. De lo contrario, te encontrarás con ClassNotFoundException
, aunque el parcelable esté correctamente definido en tu aplicación.
Por ejemplo, considera el siguiente archivo .aidl
de muestra:
// IRectInsideBundle.aidl package com.example.android; /** Example service interface */ interface IRectInsideBundle { /** Rect parcelable is stored in the bundle with key "rect". */ void saveRect(in Bundle bundle); }
ClassLoader
se configura de forma explícita en el Bundle
antes de leer Rect
:
Kotlin
private val binder = object : IRectInsideBundle.Stub() { override fun saveRect(bundle: Bundle) { bundle.classLoader = classLoader val rect = bundle.getParcelable<Rect>("rect") process(rect) // Do more with the parcelable. } }
Java
private final IRectInsideBundle.Stub binder = new IRectInsideBundle.Stub() { public void saveRect(Bundle bundle){ bundle.setClassLoader(getClass().getClassLoader()); Rect rect = bundle.getParcelable("rect"); process(rect); // Do more with the parcelable. } };
Cómo llamar a un método de IPC
Para llamar a una interfaz remota definida con AIDL, sigue estos pasos en tu clase de llamada:
- Incluye el archivo
.aidl
en el directoriosrc/
del proyecto. - Declara una instancia de la interfaz
IBinder
, que se genera según el AIDL. - Implementa
ServiceConnection
. - Llama a
Context.bindService()
y pasa tu implementación deServiceConnection
. - En tu implementación de
onServiceConnected()
, recibes una instancia deIBinder
, llamadaservice
. Llama aYourInterfaceName.Stub.asInterface((IBinder)service)
para convertir el parámetro que se muestra al tipoYourInterface
. - Llama a los métodos que definiste en la interfaz. Siempre captura las excepciones
DeadObjectException
, que se producen cuando se corta la conexión. Además, captura las excepciones deSecurityException
, que se lanzan cuando los dos procesos involucrados en la llamada al método de IPC tienen definiciones contradictorias con el AIDL. - Para desconectarte, llama a
Context.unbindService()
con la instancia de tu interfaz.
Ten en cuenta estos puntos cuando llames a un servicio de IPC:
- Los objetos se cuentan como referencia entre procesos.
- Puedes enviar objetos anónimos como argumentos de métodos.
Para obtener más información sobre la vinculación a un servicio, consulta la Descripción general de los servicios vinculados.
Aquí hay un código de muestra que demuestra cómo llamar a un servicio creado con el AIDL, tomado del ejemplo del servicio remoto en el proyecto ApiDemos.
Kotlin
private const val BUMP_MSG = 1 class Binding : Activity() { /** The primary interface you call on the service. */ private var mService: IRemoteService? = null /** Another interface you use on the service. */ internal var secondaryService: ISecondary? = null private lateinit var killButton: Button private lateinit var callbackText: TextView private lateinit var handler: InternalHandler private var isBound: Boolean = false /** * Class for interacting with the main interface of the service. */ private val mConnection = object : ServiceConnection { override fun onServiceConnected(className: ComponentName, service: IBinder) { // This is called when the connection with the service is // established, giving us the service object we can use to // interact with the service. We are communicating with our // service through an IDL interface, so get a client-side // representation of that from the raw service object. mService = IRemoteService.Stub.asInterface(service) killButton.isEnabled = true callbackText.text = "Attached." // We want to monitor the service for as long as we are // connected to it. try { mService?.registerCallback(mCallback) } catch (e: RemoteException) { // In this case, the service crashes before we can // do anything with it. We can count on soon being // disconnected (and then reconnected if it can be restarted) // so there is no need to do anything here. } // As part of the sample, tell the user what happened. Toast.makeText( this@Binding, R.string.remote_service_connected, Toast.LENGTH_SHORT ).show() } override fun onServiceDisconnected(className: ComponentName) { // This is called when the connection with the service is // unexpectedly disconnected—that is, its process crashed. mService = null killButton.isEnabled = false callbackText.text = "Disconnected." // As part of the sample, tell the user what happened. Toast.makeText( this@Binding, R.string.remote_service_disconnected, Toast.LENGTH_SHORT ).show() } } /** * Class for interacting with the secondary interface of the service. */ private val secondaryConnection = object : ServiceConnection { override fun onServiceConnected(className: ComponentName, service: IBinder) { // Connecting to a secondary interface is the same as any // other interface. secondaryService = ISecondary.Stub.asInterface(service) killButton.isEnabled = true } override fun onServiceDisconnected(className: ComponentName) { secondaryService = null killButton.isEnabled = false } } private val mBindListener = View.OnClickListener { // Establish a couple connections with the service, binding // by interface names. This lets other applications be // installed that replace the remote service by implementing // the same interface. val intent = Intent(this@Binding, RemoteService::class.java) intent.action = IRemoteService::class.java.name bindService(intent, mConnection, Context.BIND_AUTO_CREATE) intent.action = ISecondary::class.java.name bindService(intent, secondaryConnection, Context.BIND_AUTO_CREATE) isBound = true callbackText.text = "Binding." } private val unbindListener = View.OnClickListener { if (isBound) { // If we have received the service, and hence registered with // it, then now is the time to unregister. try { mService?.unregisterCallback(mCallback) } catch (e: RemoteException) { // There is nothing special we need to do if the service // crashes. } // Detach our existing connection. unbindService(mConnection) unbindService(secondaryConnection) killButton.isEnabled = false isBound = false callbackText.text = "Unbinding." } } private val killListener = View.OnClickListener { // To kill the process hosting the service, we need to know its // PID. Conveniently, the service has a call that returns // that information. try { secondaryService?.pid?.also { pid -> // Note that, though this API lets us request to // kill any process based on its PID, the kernel // still imposes standard restrictions on which PIDs you // can actually kill. Typically this means only // the process running your application and any additional // processes created by that app, as shown here. Packages // sharing a common UID are also able to kill each // other's processes. Process.killProcess(pid) callbackText.text = "Killed service process." } } catch (ex: RemoteException) { // Recover gracefully from the process hosting the // server dying. // For purposes of this sample, put up a notification. Toast.makeText(this@Binding, R.string.remote_call_failed, Toast.LENGTH_SHORT).show() } } // ---------------------------------------------------------------------- // Code showing how to deal with callbacks. // ---------------------------------------------------------------------- /** * This implementation is used to receive callbacks from the remote * service. */ private val mCallback = object : IRemoteServiceCallback.Stub() { /** * This is called by the remote service regularly to tell us about * new values. Note that IPC calls are dispatched through a thread * pool running in each process, so the code executing here is * NOT running in our main thread like most other things. So, * to update the UI, we need to use a Handler to hop over there. */ override fun valueChanged(value: Int) { handler.sendMessage(handler.obtainMessage(BUMP_MSG, value, 0)) } } /** * Standard initialization of this activity. Set up the UI, then wait * for the user to interact with it before doing anything. */ override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.remote_service_binding) // Watch for button taps. var button: Button = findViewById(R.id.bind) button.setOnClickListener(mBindListener) button = findViewById(R.id.unbind) button.setOnClickListener(unbindListener) killButton = findViewById(R.id.kill) killButton.setOnClickListener(killListener) killButton.isEnabled = false callbackText = findViewById(R.id.callback) callbackText.text = "Not attached." handler = InternalHandler(callbackText) } private class InternalHandler( textView: TextView, private val weakTextView: WeakReference<TextView> = WeakReference(textView) ) : Handler() { override fun handleMessage(msg: Message) { when (msg.what) { BUMP_MSG -> weakTextView.get()?.text = "Received from service: ${msg.arg1}" else -> super.handleMessage(msg) } } } }
Java
public static class Binding extends Activity { /** The primary interface we are calling on the service. */ IRemoteService mService = null; /** Another interface we use on the service. */ ISecondary secondaryService = null; Button killButton; TextView callbackText; private InternalHandler handler; private boolean isBound; /** * Standard initialization of this activity. Set up the UI, then wait * for the user to interact with it before doing anything. */ @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.remote_service_binding); // Watch for button taps. Button button = (Button)findViewById(R.id.bind); button.setOnClickListener(mBindListener); button = (Button)findViewById(R.id.unbind); button.setOnClickListener(unbindListener); killButton = (Button)findViewById(R.id.kill); killButton.setOnClickListener(killListener); killButton.setEnabled(false); callbackText = (TextView)findViewById(R.id.callback); callbackText.setText("Not attached."); handler = new InternalHandler(callbackText); } /** * Class for interacting with the main interface of the service. */ private ServiceConnection mConnection = new ServiceConnection() { public void onServiceConnected(ComponentName className, IBinder service) { // This is called when the connection with the service is // established, giving us the service object we can use to // interact with the service. We are communicating with our // service through an IDL interface, so get a client-side // representation of that from the raw service object. mService = IRemoteService.Stub.asInterface(service); killButton.setEnabled(true); callbackText.setText("Attached."); // We want to monitor the service for as long as we are // connected to it. try { mService.registerCallback(mCallback); } catch (RemoteException e) { // In this case the service crashes before we can even // do anything with it. We can count on soon being // disconnected (and then reconnected if it can be restarted) // so there is no need to do anything here. } // As part of the sample, tell the user what happened. Toast.makeText(Binding.this, R.string.remote_service_connected, Toast.LENGTH_SHORT).show(); } public void onServiceDisconnected(ComponentName className) { // This is called when the connection with the service is // unexpectedly disconnected—that is, its process crashed. mService = null; killButton.setEnabled(false); callbackText.setText("Disconnected."); // As part of the sample, tell the user what happened. Toast.makeText(Binding.this, R.string.remote_service_disconnected, Toast.LENGTH_SHORT).show(); } }; /** * Class for interacting with the secondary interface of the service. */ private ServiceConnection secondaryConnection = new ServiceConnection() { public void onServiceConnected(ComponentName className, IBinder service) { // Connecting to a secondary interface is the same as any // other interface. secondaryService = ISecondary.Stub.asInterface(service); killButton.setEnabled(true); } public void onServiceDisconnected(ComponentName className) { secondaryService = null; killButton.setEnabled(false); } }; private OnClickListener mBindListener = new OnClickListener() { public void onClick(View v) { // Establish a couple connections with the service, binding // by interface names. This lets other applications be // installed that replace the remote service by implementing // the same interface. Intent intent = new Intent(Binding.this, RemoteService.class); intent.setAction(IRemoteService.class.getName()); bindService(intent, mConnection, Context.BIND_AUTO_CREATE); intent.setAction(ISecondary.class.getName()); bindService(intent, secondaryConnection, Context.BIND_AUTO_CREATE); isBound = true; callbackText.setText("Binding."); } }; private OnClickListener unbindListener = new OnClickListener() { public void onClick(View v) { if (isBound) { // If we have received the service, and hence registered with // it, then now is the time to unregister. if (mService != null) { try { mService.unregisterCallback(mCallback); } catch (RemoteException e) { // There is nothing special we need to do if the service // crashes. } } // Detach our existing connection. unbindService(mConnection); unbindService(secondaryConnection); killButton.setEnabled(false); isBound = false; callbackText.setText("Unbinding."); } } }; private OnClickListener killListener = new OnClickListener() { public void onClick(View v) { // To kill the process hosting our service, we need to know its // PID. Conveniently, our service has a call that returns // that information. if (secondaryService != null) { try { int pid = secondaryService.getPid(); // Note that, though this API lets us request to // kill any process based on its PID, the kernel // still imposes standard restrictions on which PIDs you // can actually kill. Typically this means only // the process running your application and any additional // processes created by that app as shown here. Packages // sharing a common UID are also able to kill each // other's processes. Process.killProcess(pid); callbackText.setText("Killed service process."); } catch (RemoteException ex) { // Recover gracefully from the process hosting the // server dying. // For purposes of this sample, put up a notification. Toast.makeText(Binding.this, R.string.remote_call_failed, Toast.LENGTH_SHORT).show(); } } } }; // ---------------------------------------------------------------------- // Code showing how to deal with callbacks. // ---------------------------------------------------------------------- /** * This implementation is used to receive callbacks from the remote * service. */ private IRemoteServiceCallback mCallback = new IRemoteServiceCallback.Stub() { /** * This is called by the remote service regularly to tell us about * new values. Note that IPC calls are dispatched through a thread * pool running in each process, so the code executing here is * NOT running in our main thread like most other things. So, * to update the UI, we need to use a Handler to hop over there. */ public void valueChanged(int value) { handler.sendMessage(handler.obtainMessage(BUMP_MSG, value, 0)); } }; private static final int BUMP_MSG = 1; private static class InternalHandler extends Handler { private final WeakReference<TextView> weakTextView; InternalHandler(TextView textView) { weakTextView = new WeakReference<>(textView); } @Override public void handleMessage(Message msg) { switch (msg.what) { case BUMP_MSG: TextView textView = weakTextView.get(); if (textView != null) { textView.setText("Received from service: " + msg.arg1); } break; default: super.handleMessage(msg); } } } }