touch()
メソッドは指定キーの有効期限を更新します。これは関連する値を更新せずに、アイテムが有効期限切れになるのを防ぎたい場合に利用できます。例えば、セッションデータベースにおいて、各ユーザがWebページにアクセスした際に、明示的なセッション情報の更新を必要とせずに、データベース内のセッションを有効に保持したい場合があるかもしれません。
API Call | client.touch(key, expiry) | ||
Asynchronous | yes | ||
Description | Update the expiry time of an item | ||
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). |
touch()
メソッドの一つ目の形式は単純にキーと更新する有効期限を指定します。例えば、セッションの有効期限を5分に更新します:
OperationFuture<Boolean> touchOp = client.touch("sessionid",300);