ビジネス・コンポーネントのイベント・タグ - <jbo:FormEvent>

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>データ・タグを参照してください。

属性

この例では、「ビジネス・コンポーネント」の「更新」イベントをデータ・ソースおよび追加情報としての行キーを使用して生成します。

<%@ 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 />