非同期の asyncGet()
メソッドは指定のキーに対する値を、応答を待たずに取得することが出来ます。
| API Call | client.asyncGet(key) | ||
| Asynchronous | yes | ||
| Description | Get one or more key values | ||
| Returns | Future<Object> (
Asynchronous request value, as Object
) | ||
| Arguments | |||
String key | Document ID used to identify the value | ||
| Exceptions | |||
TimeoutException | Value could not be retrieved | ||
一つ目の asyncGet()
メソッドの形式では、指定のキーに対する値を後で取得できるように、Future
オブジェクトを返却します。以下は String
の値を取得する例です：
GetFuture<Object> getOp = client.asyncGet("samplekey"); String username; try { username = (String) getOp.get(5, TimeUnit.SECONDS); } catch(Exception e) { getOp.cancel(false); }
| API Call | client.asyncGet(key, transcoder) | ||
| Asynchronous | yes | ||
| Description | Get one or more key values | ||
| Returns | Future<T> (
Asynchronous request value, as Transcoded Object
) | ||
| Arguments | |||
String key | Document ID used to identify the value | ||
Transcoder<T> transcoder | Transcoder class to be used to serialize value | ||
二つ目の形式は一つ目と同じですが、格納されている値に対してカスタムトランスコーダを利用可能となっています。