アプリケーション・ナビゲータでのweb.xmlのポップアップ・メニュー 「開く」
「概要」タブ
「サーブレット」
Webアプリケーション・デプロイメント・ディスクリプタ(web.xml
)の一般情報を指定する場合に使用します。web.xml
ファイルでは、アプリケーションのWebアーカイブ(.war
)に含められたファイルを、ランタイムWebサーバーおよびWebブラウザでWebベース・アプリケーションを実装するために使用する方法が説明されます。Webアプリケーションのデプロイメント・ディスクリプタを構成して、実行時のWebアプリケーション・リソースを管理します。詳細
サーブレット
一般サーブレット
サーブレット・マッピング
初期化パラメータ
セキュリティ・ロール参照
サーブレットを作成して、サーブレット・クラス・ファイルまたはJSPに関連付ける際に使用します。
作成
新規のサーブレットを構成する場合にクリックします。
削除
既存のサーブレットをリストから削除する場合にクリックします。
名前
新規サーブレットの名前を入力します。サーブレット・クラス・ファイルまたはJSPファイルのいずれかの名前も入力する必要があります。
タイプ
サーブレットのタイプとして、「サーブレット・クラス」または「JSPファイル」を選択します。
サーブレット・クラス/JSPファイル
サーブレット・クラス・ファイルの完全修飾名、またはJSPファイルの名前を入力します。
サーブレットに宣言データを定義する際に使用します。オプションで、Webサーバーの起動時にサーブレットを初期化する順序を指定することもできます。
表示名
GUIツールによって表示される短縮名を入力します。このフィールドは、<display-name>
サブ要素に該当します。
説明
サーブレットのテキスト説明を入力します。このフィールドは、<description>
サブ要素に該当します。
サーブレットのロード
アプリケーション起動
アプリケーション起動時にこのWebアプリケーションを事前ロードする必要がある場合に選択します。
最初のリクエスト
最初のリクエスト時にこのWebアプリケーションをロードする必要がある場合に選択します。
ロード順序
(オプション)サーブレットをロードする順序を示す整数を入力します。小さい整数値を割り当てたサーブレットは大きい整数値を割り当てたものより先にロードされます。このフィールドは、<load-on-startup>
サブ要素に該当します。
デフォルト値の選択を解除します。値が指定されていない場合、または指定された値が正の整数でない場合、Webサーバーでは任意の順序でサーブレットをロードできます。値が正の整数または0の場合、Webサーバーではアプリケーションのデプロイ時にサーブレットがロードされ、初期化される必要があります。
特定のURLパターンをサーブレットまたはJSPファイルにリダイレクトする際に使用します。様々なURLパターンを同じサーブレット・クラスまたはJSPファイルに集めることは可能ですが、<init-param>
宣言はそれぞれ異なります。
注意: <servlet>
タグは<jsp-file>
を指すため、<servlet-mapping>
サブ要素でもURLパターンをJSPページにリダイレクトできます。
サブ要素<servlet-mapping>
は、web.xml
デプロイメント・ディスクリプタ定義の必須要素ではありません。
作成
新規のサーブレット・マッピングを構成する場合にクリックします。
削除
既存のサーブレット・マッピングをリストから削除する場合にクリックします。
URLパターン
(必須)Webアプリケーションの特定のサーブレットにマップするURLを入力します。URLのhttp://host:port<webappname>
より後の部分が、指定したパターンと比較されます。パターンが一致すると、この要素にマッピングされたサーブレットがコールされます。URLは、Javaサーブレット仕様バージョン2.3の第10項に指定されているルールに従っている必要があります。このフィールドは、<servlet-mapping
サブ要素の<servlet-mapping>
タグに該当します。
アプリケーションの特定のサーブレットまたはJSPに対して初期化パラメータを構成する際に使用します。
サブ要素<init-param>
は、web.xml
デプロイメント・ディスクリプタ定義の必須要素ではありません。
作成
新規の初期化パラメータを構成する場合にクリックします。
削除
既存の初期化パラメータをリストから削除する場合にクリックします。
名前
追加する初期化パラメータの名前を入力します。<init-param>
サブ要素の<param-name>
タグに該当します。
値
初期化パラメータの値を入力します。<init-param>
サブ要素の<param-value>
タグに該当します。
説明
(オプション)初期化パラメータの説明を入力します。<init-param>
サブ要素の<description>
タグに該当します。
サブ要素<security-role>
によって定義されたセキュリティ・ロール名を、サーブレットのアプリケーション・コードに指定した代替ロール名にリンクする際に使用します。この参照によって、アプリケーション・コードを変更せずに、デプロイメント時にサーブレットを構成できます。サブ要素<security-role-ref>
は、web.xml
デプロイメント・ディスクリプタ定義の必須要素ではありません。
作成
新規のセキュリティ・ロール参照を構成する場合にクリックします。
削除
既存のセキュリティ・ロール参照をリストから削除する場合にクリックします。
ロール名
サーブレット・コードに指定され、代替名と関連付けるセキュリティ・ロールの名前を入力します。このフィールドは、<security-role-ref>
サブ要素の<role-name>
タグに該当します。
ロール・リンク
代替名としてリンク先となるセキュリティ・ロールの名前を入力します。このフィールドは、<security-role-ref>
サブ要素の<role-link>
タグに該当します。入力する名前は、生成されたweb.xml
ファイルの<security-role>
サブ要素の<role-name>
タグによって定義される必要があります。既存のセキュリティ・ロール名を参照するには、このダイアログの左側にあるツリーから「セキュリティ」ノードを選択します。
説明
(オプション)代替セキュリティ・ロール名に関連付けるセキュリティ・ロールのテキスト説明を入力します。このフィールドは、<security-role-ref>
サブ要素の<description>
タグに該当します。
このエディタの他のページのヘルプについては、次のトピックを参照してください。
Copyright © 1997, 2009, Oracle. All rights reserved.