ビジネス・コンポーネント接続タグ - <jbo:DataSource>

次のようなビュー・オブジェクトに基づいてデータ・ソース・インスタンスを作成します。

JSP構文

<jbo:DataSource
   id="dataSourceInstanceName"
   appid="appModuleInstanceName"
   viewobject="viewObjectName"
   [ whereclause="filterString" ]
   [ orderbyclause="orderbyString" ]
   [ rangesize="number of rows displayed | -1 | 1" ]
   [ forwardonly="true | false" ]
   [ itermode="LastPagePartial | LastPageFull" ]
/>

注意: コンポーネント・パレットを使用して<jbo:DataSource>タグをJSPページ内にドロップした場合、すべての属性が表示されるわけではありません。このタグの「属性」ダイアログには、変更できる属性のみが表示されます。その他の属性の値は、次の属性セクションで説明するように、アプリケーションから取得されます。

説明

<jbo:DataSource>タグは、ビジネス・コンポーネントAPIを介してビジネス・コンポーネント・データ・ソース(ビュー・オブジェクト)インスタンスを操作する場合に、スクリプト可能変数として使用できるデータ・ソース・インスタンスへのハンドルを提供します。次に例を示します。

 <jbo:DataSource id="ds" 
appid="Mypackage1Module" viewobject="EmpView1" /> <% 
RowSet rs = ds.getRowSet(); Row currentRow = rs.getCurrentRow(); %>        

注意: バージョン9.0.3より前のJDeveloperでは、ビジネス・コンポーネントJSPページは<jbo:DataSource>タグに排他的に依存してビュー・オブジェクトへのデータ・バインディングを取得していました。生成されるデータ・ソースIDは、行セットおよび属性を操作するために、<jbo:RowsetIterate><jbo:ShowValue>など、他のデータ・タグのdatasource属性によって参照されていました。JDeveloperバージョン9.0.3以降では、ビジネス・コンポーネント・データ・タグが必要とするdatasource属性のビュー・オブジェクト・インスタンス名を入力できます。このようにビュー・オブジェクトにデータ・ソースとして直接名前を付けられるため、<jbo:ViewObject>タグおよび<jbo:DataSource>タグをJSPページ内で使用する必要はなくなりました。

関連項目: oracle.jbo.DataSource

属性

<jbo:DataSource id="category_vo" appid="OnlineOrdersModule" viewobject="CategoryView" />

<jbo:DataSource
id="customer_vo1" appid="OnlineOrdersModule"
whereclause="<%= wc %>"
viewobject="CustomerView" />

さらに詳細な例を次に示します。

<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo" %>
<jbo:ApplicationModule id="OnlineOrdersModule"
configname="OnlineOrders.OnlineOrdersModule.LocalConfig"
releasemode="Stateless" />

<jbo:DataSource id="ds1" appid="OnlineOrdersModule" whereclause="id > 206" rangesize="20" viewobject="CustomerView" />

<jbo:RowsetIterate datasource="ds1" >
  <jbo:ShowValue datasource="ds1" dataitem="Id" ></jbo:ShowValue>
  <jbo:ShowValue datasource="ds1" dataitem="Firstname" ></jbo:ShowValue>
  <jbo:ShowValue datasource="ds1" dataitem="Lastname" ></jbo:ShowValue>
  </jbo:RowsetIterate>
</BODY>
</HTML>

<jbo:ReleasePageResources />