ActorStateManager Interface

Paquet:

microsoft.servicefabric.actors.runtime

public interface ActorStateManager

Représente l’interface que le gestionnaire d’état pour Actor implémente.

Résumé de la méthode

Modificateur et type	Méthode et description
<T> CompletableFuture<T>	addOrUpdateStateAsync(String stateName, T addValue, BiFunction<String, T, T> updateValueFactory) Ajoute un état d’acteur avec un nom d’état donné, s’il n’existe pas déjà ou met à jour le nom et la valeur d’état spécifiés, s’il n’existe pas.
<T> CompletableFuture<T>	addOrUpdateStateAsync(String stateName, T addValue, BiFunction<String, T, T> updateValueFactory, CancellationToken cancellationToken) Ajoute un état d’acteur avec un nom d’état donné, s’il n’existe pas déjà ou met à jour le nom et la valeur d’état spécifiés, s’il n’existe pas.
<T> CompletableFuture<?>	addStateAsync(String stateName, T value) Ajoute un état d’acteur avec un nom d’état donné.
<T> CompletableFuture<?>	addStateAsync(String stateName, T value, CancellationToken cancellationToken) Ajoute un état d’acteur avec un nom d’état donné.
CompletableFuture<?>	clearCacheAsync() Efface tous les états d’acteur mis en cache et toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement d’état. Remarques: Toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement sont effacées lors de l’effacement du cache et ne seront pas incluses dans l’opération d’enregistrement suivante.
CompletableFuture<?>	clearCacheAsync(CancellationToken cancellationToken) Efface tous les états d’acteur mis en cache et toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement d’état. Remarques: Toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement sont effacées lors de l’effacement du cache et ne seront pas incluses dans l’opération d’enregistrement suivante.
CompletableFuture<Boolean>	containsStateAsync(String stateName) Vérifie si un état d’acteur portant le nom spécifié existe.
CompletableFuture<Boolean>	containsStateAsync(String stateName, CancellationToken cancellationToken) Vérifie si un état d’acteur portant le nom spécifié existe.
<T> CompletableFuture<T>	getOrAddStateAsync(String stateName, T value) Obtient un état d’acteur avec un nom d’état donné, s’il existe ou ajoute l’état avec l’état avec le nom d’état spécifié, s’il existe.
<T> CompletableFuture<T>	getOrAddStateAsync(String stateName, T value, CancellationToken cancellationToken) Obtient un état d’acteur avec un nom d’état donné, s’il existe ou ajoute l’état avec l’état avec le nom d’état spécifié, s’il existe.
<T> CompletableFuture<T>	getStateAsync(String stateName) Obtient un état d’acteur avec le nom d’état spécifié.
<T> CompletableFuture<T>	getStateAsync(String stateName, CancellationToken cancellationToken) Obtient un état d’acteur avec le nom d’état spécifié.
CompletableFuture<List<String>>	getStateNamesAsync() Crée une liste de tous les noms d’état d’acteur pour l’acteur actuel.
CompletableFuture<List<String>>	getStateNamesAsync(CancellationToken cancellationToken) Crée une liste de tous les noms d’état d’acteur pour l’acteur actuel.
CompletableFuture<?>	removeStateAsync(String stateName) Supprime un état d’acteur avec un nom d’état donné à la valeur spécifiée.
CompletableFuture<?>	removeStateAsync(String stateName, CancellationToken cancellationToken) Supprime un état d’acteur avec un nom d’état donné à la valeur spécifiée.
CompletableFuture<?>	saveStateAsync() Enregistre explicitement toutes les modifications d’état mises en cache (ajout/mise à jour/suppression) effectuées depuis le dernier appel à saveStateAsync(CancellationToken cancellationToken) par l’exécution de l’acteur ou par l’utilisateur.
CompletableFuture<?>	saveStateAsync(CancellationToken cancellationToken) Enregistre explicitement toutes les modifications d’état mises en cache (ajout/mise à jour/suppression) effectuées depuis le dernier appel à saveStateAsync(CancellationToken cancellationToken) par l’exécution de l’acteur ou par l’utilisateur.
<T> CompletableFuture<?>	setStateAsync(String stateName, T value) Supprime un état d’acteur avec le nom d’état spécifié. Si un état d’acteur avec le nom spécifié n’existe pas, il est ajouté.
<T> CompletableFuture<?>	setStateAsync(String stateName, T value, CancellationToken cancellationToken) Supprime un état d’acteur avec le nom d’état spécifié. Si un état d’acteur avec le nom spécifié n’existe pas, il est ajouté.
<T> CompletableFuture<Boolean>	tryAddStateAsync(String stateName, T value) Tente d’ajouter un état d’acteur avec un nom d’état donné.
<T> CompletableFuture<Boolean>	tryAddStateAsync(String stateName, T value, CancellationToken cancellationToken) Tente d’ajouter un état d’acteur avec un nom d’état donné.
<T> CompletableFuture<ConditionalValue<T>>	tryGetStateAsync(String stateName) Tente d’obtenir un état d’acteur avec le nom d’état spécifié.
<T> CompletableFuture<ConditionalValue<T>>	tryGetStateAsync(String stateName, CancellationToken cancellationToken) Tente d’obtenir un état d’acteur avec le nom d’état spécifié.
CompletableFuture<Boolean>	tryRemoveStateAsync(String stateName) Tente de supprimer un état d’acteur avec le nom d’état spécifié.
CompletableFuture<Boolean>	tryRemoveStateAsync(String stateName, CancellationToken cancellationToken) Tente de supprimer un état d’acteur avec le nom d’état spécifié.

Détails de la méthode

addOrUpdateStateAsync

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

Ajoute un état d’acteur avec un nom d’état donné, s’il n’existe pas déjà ou met à jour le nom et la valeur d’état spécifiés, s’il n’existe pas.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter ou à obtenir.

addValue - Valeur de l’état de l’acteur à ajouter s’il n’existe pas.

updateValueFactory - Fonction de fabrique pour générer la valeur de l’état de l’acteur à mettre à jour s’il existe.

Retours:

Tâche qui représente l’opération d’ajout/mise à jour asynchrone. La valeur du paramètre T contient la valeur de l’état de l’acteur qui a été ajoutée/mise à jour.

addOrUpdateStateAsync

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

Ajoute un état d’acteur avec un nom d’état donné, s’il n’existe pas déjà ou met à jour le nom et la valeur d’état spécifiés, s’il n’existe pas.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter ou à obtenir.

addValue - Valeur de l’état de l’acteur à ajouter s’il n’existe pas.

updateValueFactory - Fonction de fabrique pour générer la valeur de l’état de l’acteur à mettre à jour s’il existe.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’ajout/mise à jour asynchrone. La valeur du paramètre T contient la valeur de l’état de l’acteur qui a été ajoutée/mise à jour.

addStateAsync

public CompletableFuture addStateAsync(String stateName, T value)

Ajoute un état d’acteur avec un nom d’état donné.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter.

value - Valeur de l’état de l’acteur à ajouter.

Retours:

Tâche qui représente l’opération d’ajout asynchrone.

addStateAsync

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

Ajoute un état d’acteur avec un nom d’état donné.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter.

value - Valeur de l’état de l’acteur à ajouter.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’ajout asynchrone.

clearCacheAsync

public CompletableFuture clearCacheAsync()

Efface tous les états d’acteur mis en cache et toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement d’état.

Remarques: Toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement sont effacées lors de l’effacement du cache et ne seront pas incluses dans l’opération d’enregistrement suivante.

Retours:

Tâche qui représente l’opération asynchrone d’effacement du cache.

clearCacheAsync

public CompletableFuture clearCacheAsync(CancellationToken cancellationToken)

Efface tous les états d’acteur mis en cache et toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement d’état.

Remarques: Toutes les opérations effectuées ActorStateManager depuis la dernière opération d’enregistrement sont effacées lors de l’effacement du cache et ne seront pas incluses dans l’opération d’enregistrement suivante.

Paramètres:

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération asynchrone d’effacement du cache.

containsStateAsync

public CompletableFuture containsStateAsync(String stateName)

Vérifie si un état d’acteur portant le nom spécifié existe.

Paramètres:

stateName - Nom de l’état de l’acteur.

Retours:

Tâche qui représente l’opération asynchrone case activée. La valeur du paramètre T est true si l’état avec le nom spécifié existe sinon false.

containsStateAsync

public CompletableFuture containsStateAsync(String stateName, CancellationToken cancellationToken)

Vérifie si un état d’acteur portant le nom spécifié existe.

Paramètres:

stateName - Nom de l’état de l’acteur.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération asynchrone case activée. La valeur du paramètre T est true si l’état avec le nom spécifié existe sinon false.

getOrAddStateAsync

public CompletableFuture getOrAddStateAsync(String stateName, T value)

Obtient un état d’acteur avec un nom d’état donné, s’il existe ou ajoute l’état avec l’état avec le nom d’état spécifié, s’il existe.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter/mettre à jour.

value - Valeur de l’état de l’acteur à ajouter /update.

Retours:

Tâche qui représente l’opération d’ajout ou d’obtention asynchrone. La valeur du paramètre T contient la valeur de l’état de l’acteur avec l’état donné.

getOrAddStateAsync

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

Obtient un état d’acteur avec un nom d’état donné, s’il existe ou ajoute l’état avec l’état avec le nom d’état spécifié, s’il existe.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter/mettre à jour.

value - Valeur de l’état de l’acteur à ajouter /update.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’ajout ou d’obtention asynchrone. La valeur du paramètre T contient la valeur de l’état de l’acteur avec l’état donné.

getStateAsync

public CompletableFuture getStateAsync(String stateName)

Obtient un état d’acteur avec le nom d’état spécifié.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter.

Retours:

Tâche qui représente l’opération d’obtention asynchrone. La valeur du paramètre T contient la valeur de l’état de l’acteur avec le nom d’état donné.

getStateAsync

public CompletableFuture getStateAsync(String stateName, CancellationToken cancellationToken)

Obtient un état d’acteur avec le nom d’état spécifié.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’obtention asynchrone. La valeur du paramètre T contient la valeur de l’état de l’acteur avec le nom d’état donné.

getStateNamesAsync

public CompletableFuture> getStateNamesAsync()

Crée une liste de tous les noms d’état d’acteur pour l’acteur actuel.

Retours:

Tâche qui représente l’opération d’énumération asynchrone. La valeur du paramètre T est énumérable de tous les noms d’état d’acteur.

getStateNamesAsync

public CompletableFuture> getStateNamesAsync(CancellationToken cancellationToken)

Crée une liste de tous les noms d’état d’acteur pour l’acteur actuel.

Paramètres:

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’énumération asynchrone. La valeur du paramètre T est énumérable de tous les noms d’état d’acteur.

removeStateAsync

public CompletableFuture removeStateAsync(String stateName)

Supprime un état d’acteur avec un nom d’état donné à la valeur spécifiée.

Paramètres:

stateName - Nom de l’état de l’acteur à supprimer.

Retours:

Tâche qui représente l’opération de suppression asynchrone.

removeStateAsync

public CompletableFuture removeStateAsync(String stateName, CancellationToken cancellationToken)

Supprime un état d’acteur avec un nom d’état donné à la valeur spécifiée.

Paramètres:

stateName - Nom de l’état de l’acteur à supprimer.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération de suppression asynchrone.

saveStateAsync

public CompletableFuture saveStateAsync()

Enregistre explicitement toutes les modifications d’état mises en cache (ajout/mise à jour/suppression) effectuées depuis le dernier appel à saveStateAsync(CancellationToken cancellationToken) par l’exécution de l’acteur ou par l’utilisateur.

Retours:

Tâche qui représente l’opération d’écriture d’enregistrement asynchrone.

saveStateAsync

public CompletableFuture saveStateAsync(CancellationToken cancellationToken)

Enregistre explicitement toutes les modifications d’état mises en cache (ajout/mise à jour/suppression) effectuées depuis le dernier appel à saveStateAsync(CancellationToken cancellationToken) par l’exécution de l’acteur ou par l’utilisateur.

Paramètres:

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’écriture d’enregistrement asynchrone.

setStateAsync

public CompletableFuture setStateAsync(String stateName, T value)

Supprime un état d’acteur avec le nom d’état spécifié. Si un état d’acteur avec le nom spécifié n’existe pas, il est ajouté.

Paramètres:

stateName - Nom de l’état de l’acteur à définir.

value - Valeur de l’état de l’acteur à définir.

Retours:

Tâche qui représente l’opération de définition asynchrone.

setStateAsync

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

Supprime un état d’acteur avec le nom d’état spécifié. Si un état d’acteur avec le nom spécifié n’existe pas, il est ajouté.

Paramètres:

stateName - Nom de l’état de l’acteur à définir.

value - Valeur de l’état de l’acteur à définir.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération de définition asynchrone.

tryAddStateAsync

public CompletableFuture tryAddStateAsync(String stateName, T value)

Tente d’ajouter un état d’acteur avec un nom d’état donné.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter.

value - Valeur de l’état de l’acteur à ajouter.

Retours:

Tâche qui représente l’opération d’ajout asynchrone. La valeur du paramètre T indique si l’état a été correctement ajouté.

tryAddStateAsync

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

Tente d’ajouter un état d’acteur avec un nom d’état donné.

Paramètres:

stateName - Nom de l’état de l’acteur à ajouter.

value - Valeur de l’état de l’acteur à ajouter.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’ajout asynchrone. La valeur du paramètre T indique si l’état a été correctement ajouté.

tryGetStateAsync

public CompletableFuture> tryGetStateAsync(String stateName)

Tente d’obtenir un état d’acteur avec le nom d’état spécifié.

Paramètres:

stateName - Nom de l’état de l’acteur à obtenir.

Retours:

Tâche qui représente l’opération d’obtention asynchrone. La valeur du paramètre T indique ConditionalValue si l’état de l’acteur est présent et la valeur de l’état de l’acteur s’il est présent.

tryGetStateAsync

public CompletableFuture> tryGetStateAsync(String stateName, CancellationToken cancellationToken)

Tente d’obtenir un état d’acteur avec le nom d’état spécifié.

Paramètres:

stateName - Nom de l’état de l’acteur à obtenir.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération d’obtention asynchrone. La valeur du paramètre T indique ConditionalValue si l’état de l’acteur est présent et la valeur de l’état de l’acteur s’il est présent.

tryRemoveStateAsync

public CompletableFuture tryRemoveStateAsync(String stateName)

Tente de supprimer un état d’acteur avec le nom d’état spécifié.

Paramètres:

stateName - Nom de l’état de l’acteur à supprimer.

Retours:

Tâche qui représente l’opération de suppression asynchrone. La valeur du paramètre T indique si l’état a été supprimé avec succès.

tryRemoveStateAsync

public CompletableFuture tryRemoveStateAsync(String stateName, CancellationToken cancellationToken)

Tente de supprimer un état d’acteur avec le nom d’état spécifié.

Paramètres:

stateName - Nom de l’état de l’acteur à supprimer.

cancellationToken -

CancellationTokenobjet pour indiquer l’annulation status de l’opération.

Retours:

Tâche qui représente l’opération de suppression asynchrone. La valeur du paramètre T indique si l’état a été supprimé avec succès.