クライアントアプリケーションは、同期アプリケーション連携実行基盤を呼び出して処理要求を行い、処理結果を受け取る役割をもったアプリケーションです。
クライアントアプリケーションは、Javaで作成します。形態としては、サーブレット、JavaServer Pages(JSP)ベースのアプリケーションなどが利用できます。
同期アプリケーション連携実行基盤で提供されるクライアントAPIを利用することにより、各サーバアプリケーションで共通のAPIを使用したクライアントアプリケーションを開発することができます。
クライアントアプリケーションにおける操作は、beanまたはMapにデータを設定しクライアントAPIを呼び出すだけで、サーバアプリケーション固有のAPIを使用する必要はありません。このため、クライアントアプリケーションとサーバアプリケーションの依存関係が少なくなり、それぞれを独立して開発することができます。
クライアントアプリケーションから同期アプリケーション連携実行基盤を呼び出すには、以下の3種類の方法があります。クライアントアプリケーションの種類に応じて呼出し方法を選択してください。
一般的なJavaアプリケーションからの呼出し
一般的なJavaアプリケーションからサーバアプリケーションを呼び出します。Servlet、JSP、およびEJBなどの一般的なアプリケーションから呼び出すことができます。
Apcoordinatorのリモート共通インタフェースによる呼出し
Apcoordinatorのリモート共通インタフェースを使用して、サーバアプリケーションを呼び出します。これにより、Apcoordinatorによるアプリケーション開発の親和性が高まり、EJBと共通のインタフェースで呼び出すことができアプリケーション情報入力ファイルの作成アプリケーション情報入力ファイルの作成ます。
Apcoordinatorの詳細については、“Apcoordinatorユーザーズガイド”を参照してください。
J2EE Connector ArchitectureのCommon Client Interface（CCI）による呼出し
J2EE Connector Architecture対応クライアントAPIを使用して、サーバアプリケーションを呼び出します。これにより、J2EEの標準的なインタフェースで呼び出すことができます。
■同期アプリケーション連携実行基盤におけるbeanの位置付け
Javaで作成したクライアントプログラムを、同期アプリケーション連携実行基盤に定義されたサーバアプリケーションと連携させるためには、Javaクライアントランタイム（以降、クライアントAPIと呼びます）、Javaクライアントアプリケーションをつなぐためのデータ変換クラス、および呼び出すサーバアプリケーションのインタフェース情報（bean）が必要になります。以下に、それぞれの位置付けを示します。
Javaで作成したクライアントプログラムを、サーバアプリケーションと連携させるために必要な情報は、以下の方法で作成することができます。
サーバアプリケーションがC言語の場合： bean生成ツール（コマンド）
サーバアプリケーションがCOBOLの場合： COBOL開発支援ツール
■C言語のサーバアプリケーションと連携する場合
C言語のサーバアプリケーションと連携する場合は、bean生成ツールで必要な情報を作成します。bean生成ツールでは、サーバアプリケーションのインタフェースを定義したIDLファイル、および付加情報を定義したアプリケーション情報入力ファイルを入力として、以下の情報を生成します。
データ変換クラス
ユーザ定義型クラス
bean
Javaで作成したクライアントプログラムと、bean生成ツールで生成された情報をコンパイルおよびビルドして、Javaクライアントアプリケーション（jarファイル）を作成します。
以下に、bean生成ツールの機能概要を示します。
IDLファイル
サーバアプリケーションのインタフェースを、IDLで記述したファイルです。
アプリケーション情報入力ファイル
サーバアプリケーションインタフェースの付加情報などを定義したファイルです。
bean
IDLファイルに定義されているサーバアプリケーションのオペレーションに対応した、Javaのクラスです。
ユーザ定義型クラス
IDLファイルに定義されている構造体に対応した、ユーザ定義型のJavaクラスです。
データ変換クラス
bean、配列、ユーザ定義型クラス、およびバイナリのデータを同期アプリケーション連携実行基盤のデータ型へ変換するための、Javaクラスです。
■COBOLのサーバアプリケーションと連携する場合
COBOLのサーバアプリケーションと連携する場合は、COBOL開発支援ツールで必要な情報を作成します。COBOL開発支援ツールは、COBOL登録集、およびサーバアプリケーションの付加情報を入力として、以下の情報を生成します。
データ変換クラス
ユーザ定義型クラス
bean
Javaで作成したクライアントプログラムと、COBOL開発支援ツールで生成された情報をコンパイルおよびビルドして、Javaクライアントアプリケーション（jarファイル）を作成します。
以下に、COBOL開発支援ツールの機能概要を示します。
COBOL登録集
サーバアプリケーションで使用するパラメタ（COBOLプログラムのPROCEDURE DIVISIONのUSING句に指定したデータ項目）を記述したファイルです。
bean
COBOL登録集に定義されているサーバアプリケーションのオペレーションに対応した、Javaのクラスです。
ユーザ定義型クラス
COBOL登録集に定義されている構造体に対応した、ユーザ定義型のJavaクラスです。
データ変換クラス
bean、配列、ユーザ定義型クラス、およびバイナリのデータを同期アプリケーション連携実行基盤のデータ型へ変換するための、Javaクラスです。
注意
COBOL開発支援ツールが生成する以下のファイルは、クライアントアプリケーション開発では使用しませんが、サーバ側のアプリケーションを作成配備する場合に使用します。
COBOL実行基盤インタフェース
アプリケーションインタフェース定義ファイル
アプリケーション呼出し定義ファイル
