送信ページのHTMLフォーム要素のリクエスト・オブジェクトにJSPイベントを追加します。
JSP構文
<jbo:FormEvent
event="eventName"
[ datasource="datasourceName" ] | [ viewobject="viewobjectName" ]
[ addrowkey='true'| 'false']
/>
説明
<jbo:FormEvent>データ・タグは、JSPイベントを指定する特別なリクエスト・パラメータをJSPページで送信できます。次のイベントを送信できます。
FormEventデータ・タグは、JSPページのHTMLフォーム要素内で使用します。JSPページは、FormEventデータ・タグで指定された属性値から次の2つのリクエスト・パラメータを作成します。
jboEvent="eventname"
jboEventVo="viewobjectname"
ここで、ビュー・オブジェクト名はオプションです。リクエスト・パラメータを使用して送信するイベントは、ターゲットJSPページのビュー・オブジェクトに適用され、そのページの対応する<jbo:OnEvent>データ・タグの本体で処理されます。FormEvent属性でビュー・オブジェクト名を指定しない場合、イベントはターゲットJSPページのデータソース内のすべてのビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに適用する場合は、次のいずれかの処理を行います。
または
注意: ターゲットJSPページには、受け取ったイベントを処理する<jbo:OnEvent>データ・タグが含まれている必要があります。イベント処理の詳細は、<jbo:OnEvent>データ・タグを参照してください。
HTMLフォーム要素内では、次の2つの例は同じ意味です。
<jbo:FormEvent event="Commit" viewobject="myViewObject">
および
<input name="jboEvent" type="hidden" value="Commit" />
<input name="jboEventVo" type="hidden" value="myViewObject" />
ターゲットJSPページは、送信JSPページのリクエスト・オブジェクトから受け取った2つの特別なイベント・パラメータを処理する必要があります。これらのフォーム・パラメータの値が<jbo:OnEvent>データ・タグ内の識別子と一致した場合、OnEventデータ・タグの本体がターゲット・ページで実行されます。詳細は、<jbo:OnEvent>データ・タグを参照してください。
属性
FirstSet
、NextSet
、PreviousSet
およびLastSet
First
、Next
、Previous
およびLast
Update
、Delete
、Commit
およびRollback
viewobject
属性でビュー・オブジェクト名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。datasource
属性でデータソース名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
注意: アプリケーション・モジュールで定義された既存のビュー・オブジェクト、またはCreateViewObjectデータ・タグを使用して作成したビュー・オブジェクトを指定できます。ネストされたアプリケーション・モジュールにビュー・オブジェクトが含まれている場合、appmodNested.viewobjectName
のように、ビュー・オブジェクト名をアプリケーション・モジュール名とともに指定する必要があります。
例
この例では、追加情報としてデータソースおよび行キーを使用してビジネス・コンポーネントのUpdateイベントを生成します。
<%@ 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 />