<jbo:UrlEvent>

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

属性

次の例では、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 />