JavaのWebアプリケーションは、URLをサーブレットにマップする方法を決定するために配備記述子(Deployment descriptor)ファイルを使用する。配備記述子ファイルはweb.xmlというファイル名で、WEB-INFディレクトリ下に配置される。
Java EE配備記述子スキーマのXML名前空間はhttp://xmlns.jcp.org/xml/ns/javaeeである。
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の要素を次の表に示す。
Element | Description |
---|---|
web-app | 配備記述子のルート要素 |
context-param | Webアプリケーションの初期化パラメータ |
listener | リスナの定義 |
context-param要素の親要素はweb-appである。
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要素の親要素はweb-appである。
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>