WeakHashMap Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Implementação baseada em tabela de hash da Map interface, com <>em chaves</em> fracas.
[Android.Runtime.Register("java/util/WeakHashMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class WeakHashMap : Java.Util.AbstractMap, IDisposable
[<Android.Runtime.Register("java/util/WeakHashMap", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type WeakHashMap = class
inherit AbstractMap
interface IMap
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Herança
- Atributos
- Implementações
Comentários
Implementação baseada em tabela de hash da Map interface, com <>em chaves</em> fracas. Uma entrada em um WeakHashMap será removida automaticamente quando sua chave não estiver mais em uso comum. Mais precisamente, a presença de um mapeamento para uma determinada chave não impedirá que a chave seja descartada pelo coletor de lixo, ou seja, feita finalizável, finalizada e recuperada. Quando uma chave é descartada, sua entrada é efetivamente removida do mapa, portanto, essa classe se comporta de forma um pouco diferente de outras Map implementações.
Há suporte para valores nulos e a chave nula. Essa classe tem características de desempenho semelhantes às da HashMap classe e tem os mesmos parâmetros de eficiência da<> capacidade< inicial/em> e <em>fator< de carga/em>.
Como a maioria das classes de coleção, essa classe não é sincronizada. Um sincronizado WeakHashMap pode ser construído usando o Collections#synchronizedMap Collections.synchronizedMap método.
Essa classe destina-se principalmente ao uso com objetos-chave cujos equals métodos testam a identidade do objeto usando o == operador. Depois que essa chave é descartada, ela nunca pode ser recriada, portanto, é impossível fazer uma pesquisa dessa chave em um WeakHashMap momento posterior e se surpreender que sua entrada tenha sido removida. Essa classe funcionará perfeitamente bem com objetos-chave cujos equals métodos não se baseiam na identidade do objeto, como String instâncias. No entanto, com esses objetos de chave recriaveis, a remoção automática de WeakHashMap entradas cujas chaves foram descartadas pode ser confusa.
O comportamento da WeakHashMap classe depende, em parte, das ações do coletor de lixo, portanto, vários invariáveis familiares (embora não necessários) Map não são mantidos para essa classe. Como o coletor de lixo pode descartar chaves a qualquer momento, um WeakHashMap pode se comportar como se um thread desconhecido estivesse removendo silenciosamente as entradas. Em particular, mesmo que você sincronize em uma WeakHashMap instância e invoque nenhum de seus métodos mutadores, é possível que o size método retorne valores menores ao longo do tempo, para que o isEmpty método retorne false e, em seguida true, para que o containsKey método retorne true e posteriormente false para uma determinada chave, para que o get método retorne um valor para uma determinada chave, mas posteriormente retornar null, para o put método a ser retornado null e o remove método a ser retornado false para uma chave que anteriormente parecia estar no mapa e para exames sucessivos do conjunto de chaves, da coleção de valores e do conjunto de entradas para produzir um número sucessivamente menor de elementos.
Cada objeto de chave em um WeakHashMap é armazenado indiretamente como o referencial de uma referência fraca. Portanto, uma chave será removida automaticamente somente depois que as referências fracas a ela, dentro e fora do mapa, forem desmarcadas pelo coletor de lixo.
<nota de implementação forte>:/strong> Os objetos de valor em um WeakHashMap são mantidos por referências< fortes comuns. Portanto, deve-se tomar cuidado para garantir que os objetos de valor não se refiram fortemente às suas próprias chaves, direta ou indiretamente, pois isso impedirá que as chaves sejam descartadas. Observe que um objeto de valor pode se referir indiretamente à sua chave por meio do WeakHashMap próprio; ou seja, um objeto de valor pode se referir fortemente a algum outro objeto de chave cujo objeto de valor associado, por sua vez, se refere fortemente à chave do primeiro objeto de valor. Se os valores no mapa não dependerem do mapa que contém referências fortes a eles, uma maneira de lidar com isso é encapsular os próprios WeakReferences valores dentro antes de inserir, como em: m.put(key, new WeakReference(value))e desembrulhar em cada get.
Os iteradores retornados pelo iterator método das coleções retornadas por todos os "métodos de exibição de coleção" dessa classe são rapidamente reprovados: se o mapa for modificado estruturalmente a qualquer momento após a criação do iterador, de qualquer forma, exceto por meio do próprio remove método do iterador, o iterador lançará um ConcurrentModificationException. Assim, diante da modificação simultânea, o iterador falha de forma rápida e limpa, em vez de arriscar um comportamento arbitrário e não determinístico em um momento indeterminado no futuro.
Observe que o comportamento de fail-fast de um iterador não pode ser garantido como ele é, em geral, impossível fazer quaisquer garantias difíceis na presença de modificação simultânea não sincronizada. Iteradores com fail-fast são lançados ConcurrentModificationException em uma base de melhor esforço. Portanto, seria errado escrever um programa que dependesse dessa exceção para sua correção: o comportamento rápido de iteradores deve ser usado apenas para detectar bugs.
Essa classe é membro do Java Collections Framework.
Adicionado em 1.2.
Java documentação para java.util.WeakHashMap.
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 | Descrição |
|---|---|
| WeakHashMap() |
Constrói um novo, vazio |
| WeakHashMap(IDictionary) |
Constrói um novo |
| WeakHashMap(Int32, Single) |
Constrói um novo, vazio |
| WeakHashMap(Int32) |
Constrói um novo, vazio |
| WeakHashMap(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
Propriedades
| Nome | Descrição |
|---|---|
| Class |
Retorna a classe de tempo de execução deste |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| IsEmpty |
Retornará true se este mapa não contiver mapeamentos chave-valor. (Herdado de AbstractMap) |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Obtém os sinalizadores de estado atribuídos pela última vez pelo runtime. (Herdado de JavaObject) |
| JniPeerMembers |
Obtém os metadados JNI usados para acessar membros dessa associação Java. |
| 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 | Descrição |
|---|---|
| Clear() |
Remove todos os mapeamentos deste mapa (operação opcional). (Herdado de AbstractMap) |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delega a construção desse par ao gerenciador de valores do runtime. (Herdado de JavaObject) |
| ContainsKey(Object) |
Retornará true se este mapa contiver um mapeamento para a chave especificada. (Herdado de AbstractMap) |
| ContainsValue(Object) |
Retorna true se este mapa mapeia uma ou mais chaves para o valor especificado. (Herdado de AbstractMap) |
| 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() |
Pede ao gerenciador de valores para descartar esse par, a menos que seu mapeamento mantenha essa mesma instância gerenciada. (Herdado de JavaObject) |
| EntrySet() |
Retorna uma |
| Equals(Object) |
Testa se outro par gerenciado se refere ao mesmo objeto Java. (Herdado de JavaObject) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| ForEach(IBiConsumer) |
Chama a operação especificada para entradas de mapa cujas chaves fracas não foram desmarcadas. |
| Get(Object) |
Retorna o valor para o qual a chave especificada é mapeada ou nula se este mapa não contiver nenhum mapeamento para a chave. (Herdado de AbstractMap) |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| JavaFinalize() |
Obsoleto.
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) |
| KeySet() |
Retorna uma exibição Set das chaves contidas neste mapa. (Herdado de AbstractMap) |
| NewWeakHashMap(Int32) |
Cria um WeakHashMap novo e vazio adequado para o número esperado de mapeamentos. |
| Notify() |
Ativa um único thread que está aguardando no monitor desse objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| Put(Object, Object) |
Associa o valor especificado à chave especificada neste mapa (operação opcional). (Herdado de AbstractMap) |
| PutAll(IDictionary) |
Copia todos os mapeamentos do mapa especificado para este mapa (operação opcional). (Herdado de AbstractMap) |
| Remove(Object) |
Remove o mapeamento de uma chave deste mapa se ela estiver presente (operação opcional). (Herdado de AbstractMap) |
| ReplaceAll(IBiFunction) |
Atualiza valores para entradas cujas chaves fracas não foram desmarcadas. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Armazena um valor de referência no bloco de controle sem criar uma cópia de referência JNI. (Herdado de JavaObject) |
| Size() |
Retorna o número de mapeamentos chave-valor neste mapa. (Herdado de AbstractMap) |
| 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 do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| Values() |
Retorna uma exibição coleção dos valores contidos neste mapa. (Herdado de AbstractMap) |
| Wait() |
Faz com que o thread atual aguarde até que seja despertado, normalmente sendo <notificado></em> ou <em>interrompido</em>. (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <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 seja ativado, normalmente sendo <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 | Descrição |
|---|---|
| IJavaPeerable.Disposed() |
Marca esse par como descartado e chama |
| IJavaPeerable.Finalized() |
Marca esse par como descartado e chama |
| IJavaPeerable.JniObjectReferenceControlBlock |
Obtém o ponteiro de bloco de controle nativo usado por esse par. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Armazena o código de hash de identidade fornecido pelo runtime. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Substitui os sinalizadores de estado de par gerenciado armazenados. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Atualiza a referência de par e libera o bloco de controle de um par descartado quando a referência é inválida. (Herdado de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Remove essa instância da pesquisa de objeto Java do runtime. |
Métodos de Extensão
| Nome | Descrição |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo verificada pelo tempo de execução do Android. |
| JavaCast<TResult>(IJavaObject) |
Reutiliza um par gerenciado compatível ou obtém um wrapper do tipo solicitado. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |