DBアダプタの定義について説明します。DBアダプタは,サービスアダプタ定義画面で定義できます。
DBアダプタの場合,WSDLが生成されないため,サービス部品の電文フォーマットも自動生成されません。そのため,サービス部品の電文フォーマット(DBアダプタ用のXMLフォーマット定義ファイル)を作成して,設定する必要があります。
DBアダプタ用のXMLフォーマット定義ファイルの作成方法については,「4.3.5 サービス部品電文を作成する(DBアダプタ電文の場合)」を参照してください。
サービスリクエスタの電文の形式と,DBアダプタ電文の形式が異なる場合,データ変換が必要です。
要求電文のデータ変換を行う場合,サービスアダプタ定義画面で標準電文にサービスリクエスタから入力される電文を設定し,データ変換定義画面でデータ変換(マッピング)を定義します。応答電文のデータ変換を行う場合,サービス部品から返される電文に標準電文を設定し,データ変換定義画面でデータ変換(マッピング)を定義します。
データ変換の詳細については,「7. データ変換の定義」を参照してください。
サービス部品の利用者は,次のファイルを作成し,サービスアダプタ定義画面で設定する必要があります。
SQLオペレーション定義ファイルの作成については,「4.3.5(1) SQLオペレーション定義ファイルを作成する」を参照してください。
アプリケーション統合属性ファイルは,サンプルファイルをテキストエディタなどで編集して作成します。アプリケーション統合属性ファイルは「cscadapter_property.xml」という名称で,次の場所に格納されています。
<Cosminexusのインストールディレクトリ>¥CSC¥config¥dba¥templates
なお,アプリケーション統合属性ファイルの詳細については,マニュアル「Cosminexus アプリケーション設定操作ガイド」を参照してください。
アプリケーション統合属性ファイルに設定する項目について,次の表に示します。
表5-3 アプリケーション統合属性ファイルの設定項目
タグ | 説明 | 設定内容 |
---|---|---|
<hitachi-application-all-property> | ルートタグ | - |
<ejb-jar> | EJBに関する情報の定義の開始タグ | - |
<hitachi-session-bean-property> | SessionBeanの属性の定義の開始タグ | - |
<resource-ref> | リソース参照についての定義の開始タグ | - |
<res-ref-name> | リソース参照名 | SQLオペレーション定義ファイルの<DB_NAME>タグに指定したデータベース参照名。 |
<res-sharing-scope> | 参照したリソースを共有するかどうかの指定 | DBアダプタが参照するDB Connectorを共有するかどうかの指定。 |
<linked-to> | データソース表示名 | DB Connectorのプロパティ定義(Display name)に指定したリソースアダプタの名称。 |
</resource-ref> | リソース参照についての定義の終了タグ | - |
<session-runtime> | runtimeの定義の開始タグ | - |
<stateless> | statelessの定義の開始タグ | - |
<pooled-instance> | プール内のインスタンスについての定義の開始タグ | - |
<minimum> | プール内のインスタンスの最小数 | DBアダプタのインスタンスの最小数。 |
<maximum> | プール内のインスタンスの最大数 | DBアダプタのインスタンスの最大数。 |
</pooled-instance> | プール内のインスタンスについての定義の終了タグ | - |
</stateless> | statelessの定義の終了タグ | - |
</session-runtime> | runtimeの定義の終了タグ | - |
</hitachi-session-bean-property> | SessionBeanの属性の定義の終了タグ | - |
</ejb-jar> | EJBに関する情報の定義の終了タグ | - |
</hitachi-application-all-property> | ルートタグ | - |
DBアダプタを定義する場合の手順を次に示します。