次のビュー・オブジェクトに基づいて、ビュー・オブジェクト・インスタンスを作成します。
指定したアプリケーション・モジュールにすでに存在する。
<jbo:CreateViewObject>
または<jbo:CreateRowSet>
データ・タグを使用して動的に作成します。
JSP構文
<jbo:ViewObject
id="viewObjectInstanceName"
name="viewObjectName"
[ rangesize="number of rows displayed | -1 | 1" ]
[ itermode=" LastPagePartial | LastPageFull" ]
/>
説明
<jbo:ViewObject>
タグは、ビジネス・コンポーネントAPIを介してビュー・オブジェクト・インスタンスで操作するときに、スクリプト可能な変数として使用できるビュー・オブジェクト・インスタンスが指定されます。次に例を示します。
<jbo:ViewObject id="vo" name="Mypackage1Module.EmpView1"
/> <% Row currentRow = vo.getCurrentRow(); %>
以前のバージョンのビジネス・コンポーネントJSPページでは、ビュー・オブジェクトに対するデータ・バインディングを取得するために<jbo:DataSource>
タグのみを使用していました。JDeveloperバージョン 9.0.3以降では、ビジネス・コンポーネント・データ・タグに必要なdatasource
属性に、ビュー・オブジェクト・インスタンス名を使用できます。ビュー・オブジェクトをデータソースとして直接指定できる機能のため、ビジネス・コンポーネントJSPページでは<jbo:ViewObject>
および<jbo:DataSource>
タグは不要になります。<jbo:ViewObject>
タグは、より明示的なタグ名を使用して<jbo:DataSource>
タグの機能をミラー化するために用意されていました。
関連項目: oracle.jbo.ViewObject
およびoracle.jbo.RowIterator
説明
id-ビュー・オブジェクトのインスタンスの名前。ページ内で一意の名前を割り当てる必要があります。有効なJava識別子であればどのような名前でもかまいません。スクリプトレット内で、型oracle.jbo.ViewObject
のスクリプト可能な変数としてこのIDを使用できます。
name-ビジネス・コンポーネント・プロジェクトでの表示に使用するビュー・オブジェクトのフルネーム。アプリケーション・モジュールによって定義された既存のビュー・オブジェクト、または<jbo:CreateViewObject>
データ・タグを使用して作成したビュー・オブジェクトを指定できます。アプリケーション・モジュールIDであるappmodId.viewobjectName
でビュー・オブジェクト名を指定する必要があります。また、 appmodId.viewobjectName#rowsetName
という表記法を使用してビュー・オブジェクトの行セットを指定することもできます。
rangesize-ビュー・オブジェクトからフェッチする、レンジにおける行数(オプション)。これは、行セット全体で作業しない場合に有用です。レンジによって、データ・ソース内の行のサブセットへのアクセスに使用できるウィンドウが効果的に定義されます。レンジは、行セットが大きく、すべての行をクライアントに送るわけではない場合、または一定の行数をページに表示する場合に有用です。デフォルトでは、レンジ・サイズは1行(値1)に設定されます。-1に設定すると、すべての行がフェッチされます。
itermode-ユーザーが行セット内の最終レンジの行の表示を試みた場合の行セットの表示動作を決定します(オプション)。一度に行セット内の全レンジの行のみを表示する場合(このモードでは、完全にデータ移入されたページが表示されます)、LastPageFull
に設定します。それ以外の場合、デフォルト値LastPagePartial
が適用されて、レンジ・サイズに関係なく、ユーザーが行セットの最後まで移動できます。デフォルトの部分ページ・モードを使用するユーザーにとって、最終ページのサイズが、前回表示されたページ(レンジ・サイズによって常に制御される)とは異なることがあります。
注意: 最終ページの部分モード(デフォルト)は、ページ内で一定数の行セットが処理されるWebクライアントの場合に役に立ちます。最終ページの完全モードでは、ページ内の行数が必ずしも一定しているとはかぎりません。行セットの最後に達した場合、ページが自動的に調整され、範囲サイズより少ない行数でスクロールされる場合があります。これら2つのモードのもう1点の違いは、最終ページで行が削除された場合です。最終ページの完全モードでは、範囲が最後に達したときに範囲内の行を削除すると、範囲を完全に保つために最上位の行が読み込まれます(存在する場合)。最終ページの部分モードでは、最上位の行は読み込まれません。ページの最後の行が削除されると、範囲サイズによって上にスクロールされます(ページ・アップ)。最終ページの動作の詳細は、oracle.jbo.RowIterator
Javadocを参照してください。
Copyright © 1997, 2007, Oracle. All rights reserved.