> WebLogic Server Web アプリケーション、サーブレット、JSP の開発 > weblogic.xml デプロイメント記述子の要素

WebLogic Server Web アプリケーション、サーブレット、JSP の開発

     前  次    新しいウィンドウで目次を開く     
ここから内容の開始

weblogic.xml デプロイメント記述子の要素

このマニュアルは、WebLogic Server 固有のデプロイメント記述子 weblogic.xml の要素に関する詳細なリファレンスです。お使いの Web アプリケーションに weblogic.xml デプロイメント記述子が含まれていない場合、WebLogic Server によってこのデプロイメント記述子の要素にデフォルトの値が自動的に選択されます。weblogic.xml のスキーマについては、http://www.bea.com/ns/weblogic/90/weblogic-web-app.xsd を参照してください。

以降の節では、weblogic.xml デプロイメント記述子のルート要素 <weblogic-web-app> の下に定義できる複合的なデプロイメント記述子要素について説明します。

 

description

description 要素は、Web アプリケーションの説明文です。

 

weblogic-version

weblogic-version 要素は、当該 Web アプリケーション (ルート要素 <weblogic-web-app> に定義) のデプロイ先とする WebLogic Server のバージョンを示します。この要素は参照用で、現在 WebLogic Server では使用されていません。

 

security-role-assignment

security-role-assignment 要素は、Web アプリケーションのセキュリティ ロールと WebLogic Server の 1 つまたは複数のプリンシパルとのマッピングを宣言します。次に例を示します。 

<security-role-assignment>
    <role-name>PayrollAdmin</role-name>
    <principal-name>Tanya</principal-name>
    <principal-name>Fred</principal-name>
    <principal-name>system</principal-name>
</security-role-assignment>

この要素を使用すると、次の例のように、特定のロールを外部定義されたロールとしてマークすることもできます。 

<security-role-assignment>
    <role-name>roleadmin</role-name>
    <externally-defined/>
</security-role-assignment>
注意 : <security-role-assignment> 要素には、<principal-name> または <externally-defined> のどちらかが定義されている必要があります。この両方を省略することはできません。

次の表では、security-role-assignment 要素内で定義できる要素について説明します。

要素
必須/
省略可能
説明
<role-name>
必須
セキュリティ ロール名を指定する。
<principal-name>
<externally-defined> が定義されていない場合、必須
セキュリティ レルムで定義されるプリンシパルの名前を指定する。複数の <principal-name> 要素を使用してプリンシパルをロールにマップできる。セキュリティ レルムの詳細については、『WebLogic Server のセキュリティ』を参照。
<externally-defined>
<principal-name> が定義されていない場合、必須
特定のセキュリティ ロールがセキュリティ レルムでグローバルに定義されていることを指定する。WebLogic Server では、このセキュリティ ロールをグローバル レルム内でルックアップするのではなくプリンシパル名として使用する。セキュリティ ロールと principal-name のマッピングが別の場所で定義されている場合、これは暗示的なプレースホルダとして使用される。

注意 : security-role-assignment 要素およびその下位要素を定義していない場合は、Web アプリケーション コンテナによってロール名がプリンシパル名として暗黙的にマップされ、ログに警告メッセージが出力されます。マッピングが定義されていないと、EJB コンテナはモジュールをデプロイしません。
注意 : 以下に、ロール名が「role_xyz」の場合の使用例を示します。

 

run-as-role-assignment

run-as-role-assignment 要素は、web.xml の run-as ロール名 (servlet 要素の下位要素) をシステムの有効なユーザ名にマップします。この値は、servlet-descriptor の run-as-principal-name 要素によって任意のサーブレットについてオーバーライドできます。ロール名の run-as-role-assignment がない場合は、Web アプリケーション コンテナにより security-role-assignment に定義されている最初の principal-name が使用されます。以下の例に、run-as-role-assignment 要素の使い方を示します。 

<run-as-role-assignment>
    <role-name>RunAsRoleName</role-name>
    <run-as-principal-name>joe</run-as-principal-name>
</run-as-role-assignment>

次の表では、run-as-role-assignment 要素内で定義できる要素について説明します。

要素
必須/
省略可能
説明
<role-name>
必須
セキュリティ ロール名を指定する。
<run-as-principal-name>
必須
プリンシパルの名前を指定する。

 

resource-description

resource-description 要素は、サーバ リソースの JNDI 名を、WebLogic Server の EJB リソースの参照にマップするために使用されます。

次の表では、resource-description 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<res-ref-name>
必須
リソース参照名を指定する。
<jndi-name>
必須
リソースの JNDI 名を指定する。

 

resource-env-description

resource-env-description 要素は、ejb-jar.xml デプロイメント記述子で宣言された resource-env-ref を、それが表しているサーバ リソースの JNDI 名にマップします。

次の表では、resource-env-description 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<res-env-ref-name>
必須
リソース環境参照の名前を指定する。
<jndi-name>
必須
リソース環境参照の JNDI 名を指定する。

 

ejb-reference-description

次の表では、ejb-reference-description 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<ejb-ref-name>
必須
Web アプリケーションで使用する EJB 参照の名前を指定する。
<jndi-name>
必須
参照の JNDI 名を指定する。

 

service-reference-description

次の表では、service-reference-description 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<service-ref-name>
   
<wsdl-url>
   
<call-property>
 
<call-property> 要素には次の下位要素がある。
  • <name>
  • <value>
<port-info>
 
<port-info> 要素には次の下位要素がある。
  • <port-name>
  • <stub-property>
  • <call-property>

 

session-descriptor

session-descriptor 要素には、サーブレット セッションのパラメータを定義します。

注意 : セッション コンテキストを初期化する場合、weblogic-application.xml のほとんどのセッション デプロイメント記述子は、weblogic.xml よりも優先されます。未定義のプロパティがある場合は、それが weblogic.xml に存在している場合でもデフォルト値が使用されます。ただし、両方の XML ファイルが使用されている場合、次のプロパティについては weblogic.xml が優先されます。

 

jsp-descriptor

jsp-descriptor 要素には、JSP コンパイラのコンフィグレーション パラメータのリストを指定します。次の表で、jsp-descriptor 要素内に定義できる要素について説明します。

要素
必須/省略可能
説明
page-check-seconds
1
JSP ファイルが変更されたために再コンパイルする必要があるかどうかをチェックする間隔を秒単位で設定する。変更されている場合は、依存関係もチェックされ、再帰的に再ロードされる。
  • 値が -1 の場合、ページの確認は行われない。この値は、プロダクション環境のデフォルト値。
  • 値 0 の場合、必ずページの確認が行われる。
  • 値が 1 の場合、ページの確認は 1 秒ごとに行わる。この値は、開発環境のデフォルト値。
JSP がまれにしか変更されないプロダクション環境では、チューニング要件に応じて pageCheckSeconds の値を 60 以上に変更すること。
precompile
false
true に設定すると、Web アプリケーションのデプロイ (再デプロイ) 時または WebLogic Server の起動時に、変更されたすべての JSP が自動的にあらかじめコンパイルされる。
precompile-continue
false
true に設定すると、いずれかの JSP のコンパイルに失敗しても、変更されたすべての JSP がプリコンパイルされる。precompile が true に設定されている場合にのみ有効。
keepgenerated
false
JSP コンパイル プロセスの間に生成される Java ファイルを保存する。このパラメータを true に設定しない限り、中間生成された Java ファイルはコンパイル後に削除される。
verbose
true
true に設定すると、デバッグ情報がブラウザ、コマンド プロンプト、および WebLogic Server ログ ファイルに出力される。
working-dir
内部に生成されるディレクトリ
WebLogic Server が、JSP 用に生成された Java とコンパイル済みのクラス ファイルを保存するディレクトリの名前。
注意 : weblogic.xml で working-dir を定義している場合、Web アプリケーションをアンデプロイしても、このディレクトリは削除されない。
print-nulls
null
false に設定すると、"null" を含む式は " " として出力される。
backward-compatible
true
true に設定すると、下位互換性が有効になる。
encoding
ユーザのプラットフォームのデフォルト エンコーディング
JSP ページで使用されるデフォルトの文字セットを指定する。標準の Java 文字セット名を使用する。
この属性を設定しない場合、デフォルトはユーザのプラットフォームのエンコーディング。
JSP コードに含まれる JSP ページ ディレクティブはこの設定をオーバーライドする。次に例を示す。
<%@ page contentType="text/html; charset=custom-encoding"%>
package-prefix
jsp_servlet
すべての JSP ページのコンパイル先となるパッケージのプレフィックスを指定する。
exact-mapping
true
true の場合、JSP の最初の要求時に新しく作成される JspStub が正確なリクエストにマップされる。exactMapping が false に設定されている場合、Web アプリケーション コンテナは JSP 用に正確ではない url マッピングを生成する。exactMapping は JSP ページのパス情報を提供する。
default-file-name
true
JSP 用の生成済み Java およびコンパイル済みクラス ファイルを保存するファイルのデフォルト名。
rtexprvalue-jsp-param-name
false
jsp:param タグの name 属性に実行時の式の値を指定できるようにする。デフォルトでは false に設定される。

 

auth-filter

auth-filter 要素は、認証フィルタの HttpServlet クラスを指定します。

注意 : この要素は現在のリリースでは非推奨とされています。代わりにサーブレット認証フィルタを使用してください。

 

container-descriptor

<container-descriptor> 要素には、Web アプリケーションの動作に影響するパラメータのリストを指定します。

check-auth-on-forward

<check-auth-on-forward/> 要素は、サーブレットまたは JSP から転送されたリクエストの認証を必要とするときに追加します。再認証を必要としない場合、このタグは省略します。次に例を示します。 

<container-descriptor>
    <check-auth-on-forward/>
</container-descriptor>
注意 : ベスト プラクティスとしては、check-auth-on-forward プロパティを有効にしないことをお勧めします。

filter-dispatched-requests-enabled

<filter-dispatched-requests-enabled> 要素は、ディスパッチされたリクエストにフィルタを適用するかどうかを制御します。デフォルト値は false です。

注意 : 2.4 サーブレットは、(2.4 仕様に従って) 2.3 サーブレットと下位互換性があるため、2.3 の記述子要素が WebLogic Server で検出された場合、<filter-dispatched-requests-enabled> 要素のデフォルトは true になります。

redirect-with-absolute-url

<redirect-with-absolute-url> 要素は、javax.servlet.http.HttpServletResponse.SendRedirect() メソッドでのリダイレクトに相対 URL と絶対 URL のどちらを使用するかを制御します。プロキシ HTTP サーバを使用しており、URL を非相対リンクに変換したくない場合は、この要素を false に設定します。

デフォルトの動作では、URL が非相対リンクに変換されます。

リダイレクトで使用されるユーザが読めるデータ。

index-directory-enabled

<index-directory-enabled> 要素は、適切なインデックス ファイルが見つからない場合に HTML ディレクトリのリストを自動的に生成するかどうかを制御します。

デフォルト値は false です (ディレクトリは生成されません)。値は true または false です。

index-directory-sort-by

<index-directory-sort-by> 要素は、weblogic.servlet.FileServlet で生成されるディレクトリ リストのソート順序を定義します。有効な sort-by 値は、NAME、LAST_MODIFIED、および SIZE です。デフォルトの sort-by 値は NAME です。

servlet-reload-check-secs

<servlet-reload-check-secs> 要素は、サーブレットが変更されたかどうかを WebLogic Server がチェックして、変更されていた場合に再ロードするかどうかを定義します。

コンソールで指定する値は、手動で設定する値よりも常に優先されます。

resource-reload-check-secs

<resource-reload-check-secs> 要素は、Web アプリケーション スコープのリソース パスで検出されるキャッシュされたリソースのメタデータ キャッシングに使用されます。このパラメータでは、リソースが変更されているかどうかをチェックして変更されていた場合にリロードを行う頻度を特定します。

このパラメータの値としては Administration Console を使用して指定したものに優先権が与えられます。

single-threaded-servlet-pool-size

<single-threaded-servlet-pool-size> 要素は、SingleThreadMode インスタンス プールで使用するプールのサイズを定義します。デフォルト値は 5 です。

注意 : SingleThreadMode インスタンス プールはこのリリースでは非推奨とされています。

session-monitoring-enabled

<session-monitoring-enabled> 要素を true に設定すると、セッションの実行時 MBean を作成できます。false (デフォルト値) に設定すると、実行時 MBean は作成されません。コンソールで指定する値は、手動で設定する値よりも優先されます。

save-sessions-enabled

<save-sessions-enabled> 要素は、再デプロイまたはアンデプロイ時にセッション データをクリーンアップするかどうかを制御します。これはメモリとレプリケート セッションに影響します。値を true に設定すると、セッション データは保存されます。false に設定すると、Web アプリケーションが再デプロイまたはアンデプロイされるときにセッション データは破棄されます。デフォルトは false です。

prefer-web-inf-classes

<prefer-web-inf-classes> 要素を true に設定すると、Web アプリケーションの WEB-INF ディレクトリ内のクラスが、アプリケーションまたはシステム クラスローダにロードされるクラスよりも優先してロードされます。デフォルト値は false です。コンソールで指定する値は、手動で設定する値よりも優先されます。

default-mime-type

<default-mime-type> 要素のデフォルト値は null です。この要素を使用すると、拡張がマップされていない content-type のデフォルトの MIME タイプを指定できます。

client-cert-proxy-enabled

<client-cert-proxy-enabled> 要素の値はデフォルトで true になっています。true の場合、WebLogic Server によってクライアントからの ID 証明書がバックエンドのサーバに渡されます。また、受信した WL-Proxy-Client-Cert ヘッダを受け入れるのか、破棄するのかが WebLogic Server に通知されます。

WL-Proxy-Client-Cert ヘッダの各 ID 証明書はプロキシサーバ プラグインによってエンコードされ、バックエンドの WebLogic Server インスタンスに渡されます。各 WebLogic Server インスタンスでは、このヘッダから証明書情報を受け取り、安全なソースに由来するものであると確認してから、その証明書情報でユーザを認証します。バックグラウンドの WebLogic Server インスタンスでは、このパラメータが (クラスタ、サーバ、または Web アプリケーションのレベルで) true に設定されている必要があります。

この要素を true に設定する場合、weblogic.security.net.ConnectionFilter を使用して、各 WebLogic Server インスタンスで確実に、プロキシサーバ プラグインが実行されているマシンからの接続のみを受け付けるようにします。true を指定した場合に接続フィルタを使用しないと WL-Proxy-Client-Cert ヘッダのなりすましが可能になるため、セキュリティに脆弱性が生じるおそれがあります。

relogin-enabled

<relogin-enabled> 要素は下位互換性のためのパラメータです。すでにログインしているユーザが特権を持たないリソースにアクセスしようとすると、応答として FORBIDDEN (403) が発生します。

allow-all-roles

Web アプリケーションの web.xml 記述子に定義されている security-constraints 要素の中では、auth-constraint 要素が、当該リソースの集合へのアクセスを許可する必要があるユーザ ロールを示します。role-name = "*" とすると、Web アプリケーション内のすべてのロールを示す構文を簡単に記述できます。なお、role-name = "*" は以前のリリースでは、レルム内に定義されているすべてのユーザおよびロールを示すものとして扱われていました。

この allow-all-roles 要素は、以前の動作に戻すための下位互換性スイッチです。デフォルトの動作では、Web アプリケーションに定義されているすべてのロールが許可されます。weblogic-xml に指定されている値が、WebAppContainerMBean に定義されている値よりも優先されます。

native-io-enabled

weblogic.servlet.FileServlet (暗黙的に登録されているデフォルトのサーブレット) で静的ファイルを提供しているときにネイティブ I/O を使用するには、native-io-enabled を true に設定しますデフォルト値は false です。native-io-enabled 要素は Windows 上でのみ適用されます。

minimum-native-file-size

minimum-native-file-size 要素は native-io-enabled が true に設定されている場合にのみ適用されます。minimum-native-file-size 要素には、ネイティブ I/O を使用する際の最小ファイル サイズを指定します。提供するファイルのサイズがこの値よりも大きいと、ネイティブ I/O が使用されます。この値を設定しない場合、デフォルト値として 4K が使用されます。

disable-implicit-servlet-mapping

disable-implicit-servlet-mapping フラグが true に設定されている場合、Web アプリケーション コンテナでは内部サーブレット (*.jsp、*.class など) の暗黙的なマッピングが作成されず、デフォルト サーブレットのマッピングのみが作成されます。通常、暗黙的なサーブレット マッピングを無効にするのは、HttpClusterServlet や HttpProxyServlet をコンフィグレーションしている場合です。

デフォルト値は false です。

optimistic-serialization

optimistic-serialization が有効になっている場合、リクエストがサーブレット コンテキストを超えてディスパッチされるときに getAttribute(name) のコンテキストとリクエスト属性がシリアライズおよびデシリアライズされません。

つまり、複数の Web アプリケーションに共通する属性は、共通の親クラスローダにスコープ指定するか (アプリケーション スコープ指定)、2 つの Web アプリケーションが同じアプリケーションに属していない場合はシステムのクラスパスに配置する必要があります。

optimistic-serialization が無効 (デフォルト値) になっている場合、ClassCastException の発生を回避するために getAttribute(name) のコンテキストおよびリクエストの属性がシリアライズおよびデシリアライズされます。

optimistic-serialization 値は、WebAppContainerMBean でドメイン レベルで指定することもでき、その場合すべての Web アプリケーションに適用されます。weblogic.xml に値を指定した場合、その値によってドメイン レベルの値がオーバーライドされます。

デフォルト値は false です。

WebAppComponentRuntimeBean.getSessionIds() メソッドを呼び出すと、この名前を持つセッション属性値の配列が返されます。設定されていない場合、ランダムに生成された String 値の配列が返されます。

require-admin-traffic

require-admin-trafffic 要素は、トラフィックが管理チャネルを経由するかどうかを定義します。true に設定すると、トラフィックが管理チャネルを経由できるようになります。それ以外の場合は、Web アプリケーションが管理モードの場合にのみ、トラフィックが管理チャネルを経由できます。次に例を示します。 

<container-descriptor>
    <require-admin-traffic>true</require-admin-traffic>
</container-descriptor>

 

charset-params

<charset-params> 要素は、Unicode 以外の処理でコード セット動作を定義するために使います。次に例を示します。 

<charset-params> 
<input-charset> 
<resource-path>/*</resource-path> 
<java-charset-name>UTF-8</java-charset-name> 
</input-charset> 
</charset-params>

input-charset

<input-charset> 要素を使って、GET データと POST データの読み取りにどの文字セットを使用するのかを定義します。次に例を示します。 

<input-charset>
    <resource-path>/foo</resource-path>
    <java-charset-name>SJIS</java-charset-name>
</input-charset>

詳細については、「HTTP リクエストのエンコーディングの識別」を参照してください。

次の表では、<input-charset> 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<resource-path>
必須
リクエストの URL に含まれている場合、<java-charset-name> で指定されている Java 文字セットを使用するように WebLogic Server に知らせるパス。
<java-charset-name>
必須
使用する Java 文字セットを指定する。

charset-mapping

<charset-mapping> 要素を使って、IANA 文字セット名を Java 文字セット名にマップします。次に例を示します。 

<charset-mapping>
    <iana-charset-name>Shift-JIS</iana-charset-name>
    <java-charset-name>SJIS</java-charset-name>
</charset-mapping>

詳細については、「IANA 文字セットの Java 文字セットへのマッピング」を参照してください。

次の表では、<charset-mapping> 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<iana-charset-name>
必須
<java-charset-name> 要素で指定された Java 文字セットにマップされる IANA 文字セット名を指定する。
<java-charset-name>
必須
使用する Java 文字セットを指定する。

 

virtual-directory-mapping

virtual-directory-mapping 要素は、特定の種類のリクエスト (画像リクエストなど) 用に、Web アプリケーションのデフォルト ドキュメント ルート以外のドキュメント ルートを指定するために使用します。Web アプリケーション セット用のすべての画像は単一の場所に格納することができ、それらを使用する各 Web アプリケーションのドキュメント ルートにコピーする必要がありません。リクエストを受信した場合、仮想ディレクトリが指定されていれば、サーブレット コンテナは要求されたリソースをまず仮想ディレクトリで検索し、次に Web アプリケーションのデフォルト ドキュメント ルートで検索します。これにより、同じドキュメントが両方の場所に存在する場合の優先順位が決まります。

次に例を示します。 

<virtual-directory-mapping>
     <local-path>c:/usr/gifs</local-path>
     <url-pattern>/images/*</url-pattern>
     <url-pattern>*.jpg</url-pattern>
</virtual-directory-mapping>
<virtual-directory-mapping>
     <local-path>c:/usr/common_jsps.jar</local-path>
     <url-pattern>*.jsp</url-pattern>
</virtual-directory-mapping>

次の表では、virtual-directory-mapping 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<local-path>
必須
ディスク上の物理位置を指定する。
<url-pattern>
必須
マッピングの URL パターンを含む。サーブレット API 仕様のセクション 11.2 で指定されているルールに準拠している必要がある。

仮想ディレクトリ マッピングの WebLogic Server 実装では、マッピングの url-pattern に一致するディレクトリが必要です。上記の画像の例であれば、c:/usr/gifs/images に images というディレクトリを作成する必要があります。これにより、サーブレット コンテナが images ディレクトリにある複数の Web アプリケーションの画像を見つけることが可能になります。

 

url-match-map

この要素は、URL パターン マッチング用のクラスを指定するために使用します。WebLogic Server のデフォルト URL マッチ マッピング クラスは J2EE 仕様に基づく weblogic.servlet.utils.URLMatchMap です。また、WebLogic Server には SimpleApacheURLMatchMap も実装されています。これは、url-match-map 要素を使用してプラグインできます。

SimpleApacheURLMatchMap のルールを示します。

*.jws を JWSServlet にマップする場合

http://foo.com/bar.jws/baz は pathInfo = baz を使用して JWSServlet に解決されます。

次の例に示すように、使用する URLMatchMap を weblogic.xml でコンフィグレーションします。 

<url-match-map>
     weblogic.servlet.utils.SimpleApacheURLMatchMap
</url-match-map>

 

security-permission

security-permission 要素は、セキュリティ ポリシー ファイル構文に基づいて単一のセキュリティ パーミッションを指定します。Sun のセキュリティ パーミッション仕様の実装については、次の URL を参照してください。

http://java.sun.com/j2se/1.3/docs/guide/security/PolicyFiles.html#FileSyntax

オプションの codebase および signedBy 句は無視してください。

次に例を示します。 

<security-permission-spec>
     grant { permission java.net.SocketPermission "*", "resolve" };
</security-permission-spec>

各要素の説明は次のとおりです。

permission java.net.SocketPermission はパーミッション クラス名です。

"*" は対象名を示します。

resolve はアクションを示します。

 

context-root

context-root 要素は、このスタンドアロン Web アプリケーションのコンテキスト ルートを定義します。Web アプリケーションがスタンドアロンではなく EAR の一部の場合、EAR の META-INF/application.xml ファイルにコンテキスト ルートを指定します。application.xml の context-root 設定は、weblogic.xml の context-root 設定に優先します。

この weblogic.xml 要素は、2 フェーズ デプロイメント モデルを使用するデプロイメントに対してのみ有効に機能します。

Web アプリケーションのコンテキスト ルートの優先順位は次のとおりです。

  1. application.xml のコンテキスト ルートがチェックされ、見つかった場合はこれが Web アプリケーションのコンテキスト ルートとして使用されます。
  2. コンテキスト ルートの設定が application.xml になく、Web アプリケーションが EAR の一部としてデプロイされる場合、コンテキスト ルートが weblogic.xml に定義されているかどうかがチェックされます。見つかった場合、これが Web アプリケーションのコンテキスト ルートとして使用されます。Web アプリケーションがスタンドアロンとしてデプロイされる場合、application.xml は使用されず、コンテキスト ルートのチェックは weblogic.xml で開始されます。このファイルに定義されていない場合、デフォルトによって URI が使用されます。
  3. コンテキスト ルートが weblogic.xml と application.xml のどちらにも定義されていない場合、コンテキスト パスは URI から推定され、URI に定義されている値から WAR サフィックスを取り除いた名前が付けられます。たとえば、URI が MyWebApp.war の場合は、MyWebApp という名前が付けられます。
注意 : context-root 要素を EAR ライブラリ内の個々の Web アプリケーションに対して設定することはできません。Web アプリケーション ライブラリに対してのみ設定できます。

 

wl-dispatch-policy

wl-dispatch-policy 要素を使用して、実行キュー名を指定し、Web アプリケーションをコンフィグレーションされた実行キューに割り当てます。この Web アプリケーション レベルのパラメータは、個々のサーブレットや jsp レベルで per-servlet-dispatch-policy 要素を使ってオーバーライドできます。

 

servlet-descriptor

servlet-descriptor 要素を使用して、サーブレット固有の要素を集約します。

次の表では、servlet-descriptor 要素内で定義できる要素について説明します。

要素
必須/省略可能
説明
<servlet-name>
必須
web.xml デプロイメント記述子ファイルのサーブレット要素に定義されたサーブレット名を指定する。
<run-as-principal-name>
省略可能
web.xml デプロイメント記述子に定義された run-as-role-name に対するプリンシパル名を含む。
<init-as-principal-name>
省略可能
サーブレットの init メソッドの run-as-principal-name と同じ。ここに指定する ID はシステムの有効なユーザ名である必要がある。init-as-principal-name を指定しない場合、コンテナは run-as-principal-name 要素を使用する。
<destroy-as-principal-name>
省略可能
サーブレットの destroy メソッドの run-as-principal-name と同じ。ここに指定する ID はシステムの有効なユーザ名である必要がある。destroy-as-principal-name を指定しない場合、コンテナは run-as-principal-name 要素を使用する。
<dispatch-policy>
省略可能
この要素は非推奨。実行キュー名を指定して、ある特定のサーブレットを割り当てるためにコンフィグレーションされた execute-queue に使用する。この設定は、wl-dispatch-policy で定義した Web アプリケーション レベルのディスパッチ ポリシーをオーバーライドする。

 

work-manager

work-manager 要素は <weblogic-web-app> 要素の下位要素です。work-manager 要素の内部には以下の要素を定義できます。

要素
必須/
省略可能
説明
name
必須
ワーク マネージャの名前を指定する。
response-time-request-class / fair-share-request-class / context-request-class / request-class-name
省略可能
以下の 4 つの要素から選択できる。
response-time-request-class - アプリケーションの応答時間リクエスト クラスを定義する。応答時間は goal-ms 属性にミリ秒単位で定義する。増分は ((目標値 - T) Cr)/R。T は平均スレッド使用時間、R は到着率、Cr はフェア シェアよりも応答時間目標値を優先させるための係数。
fair-share-request-class - フェア シェア リクエスト クラスを定義する。フェア シェアは、デフォルト シェアに対する属性値の割合で定義される。したがって、デフォルトは 100 になる。増分は Cf/(P R T)。P は割合、R は到着率、T は平均スレッド使用時間、C f はフェア シェアの優先順位を応答時間目標値よりも低くするための係数。
context-request-class - コンテキスト クラスを定義する。コンテキスト情報 (現在のユーザまたはそのロール、クッキー、作業領域などのフィールド) をサービス クラス名にマッピングした複数のケースを指定して、コンテキストを定義する。
request-class-name - リクエスト クラス名を定義する。
min-threads-constraint、min-threads-constraint-name
省略可能
以下の 2 つの要素から選択できる。
min-threads-constraint - 制約対象の作業セットのリクエストに割り当てられるスレッドの数を確保して、デッドロックを回避するために使用する。デフォルトはゼロ。min-threads の値を 1 に設定すると、ピアから同期的に呼び出されるレプリケーション更新リクエストなどの場合に便利。
min-threads-constraint-name - min-threads-constraint 要素の名前を定義する。
max-threads-constraint、max-threads-constraint-name
省略可能
以下の 2 つの要素から選択できる。
max-threads-constraint - 制約対象の作業セットからのリクエストを実行する同時スレッドの数を制限する。デフォルトは無制限。たとえば、最大スレッド数が 10 に定義された制約を 3 つのエントリ ポイントで共有するとする。このスケジューリング ロジックでは、3 つのエントリ ポイントからのリクエストを 10 個以下のスレッドで実行する。
max-threads-constraint-name - max-threads-constraint 要素の名前を定義する。
capacity、capacity-name
省略可能
以下の 2 つの要素から選択できる。
capacity - 制約を定義して、「制約対象の作業セット」と呼ばれるエントリ ポイントのセットに適用できる。この容量に達した場合にのみ、サーバはリクエストの拒否を開始する。デフォルトはゼロ。容量には、制約対象の作業セットからの全リクエスト (キューにあるリクエストと実行中のリクエスト) が含まれる。この制約は、独自にフロー制御を行う JMS のようなサブシステムを主な対象としている。この制約は、グローバル キューのしきい値とは無関係。
capacity-name - capacity 要素の名前を定義する。

 

logging

logging 要素は <weblogic-web-app> 要素の下位要素です。logging 要素の内部には以下の要素を定義できます。

要素
必須/
省略可能
説明
log-filename
必須

ログ ファイルの名前を指定する。ファイル名は絶対アドレスで指定する必要がある。

logging-enabled
省略可能

ManagedConnectionFactory または ManagedConnection に対してログ ライターが設定されているかどうかを示す。この要素を true に設定すると、ManagedConnectionFactory または ManagedConnection から生成された出力は、log-filename 要素で指定したファイルに送られる。

この値を指定しないと、WebLogic Server では定義されているデフォルト値が使用される。

値の範囲 : true または false。

デフォルト値 : false
rotation-type
省略可能
ファイルのローテーション タイプを設定する。
指定できる値は bySize、byName、none。
  • bySize - ログ ファイルが file-size-limit に指定したサイズに達すると、ファイル名が FileName.n に変更される。
  • byName - file-time-span に指定する時間が経過するたびに、ファイル名が FileName.n に変更される。ファイル名が変更されると、以後のメッセージは log-filename に指定した名前の新しいファイルに蓄積される。
  • none - メッセージは 1 つのファイルに蓄積される。サイズが大きくなった場合、ファイルの内容を消去する必要がある。
デフォルト値 : bySize
number-of-files-limited
省略可能
当該サーバ インスタンスで、古いメッセージの保存用に作成するファイルの数を制限するかどうかを指定する (rotation-type で bySize を指定する必要がある)。この制限に達すると、最も古いファイルが上書きされる。このオプションを有効にしない場合、新しいファイルが無制限に作成されていくため、作成されたファイルを必要に応じて削除する必要がある。
number-of-files-limited を true に設定して有効化した場合、ログ ファイルのローテーション方法を判断するために rotationType 変数が参照される。ローテーションでは、新しいファイルを作成するのではなく、既存のファイルが上書きされる。number-of-files-limited を false に設定すると、同じログ ファイルを上書きせずに多数のログ ファイルが作成される。

値の範囲 : true または false。

デフォルト値 : false
file-count
省略可能
ログをローテーションする場合にサーバで作成されるログ ファイルの最大数。この数には、現在のメッセージを格納するためにサーバで使用されているファイルは含まれない (number-of-files-limited を有効にする必要がある)。
デフォルト値 : 7
file-size-limit
省略可能
サーバでログ メッセージを別のファイルに移動するきっかけとなるサイズ (rotation-type で bySize を指定する必要がある)。ログ ファイルが指定の最小サイズに到達すると、以後サーバは、ファイル サイズをチェックする際に、現在のログ ファイルの名前を FileName.n に変更し、それ以降のメッセージを保存するための新規ログ ファイルを作成する。
デフォルト値 : 500
rotate-log-on-startup
省略可能
起動サイクル中にサーバでログ ファイルがローテーションされるかどうかを指定する。
値の範囲 : true または false。
デフォルト値 : true
log-file-rotation-dir
省略可能
ローテーションされたログ ファイルが格納されるディレクトリ パスを指定する。
rotation-time
省略可能
ログ ファイルの時間ベースのローテーションの開始時間。フォーマットは k:mm。k は 1 ～ 24。rotation-type で byTime を指定する必要がある。指定された時間に、現在のログ ファイル名が変更される。以後、file-time-span で指定した間隔でログ ファイル名が変更される。
指定した時間が既に過ぎている場合、サーバは直ちにファイルのローテーションを開始する。
デフォルトでは、ローテーション サイクルは直ちに開始される。
file-time-span
省略可能
古いログ メッセージが別のファイルに移される間隔 (単位は時間)。rotation-type で byTime を指定する必要がある。
デフォルト値 : 24

 

library-ref

library-ref 要素では、現在の Web アプリケーションの Web アプリケーション ライブラリとして使用されるライブラリ モジュールを参照します。

次に例を示します。 

<library-ref>
     <library-name>WebAppLibraryFoo</library-name>
     <specification-version>2.0</specification-version>
     <implementation-version>8.1beta</implementation-version>
     <exact-match>false</exact-match>
</library-ref>

Web アプリケーションに関連する下位要素は library-name、specification-version、implementation-version、および exact-match のみです。

library-ref 要素の内部には以下の要素を定義できます。

要素
必須/
省略可能
説明
library-name
必須
ライブラリ モジュールの参照用にライブラリの名前を提供する。デフォルト値は null。
specification-version
必須
ライブラリ モジュールの参照用に仕様のバージョンを提供する。デフォルト値は 0 (これは float)。
implementation-version
必須
ライブラリ モジュールの参照用に実装のバージョンを提供する。デフォルト値は null。
exact-match
必須
デフォルト値は false。

 

下位互換性フラグ

WebLogic Server 9.0 よりも前のリリースの動作に戻せるように、複数の下位互換性フラグが追加されています。これらのフラグの詳細なリストや説明、また Web アプリケーション、JSP、およびサーブレットの下位互換性については、『WebLogic のアプリケーション環境のアップグレード』の「旧リリースとの互換性」を参照してください。

 

Web コンテナのグローバル コンフィグレーション

Web コンテナをグローバル レベルでコンフィグレーションするには、WebAppContainerMBean を使用します。WebAppContainerMBean の属性と、それを使用してすべての Web アプリケーションに対しドメイン全体のデフォルトを指定する方法については、http://edocs.beasys.co.jp/e-docs/wls/docs92/wlsmbeanref/mbeans/WebAppContainerMBean.html で WebAppContainerMBean を参照してください。


  ページの先頭       前  次