イベントを送信するためのURLを作成する簡易タグです。
<jbo:UrlEvent
[ targeturl='targeturlName']
[ targeturlparam='paramName']
event='eventName'
[ datasource='datasourceName'] | [ viewobject='viewobjectName']
[ addrowkey='true'| 'false']
[ extraparameters='param=value'[& 'param=value'...] ]
/>
注意: 別のHTMLタグ内部でこのタグを使用する場合の構文エラーを防ぐため、<jbo:UrlEvent>
データ・タグの属性には一重引用符を使用してください。
<jbo:UrlEvent>
データ・タグは、JSPイベントを特定する特別なリクエスト・パラメータを使用してURLを作成します。次のイベントを送信できます。
<jbo:UrlEvent>
データ・タグは、URLを取得するHTMLタグの内部で使用します。 JSPページは、<jbo:UrlEvent>
データ・タグで指定された属性値から次の2つのリクエスト・パラメータを作成します。
jboEvent='eventname'
jboEventVo='viewobjectname'
ここで、ビュー・オブジェクト名はオプションです。 URLを使用して送信するイベントは、ターゲットJSPページのビュー・オブジェクトに適用され、そのページの対応する<jbo:OnEvent>
データ・タグ・ボディにより処理されます。 UrlEvent属性でビュー・オブジェクト名を省略した場合、イベントはターゲットJSPページのデータソース内の任意のビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに適用する場合は、次のいずれかの処理を行います。
または
注意: ターゲットJSPページには、受信イベントを処理するための<jbo:OnEvent>
データ・タグが含まれている必要があります。 イベント処理の詳細は、<jbo:OnEvent>
データ・タグを参照してください。
たとえば、<jbo:UrlEvent>
データ・タグをHREFタグの内部で使用する場合、次の2つのフォームは同じ意味です。
<a href="<jbo:UrlEvent targeturl='mytargetpage.jsp' event='Next' datasource='myViewObject'/>" >Click for next row.</a>
および
<a href="mytargetpage.jsp?jboEvent=Next&jboEventVo=myViewObject" >Click for next row.</a>
ターゲットJSPページは、送信JSPページからの2つの特別なイベント・リクエスト・パラメータを処理します。 これらの入力パラメータの値が<jbo:OnEvent>
データ・タグ内の識別子と一致した場合は、<jbo:OnEvent>
データ・タグ・ボディがターゲット・ページで実行されます。 詳細は、<jbo:OnEvent>
データ・タグを参照してください。
targeturlparam
属性を使用します)。
targeturl
属性で明示的に指定する場合は、この属性を省略できます。
FirstSet
、NextSet
、PreviousSet
およびLastSet
First
、Next
、Previous
およびLast
Update
、Delete
およびInsert
<jbo:DataSource>
タグを使用して作成します。 viewobject
属性でビュー・オブジェクト名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
datasource
属性でデータソース名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
注意: アプリケーション・モジュールで定義された既存のビュー・オブジェクト、または<jbo:CreateViewObject>
データ・タグを使用して作成したビュー・オブジェクトを指定できます。 ネストされたアプリケーション・モジュールにビュー・オブジェクトが含まれている場合は、appmodNested.viewobjectName
のように、ビュー・オブジェクト名をアプリケーション・モジュール名とともに指定する必要があります。
<jbo:OnEvent>
データ・タグ・ボディで特定の行に対して処理を実行する必要がある場合は、この属性を使用します。
次の例では、<jbo:UrlEvent>
データ・タグで指定されたデータソースに対するnextおよびfirstイベントを生成するリンクを表示します。 <jbo:OnEvent>
データ・タグは、これらのイベントを処理します。
<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo" %> <jbo:ApplicationModule id="am" configname="mypackage.MypackageModule.MypackageModuleLocal" releasemode="Stateful" /> <jbo:DataSource id="ds" appid="am" viewobject="EmpView" /> <jbo:OnEvent datasource="ds" name="next"> <jbo:RowsetNavigate datasource="ds" action="Next" /> </jbo:OnEvent> <jbo:OnEvent datasource="ds" name="first"> <jbo:RowsetNavigate datasource="ds" action="First" /> </jbo:OnEvent> <jbo:Row id="currentRow" datasource="ds" action="current" > Name: <jbo:RenderValue dataitem="Ename" /><br> Employee number: <jbo:RenderValue dataitem="Empno" /><br></jbo:Row> <a href="<jbo:UrlEvent datasource='ds' event='First' />">First record</a> <a href="<jbo:UrlEvent datasource='ds' event='Next' />">Next record</a> <jbo:ReleasePageResources /
Copyright © 1997, 2004, Oracle. All rights reserved.