ReliableHashMap<K,V> Classe

Pacote:

microsoft.servicefabric.data.collections

• java.lang.Object
• • microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs
  • • microsoft.servicefabric.data.collections.ReliableHashMap<K,V>

Parâmetros de tipo

K

V

public class ReliableHashMap<K extends String,V> implements ReliableCollection

Resumo do Construtor

Construtor	Description
ReliableHashMap(long store, long replicaId, String name, String traceId)

Resumo do método

Modificador e tipo	Método e descrição
CompletableFuture<Void>	clearAsync() Remove todo o estado do , incluindo repositório ReliableCollectionreplicado e persistente.
void	close()
CompletableFuture<V>	computeAsync(Transaction txn, K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction) Tenta calcular um mapeamento para a chave especificada e seu valor mapeado atual (ou nulo se não houver mapeamento atual).
CompletableFuture<V>	computeAsync(Transaction txn, K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction, Duration timeout, CancellationToken cancellationToken) Tenta calcular um mapeamento para a chave especificada e seu valor mapeado atual (ou nulo se não houver mapeamento atual).
CompletableFuture<V>	computeIfAbsentAsync(Transaction txn, K key, Function<? super K, ? extends V> mappingFunction) Se a chave especificada ainda não estiver associada a um valor, tentará calcular seu valor usando a função de mapeamento fornecida e a inserirá nesse mapa, a menos que seja nulo.
CompletableFuture<V>	computeIfAbsentAsync(Transaction txn, K key, Function<? super K, ? extends V> mappingFunction, Duration timeout, CancellationToken cancellationToken) Se a chave especificada ainda não estiver associada a um valor, tentará calcular seu valor usando a função de mapeamento fornecida e a inserirá nesse mapa, a menos que seja nulo.
CompletableFuture<V>	computeIfPresentAsync(Transaction txn, K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction) Se o valor da chave especificada estiver presente, tentará calcular um novo mapeamento, considerando a chave e seu valor mapeado atual.
CompletableFuture<V>	computeIfPresentAsync(Transaction txn, K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction, Duration timeout, CancellationToken cancellationToken) Se o valor da chave especificada estiver presente, tentará calcular um novo mapeamento, considerando a chave e seu valor mapeado atual.
CompletableFuture<Boolean>	containsKeyAsync(Transaction txn, K key) Testa se o objeto especificado é uma chave nesta tabela.
CompletableFuture<Boolean>	containsKeyAsync(Transaction txn, K key, Duration timeout, CancellationToken cancellationToken) Testa se o objeto especificado é uma chave nesta tabela.
CompletableFuture<Boolean>	containsKeyAsync(Transaction txn, K key, LockMode lockMode) Testa se o objeto especificado é uma chave nesta tabela.
CompletableFuture<Boolean>	containsKeyAsync(Transaction txn, K key, LockMode lockMode, Duration timeout, CancellationToken cancellationToken) Testa se o objeto especificado é uma chave nesta tabela.
CompletableFuture<AsyncEnumeration<V>>	elementsAsync(Transaction txn) Retorna uma enumeração dos valores nesta tabela.
CompletableFuture<V>	getAsync(Transaction txn, K key) Retorna o valor para o qual a chave especificada é mapeada ou nulo se este mapa não contiver nenhum mapeamento para a chave.
CompletableFuture<V>	getAsync(Transaction txn, K key, Duration timeout, CancellationToken cancellationToken) Retorna o valor para o qual a chave especificada é mapeada ou nulo se este mapa não contiver nenhum mapeamento para a chave.
long	getCount() Obtém o número de elementos contidos no ReliableCollection
URI	getName() Obtém o nome do URI exclusivo para o HashMap Confiável
CompletableFuture<AsyncEnumeration<K>>	keysAsync(Transaction txn) Retorna uma enumeração das chaves nesta tabela.
CompletableFuture<AsyncEnumeration<KeyValuePair<K, V>>>	keyValuesAsync(Transaction txn) Retorna uma enumeração dos pares chave-valor nesta tabela.
CompletableFuture<Boolean>	putAsync(Transaction txn, K key, V value) Mapeia a chave especificada para o valor especificado nesta tabela. Nem a chave nem o valor podem ser nulos.
CompletableFuture<Boolean>	putAsync(Transaction txn, K key, V value, Duration timeout, CancellationToken cancellationToken) Mapeia a chave especificada para o valor especificado nesta tabela. Nem a chave nem o valor podem ser nulos.
CompletableFuture<Boolean>	putIfAbsentAsync(Transaction txn, K key, V value) Se a chave especificada ainda não estiver associada a um valor, associe-a ao valor fornecido.
CompletableFuture<Boolean>	putIfAbsentAsync(Transaction txn, K key, V value, Duration timeout, CancellationToken cancellationToken) Se a chave especificada ainda não estiver associada a um valor, associe-a ao valor fornecido.
CompletableFuture<Boolean>	removeAsync(Transaction txn, K key) Remove a chave (e seu valor correspondente) deste mapa. Esse método não fará nada se a chave não estiver no mapa.
CompletableFuture<Boolean>	removeAsync(Transaction txn, K key, Duration timeout, CancellationToken cancellationToken) Remove a chave (e seu valor correspondente) deste mapa. Esse método não fará nada se a chave não estiver no mapa.
CompletableFuture<Boolean>	replaceAsync(Transaction txn, K key, V value) Substitui a entrada de uma chave somente se atualmente mapeada para algum valor.
CompletableFuture<Boolean>	replaceAsync(Transaction txn, K key, V value, Duration timeout, CancellationToken cancellationToken) Substitui a entrada de uma chave somente se atualmente mapeada para algum valor.
long	size() Retorna o número de mapeamentos.

Membros herdados

microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.freeTStore(long) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeAddAsync(long,long,String,byte [],int,long,long,int,int,CancellationToken) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeContainsKeyAsync(long,long,String,int,long,long,int,CancellationToken) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeEnumeratorAsync(long,long,long,int) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeGetAsync(long,long,String,long,long,int,CancellationToken) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeGetCount(long) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeKeyEnumeratorAsync(long,long,long,int) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativePutAsync(long,long,String,byte [],int,long,long,int,int,CancellationToken) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativePutIfAbsentAsync(long,long,String,byte [],int,long,long,int,int,CancellationToken) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeRemoveAsync(long,long,String,long,long,int,CancellationToken) microsoft.servicefabric.data.collections.ReliableCollectionsNativeAPIs.nativeUpdateAsync(long,long,String,byte [],int,long,long,int,int,CancellationToken)

Detalhes do construtor

ReliableHashMap

public ReliableHashMap(long store, long replicaId, String name, String traceId)

Parâmetros:

store

replicaId

name

traceId

Detalhes do método

clearAsync

public CompletableFuture clearAsync()

Remove todo o estado do , incluindo repositório ReliableCollectionreplicado e persistente.

Substituições:

ReliableHashMap<K,V>.clearAsync()

Retornos:

Um futuro completável que representa a operação de limpeza assíncrona.

close

public void close()

computeAsync

public CompletableFuture computeAsync(Transaction txn, K key, BiFunction remappingFunction)

Tenta calcular um mapeamento para a chave especificada e seu valor mapeado atual (ou nulo se não houver mapeamento atual).

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

remappingFunction - a função para calcular um valor

Retornos:

CompletableFuture com o valor new(computed) associado à chave especificada ou nulo se o valor calculado for nulo. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, remappingFunction ou txn for nulo.

computeAsync

public CompletableFuture computeAsync(Transaction txn, K key, BiFunction remappingFunction, Duration timeout, CancellationToken cancellationToken)

Tenta calcular um mapeamento para a chave especificada e seu valor mapeado atual (ou nulo se não houver mapeamento atual).

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado.

remappingFunction - a função para calcular um valor.

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com o valor new(computed) associado à chave especificada ou nulo se o valor calculado for nulo. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, remappingFunction ou txn for nulo.

computeIfAbsentAsync

public CompletableFuture computeIfAbsentAsync(Transaction txn, K key, Function mappingFunction)

Se a chave especificada ainda não estiver associada a um valor, tentará calcular seu valor usando a função de mapeamento fornecida e a inserirá nesse mapa, a menos que seja nulo.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

mappingFunction - a função para calcular um valor

Retornos:

CompletableFuture com o valor new(computed) se não houver mapeamento anterior ou nulo se o valor calculado for nulo ou se já existir um mapeamento para a chave especificada. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, mappingFunction ou txn for nulo.

computeIfAbsentAsync

public CompletableFuture computeIfAbsentAsync(Transaction txn, K key, Function mappingFunction, Duration timeout, CancellationToken cancellationToken)

Se a chave especificada ainda não estiver associada a um valor, tentará calcular seu valor usando a função de mapeamento fornecida e a inserirá nesse mapa, a menos que seja nulo.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

mappingFunction - a função para calcular um valor

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com o valor new(computed) se não houver mapeamento anterior ou nulo se o valor calculado for nulo ou se já existir um mapeamento para a chave especificada. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, mappingFunction ou txn for nulo.

computeIfPresentAsync

public CompletableFuture computeIfPresentAsync(Transaction txn, K key, BiFunction remappingFunction)

Se o valor da chave especificada estiver presente, tentará calcular um novo mapeamento, considerando a chave e seu valor mapeado atual.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual um valor pode ser associado.

remappingFunction - a função para calcular um valor.

Retornos:

CompletableFuture com o valor new(computed) se houver um mapeamento anterior ou nulo se o valor calculado for nulo ou se nenhum mapeamento existir para a chave especificada. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, remappingFunction ou txn for nulo.

computeIfPresentAsync

public CompletableFuture computeIfPresentAsync(Transaction txn, K key, BiFunction remappingFunction, Duration timeout, CancellationToken cancellationToken)

Se o valor da chave especificada estiver presente, tentará calcular um novo mapeamento, considerando a chave e seu valor mapeado atual.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual um valor pode ser associado.

remappingFunction - a função para calcular um valor.

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com o valor new(computed) se houver um mapeamento anterior ou nulo se o valor calculado for nulo ou se nenhum mapeamento existir para a chave especificada. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, remappingFunction ou txn for nulo.

containsKeyAsync

public CompletableFuture containsKeyAsync(Transaction txn, K key)

Testa se o objeto especificado é uma chave nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave possível

Retornos:

CompletableFuture com resultado true se a chave for encontrada neste Mapa, caso contrário, false. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

containsKeyAsync

public CompletableFuture containsKeyAsync(Transaction txn, K key, Duration timeout, CancellationToken cancellationToken)

Testa se o objeto especificado é uma chave nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave possível

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com resultado true se a chave for encontrada neste Mapa, caso contrário, false. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

containsKeyAsync

public CompletableFuture containsKeyAsync(Transaction txn, K key, LockMode lockMode)

Testa se o objeto especificado é uma chave nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave possível

lockMode - O modo de bloqueio a ser obtido durante a verificação da presença da chave.

Retornos:

CompletableFuture com resultado true se a chave for encontrada neste Mapa, caso contrário, false. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

containsKeyAsync

public CompletableFuture containsKeyAsync(Transaction txn, K key, LockMode lockMode, Duration timeout, CancellationToken cancellationToken)

Testa se o objeto especificado é uma chave nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave possível

lockMode - O modo de bloqueio a ser obtido durante a verificação da presença da chave.

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com resultado true se a chave for encontrada neste Mapa, caso contrário, false. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

elementsAsync

public CompletableFuture> elementsAsync(Transaction txn)

Retorna uma enumeração dos valores nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

Retornos:

CompletableFuture com uma enumeração dos valores neste Mapa. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se txn for nulo.

getAsync

public CompletableFuture getAsync(Transaction txn, K key)

Retorna o valor para o qual a chave especificada é mapeada ou nulo se este mapa não contiver nenhum mapeamento para a chave.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - a chave cujo valor associado deve ser retornado

Retornos:

CompletableFuture com o valor para o qual a chave especificada é mapeada, nulo se esse mapeamento não existir. O futuro é concluído excepcionalmente com IOException ou ClassNotFoundException para falhas de desserialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

getAsync

public CompletableFuture getAsync(Transaction txn, K key, Duration timeout, CancellationToken cancellationToken)

Retorna o valor para o qual a chave especificada é mapeada ou nulo se este mapa não contiver nenhum mapeamento para a chave.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - a chave cujo valor associado deve ser retornado

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com o valor para o qual a chave especificada é mapeada, nulo se esse mapeamento não existir. O futuro é concluído excepcionalmente com IOException ou ClassNotFoundException para falhas de desserialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

getCount

public long getCount()

Obtém o número de elementos contidos no ReliableCollection

Substituições:

ReliableHashMap<K,V>.getCount()

Retornos:

O número de elementos.

getName

public URI getName()

Obtém o nome do URI exclusivo para o HashMap Confiável

Substituições:

ReliableHashMap<K,V>.getName()

keysAsync

public CompletableFuture> keysAsync(Transaction txn)

Retorna uma enumeração das chaves nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

Retornos:

CompletableFuture com uma enumeração das chaves neste Mapa. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se txn for nulo.

keyValuesAsync

public CompletableFuture>> keyValuesAsync(Transaction txn)

Retorna uma enumeração dos pares chave-valor nesta tabela.

Parâmetros:

txn - A ID da transação associada a essa operação.

Retornos:

CompletableFuture com uma enumeração de KeyValuePair neste Mapa. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se txn for nulo.

putAsync

public CompletableFuture putAsync(Transaction txn, K key, V value)

Mapeia a chave especificada para o valor especificado nesta tabela. Nem a chave nem o valor podem ser nulos.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

value - valor a ser associado à chave especificada

Retornos:

CompletableFuture com resultado true se houver um mapeamento anterior, caso contrário, false. O futuro é concluído excepcionalmente com IOException para falhas de serialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, value ou txn for nulo.

putAsync

public CompletableFuture putAsync(Transaction txn, K key, V value, Duration timeout, CancellationToken cancellationToken)

Mapeia a chave especificada para o valor especificado nesta tabela. Nem a chave nem o valor podem ser nulos.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

value - valor a ser associado à chave especificada

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com resultado true se houver um mapeamento anterior, caso contrário, false. O futuro é concluído excepcionalmente com IOException para falhas de serialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, value ou txn for nulo.

putIfAbsentAsync

public CompletableFuture putIfAbsentAsync(Transaction txn, K key, V value)

Se a chave especificada ainda não estiver associada a um valor, associe-a ao valor fornecido.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

value - valor a ser associado à chave especificada

Retornos:

CompletableFuture com resultado true se o valor for aplicado; caso contrário, false. O futuro é concluído excepcionalmente com IOException para falhas de serialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, value ou txn for nulo.

putIfAbsentAsync

public CompletableFuture putIfAbsentAsync(Transaction txn, K key, V value, Duration timeout, CancellationToken cancellationToken)

Se a chave especificada ainda não estiver associada a um valor, associe-a ao valor fornecido.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado deve ser associado

value - valor a ser associado à chave especificada

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com resultado true se o valor for aplicado; caso contrário, false. O futuro é concluído excepcionalmente com IOException para falhas de serialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, value ou txn for nulo.

removeAsync

public CompletableFuture removeAsync(Transaction txn, K key)

Remove a chave (e seu valor correspondente) deste mapa. Esse método não fará nada se a chave não estiver no mapa.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - a chave que precisa ser removida.

Retornos:

CompletableFuture com resultado true se a chave for encontrada e a remoção for bem-sucedida, caso contrário, false. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

removeAsync

public CompletableFuture removeAsync(Transaction txn, K key, Duration timeout, CancellationToken cancellationToken)

Remove a chave (e seu valor correspondente) deste mapa. Esse método não fará nada se a chave não estiver no mapa.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - a chave que precisa ser removida.

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com resultado true se a chave for encontrada e a remoção for bem-sucedida, caso contrário, false. O futuro é concluído excepcionalmente com FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key ou txn for nulo.

replaceAsync

public CompletableFuture replaceAsync(Transaction txn, K key, V value)

Substitui a entrada de uma chave somente se atualmente mapeada para algum valor.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado está associado

value - valor a ser associado à chave especificada

Retornos:

CompletableFuture com resultado true se a chave for encontrada e a substituição for bem-sucedida, caso contrário, false. O futuro é concluído excepcionalmente com IOException para falhas de serialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, value ou txn for nulo.

replaceAsync

public CompletableFuture replaceAsync(Transaction txn, K key, V value, Duration timeout, CancellationToken cancellationToken)

Substitui a entrada de uma chave somente se atualmente mapeada para algum valor.

Parâmetros:

txn - A ID da transação associada a essa operação.

key - chave à qual o valor especificado está associado

value - valor a ser associado à chave especificada

timeout - o tempo limite para a conclusão da operação. O tempo limite padrão (4 segundos) será usado se nulo for passado.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

CompletableFuture com resultado true se a chave for encontrada e a substituição for bem-sucedida, caso contrário, false. O futuro é concluído excepcionalmente com IOException para falhas de serialização, FabricException para falhas relacionadas à malha.

Gera:

IllegalArgumentException - se key, value ou txn for nulo.

size

public long size()

Retorna o número de mapeamentos.

Retornos:

Esse método retorna o número de mapeamentos no mapa. Essa não é uma chamada assíncrona. Ele fornece o melhor número de mapeamentos.