ActorBase Klasse

Paket:

microsoft.servicefabric.actors.runtime

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

public class ActorBase

Stellt die Basisklasse für Akteure dar. Actor

Bemerkungen:Dies ist ein Basistyp für Actor. Er stellt die Funktionalität bereit, die für alle Akteure gilt, die von Akteur implementiert werden, der von Actor "Der Zustand wird für die Garbage Collection des Akteurs beibehalten" und "Fail overs" implementiert wird. Das Speichern und Abrufen des Zustands wird vom Akteurstatusanbieter ActorStateProviderbereitgestellt.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
ActorBase(FabricActorService actorService, ActorId actorId)

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
FabricActorService	getActorService() Ruft das zustandsbehaftete Dienstreplikat ab, das den Actor hostet.
String	getApplicationName() Ruft den Namen der Anwendung ab, die den Akteurdienst enthält, der diesen Actor hostt.
DiagnosticsManagerActorContext	getDiagnosticsContext() Gibt den Diagnose Kontext für einen Akteur zurück. Nur zur internen Verwendung.
<T> T	getEvent(Class<T> eventClass) Ruft das Ereignis für die angegebene Ereignisschnittstelle ab.
ActorId	getId() Ruft die Identität dieses Akteurs mit dem Actor-Dienst ab.
ActorReminder	getReminder(String reminderName) Ruft die Akteurerinnerung mit dem angegebenen Erinnerungsnamen ab.
URI	getServiceUri() Ruft den URI des Akteurdiensts ab, der diesen Akteur hosten wird.
boolean	isDirty() Überprüfen Sie, ob der Status des Akteurs modifiziert ist.
CompletableFuture<?>	onActivateAsync() Überschreiben Sie diese Methode, um die Member zu initialisieren, den Zustand zu initialisieren oder Zeitgeber zu registrieren. Diese Methode wird direkt nach dem Aktivieren des Akteurs und vor dem Senden von Methodenaufrufen oder Erinnerungen aufgerufen.
CompletableFuture<?>	onDeactivateAsync() Überschreiben Sie diese Methode, um alle Ressourcen freizugeben, einschließlich des Aufhebens der Registrierung der Timer. Diese Methode wird direkt vor der Deaktivierung des Akteurs aufgerufen.
CompletableFuture<?>	onPostActorMethodAsync(ActorMethodContext actorMethodContext) Diese Methode wird von der Actor-Runtime aufgerufen, die eine Actor-Methode ausgeführt hat. Überschreiben Sie diese Methode, um aktionen auszuführen, nachdem die Ausführung einer Actor-Methode abgeschlossen wurde. Bemerkungen: Diese Methode wird von der Actor Runtime vor aufgerufen: Aufrufen einer Actor-Schnittstellenmethode, wenn eine Clientanforderung kommt. Aufrufen einer Methode auf der Remindable Schnittstelle, wenn eine Erinnerung ausgelöst wird. Aufrufen eines Timerrückrufs, wenn der Timer ausgelöst wird.
CompletableFuture<?>	onPreActorMethodAsync(ActorMethodContext actorMethodContext) Diese Methode wird von der Actor Runtime kurz vor dem Aufrufen einer Actor-Methode aufgerufen. Überschreiben Sie diese Methode zum Ausführen von Aktionen, bevor eine Actor-Methode aufgerufen wird. Bemerkungen:Diese Methode wird von der Actor Runtime vor aufgerufen: Aufrufen einer Actor-Schnittstellenmethode, wenn eine Clientanforderung kommt. Aufrufen einer Methode auf der Remindable Schnittstelle, wenn eine Erinnerung ausgelöst wird. Aufrufen eines Timerrückrufs, wenn der Timer ausgelöst wird.
CompletableFuture<?>	registerReminderAsync(String reminderName, byte[] state, Duration dueTime, Duration period) Registriert die angegebene Erinnerung beim Akteur.
ActorTimer	registerTimer(Function<Object, CompletableFuture<?>> asyncCallback, Object state, Duration dueTime, Duration period) Registriert einen Timer für den Akteur.
ActorTimer	registerTimer(Function<Object, CompletableFuture<?>> asyncCallback, String asyncCallbackFunctionName, Object state, Duration dueTime, Duration period) Registriert einen Timer für den Akteur.
void	setDirty(boolean isDirty) Legt den Status des Akteurs auf modifiziert fest.
void	setDummy(boolean isDummy) Legen Sie den Status des Akteurs fest, unabhängig davon, ob er dummy ist oder nicht.
CompletableFuture<?>	unregisterReminderAsync(ActorReminder reminder) Hebt die Registrierung der angegebenen Erinnerung beim Actor auf.
void	unregisterTimer(ActorTimer timer) Hebt die Registrierung eines Timers auf, der zuvor für diesen Akteur festgelegt wurde.

Details zum Konstruktor

ActorBase

protected ActorBase(FabricActorService actorService, ActorId actorId)

Parameter:

actorService

actorId

Details zur Methode

getActorService

public FabricActorService getActorService()

Ruft das zustandsbehaftete Dienstreplikat ab, das den Actor hostet.

Gibt zurück:

FabricActorService , das das zustandsbehaftete Dienstreplikat darstellt, das den Akteur hostet. Schauspieler.

getApplicationName

public String getApplicationName()

Ruft den Namen der Anwendung ab, die den Akteurdienst enthält, der diesen Actor hostt.

Gibt zurück:

Name der Anwendung, die den Akteurdienst enthält, der diesen Actor hosten soll.

getDiagnosticsContext

public DiagnosticsManagerActorContext getDiagnosticsContext()

Gibt den Diagnose Kontext für einen Akteur zurück. Nur zur internen Verwendung.

Gibt zurück:

Diagnose Kontext.

getEvent

protected T getEvent(Class eventClass)

Ruft das Ereignis für die angegebene Ereignisschnittstelle ab.

Parameter:

eventClass - Ereignisklasse.

Gibt zurück:

Gibt ein Ereignis zurück, das die angegebene Schnittstelle darstellt.

getId

public ActorId getId()

Ruft die Identität dieses Akteurs mit dem Actor-Dienst ab.

Gibt zurück:

ActorId für den Akteur.

getReminder

protected ActorReminder getReminder(String reminderName)

Ruft die Akteurerinnerung mit dem angegebenen Erinnerungsnamen ab.

Parameter:

reminderName - Name der abzurufenden Erinnerung.

Gibt zurück:

Ein ActorReminder , das eine Akteurerinnerung darstellt.

getServiceUri

public URI getServiceUri()

Ruft den URI des Akteurdiensts ab, der diesen Akteur hosten wird.

Gibt zurück:

java.net.URI des Akteurdiensts, der diesen Akteur hosten soll.

isDirty

public boolean isDirty()

Überprüfen Sie, ob der Status des Akteurs modifiziert ist.

Gibt zurück:

Boolescher Wert true, wenn der Status des Akteurs modifiziert ist, andernfalls false.

onActivateAsync

protected CompletableFuture onActivateAsync()

Überschreiben Sie diese Methode, um die Member zu initialisieren, den Zustand zu initialisieren oder Zeitgeber zu registrieren. Diese Methode wird direkt nach dem Aktivieren des Akteurs und vor dem Senden von Methodenaufrufen oder Erinnerungen aufgerufen.

Gibt zurück:

Ein CompletableFuture-Objekt, das den ausstehenden OnActivateAsync-Vorgang darstellt.

onDeactivateAsync

protected CompletableFuture onDeactivateAsync()

Überschreiben Sie diese Methode, um alle Ressourcen freizugeben, einschließlich des Aufhebens der Registrierung der Timer. Diese Methode wird direkt vor der Deaktivierung des Akteurs aufgerufen.

Gibt zurück:

Ein CompletableFuture-Objekt, das den ausstehenden OnDeactivateAsync-Vorgang darstellt.

onPostActorMethodAsync

protected CompletableFuture onPostActorMethodAsync(ActorMethodContext actorMethodContext)

Diese Methode wird von der Actor-Runtime aufgerufen, die eine Actor-Methode ausgeführt hat. Überschreiben Sie diese Methode, um aktionen auszuführen, nachdem die Ausführung einer Actor-Methode abgeschlossen wurde.

Bemerkungen: Diese Methode wird von der Actor Runtime vor aufgerufen:

• Aufrufen einer Actor-Schnittstellenmethode, wenn eine Clientanforderung kommt.

• Aufrufen einer Methode auf der Remindable Schnittstelle, wenn eine Erinnerung ausgelöst wird.

• Aufrufen eines Timerrückrufs, wenn der Timer ausgelöst wird.

Parameter:

actorMethodContext - Ein ActorMethodContext , der die Methode beschreibt, die vor dieser Methode von der Actor Runtime aufgerufen wurde.

Gibt zurück:

Ein CompletableFuture , der den Vorgang nach der Actor-Methode darstellt.

onPreActorMethodAsync

protected CompletableFuture onPreActorMethodAsync(ActorMethodContext actorMethodContext)

Diese Methode wird von der Actor Runtime kurz vor dem Aufrufen einer Actor-Methode aufgerufen. Überschreiben Sie diese Methode zum Ausführen von Aktionen, bevor eine Actor-Methode aufgerufen wird.

Bemerkungen:Diese Methode wird von der Actor Runtime vor aufgerufen:

• Aufrufen einer Actor-Schnittstellenmethode, wenn eine Clientanforderung kommt.

• Aufrufen einer Methode auf der Remindable Schnittstelle, wenn eine Erinnerung ausgelöst wird.

• Aufrufen eines Timerrückrufs, wenn der Timer ausgelöst wird.

Parameter:

actorMethodContext - Eine ActorMethodContext Beschreibung der Methode, die von der Actor Runtime aufgerufen wird, nachdem diese Methode abgeschlossen ist.

Gibt zurück:

Ein CompletableFuture Vor-Akteur-Methoden-Vorgang.

registerReminderAsync

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

Registriert die angegebene Erinnerung beim Akteur.

Parameter:

reminderName - Name der zu registrierenden Erinnerung

state - Zustand, der der Erinnerung zugeordnet ist.

dueTime - Ein java.time.Duration , der die Zeit darstellt, die vor dem Auslösen der Erinnerung verzögert werden muss. Geben Sie negative eine (-1) Millisekunde an, um zu verhindern, dass Erinnerungen ausgelöst werden. Geben Sie null (0) an, um die Erinnerung sofort auszulösen.

period - Das Zeitintervall zwischen dem Auslösen von Erinnerungen. Geben Sie negative eine (-1) Millisekunde an, um das periodische Auslösen zu deaktivieren.

Gibt zurück:

Eine Aufgabe, die den asynchronen Registrierungsvorgang darstellt.

registerTimer

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

Registriert einen Timer für den Akteur.

Parameter:

asyncCallback - Rückruf, um beim Auslösen des Timers aufzurufen.

state - Zustand, der an den Timerrückruf übergeben werden soll.

dueTime - TimeSpan, wenn der Akteurtimer zuerst fällig ist.

period - TimeSpan für den nachfolgenden Aufruf des Akteurzeitgebers.

Gibt zurück:

Gibt das ActorTimer-Objekt zurück.

registerTimer

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

Registriert einen Timer für den Akteur.

Parameter:

asyncCallback - Rückruf, um beim Auslösen des Timers aufzurufen.

asyncCallbackFunctionName - Name der AsyncCallBack-Funktion. Sie kann in onPreActorMethodAsync(ActorMethodContext actorMethodContext) und onPostActorMethodAsync(ActorMethodContext actorMethodContext) verwendet werden, um jede Benutzeraufgabe beim Pre- und Post-Aufruf dieser Funktion zu initiieren. Die -Eigenschaft getMethodName() gibt den Methodennamen an.

state - Zustand, der an den Timerrückruf übergeben werden soll.

dueTime - TimeSpan, wenn der Akteurtimer zuerst fällig ist.

period - TimeSpan für den nachfolgenden Aufruf des Akteurzeitgebers.

Gibt zurück:

Gibt das ActorTimer-Objekt zurück.

setDirty

public void setDirty(boolean isDirty)

Legt den Status des Akteurs auf modifiziert fest.

Parameter:

isDirty - nimmt den Status des Akteurs als booleschen Wert an: true oder false.

setDummy

protected void setDummy(boolean isDummy)

Legen Sie den Status des Akteurs fest, unabhängig davon, ob er dummy ist oder nicht.

Parameter:

isDummy - nimmt den Akteurstatus als booleschen Wert an: true oder false.

unregisterReminderAsync

protected CompletableFuture unregisterReminderAsync(ActorReminder reminder)

Hebt die Registrierung der angegebenen Erinnerung beim Actor auf.

Parameter:

reminder - Die Akteurerinnerung zum Aufheben der Registrierung.

Gibt zurück:

Eine Aufgabe, die den asynchronen Vorgang zum Aufheben der Registrierung darstellt.

unregisterTimer

protected void unregisterTimer(ActorTimer timer)

Hebt die Registrierung eines Timers auf, der zuvor für diesen Akteur festgelegt wurde.

Parameter:

timer - ActorTimer, der timer darstellt, der die Registrierung aufheben muss.