CciTemplate (Spring Framework API)

java.lang.ObjectSE
- org.springframework.jca.cci.core.CciTemplate

実装されたすべてのインターフェース:
CciOperations
使用すべきではありません。
5.3 以降、特定のデータアクセス API を推奨 (代替がない場合はネイティブ CCI の使用を推奨)
```
@DeprecatedSE
public class CciTemplate
extends ObjectSE
implements CciOperations
```
これは、CCI コアパッケージの中心的なクラスです。CCI の使用を簡素化し、一般的なエラーを回避できます。コア CCI ワークフローを実行し、CCI にパラメーターを提供して結果を抽出するアプリケーションコードを残します。このクラスは、EIS クエリまたは更新を実行し、ResourceExceptions をキャッチして、org.springframework.dao パッケージで定義されている一般的な例外階層に変換します。
このクラスを使用するコードは、RecordEE インスタンスを渡して受け取ったり、入力レコードを作成したり、出力レコード（または CCI ResultSets）から結果オブジェクトを抽出したりするためのコールバックインターフェースを実装できます。
ConnectionFactory 参照を使用した直接インスタンス化を介してサービス実装内で使用するか、アプリケーションコンテキストで準備し、Bean 参照としてサービスに提供できます。注: ConnectionFactory は、アプリケーションコンテキストで常に Bean として構成する必要があります。最初の場合はサービスに直接、2 番目の場合は準備済みテンプレートに設定します。
導入:
1.2
作成者:
Thierry Templier, Juergen Hoeller
関連事項:
RecordCreator, RecordExtractor

コンストラクターのサマリー

コンストラクター
コンストラクターと説明
`CciTemplate()` 使用すべきではありません。 Bean 用の新しい CciTemplate を作成します。
`CciTemplate(ConnectionFactoryEE connectionFactory)` 使用すべきではありません。接続を取得する ConnectionFactory を指定して、新しい CciTemplate を構築します。
`CciTemplate(ConnectionFactoryEE connectionFactory, ConnectionSpecEE connectionSpec)` 使用すべきではありません。接続を取得する ConnectionFactory を指定して、新しい CciTemplate を構築します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` 使用すべきではありません。
`IndexedRecordEE`	`createIndexedRecord(StringSE name)` 使用すべきではありません。 ConnectionFactory の RecordFactory を介してインデックス付きレコードを作成します。
`MappedRecordEE`	`createMappedRecord(StringSE name)` 使用すべきではありません。 ConnectionFactory の RecordFactory からマップされたレコードを作成します。
`protected RecordEE`	`createRecord(RecordCreator recordCreator)` 使用すべきではありません。指定された RecordCreator を呼び出し、JCA ResourceExceptions を Spring の DataAccessException 階層に変換します。
`protected <T> T`	`doExecute(InteractionSpecEE spec, RecordEE inputRecord, RecordEE outputRecord, RecordExtractor<T> outputExtractor)` 使用すべきではありません。 CIS を使用して、EIS で指定された対話を実行します。
`<T> T`	`execute(ConnectionCallback<T> action)` 使用すべきではありません。 CCI 接続で動作するコールバックアクションとして実装された、CCI を使用して EIS でリクエストを実行します。
`<T> T`	`execute(InteractionCallback<T> action)` 使用すべきではありません。 CCI 相互作用で動作するコールバックアクションとして実装された、CCI を使用して EIS でリクエストを実行します。
`RecordEE`	`execute(InteractionSpecEE spec, RecordEE inputRecord)` 使用すべきではありません。 CIS を使用して、EIS で指定された対話を実行します。
`RecordEE`	`execute(InteractionSpecEE spec, RecordCreator inputCreator)` 使用すべきではありません。 CIS を使用して、EIS で指定された対話を実行します。
`<T> T`	`execute(InteractionSpecEE spec, RecordCreator inputCreator, RecordExtractor<T> outputExtractor)` 使用すべきではありません。 CIS を使用して、EIS で指定された対話を実行します。
`void`	`execute(InteractionSpecEE spec, RecordEE inputRecord, RecordEE outputRecord)` 使用すべきではありません。 CIS を使用して、EIS で指定された対話を実行します。
`<T> T`	`execute(InteractionSpecEE spec, RecordEE inputRecord, RecordExtractor<T> outputExtractor)` 使用すべきではありません。 CIS を使用して、EIS で指定された対話を実行します。
`ConnectionFactoryEE`	`getConnectionFactory()` 使用すべきではありません。このテンプレートで使用される CCI ConnectionFactory を返します。
`ConnectionSpecEE`	`getConnectionSpec()` 使用すべきではありません。このテンプレートで使用されている CCI ConnectionSpec を返します（ある場合）。
`CciTemplate`	`getDerivedTemplate(ConnectionSpecEE connectionSpec)` 使用すべきではありません。このテンプレートインスタンスから派生したテンプレートを作成し、ConnectionFactory およびその他の設定を継承しますが、接続の取得に使用される ConnectionSpec をオーバーライドします。
`RecordCreator`	`getOutputRecordCreator()` 使用すべきではありません。デフォルトの出力レコードの作成に使用する必要がある RecordCreator を返します。
`protected RecordFactoryEE`	`getRecordFactory(ConnectionFactoryEE connectionFactory)` 使用すべきではありません。指定された ConnectionFactory の RecordFactory を返します。
`void`	`setConnectionFactory(ConnectionFactoryEE connectionFactory)` 使用すべきではありません。接続を取得する CCI ConnectionFactory を設定します。
`void`	`setConnectionSpec(ConnectionSpecEE connectionSpec)` 使用すべきではありません。このテンプレートインスタンスが接続を取得することになっている CCI ConnectionSpec を設定します。
`void`	`setOutputRecordCreator(RecordCreator creator)` 使用すべきではありません。デフォルトの出力レコードの作成に使用する RecordCreator を設定します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - CciTemplate
```
public CciTemplate()
```
    使用すべきではありません。
    Bean 用の新しい CciTemplate を作成します。
    メモ: インスタンスを使用する前に、ConnectionFactory を設定する必要があります。
    関連事項:
    setConnectionFactory(javax.resource.cci.ConnectionFactory)
  - CciTemplate
```
public CciTemplate(ConnectionFactoryEE connectionFactory)
```
    使用すべきではありません。
    接続を取得する ConnectionFactory を指定して、新しい CciTemplate を構築します。注: これにより、例外トランスレーターの先行初期化がトリガーされます。
    パラメーター:
    connectionFactory - から接続を取得する JCA ConnectionFactory
  - CciTemplate
```
public CciTemplate(ConnectionFactoryEE connectionFactory,
                   @Nullable
                   ConnectionSpecEE connectionSpec)
```
    使用すべきではありません。
    接続を取得する ConnectionFactory を指定して、新しい CciTemplate を構築します。注: これにより、例外トランスレーターの先行初期化がトリガーされます。
    パラメーター:
    connectionFactory - から接続を取得する JCA ConnectionFactory
    connectionSpec - 接続を取得する CCI ConnectionSpec (null の場合があります)
- メソッドの詳細
  - setConnectionFactory
```
public void setConnectionFactory(@Nullable
                                 ConnectionFactoryEE connectionFactory)
```
    使用すべきではありません。
    接続を取得する CCI ConnectionFactory を設定します。
  - getConnectionFactory
```
@Nullable
public ConnectionFactoryEE getConnectionFactory()
```
    使用すべきではありません。
    このテンプレートで使用される CCI ConnectionFactory を返します。
  - setConnectionSpec
```
public void setConnectionSpec(@Nullable
                              ConnectionSpecEE connectionSpec)
```
    使用すべきではありません。
    このテンプレートインスタンスが接続を取得することになっている CCI ConnectionSpec を設定します。
  - getConnectionSpec
```
@Nullable
public ConnectionSpecEE getConnectionSpec()
```
    使用すべきではありません。
    このテンプレートで使用されている CCI ConnectionSpec を返します（ある場合）。
  - setOutputRecordCreator
```
public void setOutputRecordCreator(@Nullable
                                   RecordCreator creator)
```
    使用すべきではありません。
    デフォルトの出力レコードの作成に使用する RecordCreator を設定します。
    デフォルトはなし: 明示的な出力 Record が execute メソッドに渡されない場合、出力 Record を返す CCI の Interaction.execute バリアントが呼び出されます。
    渡された出力レコードを使用して CCI の Interaction.execute バリアントを常に呼び出す必要がある場合は、ここで RecordCreator を指定します。明示的に指定された出力 Record がない限り、CciTemplate はこの RecordCreator を呼び出してデフォルトの出力 Record インスタンスを作成します。
    関連事項:
    Interaction.execute(javax.resource.cci.InteractionSpec, Record)EE, Interaction.execute(javax.resource.cci.InteractionSpec, Record, Record)EE
  - getOutputRecordCreator
```
@Nullable
public RecordCreator getOutputRecordCreator()
```
    使用すべきではありません。
    デフォルトの出力レコードの作成に使用する必要がある RecordCreator を返します。
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    使用すべきではありません。
  - getDerivedTemplate
```
public CciTemplate getDerivedTemplate(ConnectionSpecEE connectionSpec)
```
    使用すべきではありません。
    このテンプレートインスタンスから派生したテンプレートを作成し、ConnectionFactory およびその他の設定を継承しますが、接続の取得に使用される ConnectionSpec をオーバーライドします。
    パラメーター:
    connectionSpec - 派生テンプレートインスタンスが接続を取得することになっている CCI ConnectionSpec
    戻り値:
    派生テンプレートインスタンス
    関連事項:
    setConnectionSpec(javax.resource.cci.ConnectionSpec)
  - execute
```
@Nullable
public <T> T execute(ConnectionCallback<T> action)
                        throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CCI を使用する EIS でリクエストを実行します。CCI 接続で動作するコールバックアクションとして実装されます。これにより、Spring の管理された CCI 環境内で任意のデータアクセス操作を実装できます。つまり、Spring 管理のトランザクションに参加し、JCA ResourceExceptions を Spring の DataAccessException 階層に変換します。
    コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    action - アクションを指定するコールバックオブジェクト
    戻り値:
    アクションによって返された結果オブジェクト（存在する場合）
    例外:
    DataAccessException - 問題がある場合
  - execute
```
@Nullable
public <T> T execute(InteractionCallback<T> action)
                        throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CCI を使用して EIS でリクエストを実行します。これは、CCI 相互作用で動作するコールバックアクションとして実装されます。これにより、Spring の管理された CCI 環境内で、単一の対話で任意のデータアクセス操作を実装できます。つまり、Spring 管理のトランザクションに参加し、JCA ResourceExceptions を Spring の DataAccessException 階層に変換します。
    コールバックアクションは、ドメインオブジェクトまたはドメインオブジェクトのコレクションなどの結果オブジェクトを返すことができます。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    action - アクションを指定するコールバックオブジェクト
    戻り値:
    アクションによって返された結果オブジェクト（存在する場合）
    例外:
    DataAccessException - 問題がある場合
  - execute
```
@Nullable
public RecordEE execute(InteractionSpecEE spec,
                                RecordEE inputRecord)
                         throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CIS を使用して、EIS で指定された対話を実行します。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    spec - 相互作用を定義する CCI InteractionSpec インスタンス (connector-specific)
    inputRecord - 入力レコード
    戻り値:
    出力レコード
    例外:
    DataAccessException - 問題がある場合
  - execute
```
public void execute(InteractionSpecEE spec,
                    RecordEE inputRecord,
                    RecordEE outputRecord)
             throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CIS を使用して、EIS で指定された対話を実行します。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    spec - 相互作用を定義する CCI InteractionSpec インスタンス (connector-specific)
    inputRecord - 入力レコード
    outputRecord - 出力レコード
    例外:
    DataAccessException - 問題がある場合
  - execute
```
public RecordEE execute(InteractionSpecEE spec,
                      RecordCreator inputCreator)
               throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CIS を使用して、EIS で指定された対話を実行します。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    spec - 相互作用を定義する CCI InteractionSpec インスタンス (connector-specific)
    inputCreator - 使用する入力レコードを作成するオブジェクト
    戻り値:
    出力レコード
    例外:
    DataAccessException - 問題がある場合
  - execute
```
public <T> T execute(InteractionSpecEE spec,
                     RecordEE inputRecord,
                     RecordExtractor<T> outputExtractor)
              throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CIS を使用して、EIS で指定された対話を実行します。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    spec - 相互作用を定義する CCI InteractionSpec インスタンス (connector-specific)
    inputRecord - 入力レコード
    outputExtractor - 出力レコードを結果オブジェクトに変換するオブジェクト
    戻り値:
    RecordExtractor オブジェクトで抽出された出力データ
    例外:
    DataAccessException - 問題がある場合
  - execute
```
public <T> T execute(InteractionSpecEE spec,
                     RecordCreator inputCreator,
                     RecordExtractor<T> outputExtractor)
              throws DataAccessException
```
    使用すべきではありません。
    インターフェースからコピーされた説明: CciOperations
    CIS を使用して、EIS で指定された対話を実行します。
    次で指定:
    インターフェース CciOperations の execute
    パラメーター:
    spec - 相互作用を定義する CCI InteractionSpec インスタンス (connector-specific)
    inputCreator - 使用する入力レコードを作成するオブジェクト
    outputExtractor - 出力レコードを結果オブジェクトに変換するオブジェクト
    戻り値:
    RecordExtractor オブジェクトで抽出された出力データ
    例外:
    DataAccessException - 問題がある場合
  - doExecute
```
@Nullable
protected <T> T doExecute(InteractionSpecEE spec,
                                    RecordEE inputRecord,
                                    @Nullable
                                    RecordEE outputRecord,
                                    @Nullable
                                    RecordExtractor<T> outputExtractor)
                             throws DataAccessException
```
    使用すべきではありません。
    CCI を使用して EIS で指定された対話を実行します。他のすべての対話実行メソッドはこれを通過します。
    パラメーター:
    spec - 相互作用を定義する CCI InteractionSpec インスタンス (connector-specific)
    inputRecord - 入力レコード
    outputRecord - 出力レコード (null にすることができます)
    outputExtractor - 出力レコードを結果オブジェクトに変換するオブジェクト
    戻り値:
    RecordExtractor オブジェクトで抽出された出力データ
    例外:
    DataAccessException - 問題がある場合
  - createIndexedRecord
```
public IndexedRecordEE createIndexedRecord(StringSE name)
                                  throws DataAccessException
```
    使用すべきではありません。
    ConnectionFactory の RecordFactory を介してインデックス付きレコードを作成します。
    パラメーター:
    name - レコードの名前
    戻り値:
    レコード
    例外:
    DataAccessException - レコードの作成に失敗した場合
    関連事項:
    getRecordFactory(javax.resource.cci.ConnectionFactory), RecordFactory.createIndexedRecord(String)EE
  - createMappedRecord
```
public MappedRecordEE createMappedRecord(StringSE name)
                                throws DataAccessException
```
    使用すべきではありません。
    ConnectionFactory の RecordFactory からマップされたレコードを作成します。
    パラメーター:
    name - レコード名
    戻り値:
    レコード
    例外:
    DataAccessException - レコードの作成に失敗した場合
    関連事項:
    getRecordFactory(javax.resource.cci.ConnectionFactory), RecordFactory.createMappedRecord(String)EE
  - createRecord
```
protected RecordEE createRecord(RecordCreator recordCreator)
                       throws DataAccessException
```
    使用すべきではありません。
    指定された RecordCreator を呼び出し、JCA ResourceExceptions を Spring の DataAccessException 階層に変換します。
    パラメーター:
    recordCreator - 呼び出す RecordCreator
    戻り値:
    作成されたレコード
    例外:
    DataAccessException - レコードの作成に失敗した場合
    関連事項:
    getRecordFactory(javax.resource.cci.ConnectionFactory), RecordCreator.createRecord(javax.resource.cci.RecordFactory)
  - getRecordFactory
```
protected RecordFactoryEE getRecordFactory(ConnectionFactoryEE connectionFactory)
                                  throws ResourceExceptionEE
```
    使用すべきではありません。
    指定された ConnectionFactory の RecordFactory を返します。
    デフォルトの実装は、可能であればコネクターの RecordFactory を返し、NotSupportedRecordFactory プレースホルダーにフォールバックします。これにより、いかなる場合でも、null でない RecordFactory 参照を使用して RecordCreator コールバックを呼び出すことができます。
    パラメーター:
    connectionFactory - CCI ConnectionFactory
    戻り値:
    ConnectionFactory の CCI RecordFactory
    例外:
    ResourceExceptionEE - CCI メソッドによってスローされた場合
    関連事項:
    NotSupportedRecordFactory

クラス CciTemplate

コンストラクターのサマリー

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

CciTemplate

CciTemplate

CciTemplate

メソッドの詳細

setConnectionFactory

getConnectionFactory

setConnectionSpec

getConnectionSpec

setOutputRecordCreator

getOutputRecordCreator

afterPropertiesSet

getDerivedTemplate

execute

execute

execute

execute

execute

execute

execute

doExecute

createIndexedRecord

createMappedRecord

createRecord

getRecordFactory