JSPイベントの情報をパラメータとして含むURLを作成する簡易タグです。
JSP構文
<jbo:UrlEvent
[ targeturl='targeturlName']
[ targeturlparam='paramName']
event='eventName'
[ datasource='datasourceName'] | [ viewobject='viewobjectName']
[ addrowkey='true'| 'false']
[ extraparameters='param=value'[& 'param=value'...] ]
/>
注意: 別のHTMLタグ内部でこのタグを使用する場合に構文エラーを防ぐため、UrlEventデータ・タグの属性には一重引用符を使用してください。
説明
<jbo:UrlEvent>データ・タグは、JSPイベントを特定する特別なリクエスト・パラメータを使用してURLを作成します。次のイベントを送信できます。
UrlEventデータ・タグは、URLを取得するHTMLタグの内部で使用します。JSPページは、UrlEventデータ・タグで指定された属性値から次の2つのリクエスト・パラメータを作成します。
jboEvent='eventname'
jboEventVo='viewobjectname'
ここで、ビュー・オブジェクト名はオプションです。URLを使用して送信するイベントは、ターゲットJSPページのビュー・オブジェクトに適用され、そのページの対応する<jbo:OnEvent>データ・タグの本体により処理されます。UrlEvent属性でビュー・オブジェクト名を省略した場合、イベントはターゲットJSPページのデータソース内の任意のビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに適用する場合は、次のいずれかの処理を行います。
または
注意: ターゲットJSPページには、受け取ったイベントを処理する<jbo:OnEvent>データ・タグが含まれている必要があります。イベント処理の詳細は、<jbo:OnEvent>データ・タグを参照してください。
たとえば、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>データ・タグ内の識別子と一致した場合、OnEventデータ・タグの本体がターゲット・ページで実行されます。詳細は、<jbo:OnEvent>データ・タグを参照してください。
属性
targeturlparam
属性を使用します)。targeturl
属性で明示的に指定する場合は、この属性を省略できます。 FirstSet
、NextSet
、PreviousSet
およびLastSet
First
、Next
、Previous
およびLast
Update
、Delete
およびInsert
viewobject
属性でビュー・オブジェクト名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。datasource
属性でデータソース名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
注意: アプリケーション・モジュールで定義された既存のビュー・オブジェクト、またはCreateViewObjectデータ・タグを使用して作成したビュー・オブジェクトを指定できます。ネストされたアプリケーション・モジュールにビュー・オブジェクトが含まれている場合、appmodNested.viewobjectName
のように、ビュー・オブジェクト名をアプリケーション・モジュール名とともに指定する必要があります。
例
次の例では、UrlEventデータ・タグで指定されたデータソースに対するnextおよびfirstイベントを生成するリンクを表示します。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 />