ReliableCollectionsActorStateProvider Klasse
- java.
lang. Object - StateProviderReplica
- ActorStateProvider
- microsoft.
servicefabric. actors. runtime. ReliableCollectionsActorStateProvider
- microsoft.
public class ReliableCollectionsActorStateProvider implements ActorStateProvider
Zusammenfassung zum Konstruktor
Methodenzusammenfassung
Modifizierer und Typ | Methode und Beschreibung |
---|---|
void |
abort()
Beenden Sie das Zustandsanbieterreplikat erzwungen.
Bemerkungen:Dies tritt in der Regel auf, wenn ein dauerhafter Fehler auf dem Knoten erkannt wird oder wenn Service Fabric den Lebenszyklus des Replikats aufgrund interner Fehler nicht zuverlässig verwalten kann. |
CompletableFuture<?> |
actorActivatedAsync(ActorId actorId, CancellationToken cancellationToken)
Diese Methode wird im Rahmen des Aktivierungsprozesses des Akteurs mit der angegebenen ID aufgerufen. |
CompletableFuture<?> |
backupAsync(BackupOption option, Duration timeout, CancellationToken cancellationToken, BiFunction<BackupInfo, CancellationToken, CompletableFuture<Boolean>> backupCallback)
Führt eine vollständige Sicherung des gesamten zuverlässigen Zustands aus, der von diesem ReliableStateManager verwaltet wird.
Bemerkungen: Eine VOLLSTÄNDIGE Sicherung wird mit einem Timeout von einer Stunde ausgeführt. Vom BackupCallback zurückgegebener Boolescher Wert gibt an, ob der Dienst den Sicherungsordner erfolgreich an einen externen Speicherort verschieben konnte. Wenn false zurückgegeben wird, löst BackupAsync UnsupportedOperationException mit der entsprechenden Meldung aus, die angibt, dass backupCallback false zurückgegeben hat. Außerdem wird die Sicherung als nicht erfolgreich markiert. |
CompletableFuture<?> |
backupAsync(BiFunction<BackupInfo, CancellationToken, CompletableFuture<Boolean>> backupCallback)
Führt eine vollständige Sicherung des gesamten zuverlässigen Zustands aus, der von diesem ReliableStateManager verwaltet wird.
Bemerkungen: Eine VOLLSTÄNDIGE Sicherung wird mit einem Timeout von einer Stunde ausgeführt. Vom BackupCallback zurückgegebener Boolescher Wert gibt an, ob der Dienst den Sicherungsordner erfolgreich an einen externen Speicherort verschieben konnte. Wenn false zurückgegeben wird, löst BackupAsync UnsupportedOperationException mit der entsprechenden Meldung aus, die angibt, dass backupCallback false zurückgegeben hat. Außerdem wird die Sicherung als nicht erfolgreich markiert. |
CompletableFuture<?> |
changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken)
Benachrichtigen Sie das Zustandsanbieterreplikat, dass sich seine Rolle ändert, z. B. in "Primär" oder "Sekundär". |
CompletableFuture<?> |
closeAsync(CancellationToken cancellationToken)
Schließen Sie das Zustandsanbieterreplikat ordnungsgemäß.
Bemerkungen:Dies tritt in der Regel auf, wenn der Code des Replikats aktualisiert wird, das Replikat aufgrund eines Lastenausgleichs verschoben wird oder ein vorübergehender Fehler erkannt wird. |
CompletableFuture<Boolean> |
containsStateAsync(ActorId actorId, String stateName, CancellationToken cancellationToken)
Überprüft, ob der Akteurstatusanbieter einen Akteurstatus mit dem angegebenen Statusnamen enthält. |
CompletableFuture<?> |
deleteReminderAsync(ActorId actorId, String reminderName, CancellationToken cancellationToken)
Löscht die angegebene Actor-Erinnerung, sofern vorhanden. |
CompletableFuture<?> |
deleteRemindersAsync(Map<ActorId, Collection<String>> reminderNames, CancellationToken cancellationToken)
Löscht den angegebenen Erinnerungssatz. |
CompletableFuture<List<String>> |
enumerateStateNamesAsync(ActorId actorId, CancellationToken cancellationToken)
Erstellt eine Aufzählung aller Zustandsnamen, die dem angegebenen Akteur zugeordnet sind.
Bemerkungen:Der vom Akteurstatusanbieter zurückgegebene Enumerator kann sicher gleichzeitig mit Lese- und Schreibvorgängen an den Zustandsanbieter verwendet werden. Sie stellt eine Momentaufnahme konsistente Ansicht des Zustandsanbieters dar. |
CompletableFuture<Paged |
getActorsAsync(int numItemsToReturn, ContinuationToken continuationToken, CancellationToken cancellationToken)
Ruft ActorIds vom Zustandsanbieter ab.
Bemerkungen: Das |
void |
initialize(ActorTypeInformation actorTypeInformation)
Initialisiert den Akteurzustandsanbieter mit Typinformationen des zugeordneten Akteurtyps. |
void |
initialize(StatefulServiceInitializationParameters initializationParameters)
Initialisieren Sie das Zustandsanbieterreplikat mithilfe der Dienstinitialisierungsinformationen.
Bemerkungen:Während der Initialisierung sollte keine komplexe Verarbeitung durchgeführt werden. In OpenAsync sollte eine teure oder lang andauernde Initialisierung durchgeführt werden. |
CompletableFuture<Actor |
loadRemindersAsync(CancellationToken cancellationToken)
Lädt alle Erinnerungen, die im Akteurzustandsanbieter enthalten sind. |
<T> CompletableFuture<T> |
loadStateAsync(ActorId actorId, String stateName, CancellationToken cancellationToken)
Lädt den Akteurstatus, der dem angegebenen Statusnamen zugeordnet ist. |
CompletableFuture<Replicator> |
openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken)
Öffnen Sie das Zustandsanbieterreplikat zur Verwendung.
Bemerkungen:Initialisierungstasks für erweiterte Zustandsanbieter können zu diesem Zeitpunkt gestartet werden. |
CompletableFuture<?> |
reminderCallbackCompletedAsync(ActorId actorId, ActorReminder reminder, CancellationToken cancellationToken)
Wird aufgerufen, wenn eine Erinnerung ausgelöst wird und die Ausführung des Rückrufs receiveReminderAsync(String reminderName, byte[] context, Duration timeSpan, Duration period) erfolgreich abgeschlossen wird |
CompletableFuture<?> |
removeActorAsync(ActorId actorId, CancellationToken cancellationToken)
Entfernt alle vorhandenen Zustände und Erinnerungen, die dem angegebenen Akteur atomar zugeordnet sind. |
CompletableFuture<?> |
restoreAsync(String backupFolderPath)
Stellen Sie eine sicherung wieder her.
Bemerkungen:Es wird eine sichere Wiederherstellung durchgeführt, d. h. die Wiederherstellung wird nur abgeschlossen, wenn die wiederherzustellenden Daten dem Status des aktuellen Replikats voraus sind. |
CompletableFuture<?> |
restoreAsync(String backupFolderPath, RestorePolicy restorePolicy, Duration timeout, CancellationToken cancellationToken)
Wiederherstellen einer sicherung |
CompletableFuture<?> |
saveReminderAsync(ActorId actorId, ActorReminder reminder, CancellationToken cancellationToken)
Speichert die angegebene Akteurerinnerung. Wenn eine Akteurerinnerung mit dem angegebenen Namen nicht vorhanden ist, wird die Akteurerinnerung hinzugefügt, andernfalls wird eine vorhandene Akteurerinnerung mit demselben Namen aktualisiert. |
CompletableFuture<?> |
saveStateAsync(ActorId actorId, List<ActorStateChange> stateChanges, CancellationToken cancellationToken)
Speichert den angegebenen Satz von Akteurzustandsänderungen atomar.
Bemerkungen: Die Auflistung der Zustandsänderungen sollte nur ein Element für einen bestimmten Zustandsnamen enthalten. Der Speichervorgang schlägt fehl, wenn versucht wird, einen bereits vorhandenen Akteurstatus hinzuzufügen oder einen nicht vorhandenen Akteurstatus zu aktualisieren bzw. zu entfernen. |
void |
setOnDataLossCallback(Function<CancellationToken, CompletableFuture<Boolean>> onDataLossAsync)
Funktion, die bei vermuteten Datenverlusten aufgerufen wird |
Geerbte Elemente
Details zum Konstruktor
ReliableCollectionsActorStateProvider
public ReliableCollectionsActorStateProvider()
ReliableCollectionsActorStateProvider
public ReliableCollectionsActorStateProvider(ReliableStateManagerConfiguration stateManagerConfig)
Parameter:
ReliableCollectionsActorStateProvider
public ReliableCollectionsActorStateProvider(ReliableStateManagerConfiguration stateManagerConfig, int actorStateMapCount, int reminderMapCount)
Parameter:
Details zur Methode
abort
public void abort()
Beenden Sie das Zustandsanbieterreplikat erzwungen.
Bemerkungen:Dies tritt in der Regel auf, wenn ein dauerhafter Fehler auf dem Knoten erkannt wird oder wenn Service Fabric den Lebenszyklus des Replikats aufgrund interner Fehler nicht zuverlässig verwalten kann.
Überschreibt:
ReliableCollectionsActorStateProvider.abort()actorActivatedAsync
public CompletableFuture actorActivatedAsync(ActorId actorId, CancellationToken cancellationToken)
Diese Methode wird im Rahmen des Aktivierungsprozesses des Akteurs mit der angegebenen ID aufgerufen.
Überschreibt:
ReliableCollectionsActorStateProvider.actorActivatedAsync(ActorId actorId, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
backupAsync
public CompletableFuture backupAsync(BackupOption option, Duration timeout, CancellationToken cancellationToken, BiFunction
Führt eine vollständige Sicherung des gesamten zuverlässigen Zustands aus, der von diesem ReliableStateManager verwaltet wird.
Bemerkungen: Eine VOLLSTÄNDIGE Sicherung wird mit einem Timeout von einer Stunde ausgeführt. Vom BackupCallback zurückgegebener Boolescher Wert gibt an, ob der Dienst den Sicherungsordner erfolgreich an einen externen Speicherort verschieben konnte. Wenn false zurückgegeben wird, löst BackupAsync UnsupportedOperationException mit der entsprechenden Meldung aus, die angibt, dass backupCallback false zurückgegeben hat. Außerdem wird die Sicherung als nicht erfolgreich markiert.
Überschreibt:
ReliableCollectionsActorStateProvider.backupAsync(BackupOption option, Duration timeout, CancellationToken cancellationToken, BiFunction<BackupInfo, CancellationToken, CompletableFuture<Boolean>> backupCallback)Parameter:
Gibt zurück:
backupAsync
public CompletableFuture backupAsync(BiFunction
Führt eine vollständige Sicherung des gesamten zuverlässigen Zustands aus, der von diesem ReliableStateManager verwaltet wird.
Bemerkungen: Eine VOLLSTÄNDIGE Sicherung wird mit einem Timeout von einer Stunde ausgeführt. Vom BackupCallback zurückgegebener Boolescher Wert gibt an, ob der Dienst den Sicherungsordner erfolgreich an einen externen Speicherort verschieben konnte. Wenn false zurückgegeben wird, löst BackupAsync UnsupportedOperationException mit der entsprechenden Meldung aus, die angibt, dass backupCallback false zurückgegeben hat. Außerdem wird die Sicherung als nicht erfolgreich markiert.
Überschreibt:
ReliableCollectionsActorStateProvider.backupAsync(BiFunction<BackupInfo, CancellationToken, CompletableFuture<Boolean>> backupCallback)Parameter:
Gibt zurück:
changeRoleAsync
public CompletableFuture changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken)
Benachrichtigen Sie das Zustandsanbieterreplikat, dass sich seine Rolle ändert, z. B. in "Primär" oder "Sekundär".
Überschreibt:
ReliableCollectionsActorStateProvider.changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
closeAsync
public CompletableFuture closeAsync(CancellationToken cancellationToken)
Schließen Sie das Zustandsanbieterreplikat ordnungsgemäß.
Bemerkungen:Dies tritt in der Regel auf, wenn der Code des Replikats aktualisiert wird, das Replikat aufgrund eines Lastenausgleichs verschoben wird oder ein vorübergehender Fehler erkannt wird.
Überschreibt:
ReliableCollectionsActorStateProvider.closeAsync(CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
containsStateAsync
public CompletableFuture
Überprüft, ob der Akteurstatusanbieter einen Akteurstatus mit dem angegebenen Statusnamen enthält.
Überschreibt:
ReliableCollectionsActorStateProvider.containsStateAsync(ActorId actorId, String stateName, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
deleteReminderAsync
public CompletableFuture deleteReminderAsync(ActorId actorId, String reminderName, CancellationToken cancellationToken)
Löscht die angegebene Actor-Erinnerung, sofern vorhanden.
Überschreibt:
ReliableCollectionsActorStateProvider.deleteReminderAsync(ActorId actorId, String reminderName, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
deleteRemindersAsync
public CompletableFuture deleteRemindersAsync(Map
Löscht den angegebenen Erinnerungssatz.
Überschreibt:
ReliableCollectionsActorStateProvider.deleteRemindersAsync(Map<ActorId, Collection<String>> reminderNames, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
enumerateStateNamesAsync
public CompletableFuture> enumerateStateNamesAsync(ActorId actorId, CancellationToken cancellationToken)
Erstellt eine Aufzählung aller Zustandsnamen, die dem angegebenen Akteur zugeordnet sind.
Bemerkungen:Der vom Akteurstatusanbieter zurückgegebene Enumerator kann sicher gleichzeitig mit Lese- und Schreibvorgängen an den Zustandsanbieter verwendet werden. Sie stellt eine Momentaufnahme konsistente Ansicht des Zustandsanbieters dar.
Überschreibt:
ReliableCollectionsActorStateProvider.enumerateStateNamesAsync(ActorId actorId, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
getActorsAsync
public CompletableFuture
Ruft ActorIds vom Zustandsanbieter ab.
Bemerkungen: Das
Überschreibt:
ReliableCollectionsActorStateProvider.getActorsAsync(int numItemsToReturn, ContinuationToken continuationToken, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
initialize
public void initialize(ActorTypeInformation actorTypeInformation)
Initialisiert den Akteurzustandsanbieter mit Typinformationen des zugeordneten Akteurtyps.
Überschreibt:
ReliableCollectionsActorStateProvider.initialize(ActorTypeInformation actorTypeInformation)Parameter:
initialize
public void initialize(StatefulServiceInitializationParameters initializationParameters)
Initialisieren Sie das Zustandsanbieterreplikat mithilfe der Dienstinitialisierungsinformationen.
Bemerkungen:Während der Initialisierung sollte keine komplexe Verarbeitung durchgeführt werden. In OpenAsync sollte eine teure oder lang andauernde Initialisierung durchgeführt werden.
Überschreibt:
ReliableCollectionsActorStateProvider.initialize(StatefulServiceInitializationParameters initializationParameters)Parameter:
loadRemindersAsync
public CompletableFuture
Lädt alle Erinnerungen, die im Akteurzustandsanbieter enthalten sind.
Überschreibt:
ReliableCollectionsActorStateProvider.loadRemindersAsync(CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
loadStateAsync
public
Lädt den Akteurstatus, der dem angegebenen Statusnamen zugeordnet ist.
Überschreibt:
ReliableCollectionsActorStateProvider.loadStateAsync(ActorId actorId, String stateName, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
openAsync
public CompletableFuture
Öffnen Sie das Zustandsanbieterreplikat zur Verwendung.
Bemerkungen:Initialisierungstasks für erweiterte Zustandsanbieter können zu diesem Zeitpunkt gestartet werden.
Überschreibt:
ReliableCollectionsActorStateProvider.openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
reminderCallbackCompletedAsync
public CompletableFuture reminderCallbackCompletedAsync(ActorId actorId, ActorReminder reminder, CancellationToken cancellationToken)
Wird aufgerufen, wenn eine Erinnerung ausgelöst wird und die Ausführung des Rückrufs receiveReminderAsync(String reminderName, byte[] context, Duration timeSpan, Duration period) erfolgreich abgeschlossen wird
Überschreibt:
ReliableCollectionsActorStateProvider.reminderCallbackCompletedAsync(ActorId actorId, ActorReminder reminder, CancellationToken cancellationToken)Parameter:
Gibt zurück:
removeActorAsync
public CompletableFuture removeActorAsync(ActorId actorId, CancellationToken cancellationToken)
Entfernt alle vorhandenen Zustände und Erinnerungen, die dem angegebenen Akteur atomar zugeordnet sind.
Überschreibt:
ReliableCollectionsActorStateProvider.removeActorAsync(ActorId actorId, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
restoreAsync
public CompletableFuture restoreAsync(String backupFolderPath)
Stellen Sie eine sicherung wieder her.
Bemerkungen:Es wird eine sichere Wiederherstellung durchgeführt, d. h. die Wiederherstellung wird nur abgeschlossen, wenn die wiederherzustellenden Daten dem Status des aktuellen Replikats voraus sind.
Überschreibt:
ReliableCollectionsActorStateProvider.restoreAsync(String backupFolderPath)Parameter:
Gibt zurück:
restoreAsync
public CompletableFuture restoreAsync(String backupFolderPath, RestorePolicy restorePolicy, Duration timeout, CancellationToken cancellationToken)
Wiederherstellen einer sicherung
Überschreibt:
ReliableCollectionsActorStateProvider.restoreAsync(String backupFolderPath, RestorePolicy restorePolicy, Duration timeout, CancellationToken cancellationToken)Parameter:
Gibt zurück:
saveReminderAsync
public CompletableFuture saveReminderAsync(ActorId actorId, ActorReminder reminder, CancellationToken cancellationToken)
Speichert die angegebene Akteurerinnerung. Wenn eine Akteurerinnerung mit dem angegebenen Namen nicht vorhanden ist, wird die Akteurerinnerung hinzugefügt, andernfalls wird eine vorhandene Akteurerinnerung mit demselben Namen aktualisiert.
Überschreibt:
ReliableCollectionsActorStateProvider.saveReminderAsync(ActorId actorId, ActorReminder reminder, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
saveStateAsync
public CompletableFuture saveStateAsync(ActorId actorId, List
Speichert den angegebenen Satz von Akteurzustandsänderungen atomar.
Bemerkungen: Die Auflistung der Zustandsänderungen sollte nur ein Element für einen bestimmten Zustandsnamen enthalten. Der Speichervorgang schlägt fehl, wenn versucht wird, einen bereits vorhandenen Akteurstatus hinzuzufügen oder einen nicht vorhandenen Akteurstatus zu aktualisieren bzw. zu entfernen.
Überschreibt:
ReliableCollectionsActorStateProvider.saveStateAsync(ActorId actorId, List<ActorStateChange> stateChanges, CancellationToken cancellationToken)Parameter:
CancellationToken-Objekt, um den Abbruch status des Vorgangs anzugeben.
Gibt zurück:
setOnDataLossCallback
public void setOnDataLossCallback(Function
Funktion, die bei vermuteten Datenverlusten aufgerufen wird
Überschreibt:
ReliableCollectionsActorStateProvider.setOnDataLossCallback(Function<CancellationToken, CompletableFuture<Boolean>> onDataLossAsync)Parameter:
Gilt für:
Azure SDK for Java