java web编程web.xml详解

     一般的java web工程中都会用到web.xml，web.xml在Java web工程的WEB-INF目录下，web.xml主要的功能就是用来配置站点信息，主要的配置项有：①站台的名称和说明；②针对环境参数（Context）做初始化工作；③Servlet的配置（包括Filter、Listener、Servlet）；④Tag Library的对应；⑤JSP网页设定；⑥Mime Type处理；⑦错误处理；⑧利用JDNI获得站台资源等。但是要说明的是web.xml并不是必须的，一个java web工程可以没有web.xml文件。 

一、认识web.xml中的配置元素

     在web.xml中所需的配置元素都在<web-app>元素内，下面的列表给出了所有可直接出现在<web-app>元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet-mapping元素之前。请注意，所有这些元素都是可选的。因此，可以省略掉某一元素，但不能把它放于不正确的位置。 

1、站点描述配置元素

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

②<description>----Web应用描述。给出于此相关的说明性文本。

③<icon>----该元素包含small-icon和large-icon两个子元素，用来指定web站台中小图标和大图标的路径。

<display-name>Develop Example</display-name>
<description>JSP 2.0 Tech Book's Examples</description>
<icon>
   <small-icon>/images/small.gif</small-icon>
   <large-icon>/images/large.gir</large-icon>
</icon>

 2、设置web站点环境参数

①<context-param>----该元素声明应用范围内的初始化参数。它用于向 ServletContext提供键值对，即应用程序上下文信息。我们的listener, filter等在初始化时会用到这些上下文中的信息。在servlet里面可以通过getServletContext().getInitParameter("context/param")得到。它包含两个子元素:<param-name>和<param-value>

     ②<param-name>参数名称</param-name>----设定Context名称
     ③<param-value>值</param-value>----设定Context名称的值

<context-param>
    <param-name>my_param</param-name>
    <param-value>hello</param-value>
</context-param>

3、过滤器设置

①<filter>----过滤器。将一个名字与一个实现javaxs.servlet.Filter接口的类相关联。它包含以下子元素：

     ②<filter-name></filter-name> 这当然就是指定filter的名字
     ③<filter-class></filter-class> 这是用来定义filter的类的名称
     ④<init-param></init-param> 用来定义参数。它有两个子元素：

          ⑤<param-name></param-name> 用来指定参数的名称
          ⑥<param-value></param-value> 用来设定参数值

①<filter-mapping>----与<filter>同时使用,用来定义filter所对应的URL，它有两个子元素：

     ②<filter-name></filter-name> 指定filter的名字

     ③<url-pattern></url-pattern> 指定filter所对应的URL

<filter>
    <filter-name>setCharacterEncoding</filter-name>
    <filter-class>com.myTest.setCharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>setCharacterEncoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

4、监听器设置

①<llistener>----servlet API的版本2.3增加了对事件监听程序的支持，支持对：

(a)监听ServletContext、Request、Session作用域的创建和销毁

     ServletContextListener

     HttpSessionListener

     ServletRequestListener

(b)监听ServletContext、Request、Session作用域中属性变化（增加、修改、删除） 

     ServletContextAttributeListener

　  HttpSessionAttributeListener
　  ServletRequestAttributeListener

(c)监听HttpSession中对象状态的改变（被绑定、解除绑定、钝化、活化）

     HttpSessionBindingListener 感知到绑定以及解除绑定
　 HttpSessionActivationListener 感知钝化和活化 状态改变

<listener> 
    <listerner-class>com.listener.SessionListener</listener-class> 
</listener>

5、servlet设置

①<servlet>----用来声明一个servlet的数据，主要有以下子元素：

     ②<servlet-name></servlet-name> 指定servlet的名称

     ③<servlet-class></servlet-class> 指定servlet的类名称

     ④<jsp-file></jsp-file> 指定web站台中的某个JSP网页的完整路径

     ⑤<init-param></init-param> 用来定义参数，可有多个init-param。在servlet类中通过getInitParamenter(String name)方法访问初始化参数

     ⑥<load-on-startup></load-on-startup>指定当Web应用启动时，装载Servlet的次序。当值为正数或零时：Servlet容器先加载数值小的servlet，再依次加载其他数值大的servlet。当值为负或未定义：Servlet容器将在Web客户首次访问这个servlet时加载它。  

①<servlet-mapping>----用来定义servlet所对应的URL，包含两个子元素：

     ②<servlet-name></servlet-name> 指定servlet的名称

     ③<url-pattern></url-pattern> 指定servlet所对应的URL 

<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>

 6、会话设置

①<session-config>----如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。 包含一个子元素：

     ②<session-timeout>----用来定义这个web站台所有session的有效期限，单位为分钟。

<session-config>
    <session-timeout>120</session-timeout>
</session-config>

7、mime设置

①<mime-mapping>----如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。包含两个子元素：   

     ②<extension></extension> 扩展名的名称

     ③<mime-type></mime-type> MIME格式

<mime-mapping>
    <extension>htm</extension>
    <mime-type>text/html</mime-type>
</mime-mapping>

 8、设置欢迎页

①<welcome-file-list>----指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。 包含一个子元素：

    ②<welcome-file></welcome-file> ---- 指定首页的文件名称

<welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
</welcome-file-list>

 9、错误页面设置

①<error-page>----用来处理错误代码或异常的页面，有三个子元素：

     ②<error-code></error-code> 指定错误代码
     ③<exception-type></exception-type> 指定一个JAVA异常类型
     ④<location></location> 指定在web站台内的相关资源路径

<error-page>
    <error-code>404</error-code>
    <location>/NotFound.jsp</location>
</error-page>

10、设置jsp tag library路径

①<taglib>----taglib元素对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。 有两个子元素：

    ②<taglib-uri></taglib-uri> 定义TLD文件的URI，在JSP网页中用taglib指令便可取得该URI的TLD文件
    ③<taglib-location></taglib-location> 指定TLD文件相对于web站台的存放位置

<taglib>
      <taglib-uri>myTaglib</taglib-uri>
      <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location>
</taglib>

11、设置资源相关的一个管理对象

<resource-ref>----声明一个资源工厂使用的外部资源。 有五个子元素：

    <description></description> 资源说明
    <rec-ref-name></rec-ref-name> 资源名称
    <res-type></res-type> 资源种类
    <res-auth></res-auth> 资源经由Application或Container来许可
    <res-sharing-scope></res-sharing-scope> 资源是否可以共享，有Shareable和Unshareable两个值，默认为Shareable

<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>

12、设置jsp

<jsp-config> 包括 <taglib> 和 <jsp-property-group> 两个子元素。其中：

     <taglib> 元素在JSP 1.2 时就已经存在；

     <jsp-property-group> 是JSP 2.0 新增的元素。

     <jsp-property-group> 元素主要有八个子元素，它们分别为：

            <description>：设定的说明 

            <display-name>：设定名称 

            <url-pattern>：设定值所影响的范围，如： /CH2 或 /*.jsp

            <el-ignored>：若为 true，表示不支持 EL 语法 

            <scripting-invalid>：若为 true，表示不支持 <% scripting %>语法 

            <page-encoding>：设定 JSP 网页的编码 

            <include-prelude>：设置 JSP 网页的抬头，扩展名为 .jspf

            <include-coda>：设置 JSP 网页的结尾，扩展名为 .jspf 

<jsp-config>
    <taglib>
        <taglib-uri>Taglib</taglib-uri>
        <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location>
    </taglib>
    <jsp-property-group>
        <description>Special property group for JSP Configuration JSP example.</description>
        <display-name>JSPConfiguration</display-name>
        <url-pattern>/jsp/* </url-pattern>
        <el-ignored>true</el-ignored>
        <page-encoding>GB2312</page-encoding>
        <scripting-invalid>true</scripting-invalid>
        <include-prelude>/include/prelude.jspf</include-prelude>
        <include-coda>/include/coda.jspf</include-coda>
    </jsp-property-group>
</jsp-config>

13、其他一些设置

<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应用的环境项。
<ejb-ref>----ejb-ref元素声明一个EJB的主目录的引用。
<ejb-local-ref>----ejb-local-ref元素声明一个EJB的本地主目录的应用。