Java Server Pages
手順 4 : 設計時 GUI の実装
8
設計時GUI
の開発用する接続パラ メ ータ、 イベン ト リ ス ト 、 サービ ス リ ス ト 、 ロ グ レベル、 およ びプールの設定が提供さ れます。 [Application View Summary] ページには、 各パ
ラ メ ータ が表示さ れます。
ユーザ レベルか ら見る と 、AbstractDesignTimeRequestHandlerに よ り 、 アダ プ タ全体に共通するすべてのア ク ショ ンに適用でき る実装が提供さ れます。 主な ア ク シ ョ ンは以下の と お り です。
アプ リ ケーショ ン ビ ューの定義
接続の コ ン フ ィ グ レーショ ン
注意
: ADK
には、 CCI 接続を設定する ための接続パ ラ メ ータ を処理する メ ソ ッ ド はあ り ますが、confconn.jspページは提供さ れません。 こ の
フ ォームの作成方法については、 8-35 ページの 「手順 5a :confconn.jsp フ ォームの作成」 を参照し て く だ さ い。
アプ リ ケーショ ン ビ ューのデプ ロ イ
アプ リ ケーショ ン ビ ュー セキ ュ リ テ ィ の定義
アプ リ ケーショ ン ビ ューの編集
アプ リ ケーショ ン ビ ューのアンデプロ イ
イ ン クルー ド する メ ソ ッ ド
こ れ ら のア ク シ ョ ンを正し く 実行するには、
AbstractDesignTimeRequestHandler
を実装する際に、 次の メ ソ ッ ド を指定す
る必要があ り ます。initServiceDescriptor();
こ の メ ソ ッ ド に よ り 、 設計時にアプ リ ケーショ ン ビ ューにサービ スが追加 さ れます （8-33 ページの 「手順 4b : initServiceDescriptor() の実装」 を参照し て
く だ さ い）。
initEventDescriptor();
こ の メ ソ ッ ド に よ り 、 設計時にアプ リ ケーショ ン ビ ューに イベン ト が追加 さ れます （8-34 ページの 「手順 4c : initEventDescriptor() の実装」 を参照し て
く だ さ い）。
AbstractDesignTimeRequestHandler
の具象実装のたびに、 次の 2 つの メ ソ ッ
ド を指定する必要があ り ます。手順
4 :
設計時GUI
の実装アダプ タの開発
8-33
protected String getAdapterLogicalName();
こ の メ ソ ッ ド に よ り 、 アダプ タの論理名が返さ れます。 こ れは、 アプ リ ケー シ ョ ン ビ ューをその名前でデプ ロ イ する 際に使用 さ れます。
protected Class getManagedConnectionFactoryClass();
こ の メ ソ ッ ド は、 アダプタ に対する SPI の ManagedConnectionFactory実 装ク ラ ス を返し ます。
手順 4a : ManagedConnectionFactory ク ラスの指 定
ManagedConnectionFactory ク ラ ス を指定するには、 次の メ ソ ッ ド を実装する 必要があ り ます。
protected Class getManagedConnectionFactoryClass();
こ の メ ソ ッ ド はアダプ タに対する SPI の ManagedConnectionFactory
実装 ク ラ
ス を返し ます。 こ の ク ラ スは、AbstractManagedConnectionFactoryが EIS へ の接続を試みる場合に必要です。手順 4b : initServiceDescriptor() の実装
サービ ス アダプ タについて、 アダプ タのユーザが設計時にサービ ス を追加でき る よ う に、initServiceDescriptor()を実装する必要があ り ます。 こ の メ ソ ッ ド は、 コー ド リ ス ト 8-5 のよ う に実装し ます。
コー ド リ ス ト
8-5 initServiceDescriptor()
の実装protected abstract void initServiceDescriptor(ActionResult result, IServiceDescriptor sd,
HttpServletRequest request) throws Exception
8
設計時GUI
の開発こ の メ ソ ッ ド は、AbstractDesignTimeRequestHandlerの addservc()の実装 に よ っ て呼び出さ れます。 こ の メ ソ ッ ド には、IServiceDescriptorパ ラ メ ータ に関連付け られた EIS 固有の情報を初期化する役割があ り ます。addservc()の 基本ク ラ スが、 エ ラー処理な ど を実行し ます。 ユーザが addservc
JSP
を発行す る と 、addservc() メ ソ ッ ド が呼び出さ れます。手順 4c : initEventDescriptor() の実装
イベン ト アダプ タは、 アダプ タのユーザが設計時に イベン ト を追加で き る よ う に、initEventDescriptor() を実装する必要があ り ます。 こ の メ ソ ッ ド は、
コー ド リ ス ト 8-6 の よ う に実装し ます。
コー ド リ ス ト
8-6
initEventDescriptor()の実装 protected abstract voidinitEventDescriptor(ActionResult result, IEventDescriptor ed,
HttpServletRequest request) throws Exception;
こ の メ ソ ッ ド は、AbstractDesignTimeRequestHandlerの addevent()の実装 に よ っ て呼び出さ れます。 こ の メ ソ ッ ド には、IServiceDescriptorパ ラ メ ータ に関連付け られた EIS 固有の情報を初期化する役割があ り ます。addevent()の 基本ク ラ ス を実装する こ と に よ り エ ラー処理な どの コ ンセプ ト に対応でき ます。
ユーザが addevent
JSP
を発行する と 、addevent() メ ソ ッ ド が呼び出さ れます。addeventには共通の ロ ジ ッ ク が含まれている こ と に加えて EIS 固有の ロ ジ ッ ク が initEventDescriptor()
に委託 さ れる ので、 オーバーラ イ ド し ないよ う に し
て く だ さ い。注意
:
サービ ス記述子にプ ロパテ ィ を追加する場合は、 Bean 属性の命名規約に 従って名前を割 り 当て る必要があ り ます。 こ れに従っていない場合、サービ ス記述子では、InteractionSpecは正し く 更新さ れません。