インターフェース AsyncResultSetExtractor<T>
- すべての既知の実装クラス:
AsyncCqlTemplate.AsyncRowCallbackHandlerResultSetExtractor
,AsyncRowMapperResultSetExtractor
- 関数インターフェース:
- これは関数インターフェースであるため、ラムダ式またはメソッド参照の割り当てターゲットとして使用できます。
@DeprecatedSE(since="4.0",
forRemoval=true)
@FunctionalInterfaceSE
public interface AsyncResultSetExtractor<T>
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
AsyncCqlTemplate
のクエリメソッドで使用されるコールバックインターフェース。このインターフェースの実装は、AsyncResultSet
から結果を抽出する実際の作業を実行しますが、例外処理について心配する必要はありません。DriverException
は、呼び出し元の AsyncCqlTemplate
によってキャッチされ、処理されます。 このインターフェースは、主に CQL フレームワーク自体内で使用されます。RowMapper
は通常、AsyncResultSet
処理のよりシンプルな選択肢であり、AsyncResultSet
全体に対して 1 つの結果オブジェクトをマッピングするのではなく、行ごとに 1 つの結果オブジェクトをマッピングします。
メモ: RowCallbackHandler
とは対照的に、AsyncResultSetExtractor
オブジェクトは通常ステートレスであり、ステートフルリソースにアクセスしたり、オブジェクト内に結果の状態を保持したりしない限り、再利用可能です。
- 導入:
- 4.0
- 作成者:
- Mark Paluch
- 関連事項:
メソッドのサマリー
修飾子と型メソッド説明extractData
(com.datastax.oss.driver.api.core.cql.AsyncResultSet resultSet) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。実装では、AsyncResultSet
全体を処理するためにこのメソッドを実装する必要があります。
メソッドの詳細
extractData
@Nullable ListenableFuture<T> extractData(com.datastax.oss.driver.api.core.cql.AsyncResultSet resultSet) throws com.datastax.oss.driver.api.core.DriverException, DataAccessException 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。実装では、AsyncResultSet
全体を処理するためにこのメソッドを実装する必要があります。- パラメーター:
resultSet
- データを抽出するAsyncResultSet
。- 戻り値:
- 任意の結果オブジェクト、または結果オブジェクトがない場合は null (後者の場合、抽出子は通常ステートフルになります)。
- 例外:
com.datastax.oss.driver.api.core.DriverException
- 列の値を取得したりナビゲートしたりする際にDriverException
に遭遇した場合 (つまり、DriverException
をキャッチする必要はありません。)DataAccessException
- カスタム例外の場合
CompletableFuture
SE ベースのバリアントを使用します。