べき等属性
[べき等] 属性は、操作が状態情報を変更しないことを指定し、実行されるたびに同じ結果を返します。 ルーチンを複数回実行すると、1 回実行した場合と同じ効果があります。
[
interface-attribute-list
]
interface interface-name
{
[idempotent [, attribute-list]] returntype function-name(params)
}
パラメーター
-
interface-attribute-list
-
インターフェイス全体に適用される 0 個以上の IDL 属性のリストを指定します。 2 つ以上のインターフェイス属性が存在する場合は、コンマで区切る必要があります。
-
interface-name
-
インターフェイスの名前を指定します。
-
attribute-list
-
関数に適用する追加の属性を指定します。 複数の属性をコンマで区切ります。
-
returntype
-
関数の戻り値の型を指定します。
-
function-name
-
[べき等] 属性を適用する関数の名前を指定します。
-
params
-
関数パラメーターの一覧。
解説
RPC では、2 種類のリモート呼び出しセマンティクスがサポートされています。[べき等] 属性を持つ操作の呼び出しと、[べき等] 属性 (べき等でない操作) を使用しない操作 (べき等操作) の呼び出しです。 べき等操作は、無効な効果なしで複数回実行できます。 逆に、べき等でない操作は、毎回異なる結果を返すか、何らかの状態を変更するため、複数回実行することはできません。
呼び出しが完了しない場合にプロシージャが自動的に再実行されるようにするには、[ べき等] 属性を使用します。 [べき等]、[ブロードキャスト]、または [多分] 属性が存在しない場合、プロシージャは既定で非べき等セマンティクスを使用します。 この場合、操作は 1 回だけ実行されます。
関連項目