IBinder Interface

Definição

[Android.Runtime.Register("android/os/IBinder", "", "Android.OS.IBinderInvoker")]
public interface IBinder : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/os/IBinder", "", "Android.OS.IBinderInvoker")>]
type IBinder = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Derivado

Android.OS.Binder

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable IDisposable

Comentários

Interface base para um objeto remoto, a parte principal de um mecanismo de chamada de procedimento remoto leve projetado para alto desempenho ao executar chamadas em processo e entre processos. Essa interface descreve o protocolo abstrato para interagir com um objeto remoto. Não implemente essa interface diretamente, em vez disso, estenda-se de Binder.

A API do IBinder de chave é #transact transact() correspondida por Binder#onTransact Binder.onTransact(). Esses métodos permitem que você envie uma chamada para um objeto IBinder e receba uma chamada chegando a um objeto Binder, respectivamente. Essa API de transação é síncrona, de modo que uma chamada não #transact transact() retorne até que o destino tenha retornado Binder#onTransact Binder.onTransact(); esse é o comportamento esperado ao chamar um objeto que existe no processo local, e o mecanismo de IPC (comunicação interprocesso) subjacente garante que essas mesmas semânticas se apliquem ao passar por processos.

Os dados enviados por meio de transact() são um Parcelbuffer genérico de dados que também mantém alguns metadados sobre seu conteúdo. Os metadados são usados para gerenciar referências de objeto IBinder no buffer, de modo que essas referências possam ser mantidas à medida que o buffer se move entre processos. Esse mecanismo garante que, quando um IBinder for gravado em um Pacote e enviado para outro processo, se esse outro processo enviar uma referência para o mesmo IBinder de volta ao processo original, o processo original receberá o mesmo objeto IBinder de volta. Essas semânticas permitem que objetos IBinder/Binder sejam usados como uma identidade exclusiva (para servir como um token ou para outras finalidades) que podem ser gerenciados entre processos.

O sistema mantém um pool de threads de transação em cada processo em que ele é executado. Esses threads são usados para expedir todos os IPCs provenientes de outros processos. Por exemplo, quando um IPC é feito do processo A para o processo B, o thread de chamada em Blocos A em transact() como ele envia a transação para o processo B. O próximo thread de pool disponível em B recebe a transação de entrada, chama Binder.onTransact() no objeto de destino e responde com o Pacote de resultados. Ao receber seu resultado, o thread no processo A retorna para permitir que sua execução continue. Na verdade, outros processos parecem ser usados como threads adicionais que você não criou executando em seu próprio processo.

O sistema Binder também dá suporte à recursão entre processos. Por exemplo, se o processo A executar uma transação para processar B e processar B durante o tratamento dessas chamadas de transação transact() em um IBinder implementado em A, o thread em A que está atualmente aguardando a conclusão da transação original cuidará de chamar Binder.onTransact() no objeto que está sendo chamado por B. Isso garante que a semântica de recursão ao chamar o objeto associador remoto seja a mesma que ao chamar objetos locais.

Ao trabalhar com objetos remotos, você geralmente deseja descobrir quando eles não são mais válidos. Há três maneiras de determinar isso: <ul><li> O #transact transact() método gerará uma RemoteException exceção se você tentar chamá-la em um IBinder cujo processo não existe mais. <li> O #pingBinder() método pode ser chamado e retornará false se o processo remoto não existir mais. <li> O #linkToDeath linkToDeath() método pode ser usado para registrar um DeathRecipient com o IBinder, que será chamado quando o processo de contenção desaparecer. </ul>

Java documentação para android.os.IBinder.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.