AbstractPreferences Classe

Definição

Namespace:

Java.Util.Prefs

Assembly:

Mono.Android.dll

Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la.

[Android.Runtime.Register("java/util/prefs/AbstractPreferences", DoNotGenerateAcw=true)]
public abstract class AbstractPreferences : Java.Util.Prefs.Preferences

[<Android.Runtime.Register("java/util/prefs/AbstractPreferences", DoNotGenerateAcw=true)>]
type AbstractPreferences = class
    inherit Preferences

Herança

Object

JavaObject

Object

Preferences

AbstractPreferences

Atributos

RegisterAttribute

Comentários

Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la.

<forte>Essa classe é somente para Preferences implementadores. Os usuários normais da Preferences instalação não devem ter necessidade de consultar esta documentação. A Preferences documentação deve ser suficiente.</strong>

Os implementadores devem substituir os nove métodos de SPI (interface de provedor de serviço abstrato): #getSpi(String), , #putSpi(String,String), #removeSpi(String), , #childSpi(String), #removeNodeSpi(), #keysSpi()e #childrenNamesSpi()#syncSpi()#flushSpi(). Todos os métodos concretos especificam precisamente como eles são implementados em cima desses métodos SPI. O implementador poderá, a seu critério, substituir um ou mais dos métodos concretos se a implementação padrão for insatisfatória por qualquer motivo, como desempenho.

Os métodos SPI se enquadram em três grupos relacionados ao comportamento de exceção. O getSpi método nunca deve gerar exceções, mas realmente não importa, pois qualquer exceção gerada por esse método será interceptada por #get(String,String), o que retornará o valor padrão especificado para o chamador. Os removeNodeSpi, keysSpi, childrenNamesSpi, syncSpi métodos e os flushSpi métodos são especificados para gerar BackingStoreExceptione a implementação é necessária para gerar essa exceção verificada se não for possível executar a operação. A exceção se propaga para fora, fazendo com que o método de API correspondente falhe.

Os métodos spi restantes #putSpi(String,String)e #removeSpi(String)#childSpi(String) têm um comportamento de exceção mais complicado. Eles não são especificados para serem lançados BackingStoreException, pois geralmente podem obedecer aos contratos, mesmo que o repositório de backup não esteja disponível. Isso é verdade porque eles não retornam nenhuma informação e seus efeitos não são necessários para se tornarem permanentes até uma chamada subsequente para Preferences#flush() ou Preferences#sync(). De um modo geral, esses métodos SPI não devem gerar exceções. Em algumas implementações, pode haver circunstâncias em que essas chamadas não podem sequer enfileirar a operação solicitada para processamento posterior. Mesmo nessas circunstâncias, geralmente é melhor simplesmente ignorar a invocação e o retorno, em vez de lançar uma exceção. Nestas circunstâncias, no entanto, todas as invocações subsequentes flush() e sync devem retornar false, pois retornar true implicaria que todas as operações anteriores tinham sido permanentes com êxito.

Há uma circunstância em que putSpi, removeSpi and childSpideve gerar uma exceção: se o chamador não tiver privilégios suficientes no sistema operacional subjacente para executar a operação solicitada. Isso, por exemplo, ocorrerá na maioria dos sistemas se um usuário não privilegiado tentar modificar as preferências do sistema. (Os privilégios necessários variam de implementação para implementação. Em algumas implementações, elas têm o direito de modificar o conteúdo de algum diretório no sistema de arquivos; em outros, eles têm o direito de modificar o conteúdo de alguma chave em um registro.) Em qualquer uma dessas circunstâncias, geralmente seria indesejável permitir que o programa continuasse em execução como se essas operações se tornassem permanentes posteriormente. Embora as implementações não sejam necessárias para gerar uma exceção nessas circunstâncias, elas são incentivadas a fazê-lo. Um SecurityException seria apropriado.

A maioria dos métodos SPI exige a implementação para ler ou gravar informações em um nó de preferências. O implementador deve ter cuidado com o fato de que outra VM pode ter excluído simultaneamente esse nó do repositório de backup. É responsabilidade da implementação recriar o nó se ele tiver sido excluído.

Observação de implementação: nas implementações padrão Preferences do Sun, a identidade do usuário é herdada do sistema operacional subjacente e não é alterada durante o tempo de vida da máquina virtual. É reconhecido que as implementações do lado Preferences do servidor podem ter a alteração de identidade do usuário de solicitação para solicitação, passada implicitamente para Preferences métodos por meio do uso de uma instância estática ThreadLocal . Os autores dessas implementações são altamente incentivados a determinar o usuário no momento em que as preferências são acessadas (por exemplo, pelo #get(String,String) método) #put(String,String) em vez de associar permanentemente um usuário a cada Preferences instância. O último comportamento entra em conflito com o uso normal Preferences e causa grande confusão.

Adicionado em 1.4.

Java documentação para java.util.prefs.AbstractPreferences.

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

Construtores

Nome	Description
AbstractPreferences(AbstractPreferences, String)	Cria um nó de preferência com o pai especificado e o nome especificado em relação ao pai.
AbstractPreferences(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.

Campos

Nome	Description
MaxKeyLength	Comprimento máximo da cadeia de caracteres permitida como uma chave (80 caracteres). (Herdado de Preferences)
MaxNameLength	Comprimento máximo de um nome de nó (80 caracteres). (Herdado de Preferences)
MaxValueLength	Comprimento máximo da cadeia de caracteres permitida como um valor (8.192 caracteres). (Herdado de Preferences)

Propriedades

Nome	Description
Class	Retorna a classe de runtime deste Object. (Herdado de Object)
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
IsRemoved	Retorna true iff este nó (ou um ancestral) foi removido com o #removeNode() método.
IsUserNode	Implementa o isUserNode método de acordo com a especificação em Preferences#isUserNode().
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
JniPeerMembers	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.
Lock	Um objeto cujo monitor é usado para bloquear esse nó.
NewNode	Esse campo deverá ser true se esse nó não existir no repositório de backup antes da criação desse objeto.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
ThresholdClass	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.

Métodos

Nome	Description
AbsolutePath()	Implementa o absolutePath método de acordo com a especificação em Preferences#absolutePath().
AddNodeChangeListener(INodeChangeListener)	Registra uma NodeChangeListener instância para esse nó, que manipulará NodeChangeEvents.
AddPreferenceChangeListener(IPreferenceChangeListener)	Registra uma PreferenceChangeListener instância para esse nó, que manipulará PreferenceChangeEvents.
CachedChildren()	Retorna todos os filhos desconhecidos conhecidos deste nó.
ChildrenNames()	Implementa o children método de acordo com a especificação em Preferences#childrenNames().
ChildrenNamesSpi()	Retorna os nomes dos filhos desse nó de preferência.
ChildSpi(String)	Retorna o filho nomeado desse nó de preferência, criando-o se ele ainda não existir.
Clear()	Implementa o clear método de acordo com a especificação em Preferences#clear().
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
Equals(Object)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
ExportNode(Stream)	Implementa o exportNode método de acordo com a especificação em Preferences#exportNode(OutputStream).
ExportNodeAsync(Stream)	Emite de forma assíncrona um documento XML que representa todas as preferências contidas neste nó, mas não seus descendentes. (Herdado de Preferences)
ExportSubtree(Stream)	Implementa o exportSubtree método de acordo com a especificação em Preferences#exportSubtree(OutputStream).
ExportSubtreeAsync(Stream)	Emite de forma assíncrona um documento XML que representa todas as preferências contidas neste nó e todos os seus descendentes. (Herdado de Preferences)
Flush()	Implementa o flush método de acordo com a especificação em Preferences#flush().
FlushAsync()	Força de forma assíncrona quaisquer alterações nesse nó de preferência e seus descendentes para o repositório persistente. (Herdado de Preferences)
FlushSpi()	Esse método é invocado com esse nó bloqueado.
Get(String, String)	Implementa o get método de acordo com a especificação em Preferences#get(String,String).
GetBoolean(String, Boolean)	Implementa o getBoolean método de acordo com a especificação em Preferences#getBoolean(String,boolean).
GetByteArray(String, Byte[])	Implementa o getByteArray método de acordo com a especificação em Preferences#getByteArray(String,byte[]).
GetChild(String)	Retorna o filho nomeado se ele existir ou null se não existir.
GetDouble(String, Double)	Implementa o getDouble método de acordo com a especificação em Preferences#getDouble(String,double).
GetFloat(String, Single)	Implementa o getFloat método de acordo com a especificação em Preferences#getFloat(String,float).
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetInt(String, Int32)	Implementa o getInt método de acordo com a especificação em Preferences#getInt(String,int).
GetLong(String, Int64)	Implementa o getLong método de acordo com a especificação em Preferences#getLong(String,long).
GetSpi(String)	Retorne o valor associado à chave especificada nesse nó de preferência ou null se não houver associação para essa chave ou se a associação não puder ser determinada no momento.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
Keys()	Implementa o keys método de acordo com a especificação em Preferences#keys().
KeysSpi()	Retorna todas as chaves que têm um valor associado nesse nó de preferência.
Name()	Implementa o name método de acordo com a especificação em Preferences#name().
Node(String)	Implementa o node método de acordo com a especificação em Preferences#node(String).
NodeExists(String)	Implementa o nodeExists método de acordo com a especificação em Preferences#nodeExists(String).
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
Parent()	Implementa o parent método de acordo com a especificação em Preferences#parent().
Put(String, String)	Implementa o put método de acordo com a especificação em Preferences#put(String,String).
PutBoolean(String, Boolean)	Implementa o putBoolean método de acordo com a especificação em Preferences#putBoolean(String,boolean).
PutByteArray(String, Byte[])	Implementa o putByteArray método de acordo com a especificação em Preferences#putByteArray(String,byte[]).
PutDouble(String, Double)	Implementa o putDouble método de acordo com a especificação em Preferences#putDouble(String,double).
PutFloat(String, Single)	Implementa o putFloat método de acordo com a especificação em Preferences#putFloat(String,float).
PutInt(String, Int32)	Implementa o putInt método de acordo com a especificação em Preferences#putInt(String,int).
PutLong(String, Int64)	Implementa o putLong método de acordo com a especificação em Preferences#putLong(String,long).
PutSpi(String, String)	Coloque a associação chave-valor fornecida nesse nó de preferência.
Remove(String)	Implementa o remove(String) método de acordo com a especificação em Preferences#remove(String).
RemoveNode()	Implementa o removeNode() método de acordo com a especificação em Preferences#removeNode().
RemoveNodeChangeListener(INodeChangeListener)	Remove a instância fornecida NodeChangeListener desse nó.
RemoveNodeSpi()	Remove esse nó de preferência, invalidando-o e quaisquer preferências que ele contenha.
RemovePreferenceChangeListener(IPreferenceChangeListener)	Remove a instância fornecida PreferenceChangeListener desse nó.
RemoveSpi(String)	Remova a associação (se houver) para a chave especificada neste nó de preferência.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
Sync()	Implementa o sync método de acordo com a especificação em Preferences#sync().
SyncAsync()	Sincroniza de forma assíncrona esse nó de preferência e seus descendentes com o repositório persistente. (Herdado de Preferences)
SyncSpi()	Esse método é invocado com esse nó bloqueado.
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres desse nó de preferências.
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
IJavaPeerable.Finalized()	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la. (Herdado de JavaObject)

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância self.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	Essa classe fornece uma implementação esquelética da Preferences classe, facilitando muito a tarefa de implementá-la.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.