作成するBC4J JSPページでは、Strutsフレームワークを使用して、ビジネス・コンポーネントにより開始されるアクションを処理できます。ビジネス・コンポーネントWebアプリケーションは、BC4Jモデルに対して次の操作を実行するための定義済アクション・クラスを提供する、小さなライブラリbc4jstruts.jar
を使用します。
BC4J JSPページには、BC4Jデータ・タグ・ライブラリからのJSPコンポーネント・タグがインクルードされます。これらのタグは、アクション・クラスがビジネス・コンポーネント操作の完了に必要とする次のランタイム・パラメータを渡すよう、最新のJDeveloperリリースで変更されました。
jboEvent
は、BC4Jイベント名を指定します。jboEventVo
は、ビュー・オブジェクト・インスタンス名を指定します。jboRowKey
は、(たとえば、行の編集に使用する)行識別子を指定します。 amId
は、アプリケーション・モジュールを指定します。各アクション・クラスには最低でもアプリケーション・モジュールの名前が必要となり、ほとんどの場合、イベントを処理するビュー・オブジェクトの名前が必要です。JSPページは、これらの値を数通りの方法で提供します。
struts-config.xml
ファイルに定義できます。
たとえば、ビジネス・コンポーネントStruts JSPアプリケーション・ウィザードを使用してJSPページを生成する場合のstruts-config.xml
ファイルを見ると、ページはアクション・マッピングを使用して特定のアクションのプロパティ・セットとして値を事前定義しています。
<jbo:UrlEvent>
BC4Jデータ・タグを使用して、リクエスト・パラメータとして提供される値とのリンクを生成できます。
<a href="<jbo:UrlEvent targeturl='/actionMappingName.do'
datasource='amid.ViewObjectUsageName' event='jboEventName' />">
perform this BC4J-specific action, using jboEventName
</a>
<a href="actionMappingName.do?
jboEvent=jboEventName&jboEventVo=ViewObjectUsageName&amId=amid">
perform this BC4J-specific action, using jboEventName
</a>
アプリケーションでStruts構成とページ・リンクの両方を使用して同じアクションに対するBC4Jコンテキストを定義する場合は、Struts構成が優先されます。
bc4jstruts.jar
には、次のクラスが用意されています。
oracle.jbo.html.struts11.action.NavigationAction
oracle.jbo.html.struts11.action.EditAction
oracle.jbo.html.struts11.action.TransactionAction
oracle.jbo.html.struts11.action.QueryAction
次の表に、サポートされているビジネス・コンポーネント操作を完了するためにこれらのアクション・クラスが必要とするパラメータを説明します。
注意: これらの表では、「×」は必須パラメータを示し、「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)のデプロイについて