web.xml

JavaのWebアプリケーションは、URLをサーブレットにマップする方法を決定するために配備記述子(Deployment descriptor)ファイルを使用する。配備記述子ファイルはweb.xmlというファイル名で、WEB-INFディレクトリ下に配置される。

web.xmlの名前空間

Java EE配備記述子スキーマのXML名前空間はhttp://xmlns.jcp.org/xml/ns/javaeeである。

web.xmlのサンプル

web.xmlはXML形式で記述する。

web.xmlの例を次に示す。

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1>

web.xmlの要素

web.xmlの要素を次の表に示す。

web.xmlの要素
Element Description
web-app 配備記述子のルート要素
context-param Webアプリケーションの初期化パラメータ
listener リスナの定義

context-param

context-param要素の親要素はweb-appである。

context-paramの子要素
Element Description 個数
param-name パラメータの名前 1
param-value パラメータの値 1
description パラメータの説明 0以上

context-paramの例を次に示す。

<context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

listener

listener要素の親要素はweb-appである。

listenerの子要素
Element Description 個数
description リスナの説明 0以上
display-name ツールで表示されるリスナの名前 0以上
icon ツールで表示される画像 0以上
listener-class リスナインタフェースを実装したServletクラス 1

listenerの例を次に示す。

<listener>
  <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>