ユーザーが選択可能なリンクをレンダリングしてデータベース・トランザクションをコミットまたはロールバックするコンポーネントを挿入します。
JSP構文
<jbo:DataTransaction
appid="appModuleInstance"
[ targetURL="event-handling page | the JSP with the component" ]
[ relativeUrlPath="component's JSP page | DataTransactionComponent.jsp" ]
/>
説明
<jbo:DataTransaction>
コンポーネントは、データ・ソースの変更内容をコミットするか、ロール・バックするかをユーザーが選択できるJSPページにリンクを挿入します。このページによってレンダリングされたリンクの状態は、データ・ソースの現在の状態を反映しています。つまり、データが変更されていないか、ユーザーがすでにデータベースにすべてのデータ・ソースの変更をコミット済の場合は、リンクがグレー表示され、選択できません。
DataTransactionコンポーネントは、ユーザーのリンク選択の処理をする場合<jbo:Commit>
および<jbo:Rollback>
データ・タグに依存します。編集フォームを含むJSPページ内に、DataTransactionコンポーネント・タグを挿入できます。DataTransactionコンポーネント・タグを挿入したページと同じページ、または一意のターゲット・ページで、データベース・トランザクションを処理できます。
属性
<jbo:ApplicationModule>
データ・タグに定義されているアプリケーション・モジュールID。
relativeUrlPath: オプション。コンポーネント・タグを実装するJSPファイルの場所。デフォルトでは、JDeveloperが提供するファイルDataTransactionComponent.jsp
が参照されます。コンポーネントの動作をカスタマイズするために作成するコンポーネント実装.jsp
ファイルの名前を指定できます。また、すでにカスタマイズした既存のコンポーネント実装.jsp
ファイルを参照するように名前を編集することもできます。
作成または参照するファイルがプロジェクト・ディレクトリsite
(mywork
フォルダ内)のサブディレクトリに表示される場合、相対パスを指定する必要があります。たとえば、components
と呼ばれるsite
フォルダのサブディレクトリにカスタム・コンポーネント実装ファイルMyDataTransactionComponent.jsp
を作成する場合、relativeUrlPathの値は、/components/MyDataTransactionComponent.jsp
になります。
例
次の例では、DataTransactionコンポーネントがバインドされているアプリケーション・モジュール・セッションでデータベース・トランザクションが処理されます。この例では、DataTransactionのターゲットはこのコンポーネントを含むJSPです。
<jbo:ApplicationModule id="am" configname="mypackage.MypackageModule.MypackageModuleLocal"
releasemode="Stateful" />
<jbo:DataSource id="LocationsView" appid="am" viewobject="LocationsView"/>
<jbo:DataTransaction appid="am" />
Copyright © 1997, 2009, Oracle. All rights reserved.