StrutsベースのWebアプリケーションでのビジネス・コンポーネント・アクションについて

作成するBC4J JSPページでは、Strutsフレームワークを使用して、ビジネス・コンポーネントにより開始されるアクションを処理できます。ビジネス・コンポーネントWebアプリケーションは、BC4Jモデルに対して次の操作を実行するための定義済アクション・クラスを提供する、小さなライブラリbc4jstruts.jarを使用します。

BC4J JSPがStrutsフレームワークと通信する方法

BC4J JSPページには、BC4Jデータ・タグ・ライブラリからのJSPコンポーネント・タグがインクルードされます。これらのタグは、アクション・クラスがビジネス・コンポーネント操作の完了に必要とする次のランタイム・パラメータを渡すよう、最新のJDeveloperリリースで変更されました。

各アクション・クラスには最低でもアプリケーション・モジュールの名前が必要となり、ほとんどの場合、イベントを処理するビュー・オブジェクトの名前が必要です。JSPページは、これらの値を数通りの方法で提供します。

アプリケーションでStruts構成とページ・リンクの両方を使用して同じアクションに対するBC4Jコンテキストを定義する場合は、Struts構成が優先されます。

BC4J Strutsアクション・クラスが定義するイベント

bc4jstruts.jarには、次のクラスが用意されています。

次の表に、サポートされているビジネス・コンポーネント操作を完了するためにこれらのアクション・クラスが必要とするパラメータを説明します。

注意: これらの表では、「×」は必須パラメータを示し、「O」はデフォルト値のある必須パラメータを示します。

アクション・タイプ: oracle.jbo.html.struts11.action.NavigationAction

イベント AppModule View Object Value Success 説明

next

×

×

 

O

行セット内の現在位置を次の行に移動します。

previous

×

×

 

O

行セット内の現在位置を前の行に移動します。

first

×

×

 

O

行セット内の現在位置を最初の行に移動します。

last

×

×

 

O

行セット内の現在位置を最後の行に移動します。

nextSet

×

×

 

O

1ページ下の範囲にスクロールします。

previousSet

×

×

 

O

1ページ上の範囲にスクロールします。

firstSet

×

×

 

O

範囲を行セットの先頭にスクロールします。

lastSet

×

×

 

O

範囲を行セットの最後にスクロールします。

gotoSet

×

×

×

O

範囲をn番目のページにスクロールします。

 

アクション・タイプ: oracle.jbo.html.struts11.action.EditAction

イベント AppModule View Object RowKey Create Edit Delete Success 説明

create

×

×

 

O

 

 

 

新規行を作成します。

edit

×

×

×

 

O

 

 

RowKeyで識別される行を編集します。

delete

×

×

×

 

 

O

 

RowKeyで識別される行を削除します。

update

×

×

×

 

 

 

O

RowKeyで識別される行を更新します。

 

アクション・タイプ: oracle.jbo.html.struts11.action.TransactionAction

イベント AppModule Success 説明

commit

×

O

トランザクションをコミットします。

rollback

×

O

トランザクションをロールバックします。

 

アクション・タイプ: oracle.jbo.html.struts11.action.QueryAction

イベント AppModule View Object Index Success 説明

removeCriteria

×

×

×

O

索引の基準行を削除します。

addCriteria

×

×

 

O

空の新規基準行を追加します。

clearAll

×

×

 

O

すべての基準を削除します。

search

×

×

 

O

問合せを実行します。

 

各イベントのパラメータは、struts-config.xmlで定義するか、パラメータとして渡すことができます。

使用される名前 リクエスト・パラメータ名 struts-configアクション・プロパティ

VO

jboEventVo

ViewObject

AM

amId

Application

Event

event

event

RowKey

jboRowKey

未定義

 

 


JSPページおよびビジネス・コンポーネントについて
JSPページおよびBC4Jアプリケーション・モジュール・プールについて
bc4j.xcfgファイルでのBC4J JSPランタイム・プロパティの定義
Business Components for Java(BC4J)のデプロイについて