web.xml配置文件
filter
<!--过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联--> <filter> <!--声明描述信息--> <description></description> <!--用于定义Web应用的名称--> <display-name></display-name> <!--用于指定当前filter对应的类的路径--> <filter-class></filter-class> <!--用于对当前filter取一个名称,以便在后面的映射时使用--> <filter-name></filter-name> <!--指定应用的大图标和小图标--> <icon></icon> <!--用于指定当前filter的一些初始化参数--> <init-param></init-param> </filter> <filter-mapping> <!--该元素有四个可能的值:即REQUEST(默认),FORWARD,INCLUDE和ERROR,可以在一个<filter-mapping>元素中加入任意数目的<dispatcher>,
使得filter将会作用于直接从客户端过来的request,通过forward过来的request,通过include过来的request和通过<error-page>过来的request。
如果没有指定任何< dispatcher >元素,默认值是REQUEST --> <dispatcher></dispatcher> <!--用于指定上文定义的filter名称--> <filter-name></filter-name> <!--用于指定上文定义的servlet名称--> <servlet-name></servlet-name> <!--描述用于解析URL的模式--> <url-pattern></url-pattern> </filter-mapping>
servlet
<!--在向servlet或JSP页面制定初始化参数或定制URL时,必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的--> <servlet> <!--声明描述信息--> <description></description> <!--用于定义Web应用的名称--> <display-name></display-name> <!--指定应用的大图标和小图标--> <icon></icon> <!--用于指定servlet的一些初始化参数--> <init-param></init-param> <!--用于指定一个jsp页面来对该servlet进行初始化--> <jsp-file></jsp-file> <!--用于指定应用启动时加载的优先级--> <load-on-startup></load-on-startup> <!--该元素指定了该web应用程序运行时所需用的运行身份--> <run-as></run-as> <!--该元素将 <security-role> 定义的安全角色名链接到使用Servlet逻辑进行硬编码的备用角色名。
使用此附加提取层,可以在部署时配置Servlet,且不必更改Servlet 代码--> <security-role-ref></security-role-ref> <!--用于指定当前servlet对应的类的路径--> <servlet-class></servlet-class> <!--用于对当前servlet取一个名称,以便在后面的映射时使用--> <servlet-name></servlet-name> </servlet> <!--服务器一般为servlet提供一个缺省的URL:http://localhost/webAppPrefix/servlet/ServletName。
但是,常常会更改这个URL,以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时,使用servlet-mapping元素--> <servlet-mapping> <!--用于指定上文配置的servlet的名称--> <servlet-name></servlet-name> <!--描述用于解析URL的模式--> <url-pattern></url-pattern> </servlet-mapping>
context-param
<!--该元素声明应用范围内的初始化参数--> <context-param> <!--声明描述信息--> <description></description> <!--用于指定上下文参数的名称--> <param-name></param-name> <!--用于指定上下文参数的值--> <param-value></param-value> </context-param>
listener
<!--事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类--> <listener> <!--声明描述信息--> <description></description> <!--用于定义Web应用的名称--> <display-name></display-name> <!--指定应用的大图标和小图标--> <icon></icon> <!--用于指定监听器的类(完整路径)--> <listener-class></listener-class> </listener>
error-page
<!--在返回特定HTTP状态代码时,或者特定类型的异常被抛出时,能够制定将要显示的页面--> <error-page> <!--用于指定Http的错误代码--> <error-code></error-code> <!--用于指定程序中的异常(异常的完整路径)--> <exception-type></exception-type> <!--用于指定程序出现错误时,跳转到的页面--> <location></location> </error-page>
description
<!--声明WEB应用的描述信息--> <description></description>
display-name
<!--定义了WEB应用的名字--> <display-name></display-name>
welcome-file-list
<!--指示服务器在收到引用一个目录名而不是文件名的URL时,使用哪个文件--> <welcome-file-list> <!--用于指定欢迎页面的路径--> <welcome-file></welcome-file> </welcome-file-list>
web.xml常用组件解析
<web-app> <display-name></display-name>WEB应用的名字 <description></description> WEB应用的描述 <context-param></context-param> context-param元素声明应用范围内的初始化参数 <!– 指定spring配置文件位置 –> <context-param> <param-name>contextConfigLocation</param-name> <param-value> <!–加载多个spring配置文件 –> /WEB-INF/applicationContext.xml, /WEB-INF/action-servlet.xml </param-value> </context-param> <filter></filter> 过滤器将一个名字与一个实现javax.servlet.Filter接口的类相关联 <filter-mapping></filter-mapping> 一旦命名了一个过滤器,就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联 <listener></listener> 事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类。 <!– 定义SPRING监听器,加载spring –> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <servlet></servlet> 在向servlet或JSP页面制定初始化参数或定制URL时,必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。 <servlet-mapping></servlet-mapping> 服务器一般为servlet提供一个缺省的URL:http://host/webAppPrefix/servlet/ServletName。但是,常常会更改这个URL,以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时,使用servlet-mapping元素 <session-config></session-config> 如果某个会话在一定时间内未被访问,服务器可以抛弃它以节省内存。 可通过使用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值,或者可利用session-config元素制定缺省超时值 <mime-mapping></mime-mapping>如果Web应用具有想到特殊的文件,希望能保证给他们分配特定的MIME类型,则mime-mapping元素提供这种保证 <welcome-file-list></welcome-file-list> 指示服务器在收到引用一个目录名而不是文件名的URL时,使用哪个文件(其实就是欢迎界面或者说入口界面一般为index.*) <error-page></error-page> 在返回特定HTTP状态代码时,或者特定类型的异常被抛出时,能够制定将要显示的页面。 <taglib></taglib> 对标记库描述符文件(Tag Libraryu Descriptor file)指定别名。此功能使你能够更改TLD文件的位置, 而不用编辑使用这些文件的JSP页面。 <resource-env-ref></resource-env-ref>声明与资源相关的一个管理对象。 <resource-ref></resource-ref> 声明一个资源工厂使用的外部资源。 <security-constraint></security-constraint> 制定应该保护的URL。它与login-config元素联合使用 <login-config></login-config> 指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。 <security-role></security-role>给出安全角色的一个列表,这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易 <env-entry></env-entry>声明Web应用的环境项 </web-app>