春节礼物--中文web-app_2_3.dtd

Question

<!--
env-entry-name 元素的内容是一个web应用程序的环境入口的名字。该名字是一个和
java:comp/env 上下文(context)相关的JNDI名字。该名字在一个web应用程序中必须是唯一
的。Example:<env-entry-name>minAmount</env-entry-name>在 env-entry中使用
-->
<!ELEMENT env-entry-name (#PCDATA)><!--
env-entry-type 元素的内容是该web应用程序代码所期望的环境入口的值的完全形式
(fully-qualified)的Java类型。其可选值有以下几个： java.lang.Boolean
java.lang.Byte
java.lang.Character
java.lang.String
java.lang.Short
java.lang.Integer
java.lang.Long
java.lang.Float
java.lang.Double在env－entry中使用
-->
<!ELEMENT env-entry-type (#PCDATA)><!--
env-entry-value元素的内容是一个web应用程序的环境入口的值。该值必须是能满足所指定的
类型的只需要一个String参数的构造器的有效的String，或者是一个单独的字符，这个时候所指
定的类型为必须java.lang.Character。Example:<env-entry-value>100.00</env-entry-value>在 env-entry中使用
-->
<!ELEMENT env-entry-value (#PCDATA)><!--
error-code元素的内容是一个HTTP错误字，比如：404在error-page中使用
<!ELEMENT error-code (#PCDATA)><!--
error-page元素的内容是一个错误代码或者例外类型和该web应用程序里面的一个资源的路径的
映射。在web-app中使用
-->
<!ELEMENT error-page ((error-code | exception-type), location)><!--
exception-type元素的内容是一个Java 例外类型的完全形式的类名。在error-page中使用
-->
<!ELEMENT exception-type (#PCDATA)><!--
extension元素的内容是一个描述了一个扩展名的字符串。比如：“txt”在mime-mapping中使用
-->
<!ELEMENT extension (#PCDATA)><!--
filter 元素声明了web应用程序里的一个filter。通过filter-name的值作为引用，在
filter-mapping元素里，filter被映射到一个Servlet或者是一个URL范式上。通过
FilterConfig接口，filter可以使用配置描述器所声明的初始化参数。在web-app中使用
-->
<!ELEMENT filter (icon?,filter-name,display-name?, description?,
filter-class,init-param*)><!--
filter-class的内容是该filter的类名的全称。在filter中使用
-->
<!ELEMENT filter-class(#PCDATA)><!--
filter-mapping元素声明了在wen应用程序里面的filter映射。容器根据filter－mapping声
明来决定哪些filter按照什么顺序应用于一个请求上。容器匹配按照正常方式访问一个Servlet的
请求URI。然后根据所有filter-mapping的servlet-name或者是url-pattern来决定哪个
filter可以应用到该URI之上。决定filter调用顺序的是适合该URI的filter－mapping列表中
的filter顺序。filter-name的值必须得是该配置描述器里面的filter声明的子元素
filter－name的值。在web-app中使用
-->
<!ELEMENT filter-mapping(filter-name, (url-pattern | servlet-name))><!--
filter的逻辑名。这个名字是用来映射filter的，在web应用程序里各个filter-name是唯一的。在filter,filter-mapping中使用
-->
<!ELEMENT filter-name(#PCDATA)><!--
form-error-page 元素定义了在web应用程序里能找到登陆失败时所显示的错误页面的位置。路
径名的形式是相对于该WAR文件的根以/打头。在form-login-config中使用
-->
<!ELEMENT form-error-page (#PCDATA)><!--
form-login-config元素定义了以form方式的鉴定机制所需要使用的登陆和错误页面。如果没有
使用以form为基础形式的鉴定机制，则该元素会被忽略。在login-config中使用
-->
<!ELEMENT form-login-config (form-login-page, form-error-page)><!--
form-login-page元素定义了在该web应用程序的能找到登陆页面可以的位置。路径名的形式是相
对于该WAR文件的根以/打头。在form-login-config中使用
-->
<!ELEMENT form-login-page (#PCDATA)><!--
home元素的内容是enterprise beans的home 接口的完全形式的名字。在ejb-ref中使用Example:<home>com.aardvark.payroll.PayrollHome</home>
-->
<!ELEMENT home (#PCDATA)><!--
http-method元素的内容是一个HTTP方法（GET|POST|...）。在web-resource-coloction中使用
-->
<!ELEMENT http-method (#PCDATA)><!--
icon元素的内容是用来在GUI工具里代表其父元素的，指定文件名字的小的和大的，GIF或者JPEG
icon图片的small-icon和large-icon元素。在filter,servlet,web-app中使用
-->
<!ELEMENT icon(small-icon?, large-icon?)><!--
init-param元素的内容是一个作为servlet的初始化参数的名值对。在filter,servlet中使用
-->
<!ELEMENT init-param (param-name, param-value, description?)><!--
jsp-file元素的内容是一个以/打头的指向该web应用程序里的一个JSP文件的完整路径。在servlet中使用
-->
<!ELEMENT jsp-file (#PCDATA)><!--
large-icon元素的内容是一个32x32像素的icon图片文件的文件名。该文件名是一个相对于该
web应用程序的war文件的路径名。该图片文件可以是JPEG格式，也可以是GIF格式。它是由图形工具使用的。在icon中使用Example:<large-icon>employee-service-icon32x32.jpg</large-icon>
-->
<!ELEMENT large-icon (#PCDATA)><!--
listener元素标明了一个web应用程序的listener bean的配置属性。在web-app中使用
-->
<!ELEMENT listener (listener-class)><!--
listener-class声明了该应用程序里一个必须要注册为该web应用程序listener bean的一个
类。其值为该listener类的完全形式的类名。在listener中使用
-->
<!ELEMENT listener-class(#PCDATA)><!--
load-on-startup元素标明了该servlet必须得在该web应用程序开始运行的时候被装入（初始
化一个对象，并调用该servlet的init()方法）。其值为一个可选的整数，标明了该servlet被
载入的次序。如果值为一个负整数或者该元素不出现的话，则容器可以在其选定的任何时候载入该
servlet。如果该值是一个正整数或者是零，则容器必须在启动该应用程序的时候载入并初始化该
servlet。容器必须保证用小的整数标明的servlet比用大的整数标明的servlet先载入。容器可
以在用同个整数标明的servlet中自由的选择载入次序。在srvlet中使用
-->
<!ELEMENT load-on-startup (#PCDATA)><!--
local元素的内容是该enterprise bean的本地接口的完全形式的名字。在ejb-local-ref中使用-->
<!ELEMENT local (#PCDATA)><!--
local-home元素的内容是该enterprise bean的本地home接口的完全形式的名字。在ejb-local-ref中使用
-->
<!ELEMENT local-home (#PCDATA)><!--
location元素的内容是该web应用程序里的资源的位置，该位置是一个以“/”打头的相对于该web
应用程序的根的相对路径。在error-page中使用
-->
<!ELEMENT location (#PCDATA)><!--
login-config 元素的作用是配置该应用程序中应该使用什么身份鉴定方法，所使用的域名
(realm name)，还有form登陆机制所需要的一些属性。在web-app中使用
-->
<!ELEMENT login-config (auth-method?, realm-name?, form-login-config?)><!--
mime-mapping 元素定义了一个在后缀名和mime类型之间的映射。在web-app中使用
-->
<!ELEMENT mime-mapping (extension, mime-type)><!--
mime-type元素的内容是一个规定了的mime类型。比如：“text/plain”。
-->
<!ELEMENT mime-type (#PCDATA)><!--
param-name元素的内容是一个参数的名字。每个参数名字在该wenb应用程序中必须是唯一的。在context-param,init-param中使用
-->
<!ELEMENT param-name (#PCDATA)><!--
param-value元素的内容是该参数的值。在context-param,init-param中使用
-->
<!ELEMENT param-value (#PCDATA)><!--
realm-name元素指定了以HTTP为基础的身份鉴定中所用的域名。在login-config中使用
-->
<!ELEMENT realm-name (#PCDATA)><!--
remote元素的内容是该enterprise bean的远程接口的完全形式的名字。
Example:<remote>com.wombat.empl.EmployeeService</remote>
-->
<!ELEMENT remote (#PCDATA)><!--
res-auth元素指定了web应用程序的代码中是否包含有注册到资源管理器上的程序，或者指定了容
器是否可以因为web应用程序的需要而注册到资源管理器上。如果是后者，则容器将会使用配置者
所提供的信息。其值必须为一下两种之一： <res-auth>Application</res-auth>
<res-auth>Container</res-auth>
在resource-ref中使用
-->
<!ELEMENT res-auth (#PCDATA)><!--
res-ref-name元素指定了一个资源管理器连接工厂引用的名字。这个名字是一个相对于
java:comp/env上下文(context)的JNDI名字。在一个web应用程序里，该名字必须是唯一的。在resource-ref中使用
<!ELEMENT res-ref-name (#PCDATA)><!--
res-sharing-scope元素指定了是否能共享通过资源管理器连接工厂引用得到的连接。如果指定了
该元素，则其值必须为以下两者之一： <res-sharing-scope>Shareable</res-sharing-scope>
<res-sharing-scope>Unshareable</res-sharing-scope>默认值是 Shareable
在resource-ref中使用
-->
<!ELEMENT res-sharing-scope (#PCDATA)>

Answer 1

<!--
res-type 元素定义了数据源的类型。该类型必须为可以为该数据源所实现(be implemented)的
Java语言的类或者接口的完全形式的名字。在resource-ref中使用
-->
<!ELEMENT res-type (#PCDATA)><!--
resource-env-ref元素的内容是一个web应用程序对一个和一个web应用程序环境里的资源联合了
的管理对象的应用。它由以下几个组成：一个可选的描述，该资源的环境引用的名字，和一个该web
应用程序代码所需要的资源环境引用类型的指明。在web-app中使用Example:<resource-env-ref>
    <resource-env-ref-name>jms/StockQueue</resource-env-ref-name>
    <resource-env-ref-type>javax.jms.Queue</resource-env-ref-type>
</resource-env-ref>
-->
<!ELEMENT resource-env-ref (description?, resource-env-ref-name,
resource-env-ref-type)><!--
resource-env-ref-name元素指定了一个资源环境引用的名字；它的值是该web应用程序代码中
所使用的环境实体的名字。该名字是一个和java:comp/env上下文(context)相关联的JNDI名字，
它必须在该web应用程序中唯一。在resource-env-ref中使用
-->
<!ELEMENT resource-env-ref-name (#PCDATA)><!--
resource-env-ref-type元素指定了一个资源环境引用的类型。它是一个Java语言类型或者接口
的完全形式的名字。在resource-evn-ref中使用
-->
<!ELEMENT resource-env-ref-type (#PCDATA)><!--
resource-ref元素的内容是一个对web应用程序对一个外部资源的引用。它由一个可选的描述，一
个资源管理器连接工厂引用的名字，web应用程序代码中所需要的资源管理器连接工厂的类型指示，
应用程序或者容器的身份鉴证的类型和一个可选的从该资源所得连接得可共享性说明（其值为
Shareable或者是Unchareable）。在web-app中使用Example:    <resource-ref>
<res-ref-name>jdbc/EmployeeAppDB</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
<res-sharing-scope>Shareable</res-sharing-scope>
    </resource-ref>
-->
<!ELEMENT resource-ref (description?, res-ref-name, res-type, res-auth,
res-sharing-scope?)><!--
role-link元素是一个对已定义安全角色得引用。该元素必须包含有在security-role元素中定义
的安全角色之一的名字。在security-role-ref中使用
-->
<!ELEMENT role-link (#PCDATA)><!--
role-name元素的内容是一个安全角色的名字。该名字必须符合NMTOKEN词法规则。在auth-constraint, run-as, security-role, security-role-ref中使用
-->
<!ELEMENT role-name (#PCDATA)><!--
run-as 元素指定了该web应用程序运行时所需用的运行身份。它由一个可选的描述和一个安全角色
的名字组成。在servlet中使用
-->
<!ELEMENT run-as (description?, role-name)><!--
security-constaint元素用来在联合一个或多个web资源集合和安全约束时使用。在web-app中使用
-->
<!ELEMENT security-constraint (display-name?, web-resource-collection+,
auth-constraint?, user-data-constraint?)><!--
security-role元素定义了一个安全角色。该定义定义由一个可选的对该安全角色的说明和该安全
角色的名字组成。在web-app中使用Example:    <security-role>
<description>
    This role includes all employees who are authorized
    to access the employee service application.
</description>
<role-name>employee</role-name>
    </security-role>
-->
<!ELEMENT security-role (description?, role-name)><!--
security-role-ref 元素的内容是一个该web应用程序代码里的一个安全角色引用的声明。该声
明由一个可选的描述，代码中所用到的该安全角色的名字和一个可选的指向该安全角色的链接。如
果该安全角色没有指定，则配置者必须选择一个适当的安全角色。role-name元素的值必须是一个在EJBContext.isCallerInrole(String roleName)方法或者
是HttpServletRequest.isUserInRole(String role)方法中的参数字符串。在servlet中使用-->
<!ELEMENT security-role-ref (description?, role-name, role-link?)><!--
servlet元素的内容是一个servlet的数据声明。如果指定了一个jsp文件而且load-on-startup
元素出现了，则该JSP必须被预编译并载入。在web-app中使用
-->
<!ELEMENT servlet (icon?, servlet-name, display-name?, description?,
(servlet-class|jsp-file), init-param*, load-on-startup?, run-as?, 
security-role-ref*)>
<!--
servlet-class元素的内容是该servlet类名的完全形式。在servlet中使用
-->
<!ELEMENT servlet-class (#PCDATA)><!--
servlet-mapping元素定义了一个在一个servlet和一个url范式之间的映射。在web-app中使用
-->
<!ELEMENT servlet-mapping (servlet-name, url-pattern)><!--
servlet-name元素的内容是该servlet的规范的名字，每个servlet名字在其所在web应用程序
中必须是唯一的。在filter-mapping, servlet, servlet-mapping中使用
-->
<!ELEMENT servlet-name (#PCDATA)><!--
session-config元素定义了该web应用程序的session参数。在web-app中使用
-->
<!ELEMENT session-config (session-timeout?)><!--
session-timeout元素定义了在该web应用程序中创造的session的默认超时时间间隔。该时间间
隔必须是一个以分钟为单文的整数。如果该时间间隔是0或者更小，则容器默认为session永远不会
超时。在session-config中使用
-->
<!ELEMENT session-timeout (#PCDATA)><!--
small-icon元素的内容是一个16x16像素的icon图片文件的文件名。该文件名是一个相对于该
web应用程序的war文件的路径名。该图片文件可以是JPEG格式，也可以是GIF格式。它是由图形工具使用的。在icon中使用Example:<small-icon>employee-service-icon16x16.jpg</small-icon>
-->
<!ELEMENT small-icon (#PCDATA)><!--
taglib元素是用来描述一个JSP标志库的。在web-app中使用
-->
<!ELEMENT taglib (tablib-uri, taglib-location)><!--
taglib-location元素的内容是一个能找到该标志库的描述文件的路径，如同一个相对于该web应
用程序的资源。在tablib中使用
-->
<!ELEMENT tablib-location (#PCDATA)><!--
tablib-uri元素描述了一个相对于web.xml文档位置的URI,唯一标志着一个该web应用程序所使
用的标志库。在tablib中使用
-->
<!ELEMENT tablib-uri (#PCDATA)><!--
transport-guarantee元素指定了客户端和服务器之间的信息传输方式应该是NONE, INTEGRAL
还是CONFIDENTIAL。NONE表示该应用程序不需要任何传输保证。INTEGRAL表示应用程序要求在
客户端和服务器端的之间传输的数据需要在一种数据不会在传输过程中被修改的传输方式传输。
CONFIDENTIAL表示应用程序要求数据必须在一种防止其他实体看到传输的内容的方式中传送。大
多数情况下，INTEGRAL或者CONFIDENTIAL表示需要使用SSL。在user-data-constraint中使用
-->
<!ELEMENT transport-guarantee (#PCDATA)><!--
url-pattern元素的内容是映射的url范式。它必须遵守Servlet API规范的11.2节所指定的规
则。在filter-mapping,servlet-mapping,web-resource-collection中使用
-->
<!ELEMENT url-pattern (#PCDATA)><!--
user-data-constraint元素用来指定在客户端和容器之间的数据传输需要受到什么样的保护。在security-constraint中使用
-->
<!ELEMENT user-data-constraint (description?, transport-guarantee)><!--
web-resource-collection 元素用来识别一个安全约束在一个web应用程序里所适用的资源和
HTTP请求方法的一个子集。如果没有指定任何HTTP请求方法，则该安全约束对所有的HTTP请求方
法有效。在security-constraint中使用
-->
<!ELEMENT web-resource-collection (web-resource-name, description?,
url-pattern*, http-method*)><!--
web-resource-name元素的内容是该web资源集合的名字。在web-resource-collection中使用
-->
<!ELEMENT web-resource-name (#PCDATA)><!--
welcome-file元素的内容是一个默认的欢迎页面的名字，比如index.html在welcome-file-list中使用。
-->
<!ELEMENT welcome-file (#PCDATA)><!--
welcome-file-list的内容是welcome-file元素的序列表。在web-app中使用
-->
<!ELEMENT welcome-file-list (welcome-file+)><!--
ID机制允许用来加入额外配置信息（在标准的配置描述器以外的信息）的工具把非标准的信息存储
在其他的文件上，并可以很容易的从这些工具读有的文件上引用到标准的配置描述器上的信息。这些工具都不能把非标准的信息加入到标准的配置描述器中。
-->下面的是原文983行开始至末尾的一些不需要翻译的东西，字数已经满了，就不贴上来了