ActorBase Classe

Paquet:

microsoft.servicefabric.actors.runtime

• java.lang.Object
• • microsoft.servicefabric.actors.runtime.ActorBase

public class ActorBase

Représente la classe de base pour les acteurs. Actor

Remarques:Il s’agit d’un type de base pour l’acteur, il fournit la fonctionnalité qui est commune entre les acteurs implémentés par l’acteur dérivant de Actor L’état est conservé entre les garbage collections d’acteurs et les basculements. Le stockage et la récupération de l’état sont fournis par le fournisseur d’état acteur ActorStateProvider.

Récapitulatif du constructeur

Constructeur	Description
ActorBase(FabricActorService actorService, ActorId actorId)

Résumé de la méthode

Modificateur et type	Méthode et description
FabricActorService	getActorService() Obtient le service avec état réplica qui héberge l’acteur.
String	getApplicationName() Obtient le nom de l’application qui contient le service d’acteur qui héberge cet acteur.
DiagnosticsManagerActorContext	getDiagnosticsContext() Retourne le contexte diagnostics pour un acteur. À usage interne uniquement.
<T> T	getEvent(Class<T> eventClass) Obtient l’événement pour l’interface d’événement spécifiée.
ActorId	getId() Obtient l’identité de cet acteur avec le service d’acteur.
ActorReminder	getReminder(String reminderName) Obtient le rappel de l’acteur avec le nom de rappel spécifié.
URI	getServiceUri() Obtient l’URI du service d’acteur qui héberge cet acteur.
boolean	isDirty() Vérifiez si l’état de l’acteur est sale.
CompletableFuture<?>	onActivateAsync() Remplacez cette méthode pour initialiser les membres, initialiser l’état ou inscrire des minuteurs. Cette méthode est appelée juste après l’activation de l’acteur et avant qu’un appel de méthode ou des rappels ne soient envoyés dessus.
CompletableFuture<?>	onDeactivateAsync() Remplacez cette méthode pour libérer toutes les ressources, y compris la désinscription des minuteurs. Cette méthode est appelée juste avant la désactivation de l’acteur.
CompletableFuture<?>	onPostActorMethodAsync(ActorMethodContext actorMethodContext) Cette méthode est appelée par le runtime d’acteur qu’une méthode d’acteur a terminé l’exécution. Remplacez cette méthode pour effectuer des actions une fois qu’une méthode d’acteur a terminé l’exécution. Remarques: Cette méthode est appelée par le runtime de l’acteur avant : Appel d’une méthode d’interface d’acteur lorsqu’une demande cliente arrive. Appel d’une méthode sur Remindable l’interface lorsqu’un rappel se déclenche. Appel d’un rappel du minuteur lorsque le minuteur se déclenche.
CompletableFuture<?>	onPreActorMethodAsync(ActorMethodContext actorMethodContext) Cette méthode est appelée par le runtime d’acteur juste avant d’appeler une méthode d’acteur. Remplacez cette méthode pour effectuer des actions avant qu’une méthode d’acteur soit appelée. Remarques:Cette méthode est appelée par le runtime de l’acteur avant : Appel d’une méthode d’interface d’acteur lorsqu’une demande cliente arrive. Appel d’une méthode sur Remindable l’interface lorsqu’un rappel se déclenche. Appel d’un rappel du minuteur lorsque le minuteur se déclenche.
CompletableFuture<?>	registerReminderAsync(String reminderName, byte[] state, Duration dueTime, Duration period) Inscrit le rappel spécifié auprès de l’acteur.
ActorTimer	registerTimer(Function<Object, CompletableFuture<?>> asyncCallback, Object state, Duration dueTime, Duration period) Inscrit un minuteur pour l’acteur.
ActorTimer	registerTimer(Function<Object, CompletableFuture<?>> asyncCallback, String asyncCallbackFunctionName, Object state, Duration dueTime, Duration period) Inscrit un minuteur pour l’acteur.
void	setDirty(boolean isDirty) Définit l’état de l’acteur comme sale.
void	setDummy(boolean isDummy) Définissez l’état de l’acteur, qu’il soit factice ou non.
CompletableFuture<?>	unregisterReminderAsync(ActorReminder reminder) Annule l’inscription du rappel spécifié auprès de l’acteur.
void	unregisterTimer(ActorTimer timer) Annule l’inscription d’un minuteur précédemment défini sur cet acteur.

Détails du constructeur

ActorBase

protected ActorBase(FabricActorService actorService, ActorId actorId)

Paramètres:

actorService

actorId

Détails de la méthode

getActorService

public FabricActorService getActorService()

Obtient le service avec état réplica qui héberge l’acteur.

Retours:

FabricActorServicequi représente le service avec état réplica hébergeant l’acteur. Acteur.

getApplicationName

public String getApplicationName()

Obtient le nom de l’application qui contient le service d’acteur qui héberge cet acteur.

Retours:

Nom de l’application qui contient le service d’acteur qui héberge cet acteur.

getDiagnosticsContext

public DiagnosticsManagerActorContext getDiagnosticsContext()

Retourne le contexte diagnostics pour un acteur. À usage interne uniquement.

Retours:

diagnostics contexte.

getEvent

protected T getEvent(Class eventClass)

Obtient l’événement pour l’interface d’événement spécifiée.

Paramètres:

eventClass - Classe d’événements.

Retours:

Retourne un événement qui représente l’interface spécifiée.

getId

public ActorId getId()

Obtient l’identité de cet acteur avec le service d’acteur.

Retours:

ActorId pour l’acteur.

getReminder

protected ActorReminder getReminder(String reminderName)

Obtient le rappel de l’acteur avec le nom de rappel spécifié.

Paramètres:

reminderName - Nom du rappel à obtenir.

Retours:

ActorReminder qui représente un rappel d’acteur.

getServiceUri

public URI getServiceUri()

Obtient l’URI du service d’acteur qui héberge cet acteur.

Retours:

java.net.URI du service d’acteur qui héberge cet acteur.

isDirty

public boolean isDirty()

Vérifiez si l’état de l’acteur est sale.

Retours:

Valeur booléenne true si l’état de l’acteur est sale ; sinon, false.

onActivateAsync

protected CompletableFuture onActivateAsync()

Remplacez cette méthode pour initialiser les membres, initialiser l’état ou inscrire des minuteurs. Cette méthode est appelée juste après l’activation de l’acteur et avant qu’un appel de méthode ou des rappels ne soient envoyés dessus.

Retours:

CompletableFuture qui représente l’opération OnActivateAsync en cours.

onDeactivateAsync

protected CompletableFuture onDeactivateAsync()

Remplacez cette méthode pour libérer toutes les ressources, y compris la désinscription des minuteurs. Cette méthode est appelée juste avant la désactivation de l’acteur.

Retours:

CompletableFuture qui représente l’opération OnDeactivateAsync en cours.

onPostActorMethodAsync

protected CompletableFuture onPostActorMethodAsync(ActorMethodContext actorMethodContext)

Cette méthode est appelée par le runtime d’acteur qu’une méthode d’acteur a terminé l’exécution. Remplacez cette méthode pour effectuer des actions une fois qu’une méthode d’acteur a terminé l’exécution.

Remarques: Cette méthode est appelée par le runtime de l’acteur avant :

• Appel d’une méthode d’interface d’acteur lorsqu’une demande cliente arrive.

• Appel d’une méthode sur Remindable l’interface lorsqu’un rappel se déclenche.

• Appel d’un rappel du minuteur lorsque le minuteur se déclenche.

Paramètres:

actorMethodContext - ActorMethodContext décrivant la méthode qui a été appelée par le runtime d’acteur avant cette méthode.

Retours:

représentant une CompletableFuture opération post-acteur-méthode.

onPreActorMethodAsync

protected CompletableFuture onPreActorMethodAsync(ActorMethodContext actorMethodContext)

Cette méthode est appelée par le runtime d’acteur juste avant d’appeler une méthode d’acteur. Remplacez cette méthode pour effectuer des actions avant qu’une méthode d’acteur soit appelée.

Remarques:Cette méthode est appelée par le runtime de l’acteur avant :

• Appel d’une méthode d’interface d’acteur lorsqu’une demande cliente arrive.

• Appel d’une méthode sur Remindable l’interface lorsqu’un rappel se déclenche.

• Appel d’un rappel du minuteur lorsque le minuteur se déclenche.

Paramètres:

actorMethodContext - ActorMethodContext décrivant la méthode qui sera appelée par le runtime de l’acteur une fois cette méthode terminée.

Retours:

représentant une CompletableFuture opération pré-acteur-méthode.

registerReminderAsync

protected CompletableFuture registerReminderAsync(String reminderName, byte[] state, Duration dueTime, Duration period)

Inscrit le rappel spécifié auprès de l’acteur.

Paramètres:

reminderName - Nom du rappel à inscrire

state - État associé au rappel.

dueTime - java.time.Duration représentant le délai nécessaire avant de déclencher le rappel. Spécifiez une milliseconde négative (-1) pour empêcher le déclenchement du rappel. Spécifiez zéro (0) pour déclencher immédiatement le rappel.

period - Intervalle de temps entre le déclenchement des rappels. Spécifiez une milliseconde négative (-1) pour désactiver le déclenchement périodique.

Retours:

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

registerTimer

protected ActorTimer registerTimer(Function> asyncCallback, Object state, Duration dueTime, Duration period)

Inscrit un minuteur pour l’acteur.

Paramètres:

asyncCallback - Rappel à appeler lorsque le minuteur se déclenche.

state - État à passer dans le rappel du minuteur.

dueTime - TimeSpan lorsque le minuteur de l’acteur est dû pour la première fois.

period - TimeSpan pour l’appel ultérieur du minuteur d’acteur.

Retours:

Renvoie l’objet ActorTimer.

registerTimer

protected ActorTimer registerTimer(Function> asyncCallback, String asyncCallbackFunctionName, Object state, Duration dueTime, Duration period)

Inscrit un minuteur pour l’acteur.

Paramètres:

asyncCallback - Rappel à appeler lorsque le minuteur se déclenche.

asyncCallbackFunctionName - nom de la fonction AsyncCallBack. Il peut être utilisé dans onPreActorMethodAsync(ActorMethodContext actorMethodContext) et onPostActorMethodAsync(ActorMethodContext actorMethodContext) pour lancer n’importe quelle tâche utilisateur sur le pré-appel et le post-appel de cette fonction. La propriété getMethodName() donne le nom de la méthode.

state - État à passer dans le rappel du minuteur.

dueTime - TimeSpan lorsque le minuteur de l’acteur est dû pour la première fois.

period - TimeSpan pour l’appel ultérieur du minuteur d’acteur.

Retours:

Renvoie l’objet ActorTimer.

setDirty

public void setDirty(boolean isDirty)

Définit l’état de l’acteur comme sale.

Paramètres:

isDirty - prend l’état acteur comme valeur booléenne : true ou false.

setDummy

protected void setDummy(boolean isDummy)

Définissez l’état de l’acteur, qu’il soit factice ou non.

Paramètres:

isDummy - prend l’état acteur comme valeur booléenne : true ou false.

unregisterReminderAsync

protected CompletableFuture unregisterReminderAsync(ActorReminder reminder)

Annule l’inscription du rappel spécifié auprès de l’acteur.

Paramètres:

reminder - Rappel de l’acteur à annuler l’inscription.

Retours:

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

unregisterTimer

protected void unregisterTimer(ActorTimer timer)

Annule l’inscription d’un minuteur précédemment défini sur cet acteur.

Paramètres:

timer - ActorTimer représentant le minuteur qui doit être désinscrit.