ActorStateManager Interface

Pacote:

microsoft.servicefabric.actors.runtime

public interface ActorStateManager

Representa a interface que o gerenciador de estado para Actor implementa.

Resumo do método

Modificador e tipo	Método e descrição
<T> CompletableFuture<T>	addOrUpdateStateAsync(String stateName, T addValue, BiFunction<String, T, T> updateValueFactory) Adiciona um estado de ator com determinado nome de estado, se ele ainda não existir ou atualizar o nome e o valor do estado especificados, se ele não existir.
<T> CompletableFuture<T>	addOrUpdateStateAsync(String stateName, T addValue, BiFunction<String, T, T> updateValueFactory, CancellationToken cancellationToken) Adiciona um estado de ator com determinado nome de estado, se ele ainda não existir ou atualizar o nome e o valor do estado especificados, se ele não existir.
<T> CompletableFuture<?>	addStateAsync(String stateName, T value) Adiciona um estado de ator com o nome de estado fornecido.
<T> CompletableFuture<?>	addStateAsync(String stateName, T value, CancellationToken cancellationToken) Adiciona um estado de ator com o nome de estado fornecido.
CompletableFuture<?>	clearCacheAsync() Limpa todos os estados de ator armazenados em cache e todas as operações executadas desde ActorStateManager a última operação de salvamento de estado. Observações: Todas as operações executadas em ActorStateManager desde a última operação de salvamento são desmarcadas na limpeza do cache e não serão incluídas na próxima operação de salvamento.
CompletableFuture<?>	clearCacheAsync(CancellationToken cancellationToken) Limpa todos os estados de ator armazenados em cache e todas as operações executadas desde ActorStateManager a última operação de salvamento de estado. Observações: Todas as operações executadas em ActorStateManager desde a última operação de salvamento são desmarcadas na limpeza do cache e não serão incluídas na próxima operação de salvamento.
CompletableFuture<Boolean>	containsStateAsync(String stateName) Verifica se existe um estado de ator com o nome especificado.
CompletableFuture<Boolean>	containsStateAsync(String stateName, CancellationToken cancellationToken) Verifica se existe um estado de ator com o nome especificado.
<T> CompletableFuture<T>	getOrAddStateAsync(String stateName, T value) Obtém um estado de ator com determinado nome de estado, se ele existir ou adicionar o estado com o estado com o nome de estado especificado, se ele existir.
<T> CompletableFuture<T>	getOrAddStateAsync(String stateName, T value, CancellationToken cancellationToken) Obtém um estado de ator com determinado nome de estado, se ele existir ou adicionar o estado com o estado com o nome de estado especificado, se ele existir.
<T> CompletableFuture<T>	getStateAsync(String stateName) Obtém um estado de ator com o nome de estado especificado.
<T> CompletableFuture<T>	getStateAsync(String stateName, CancellationToken cancellationToken) Obtém um estado de ator com o nome de estado especificado.
CompletableFuture<List<String>>	getStateNamesAsync() Cria uma Lista de todos os nomes de estado do ator para o ator atual.
CompletableFuture<List<String>>	getStateNamesAsync(CancellationToken cancellationToken) Cria uma Lista de todos os nomes de estado do ator para o ator atual.
CompletableFuture<?>	removeStateAsync(String stateName) Remove um estado de ator com determinado nome de estado para o valor especificado.
CompletableFuture<?>	removeStateAsync(String stateName, CancellationToken cancellationToken) Remove um estado de ator com determinado nome de estado para o valor especificado.
CompletableFuture<?>	saveStateAsync() Salva todas as alterações de estado armazenadas em cache (adicionar/atualizar/remover) que foram feitas desde a última chamada para saveStateAsync(CancellationToken cancellationToken) por runtime de ator ou pelo usuário explicitamente.
CompletableFuture<?>	saveStateAsync(CancellationToken cancellationToken) Salva todas as alterações de estado armazenadas em cache (adicionar/atualizar/remover) que foram feitas desde a última chamada para saveStateAsync(CancellationToken cancellationToken) por runtime de ator ou pelo usuário explicitamente.
<T> CompletableFuture<?>	setStateAsync(String stateName, T value) Remove um estado de ator com o nome de estado especificado. Se um estado de ator com o nome especificado não existir, ele será adicionado.
<T> CompletableFuture<?>	setStateAsync(String stateName, T value, CancellationToken cancellationToken) Remove um estado de ator com o nome de estado especificado. Se um estado de ator com o nome especificado não existir, ele será adicionado.
<T> CompletableFuture<Boolean>	tryAddStateAsync(String stateName, T value) Tenta adicionar um estado de ator com o nome de estado fornecido.
<T> CompletableFuture<Boolean>	tryAddStateAsync(String stateName, T value, CancellationToken cancellationToken) Tenta adicionar um estado de ator com o nome de estado fornecido.
<T> CompletableFuture<ConditionalValue<T>>	tryGetStateAsync(String stateName) Tenta obter um estado de ator com o nome de estado especificado.
<T> CompletableFuture<ConditionalValue<T>>	tryGetStateAsync(String stateName, CancellationToken cancellationToken) Tenta obter um estado de ator com o nome de estado especificado.
CompletableFuture<Boolean>	tryRemoveStateAsync(String stateName) Tenta remover um estado de ator com o nome de estado especificado.
CompletableFuture<Boolean>	tryRemoveStateAsync(String stateName, CancellationToken cancellationToken) Tenta remover um estado de ator com o nome de estado especificado.

Detalhes do método

addOrUpdateStateAsync

public CompletableFuture addOrUpdateStateAsync(String stateName, T addValue, BiFunction updateValueFactory)

Adiciona um estado de ator com determinado nome de estado, se ele ainda não existir ou atualizar o nome e o valor do estado especificados, se ele não existir.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado ou obtido.

addValue - Valor do estado do ator a ser adicionado se ele não existir.

updateValueFactory - Função de fábrica para gerar o valor do estado do ator a ser atualizado se ele existir.

Retornos:

Uma tarefa que representa a operação de adição/atualização assíncrona. O valor do parâmetro T contém o valor do estado do ator que foi adicionado/atualizado.

addOrUpdateStateAsync

public CompletableFuture addOrUpdateStateAsync(String stateName, T addValue, BiFunction updateValueFactory, CancellationToken cancellationToken)

Adiciona um estado de ator com determinado nome de estado, se ele ainda não existir ou atualizar o nome e o valor do estado especificados, se ele não existir.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado ou obtido.

addValue - Valor do estado do ator a ser adicionado se ele não existir.

updateValueFactory - Função de fábrica para gerar o valor do estado do ator a ser atualizado se ele existir.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de adição/atualização assíncrona. O valor do parâmetro T contém o valor do estado do ator que foi adicionado/atualizado.

addStateAsync

public CompletableFuture addStateAsync(String stateName, T value)

Adiciona um estado de ator com o nome de estado fornecido.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado.

value - Valor do estado do ator a ser adicionado.

Retornos:

Uma tarefa que representa a operação de adição assíncrona.

addStateAsync

public CompletableFuture addStateAsync(String stateName, T value, CancellationToken cancellationToken)

Adiciona um estado de ator com o nome de estado fornecido.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado.

value - Valor do estado do ator a ser adicionado.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de adição assíncrona.

clearCacheAsync

public CompletableFuture clearCacheAsync()

Limpa todos os estados de ator armazenados em cache e todas as operações executadas desde ActorStateManager a última operação de salvamento de estado.

Observações: Todas as operações executadas em ActorStateManager desde a última operação de salvamento são desmarcadas na limpeza do cache e não serão incluídas na próxima operação de salvamento.

Retornos:

Uma tarefa que representa a operação de cache de limpeza assíncrona.

clearCacheAsync

public CompletableFuture clearCacheAsync(CancellationToken cancellationToken)

Limpa todos os estados de ator armazenados em cache e todas as operações executadas desde ActorStateManager a última operação de salvamento de estado.

Observações: Todas as operações executadas em ActorStateManager desde a última operação de salvamento são desmarcadas na limpeza do cache e não serão incluídas na próxima operação de salvamento.

Parâmetros:

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de cache de limpeza assíncrona.

containsStateAsync

public CompletableFuture containsStateAsync(String stateName)

Verifica se existe um estado de ator com o nome especificado.

Parâmetros:

stateName - Nome do estado do ator.

Retornos:

Uma tarefa que representa a operação de marcar assíncrona. O valor do parâmetro T será true se o estado com o nome especificado existir, caso contrário, false.

containsStateAsync

public CompletableFuture containsStateAsync(String stateName, CancellationToken cancellationToken)

Verifica se existe um estado de ator com o nome especificado.

Parâmetros:

stateName - Nome do estado do ator.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de marcar assíncrona. O valor do parâmetro T será true se o estado com o nome especificado existir, caso contrário, false.

getOrAddStateAsync

public CompletableFuture getOrAddStateAsync(String stateName, T value)

Obtém um estado de ator com determinado nome de estado, se ele existir ou adicionar o estado com o estado com o nome de estado especificado, se ele existir.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado/atualizado.

value - Valor do estado do ator para adicionar /update.

Retornos:

Uma tarefa que representa a operação assíncrona de adicionar ou obter. O valor do parâmetro T contém o valor do estado do ator com o estado fornecido.

getOrAddStateAsync

public CompletableFuture getOrAddStateAsync(String stateName, T value, CancellationToken cancellationToken)

Obtém um estado de ator com determinado nome de estado, se ele existir ou adicionar o estado com o estado com o nome de estado especificado, se ele existir.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado/atualizado.

value - Valor do estado do ator para adicionar /update.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação assíncrona de adicionar ou obter. O valor do parâmetro T contém o valor do estado do ator com o estado fornecido.

getStateAsync

public CompletableFuture getStateAsync(String stateName)

Obtém um estado de ator com o nome de estado especificado.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado.

Retornos:

Uma tarefa que representa a operação de obtenção assíncrona. O valor do parâmetro T contém o valor do estado do ator com o nome de estado fornecido.

getStateAsync

public CompletableFuture getStateAsync(String stateName, CancellationToken cancellationToken)

Obtém um estado de ator com o nome de estado especificado.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de obtenção assíncrona. O valor do parâmetro T contém o valor do estado do ator com o nome de estado fornecido.

getStateNamesAsync

public CompletableFuture> getStateNamesAsync()

Cria uma Lista de todos os nomes de estado do ator para o ator atual.

Retornos:

Uma tarefa que representa a operação de enumeração assíncrona. O valor do parâmetro T é enumerável de todos os nomes de estado do ator.

getStateNamesAsync

public CompletableFuture> getStateNamesAsync(CancellationToken cancellationToken)

Cria uma Lista de todos os nomes de estado do ator para o ator atual.

Parâmetros:

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de enumeração assíncrona. O valor do parâmetro T é enumerável de todos os nomes de estado do ator.

removeStateAsync

public CompletableFuture removeStateAsync(String stateName)

Remove um estado de ator com determinado nome de estado para o valor especificado.

Parâmetros:

stateName - Nome do estado do ator a ser removido.

Retornos:

Uma tarefa que representa a operação de remoção assíncrona.

removeStateAsync

public CompletableFuture removeStateAsync(String stateName, CancellationToken cancellationToken)

Remove um estado de ator com determinado nome de estado para o valor especificado.

Parâmetros:

stateName - Nome do estado do ator a ser removido.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de remoção assíncrona.

saveStateAsync

public CompletableFuture saveStateAsync()

Salva todas as alterações de estado armazenadas em cache (adicionar/atualizar/remover) que foram feitas desde a última chamada para saveStateAsync(CancellationToken cancellationToken) por runtime de ator ou pelo usuário explicitamente.

Retornos:

Uma tarefa que representa a operação de salvar assíncrona.

saveStateAsync

public CompletableFuture saveStateAsync(CancellationToken cancellationToken)

Salva todas as alterações de estado armazenadas em cache (adicionar/atualizar/remover) que foram feitas desde a última chamada para saveStateAsync(CancellationToken cancellationToken) por runtime de ator ou pelo usuário explicitamente.

Parâmetros:

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de salvar assíncrona.

setStateAsync

public CompletableFuture setStateAsync(String stateName, T value)

Remove um estado de ator com o nome de estado especificado. Se um estado de ator com o nome especificado não existir, ele será adicionado.

Parâmetros:

stateName - Nome do estado do ator a ser definido.

value - Valor do estado do ator a ser definido.

Retornos:

Uma tarefa que representa a operação de conjuntos assíncrona.

setStateAsync

public CompletableFuture setStateAsync(String stateName, T value, CancellationToken cancellationToken)

Remove um estado de ator com o nome de estado especificado. Se um estado de ator com o nome especificado não existir, ele será adicionado.

Parâmetros:

stateName - Nome do estado do ator a ser definido.

value - Valor do estado do ator a ser definido.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de conjuntos assíncrona.

tryAddStateAsync

public CompletableFuture tryAddStateAsync(String stateName, T value)

Tenta adicionar um estado de ator com o nome de estado fornecido.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado.

value - Valor do estado do ator a ser adicionado.

Retornos:

Uma tarefa que representa a operação de adição assíncrona. O valor do parâmetro T indica se o estado foi adicionado com êxito.

tryAddStateAsync

public CompletableFuture tryAddStateAsync(String stateName, T value, CancellationToken cancellationToken)

Tenta adicionar um estado de ator com o nome de estado fornecido.

Parâmetros:

stateName - Nome do estado do ator a ser adicionado.

value - Valor do estado do ator a ser adicionado.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de adição assíncrona. O valor do parâmetro T indica se o estado foi adicionado com êxito.

tryGetStateAsync

public CompletableFuture> tryGetStateAsync(String stateName)

Tenta obter um estado de ator com o nome de estado especificado.

Parâmetros:

stateName - Nome do estado do ator a ser obtido.

Retornos:

Uma tarefa que representa a operação de obtenção assíncrona. O valor do parâmetro T contém ConditionalValue indicando se o estado do ator está presente e o valor do estado do ator se ele estiver presente.

tryGetStateAsync

public CompletableFuture> tryGetStateAsync(String stateName, CancellationToken cancellationToken)

Tenta obter um estado de ator com o nome de estado especificado.

Parâmetros:

stateName - Nome do estado do ator a ser obtido.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de obtenção assíncrona. O valor do parâmetro T contém ConditionalValue indicando se o estado do ator está presente e o valor do estado do ator se ele estiver presente.

tryRemoveStateAsync

public CompletableFuture tryRemoveStateAsync(String stateName)

Tenta remover um estado de ator com o nome de estado especificado.

Parâmetros:

stateName - Nome do estado do ator a ser removido.

Retornos:

Uma tarefa que representa a operação de remoção assíncrona. O valor do parâmetro T indica se o estado foi removido com êxito.

tryRemoveStateAsync

public CompletableFuture tryRemoveStateAsync(String stateName, CancellationToken cancellationToken)

Tenta remover um estado de ator com o nome de estado especificado.

Parâmetros:

stateName - Nome do estado do ator a ser removido.

cancellationToken -

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

Retornos:

Uma tarefa que representa a operação de remoção assíncrona. O valor do parâmetro T indica se o estado foi removido com êxito.