この章では、ホスト・アプリケーションとの対話をカプセル化する Java™ Beans である、統合オブジェクトについて説明します。統合オブジェクトをサポートしているのは、HATS ポートレットなど、HATS Web アプリケーションのみです。
IBM® WebSphere® Host Publisher を使用したことがあれば、統合オブジェクトの性質の多くについては理解されているでしょうが、その場合でも、統合オブジェクトが HATS でどのように使用されるかを理解する必要があります。HATS で統合オブジェクトを作成したり使用するには、経験豊富な Host Publisher 開発者である必要はありません。
ご使用の HATS アプリケーションが単一のホスト・アプリケーションを変換するものであり、2 次的な接続を使用しない場合は、統合オブジェクトを使用する必要はありません。次の条件のいずれかに該当する場合には、統合オブジェクトを使用する必要がある場合があります。
統合オブジェクトを作成すると、これを次のようなさまざまな用法で使用できます。
統合オブジェクトを使用して実行できるその他の高度なタスクについては、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。次のようなタスクについての説明があります。
統合オブジェクトは、マクロから作成します。マクロとホスト端末のステップに従って、マクロを記録してください。
「HATS プロジェクト」ビューでマクロを右クリックして、「統合オブジェクトの作成」を選択します。統合オブジェクトは、マクロと同じ名前になります。マクロを記録すると統合オブジェクトが自動的に生成されるように、HATS のプリファレンスを設定することもできます。「ウィンドウ (Window)」>「プリファレンス」をクリックし、左側のツリーで「HATS」を展開し、「統合オブジェクト」をクリックします。「マクロ保存時に統合オブジェクトを自動的に生成」というラベルの付いたボックスを選択して、「適用」をクリックします。
統合オブジェクトの作成に使用するマクロに命名するときは、必ず以下の要件に従ってください。
チェーニングされたマクロから統合オブジェクトを作成することはできません。統合オブジェクト・チェーニングの場合、チェーン内の各統合オブジェクトの実行が完了してから次の統合オブジェクトに制御が渡されるので、マクロのチェーニングとはまったく異なります。マクロのチェーニングでは、HATS の「マクロを実行」アクションを使用して、現在のマクロ (「マクロを実行」アクションが発生したマクロ) を終了し、ターゲット・マクロの指定されたマクロ画面の処理を開始します。<playmacro name="chainedMacroName"/> タグを含む Host On-Demand マクロをインポートした場合、このマクロは HATS の「マクロを実行」アクションおよび「マクロ・トランザクションを実行」アクションのみに使用できます。マクロのチェーニングについて詳しくは、「HATS 拡張マクロ・ガイド」を参照してください。
あるマクロから統合オブジェクトが作成された後で、マクロ・エディターを使用してそのマクロを変更した場合、この変更を正確反映させるには、その統合オブジェクトを再生成する必要があります。「マクロ保存時に統合オブジェクトを自動的に生成」プリファレンスを選択した場合、統合オブジェクトは自動的に更新されます。
作成した統合オブジェクトのリストを表示するには、HATS Toolkit の「HATS プロジェクト」表示タブをクリックし、プロジェクト名を展開します。次に、「ソース」>「統合オブジェクト」の順に移動し、フォルダーをダブルクリックして中身を表示します。
統合オブジェクト・チェーニングを使用すると、複数の統合オブジェクトを作成し、これらをご使用の Host Access Transformation Services アプリケーション内で単一のメジャー・タスクにグループ化できます。各統合オブジェクトが 1 つのサブタスクを実行し、統合オブジェクト・チェーンがメジャー・タスクを実行します。アプリケーションが実行されると、同じ接続を使用して、統合オブジェクトが順々に実行されます。
マクロを右マウス・ボタンでクリックして統合オブジェクトを作成するときに、「チェーニングされた統合オブジェクトの作成」を選択します。次に、その統合オブジェクトをチェーン内の最初のオブジェクトにするか、中間のオブジェクトにするか、最後のオブジェクトにするかを指定します。チェーン内には、複数の中間統合オブジェクトを置くことができます。この統合オブジェクトの開始状態および停止状態を示すラベルを入力します。チェーン内の最初の統合オブジェクトには開始状態ラベルがなく、チェーン内の最後の統合オブジェクトには停止状態ラベルがありません。状態ラベルは、チェーン内の統合オブジェクトが正しい順番で処理され、そのつど正しいデータが渡されることを保証する必要があります。
このセクションでは、統合オブジェクト・チェーニングについて詳しく説明し、HATS アプリケーション内で統合オブジェクト・チェーニングを使用する方法を示します。
チェーン内にいくつの統合オブジェクトが必要かを判断するには、まず、実行する必要があるサブタスクをすべてリストします。例えば、fileview という名前のホスト・アプリケーションがあり、このホスト・アプリケーションを起動すると、ファイルのリストが表示されるとします。ユーザーは、ファイル名の横に「1」と入力し、Enter を押して、その中身を表示することにより、ファイルのリストから任意のファイルを選択できます。実行する作業は次の 2 つです。
2 つのマクロが必要です。なぜなら、2 番目のマクロを実行する前にユーザーの判断が必要なためです。2 番目のマクロは、ユーザー入力を待機する必要があります。ユーザー入力が必要な場所を定義するのが、複数のタスクを個々の統合オブジェクトに分離するための最初のステップです。
ユーザーの選択肢が複数ある場合、それぞれの選択によって引き起こされるホスト・アクションが異なるときは、それぞれの選択は別個の統合オブジェクトでなければなりません。その後、ユーザーの選択に基づいて、これらの統合オブジェクトを動的に組み合わせることができます。例えば、5 つの項目からなるメニューがあるとします。5 つの選択項目の中からユーザーが任意に選択できる場合、それぞれの選択は独立した統合オブジェクトでなければなりません。
アプリケーション内に別個のタスクがいくつあるかわかったら、アプリケーションに対するチェーニングの影響を判断できます。3 つ以上のタスクがある場合は、チェーニングを使用することにより、アプリケーションの応答時間を改善したり、実行する必要があるマクロ記録の量を減らして統合オブジェクトの全体的な複雑さを減らすことができます。
チェーン内の統合オブジェクトは、接続を (ある画面で) ある状態にします。統合オブジェクトが実行を終了したら、その状態で (つまり、その画面で) 開始する別の統合オブジェクトが実行できます。
チェーニングを使用すると、複雑なアプリケーションを複数のタスクに分割できます。各タスクは 1 つの統合オブジェクトによって表現されます。統合オブジェクトの順序を正しく指定する必要があります。
例えば、あるチェーンに 3 つの統合オブジェクト (A、B、および C) がある場合、最初に A を使用し、次に B を使用し、最後に C を使用する必要があるとします。統合オブジェクト B よりも先に統合オブジェクト C が呼び出された場合、C がその接続を要求したときに接続が正しい状態で使用可能になっていないと、この統合オブジェクトは失敗します。

図 64は、3 つの統合オブジェクトの実行全体を通しての接続の存続時間を示しています。統合オブジェクト A が最初で、統合オブジェクト B が中間で、統合オブジェクト C が最後として構成されています。接続状態データは、最後の統合オブジェクトの実行の接続および状態ラベルを表します。
HATS で統合オブジェクト・チェーニングを使用してアプリケーションを構築するには、最初に統合オブジェクトを構築し、そのあとで、統合オブジェクトから Web ページを作成する必要があります。
以下のステップに従って、アプリケーションを作成してください。
HATS ホスト端末を使用して、HATS Toolkit にマクロを記録することができます。そのためには、HATS ホスト端末画面で、「マクロの記録」アイコンをクリックします。マクロの記録については、マクロ関連アイコンを参照してください。
作成するそれぞれの統合オブジェクトごとに、これらのステップを実行します。
個々のマクロを右マウス・ボタンでクリックし、「チェーニングされた統合オブジェクトの作成」を選択します。オブジェクト・チェーン内での位置を、「最初」、「中間」、「最後」の中から選択できます。「最初」を選択した場合、統合オブジェクト・チェーニングの構成時の状態は停止状態になります。「中間」を選択した場合、状態は開始状態または停止状態になります。オブジェクト・チェーンの「最後」の位置では、開始状態を使用します。
チェーンを構成するすべての統合オブジェクトについて、この作業を行う必要があります。
統合オブジェクト・チェーニングは、非常に複雑なホスト・アプリケーションをモデル化するための強力なツールですが、アプリケーションをアセンブルする際には注意が必要です。間違った順番で統合オブジェクトが呼び出される Java EE アプリケーションを作成してしまう恐れがあるため、このような事態が発生したときにサーバー上にどのようなエラーが表示されるかを認識している必要があります。
統合オブジェクトを間違った順番でチェーニングすると、統合オブジェクトを実行したときに問題が発生します。以下に、サーバー上に表示される可能性のあるエラー・メッセージおよびそのデバッグ方法を示します。
この状況が発生した場合は、統合オブジェクトが間違った順番で呼び出された原因を判別してください。
任意の統合オブジェクトから JSP を作成できます。JSP を構築するには、モデル 1、JSF、および Struts という、3 つの方法があります。以下のセクションでは、これらの 3 つの方法について説明し、これらを使用してページを作成する方法を示します。
JSP を構築する HATS の従来の方法はモデル 1 と呼ばれます。
このモデルでは、単一の JSP に以下のものが含まれています。
「HATS プロジェクト」ビューで、統合オブジェクトの名前を右クリックして、「モデル 1 Web ページの作成」を選択します。入出力ページ名と宛先を指定するか、あるいは統合オブジェクト名に基づいて作成されたデフォルト名を受け入れます。「既存ファイルへの付加」または「既存ファイルの上書き」を選択して、「ページ生成オプション」を指定することもできます。選択が終わったら、「次へ」をクリックします。
モデル 1 Web ページを作成する場合は、2 つのページを定義します。統合オブジェクトに必要なデータを収集する入力ページと、統合オブジェクトの実行後に結果を表示する出力ページです。
「入力の定義」ページで、各入力プロパティーの入力コントロールを定義できます。 コントロールを変更するには、入力プロパティーを選択し、「編集」をクリックします。 コントロールに先行テキストを追加し、必要な場合は、選択したコントロールを構成できます。入力コントロールを使用する代わりに、入力プロパティーをグローバル変数の値に設定することを選択できます。オプションで、入力プロパティー値をグローバル変数として格納できます (統合オブジェクトが使用するグローバル変数は共用されます)。 入力ページを実行すると、出力ページに制御が直接渡されるのではなく、HATS アプリケーションに制御が戻るため、これによってグローバル変数の設定やその他のアクションを必要に応じて行うことができます。
「出力の定義」ページで、表示する統合オブジェクトの出力プロパティーを選択します。コントロールを変更するには、出力プロパティーを選択し、「編集」をクリックします。 コントロールに先行テキストを追加できます。 出力 JSP には、統合オブジェクトの初期化、グローバル変数からの統合オブジェクトのプロパティーの設定、統合オブジェクトの実行、および統合オブジェクト出力の表示を行うためのコードが含まれます。
ユーザーが作成するページは、「HATS プロジェクト」ビューの「Web Content/Model 1 Pages」フォルダーに入ります。 Web ページの編集と Page Designer の起動を行うには、ページ名をダブルクリックします。ページをテストするには、入力ページ (入力がない場合は出力ページ) を右クリックし、「サーバーでデバッグ」または「サーバーで実行」のいずれかを選択します。
SignOn.setHPubStartPoolName("<new_project_name>/<default_connection>");Rational® SDP の Struts ツール・フィーチャーをインストール済みの場合、HATS では、統合オブジェクトに基づく Web ページを作成するために Struts を使用できるようにします。
「HATS プロジェクト」ビューで、統合オブジェクトの名前を右クリックして、「Struts Web ページの作成」を選択します。入力ページと出力ページの名前を指定するか、統合オブジェクト名に基づいて作成されるデフォルトの名前を受け入れます。「完了」をクリックします。
Struts Web ページを作成すると、次の 5 つの新規ファイルが HATS により生成されます。
また、HATS は、Action クラスに ActionForm クラスを関連付けるために、struts-config.xml ファイルにアクション・マッピングを追加します。
Struts は、The Apache Software Foundation の Jakarta プロジェクトの一環として開発されました。Struts の詳細については、http://jakarta.apache.org/struts および Rational SDP のヘルプ目次を参照してください。
JavaServer Faces (JSF) は、Java サーバーで実行する Web アプリケーション用のユーザー・インターフェース (UI) を開発するためのフレームワークです。再使用可能な UI コンポーネントをページでアセンブルすることにより、Web アプリケーションをすぐに構築できます。JSF Web ページを作成すると、Page Designer やパレットなどのツールを使用して変更や編集を行うことができます。
「HATS プロジェクト」ビューで、統合オブジェクトの名前を右クリックして、「JSF Web ページの作成」を選択します。入力ページと出力ページの名前、および宛先を指定するか、統合オブジェクト名に基づいて作成されたデフォルトの名前を受け入れます。「既存ファイルの上書き」チェック・ボックスを選択して、既存のファイルを上書きすることもできます。選択が終わったら、「次へ」をクリックします。
JSF Web ページを作成する場合は、2 つのページを定義します。統合オブジェクトに必要なデータを収集する入力ページと、統合オブジェクトの実行後に結果を表示する出力ページです。
入力ページの場合、各入力プロパティーの入力コントロールを定義できます。コントロールを変更するには、入力プロパティーを選択し、「編集」をクリックします。コントロールに先行テキストを追加し、必要な場合は、選択したコントロールを構成できます。「次へ」をクリックします。
出力ページの場合、表示する統合オブジェクトの出力プロパティーを選択します。コントロールを変更するには、出力プロパティーを選択し、「編集」をクリックします。コントロールに先行テキストを追加できます。「完了」をクリックします。
ユーザーが作成するページは、「HATS プロジェクト」ビューの「Web Content/JSF Pages」フォルダーに入ります。 Web ページの編集と Page Designer の起動を行うには、ページ名をダブルクリックします。ページをテストするには、入力ページ (入力がない場合は出力ページ) を右クリックし、「サーバーでデバッグ」または「サーバーで実行」のいずれかを選択します。
BasicIOErrorPage は、統合オブジェクトを起動する JSP が使用するデフォルトのエラー・ページです。エラーが発生した場合、エラーの性質に関する基本的な情報がブラウザーに戻されます。この処理では、バックエンド接続は自動的に廃棄されます。
デフォルトの接続定義に基づいて接続が作成された場合、AdvancedIOErrorPage.jsp により、デフォルトの変換の HATS エントリー・サーブレットに接続が渡されます。この処理により、バックエンド接続との対話が可能になり、発生したエラーを特定できる可能性があります。デフォルトの変換の場合は、接続を切断することもできます。統合オブジェクトでエラーが発生した場合、基本的に AdvancedIOErrorPage.jsp により、ユーザーが処理を制御できる範囲が広がります。
これらのエラー・ページは、プロジェクトの「Web コンテンツ」フォルダーにある「ナビゲーター」ビューで参照できます。
以下に示す HATS ツールの機能は、JSP で統合オブジェクトを使用する場合に適用されます。以下に示す項目は、HATS Toolkit メニュー・バーの「HATS ツール」メニューから選択できます。
統合オブジェクトの入出力を変換 JSP に追加できます。
統合オブジェクトの入力を JSP に追加するときは、「統合オブジェクト・プロパティーを挿入」>「入力」を選択します。「統合オブジェクト・クラスの選択」ページで、使用する統合オブジェクトのクラス名、およびユーザーが入力フォームを送信するときに表示される宛先ページを入力します。「次へ」をクリックします。「入力の定義」ページで、コントロールを変更するには、入力プロパティーを選択し、「編集」をクリックします。ここでは、先行テキストを定義したり、必要な場合は適切な入力コントロールを選択および構成したり、値をグローバル変数として保管したりできます。
統合オブジェクトの出力を JSP に追加するときは、「統合オブジェクト・プロパティーを挿入」>「出力」を選択します。「統合オブジェクト・クラスの選択」ページで、使用する統合オブジェクトのクラス名を入力し、チェック・ボックス「統合オブジェクトのトランザクション・メソッドを挿入します」をクリックして、統合オブジェクトを実行するトランザクション・メソッドを挿入します。「次へ」をクリックします。「出力の定義」ページで、コントロールを変更するには、出力プロパティーを選択し、「編集」をクリックします。ここで、先行テキストの定義、および適切な出力コントロールの選択を行うことができます。
HATS のグローバル変数には、ある HATS オブジェクトから別の HATS オブジェクトに情報を渡すために使用できる値が格納されます。統合オブジェクトの出力データを別の HATS オブジェクトに渡す場合は、統合オブジェクトを駆動するために使用する出力 JSP にコードを追加する必要があります。このコードは、統合オブジェクトが正常に実行された後で追加する必要があります。以下に例を示します。
<% IOGV.setGlobalVariableString(session, "exampleGV", exampleIO.getOutputData()); %>
この例では、共用グローバル変数 exampleGV に統合オブジェクト exampleIO の OutputData プロパティーの値が代入されます。
統合オブジェクト環境で使用するグローバル変数は、共用グローバル変数として定義する必要があります。この例のコードでは、共用グローバル変数が存在しない場合は、これが作成されます。
「HATS アプリケーションへの転送の挿入」は、JSP 制御情報をユーザーが起動した HATS アプリケーション (Web アプリケーションまたは標準ポートレットのいずれか) に戻すボタンを変換に追加するときに選択します。例えば、JSP によって統合オブジェクトが起動されて指定のタスクが実行されたら、HATS アプリケーションに制御を戻したい場合があります。このボタンの属性を変更するには、「設計 (Design)」ビューでボタンを強調表示し、右マウス・ボタンでクリックして「属性」を選択します。