クラス CqlTemplate
- 実装されたすべてのインターフェース:
InitializingBean
,CqlOperations
ResultSet
の反復処理を開始し、RuntimeException
SE 例外をキャッチして、org.springframework.dao
パッケージで定義されている汎用的でより情報量の多い例外階層に変換します。 このクラスを使用するコードでは、コールバックインターフェースを実装するだけで、明確に定義された契約が与えられます。PreparedStatementCreator
コールバックインターフェースは、Connection を指定して準備されたステートメントを作成し、CQL と必要なパラメーターを提供します。ResultSetExtractor
インターフェースは、ResultSet
から値を抽出します。2 つの一般的な代替コールバックインターフェースについては、PreparedStatementBinder
と RowMapper
も参照してください。
CqlSession
参照による直接インスタンス化を介してサービス実装内で使用するか、アプリケーションコンテキストで準備して Bean 参照としてサービスに渡すことができます。注: CqlSession
は、アプリケーションコンテキストで常に Bean として構成する必要があります。最初のケースではサービスに直接渡され、2 番目のケースでは準備されたテンプレートに渡されます。
このクラスは、コールバックインターフェースと PersistenceExceptionTranslator
インターフェースによってパラメーター化できるため、サブクラス化する必要はありません。
このクラスによって実行されるすべての CQL 操作は、ログカテゴリとして "org.springframework.data.cassandra.core.cqlTemplate" を使用してデバッグレベルでログに記録されます。
NOTE: このクラスのインスタンスは、構成後はスレッドセーフです。
- 作成者:
- David Webb, Matthew Adams, Ryan Scheidter, Antoine Toulme, John Blum, Mark Paluch, Mike Barlotta
- 関連事項:
ネストされたクラスのサマリー
ネストされたクラスフィールドサマリー
クラス org.springframework.data.cassandra.core.cql.CassandraAccessor から継承されたフィールド
logger
コンストラクターのサマリー
コンストラクターコンストラクター説明新しい、初期化されていないCqlTemplate
を作成します。CqlTemplate
(com.datastax.oss.driver.api.core.CqlSession session) 指定されたCqlSession
で初期化された新しいCqlTemplate
を作成します。CqlTemplate
(SessionFactory sessionFactory) 指定されたSessionFactory
を使用して新しいCqlTemplate
を構築します。メソッドのサマリー
修飾子と型メソッド説明現在のリングについて説明します。<T> CollectionSE<T>
describeRing
(HostMapper<T> hostMapper) 現在のリングについて説明します。boolean
execute
(com.datastax.oss.driver.api.core.cql.Statement<?> statement) 単一の CQL 実行 (通常は DDL ステートメント、挿入、更新、削除ステートメント) を発行します。boolean
単一の CQL 実行 (通常は DDL ステートメント、挿入、更新、削除ステートメント) を発行します。boolean
準備されたステートメントを介して単一の CQL 操作 (挿入、更新、削除ステートメントなど) を発行し、指定された引数をバインドします。boolean
execute
(StringSE cql, PreparedStatementBinder psb) 指定された CQL を使用して、PreparedStatementBinder
を使用してバインドパラメーターを設定するステートメントを発行します。<T> T
execute
(StringSE cql, PreparedStatementCallback<T> action) CQLPreparedStatement
で動作するコールバックアクションとして実装された CQL データアクセス操作を実行します。boolean
execute
(PreparedStatementCreator preparedStatementCreator) PreparedStatementCreator
を使用して単一の CQL 実行操作 (挿入、更新、削除ステートメントなど) を発行し、CQL および必要なパラメーターを指定します。<T> T
execute
(PreparedStatementCreator preparedStatementCreator, PreparedStatementCallback<T> action) CQLPreparedStatement
で動作するコールバックアクションとして実装された CQL データアクセス操作を実行します。<T> T
execute
(SessionCallback<T> action) CqlSession
で動作するコールバックアクションとして実装された CQL データアクセス操作を実行します。protected PreparedStatementCreator
渡された CQL を使用して、新しい CQL ベースのPreparedStatementCreator
を作成します。newResultSetExtractor
(RowCallbackHandler rowCallbackHandler) 指定されたRowCallbackHandler
を適応させてResultSetExtractor
の新しいインスタンスを構築します。protected <T> RowMapperResultSetExtractor<T>
newResultSetExtractor
(RowMapper<T> rowMapper) 指定されたRowMapper
を適応させてResultSetExtractor
の新しいインスタンスを構築します。protected <T> RowMapperResultSetExtractor<T>
newResultSetExtractor
(RowMapper<T> rowMapper, int rowsExpected) 指定されたRowMapper
を適応させてResultSetExtractor
の新しいインスタンスを構築します。protected <T> ResultSetExtractor<StreamSE<T>>
newStreamExtractor
(RowMapper<T> rowMapper) 指定されたRowMapper
を適応させてResultSetExtractor
の新しいインスタンスを構築します。<T> T
query
(com.datastax.oss.driver.api.core.cql.Statement<?> statement, ResultSetExtractor<T> resultSetExtractor) 静的 CQL を指定してクエリを実行し、ResultSetExtractor
でResultSet
を読み取ります。void
query
(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowCallbackHandler rowCallbackHandler) 静的 CQL を指定してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。<T> ListSE<T>
静的 CQL を指定してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。<T> T
query
(StringSE cql, PreparedStatementBinder psb, ResultSetExtractor<T> resultSetExtractor) 準備されたステートメントを使用してクエリを実行し、ResultSetExtractor
を使用してResultSet
を読み取ります。void
query
(StringSE cql, PreparedStatementBinder psb, RowCallbackHandler rowCallbackHandler) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリに値をバインドする方法を認識しているPreparedStatementBinder
実装を作成し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。<T> ListSE<T>
query
(StringSE cql, PreparedStatementBinder psb, RowMapper<T> rowMapper) 指定された CQL をクエリして、CQL と、値をクエリにバインドする方法を認識するPreparedStatementBinder
実装からプリペアドステートメントを作成し、RowMapper
を介して各行を Java オブジェクトにマッピングします。<T> T
query
(StringSE cql, ResultSetExtractor<T> resultSetExtractor) 静的 CQL を指定してクエリを実行し、ResultSetExtractor
でResultSet
を読み取ります。<T> T
query
(StringSE cql, ResultSetExtractor<T> resultSetExtractor, ObjectSE... args) 指定された CQL をクエリして、CQL からプリペアドステートメントを作成し、クエリにバインドする引数のリストを作成し、ResultSetExtractor
でResultSet
を読み取ります。void
query
(StringSE cql, RowCallbackHandler rowCallbackHandler) 静的 CQL を指定してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。void
query
(StringSE cql, RowCallbackHandler rowCallbackHandler, ObjectSE... args) 指定された CQL をクエリして、CQL からプリペアドステートメントを作成し、クエリにバインドする引数のリストを作成し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。<T> ListSE<T>
静的 CQL を指定してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。<T> ListSE<T>
指定された CQL をクエリして、CQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper
を介して各行を Java オブジェクトにマッピングします。<T> T
query
(PreparedStatementCreator preparedStatementCreator, PreparedStatementBinder psb, ResultSetExtractor<T> resultSetExtractor) 準備されたステートメントと、値をクエリにバインドする方法を認識しているPreparedStatementBinder
実装を使用してクエリを実行し、ResultSetExtractor
でResultSet
を読み取ります。void
query
(PreparedStatementCreator preparedStatementCreator, PreparedStatementBinder psb, RowCallbackHandler rowCallbackHandler) 準備されたステートメントと、値をクエリにバインドする方法を認識するPreparedStatementBinder
実装を使用してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。<T> ListSE<T>
query
(PreparedStatementCreator preparedStatementCreator, PreparedStatementBinder psb, RowMapper<T> rowMapper) 準備されたステートメントと、値をクエリにバインドする方法を認識するPreparedStatementBinder
実装を使用してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。<T> T
query
(PreparedStatementCreator preparedStatementCreator, ResultSetExtractor<T> resultSetExtractor) 準備されたステートメントを使用してクエリを実行し、ResultSetExtractor
を使用してResultSet
を読み取ります。void
query
(PreparedStatementCreator preparedStatementCreator, RowCallbackHandler rowCallbackHandler) 準備済みステートメントを使用してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。<T> ListSE<T>
query
(PreparedStatementCreator preparedStatementCreator, RowMapper<T> rowMapper) 準備済みステートメントを使用してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。queryForList
(com.datastax.oss.driver.api.core.cql.Statement<?> statement) 静的 CQL を指定して、結果List
SE のクエリを実行します。<T> ListSE<T>
queryForList
(com.datastax.oss.driver.api.core.cql.Statement<?> statement, ClassSE<T> elementType) 静的 CQL を指定して、結果List
SE のクエリを実行します。queryForList
(StringSE cql) 静的 CQL を指定して、結果List
SE のクエリを実行します。<T> ListSE<T>
queryForList
(StringSE cql, ClassSE<T> elementType) 静的 CQL を指定して、結果List
SE のクエリを実行します。<T> ListSE<T>
queryForList
(StringSE cql, ClassSE<T> elementType, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果List
SE を期待します。queryForList
(StringSE cql, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果List
SE を期待します。queryForMap
(com.datastax.oss.driver.api.core.cql.Statement<?> statement) 静的 CQL を指定して、結果マップのクエリを実行します。queryForMap
(StringSE cql) 静的 CQL を指定して、結果マップのクエリを実行します。queryForMap
(StringSE cql, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果のマップを期待します。<T> T
queryForObject
(com.datastax.oss.driver.api.core.cql.Statement<?> statement, ClassSE<T> requiredType) 静的 CQL を指定して、結果オブジェクトのクエリを実行します。<T> T
queryForObject
(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowMapper<T> rowMapper) 静的 CQL を指定してクエリを実行し、単一の結果行をRowMapper
経由で Java オブジェクトにマッピングします。<T> T
queryForObject
(StringSE cql, ClassSE<T> requiredType) 静的 CQL を指定して、結果オブジェクトのクエリを実行します。<T> T
queryForObject
(StringSE cql, ClassSE<T> requiredType, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果オブジェクトを期待します。<T> T
queryForObject
(StringSE cql, RowMapper<T> rowMapper) 静的 CQL を指定してクエリを実行し、単一の結果行をRowMapper
経由で Java オブジェクトにマッピングします。<T> T
queryForObject
(StringSE cql, RowMapper<T> rowMapper, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、RowMapper
を介して単一の結果行を Java オブジェクトにマッピングします。com.datastax.oss.driver.api.core.cql.ResultSet
queryForResultSet
(com.datastax.oss.driver.api.core.cql.Statement<?> statement) 静的 CQL を指定して、ResultSet のクエリを実行します。com.datastax.oss.driver.api.core.cql.ResultSet
静的 CQL を指定して、ResultSet のクエリを実行します。com.datastax.oss.driver.api.core.cql.ResultSet
queryForResultSet
(StringSE cql, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を期待します。IterableSE<com.datastax.oss.driver.api.core.cql.Row>
queryForRows
(com.datastax.oss.driver.api.core.cql.Statement<?> statement) 静的 CQL を指定して、行のクエリを実行します。IterableSE<com.datastax.oss.driver.api.core.cql.Row>
queryForRows
(StringSE cql) 静的 CQL を指定して、行のクエリを実行します。IterableSE<com.datastax.oss.driver.api.core.cql.Row>
queryForRows
(StringSE cql, ObjectSE... args) 指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリスト (行を想定) を作成します。<T> StreamSE<T>
queryForStream
(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowMapper<T> rowMapper) <T> StreamSE<T>
queryForStream
(StringSE cql, RowMapper<T> rowMapper, ObjectSE... args) <T> StreamSE<T>
queryForStream
(PreparedStatementCreator preparedStatementCreator, PreparedStatementBinder psb, RowMapper<T> rowMapper) 準備されたステートメントと、値をクエリにバインドする方法を認識しているPreparedStatementBinder
実装を使用してクエリを実行し、各行をRowMapper
を介して Java オブジェクトにマッピングし、反復可能なStream
SE に変換します。<T> StreamSE<T>
queryForStream
(PreparedStatementCreator preparedStatementCreator, RowMapper<T> rowMapper) protected DataAccessException
translateException
(StringSE task, StringSE cql, RuntimeExceptionSE RuntimeException) 指定されたRuntimeException
SE を汎用DataAccessException
に変換します。クラス org.springframework.data.cassandra.core.cql.CassandraAccessor から継承されたメソッド
afterPropertiesSet, applyStatementSettings, getConsistencyLevel, getExceptionTranslator, getExecutionProfileResolver, getFetchSize, getKeyspace, getPageSize, getSerialConsistencyLevel, getSession, getSessionFactory, newColumnMapRowMapper, newPreparedStatementBinder, newSingleColumnRowMapper, newStatement, setConsistencyLevel, setExceptionTranslator, setExecutionProfile, setExecutionProfileResolver, setFetchSize, setKeyspace, setPageSize, setSerialConsistencyLevel, setSession, setSessionFactory, toCql, translate, translateExceptionIfPossible
コンストラクターの詳細
CqlTemplate
public CqlTemplate()新しい、初期化されていないCqlTemplate
を作成します。注: インスタンスを使用する前にSessionFactory
を設定する必要があります。CqlTemplate
public CqlTemplate(com.datastax.oss.driver.api.core.CqlSession session) 指定されたCqlSession
で初期化された新しいCqlTemplate
を作成します。- パラメーター:
session
- アクティブな CassandraCqlSession
。- 例外:
IllegalStateExceptionSE
-CqlSession
が null の場合。
CqlTemplate
指定されたSessionFactory
を使用して新しいCqlTemplate
を構築します。- パラメーター:
sessionFactory
- アクティブな CassandraSessionFactory
は null であってはなりません。- 関連事項:
メソッドの詳細
execute
インターフェースからコピーされた説明:CqlOperations
CqlSession
で動作するコールバックアクションとして実装された CQL データアクセス操作を実行します。これにより、Spring の管理された CQL 環境内で任意のデータアクセス操作を実装できます。つまり、CQLDriverException
を Spring のDataAccessException
階層に変換できます。コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
action
- アクションを指定するコールバックオブジェクト。- 戻り値:
- アクションによって返される結果オブジェクト、または null。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
execute
インターフェースからコピーされた説明:CqlOperations
単一の CQL 実行 (通常は DDL ステートメント、挿入、更新、削除ステートメント) を発行します。- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。- 戻り値:
- ステートメントが適用されたかどうかを示すブール値。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
@Nullable public <T> T query(StringSE cql, ResultSetExtractor<T> resultSetExtractor) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、ResultSetExtractor
でResultSet
を読み取ります。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。resultSetExtractor
- 結果のすべての行を抽出するオブジェクトは null であってはなりません。- 戻り値:
- ResultSetExtractor によって返される任意の結果オブジェクト。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
query
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowCallbackHandler
- 一度に 1 行ずつ結果を抽出するオブジェクトは null であってはなりません。- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
query
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForList
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果List
SE のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForList
メソッドを使用します。結果は、
Map
SE (列名をキーとして使用して各列に 1 つのエントリ) のList
SE (行ごとに 1 つの項目) にマップされます。List
SE の各項目は、このインターフェースの queryForMap() メソッドによって返される形式になります。- 次で指定:
- インターフェース
CqlOperations
のqueryForList
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。- 戻り値:
- 行ごとに
Map
SE を含むList
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForList
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果List
SE のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForList
メソッドを使用します。結果は、指定された要素型に一致する結果オブジェクトの
List
SE (行ごとに 1 つの項目) にマップされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForList
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。elementType
- 結果List
SE の要素の必須型 (たとえば、Integer.class
) は null であってはなりません。- 戻り値:
- 指定された要素型に一致するオブジェクトの
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForMap
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果マップのクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたCqlOperations.queryForMap(String, Object...)
メソッドを使用します。クエリは単一行クエリであることが期待されています。結果行はマップにマップされます(列名をキーとして使用して、各列に 1 つのエントリ)。
- 次で指定:
- インターフェース
CqlOperations
のqueryForMap
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。- 戻り値:
- 結果マップ (列名をキーとして使用し、列ごとに 1 つのエントリ) は null であってはなりません。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForObject
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果オブジェクトのクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたCqlOperations.queryForObject(String, Class, Object...)
メソッドを使用します。このメソッドは、既知の結果を持つ静的 CQL を実行する場合に便利です。クエリは単一行 / 単一列のクエリであることが想定されており、返される結果は対応するオブジェクト型に直接マップされます。
- 次で指定:
- インターフェース
CqlOperations
のqueryForObject
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。requiredType
- 結果オブジェクトが一致すると予想される型は null であってはなりません。- 戻り値:
- 必要な型の結果オブジェクト、または CQL NULL の場合は null。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合、またはその行に正確に 1 列を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForObject
インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、単一の結果行をRowMapper
経由で Java オブジェクトにマッピングします。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたCqlOperations.queryForObject(String, RowMapper, Object...)
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のqueryForObject
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされた単一のオブジェクト。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForResultSet
public com.datastax.oss.driver.api.core.cql.ResultSet queryForResultSet(StringSE cql) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、ResultSet のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForResultSet
メソッドを使用します。結果は
ResultSet
にマッピングされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForResultSet
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。- 戻り値:
ResultSet
表現。- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForRows
public IterableSE<com.datastax.oss.driver.api.core.cql.Row> queryForRows(StringSE cql) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、行のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForResultSet
メソッドを使用します。結果は
Row
にマッピングされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForRows
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。- 戻り値:
- 行表現。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
execute
public boolean execute(com.datastax.oss.driver.api.core.cql.Statement<?> statement) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
単一の CQL 実行 (通常は DDL ステートメント、挿入、更新、削除ステートメント) を発行します。- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。- 戻り値:
- ステートメントが適用されたかどうかを示すブール値。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> T query(com.datastax.oss.driver.api.core.cql.Statement<?> statement, ResultSetExtractor<T> resultSetExtractor) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、ResultSetExtractor
でResultSet
を読み取ります。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。resultSetExtractor
- 結果のすべての行を抽出するオブジェクトは null であってはなりません。- 戻り値:
- ResultSetExtractor によって返される任意の結果オブジェクト。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
query
public void query(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowCallbackHandler rowCallbackHandler) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。rowCallbackHandler
- 一度に 1 行ずつ結果を抽出するオブジェクトは null であってはなりません。- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
query
public <T> ListSE<T> query(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForStream
public <T> StreamSE<T> queryForStream(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、各行をRowMapper
を介して Java オブジェクトにマッピングし、反復可能なStream
SE に変換します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたquery
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のqueryForStream
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
Stream
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForList
public ListSE<MapSE<StringSE,ObjectSE>> queryForList(com.datastax.oss.driver.api.core.cql.Statement<?> statement) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果List
SE のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForList
メソッドを使用します。結果は、
Map
SE (列名をキーとして使用して各列に 1 つのエントリ) のList
SE (行ごとに 1 つの項目) にマップされます。List
SE の各項目は、このインターフェースの queryForMap() メソッドによって返される形式になります。- 次で指定:
- インターフェース
CqlOperations
のqueryForList
- パラメーター:
statement
- 実行する静的 CQLStatement
は空または null であってはなりません。- 戻り値:
- 行ごとに
Map
SE を含むList
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForList
public <T> ListSE<T> queryForList(com.datastax.oss.driver.api.core.cql.Statement<?> statement, ClassSE<T> elementType) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果List
SE のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForList
メソッドを使用します。結果は、指定された要素型に一致する結果オブジェクトの
List
SE (行ごとに 1 つの項目) にマップされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForList
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。elementType
- 結果List
SE の要素の必須型 (たとえば、Integer.class
) は null であってはなりません。- 戻り値:
- 指定された要素型に一致するオブジェクトの
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForMap
public MapSE<StringSE,ObjectSE> queryForMap(com.datastax.oss.driver.api.core.cql.Statement<?> statement) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果マップのクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたCqlOperations.queryForMap(String, Object...)
メソッドを使用します。クエリは単一行クエリであることが期待されています。結果行はマップにマップされます(列名をキーとして使用して、各列に 1 つのエントリ)。
- 次で指定:
- インターフェース
CqlOperations
のqueryForMap
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。- 戻り値:
- 結果マップ (列名をキーとして使用し、列ごとに 1 つのエントリ) は null であってはなりません。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForObject
public <T> T queryForObject(com.datastax.oss.driver.api.core.cql.Statement<?> statement, ClassSE<T> requiredType) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、結果オブジェクトのクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたCqlOperations.queryForObject(String, Class, Object...)
メソッドを使用します。このメソッドは、既知の結果を持つ静的 CQL を実行する場合に便利です。クエリは単一行 / 単一列のクエリであることが想定されており、返される結果は対応するオブジェクト型に直接マップされます。
- 次で指定:
- インターフェース
CqlOperations
のqueryForObject
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。requiredType
- 結果オブジェクトが一致すると予想される型は null であってはなりません。- 戻り値:
- 必要な型の結果オブジェクト、または CQL NULL の場合は null。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合、またはその行に正確に 1 列を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForObject
public <T> T queryForObject(com.datastax.oss.driver.api.core.cql.Statement<?> statement, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定してクエリを実行し、単一の結果行をRowMapper
経由で Java オブジェクトにマッピングします。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたCqlOperations.queryForObject(String, RowMapper, Object...)
メソッドを使用します。- 次で指定:
- インターフェース
CqlOperations
のqueryForObject
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされた単一のオブジェクト。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForResultSet
public com.datastax.oss.driver.api.core.cql.ResultSet queryForResultSet(com.datastax.oss.driver.api.core.cql.Statement<?> statement) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、ResultSet のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForResultSet
メソッドを使用します。結果は
ResultSet
にマッピングされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForResultSet
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。- 戻り値:
ResultSet
表現。- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForRows
public IterableSE<com.datastax.oss.driver.api.core.cql.Row> queryForRows(com.datastax.oss.driver.api.core.cql.Statement<?> statement) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
静的 CQL を指定して、行のクエリを実行します。PreparedStatement
ではなく、CQL ステートメントを使用します。PreparedStatement
を使用して静的クエリを実行する場合は、引数配列として null を指定してオーバーロードされたqueryForResultSet
メソッドを使用します。結果は
Row
にマッピングされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForRows
- パラメーター:
statement
- 静的 CQLStatement
は null にできません。- 戻り値:
- 行表現。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
execute
インターフェースからコピーされた説明:CqlOperations
準備されたステートメントを介して単一の CQL 操作 (挿入、更新、削除ステートメントなど) を発行し、指定された引数をバインドします。- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
- ステートメントが適用されたかどうかを示すブール値。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
execute
public boolean execute(StringSE cql, @Nullable PreparedStatementBinder psb) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL を使用して、PreparedStatementBinder
を使用してバインドパラメーターを設定するステートメントを発行します。このメソッドはPreparedStatement
を作成するため、PreparedStatementCreator
を使用するよりも簡単です。PreparedStatementBinder
ではパラメーターを設定するだけです。- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。- 戻り値:
- ステートメントが適用されたかどうかを示すブール値。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
execute
@Nullable public <T> T execute(StringSE cql, PreparedStatementCallback<T> action) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
CQLPreparedStatement
で動作するコールバックアクションとして実装された CQL データアクセス操作を実行します。これにより、Spring の管理された CQL 環境内で、単一のステートメントに任意のデータアクセス操作を実装できます。つまり、Spring 管理のトランザクションに参加し、CQLDriverException
を Spring のDataAccessException
階層に変換できます。コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。action
- アクションを指定するコールバックオブジェクトは null であってはなりません。- 戻り値:
- アクションによって返された結果オブジェクト、または null
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
execute
public boolean execute(PreparedStatementCreator preparedStatementCreator) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
PreparedStatementCreator
を使用して単一の CQL 実行操作 (挿入、更新、削除ステートメントなど) を発行し、CQL および必要なパラメーターを指定します。- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
preparedStatementCreator
- CQL と必要なパラメーターを提供するオブジェクトは null であってはなりません。- 戻り値:
- ステートメントが適用されたかどうかを示すブール値。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
execute
@Nullable public <T> T execute(PreparedStatementCreator preparedStatementCreator, PreparedStatementCallback<T> action) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
CQLPreparedStatement
で動作するコールバックアクションとして実装された CQL データアクセス操作を実行します。これにより、Spring の管理された CQL 環境内で、単一のPreparedStatement
に任意のデータアクセス操作を実装できます。つまり、Spring 管理のトランザクションに参加し、CQLDriverException
を Spring のDataAccessException
階層に変換できます。コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
- 次で指定:
- インターフェース
CqlOperations
のexecute
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。action
- アクションを指定するコールバックオブジェクトは null であってはなりません。- 戻り値:
- アクションによって返される結果オブジェクト、または null。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> T query(PreparedStatementCreator preparedStatementCreator, ResultSetExtractor<T> resultSetExtractor) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備されたステートメントを使用してクエリを実行し、ResultSetExtractor
を使用してResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。resultSetExtractor
- 結果を抽出するオブジェクトは null であってはなりません。- 戻り値:
ResultSetExtractor
によって返される任意の結果オブジェクト- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public void query(PreparedStatementCreator preparedStatementCreator, RowCallbackHandler rowCallbackHandler) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備済みステートメントを使用してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。rowCallbackHandler
- 一度に 1 行ずつ結果を抽出するオブジェクトは null であってはなりません。- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> ListSE<T> query(PreparedStatementCreator preparedStatementCreator, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備済みステートメントを使用してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。
queryForStream
public <T> StreamSE<T> queryForStream(PreparedStatementCreator preparedStatementCreator, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
- 次で指定:
- インターフェース
CqlOperations
のqueryForStream
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
Stream
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
@Nullable public <T> T query(PreparedStatementCreator preparedStatementCreator, @Nullable PreparedStatementBinder psb, ResultSetExtractor<T> resultSetExtractor) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備されたステートメントと、値をクエリにバインドする方法を認識しているPreparedStatementBinder
実装を使用してクエリを実行し、ResultSetExtractor
でResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。resultSetExtractor
- 結果を抽出するオブジェクトは null であってはなりません。- 戻り値:
ResultSetExtractor
によって返される任意の結果オブジェクト。- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public void query(PreparedStatementCreator preparedStatementCreator, @Nullable PreparedStatementBinder psb, RowCallbackHandler rowCallbackHandler) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備されたステートメントと、値をクエリにバインドする方法を認識するPreparedStatementBinder
実装を使用してクエリを実行し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。rowCallbackHandler
- 一度に 1 行ずつ結果を抽出するオブジェクトは null であってはなりません。- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> ListSE<T> query(PreparedStatementCreator preparedStatementCreator, @Nullable PreparedStatementBinder psb, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備されたステートメントと、値をクエリにバインドする方法を認識するPreparedStatementBinder
実装を使用してクエリを実行し、RowMapper
を介して各行を Java オブジェクトにマッピングします。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。
queryForStream
public <T> StreamSE<T> queryForStream(PreparedStatementCreator preparedStatementCreator, @Nullable PreparedStatementBinder psb, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備されたステートメントと、値をクエリにバインドする方法を認識しているPreparedStatementBinder
実装を使用してクエリを実行し、各行をRowMapper
を介して Java オブジェクトにマッピングし、反復可能なStream
SE に変換します。- 次で指定:
- インターフェース
CqlOperations
のqueryForStream
- パラメーター:
preparedStatementCreator
-CqlSession
を指定してPreparedStatement
を作成できるオブジェクトは null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
Stream
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> T query(StringSE cql, ResultSetExtractor<T> resultSetExtractor, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL からプリペアドステートメントを作成し、クエリにバインドする引数のリストを作成し、ResultSetExtractor
でResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。resultSetExtractor
- 結果を抽出するオブジェクトは null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
ResultSetExtractor
によって返される任意の結果オブジェクト- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public void query(StringSE cql, RowCallbackHandler rowCallbackHandler, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL からプリペアドステートメントを作成し、クエリにバインドする引数のリストを作成し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowCallbackHandler
- 一度に 1 行ずつ結果を抽出するオブジェクトは null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せる)- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> ListSE<T> query(StringSE cql, RowMapper<T> rowMapper, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントとクエリにバインドする引数のリストを作成し、RowMapper
を介して各行を Java オブジェクトにマッピングします。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクトargs
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せる)- 戻り値:
- 結果
List
SE にはマップされたオブジェクトが含まれる - 例外:
DataAccessException
- クエリの実行に問題がある場合。
queryForStream
public <T> StreamSE<T> queryForStream(StringSE cql, RowMapper<T> rowMapper, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、各行をRowMapper
を介して Java オブジェクトにマッピングし、反復可能なStream
SE に変換します。- 次で指定:
- インターフェース
CqlOperations
のqueryForStream
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクトargs
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せる)- 戻り値:
- 結果
Stream
SE にはマップされたオブジェクトが含まれる - 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> T query(StringSE cql, @Nullable PreparedStatementBinder psb, ResultSetExtractor<T> resultSetExtractor) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
準備されたステートメントを使用してクエリを実行し、ResultSetExtractor
を使用してResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。resultSetExtractor
- 結果を抽出するオブジェクトは null であってはなりません。- 戻り値:
ResultSetExtractor
によって返される任意の結果オブジェクト。- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public void query(StringSE cql, @Nullable PreparedStatementBinder psb, RowCallbackHandler rowCallbackHandler) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリに値をバインドする方法を認識しているPreparedStatementBinder
実装を作成し、RowCallbackHandler
を使用して行ごとにResultSet
を読み取ります。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。rowCallbackHandler
- 一度に 1 行ずつ結果を抽出するオブジェクトは null であってはなりません。- 例外:
DataAccessException
- クエリの実行に問題がある場合。
query
public <T> ListSE<T> query(StringSE cql, @Nullable PreparedStatementBinder psb, RowMapper<T> rowMapper) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL と、値をクエリにバインドする方法を認識するPreparedStatementBinder
実装からプリペアドステートメントを作成し、RowMapper
を介して各行を Java オブジェクトにマッピングします。- 次で指定:
- インターフェース
CqlOperations
のquery
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。psb
- 準備されたステートメントに値を設定する方法を知っているオブジェクト。これが null の場合、CQL にはバインドパラメーターが含まれていないと見なされます。バインドパラメーターがない場合でも、このオブジェクトを使用してフェッチサイズやその他のパフォーマンスオプションを設定できます。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。- 戻り値:
- マップされたオブジェクトを含む結果
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。
queryForList
public ListSE<MapSE<StringSE,ObjectSE>> queryForList(StringSE cql, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果List
SE を期待します。結果は、
Map
SE (列名をキーとして使用し、列ごとに 1 つのエントリ) のList
SE (行ごとに 1 つの項目) にマップされます。List
SE の各項目は、このインターフェースの queryForMap() メソッドによって返される形式になります。- 次で指定:
- インターフェース
CqlOperations
のqueryForList
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
- 行ごとに
Map
SE を含むList
SE - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForList
public <T> ListSE<T> queryForList(StringSE cql, ClassSE<T> elementType, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果List
SE を期待します。結果は、指定された要素型に一致する結果オブジェクトの
List
SE (行ごとに 1 つの項目) にマップされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForList
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。elementType
- 結果List
SE の要素の必須型 (たとえば、Integer.class
) は null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
- 指定された要素型に一致するオブジェクトの
List
SE。 - 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForMap
public MapSE<StringSE,ObjectSE> queryForMap(StringSE cql, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果のマップを期待します。このインターフェースで定義されている queryForMap() メソッドは、ドメインモデルがない場合に適しています。それ以外の場合は、queryForObject() メソッドのいずれかを使用することを検討してください。クエリは単一行クエリであることが期待されています。結果行はマップにマップされます(列名をキーとして使用して、各列に 1 つのエントリ)。
- 次で指定:
- インターフェース
CqlOperations
のqueryForMap
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
- 結果マップ (列名をキーとして使用し、列ごとに 1 つのエントリ)。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForObject
public <T> T queryForObject(StringSE cql, ClassSE<T> requiredType, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、結果オブジェクトを期待します。クエリは、単一の行 / 単一列クエリであることが期待されています。返された結果は、対応するオブジェクト型に直接マップされます。
- 次で指定:
- インターフェース
CqlOperations
のqueryForObject
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。requiredType
- 結果オブジェクトが一致すると予想される型は null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのは PreparedStatement に任せる)- 戻り値:
- 必要な型の結果オブジェクト、または CQL NULL の場合は null。
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合、またはその行に正確に 1 列を返さない場合。DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForObject
public <T> T queryForObject(StringSE cql, RowMapper<T> rowMapper, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、RowMapper
を介して単一の結果行を Java オブジェクトにマッピングします。- 次で指定:
- インターフェース
CqlOperations
のqueryForObject
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。rowMapper
- 行ごとに 1 つのオブジェクトをマップするオブジェクト。null にすることはできません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せる)- 戻り値:
- 単一のマッピングされたオブジェクト
- 例外:
IncorrectResultSizeDataAccessException
- クエリが正確に 1 行を返さない場合。DataAccessException
- クエリの実行に問題がある場合。
queryForResultSet
public com.datastax.oss.driver.api.core.cql.ResultSet queryForResultSet(StringSE cql, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリストを作成し、ResultSet を期待します。結果は
ResultSet
にマッピングされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForResultSet
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
ResultSet
表現。- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
queryForRows
public IterableSE<com.datastax.oss.driver.api.core.cql.Row> queryForRows(StringSE cql, ObjectSE... args) throws DataAccessException インターフェースからコピーされた説明:CqlOperations
指定された CQL をクエリして、CQL から準備されたステートメントと、クエリにバインドする引数のリスト (行を想定) を作成します。結果は
Row
にマッピングされます。- 次で指定:
- インターフェース
CqlOperations
のqueryForRows
- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。args
- クエリにバインドする引数 (対応する CQL 型を推測するのはPreparedStatement
に任せます)。- 戻り値:
Row
表現。- 例外:
DataAccessException
- クエリの実行に問題がある場合。- 関連事項:
describeRing
インターフェースからコピーされた説明:CqlOperations
現在のリングについて説明します。これは、提供されているRingMemberHostMapper
を使用して、Cassandra リングトポロジの基本を提供します。- 次で指定:
- インターフェース
CqlOperations
のdescribeRing
- 戻り値:
- クラスター内でアクティブなリングトークンのリスト
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
describeRing
インターフェースからコピーされた説明:CqlOperations
現在のリングについて説明します。アプリケーションコードは、Cassandra クラスターメタデータによって返されるホストのリストを処理するために、独自のHostMapper
実装を提供する必要があります。- 次で指定:
- インターフェース
CqlOperations
のdescribeRing
- パラメーター:
hostMapper
- ホストマッピングに使用する実装。- 戻り値:
- 提供された HostMapper によって生成されたコレクション。
- 例外:
DataAccessException
- クエリの実行に問題がある場合。
translateException
protected DataAccessException translateException(StringSE task, @Nullable StringSE cql, RuntimeExceptionSE RuntimeException) 指定されたRuntimeException
SE を汎用DataAccessException
に変換します。- パラメーター:
task
- 試行されているタスクを説明する読み取り可能なテキストcql
- 問題の原因となった CQL クエリまたは更新 (null の可能性があります)RuntimeException
- 問題のRuntimeException
。- 戻り値:
- 例外変換
Function
SE - 関連事項:
newPreparedStatementCreator
渡された CQL を使用して、新しい CQL ベースのPreparedStatementCreator
を作成します。デフォルトでは、SimplePreparedStatementCreator
を作成します。このメソッドを使用すると、サブクラスによって作成をオーバーライドできます。- パラメーター:
cql
- 実行する静的 CQL は空または null であってはなりません。- 戻り値:
- 使用する新しい
PreparedStatementCreator
newResultSetExtractor
protected CqlTemplate.RowCallbackHandlerResultSetExtractor newResultSetExtractor(RowCallbackHandler rowCallbackHandler) 指定されたRowCallbackHandler
を適応させてResultSetExtractor
の新しいインスタンスを構築します。- パラメーター:
rowCallbackHandler
-RowCallbackHandler
をResultSetExtractor
として適応させます。- 戻り値:
RowCallbackHandler
のインスタンスを適応させたResultSetExtractor
実装。- 関連事項:
newResultSetExtractor
指定されたRowMapper
を適応させてResultSetExtractor
の新しいインスタンスを構築します。- パラメーター:
rowMapper
-RowMapper
をResultSetExtractor
として適応させます。- 戻り値:
RowMapper
のインスタンスを適応させたResultSetExtractor
実装。- 関連事項:
newResultSetExtractor
protected <T> RowMapperResultSetExtractor<T> newResultSetExtractor(RowMapper<T> rowMapper, int rowsExpected) 指定されたRowMapper
を適応させてResultSetExtractor
の新しいインスタンスを構築します。- パラメーター:
rowMapper
-RowMapper
をResultSetExtractor
として適応させます。rowsExpected
-ResultSet
内の予想される行数。- 戻り値:
RowMapper
のインスタンスを適応させたResultSetExtractor
実装。- 関連事項:
newStreamExtractor
指定されたRowMapper
を適応させてResultSetExtractor
の新しいインスタンスを構築します。- パラメーター:
rowMapper
-RowMapper
をResultSetExtractor
として適応させます。- 戻り値:
RowMapper
のインスタンスを適応させたResultSetExtractor
実装。- 導入:
- 3.1
- 関連事項: