StatefulServiceReplica Interface

Paquet:

system.fabric

public interface StatefulServiceReplica

Définit le comportement qui régit le cycle de vie d’un réplica, tel que le démarrage, l’initialisation, les modifications de rôle et l’arrêt.

Remarques:Les types de service avec état doivent implémenter cette interface. La logique d’un type de service avec état inclut le comportement appelé sur les réplicas principaux et le comportement appelé sur les réplicas secondaires. Si l’auteur du service souhaite utiliser le fourni FabricReplicator, le service doit également implémenter StateProvider pour utiliser l’implémentation de StateReplicator qui est fournie par FabricReplicator

Résumé de la méthode

Modificateur et type	Méthode et description
void	abort() Termine sans honte une instance. Remarques:La perte de bail et, en réponse au service, l’utilisation de reportFault(FaultType faultType) pour signaler une erreur sont des Permanent exemples de résiliation sans dommage. Lorsque cette méthode est appelée, le service instance doit immédiatement libérer et propre toutes les références et retourner.
CompletableFuture<String>	changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken) Modifie le rôle d’un réplica principal ou secondaire. Remarques:Le nouveau rôle est indiqué en tant que paramètre. Lorsque le service passe au nouveau rôle, il a la possibilité de mettre à jour son adresse d’écoute actuelle. L’adresse d’écoute est l’adresse à laquelle les clients s’y connectent. Cela permet au service lorsqu’il s’agit d’un réplica principal de revendiquer uniquement certaines ressources telles que les ports lorsque la communication à partir des clients est attendue.
CompletableFuture<Void>	closeAsync(CancellationToken cancellationToken) Ferme le service réplica lors de son arrêt. Notez que l’annulation est un avertissement et que l’opération peut toujours être terminée même si elle est annulée.
void	initialize(StatefulServiceInitializationParameters initializationParameters) Initialise un service nouvellement créé réplica.
CompletableFuture<Replicator>	openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken) Ouvre un service initialisé réplica afin que des actions supplémentaires puissent être effectuées.

Détails de la méthode

abort

public void abort()

Termine sans honte une instance.

Remarques:La perte de bail et, en réponse au service, l’utilisation de reportFault(FaultType faultType) pour signaler une erreur sont des Permanent exemples de résiliation sans dommage. Lorsque cette méthode est appelée, le service instance doit immédiatement libérer et propre toutes les références et retourner.

changeRoleAsync

public CompletableFuture changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken)

Modifie le rôle d’un réplica principal ou secondaire.

Remarques:Le nouveau rôle est indiqué en tant que paramètre. Lorsque le service passe au nouveau rôle, il a la possibilité de mettre à jour son adresse d’écoute actuelle. L’adresse d’écoute est l’adresse à laquelle les clients s’y connectent. Cela permet au service lorsqu’il s’agit d’un réplica principal de revendiquer uniquement certaines ressources telles que les ports lorsque la communication à partir des clients est attendue.

Paramètres:

newRole - mise à jour ReplicaRole vers laquelle cette réplica doit effectuer la transition.

cancellationToken -

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

Retours:

Retourne CompletableFuture de type java.lang.String, la nouvelle adresse de connexion du service qui doit être associée au réplica via l’affectation de noms Service Fabric.

closeAsync

public CompletableFuture closeAsync(CancellationToken cancellationToken)

Ferme le service réplica lors de son arrêt. Notez que l’annulation est un avertissement et que l’opération peut toujours être terminée même si elle est annulée.

Paramètres:

cancellationToken -

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

Retours:

Retourne CompletableFuture.

initialize

public void initialize(StatefulServiceInitializationParameters initializationParameters)

Initialise un service nouvellement créé réplica.

Paramètres:

initializationParameters - StatefulServiceInitializationParameters pour cette réplica.

openAsync

public CompletableFuture openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken)

Ouvre un service initialisé réplica afin que des actions supplémentaires puissent être effectuées.

Paramètres:

openMode - Cela prend en charge l’infrastructure Service Fabric et n’est pas destiné à être utilisé directement à partir de votre code.

partition - Informations StatefulServicePartition relatives à cette réplica.

cancellationToken -

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

Retours:

Retourne CompletableFuture><Replicator, qui Replicator est utilisé par le service avec état. Pour utiliser l’implémentation Service Fabric, dans openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken) , le réplica doit retourner un FabricReplicator obtenu à partir decreateReplicator(StateProvider stateProvider, ReplicatorSettings replicatorSettings)