WebLogic Server Web アプリケーションの開発
web.xml デプロイメント記述子の要素
web.xml ファイルのルート要素 <web-app> に定義するデプロイメント記述子の要素について説明します。
icon 要素では、GUI ツールで Web アプリケーションを表示する場合に使用される画像 (小さいアイコンと大きいアイコン) の、Web アプリケーション内での位置を指定します (servlet 要素にも icon という要素があり、GUI ツール内にアイコンを提供してサーブレットを表すために使用されます)。
icon 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<small-icon>
|
|
.gif 画像または .jpg 画像の位置。この要素は現在、WebLogic Server では使用されていない。
|
|
<large-icon>
|
|
.gif 画像または .jpg 画像の位置。この要素は現在、WebLogic Server では使用されていない。
|
display-name 要素では、Web アプリケーションの表示名 (GUI ツールで表示できる短い名前) を指定します。
|
|
省略可能
|
|
|
<display-name>
|
|
|
|
|
省略可能
|
|
|
<description>
|
|
|
|
|
省略可能
|
|
|
<distributable>
|
|
|
context-param 要素には、Web アプリケーションのサーブレット コンテキストの初期化パラメータの宣言が含まれます。次の表では、Web アプリケーション コンテナが使用する予約済みのコンテキスト パラメータについて説明します。これらは非推奨となり、weblogic.xml で置き換えられました。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
context-param パラメータは引き続き有効です。
|
|
省略可能
|
|
|
weblogic.httpd.
clientCertProxy
|
|
HttpClusterServlet によって送信される特別な WL-Proxy-Client-Cert ヘッダに、Web アプリケーションのクライアントからの証明書を含めることを指定する。
clientCertProxy を設定すると、WL-Proxy-Client-Cert という特別なヘッダでクラスタに証明書が渡される。
WL-Proxy-Client-Cert ヘッダは、WebLogic Server にアクセスする、どのクライアントでも指定できる。WebLogic Server は、安全なソース (プラグイン) からのものであることを信用してヘッダの証明書情報を受け取り、その情報を使用してユーザを認証する。
clientCertProxy を設定した場合は、接続フィルタを使用して、このプラグインが実行しているマシンからの接続のみを WebLogic Server が受け入れるようにする必要がある。『WebLogic Security プログラマーズ ガイド』の「ネットワーク接続フィルタの使い方」を参照。
|
|
|
省略可能
|
|
|
<icon>
|
|
|
|
<filter-name>
|
|
|
|
<display-name>
|
|
|
|
<description>
|
|
|
|
<filter-class>
|
|
|
|
<init-param>
|
|
<init-param> タグの別個のセットを使用する。
|
filter-mapping 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<filter-name>
|
|
<filter-name> 要素で <filter> 要素に割り当てられている名前に対応する。
|
|
<url-pattern>
|
<servlet> によってマップされる
|
http://host:port (「host」はホスト名、「port」はポート番号) + ContextPath に続く URL の部分は、WebLogic Server によって <url-pattern> と比較される。パターンが一致すれば、この要素でマップされているフィルタが呼び出される。
/soda/grape/*
/foo/*
/contents
*.foo
|
|
|
<url-pattern> によってマップされる
|
|
|
|
省略可能
|
|
|
<listener-class>
|
|
|
servlet 要素では、サーブレットの宣言的なデータを指定します。
<jsp-file> 要素および <load-on-startup> 要素が指定されている場合、その JSP は、WebLogic Server の起動時にあらかじめコンパイルされ、ロードされます。
|
|
省略可能
|
|
|
<icon>
|
|
|
|
<servlet-name>
|
|
|
|
<display-name>
|
|
|
|
<description>
|
|
|
|
<servlet-class>
|
<jsp-file> を使用する)
|
<servlet-class> タグまたは <jsp-file> タグのいずれか一方のみを使用する。
|
|
<jsp-file>
|
<servlet-class> を使用する)
|
<servlet-class> タグまたは <jsp-file> タグのいずれか一方のみを使用する。
|
|
<init-param>
|
|
<init-param> タグの別個のセットを使用する。
|
|
<load-on-startup>
|
|
|
|
|
|
|
|
<security-role-
ref>
|
|
<security-role> で定義されたセキュリティ ロール名を、サーブレットのロジックでハード コード化される代替ロール名にリンクする場合に使用される。この特別な抽象化レイヤによって、サーブレット コードを変更しなくてもデプロイメント時にサーブレットをコンフィグレーションできるようになる。
|
icon 要素では、GUI ツールで Web アプリケーションを表示する場合に使用される画像 (小さいアイコンと大きいアイコン) の、Web アプリケーション内での位置を指定します。
icon 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<small-icon>
|
|
.gif 画像または .jpg 画像の Web アプリケーション内での位置を指定する。
|
|
<large-icon>
|
|
.gif 画像または .jpg 画像の Web アプリケーション内での位置を指定する。
|
init-param 要素では、サーブレットの初期化属性の名前と値の組み合わせを指定します。属性ごとに init-param タグの別個のセットを使用します。
javax.servlet.ServletConfig.getInitParameter() メソッドを使用して、これらの属性にアクセスできます。
init-param 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<param-name>
|
|
|
|
<param-value>
|
|
String 値を定義する。
|
|
<description>
|
|
|
security-role-ref 要素は、<security-role> で定義されたセキュリティ ロール名を、サーブレットのロジックでハード コード化される代替ロール名にリンクします。この特別な抽象化レイヤによって、サーブレット コードを変更しなくてもデプロイメント時にサーブレットをコンフィグレーションできるようになります。
security-role-ref 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<role-name>
|
|
|
|
<role-link>
|
|
<security-role> 要素で定義されるセキュリティ ロールの名前を定義する。
|
servlet-mapping 要素では、サーブレットと URL パターンの間のマッピングを定義します。
servlet-mapping 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<servlet-name>
|
|
<servlet> 宣言タグでサーブレットに割り当てた名前に対応する。
|
|
<url-pattern>
|
|
http://host:port (「host」はホスト名、「port」はポート番号) + WebAppName に続く URL の部分は、WebLogic Server によって <url-pattern> と比較される。パターンが一致すれば、この要素でマップされているサーブレットが呼び出される。
/soda/grape/*
/foo/*
/contents
*.foo
|
session-config 要素では、Web アプリケーションのセッション属性を定義します。
session-config 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<session-timeout>
|
|
weblogic.xml の <session-descriptor> 要素の TimeoutSecs 属性に設定された値をオーバーライドする。
|
mime-mapping 要素では、拡張子と MIME タイプの間のマッピングを定義します。
mime-mapping 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<extension>
|
|
txt)。
|
|
<mime-type>
|
|
text/plain)。
|
welcome-file-list 要素では、welcome-file 要素の順序付きリストを指定します。
welcome-file-list 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<welcome-file>
|
|
|
error-page 要素では、エラーコードや例外のタイプと Web アプリケーションにあるリソースのパスの間のマッピングを指定します。
error-page 要素内で定義できる要素について説明します。
<error-code> と <exception-type> のどちらかを定義します。両方は定義しないでください。
|
|
省略可能
|
|
|
<error-code>
|
|
404)。
|
|
<exception-type>
|
|
java.lang.string)。
|
|
<location>
|
|
/myErrorPg.html)。
|
taglib 要素では、JSP タグ ライブラリを記述します。
WEB-INF ディレクトリを基準にした相対位置にある JSP 内に指定できますが、Web アプリケーションをデプロイするときに、<taglib> タグを使用して TLD をコンフィグレーションすることもできます。TLD ごとに別個の要素を使用します。
taglib 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<taglib-location>
|
|
WEB-INF ディレクトリの下に格納して、HTTP リクエストを通じて外部から入手できないようにしたほうがよい。
|
|
<taglib-uri>
|
|
|
|
|
省略可能
|
|
|
<description>
|
|
|
|
<resource-env-ref-name>
|
|
|
|
|
|
|
resource-ref 要素では、外部リソースへの参照ルックアップ名を定義します。この定義により、サーブレット コードは、デプロイメント時に実際の位置にマップされる「仮想的な」名前でリソースをルックアップできるようになります。
<resource-ref> 要素を使用します。外部リソース名は、デプロイメント時に WebLogic 固有のデプロイメント記述子 weblogic.xml でリソースの実際の位置名にマップされます。
resource-ref 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<res-ref-name>
|
|
|
|
<res-type>
|
|
|
|
<res-auth>
|
|
APPLICATION を指定した場合、アプリケーション コンポーネント コードによってプログラムでリソース サインオンが行われる。CONTAINER を指定した場合、WebLogic Server では、login-config 要素で定義されたセキュリティ コンテキストが使用される。「login-config」を参照。
|
|
<res-sharing-scope>
|
|
|
security-constraint 要素では、<web-resource-collection> 要素で定義されたリソースの集合へのアクセス特権を定義します。
|
|
省略可能
|
|
|
<web-resource-
collection>
|
|
|
|
<auth-constraint>
|
|
|
|
<user-data-
constraint>
|
|
|
<security-constraint> 要素では、1 つまたは複数の <web-resource-collection> 要素が必要です。 これらの要素では、このセキュリティ制約が適用される Web アプリケーションの領域を定義します。
|
|
省略可能
|
|
|
<web-resource-
name>
|
|
|
|
<description>
|
|
|
|
<url-pattern>
|
|
<url-pattern> 要素を 1 つまたは複数使用して、このセキュリティ制約の適用先となる URL パターンを宣言する。 この要素を 1 つも使用しない場合、この <web-resource-collection> は WebLogic Server から無視される。
|
|
<http-method>
|
|
<http-method> 要素を 1 つまたは複数使用して、認可制約の対象になる HTTP メソッド (通常は GET または POST) を宣言する。 <http-method> 要素を省略した場合には、デフォルトの動作として、セキュリティ制約がすべての HTTP メソッドに適用される。
|
auth-constraint 要素では、このセキュリティ制約で定義された Web リソースの集合にアクセスするグループまたはプリンシパルを定義します。
auth-constraint 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
user-data-constraint 要素では、クライアントによるサーバとの通信方法を定義します。
user-data-constraint 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<transport-
guarantee>
|
|
INTEGRAL または CONFIDENTIAL の転送保証を使用してユーザが認証を受けた場合、WebLogic Server はセキュア ソケット レイヤ (SSL) 接続を確立する。
|
login-config 要素を使って、ユーザの認証方法、このアプリケーションで使用されるレルムの名前、およびフォームによるログイン機能で必要になる属性をコンフィグレーションします。
<security-constraint> によって制約されたすべてのリソースにアクセスするには、認証を受ける必要があります。 認証されると、ユーザは、ほかのリソースにアクセスする権限が与えられる場合もあります。
login-config 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<auth-method>
|
|
BASIC - ブラウザ認証を使用する (これがデフォルト値である)。
FORM ユーザが作成した HTML フォーム
CLIENT-CERT を使用する。
|
|
<realm-name>
|
|
<realm-name> 要素は WebLogic Server 内のシステム セキュリティ レルムを参照しない。 この要素では HTTP ベーシック認証で使用するレルム名を定義する。 システム セキュリティ レルムは、サーバで何らかの操作が実行されるときにチェックされるセキュリティ情報の集合。 サーブレット セキュリティ レルムは、ページがアクセスされてベーシック認証が使用されるときにチェックされる、セキュリティ情報の別の集合。
|
|
<form-login-
config>
|
|
<auth-method> を FORM にコンフィグレーションする場合に、この要素を使用する。 「form-login-config」を参照。
|
<auth-method> を FORM にコンフィグレーションする場合に、<form-login-config> 要素を使用します。
|
|
省略可能
|
|
|
<form-login-page>
|
|
|
|
<form-error-page>
|
|
|
security-role 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<role-name>
|
|
weblogic.xml で対応するエントリが必要になる。weblogic.xml によって、ロールはセキュリティ レルムにあるプリンシパルにマップされる。 詳細については、「security-role-assignment」を参照。
|
env-entry 要素では、アプリケーションの環境エントリを宣言します。 環境エントリごとに別個の要素を使用します。
env-entry 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<env-entry-name>
|
|
|
|
<env-entry-value>
|
|
|
|
<env-entry-type>
|
|
java.lang.Boolean
java.lang.String
java.lang.Integer
java.lang.Double
java.lang.Float
|
ejb-ref 要素では、EJB リソースへの参照を定義します。 この参照は、WebLogic 固有のデプロイメント記述子ファイル weblogic.xml でマッピングを定義することにより、デプロイメント時に EJB の実際の位置にマップされます。 各参照 EJB 名の定義には別々の <ejb-ref> 要素を使用します。
ejb-ref 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<ejb-ref-name>
|
|
weblogic.xml で JNDI ツリーにマップされる。 詳細については、「ejb-reference-description」を参照。
|
|
<ejb-ref-type>
|
|
|
|
<home>
|
|
|
|
<remote>
|
|
|
|
<ejb-link>
|
|
<ejb-name>。
|
|
|
|
<security-role> 要素で定義されたセキュリティ ロールである必要がある。
|
ejb-local-ref 要素内で定義できる要素について説明します。
|
|
省略可能
|
|
|
<description>
|
|
|
|
<ejb-ref-name>
|
|
|
|
<ejb-ref-type>
|
|
ejb-ref-type 要素には、参照されるエンタープライズ Bean の予期されるタイプが含まれる。 ejb-ref-type 要素は以下のいずれかでなければならない。
|
|
<local-home>
|
|
|
|
<local>
|
|
|
|
<ejb-link>
|
|
ejb-link 要素は、ejb-ref または ejb-local-ref 要素内で、
ejb-link 要素内の名前は、パス名で構成される。 このパス名には、参照先の EJB が含まれる ejb-jar、#、対象の Bean の ejb-name を順に指定する。
ejb-name を含む複数の EJB をユニークに識別することが可能である。
ejb-local-ref および ejb-ref 要素
|
