ActorStateManager インターフェイス

パッケージ:

microsoft.servicefabric.actors.runtime

public interface ActorStateManager

ステート マネージャーが実装するインターフェイスを Actor 表します。

メソッドの概要

修飾子と型	メソッドと説明
<T> CompletableFuture<T>	addOrUpdateStateAsync(String stateName, T addValue, BiFunction<String, T, T> updateValueFactory) 指定された状態名を持つアクター状態を追加します (まだ存在しない場合)。指定された状態名と値が存在しない場合は更新されます。
<T> CompletableFuture<T>	addOrUpdateStateAsync(String stateName, T addValue, BiFunction<String, T, T> updateValueFactory, CancellationToken cancellationToken) 指定された状態名を持つアクター状態を追加します (まだ存在しない場合)。指定された状態名と値が存在しない場合は更新されます。
<T> CompletableFuture<?>	addStateAsync(String stateName, T value) 指定された状態名を持つアクター状態を追加します。
<T> CompletableFuture<?>	addStateAsync(String stateName, T value, CancellationToken cancellationToken) 指定された状態名を持つアクター状態を追加します。
CompletableFuture<?>	clearCacheAsync() キャッシュされたすべてのアクター状態と、最後の状態の保存操作以降に ActorStateManager 実行されたすべての操作をクリアします。 発言： 最後の保存操作以降に ActorStateManager 実行されたすべての操作は、キャッシュのクリア時にクリアされ、次の保存操作には含まれません。
CompletableFuture<?>	clearCacheAsync(CancellationToken cancellationToken) キャッシュされたすべてのアクター状態と、最後の状態の保存操作以降に ActorStateManager 実行されたすべての操作をクリアします。 発言： 最後の保存操作以降に ActorStateManager 実行されたすべての操作は、キャッシュのクリア時にクリアされ、次の保存操作には含まれません。
CompletableFuture<Boolean>	containsStateAsync(String stateName) 指定した名前のアクター状態が存在するかどうかを確認します。
CompletableFuture<Boolean>	containsStateAsync(String stateName, CancellationToken cancellationToken) 指定した名前のアクター状態が存在するかどうかを確認します。
<T> CompletableFuture<T>	getOrAddStateAsync(String stateName, T value) 指定された状態名を持つアクターの状態を取得します (存在する場合)。状態が存在する場合は、指定した状態名を持つ状態を追加します。
<T> CompletableFuture<T>	getOrAddStateAsync(String stateName, T value, CancellationToken cancellationToken) 指定された状態名を持つアクターの状態を取得します (存在する場合)。状態が存在する場合は、指定した状態名を持つ状態を追加します。
<T> CompletableFuture<T>	getStateAsync(String stateName) 指定した状態名を持つアクターの状態を取得します。
<T> CompletableFuture<T>	getStateAsync(String stateName, CancellationToken cancellationToken) 指定した状態名を持つアクターの状態を取得します。
CompletableFuture<List<String>>	getStateNamesAsync() 現在のアクターのすべてのアクター状態名のリストを作成します。
CompletableFuture<List<String>>	getStateNamesAsync(CancellationToken cancellationToken) 現在のアクターのすべてのアクター状態名のリストを作成します。
CompletableFuture<?>	removeStateAsync(String stateName) 指定した状態名を持つアクター状態を、指定された値に削除します。
CompletableFuture<?>	removeStateAsync(String stateName, CancellationToken cancellationToken) 指定した状態名を持つアクター状態を、指定された値に削除します。
CompletableFuture<?>	saveStateAsync() アクター ランタイムまたはユーザーによる最後の呼び出し saveStateAsync(CancellationToken cancellationToken) 以降に明示的に行われたすべてのキャッシュされた状態変更 (追加/更新/削除) を保存します。
CompletableFuture<?>	saveStateAsync(CancellationToken cancellationToken) アクター ランタイムまたはユーザーによる最後の呼び出し saveStateAsync(CancellationToken cancellationToken) 以降に明示的に行われたすべてのキャッシュされた状態変更 (追加/更新/削除) を保存します。
<T> CompletableFuture<?>	setStateAsync(String stateName, T value) 指定した状態名を持つアクター状態を削除します。 指定した名前のアクター状態が存在しない場合は、その状態が追加されます。
<T> CompletableFuture<?>	setStateAsync(String stateName, T value, CancellationToken cancellationToken) 指定した状態名を持つアクター状態を削除します。 指定した名前のアクター状態が存在しない場合は、その状態が追加されます。
<T> CompletableFuture<Boolean>	tryAddStateAsync(String stateName, T value) 指定された状態名を持つアクター状態の追加を試みます。
<T> CompletableFuture<Boolean>	tryAddStateAsync(String stateName, T value, CancellationToken cancellationToken) 指定された状態名を持つアクター状態の追加を試みます。
<T> CompletableFuture<ConditionalValue<T>>	tryGetStateAsync(String stateName) 指定した状態名を持つアクター状態の取得を試みます。
<T> CompletableFuture<ConditionalValue<T>>	tryGetStateAsync(String stateName, CancellationToken cancellationToken) 指定した状態名を持つアクター状態の取得を試みます。
CompletableFuture<Boolean>	tryRemoveStateAsync(String stateName) 指定した状態名を持つアクター状態の削除を試みます。
CompletableFuture<Boolean>	tryRemoveStateAsync(String stateName, CancellationToken cancellationToken) 指定した状態名を持つアクター状態の削除を試みます。

メソッドの詳細

addOrUpdateStateAsync

public CompletableFuture addOrUpdateStateAsync(String stateName, T addValue, BiFunction updateValueFactory)

指定された状態名を持つアクター状態を追加します (まだ存在しない場合)。指定された状態名と値が存在しない場合は更新されます。

パラメーター:

stateName - 追加または取得するアクター状態の名前。

addValue - 存在しない場合に追加するアクター状態の値。

updateValueFactory - アクター状態が存在する場合に更新する値を生成するファクトリ関数。

戻り値:

非同期の追加/更新操作を表すタスク。 T パラメーターの値には、追加または更新されたアクター状態の値が含まれます。

addOrUpdateStateAsync

public CompletableFuture addOrUpdateStateAsync(String stateName, T addValue, BiFunction updateValueFactory, CancellationToken cancellationToken)

指定された状態名を持つアクター状態を追加します (まだ存在しない場合)。指定された状態名と値が存在しない場合は更新されます。

パラメーター:

stateName - 追加または取得するアクター状態の名前。

addValue - 存在しない場合に追加するアクター状態の値。

updateValueFactory - アクター状態が存在する場合に更新する値を生成するファクトリ関数。

cancellationToken -

CancellationToken オブジェクトを使用して、操作のキャンセル状態を示します。

戻り値:

非同期の追加/更新操作を表すタスク。 T パラメーターの値には、追加または更新されたアクター状態の値が含まれます。

addStateAsync

public CompletableFuture addStateAsync(String stateName, T value)

指定された状態名を持つアクター状態を追加します。

パラメーター:

stateName - 追加するアクター状態の名前。

value - 追加するアクター状態の値。

戻り値:

非同期の追加操作を表すタスク。

addStateAsync

public CompletableFuture addStateAsync(String stateName, T value, CancellationToken cancellationToken)

指定された状態名を持つアクター状態を追加します。

パラメーター:

stateName - 追加するアクター状態の名前。

value - 追加するアクター状態の値。

cancellationToken -

CancellationToken オブジェクトを使用して、操作のキャンセル状態を示します。

戻り値:

非同期の追加操作を表すタスク。

clearCacheAsync

public CompletableFuture clearCacheAsync()

キャッシュされたすべてのアクター状態と、最後の状態の保存操作以降に ActorStateManager 実行されたすべての操作をクリアします。

発言： 最後の保存操作以降に ActorStateManager 実行されたすべての操作は、キャッシュのクリア時にクリアされ、次の保存操作には含まれません。

戻り値:

非同期のクリア キャッシュ操作を表すタスク。

clearCacheAsync

public CompletableFuture clearCacheAsync(CancellationToken cancellationToken)

キャッシュされたすべてのアクター状態と、最後の状態の保存操作以降に ActorStateManager 実行されたすべての操作をクリアします。

発言： 最後の保存操作以降に ActorStateManager 実行されたすべての操作は、キャッシュのクリア時にクリアされ、次の保存操作には含まれません。

パラメーター:

cancellationToken -

CancellationToken オブジェクトを使用して、操作のキャンセル状態を示します。

戻り値:

非同期のクリア キャッシュ操作を表すタスク。

containsStateAsync

public CompletableFuture containsStateAsync(String stateName)

指定した名前のアクター状態が存在するかどうかを確認します。

パラメーター:

stateName - アクター状態の名前。

戻り値:

非同期チェック操作を表すタスク。 指定した名前の状態が存在する場合、T パラメーターの値は true です。それ以外の場合は false です。

containsStateAsync

public CompletableFuture containsStateAsync(String stateName, CancellationToken cancellationToken)

指定した名前のアクター状態が存在するかどうかを確認します。

パラメーター:

stateName - アクター状態の名前。

cancellationToken -

CancellationToken オブジェクトを使用して、操作のキャンセル状態を示します。

戻り値:

非同期チェック操作を表すタスク。 指定した名前の状態が存在する場合、T パラメーターの値は true です。それ以外の場合は false です。

getOrAddStateAsync

public CompletableFuture getOrAddStateAsync(String stateName, T value)

指定された状態名を持つアクターの状態を取得します (存在する場合)。状態が存在する場合は、指定した状態名を持つ状態を追加します。

パラメーター:

stateName - 追加/更新するアクター状態の名前。

value - /update を追加するアクター状態の値。

戻り値:

非同期の追加または取得操作を表すタスク。 T パラメーターの値には、指定された状態のアクター状態の値が含まれます。

getOrAddStateAsync

public CompletableFuture getOrAddStateAsync(String stateName, T value, CancellationToken cancellationToken)

指定された状態名を持つアクターの状態を取得します (存在する場合)。状態が存在する場合は、指定した状態名を持つ状態を追加します。

パラメーター:

stateName - 追加/更新するアクター状態の名前。

value - /update を追加するアクター状態の値。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の追加または取得操作を表すタスク。 T パラメーターの値には、指定された状態のアクター状態の値が含まれます。

getStateAsync

public CompletableFuture getStateAsync(String stateName)

指定した状態名を持つアクターの状態を取得します。

パラメーター:

stateName - 追加するアクター状態の名前。

戻り値:

非同期の取得操作を表すタスク。 T パラメーターの値には、指定された状態名を持つアクター状態の値が含まれています。

getStateAsync

public CompletableFuture getStateAsync(String stateName, CancellationToken cancellationToken)

指定した状態名を持つアクターの状態を取得します。

パラメーター:

stateName - 追加するアクター状態の名前。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の取得操作を表すタスク。 T パラメーターの値には、指定された状態名を持つアクター状態の値が含まれています。

getStateNamesAsync

public CompletableFuture> getStateNamesAsync()

現在のアクターのすべてのアクター状態名のリストを作成します。

戻り値:

非同期列挙操作を表すタスク。 T パラメーターの値は、すべてのアクター状態名の列挙可能です。

getStateNamesAsync

public CompletableFuture> getStateNamesAsync(CancellationToken cancellationToken)

現在のアクターのすべてのアクター状態名のリストを作成します。

パラメーター:

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期列挙操作を表すタスク。 T パラメーターの値は、すべてのアクター状態名の列挙可能です。

removeStateAsync

public CompletableFuture removeStateAsync(String stateName)

指定した状態名を持つアクター状態を、指定された値に削除します。

パラメーター:

stateName - 削除するアクター状態の名前。

戻り値:

非同期の削除操作を表すタスク。

removeStateAsync

public CompletableFuture removeStateAsync(String stateName, CancellationToken cancellationToken)

指定した状態名を持つアクター状態を、指定された値に削除します。

パラメーター:

stateName - 削除するアクター状態の名前。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の削除操作を表すタスク。

saveStateAsync

public CompletableFuture saveStateAsync()

アクター ランタイムまたはユーザーによる最後の呼び出し saveStateAsync(CancellationToken cancellationToken) 以降に明示的に行われたすべてのキャッシュされた状態変更 (追加/更新/削除) を保存します。

戻り値:

非同期の保存操作を表すタスク。

saveStateAsync

public CompletableFuture saveStateAsync(CancellationToken cancellationToken)

アクター ランタイムまたはユーザーによる最後の呼び出し saveStateAsync(CancellationToken cancellationToken) 以降に明示的に行われたすべてのキャッシュされた状態変更 (追加/更新/削除) を保存します。

パラメーター:

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の保存操作を表すタスク。

setStateAsync

public CompletableFuture setStateAsync(String stateName, T value)

指定した状態名を持つアクター状態を削除します。 指定した名前のアクター状態が存在しない場合は、その状態が追加されます。

パラメーター:

stateName - 設定するアクター状態の名前。

value - 設定するアクター状態の値。

戻り値:

非同期のセット操作を表すタスク。

setStateAsync

public CompletableFuture setStateAsync(String stateName, T value, CancellationToken cancellationToken)

指定した状態名を持つアクター状態を削除します。 指定した名前のアクター状態が存在しない場合は、その状態が追加されます。

パラメーター:

stateName - 設定するアクター状態の名前。

value - 設定するアクター状態の値。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期のセット操作を表すタスク。

tryAddStateAsync

public CompletableFuture tryAddStateAsync(String stateName, T value)

指定された状態名を持つアクター状態の追加を試みます。

パラメーター:

stateName - 追加するアクター状態の名前。

value - 追加するアクター状態の値。

戻り値:

非同期の追加操作を表すタスク。 T パラメーターの値は、状態が正常に追加されたかどうかを示します。

tryAddStateAsync

public CompletableFuture tryAddStateAsync(String stateName, T value, CancellationToken cancellationToken)

指定された状態名を持つアクター状態の追加を試みます。

パラメーター:

stateName - 追加するアクター状態の名前。

value - 追加するアクター状態の値。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の追加操作を表すタスク。 T パラメーターの値は、状態が正常に追加されたかどうかを示します。

tryGetStateAsync

public CompletableFuture> tryGetStateAsync(String stateName)

指定した状態名を持つアクター状態の取得を試みます。

パラメーター:

stateName - 取得するアクター状態の名前。

戻り値:

非同期の取得操作を表すタスク。 T パラメーターの値には、 ConditionalValue アクター状態が存在するかどうか、およびアクター状態が存在する場合はアクター状態の値を示す 値が含まれます。

tryGetStateAsync

public CompletableFuture> tryGetStateAsync(String stateName, CancellationToken cancellationToken)

指定した状態名を持つアクター状態の取得を試みます。

パラメーター:

stateName - 取得するアクター状態の名前。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の取得操作を表すタスク。 T パラメーターの値には、 ConditionalValue アクター状態が存在するかどうか、およびアクター状態が存在する場合はアクター状態の値を示す 値が含まれます。

tryRemoveStateAsync

public CompletableFuture tryRemoveStateAsync(String stateName)

指定した状態名を持つアクター状態の削除を試みます。

パラメーター:

stateName - 削除するアクター状態の名前。

戻り値:

非同期の削除操作を表すタスク。 T パラメーターの値は、状態が正常に削除されたかどうかを示します。

tryRemoveStateAsync

public CompletableFuture tryRemoveStateAsync(String stateName, CancellationToken cancellationToken)

指定した状態名を持つアクター状態の削除を試みます。

パラメーター:

stateName - 削除するアクター状態の名前。

cancellationToken -

CancellationToken 操作の取り消し状態を示す オブジェクト。

戻り値:

非同期の削除操作を表すタスク。 T パラメーターの値は、状態が正常に削除されたかどうかを示します。