replace()
メソッドはデータベース内の既存の key/value
ペアを更新します。指定されたキーが存在しない場合、操作は失敗します。
| API Call | client.replace(key, expiry, value) | ||
| Asynchronous | yes | ||
| Description | Update an existing key with a new value | ||
| Returns | Future<Boolean> (
Asynchronous request value, as Boolean
) | ||
| Arguments | |||
String key | Document ID used to identify the value | ||
int expiry | Expiry time for key. Values larger than 30*24*60*60 seconds (30 days) are interpreted as absolute times (from the epoch). | ||
Object value | Value to be stored | ||
replace()
メソッドの一つ目の形式は、既存の値を更新する際に明示的な有効期限の設定ができます。例えばsamplekeyを更新します：
OperationFuture<Boolean> replaceOp = client.replace("samplekey","updatedvalue",0);
戻り値は Boolean を保持する
OperationFuture
インスタンスとなります。
| API Call | client.replace(key, expiry, value, transcoder) | ||
| Asynchronous | yes | ||
| Description | Update an existing key with a new value | ||
| Returns | Future<Boolean> (
Asynchronous request value, as Boolean
) | ||
| Arguments | |||
String key | Document ID used to identify the value | ||
int expiry | Expiry time for key. Values larger than 30*24*60*60 seconds (30 days) are interpreted as absolute times (from the epoch). | ||
Object value | Value to be stored | ||
Transcoder<T> transcoder | Transcoder class to be used to serialize value | ||
replace()
メソッドの二つ目の形式は一つ目と同様ですが、デフォルトトランスコーダに代わる、カスタムトランスコーダをサポートしています。