[开源项目系列]JpetStore5.0 之 Web.xml配制

由于 JpetStroe 是基于 Struts+Ibatis ，首先从 Struts 说起。

 

大家都知道 Struts 是非常经典也非常成熟的 MVC 架构。

在 V 层使用 JSP 。其作为用户视图部分。

在 C 层使用 Servlet 。其作为整个系统的控制器。

在 M 层使用 JavaBeans 。封装了系统的业务逻辑。

 

 

在 Java Web 应用中用 web.xml 配制整个系统的应用，其它是一些 WEB 层技术框架比如 Struts,Sprint MVC,WebWork 等等都是源于这个基础之上的。它就像整个 WEB 应用的树根 。

 

Web.xml 文件

<?xml version="1.0" encoding="UTF-8"?>

 

<!DOCTYPE web-app

    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

    "http://java.sun.com/dtd/web-app_2_3.dtd">

 

<web-app>

<!-- 技术 -->

  <display-name>JPetStore</display-name>

  <description>Online Pet Store Sample Application</description>

 

  <servlet>

    <servlet-name>action</servlet-name>

    <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>

    <init-param>

      <param-name>config</param-name>

      <param-value>/WEB-INF/struts-config.xml</param-value>

    </init-param>

    <init-param>

      <param-name>debug</param-name>

      <param-value>2</param-value>

    </init-param>

    <init-param>

      <param-name>detail</param-name>

      <param-value>2</param-value>

    </init-param>

    <load-on-startup>2</load-on-startup>

  </servlet>

 

  <servlet-mapping>

    <servlet-name>action</servlet-name>

    <url-pattern>*.shtml</url-pattern>

  </servlet-mapping>

 

  <session-config>

    <session-timeout>30</session-timeout>

  </session-config>

 

  <welcome-file-list>

    <welcome-file>index.html</welcome-file>

  </welcome-file-list>

 

  <taglib>

    <taglib-uri>struts-bean</taglib-uri>

    <taglib-location>/WEB-INF/tld/struts-bean.tld</taglib-location>

  </taglib>

 

  <taglib>

    <taglib-uri>struts-html</taglib-uri>

    <taglib-location>/WEB-INF/tld/struts-html.tld</taglib-location>

  </taglib>

 

  <taglib>

    <taglib-uri>struts-logic</taglib-uri>

    <taglib-location>/WEB-INF/tld/struts-logic.tld</taglib-location>

  </taglib>

 

  <resource-ref>

    <description>

      JPetStore DataSource

    </description>

    <res-ref-name>

      jdbc/jpetstore1

    </res-ref-name>

    <res-type>

      javax.sql.DataSource

    </res-type>

    <res-auth>

      Container

    </res-auth>

  </resource-ref>

 

  <security-constraint>

    <web-resource-collection>

      <web-resource-name>

        Restrict access to JSP pages

      </web-resource-name>

      <url-pattern>*.jsp</url-pattern>

    </web-resource-collection>

    <auth-constraint>

      <description>

        With no roles defined, no access granted

      </description>

    </auth-constraint>

  </security-constraint>

 

</web-app>

 

 

 

<?xml version=’1.0’ encodeing=’UTF-8’?> 

指定了 XML 的版本和字符编码。

 

 

<!DOCTYPE web-app

PUBLIC “-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN”

“http:// java.sun.com/dtd/web-app_2_3.dtd”>

DOCTYPE 必须出现在其之后。这个声明告诉服务器 Servlet 规范的版本，并且指定了 XML 文件中标记的语法的 DTD 文件 (Ducument Type Definition, 文档类型定义 )

 

<web-app> </web-app>

此为部署描述符的根元素， XML 的部署描述符是大小写敏感的， XML 对无素的次序也是敏感的。

 

<display> JpetStore</display-name>

用来标记 WEB 应用的名称，新建应用时自动生成。

 

<description>Online Pet Store Sample Application</description>

对应用的描述，可以任意更改。

 

<servlet> 

       <servlet-name> action</servlet-name>

       <sevlet-class>org.apache.struts.ActionServlet</servlet-class>

       <init-param>

              <param-name>config</param-name>

              <param-value>/WEB-INF/struts-config.xml</param-value>

       </init-param>

</servlet>

<Servlet> 配制影响应用的处理类，在 Struts 中是核心控制器 ActionServlet 。

<init-param> 配制 Struts 的初始参数。

 

<param-name>config</param-name>

配制 Strtus 的配制文件。

 

<param-name>debug</param-name>

声明 Debug 的属性。

 

<load-on-startup>2</load-on-startup>

 定义启动时加载的优先级

 

<servlet-mapping>

 定义处理指定格式 URL 请求的具体处理的 Action 类。在 Struts 中定义处理指定请求到 ActionServlt 类。

 

<session-config>

       <session-timeout>30<session-timeout>

<session-config>

 定义保持会话状态的时间。

 

<welcome-file-list>

       <welcome-file>index.html</welcome-file>

</welcome-file-list>

指定欢迎界面。当指定一个目录名而不是一个文件名的时候使用哪一个文件。所以当访问应用的根地址时返回此页面。

 

<taglib>
	<taglib-uri>struts-logic</taglib-uri>
	<taglib-location>/WEB-INF/struts-logic.tld</taglib-location>
</taglib>

  对标记库文件使用别名，为标记库文件指定逻辑名。

 

<resource-ref>

声明一个资源工厂使用的上部资源

 

<security-constraint>

定义了保护的 URL ，与 <login-config> 元素配合使用

 

  项目中未出现的，但是 Web.xml 有的其它元素：

<resource-env-ref> 元素声明与资源相关的一个管理对象

<login-config> 元素指定服务器应该怎么样访问保护页面的用户授权。

<security-rule> 给出安全角色的一个列表

<eenv-entry> 元素声明 Web 应用的环境项。

<ejb-ref> 元素声明一个 EJB 的主目录的引用。

<ejb-local-ref> 声明一个 EJB 的本地主目录的引用。

<icon> 声明 IDE 和 GUI 工具用来表示 Web 应用的一个和两个图像文件的位置。

<error-page> 用来指定特定 HTTP 异常被抛出时显示的页面例如：

<context-param> 定义应用范围内的初始化参数。

<listener> 配制在 Web 应用中事件监听器类。

<filter> 和 <filter-mapption> 对过滤器的支持。