001--web.xml配置详解

1.web-app初始化过程

　　容器对于web.xml的加载过程是：
　　　　context-param >> listener >> fileter >> servlet　　

　　初始化过程：

　　　　1、容器读web.xml配置文件中的两个节点<listener>和<contex-param>。
　　　　2、接着容器会创建一个ServletContext(上下文),应用范围内即整个WEB项目都能使用这个上下文。
　　　　3、接着容器会将读取到<context-param>转化为键值对,并交给ServletContext。
　　　　4、容器创建<listener>中的类实例,即创建监听。
　　　　5、在监听的类中会有：
　　　　　　初始化方法：contextInitialized(ServletContextEvent event)
　　　　　　　　在这个方法中可以通过：event.getServletContext().getInitParameter("contextConfigLocation") 来得到context-param 设定的值。
　　　　　　销毁方法：contextDestroyed(ServletContextEvent event).
　　　　　　　　用于关闭应用前释放资源，比如说数据库连接的关闭。
　　　　6、加载含有子元素为load-on-startup的servelt。
　　　　　　load-on-startup：
　　　　　　　　当值为0或者大于0时，表示web容器在应用启动时就加载这个servlet。
　　　　　　　　当是一个负数时或者没有指定时，则指示容器在该servlet被选择时才加载。
　　　　　　　　正数的值越小，启动该servlet的优先级越高。

2.web-app

　　根元素web-app的子元素有：
　　　　icon
　　　　display-name
　　　　description
　　　　context-param
　　　　filter
　　　　filter-mapping
　　　　listener
　　　　servlet
　　　　servlet-mapping
　　　　session-config
　　　　mime-mapping
　　　　welcome-file-list
　　　　error-page
　　　　taglib
　　　　resource-env-ref
　　　　resource-ref

3.icon

　　Web应用图标：指出IDE和GUI工具用来表示Web应用的大图标和小图标。
　　<icon>
　　　　<small-icon>/images/app_small.gif</small-icon>
　　　　<large-icon>/images/app_large.gif</large-icon>
　　</icon>

4.display-name

　　Web 应用名称：提供GUI工具可能会用来标记这个特定的Web应用的一个名称。
　　<display-name>Tomcat Example</display-name>

5.disciption

　　Web 应用描述： 给出于此相关的说明性文本。
　　<disciption>
　　　　Tomcat Example servlets and JSP pages.
　　</disciption>

6.context-param

　　上下文参数：声明应用范围内的初始化参数。
　　<context-param>
　　　　<param-name>ContextParameter</para-name>
　　　　<param-value>test</param-value>
　　</context-param>

　　在servlet里面可以通过：
　　　　this.getServletContext().getInitParameter("ContextParameter ")得到test。

7.filter

　　过滤器配置：将一个名字与一个实现javaxs.servlet.Filter接口的类相关联。
　　<filter>
　　　　<filter-name>setCharacterEncoding</filter-name>
　　　　<filter-class>com.myTest.setCharacterEncodingFilter</filter-class>
　　　　<init-param>
　　　　　　<param-name>encoding</param-name>
　　　　　　<param-value>GB2312</param-value>
　　　　</init-param>
　　</filter>
　　<filter-mapping>
　　　　<filter-name>setCharacterEncoding</filter-name>
　　　　<url-pattern>/*</url-pattern>
　　</filter-mapping>

　　在servlet里面可以通过：
　　　　this. getInitParameter("encoding ")得到GB2312。

8.listener

监听器配置。
　　<listener>
　　　　<listerner-class>
　　　　　　listener.SessionListener
　　　　</listener-class>
　　</listener>

9.Servlet

　　<servlet>
　　　　<servlet-name>snoop</servlet-name>
　　　　<servlet-class>SnoopServlet</servlet-class>
　　　　<init-param>
　　　　　　<param-name>foo</param-name>
　　　　　　<param-value>bar</param-value>
　　　　</init-param>
　　</servlet>
　　<servlet-mapping>
　　　　<servlet-name>snoop</servlet-name>
　　　　<url-pattern>/snoop</url-pattern>
　　</servlet-mapping>

　　在servlet里面可以通过：
　　　　this. getInitParameter("foo ")得到bar。

10.session-config

　　会话超时配置（单位为分钟）
　　<session-config>
　　　　<session-timeout>120</session-timeout>
　　</session-config>

11.mime-mapping

　　如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。
　　< mime-mapping >
　　　　<extension>htm</extension>
　　　　<mime-type>text/html</mime-type>
　　</mime-mapping>

　　例如： TOMCAT在默认情况下下载.rar的文件是把文件当作text打开,以至于IE打开RAR文件为乱码，可以使用此方法解决。

12.welcome-file-list

　　指定欢迎文件页配置。
　　<welcome-file-list>
　　　　<welcome-file>index.jsp</welcome-file>
　　　　<welcome-file>index.html</welcome-file>
　　　　<welcome-file>index.htm</welcome-file>
　　</welcome-file-list>

13.error-page

　　配置错误页面

　　13.1.通过错误码来配置

　　　　<error-page>
　　　　　　<error-code>404</error-code>
　　　　　　<location>/NotFound.jsp</location>
　　　　</error-page>
　　　　上面配置了当系统发生404错误时，跳转到错误处理页面NotFound.jsp。

　　13.2. 通过异常的类型配置

　　　　<error-page>
　　　　　　<exception-type>java.lang.NullException</exception-type>
　　　　　　<location>/error.jsp</location>
　　　　</error-page>
　　　　上面配置了当系统发生java.lang.NullException（即空指针异常）时，跳转到错误处理页面error.jsp

14.taglib

　　对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置， 而不用编辑使用这些文件的JSP页面。
　　<taglib>
　　　　<taglib-uri>http://jakarta.apache.org/tomcat/debug-taglib</taglib-uri>
　　　　<taglib-location>/WEB-INF/jsp/debug-taglib.tld</taglib-location>
　　</taglib>

　　如果MyEclipse(Eclipse)一直在报错,应该把<taglib> 放到 <jsp-config>中 。
　　<jsp-config>
　　　　<taglib>
　　　　　　<taglib-uri>http://jakarta.apache.org/tomcat/debug-taglib</taglib-uri>
　　　　　　<taglib-location>/WEB-INF/pager-taglib.tld</taglib-location>
　　　　</taglib>
　　</jsp-config>

15.resource-env-ref

　　资源管理对象配置 。
　　<resource-env-ref>
　　　　<resource-env-ref-name>jms/StockQueue</resource-env-ref-name>
　　</resource-env-ref>

16.resource-ref

　　资源工厂配置。
　　<resource-ref>
　　　　<res-ref-name>mail/Session</res-ref-name>
　　　　<res-type>javax.mail.Session</res-type>
　　　　<res-auth>Container</res-auth>
　　</resource-ref>

　　配置数据库连接池就可在此配置：
　　<resource-ref>
　　　　<description>JNDI JDBC DataSource of shop</description>
　　　　<res-ref-name>jdbc/sample_db</res-ref-name>
　　　　<res-type>javax.sql.DataSource</res-type>
　　　　<res-auth>Container</res-auth>
　　</resource-ref>

17.security-constraint

　　安全限制配置: 制定应该保护的URL。它与login-config元素联合使用。
　　<security-constraint>
　　　　<display-name>Example Security Constraint</display-name>
　　　　<web-resource-collection>
　　　　　　<web-resource-name>Protected Area</web-resource-name>
　　　　　　<url-pattern>/jsp/security/protected/*</url-pattern>
　　　　　　<http-method>DELETE</http-method>
　　　　　　<http-method>GET</http-method>
　　　　　　<http-method>POST</http-method>
　　　　　　<http-method>PUT</http-method>
　　　　</web-resource-collection>
　　　　<auth-constraint>
　　　　　　<role-name>tomcat</role-name>
　　　　　　<role-name>role1</role-name>
　　　　</auth-constraint>
　　</security-constraint>

18.login-config

　　登陆验证配置 : 指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。
　　<login-config>
　　　　<auth-method>FORM</auth-method>
　　　　<realm-name>Example-Based Authentiation Area</realm-name>
　　　　<form-login-config>
　　　　　　<form-login-page>/jsp/security/protected/login.jsp</form-login-page>
　　　　　　<form-error-page>/jsp/security/protected/error.jsp</form-error-page>
　　　　</form-login-config>
　　</login-config>

19.security-role

　　安全角色：security-role元素给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。
　　分别地声明角色可使高级IDE处理安全信息更为容易。
　　<security-role>
　　　　<role-name>tomcat</role-name>
　　</security-role>

20.env-entry

　　Web环境参数：env-entry元素声明Web应用的环境项 。
　　<env-entry>
　　　　<env-entry-name>minExemptions</env-entry-name>
　　　　<env-entry-value>1</env-entry-value>
　　　　<env-entry-type>java.lang.Integer</env-entry-type>
　　</env-entry>

21.ejb-ref

　　声明一个EJB的主目录的引用 。
　　<ejb-ref>
　　　　<description>Example EJB reference</decription>
　　　　<ejb-ref-name>ejb/Account</ejb-ref-name>
　　　　<ejb-ref-type>Entity</ejb-ref-type>
　　　　<home>com.mycompany.mypackage.AccountHome</home>
　　　　<remote>com.mycompany.mypackage.Account</remote>
　　</ejb-ref>

22.ejb-local-ref

　　声明一个EJB的本地主目录的应用。
　　<ejb-local-ref>
　　　　<description>Example Loacal EJB reference</decription>
　　　　<ejb-ref-name>ejb/ProcessOrder</ejb-ref-name>
　　　　<ejb-ref-type>Session</ejb-ref-type>
　　　　<local-home>com.mycompany.mypackage.ProcessOrderHome</local-home>
　　　　<local>com.mycompany.mypackage.ProcessOrder</local>
　　</ejb-local-ref>