JSPイベントを発行中のページにあるHTML FORM要素のリクエスト・オブジェクトに追加します。
JSP構文
<jbo:FormEvent
event="eventName"
[ datasource="datasourceName" ] | [ viewobject="viewobjectName" ]
[ addrowkey='true'| 'false']
/>
説明
<jbo:FormEvent>
データ・タグを使用すると、JSPページで特定のリクエスト・パラメータを発行し、JSPイベントを識別できます。発行できるイベントは次のとおりです。
JSPページにあるHTML FORM要素内の<jbo:FormEvent>
データ・タグを使用します。JSPページでは、<jbo:FormEvent>
データ・タグで指定した属性値から、次の2つのリクエスト・パラメータを構成します。
jboEvent="eventname"
jboEventVo="viewobjectname"
ビュー・オブジェクトの名前はオプションです。リクエスト・パラメータとともに発行するイベントは、ターゲットJSPページのビュー・オブジェクトに適用され、そのページ内の対応する<jbo:OnEvent>
データ・タグの本体によって処理されます。FormEvent属性のビュー・オブジェクト名を省略すると、イベントは、ターゲットJSPページのデータ・ソース内にあるすべてのビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに適用する場合、次のことが可能です。
または
注意: ターゲットJSPページには、受信イベントを処理するために<jbo:OnEvent>
データ・タグを含める必要があります。イベントの処理に関する詳細は、<jbo:OnEvent>データ・タグを参照してください。
HTML FORM要素内では、次の2つが等価です。
<jbo:FormEvent event="Commit" event="myViewObject">
および
<input name="jboEvent" type="hidden" value="Commit" />
<input name="jboEventVo" type="hidden" value="myViewObject" />
ターゲットJSPページでは、発行中のJSPページのリクエスト・オブジェクトから特定のイベント・パラメータ2つを処理します。これらのFORMパラメータの値が<jbo:OnEvent>
データ・タグ内の識別子と一致する場合、OnEventデータ・タグの本体がターゲット・ページで実行されます。詳細は、<jbo:OnEvent>
データ・タグを参照してください。
属性
firstset
、nextset、previousset
、lastset
(行セット内の次の行セットへの移動用)
first
、next
、previous
、last
(行セット内の次の行への移動用)
Update
、Delete
、Commit
、Rollback
(データベース・トランザクションの実行用)
viewobject
属性にビュー・オブジェクトを指定する場合や、ターゲットJSPページの任意のビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
datasource
属性にデータソースを指定する場合や、ターゲットJSPページの任意のビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
注意: アプリケーション・モジュールによって定義されている既存のビュー・オブジェクトを指定するか、CreateViewObjectデータ・タグを使用して作成したビュー・オブジェクトを指定できます。ビュー・オブジェクトがネストされたアプリケーション・モジュールに含まれている場合、アプリケーション・モジュール名と組み合せたビュー・オブジェクト名(appmodNested.viewobjectName
)を指定する必要があります。
<jbo:OnEvent>
データ・タグの本体によって、特定の行に対するアクションを実行する必要がある場合、これを使用します。
例
この例では、「ビジネス・コンポーネント」の「更新」イベントをデータ・ソースおよび追加情報としての行キーを使用して生成します。
<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo" %>
<jbo:ApplicationModule id="am" configname="mypackage.MypackageModule.MypackageModuleLocal" releasemode="Stateless" /> <jbo:DataSource id="ds" appid="am" viewobject="EmpView" /> <form name="test" action="formSubmit.jsp" method="post"> Name: <jbo:InputText datasource="ds" dataitem="Ename" /> <jbo:FormEvent event="Update" datasource="ds" addrowkey="true" /> <input type="submit" value="Update"> </form> <jbo:ReleasePageResources />
Copyright © 1997, 2009, Oracle. All rights reserved.