Webアプリケーション・デプロイメント・ディスクリプタの概要エディタ - サーブレット・ページ

アプリケーション・ナビゲータでの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>タグに該当します。

このエディタの他のページのヘルプについては、次のトピックを参照してください。


関連項目

アプリケーションのデプロイ

セキュアなアプリケーションの開発