Remindable Schnittstelle

Paket:

microsoft.servicefabric.actors.runtime

public interface Remindable

Schnittstelle, die Akteure, die Erinnerungen verwenden, implementieren müssen.

Methodenzusammenfassung

Modifizierer und Typ

Methode und Beschreibung

CompletableFuture<?>

receiveReminderAsync(String reminderName, byte[] context, Duration timeSpan, Duration period) Erinnerungsrückruf wird aufgerufen, wenn eine Akteurerinnerung ausgelöst wird. Bemerkungen: Wenn eine Erinnerung ausgelöst wird, ruft die Actors-Runtime die methode receiveReminderAsync für den Actor auf. Ein Akteur kann mehrere Erinnerungen registrieren, und die ReceiveReminderAsync-Methode wird jedes Mal aufgerufen, wenn eine dieser Erinnerungen ausgelöst wird. Der Akteur kann den Erinnerungsnamen verwenden, der an die receiveReminderAsync-Methode übergeben wird, um herauszufinden, welche Erinnerung ausgelöst wurde. Die Actors-Laufzeit speichert den Actor-Zustand, wenn der receiveReminderAsync-Aufruf abgeschlossen ist. Wenn beim Speichern des Zustands ein Fehler auftritt, wird dieses Actor-Objekt deaktiviert und eine neue instance aktiviert, um anzugeben, dass der Zustand nach Abschluss der Erinnerung nicht gespeichert werden muss.

Details zur Methode

receiveReminderAsync

public CompletableFuture receiveReminderAsync(String reminderName, byte[] context, Duration timeSpan, Duration period)

Erinnerungsrückruf wird aufgerufen, wenn eine Akteurerinnerung ausgelöst wird.

Bemerkungen: Wenn eine Erinnerung ausgelöst wird, ruft die Actors-Runtime die methode receiveReminderAsync für den Actor auf. Ein Akteur kann mehrere Erinnerungen registrieren, und die ReceiveReminderAsync-Methode wird jedes Mal aufgerufen, wenn eine dieser Erinnerungen ausgelöst wird. Der Akteur kann den Erinnerungsnamen verwenden, der an die receiveReminderAsync-Methode übergeben wird, um herauszufinden, welche Erinnerung ausgelöst wurde. Die Actors-Laufzeit speichert den Actor-Zustand, wenn der receiveReminderAsync-Aufruf abgeschlossen ist. Wenn beim Speichern des Zustands ein Fehler auftritt, wird dieses Actor-Objekt deaktiviert und eine neue instance aktiviert, um anzugeben, dass der Zustand nach Abschluss der Erinnerung nicht gespeichert werden muss.

Parameter:

reminderName - Name der Erinnerung.

context - Der dieser Erinnerung zugeordnete Kontext wurde an actors runtime übergeben, als die Erinnerung erstellt wurde.

timeSpan - Zeitpunkt, zu dem eine Erinnerung mit dem Namen reminderName fällig ist

period - Das Zeitintervall zwischen dem Auslösen der Erinnerung mit dem Namen reminderName.

Gibt zurück:

Eine Aufgabe, die den asynchronen Vorgang darstellt, der von diesem Rückruf ausgeführt wird.