HATS EJB アプリケーションの作成と使用

1 つ以上のホスト・アプリケーションを変換し、エンド・ユーザーに Web ページを表示する通常の HATS プロジェクトの代わりとして、HATS Enterprise JavaBeans™ (EJB) プロジェクトを構築することができます。HATS EJB プロジェクトは、統合オブジェクトにカプセル化されたホストとの対話へのアクセスを提供します。統合オブジェクトは、別の HATS アプリケーション、ユーザー作成の Java™ プログラム、Web アプリケーション、または別の EJB などの EJB クライアントにホスト・データを提供するために必要です。HATS EJB プロジェクトは、ホスト・データのコレクションをその表示から分離することができます。いくつかの HATS プロジェクトから 1 つ以上の統合オブジェクトを呼び出せるようにするには、それらを HATS EJB プロジェクトに組み込んで、いくつかの別の HATS プロジェクトから呼び出します。HATS EJB プロジェクトの構成を完了すると、それを HATS EJB アプリケーションとしてアセンブルできます。

注:
  1. HATS EJB アプリケーション・サポートは HATS V7.5.1 では非推奨です。現時点では、HATS EJB アプリケーションは引き続きサポートされていますが、IBM では、製品の今後のリリースでこの機能を削除する権利を持っています。以下の代替方法があります。
  2. ここでは、読者が EJB の基本概念に精通していることを前提としています。そうでない場合は、このサブジェクトに関する Rational® SDP の資料、またはご使用のバージョンおよびエディションの WebSphere® Application Server の WebSphere インフォメーション・センターを参照してください。
  3. HATS EJB プロジェクトで Web 高速ログオンを使用するよう設定された統合オブジェクトを組み込むことはできません。
  4. Host Publisher で EJB プロジェクトを開発した場合は、それらを HATS プロジェクトにインポートできます。Host Publisher プロジェクトの HATS へのインポートについては、「HATS ユーザーと管理者のガイド」を参照してください。

HATS EJB アプリケーションでは、エンド・ユーザーとの直接の対話やホスト画面の変換は実行できません。また、このアプリケーションには HATS プロジェクトに組み込まれている画面カスタマイズ、テンプレート、変換などのリソースは含まれません。HATS EJB アプリケーションには 1 つ以上の統合オブジェクトが含まれており、それらのサービスが呼び出し側プログラムで使用可能になります。

HATS EJB プロジェクトを作成すると、HATS Toolkit で新規ビューが開きます。このビューは、「HATS EJB プロジェクト表示」と呼ばれます。これは「HATS プロジェクト」ビューに似ていますが、含まれているのは HATS EJB プロジェクトだけです。このセクションで説明している EJB リソースを表示します。HATS EJB プロジェクトを処理するには、他の HATS プロジェクトで「HATS プロジェクト」ビューを使用するのと同じように「HATS EJB プロジェクト表示」を使用します。例えば、マクロを記録するには、「HATS EJB プロジェクト表示」でプロジェクト名をクリックし、「ホスト端末」アイコンをクリックしてプロジェクトのメイン接続のホスト端末を開きます。

HATS EJB アプリケーションは Enterprise Archive (EAR ファイル) であり、1 つ以上の統合オブジェクトで構成され、それらのサービスが EJB クライアントで使用可能にされます。通常は次の部分から成ります。

HATS EJB サポートは、HATS EJB を提供するだけでなく、統合オブジェクトごとに EJB Access Bean を生成します。この EJB Access Bean は統合オブジェクトと同じシグニチャーを持つので、EJB Access Bean を使用して統合オブジェクトを実行するためのアプリケーションと JSP を開発することができます。EJB Access Bean のシグニチャーは統合オブジェクトと同じなので、元の統合オブジェクトを使用するのとまったく同じように、クライアント・サイドのコードで EJB Access Bean を使用できます。したがって、クライアントは次のいずれかになります。

図 2

に、HATS EJB アプリケーションと、そのサービスを使用するその他のアプリケーションとのリンクを示します。

図 2. HATS EJB プロジェクト
HATS EJB プロジェクト

HATS EJB プロジェクトの作成

HATS EJB プロジェクトを作成するには、次の手順を実行します。

  1. 最終的に EJB Access Bean を組み込む予定の HATS プロジェクトを起動します。これは、ターゲット HATS プロジェクトと呼ばれます。
  2. 「ファイル」>「新規」>「プロジェクト」>「HATS」>「HATS EJB プロジェクト」をクリックします。HATS EJB プロジェクトは、必ず HATS ターゲット・プロジェクトと同じ EAR に置いてください。ウィザードでホスト接続を 1 つ定義します。
  3. Host Publisher Studio で作成した統合オブジェクトを使用する場合は、それらをプロジェクトにインポートします。「ファイル」>「インポート」をクリックし、「Host Publisher IO」を選択して、ウィザードを完了します。接続の定義やこれらの統合オブジェクトのマクロの記録は必要ありません。
  4. データの抽出元となるその他のホスト・マシンへの接続を定義します。接続の定義については、「HATS ユーザーと管理者のガイド」を参照してください。
  5. ホスト接続のいずれかに接続マクロと切断マクロが必要な場合は、ホスト端末を使用してそれらのマクロを記録します。次に、接続エディターを使用して、影響を受ける接続をそれぞれ更新し、その接続で使用する接続マクロと切断マクロの名前を指定します。接続マクロと切断マクロの記録については、「HATS ユーザーと管理者のガイド」を参照してください。
  6. 統合オブジェクトをまだ作成していない場合は、「HATS EJB プロジェクト表示」からホスト・アプリケーションへ接続し、「HATS ユーザーと管理者のガイド」の指示に従って統合オブジェクトを作成します。
  7. 必要な接続、マクロ、統合オブジェクトがすべて HATS EJB プロジェクトに含まれている場合は、EJB Access Beans をターゲット HATS プロジェクトにエクスポートできます。そのためには、「HATS EJB プロジェクト表示」で EJB プロジェクト内の任意の統合オブジェクトを右マウス・ボタンでクリックし、「HATS プロジェクトへの EJB Access Bean のエクスポート」を選択します。次に、ターゲット HATS プロジェクトと、EJB Access Beans を作成する統合オブジェクトを選択します。
  8. これで、ターゲット HATS プロジェクト内に作成した EJB Access Beans を処理できるようになりました。EJB Access Beans は、ターゲット HATS プロジェクトのソース・フォルダー、IntegrationObject パッケージ、io-name_Access.java というパターンの名前を持つファイル内にあります。EJB Access Bean を実行する HATS ビジネス・ロジックを作成することもできます。プロセスは、ビジネス・ロジックの追加で説明されているビジネス・ロジックからの統合オブジェクトの実行と同じです。Rational SDP 機能を使用すると、JSP ページへの「Bean の挿入 (Insert Beans)」および「Bean から結果を挿入 (Insert Results from Beans)」が可能になります。EJB Access Bean から直接 HATS モデル 1 ページや Struts Web ページを生成することはできません。
  9. 「HATS スタートアップ・ガイド」の説明に従って、Enterprise Archive (EAR ファイル) にプロジェクトをアセンブルします。WebSphere Application Server にそれを配置します。

自分で作成した Java コードで EJB Access Bean を使用することもできます。自分で作成したコードでの EJB Access Bean の使用については、EJB Access Beans のプログラミングを参照してください。

EJB Access Bean は、統合オブジェクト内に記録され作成されたマクロに基づいて作成されます。統合オブジェクトのシグニチャーを変更するような方法でマクロを変更して HATS EJB プロジェクトを再配置した場合は、一致する EJB Access Bean を再エクスポートして、それらを使用するコードまたは JSP を変更する必要があります。

リポジトリーへの HATS EJB プロジェクトの保管

CVS などのリポジトリーに HATS EJB プロジェクトを保管する場合、一部のディレクトリーは保管されません。これらのディレクトリーの内容は手動で格納する必要があります。プロジェクトを格納した後、次のディレクトリー内のすべてのファイルも格納する必要があります。HATS EJB プロジェクトがプロジェクト交換ファイルとして格納される場合、これらのファイルは含まれません。

EJB Access Beans の自動作成

HATS プロジェクトでないプロジェクト内の EJB Access Beans をより簡単に使用するには、HATS プリファレンス・ページでの「統合オブジェクトの作成時に HATS EJB プロジェクトに EJB Access Bean を自動的に生成」プリファレンスを参照します。

このプリファレンスをクリックすると、統合オブジェクトの作成のたびに EJB Access Bean が HATS EJB プロジェクト内に作成されます。「マクロ保存時に統合オブジェクトを自動的に生成」プリファレンスを選択した場合は、マクロの作成または変更時に統合オブジェクトと共に EJB Access Bean が作成されます。

これによって、HATS プロジェクトへのエクスポートなしに、他のプロジェクトへ直接 EJB Access Bean をコピーすることができます。他のプロジェクトに EJB 参照および EJB 環境変数を追加するには、引き続き、Java アプリケーション・クライアントでの EJB Access Bean の使用にリストされているステップに従う必要があります。

プロジェクトのマイグレーション時には、EJB Access Beans は自動的に作成されません。

HATS プリファレンスの使用について詳しくは、「HATS ユーザーと管理者のガイド」を参照してください。

EJB Access Beans のプログラミング

HATS Toolkit の HATS EJB プロジェクト内で統合オブジェクトを作成すると、EJB サポート・ファイルが生成されます。生成されるファイルの 1 つが EJB Access Bean です。EJB Access Bean は、Access Bean がサポートする統合オブジェクトと同じシグニチャーを持つ Java Bean です。アプリケーションは EJB Access Bean を使用して、HATS EJB アプリケーションに組み込まれている統合オブジェクトと対話します。

EJB Access Bean メソッドの使用

HATS 統合オブジェクトには、統合オブジェクトを使用してプログラミングするときに使用できる Java メソッドが含まれています。これらのメソッドは、EJB Access Beans でプログラミングを行う際にも使用できます。EJB Access Beans でプログラミングを行う場合は、統合オブジェクトのメソッドに記載されているメソッドに加えて、次のメソッドも使用できます。

java.lang.Object getHPubAccessHandle()
これは、統合オブジェクト・チェーンに対応する HATS EJB インスタンスのハンドルを戻します。
void setHPubAccessHandle(java.lang.Object value)
これは、統合オブジェクト・チェーンに対応する HATS EJB インスタンスのハンドルを設定します。

EJB Access Bean のチェーニング

チェーニングされた統合オブジェクトをサポートするため、HATS EJB はステートフル・セッション Bean としてインプリメントされています。HATS EJB インスタンスのライフ・サイクルは、統合オブジェクト・チェーンの処理と一致します。統合オブジェクト・チェーンの EJB Access Beans が処理される場合、2 つの EJB Access Bean プロパティーが使用されます。

hPubAccessHandle
これには、統合オブジェクト・チェーンに対応する HATS EJB インスタンスのハンドルが組み込まれます。
hPubLinkKey
これには、統合オブジェクト・チェーンの接続を表すキーが組み込まれます。
Web コンテナーでの EJB Access Bean のチェーニング

Web モジュール内で EJB Access Beans が doHPTransaction メソッドによって使用される場合、EJB Access Bean はクライアント・セッションに関連付けられた HttpSessionObject に、hPubAccessHandle プロパティーおよび hPubLinkKey プロパティーの値を保存します。統合オブジェクト・チェーンを処理する際、プロパティーは後続の EJB Access Beans によって検索されます。

チェーン内の最初の統合オブジェクトの EJB Access Bean は、HATS EJB のインスタンスを作成します。そのインスタンスは、チェーン内の後続の統合オブジェクトの EJB Access Beans すべてに対して使用されます。チェーン内の最後の統合オブジェクトの EJB Access Bean が処理されると、その統合オブジェクト・チェーンに対応する HATS EJB インスタンスは削除されます。したがって、Web モジュール内で EJB Access Beans に対して doHPTransaction メソッドを使用した場合、チェーニングは EJB Access Beans 内で管理されます。

Web コンテナー外での EJB Access Bean のチェーニング

EJB Access Bean が Web コンテナー外部で (例えば、Java プログラムから直接) 処理される場合、呼び出し側プログラムは hPubAccessHandle プロパティーと hPubLinkKey プロパティーの値を検索する必要があります。プロパティーは、チェーン内の最初の統合オブジェクトの EJB Access Bean が処理された後に検索されます。呼び出し側プログラムは、統合オブジェクト・チェーン内の後続の EJB Access Beans すべてに対して、それらが処理される前に 2 つのプロパティーを設定する必要があります。

Web コンテナー外で EJB Access Beans をチェーニングするには、次の手順を実行します。

  1. コンストラクターを呼び出して、チェーン内の最初の EJB Access Bean のインスタンスを作成します。
  2. EJB Access Bean インスタンスの setter メソッドを呼び出して、入力変数のプロパティーを設定します。setter メソッドの命名規則は次のとおりです。
    EJBChain1.setXyz(String)
    ここで、Xyz は入力変数の名前です。
  3. EJB Access Bean を起動し、次のメソッドを使用して、マクロの実行などのタスクを実行します。
    EJBChain1.processRequest()
  4. 次のメソッドを呼び出して、エラーがないか検査します。
    EJBChain1.getHPubErrorOccurred()
  5. EJB Access Bean チェーンの接続を表すキーを抽出して保存します。
    String myLinkkey = EJBChain1.getHPubLinkKey();
  6. 統合オブジェクト・チェーンに対応する HATS EJB インスタンスのハンドルを抽出して保存します。
    Object myHandle = EJBChain1.getHPubAccessHandle();
  7. コンストラクターを呼び出して、チェーン内の次の EJB Access Bean のインスタンスを作成します。
  8. このチェーニングされた接続のキーを設定します。
    EJBChain2.setHPubLinkKey(myLinkkey);
  9. このチェーニングされた接続のハンドルを設定します。
    EJBChain2.setHPubAccessHandle(myHandle);
  10. この EJB Access Bean インスタンスのメソッドを呼び出します。必要に応じて、入力変数のプロパティーを設定するメソッドを呼び出します。setter メソッドの命名規則は次のとおりです。
    EJBChain2.setXyz(String)
    ここで、Xyz は入力変数の名前です。
  11. この EJB Access Bean を起動してタスク (マクロの実行やデータベースの照会など) を実行するには、次のメソッドを使用します。
    EJBChain2.processRequest()
  12. 次のメソッドを呼び出して、エラーがないか検査します。
    EJBChain2.getHPubErrorOccurred()

チェーン内の後続の EJB Access Beans すべてに対して、ステップ 7 から 12 までを繰り返します。

Java アプリケーション・クライアントでの EJB Access Bean の使用

WebSphere では、Java アプリケーション・クライアントは次のモデルから構成されます。

これらのクライアント・モジュールについて詳しくは、WebSphere インフォメーション・センターの資料を参照してください。

以下のセクションでは、 Java EE アプリケーション・クライアントの使用を選択したことを想定しています。 Java シン・アプリケーション・クライアントを使用している場合、WebSphere インフォメーション・センターで、ご使用の WebSphere リリースに該当する指示を調べてください。

HATS は、WebSphere Application Server V6、V6.1、および V7.0 をサポートしています。Java アプリケーション・クライアントで EJB Access Bean を使用するには、次の手順を実行します。

  1. 1 つ以上のマクロ、統合オブジェクト、およびその他のリソースを含む HATS EJB プロジェクトと、HATS EJB プロジェクトから EJB Access Bean をエクスポートした HATS プロジェクトを起動します。
  2. ご使用のバージョンおよびエディションの WebSphere Application Server のインフォメーション・センターの説明に従って、Java EE アプリケーション・クライアントを作成します。これらの指示に従うには、メイン・クラスおよびデプロイメント記述子の生成を選択します。 この新規プロジェクトを、HATS EJB プロジェクトと同じ Enterprise Archive (EAR ファイル) に置きます。これらの jar ファイルを従属 jar として追加します。
  3. EJB Access Beanをアプリケーション・クライアント・プロジェクトに移動します。EJB Access Bean が保持されている IntegrationObject フォルダーを HATS プロジェクトからアプリケーション・クライアント・プロジェクトの appClientModule ディレクトリーへコピーします。
  4. ご使用のアプリケーション・クライアントに生成されたメイン・クラスでテスト・クライアントを作成するには、EJB Access Bean をインスタンス化するコードを実装し、それを実行します。
  5. Java EE アプリケーション・クライアントを使用している場合は、クライアント・デプロイメント記述子に EJB 参照および環境変数を追加します。
    1. META-INF¥application-client.xml を開きます。
    2. アプリケーション・クライアント記述子エディターの「設計」タブで Client 以下を実行します。
      1. 「追加」をクリックし、環境変数の追加を次のように選択します。
        • 名前: EJB Access Bean 内の HPUBEJB2_REFERENCE ストリングの最後の部分の値をこのフィールドにコピーします。例えば、HPUBEJB2_REFERENCE1318657356 です。
        • タイプ: java.lang.String
        • 値: ejb/ejb_project_name。ここで、ejb_project_name は HATS EJB プロジェクトの名前です。
      2. 「追加」をクリックし、EJB 参照の追加を次のように選択します。
        • EJB 参照名: ejb ejb_project_name。ここで ejb_project_name は、HATS EJB プロジェクトの名前です。
        • EJB 参照タイプ: セッション
        • ホーム: com.ibm.HostPublisher.EJB.HPubEJB2Home
        • リモート: com.ibm.HostPublisher.EJB.HPubEJB2
        • EJB リンク: ejb_project_name.jar# ejb_project_name。ここで、ejb_project_name は HATS EJB プロジェクトの名前です。
  6. EAR ファイルをテスト・サーバーに公開します。
  7. アプリケーション・クライアントをテストします。
    1. Debug パースペクティブを開きます。
    2. アプリケーション・サーバーを始動します。
    3. 「デバッグ」ドロップダウン・リストをクリックして「デバッグ」を選択し、作成した Java EE アプリケーション・クライアントのテスト環境を定義および開始します。
      1. 「WebSphere Application Client」をクリックします。
      2. 「新規」をクリックします。
      3. 「アプリケーション」タブへ移動して、フィールドに入力します。
        • 「名前」フィールドに、アプリケーション・クライアントに固有のテスト構成の名前を入力します。
        • WebSphere サーバー・タイプを選択します。
        • アプリケーション・クライアントがある EAR を選択します。
        • アプリケーション・クライアント・モジュールを選択します。
        • アプリケーション・クライアントがサーバーに接続し、特定のサーバーかプロバイダー URL のいずれかを選択できるようにします。
        • 「適用」をクリックします。
        • 「デバッグ」をクリックしてテスト環境を始動します。コンソールにテスト・クライアントの出力が表示されます。
  8. アプリケーション・クライアントをエクスポートします。「ナビゲーター」ビューで、アプリケーション・クライアント・プロジェクトの名前を右マウス・ボタンでクリックし、「エクスポート」を選択します。EAR ファイルとしてエクスポートします。

アプリケーション・クライアントの実行

前のセクションの手順を完了したら、次の手順に従ってアプリケーション・クライアントを実行します。

  1. EAR ファイルをアプリケーション・クライアントの bin ディレクトリーにコピーします。
  2. コマンド・プロンプトを開いて、Run launchClient ejb_project_nameEAR と入力します。ここで、ejb_project_name は、アプリケーション・クライアントの bin ディレクトリーにコピーした EAR ファイルの名前です。これにより、アプリケーション・クライアントが実行されます。予期した出力が表示されない場合は、launchClient.bat を調べて、DEFAULTSERVERNAME がテスト・サーバーに設定されていて、SERVERPORTNUMBER がテスト・サーバーのブートストラップ・ポートに設定されていることを確認してください。デフォルトのブートストラップ・ポートは 2809 ですが、WebSphere の構成によって異なる場合があります。ブートストラップ・アドレスはブートストラップ・ホストとブートストラップ・ポートの組み合わせで、間にコロン (:) が入ります。 WebSphere Application Server のブート・ストラップ・ポートを見つけるには、WebSphere 管理コンソールを開き「サーバー」>「アプリケーション・サーバー」> servername >「ポート」>「ブートストラップ・アドレス (BOOTSTRAP ADDRESS)」で探します。

クラスター化環境での EJB アプリケーション・クライアントの実行

クラスター化環境で EJB アプリケーション・クライアントを実行するには、2 つのオプションがあります。