Struts ActionServletのビジネス・コンポーネント定義について

web.xmlファイルは、プロジェクトのデプロイメント・ディスクリプタを定義します。このファイルは、一般的なランタイム・コンテキストを定義するためにすべてのWebアプリケーションにより使用され、アクション・サーブレット・コントローラを識別するためにStrutsアプリケーションにより使用されます。

BC4J Webアプリケーションを作成する場合は、標準のStruts ActionServletクラスを使用します。ただし、RequestProcessorクラスは、BC4JContextというBeanを初期化し、ページ・リクエストの継続時間の間これを使用可能にします。BC4JContext Beanには、アクションの実行に必要なアプリケーション・モジュールおよびビュー・オブジェクトが含まれます。ActionServletサーブレットの次のBC4J固有パラメータは、その関数をサポートします。

mapping
アクション・マッピング情報の取得およびアクションに対するカスタム・プロパティ・セットの管理に使用されるクラスのパッケージ名。データ・アクセスにビジネス・コンポーネント・プロジェクトを使用するWebアプリケーションの場合、これはoracle.jbo.html.struts11.BC4JActionMappingであり、BC4JActionMappingにはBC4J固有のアクション・クラスが含まれます。
BC4JDefinition
StrutsをサポートするBC4J JSP Webアプリケーションにのみ存在します。このディスクリプタは、BC4Jクライアント・プロジェクトの .cpxファイルで指定したBC4Jクライアント・データ・モデル定義の名前を提供します。.cpxファイルの名前はユーザー定義可能であり、デフォルトでは、BC4Jクライアント・プロジェクト(Webアプリケーション・プロジェクト)の名前になります。

web.xmlファイルからの次の引用は、これらの定義がある場所を示しています。



<servlet>
   <servlet-name>action</servlet-name>
   <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
         <init-param>
		   <param-name>config</param-name>
		   <param-value>/WEB-INF/struts-config.xml</param-value>
		 </init-param>
		 <init-param>
		   <param-name>config/sub1</param-name>
		   <param-value>struts-sub_app_module1-config.xml</param-value>
		 </init-param>
		 		 <init-param>
		   <param-name>config/sub2</param-name>
		   <param-value>struts-sub_app_module2-config.xml</param-value>
		 </init-param>
         <init-param>
           <param-name>mapping</param-name>
           <param-value>oracle.jbo.html.struts11.BC4JActionMapping</param-value>
         </init-param>
         <init-param>
		   <param-name>BC4JDefinition</param-name>
		   <param-value>MyBc4jClientProject</param-value>
		 </init-param>
         <init-param>
		   <param-name>config</param-name>
		   <param-value>/WEB-INF/struts-config.xml</param-value>
		 </init-param>
         <init-param>
		   <param-name>application</param-name>
		   <param-value>mybc4jclientpackage.ApplicationResources</param-value>
		 </init-param>
         <init-param>
		   <param-name>debug</param-name>
		   <param-value>2</param-value>
		 </init-param>
         <init-param>
		   <param-name>detail</param-name>
		   <param-value>2</param-value>
		 </init-param>
         <init-param>
		   <param-name>validate</param-name>
		   <param-value>true</param-value>
		 </init-param>
         <init-param>
		   <param-name>validating</param-name>
		   <param-value>true</param-value>
		 </init-param>
        <load-on-startup>1</load-on-startup>
 </servlet>

上のweb.xml引用で示した追加パラメータは、任意のStrutsアプリケーションに固有であり、次の項目を含みます。

config
リクエストURIをアプリケーションのアクションにマップする際に使用されるWebアプリケーション構成ファイルのパス。通常は、WebアプリケーションのWEB-INFディレクトリにインストールされています。例で示されているように、複数のサブアプリケーション(Strutsアプリケーション・モジュールと呼ぶ)を定義し、各パーティションに固有のサーブレット構成ファイルがあるパーティション化されたアプリケーション開発をサポートできます。
application
Strutsメッセージ文字列リソース・ファイルの名前。たとえば、mybc4jclientpackage.ApplicationResources.propertiesです。.propertiesファイルの名前を変更し、ここで識別できます。このファイルは、アプリケーションでサポートされる国の言語要件を満たすために通常は翻訳されます。

注意: JDeveloperは、ApplicationResources.propertiesファイルをWebアプリケーションのソース・フォルダに格納します。これにより、アプリケーション値をmybc4jclientpackage.ApplicationResourcesに簡略化できます。ファイルをソース・フォルダの外部に移動する場合は、リソース・バンドル・パッケージ名(mybc4jclientpackage.ApplicationResources)がアプリケーションのクラスパスにあり、アプリケーション値がフル・パッケージ名であることを確認してください。

debug
ActionServletのデバッグの詳細レベルであり、サーブレット・ログに表示される情報量を制御します。
detail
サーブレット・ログではなくSystem.outに記録されるStrutsのデバッグ詳細レベル。
validate
ActionServletstruts-config.xmlが新規構成ファイル形式を使用することを指定します。
validating
XML解析を検証して構成ファイルを処理するには、trueに設定します。

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