webapp配置文件之web.xml
-
- web-app下的welcome-file-list
- web-app下的filter
- web-app下的filter-mapping
- web-app下的listener
- web-app下的error-page
- web-app下的env-entry
- web-app下的security-role
- web-app下的security-constraint
- web-app下的login-config
- web-app下的mime-mapping
- web-app下的locale-encoding-mapping-list
- web-app下的resource-env-ref
- web-app下的resource-ref
- web-app下的ejb-ref
- web-app下的ejb-local-ref
web-app下的welcome-file-list
welcome-file-list
包含welcome-file
的有序列表。
当URL请求是目录名称时,将提供welcome-file
列表中指定的第一个文件。 如果找不到该文件,则服务器将尝试列表中的下一个文件。
元素 | 必需/选用 | 描述 |
---|---|---|
<welcome-file> |
选用 | 首页文件名(welcome文件的文件名),例如index.html |
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
web-app下的filter
filter
定义了一个过滤器类及其初始化属性。
元素 | 必需/选用 | 描述 |
---|---|---|
<description> |
选用 | 描述Web应用程序的文本 |
<display-name> |
选用 | 指定Web应用程序的显示名称。 |
<icon> |
选用 | 指定Web应用程序中用于在GUI工具中表示filter的大小图像的位置。 |
<filter-name> |
必需 | 定义过滤器的名称,用于引用部署描述符中其他位置的过滤器定义。 |
<filter-class> |
必需 | 过滤器的全类名。 |
<init-param> |
选用 | 包含一个name/value 键值对,作为Servlet的初始化属性。 |
<filter>
<description>...</description>
<display-name>...</display-name>
<icon>...</icon>
<filter-name>Set Character Encoding</filter-name>
<filter-class>filters.SetCharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
filter下的description
描述Web应用程序的文本
filter下的display-name
指定Web应用程序的显示名称。
filter下的icon
指定Web应用程序中用于在GUI工具中表示filter的大小图像的位置。
filter下的filter-name
定义过滤器的名称。
<filter>
<filter-name>filterName</filter-name>
<filter-class>filters.SetCharacterEncodingFilter</filter-class>
</filter>
filter下的filter-class
过滤器的全类名。
<filter>
<filter-name>filterName</filter-name>
<filter-class>filters.SetCharacterEncodingFilter</filter-class>
</filter>
filter下的init-param
过滤器的初始化属性。
<filter>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
init-param下的param-name
过滤器的初始化属性的属性名。
init-param下的param-value
过滤器的初始化属性的属性值。
web-app下的filter-mapping
元素 | 必需/选用 | 描述 |
---|---|---|
<filter-name> |
必需 | url 模式或servlet 映射的过滤器的名称 |
<url-pattern> |
必需 (或者通过<servlet> 映射) |
用于解析URL的一个模式。如果模式匹配,则调用此元素中映射的过滤器。 |
<servlet-name> |
必需(或者通过<url-pattern> 映射) |
servlet的名称,如果被调用,将导致该过滤器执行。 |
<filter-mapping>
<filter-name>Set Character Encoding</filter-name>
<url-pattern>/*</url-pattern>
<servlet-name>myServlet</servlet-name>
</filter-mapping>
注:<url-pattern>
和<servlet-name>
可以同时定义,但是不推荐这样做。
filter-mapping下的filter-name
<filter-mapping>
<filter-name>Set Character Encoding</filter-name>
<url-pattern>/*</url-pattern>
<!-- 不推荐同时定义url-pattern和servlet-name
<servlet-name>myServlet</servlet-name>
-->
</filter-mapping>
filter-mapping下的url-pattern
<filter-mapping>
<filter-name>Set Character Encoding</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
filter-mapping下的servlet-name
<filter-mapping