ビジネス・コンポーネントに固有のJSPイベントを処理するコンポーネントを挿入するために使用します。
JSP構文
<jbo:DataHandler
appid="appModuleInstance"
[ relativeUrlPath="component's JSP page | DataHandlerComponent.jsp" ]
/>
説明
<jbo:DataHandler>
コンポーネントは、next、previousおよびdeleteなどのJSPビジネス・コンポーネント固有のイベントを処理します。DataHandlerコンポーネントは、<jbo:OnEvent>
データ・タグを使用して各イベントを処理します。ビジネス・コンポーネントのイベント処理を自動的に行う場合は、イベントを受け取るJSPページの先頭にDataHandlerコンポーネント・タグを挿入します。生成されたイベントは、DataHandlerコンポーネントを挿入したページと同じページまたは一意のターゲット・ページで処理できます。
属性
<jbo:ApplicationModule>
データ・タグで定義されたアプリケーション・モジュールのid。
relativeUrlPath: (オプション)コンポーネント・タグを実装するJSPファイルの場所。デフォルトでは、JDeveloperが提供するファイルDataHandlerComponent.jsp
が参照されます。コンポーネントの動作をカスタマイズするために作成するコンポーネント実装.jsp
ファイルの名前を指定できます。また、名前を編集してカスタマイズ済の既存のコンポーネント実装.jsp
ファイルを参照できます。
作成または参照するファイルがプロジェクト・ディレクトリsite
(mywork
フォルダ内)のサブディレクトリにある場合は、相対パスを指定する必要があります。たとえば、カスタム・コンポーネント実装ファイルMyDataHandlerComponent.jsp
をsite
フォルダのサブディレクトリcomponents
に作成した場合、relativeUrlPathの値は/components/MyDataHandlerComponent.jsp
になります。
例
次の例では、バインド先のアプリケーション・モジュール・セッションのイベントを処理します。この例では、DataHandlerのターゲットはこのコンポーネントを使用するJSPです。
<jbo:ApplicationModule id="am" configname="mypackage.MypackageModule.MypackageModuleLocal"
releasemode="Stateful" />
<jbo:DataSource id="LocationsView" appid="am" viewobject="LocationsView"/>
<jbo:DataHandler appid="am" />
Copyright © 1997, 2009, Oracle. All rights reserved.