JSP クライアント

制約事項: 本トピックは、Enterprise Server 機能が有効な場合にのみ該当します。

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

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

生成された 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 クライアントの実行

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