10.6.10. Hot Rod ReplaceIfUnmodified 操作
ReplaceIfUnmodified
操作要求形式には、以下のものが含まれます。
フィールド | データタイプ | 詳細 |
---|---|---|
Header | - | - |
Key Length | vInt | キーの長さを含みます。 |
Key | バイトアレイ | キーの値を含みます。 |
Lifespan | vInt | エントリーが期限切れになるまでの秒数を含みます。秒数が 30 日を超える場合、その値はエントリーライフスパンの UNIX 時間 (つまり、日付 1/1/1970 以降の秒数) として処理されます。値が 0 に設定された場合、エントリーは期限切れになりません。 |
Max Idle | vInt | キャッシュからエビクトされるまでエントリーがアイドル状態のままになることが許可される秒数を含みます。このエントリーが 0 に設定された場合、エントリーは無期限でアイドル状態のままになることが許可され、max idle 値のため、エビクトされません。 |
Entry Version | 8 バイト | GetWithVersion 操作により返された値を使用します。 |
Value Length | vInt | 値の長さを含みます。 |
Value | バイトアレイ | 要求された値を含みます。 |
以下は、この操作から返された応答値です。
応答ステータス | 詳細 |
---|---|
0x00 | エントリーが置換または削除された場合に返されたステータス。 |
0x01 | キーが変更されたため、エントリーの置換または削除が失敗した場合に、ステータスを返します。 |
0x02 | キーが存在しない場合に、ステータスを返します。 |
この操作では空の応答がデフォルト応答になります。ただし、
ForceReturnPreviousValue
が渡された場合は、以前の値とキーが返されます。以前のキーと値が存在しない場合は、値の長さに値 0
が含まれます。