中文web-app_2_3.dtd

<!--
为了学习需要把这个文档翻译了一遍，里面的词语和语法可能很不标准，而且也可能和原文相去甚
远。但是对于我自己的理解确是有益的。觉得它对其他人也许有用，所以冒昧把它共享出来，希望
能对大家有用。要是由于我的错误翻译而使使用者曲解了原文的意思，那么我也只能深表遗憾了，
至于责任我是不负的。但是希望你能把错误指出来，由我来修改，或者是你自己加以改进，并共享
出来。

第一次字面翻译这种类型的文档，错误和难读之处估计很多，尤其是我对除了servlet和jsp之外
的知识所知甚少。然而大牛们是不屑于翻译这种文档的（或者是我孤陋寡闻了），而我等无能之辈
只能勉而为之了。

说明：
()里面的是原文,（）里面的是原文中()里面的内容

感谢： gaojunbo@csdn.expert提供的对于fully-qualified的理解。

justfly@cnpoems.net
2003.1.31 2:03完稿。
-->

<!--
Sun Microsystems,Inc.2000-2001 版权所有。901 San Antonio Road, Palo Alto,
CA 94303,U.S.A. 保留所有权利.

这个产品或者文档在使用，复制，分发上受到了copyright and distributed的许可证限制保
护。在没有得到任何形式的上的Sun和它的许可证颁发者的授权下，任何人或组织不可以以任何形
式reproduced(复制，再生)本产品或文档的任何部分。

第三方软件，包括字型技术，已经得到Sun的供应者的授权和许可。

Sun, Sun Microsystems, the Sun Logo, Solaris, Java, JavaServer Pages,
Java Naming and Directory Interface, JDBC, JDK, JavaMail 和
Enterprise JavaBeans 在美国和其他国家已经注册为Sun Microsystems, Inc的商标。

所有的SPARC商标得到SPARC International, Inc在美国和其他国家的使用许可和商标使用权
的授予。和SPARC商标有关的产品是以Sun Microsystems, Inc. 开发的一个体系结构为基础
的。

PostScript 是Adoe Systems, Inc.的一个注册商标。

联合收购： 商业软件－政府用户服从标准的许可证期限和条件.
(Federal Acquisitions: Commercial Software - Government Users Subject to
Standard License Terms and Conditions. 这句话翻译得不好)

除了根据法律无法拒绝的情况下,本文档不因任何任何明确的或者隐含的条件,请求,理由, 包括任
何含蓄的可做商品性的,因为特殊的目的或者非侵犯性的的理由而做修改。
-->

<!--
这是一个Servlet 2.3 配置描述器的XML DTD。所有的Servlet 2.3 配置描述器(deployment
descriptor) 必须包含一个如下形式的DOCTYPE:
  <!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd">

-->

<!--
下面的这些约定将用于所有的J2EE描述器元素，除非有额外说明。

-在包含有PCDATA的元素(elements)中，在数据中头部和尾部的空格可以忽略。

-值为“列举类型(enumerated)”的元素中，其值是区分大小写的。

-在同一个JAR file里指明了一个文件的路径名的元素中，相对方式的的文件名（不是用“/”开始
的路径名）都被认为是相对于该JAR 文件命名空间的根(root)的。绝对形式的文件名（以“/”开始
的）也是指定了以该JAR文件的根为起点的的名字。一般情况下，相对形式的文件名是首选的。也有
一个例外，为了servlet API的一致性,在.war文件中,绝对形式的文件名是首选的。
-->

<!--
web-app元素是一个web应用程序的配置描述器的根。
-->
<!ELEMENT web-app (icon?, display-name?, description?, distributable?,
context-param*, filter*, filter-mapping*, listener*, servlet*,
servlet-mapping*, session-config?, mime-mapping*, welcome-file-list?,
error-page*, taglib*, resource-env-ref*, resource-ref*, security-constraint*,
login-config?, security-role*, env-entry*, ejb-ref*,  ejb-local-ref*)>

<!--
auth-constraint元素标明了允许使用该资源集合的用户角色。role-name(角色名)必须对应为
该web应用程序所定义的一个security－role元素中的role－name，或者是“*”,“*”是一个专门
保留的role-name,它是一个用来标明web应用程序的所有角色的语法符号。如果“*”和角色名同时
出现了，那么容器就会认为它可以担任所有的角色。如果没有定义任何角色，则任何用户都无法使
用该web应用程序中所包含的security-constraint描述的部分。当当决定是否有使用权限时，
容器对角色名是大小写敏感的。

在security-constraint中使用
-->
<!ELEMENT auth-constraint (description?, role-name*)>

<!--
auth-method元素用来定义web容器的鉴定机制。为了获得对任何受授权约束保护的web资源的使
用权限，用户必须按照所本元素定义的机制来通过鉴证。本元素可选值为:"BASIC","DIGEST",
"FORM","CLIENT-CERT"。

在login-config中使用。
-->
<!ELEMENT auth-method (#PCDATA)>

<!--
context-param元素包含了web应用程序的servlet上下文（servlet context）的初始化参数
的声明。
-->
<!ELEMENT context-param (param-name, param-value, description?)>

<!--
description元素用来为其父元素提供文字说明。该元素用来提供所有web应用程序war文件生产者
想要提供给web应用程序war文件使用者（比如Deployer(配置器)）所需要的信息。典型情况下，
web应用程序war文件使用者所使用的工具在处理该description元素的父元素时会显示该
description元素所提供的文字说明。

在auth-constraint, context-param, ejb-local-ref, ejb-ref,env-entry, filter,
init-param, resource-env-ref, resource-ref, run-as,security-role,
security-role-ref, servlet, user-data-constraint,web-app,
web-resource-collection中使用。
-->

<!ELEMENT description (#PCDATA)>

<!--
display-name元素包含一个用来给工具显示用的短名。该元素的值没有唯一性要求。

在filter, security-constraint, servlet, web-app中使用

Example:

<display-name>Employee Self Service</display-name>
-->
<!ELEMENT display-name (#PCDATA)>

<!--
distributable元素在一个web应用程序配置描述器中的出现标明了该web应用程序
可以配置到分布式的servlet容器中。

在web-app中使用
-->
<!ELEMENT distributable EMPTY>

<!--
ejb-link元素用来标明一个EJB引用(EJB reference)是连接到一个enterprise bean的。
ejb-link元素里的名字由一个包含了所引用的ejb的ejb-jar文件的路径名和所应用的ejb名组成，
ejb名在ejb-jar路径名之后，中间用一个"#"隔开。该路径名是相对于引用了该
enterprise bean的web应用程序所在的war文件的。这个元素允许多个enterprise beans用同
个ejb－name来唯一鉴别。(This allows multiple enterprise beans with the same
ejb-name to be uniquely identified.)

在 ejb-local-ref, ejb-ref中使