JSP クライアント

EJB がエンタープライズ サーバー インスタンスで実行されている COBOL サービスにアクセスするには、EJB および JSP クライアントをアプリケーション サーバー上で実行する必要があります。IMTK から EJB と JSP クライアントの両方を同時に生成し、それらを実行するようにアプリケーション サーバーを構成できます。

重要: 生成プロセスの間に、ディプロイで作成された .car ファイルが削除されます。このため、プロダクション用の Java サービス インターフェイスを設定するとき、クライアントを生成する前に .car ファイルを使用してそのサービス インターフェイスをディプロイする必要があります。詳細については、「サービス インターフェイス ディプロイ パッケージ」を参照してください。

生成された EJB および JSP クライアントは、アーカイブ ファイル (.jar.war、および .ear) に、マニフェスト ファイルとディプロイメント記述子とともにパッケージされます。これらのファイルは、プロジェクトの myService.deploy ディレクトリの下の構造に置かれます。ここで、myService はサービス インターフェイスの名前です。jar コマンドまたは zip ユーティリティを使用して、これらのアーカイブの内容を表示したりこれらのアーカイブから個々のファイルを抽出したりできます。次のアーカイブ ファイルが作成されます。

EJB Jar アーカイブ
myService.jar アーカイブには、EJB クラスおよび追加の必須ファイルが含まれています。
ejb-jar.xml EJB を定義する、汎用のディプロイメント記述子
myServiceBean.class EJB の Bean クラス
myServiceHome.class EJB のホーム インターフェイス
myService.class EJB のリモート インターフェイス
myRecord.class EJB で必要な場合のカスタム レコード
manifest.mf この .jar ファイルを記述するマニフェスト
weblogic-ejb-jar.xml のような *.xml EJB を、一部の Java アプリケーション サーバー (WebLogic など) にディプロイするためのディプロイメント記述子

EJB クラスのソース コードは、com\mypackage\myService ディレクトリに生成されます。

クライアント War アーカイブ
myService.war アーカイブには、JSP クラス ファイルおよびその他の必須ファイルが含まれています。
*.jsp JSP ファイル。このファイルは、エンド ユーザーとサーブレット間でデータを受け渡しします。
myServiceJspBean.class このファイルにはゲッターとセッターのメソッドが含まれ、サーブレットと JSP 間で情報を相互に移行するために使用されます。
myServiceServlet.class このファイルはサーブレットです。JSP から着信する要求を処理し、ステートレス EJB のインスタンスを呼び出し、応答を JSP に返信します。
myServiceSessionMonitor.class これはヘルパー クラスで、ステートフル セッション Bean の EJB インスタンスを格納します。
manifest.mf この .war ファイルを記述するマニフェスト
mfejlib.jar .. カスタム レコード
web.xml クライアントのサーブレットおよび EJB リファレンスを定義する、汎用のディプロイメント記述子
weblogic.xml のような *.xml .war ファイルを、一部の Java アプリケーション サーバー (WebLogic など) にディプロイするためのディプロイメント記述子
アプリケーション Ear アーカイブ
myService.ear アーカイブには、他の 2 つのアーカイブ ファイルおよび追加の必須ファイルが含まれています。このアーカイブは、追加の変更なしに EJB をサポートされるサード パーティのアプリケーション サーバーにディプロイするために必要なすべての要素を含んでいます。
重要: このアプリケーション Ear アーカイブ ファイルを Java アプリケーション サーバーにディプロイする必要があります。
application.xml jar ファイルおよびクライアント .war ファイルを定義する、汎用のディプロイメント記述子
myService.jar EJB Jar アーカイブ ファイル
myService.war クライアント War アーカイブ ファイル
manifest.mf この .jar ファイルを記述するマニフェスト
mfejlib.jar カスタム レコード

JSP クライアント コンポーネントの編集

その外観とユーザービリティを向上させるために、オプションで JSP クライアントを編集できます。編集するには、最初に、プロジェクトのディプロイ フォルダーにある myService.war アーカイブ ファイルから JSP ファイルを抽出する必要があります。

注: JSP ファイルを編集する場合は、そのファイルを .war アーカイブに戻して追加し、そのコピーを別の場所に保存して、サービス インターフェイスを再びディプロイするときこのファイルを上書きしないようにします。

JSP クライアントの実行

  • サービスを実行するように構成されている エンタープライズ サーバー リージョン が、サービス インターフェイス (.svi) ファイルが含まれているプロジェクトに関連付けられていること
  • エンタープライズ サーバー リージョン を起動していること
  • サービス インターフェイスを エンタープライズ サーバー リージョン にディプロイしていること
注: サポートされていない Java アプリケーション サーバーを使用している場合は、ディプロイメント記述子を手動で作成する必要があります。詳細については、アプリケーション サーバーのマニュアルを参照してください。サポートされているアプリケーション サーバーの一覧については、「追加ソフトウェア要件」の「Enterprise Server のためのアプリケーション サーバー JCA サポート」セクションを参照してください。手順の詳細については、「ディプロイメント記述子を手動で作成するには」も参照してください。