データソースの現在位置または表示範囲を移動します。
<jbo:RowsetNavigate
datasource="datasourceInstanceName"
[ action="First | Next | Previous | Last | FirstSet | NextSet| PreviousSet | LastSet" ]
/>
<jbo:RowsetNavigate>
タグを使用し、(rowkey属性を使用して)行の現在位置を変更し、必要に応じて処理できます。
Oracle9i JDeveloperより前のリリースでは、ユーザーが行セット内の最後のレコードより後または最初のレコードより前にスクロールすると、<jbo:RowsetNavigate>
データ・タグを使用したビジネス・コンポーネントJSPデータ・タグ・アプリケーションに対して例外がスローされていました。 Oracle9i JDeveloperからは、行セットに例外はスローされません。
たとえば、アプリケーションで次のようなメッセージで状況を通知するとします。
「行セットの先頭に達しました」(ユーザーが最初の行で「前へ」をクリックした場合)
「行セットの末尾に達しました。」 (ユーザーが最後の行で「次へ」をクリックした場合)
この場合、アプリケーションではデータソース・オブジェクトに対して次のメソッドを使用する必要があります。
dsNav.getRowSet().hasNext()
(行セットの末尾に対して)dsNav.getRowSet().hasPrevious()
(行セットの先頭に対して)
行セット内の行の番号を比較するという方法ではなく、これらのメソッドを使用することをお薦めします。
参照項目: oracle.jbo.RowIterator
datasource: 行を処理するデータソースのID。 データソースは、<jbo:DataSource>
タグを使用して作成します。
action: 実行するナビゲート操作。 <jbo:OnEvent>
タグ・ボディで使用する場合はオプションです。 データソースの行ポインタをどこに移動するかによって、First
、Next
、Previous
、Last
のいずれかの値を入力します。
First
は、行ポインタを行セットの最初のレコードに移動します。
Next
は、行ポインタを行セットの次のレコードに移動します。
Previous
は、行ポインタを行セットの前のレコードに移動します。
Last
は、行ポインタを行セットの最後のレコードに移動します。
FirstSet
は、範囲を行セットの最初に移動します。
NextSet
は、範囲を次の行セットに移動します。
PreviousSet
は、範囲を前の行セットに移動します。
LastSet
は、範囲を行セットの最後に移動します。
ヒント: <%=navop%>
などの表現を使用して、実行時に操作パラメータを設定することもできます。 この方法によってページの別の部分から<jbo:RowsetNavigate>
タグに処理値を渡すことができます。
<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo" %>
<jbo:ApplicationModule id="OnlineOrdersModule"
configname="OnlineOrders.OnlineOrdersModule.LocalConfig"
releasemode="Stateless" />
<jbo:DataSource id="Orders" appid="OnlineOrdersModule" viewobject="OrdView" >
</jbo:DataSource>
<jbo:DataSource id="customers" appid="OnlineOrdersModule" viewobject="CustomerView" >
</jbo:DataSource>
<jbo:RowsetNavigate datasource="Orders" action="First" />
<form name="form1"> Order Id:<jbo:InputText datasource="Orders" dataitem="Id" />
Order Date:<jbo:InputDate datasource="Orders" dataitem="Orderdate" formname="form1" />
Customer Name:<jbo:InputSelect datasource="Orders" dataitem="CustomerId" displaydatasource="customers" displaydataitem="Id" displayvaluedataitem="Lastname" />
</form>
<jbo:RowsetNavigate datasource="Orders" action="Next" />
<form name="form2"> Order Id:<jbo:InputText datasource="Orders" dataitem="Id" />
Order Date:<jbo:InputDate datasource="Orders" dataitem="Orderdate" formname="form2" />
Customer Name:<jbo:InputSelect datasource="Orders" dataitem="CustomerId" displaydatasource="customers" displaydataitem="Id" displayvaluedataitem="Lastname" />
</form>
<jbo:RowsetNavigate datasource="Orders" action="Previous" />
<form name="form3"> Order Id:<jbo:InputText datasource="Orders" dataitem="Id" />
Order Date:<jbo:InputDate datasource="Orders" dataitem="Orderdate" formname="form3" />
Customer Name:<jbo:InputSelect datasource="Orders" dataitem="CustomerId" displaydatasource="customers" displaydataitem="Id" displayvaluedataitem="Lastname" />
</form>
<jbo:RowsetNavigate datasource="Orders" action="Last" />
<form name="form4"> Order Id:<jbo:InputText datasource="Orders" dataitem="Id" />
Order Date:<jbo:InputDate datasource="Orders" dataitem="Orderdate" formname="form4" />
Customer Name:<jbo:InputSelect datasource="Orders" dataitem="CustomerId" displaydatasource="customers" displaydataitem="Id" displayvaluedataitem="Lastname" />
</form>
</BODY>
</HTML>
<jbo:ReleasePageResources />
Copyright © 1997, 2004, Oracle. All rights reserved.