`

我未翻译完的一段 Servlet 3.1 API 规范之“部署描述符”

阅读更多
 //---------------------------------------------------------------------------------------------//
//-- 原本是响应某童鞋的号召才翻译此文的,不过今天打开草稿箱正准备继续翻译时,       ---//
//-- 发现开涛童鞋已经发布了,后续内容翻译建议大家参考开涛童鞋的文章吧!                 ---//
//-- 附件里我附上了 Servlet3.1官方规范 。                                                                      ---//
//----------------------------------------------------- ----------------------------------------//
       本章将详细说明Java Servlet 规范3.0版本对容器支持部署描述符的要求。部署描述符在开发者、系统集成人员、应用部署人员之间传达Web应用元素配置信息。

Java Servlet 规范v2.4以上版本,部署描述符以XML文档的形式进行定义。

为了向后兼容用v2.2版API编写的应用,要求Web容器也支持v2.3版的部署描述符规范。为了向后兼容用v2.2版API编写的应用,要求Web容器也支持v2.3版的部署描述符规范。

v2.2版部署描述符规范的文档类型定义文件:http://java.sun.com/j2ee/dtds/web-app_2_2.dtd

v2.3版部署描述符规范的文档类型定义文件:http://java.sun.com/dtd/web-app_2_3.dtd.

14.1部署描述符的元素

要求所有Web容器的部署描述符号支持以下配置类型和部署描述信息:

  • ServletContext 初始化参数
  • 会话配置
  • Servlet声明
  • Servlet映射
  • 应用生命周期监听类
  • 过滤器的定义与映射
  • MIME类型映射
  • 欢迎页面(默认首页)列表
  • 错误页面
  • 区域与编码映射
  • 安全配置,包括 login-config, security-constra int, security-role, security-role-ref and run-as

14.2部署描述符(文件)的处理规则

      本节列出了一些基本的规则,这些规则是容器和开发者在处理一个Web应用部署描述符时必须要注意的地方。

  • 容器必须删除其所有部署描述符的文本节点元素内容的前导空白和尾随空白。
  • 部署描述必须对模式(XML语法定义)有效。处理WEB应用的WEB容器和工具会从多个方面检查WAR文件的有效性,包括检查WAR文件中是否包含部署描述符文档。
    此外,建议处理WEB应用的容器和工具提供一个标准的语义检查。比如,检查安全约束里引用的角色是否与部署描述里定义的某一个安全角色同名。
    如果WEB应用有不一致性的情况,工具和容器应当给开发者一个描述错误提示消息。对于高端的服务器提供商,鼓励以独立于容器的工具提供这种有效性校验。
  • 在本规范中,web-app的子元素可以是任意顺序。由于XML模式的约束,多个可选性元素(distributable session-config,  welcome-file-list,  jsp-config,
    login-config, locale-encoding-mapping-list)改成"0或者多个"。当部署描述文件中包含的(session-config,  jsp-config, login-config)这些元素多于一个时,容器必须通过一个错误描述信息提示开发者。有多个事件发生时,容器必须连接包含在welcome-file-listlocale-encoding-mapping-list 里的元素。多个事件的分发必须像对单个事件分发一样正确对待。
  • 部署描述符中指定的URI路径被假定在解码形式的URL里。如果URL中包含回车或者换行,容器必须通过错误描述信息提示给开发者。容器必须保留所有其他字符,包括URL中的空白。
  • 容器必须尝试规范化部署描述中的路径,如:"/a/../b" 形式的路径必须被解读为"/b"。部署描述符(部署描述文件)中以 "../" 开头或者可以解析成以 "../" 开头的路径都不是合法的路径。
  • URI是指相对于WAR包的根目录的资源或者是一个相对于WAR包根目录的映射路径,如果没有特别规定,其应以 "/" 开头。
  • 值是枚举类型的元素的值是区分大小写的。

14.3部署描述符
      本版本规范的部署描述符(文件)可以在这里访问: http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd

14.4部署描述符(文件结构)图解
本节阐述部署描述符(文件)中的元素,属性没有显示在插图中,详细信息可参考部署描述符(文件)的模式(文件)。

  1. web-app 元素
    本元素是WEB应用部署描述符(文件)的根元素,包含下列子元素,这个元素有一个必选属性version用于指定当前描述符遵循哪个版本的模式。这个元素下的所有子元素可以是任意顺序。
    图14-1 web-app 元素结构
  2. description元素
    本元素提供对父元素的描述文本。这个元素不仅出现在web-app中,也出现在多个其他元素中。它有一个可选属性 xml:lang,用来说面描述内容是用是何种语言,默认值为"en"。
  3. display-name元素
    本元素包含一个用于工具显示的短名称,这个名称不必是唯一的。元素(同样也)包含一个可选属性 xml:lang , 用于指定(名称)的语言。
  4. icon元素
    本元素包含small-icon和large-icon两个元素,分别用来指定小号和大号gif或者jpg格式的图标文件,图标用于在GUI工具中代表父元素。
  5. distributable元素
    本元素用于表名当前WEB应用适合部署到一个分布式Servlet容器中。
  6. context-param元素
    本元素用于声明若干个WEB应用Servlet上下文初始参数。
  7. filter元素
    本元素用于在WEB应用中声明一个过滤器。过滤器被映射到一个Servlet或者在filter-mapping元素中URL模式,用filter-name值去引用它。过滤器在运行时能通过FilterConfig接口来访问在部署描述符(文件)中声明的初始参数。filter-name元素值是filter元素的逻辑名称,它在整个WEB应用范围内必须是唯一的,内容一定不能为空。filter-class元素包含的是过滤器的全类名。init-param 元素包含作为过滤器初始参数的"名-值"对。async-supported是可选元素,它如果被指定,表示过滤器支持异步请求。
    图14-2 filter 元素结构

     
  8. fiter-mapping元素
    容器通过这个约束确定哪个过滤器以什么顺序应用到一个请求,filte-name元素的值必须是部署描述符(文件)中声明的一个,匹配的请求可以被指定url-pattern或者servlet-name。
    图14-3 filter-mapping 元素结构


     
  9. listener元素
    本元素表示一个应用监听器的部署属性。子元素listener-class声明一个类,这个类必须被注册为WEB应用的监听器,其值是监听器类的全类名。

    //----------------------------------------------------------------------------------------------//
    //-- 原本是响应某童鞋的号召才翻译此文的,不过今天打开草稿箱正准备继续翻译时,       ---//
    //-- 发现开涛童鞋已经发布了,后续内容翻译建议大家参考开涛童鞋饿文章吧!                 ---//
    //-- 附件里我附上了 Servlet3.1官方规范                                                                           ---//
    //------------------------------------------------ ---------------------------------------------//

  10. servlet元素
    本元素用于声明一个Servlet,包含Servlet说明数据。
  11. servlet-mapping元素
  12. session-config元素
  13. mime-mapping元素
  14. welcome-file-list元素
  15. error-page元素
  16. jsp-config元素
  17. security-constraint元素
  18. login-config元素
  19. security-role元素
  20. env-enry元素
  21. ejb-ref元素
  22. ejb-local-ref元素
  23. service-ref元素
  24. resource-ref元素
  25. resource-evn-ref元素
  26. message-destination-ref元素
  27. message-destination元素
  28. local-encoding-mapping-list元素

14.5示例

  • 大小: 112.2 KB
  • 大小: 88.3 KB
  • 大小: 35.6 KB
分享到:
评论

相关推荐

    javax.servlet-api-3.1.0.jar

    开发者可以通过实现`javax.servlet.Filter`接口来创建过滤器,并通过`web.xml`部署描述符配置过滤规则。 Listener则是在特定事件发生时被调用的类,比如session创建、销毁或请求初始化等。它们通过实现不同的监听器...

    Java Servlet API 2.5

    10. **部署描述符(web.xml)**:这是Web应用的配置文件,用于定义Servlet、Filter、Listener以及它们的映射关系。Servlet API 2.5允许更灵活的配置,比如动态注册Servlet。 11. **JSP和EL**:JavaServer Pages (JSP)...

    jdk1.8、MYSQL5.1、Servlet API帮助文档

    Servlet3.1是包含在Servlet API中的一个版本,而在Servlet API帮助文档中,通常会涵盖以下内容: - **Servlet生命周期**:包括加载、初始化、服务、销毁四个阶段。 - **Servlet容器**:如Tomcat,负责管理...

    Java Servlet Programming9

    3. **Servlet配置**:在`web.xml`部署描述符文件中,我们可以配置Servlet,包括Servlet的映射路径、初始化参数等。例如,使用`<servlet>`、`<servlet-mapping>`等元素进行设置。 4. **请求与响应处理**:...

    深入 Java Servlet 网络编程

    4.1 web.xml:Web应用的部署描述符,用于配置Servlet、过滤器、监听器等,定义URL到Servlet的映射。 4.2 @WebServlet 注解:Java EE 6及以上版本,可以用注解简化Servlet的配置,直接在Servlet类上使用@WebServlet...

    深入JavaServlet网络编

    2. **Servlet配置**:通过`web.xml`部署描述符或注解(如`@WebServlet`)来注册Servlet。了解如何配置Servlet的URL映射、初始化参数、过滤器等,是实现Servlet功能的基础。 3. **Servlet API**:`...

    Core_Servlets_and_JavaServer_Pages

    在开发过程中,还会涉及到Web应用程序的部署描述符(web.xml),这是一个XML文件,用于配置Servlet、过滤器和监听器等组件。此外,JSTL(JavaServer Pages Standard Tag Library)和EL(Expression Language)可以...

    JAVA WEB 开发详解:XML+XSLT+SERVLET+JSP 深入剖析与实例应用.part2

    15.2 标签库描述符 455 15.2.1 [taglib]元素 456 15.2.2 [validator]元素 457 15.2.3 [listener]元素 457 15.2.4 [tag]元素 458 15.2.5 [tag-file]元素 460 15.2.6 [function]元素 461 15.3 传统标签的开发 ...

    JAVA WEB 开发详解:XML+XSLT+SERVLET+JSP 深入剖析与实例应用.part3

    15.2 标签库描述符 455 15.2.1 [taglib]元素 456 15.2.2 [validator]元素 457 15.2.3 [listener]元素 457 15.2.4 [tag]元素 458 15.2.5 [tag-file]元素 460 15.2.6 [function]元素 461 15.3 传统标签的开发 ...

    JAVAEE6标准规范

    - **Web Fragments**:允许在不修改核心 Web 应用程序部署描述符的情况下添加额外的功能。 - **Asynchronous Processing**:允许 Servlet 请求异步处理,提高了并发性能。 - **JAX-RS 1.1 (JSR 311)**:RESTful Web ...

    JAVA WEB 开发详解:XML+XSLT+SERVLET+JSP 深入剖析与实例应用.part4

    15.2 标签库描述符 455 15.2.1 [taglib]元素 456 15.2.2 [validator]元素 457 15.2.3 [listener]元素 457 15.2.4 [tag]元素 458 15.2.5 [tag-file]元素 460 15.2.6 [function]元素 461 15.3 传统标签的开发 ...

    JavaEE6 new feature

    根据给定文件的信息,我们可以看到Java EE 6 主要围绕以下几个方面进行了优化:轻量化模型、简化部署描述符的需求、以及为高级用户提供的传统API等。 #### 二、轻量级编程模型 Java EE 6 引入了一个新的轻量级编程...

    JAVA WEB 开发详解:XML+XSLT+SERVLET+JSP 深入剖析与实例应用.part5

    15.2 标签库描述符 455 15.2.1 [taglib]元素 456 15.2.2 [validator]元素 457 15.2.3 [listener]元素 457 15.2.4 [tag]元素 458 15.2.5 [tag-file]元素 460 15.2.6 [function]元素 461 15.3 传统标签的开发 ...

    Java EE 6 标准与规范(中文版)

    - **注解和部署描述符**:可以在部署描述符中声明注入点。 **4.3 Java EE 平台角色的职责** - **应用程序组件供应商**:编写组件代码。 - **应用程序组装者**:创建并打包应用程序。 - **部署者**:安装和配置应用...

    BES 8.0 Development Guide

    - **编写标记库描述符**:在 TLD 文件中定义自定义标签的属性和行为。 - **使用自定义标记库**:在 JSP 文件中引用 TLD 文件,并使用自定义标签。 ##### 2.3 监听器 监听器用于监控特定类型的事件,例如 Servlet ...

    TongWeb4.6开发指南

    - **部署描述符:** - `web.xml`文件定义了Web应用程序的配置信息。 - **Servlet API:** - 包括核心接口如`Servlet`, `GenericServlet`, `HttpServlet`等以及辅助类和异常。 - **Servlet用作欢迎页面:** - 可...

    JSP教程从入门到精通

    - **部署描述符**:在`web.xml`中注册Servlet。 - **示例**:“HelloWorld”Servlet,展示基本的Servlet创建过程。 ##### 3.3 HTML与Servlet的交互 - **表单提交**:通过HTML表单向Servlet发送数据。 - **响应处理...

    Servlets

    Servlet的配置通常在Web应用的`web.xml`部署描述符中完成,这里可以定义Servlet的映射路径、初始化参数等。例如,通过`<servlet>`和`<servlet-mapping>`元素,我们可以指定Servlet的类名和访问URL。 3. **Servlet ...

    非常全面的一个j2ee教程(经过整理,适合初学者)

    - `WEB-INF`:包含web.xml部署描述符以及其他资源。 - `classes`:存放编译后的class文件。 - `lib`:包含第三方库的jar文件。 - **4.4 第一个Servlet HelloWorldServlet** - 创建Servlet类。 - 实现`doGet`或`...

Global site tag (gtag.js) - Google Analytics