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

我未翻译完的一段 Servlet 3.1 API 规范之“部署描述符”
开头或者可以解析成以 "../" 开头的路径都不是合法的路径。URI是指相对于WAR包的根目录的资源或者是一个相对于WAR包根目录的映射路径，如果没有特别规定，其应以 "/" 开头。值是枚举类型的元素的值是区分大小写的。

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

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

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

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


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

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

servlet元素
本元素用于声明一个Servlet，包含Servlet说明数据。servlet-mapping元素session-config元素mime-mapping元素welcome-file-list元素error-page元素jsp-config元素security-constraint元素login-config元素security-role元素env-enry元素ejb-ref元素ejb-local-ref元素service-ref元素resource-ref元素resource-evn-ref元素message-destination-ref元素message-destination元素local-encoding-mapping-list元素

14.5示例