web-app_2_3.dtd
上传用户:jishiqi_cj
上传日期:2022-08-08
资源大小:24765k
文件大小:33k
源码类别:

Java编程

开发平台:

Java

  1. <!--
  2. Copyright 2000-2001 Sun Microsystems, Inc. 901 San Antonio Road,
  3. Palo Alto, CA  94303, U.S.A.  All rights reserved.
  4. This product or document is protected by copyright and distributed
  5. under licenses restricting its use, copying, distribution, and
  6. decompilation.  No part of this product or documentation may be
  7. reproduced in any form by any means without prior written authorization
  8. of Sun and its licensors, if any.
  9. Third party software, including font technology, is copyrighted and
  10. licensed from Sun suppliers.
  11. Sun, Sun Microsystems, the Sun Logo, Solaris, Java, JavaServer Pages, Java
  12. Naming and Directory Interface, JDBC, JDK, JavaMail and Enterprise JavaBeans,
  13. are trademarks or registered trademarks of Sun Microsystems, Inc in the U.S.
  14. and other countries.
  15. All SPARC trademarks are used under license and are trademarks
  16. or registered trademarks of SPARC International, Inc.
  17. in the U.S. and other countries. Products bearing SPARC
  18. trademarks are based upon an architecture developed by Sun Microsystems, Inc.
  19. PostScript is a registered trademark of Adobe Systems, Inc.
  20. Federal Acquisitions: Commercial Software - Government Users Subject to
  21. Standard License Terms and Conditions.
  22. DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED
  23. CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
  24. IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  25. PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT
  26. TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY
  27. INVALID.
  28. _________________________________________________________________________
  29. Copyright 2000-2001 Sun Microsystems, Inc.,
  30. 901 San Antonio Road, Palo Alto, CA  94303, Etats-Unis.
  31. Tous droits re'serve's.
  32. Ce produit ou document est prote'ge' par un copyright et distribue' avec
  33. des licences qui en restreignent l'utilisation, la copie, la distribution,
  34. et la de'compilation.  Aucune partie de ce produit ou de sa documentation
  35. associe'e ne peut e^tre reproduite sous aucune forme, par quelque moyen
  36. que ce soit, sans l'autorisation pre'alable et e'crite de Sun et de ses
  37. bailleurs de licence, s'il y en a.
  38. Le logiciel de'tenu par des tiers, et qui comprend la technologie
  39. relative aux polices de caracte`res, est prote'ge' par un copyright
  40. et licencie' par des fournisseurs de Sun.
  41. Sun, Sun Microsystems, le logo Sun, Solaris, Java, JavaServer Pages, Java
  42. Naming and Directory Interface, JDBC, JDK, JavaMail, et Enterprise JavaBeans,
  43. sont des marques de fabrique ou des marques de'pose'es de Sun
  44. Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
  45. Toutes les marques SPARC sont utilise'es sous licence et sont
  46. des marques de fabrique ou des marques de'pose'es de SPARC
  47. International, Inc. aux Etats-Unis et  dans
  48. d'autres pays. Les produits portant les marques SPARC sont
  49. base's sur une architecture de'veloppe'e par Sun Microsystems, Inc.
  50. Postcript est une marque enregistre'e d'Adobe Systems Inc.
  51. LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS,
  52. DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES,
  53. DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT
  54. TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE
  55. A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON.
  56. -->
  57. <!--
  58. This is the XML DTD for the Servlet 2.3 deployment descriptor.
  59. All Servlet 2.3 deployment descriptors must include a DOCTYPE
  60. of the following form:
  61.   <!DOCTYPE web-app PUBLIC
  62. "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
  63. "http://java.sun.com/dtd/web-app_2_3.dtd">
  64. -->
  65. <!--
  66. The following conventions apply to all J2EE deployment descriptor
  67. elements unless indicated otherwise.
  68. - In elements that contain PCDATA, leading and trailing whitespace
  69.   in the data may be ignored.
  70. - In elements whose value is an "enumerated type", the value is
  71.   case sensitive.
  72. - In elements that specify a pathname to a file within the same
  73.   JAR file, relative filenames (i.e., those not starting with "/")
  74.   are considered relative to the root of the JAR file's namespace.
  75.   Absolute filenames (i.e., those starting with "/") also specify
  76.   names in the root of the JAR file's namespace.  In general, relative
  77.   names are preferred.  The exception is .war files where absolute
  78.   names are preferred for consistency with the servlet API.
  79. -->
  80. <!--
  81. The web-app element is the root of the deployment descriptor for
  82. a web application.
  83. -->
  84. <!ELEMENT web-app (icon?, display-name?, description?, distributable?,
  85. context-param*, filter*, filter-mapping*, listener*, servlet*,
  86. servlet-mapping*, session-config?, mime-mapping*, welcome-file-list?,
  87. error-page*, taglib*, resource-env-ref*, resource-ref*, security-constraint*,
  88. login-config?, security-role*, env-entry*, ejb-ref*,  ejb-local-ref*)>
  89. <!--
  90. The auth-constraint element indicates the user roles that should
  91. be permitted access to this resource collection. The role-name
  92. used here must either correspond to the role-name of one of the
  93. security-role elements defined for this web application, or be
  94. the specially reserved role-name "*" that is a compact syntax for
  95. indicating all roles in the web application. If both "*" and
  96. rolenames appear, the container interprets this as all roles.
  97. If no roles are defined, no user is allowed access to the portion of
  98. the web application described by the containing security-constraint.
  99. The container matches role names case sensitively when determining
  100. access.
  101. Used in: security-constraint
  102. -->
  103. <!ELEMENT auth-constraint (description?, role-name*)>
  104. <!--
  105. The auth-method element is used to configure the authentication
  106. mechanism for the web application. As a prerequisite to gaining access to any web resources which are protected by an authorization
  107. constraint, a user must have authenticated using the configured
  108. mechanism. Legal values for this element are "BASIC", "DIGEST",
  109. "FORM", or "CLIENT-CERT".
  110. Used in: login-config
  111. -->
  112. <!ELEMENT auth-method (#PCDATA)>
  113. <!--
  114. The context-param element contains the declaration of a web
  115. application's servlet context initialization parameters.
  116. Used in: web-app
  117. -->
  118. <!ELEMENT context-param (param-name, param-value, description?)>
  119. <!--
  120. The description element is used to provide text describing the parent
  121. element.  The description element should include any information that
  122. the web application war file producer wants to provide to the consumer of
  123. the web application war file (i.e., to the Deployer). Typically, the tools
  124. used by the web application war file consumer will display the description
  125. when processing the parent element that contains the description.
  126. Used in: auth-constraint, context-param, ejb-local-ref, ejb-ref,
  127. env-entry, filter, init-param, resource-env-ref, resource-ref, run-as,
  128. security-role, security-role-ref, servlet, user-data-constraint,
  129. web-app, web-resource-collection
  130. -->
  131. <!ELEMENT description (#PCDATA)>
  132. <!--
  133. The display-name element contains a short name that is intended to be
  134. displayed by tools.  The display name need not be unique.
  135. Used in: filter, security-constraint, servlet, web-app
  136. Example:
  137. <display-name>Employee Self Service</display-name>
  138. -->
  139. <!ELEMENT display-name (#PCDATA)>
  140. <!--
  141. The distributable element, by its presence in a web application
  142. deployment descriptor, indicates that this web application is
  143. programmed appropriately to be deployed into a distributed servlet
  144. container
  145. Used in: web-app
  146. -->
  147. <!ELEMENT distributable EMPTY>
  148. <!--
  149. The ejb-link element is used in the ejb-ref or ejb-local-ref
  150. elements to specify that an EJB reference is linked to an
  151. enterprise bean.
  152. The name in the ejb-link element is composed of a
  153. path name specifying the ejb-jar containing the referenced enterprise
  154. bean with the ejb-name of the target bean appended and separated from
  155. the path name by "#".  The path name is relative to the war file
  156. containing the web application that is referencing the enterprise bean.
  157. This allows multiple enterprise beans with the same ejb-name to be
  158. uniquely identified.
  159. Used in: ejb-local-ref, ejb-ref
  160. Examples:
  161. <ejb-link>EmployeeRecord</ejb-link>
  162. <ejb-link>../products/product.jar#ProductEJB</ejb-link>
  163. -->
  164. <!ELEMENT ejb-link (#PCDATA)>
  165. <!--
  166. The ejb-local-ref element is used for the declaration of a reference to
  167. an enterprise bean's local home. The declaration consists of:
  168. - an optional description
  169. - the EJB reference name used in the code of the web application
  170.   that's referencing the enterprise bean
  171. - the expected type of the referenced enterprise bean
  172. - the expected local home and local interfaces of the referenced
  173.   enterprise bean
  174. - optional ejb-link information, used to specify the referenced
  175.   enterprise bean
  176. Used in: web-app
  177. -->
  178. <!ELEMENT ejb-local-ref (description?, ejb-ref-name, ejb-ref-type,
  179. local-home, local, ejb-link?)>
  180. <!--
  181. The ejb-ref element is used for the declaration of a reference to
  182. an enterprise bean's home. The declaration consists of:
  183. - an optional description
  184. - the EJB reference name used in the code of
  185.   the web application that's referencing the enterprise bean
  186. - the expected type of the referenced enterprise bean
  187. - the expected home and remote interfaces of the referenced
  188.   enterprise bean
  189. - optional ejb-link information, used to specify the referenced
  190.   enterprise bean
  191. Used in: web-app
  192. -->
  193. <!ELEMENT ejb-ref (description?, ejb-ref-name, ejb-ref-type,
  194. home, remote, ejb-link?)>
  195. <!--
  196. The ejb-ref-name element contains the name of an EJB reference. The
  197. EJB reference is an entry in the web application's environment and is
  198. relative to the java:comp/env context.  The name must be unique
  199. within the web application.
  200. It is recommended that name is prefixed with "ejb/".
  201. Used in: ejb-local-ref, ejb-ref
  202. Example:
  203. <ejb-ref-name>ejb/Payroll</ejb-ref-name>
  204. -->
  205. <!ELEMENT ejb-ref-name (#PCDATA)>
  206. <!--
  207. The ejb-ref-type element contains the expected type of the
  208. referenced enterprise bean.
  209. The ejb-ref-type element must be one of the following:
  210. <ejb-ref-type>Entity</ejb-ref-type>
  211. <ejb-ref-type>Session</ejb-ref-type>
  212. Used in: ejb-local-ref, ejb-ref
  213. -->
  214. <!ELEMENT ejb-ref-type (#PCDATA)>
  215. <!--
  216. The env-entry element contains the declaration of a web application's
  217. environment entry. The declaration consists of an optional
  218. description, the name of the environment entry, and an optional
  219. value.  If a value is not specified, one must be supplied
  220. during deployment.
  221. -->
  222. <!ELEMENT env-entry (description?, env-entry-name, env-entry-value?,
  223. env-entry-type)>
  224. <!--
  225. The env-entry-name element contains the name of a web applications's
  226. environment entry.  The name is a JNDI name relative to the
  227. java:comp/env context.  The name must be unique within a web application.
  228. Example:
  229. <env-entry-name>minAmount</env-entry-name>
  230. Used in: env-entry
  231. -->
  232. <!ELEMENT env-entry-name (#PCDATA)>
  233. <!--
  234. The env-entry-type element contains the fully-qualified Java type of
  235. the environment entry value that is expected by the web application's
  236. code.
  237. The following are the legal values of env-entry-type:
  238. java.lang.Boolean
  239. java.lang.Byte
  240. java.lang.Character
  241. java.lang.String
  242. java.lang.Short
  243. java.lang.Integer
  244. java.lang.Long
  245. java.lang.Float
  246. java.lang.Double
  247. Used in: env-entry
  248. -->
  249. <!ELEMENT env-entry-type (#PCDATA)>
  250. <!--
  251. The env-entry-value element contains the value of a web application's
  252. environment entry. The value must be a String that is valid for the
  253. constructor of the specified type that takes a single String
  254. parameter, or for java.lang.Character, a single character.
  255. Example:
  256. <env-entry-value>100.00</env-entry-value>
  257. Used in: env-entry
  258. -->
  259. <!ELEMENT env-entry-value (#PCDATA)>
  260. <!--
  261. The error-code contains an HTTP error code, ex: 404
  262. Used in: error-page
  263. -->
  264. <!ELEMENT error-code (#PCDATA)>
  265. <!--
  266. The error-page element contains a mapping between an error code
  267. or exception type to the path of a resource in the web application
  268. Used in: web-app
  269. -->
  270. <!ELEMENT error-page ((error-code | exception-type), location)>
  271. <!--
  272. The exception type contains a fully qualified class name of a
  273. Java exception type.
  274. Used in: error-page
  275. -->
  276. <!ELEMENT exception-type (#PCDATA)>
  277. <!--
  278. The extension element contains a string describing an
  279. extension. example: "txt"
  280. Used in: mime-mapping
  281. -->
  282. <!ELEMENT extension (#PCDATA)>
  283. <!--
  284. Declares a filter in the web application. The filter is mapped to
  285. either a servlet or a URL pattern in the filter-mapping element, using
  286. the filter-name value to reference. Filters can access the
  287. initialization parameters declared in the deployment descriptor at
  288. runtime via the FilterConfig interface.
  289. Used in: web-app
  290. -->
  291. <!ELEMENT filter (icon?, filter-name, display-name?, description?,
  292. filter-class, init-param*)>
  293. <!--
  294. The fully qualified classname of the filter.
  295. Used in: filter
  296. -->
  297. <!ELEMENT filter-class (#PCDATA)>
  298. <!--
  299. Declaration of the filter mappings in this web application. The
  300. container uses the filter-mapping declarations to decide which filters
  301. to apply to a request, and in what order. The container matches the
  302. request URI to a Servlet in the normal way. To determine which filters
  303. to apply it matches filter-mapping declarations either on servlet-name,
  304. or on url-pattern for each filter-mapping element, depending on which
  305. style is used. The order in which filters are invoked is the order in
  306. which filter-mapping declarations that match a request URI for a
  307. servlet appear in the list of filter-mapping elements.The filter-name
  308. value must be the value of the <filter-name> sub-elements of one of the
  309. <filter> declarations in the deployment descriptor.
  310. Used in: web-app
  311. -->
  312. <!ELEMENT filter-mapping (filter-name, (url-pattern | servlet-name))>
  313. <!--
  314. The logical name of the filter. This name is used to map the filter.
  315. Each filter name is unique within the web application.
  316. Used in: filter, filter-mapping
  317. -->
  318. <!ELEMENT filter-name (#PCDATA)>
  319. <!--
  320. The form-error-page element defines the location in the web app
  321. where the error page that is displayed when login is not successful
  322. can be found. The path begins with a leading / and is interpreted
  323. relative to the root of the WAR.
  324. Used in: form-login-config
  325. -->
  326. <!ELEMENT form-error-page (#PCDATA)>
  327. <!--
  328. The form-login-config element specifies the login and error pages
  329. that should be used in form based login. If form based authentication
  330. is not used, these elements are ignored.
  331. Used in: login-config
  332. -->
  333. <!ELEMENT form-login-config (form-login-page, form-error-page)>
  334. <!--
  335. The form-login-page element defines the location in the web app
  336. where the page that can be used for login can be found. The path
  337. begins with a leading / and is interpreted relative to the root of the WAR.
  338. Used in: form-login-config
  339. -->
  340. <!ELEMENT form-login-page (#PCDATA)>
  341. <!--
  342. The home element contains the fully-qualified name of the enterprise
  343. bean's home interface.
  344. Used in: ejb-ref
  345. Example:
  346. <home>com.aardvark.payroll.PayrollHome</home>
  347. -->
  348. <!ELEMENT home (#PCDATA)>
  349. <!--
  350. The http-method contains an HTTP method (GET | POST |...).
  351. Used in: web-resource-collection
  352. -->
  353. <!ELEMENT http-method (#PCDATA)>
  354. <!--
  355. The icon element contains small-icon and large-icon elements that
  356. specify the file names for small and a large GIF or JPEG icon images
  357. used to represent the parent element in a GUI tool.
  358. Used in: filter, servlet, web-app
  359. -->
  360. <!ELEMENT icon (small-icon?, large-icon?)>
  361. <!--
  362. The init-param element contains a name/value pair as an
  363. initialization param of the servlet
  364. Used in: filter, servlet
  365. -->
  366. <!ELEMENT init-param (param-name, param-value, description?)>
  367. <!--
  368. The jsp-file element contains the full path to a JSP file within
  369. the web application beginning with a `/'.
  370. Used in: servlet
  371. -->
  372. <!ELEMENT jsp-file (#PCDATA)>
  373. <!--
  374. The large-icon element contains the name of a file
  375. containing a large (32 x 32) icon image. The file
  376. name is a relative path within the web application's
  377. war file.
  378. The image may be either in the JPEG or GIF format.
  379. The icon can be used by tools.
  380. Used in: icon
  381. Example:
  382. <large-icon>employee-service-icon32x32.jpg</large-icon>
  383. -->
  384. <!ELEMENT large-icon (#PCDATA)>
  385. <!--
  386. The listener element indicates the deployment properties for a web
  387. application listener bean.
  388. Used in: web-app
  389. -->
  390. <!ELEMENT listener (listener-class)>
  391. <!--
  392. The listener-class element declares a class in the application must be
  393. registered as a web application listener bean. The value is the fully qualified classname of the listener class.
  394. Used in: listener
  395. -->
  396. <!ELEMENT listener-class (#PCDATA)>
  397. <!--
  398. The load-on-startup element indicates that this servlet should be
  399. loaded (instantiated and have its init() called) on the startup
  400. of the web application. The optional contents of
  401. these element must be an integer indicating the order in which
  402. the servlet should be loaded. If the value is a negative integer,
  403. or the element is not present, the container is free to load the
  404. servlet whenever it chooses. If the value is a positive integer
  405. or 0, the container must load and initialize the servlet as the
  406. application is deployed. The container must guarantee that
  407. servlets marked with lower integers are loaded before servlets
  408. marked with higher integers. The container may choose the order
  409. of loading of servlets with the same load-on-start-up value.
  410. Used in: servlet
  411. -->
  412. <!ELEMENT load-on-startup (#PCDATA)>
  413. <!--
  414. The local element contains the fully-qualified name of the
  415. enterprise bean's local interface.
  416. Used in: ejb-local-ref
  417. -->
  418. <!ELEMENT local (#PCDATA)>
  419. <!--
  420. The local-home element contains the fully-qualified name of the
  421. enterprise bean's local home interface.
  422. Used in: ejb-local-ref
  423. -->
  424. <!ELEMENT local-home (#PCDATA)>
  425. <!--
  426. The location element contains the location of the resource in the web
  427. application relative to the root of the web application. The value of
  428. the location must have a leading `/'.
  429. Used in: error-page
  430. -->
  431. <!ELEMENT location (#PCDATA)>
  432. <!--
  433. The login-config element is used to configure the authentication
  434. method that should be used, the realm name that should be used for
  435. this application, and the attributes that are needed by the form login
  436. mechanism.
  437. Used in: web-app
  438. -->
  439. <!ELEMENT login-config (auth-method?, realm-name?, form-login-config?)>
  440. <!--
  441. The mime-mapping element defines a mapping between an extension
  442. and a mime type.
  443. Used in: web-app
  444. -->
  445. <!ELEMENT mime-mapping (extension, mime-type)>
  446. <!--
  447. The mime-type element contains a defined mime type. example:
  448. "text/plain"
  449. Used in: mime-mapping
  450. -->
  451. <!ELEMENT mime-type (#PCDATA)>
  452. <!--
  453. The param-name element contains the name of a parameter. Each parameter
  454. name must be unique in the web application.
  455. Used in: context-param, init-param
  456. -->
  457. <!ELEMENT param-name (#PCDATA)>
  458. <!--
  459. The param-value element contains the value of a parameter.
  460. Used in: context-param, init-param
  461. -->
  462. <!ELEMENT param-value (#PCDATA)>
  463. <!--
  464. The realm name element specifies the realm name to use in HTTP
  465. Basic authorization.
  466. Used in: login-config
  467. -->
  468. <!ELEMENT realm-name (#PCDATA)>
  469. <!--
  470. The remote element contains the fully-qualified name of the enterprise
  471. bean's remote interface.
  472. Used in: ejb-ref
  473. Example:
  474. <remote>com.wombat.empl.EmployeeService</remote>
  475. -->
  476. <!ELEMENT remote (#PCDATA)>
  477. <!--
  478. The res-auth element specifies whether the web application code signs
  479. on programmatically to the resource manager, or whether the Container
  480. will sign on to the resource manager on behalf of the web application. In the
  481. latter case, the Container uses information that is supplied by the
  482. Deployer.
  483. The value of this element must be one of the two following:
  484. <res-auth>Application</res-auth>
  485. <res-auth>Container</res-auth>
  486. Used in: resource-ref
  487. -->
  488. <!ELEMENT res-auth (#PCDATA)>
  489. <!--
  490. The res-ref-name element specifies the name of a resource manager
  491. connection factory reference.  The name is a JNDI name relative to the
  492. java:comp/env context.  The name must be unique within a web application.
  493. Used in: resource-ref
  494. -->
  495. <!ELEMENT res-ref-name (#PCDATA)>
  496. <!--
  497. The res-sharing-scope element specifies whether connections obtained
  498. through the given resource manager connection factory reference can be
  499. shared. The value of this element, if specified, must be one of the
  500. two following:
  501. <res-sharing-scope>Shareable</res-sharing-scope>
  502. <res-sharing-scope>Unshareable</res-sharing-scope>
  503. The default value is Shareable.
  504. Used in: resource-ref
  505. -->
  506. <!ELEMENT res-sharing-scope (#PCDATA)>
  507. <!--
  508. The res-type element specifies the type of the data source. The type
  509. is specified by the fully qualified Java language class or interface
  510. expected to be implemented by the data source.
  511. Used in: resource-ref
  512. -->
  513. <!ELEMENT res-type (#PCDATA)>
  514. <!--
  515. The resource-env-ref element contains a declaration of a web application's
  516. reference to an administered object associated with a resource
  517. in the web application's environment.  It consists of an optional
  518. description, the resource environment reference name, and an
  519. indication of the resource environment reference type expected by
  520. the web application code.
  521. Used in: web-app
  522. Example:
  523. <resource-env-ref>
  524.     <resource-env-ref-name>jms/StockQueue</resource-env-ref-name>
  525.     <resource-env-ref-type>javax.jms.Queue</resource-env-ref-type>
  526. </resource-env-ref>
  527. -->
  528. <!ELEMENT resource-env-ref (description?, resource-env-ref-name,
  529. resource-env-ref-type)>
  530. <!--
  531. The resource-env-ref-name element specifies the name of a resource
  532. environment reference; its value is the environment entry name used in
  533. the web application code.  The name is a JNDI name relative to the
  534. java:comp/env context and must be unique within a web application.
  535. Used in: resource-env-ref
  536. -->
  537. <!ELEMENT resource-env-ref-name (#PCDATA)>
  538. <!--
  539. The resource-env-ref-type element specifies the type of a resource
  540. environment reference.  It is the fully qualified name of a Java
  541. language class or interface.
  542. Used in: resource-env-ref
  543. -->
  544. <!ELEMENT resource-env-ref-type (#PCDATA)>
  545. <!--
  546. The resource-ref element contains a declaration of a web application's
  547. reference to an external resource. It consists of an optional
  548. description, the resource manager connection factory reference name,
  549. the indication of the resource manager connection factory type
  550. expected by the web application code, the type of authentication
  551. (Application or Container), and an optional specification of the
  552. shareability of connections obtained from the resource (Shareable or
  553. Unshareable).
  554. Used in: web-app
  555. Example:
  556.     <resource-ref>
  557. <res-ref-name>jdbc/EmployeeAppDB</res-ref-name>
  558. <res-type>javax.sql.DataSource</res-type>
  559. <res-auth>Container</res-auth>
  560. <res-sharing-scope>Shareable</res-sharing-scope>
  561.     </resource-ref>
  562. -->
  563. <!ELEMENT resource-ref (description?, res-ref-name, res-type, res-auth,
  564. res-sharing-scope?)>
  565. <!--
  566. The role-link element is a reference to a defined security role. The
  567. role-link element must contain the name of one of the security roles
  568. defined in the security-role elements.
  569. Used in: security-role-ref
  570. -->
  571. <!ELEMENT role-link (#PCDATA)>
  572. <!--
  573. The role-name element contains the name of a security role.
  574. The name must conform to the lexical rules for an NMTOKEN.
  575. Used in: auth-constraint, run-as, security-role, security-role-ref
  576. -->
  577. <!ELEMENT role-name (#PCDATA)>
  578. <!--
  579. The run-as element specifies the run-as identity to be used for the
  580. execution of the web application. It contains an optional description, and
  581. the name of a security role.
  582. Used in: servlet
  583. -->
  584. <!ELEMENT run-as (description?, role-name)>
  585. <!--
  586. The security-constraint element is used to associate security
  587. constraints with one or more web resource collections
  588. Used in: web-app
  589. -->
  590. <!ELEMENT security-constraint (display-name?, web-resource-collection+,
  591. auth-constraint?, user-data-constraint?)>
  592. <!--
  593. The security-role element contains the definition of a security
  594. role. The definition consists of an optional description of the
  595. security role, and the security role name.
  596. Used in: web-app
  597. Example:
  598.     <security-role>
  599. <description>
  600.     This role includes all employees who are authorized
  601.     to access the employee service application.
  602. </description>
  603. <role-name>employee</role-name>
  604.     </security-role>
  605. -->
  606. <!ELEMENT security-role (description?, role-name)>
  607. <!--
  608. The security-role-ref element contains the declaration of a security
  609. role reference in the web application's code. The declaration consists
  610. of an optional description, the security role name used in the code,
  611. and an optional link to a security role. If the security role is not
  612. specified, the Deployer must choose an appropriate security role.
  613. The value of the role-name element must be the String used as the
  614. parameter to the EJBContext.isCallerInRole(String roleName) method
  615. or the HttpServletRequest.isUserInRole(String role) method.
  616. Used in: servlet
  617. -->
  618. <!ELEMENT security-role-ref (description?, role-name, role-link?)>
  619. <!--
  620. The servlet element contains the declarative data of a
  621. servlet. If a jsp-file is specified and the load-on-startup element is
  622. present, then the JSP should be precompiled and loaded.
  623. Used in: web-app
  624. -->
  625. <!ELEMENT servlet (icon?, servlet-name, display-name?, description?,
  626. (servlet-class|jsp-file), init-param*, load-on-startup?, run-as?, security-role-ref*)>
  627. <!--
  628. The servlet-class element contains the fully qualified class name
  629. of the servlet.
  630. Used in: servlet
  631. -->
  632. <!ELEMENT servlet-class (#PCDATA)>
  633. <!--
  634. The servlet-mapping element defines a mapping between a servlet
  635. and a url pattern
  636. Used in: web-app
  637. -->
  638. <!ELEMENT servlet-mapping (servlet-name, url-pattern)>
  639. <!--
  640. The servlet-name element contains the canonical name of the
  641. servlet. Each servlet name is unique within the web application.
  642. Used in: filter-mapping, servlet, servlet-mapping
  643. -->
  644. <!ELEMENT servlet-name (#PCDATA)>
  645. <!--
  646. The session-config element defines the session parameters for
  647. this web application.
  648. Used in: web-app
  649. -->
  650. <!ELEMENT session-config (session-timeout?)>
  651. <!--
  652. The session-timeout element defines the default session timeout
  653. interval for all sessions created in this web application. The
  654. specified timeout must be expressed in a whole number of minutes.
  655. If the timeout is 0 or less, the container ensures the default
  656. behaviour of sessions is never to time out.
  657. Used in: session-config
  658. -->
  659. <!ELEMENT session-timeout (#PCDATA)>
  660. <!--
  661. The small-icon element contains the name of a file
  662. containing a small (16 x 16) icon image. The file
  663. name is a relative path within the web application's
  664. war file.
  665. The image may be either in the JPEG or GIF format.
  666. The icon can be used by tools.
  667. Used in: icon
  668. Example:
  669. <small-icon>employee-service-icon16x16.jpg</small-icon>
  670. -->
  671. <!ELEMENT small-icon (#PCDATA)>
  672. <!--
  673. The taglib element is used to describe a JSP tag library.
  674. Used in: web-app
  675. -->
  676. <!ELEMENT taglib (taglib-uri, taglib-location)>
  677. <!--
  678. the taglib-location element contains the location (as a resource
  679. relative to the root of the web application) where to find the Tag
  680. Libary Description file for the tag library.
  681. Used in: taglib
  682. -->
  683. <!ELEMENT taglib-location (#PCDATA)>
  684. <!--
  685. The taglib-uri element describes a URI, relative to the location
  686. of the web.xml document, identifying a Tag Library used in the Web
  687. Application.
  688. Used in: taglib
  689. -->
  690. <!ELEMENT taglib-uri (#PCDATA)>
  691. <!--
  692. The transport-guarantee element specifies that the communication
  693. between client and server should be NONE, INTEGRAL, or
  694. CONFIDENTIAL. NONE means that the application does not require any
  695. transport guarantees. A value of INTEGRAL means that the application
  696. requires that the data sent between the client and server be sent in
  697. such a way that it can't be changed in transit. CONFIDENTIAL means
  698. that the application requires that the data be transmitted in a
  699. fashion that prevents other entities from observing the contents of
  700. the transmission. In most cases, the presence of the INTEGRAL or
  701. CONFIDENTIAL flag will indicate that the use of SSL is required.
  702. Used in: user-data-constraint
  703. -->
  704. <!ELEMENT transport-guarantee (#PCDATA)>
  705. <!--
  706. The url-pattern element contains the url pattern of the mapping. Must
  707. follow the rules specified in Section 11.2 of the Servlet API
  708. Specification.
  709. Used in: filter-mapping, servlet-mapping, web-resource-collection
  710. -->
  711. <!ELEMENT url-pattern (#PCDATA)>
  712. <!--
  713. The user-data-constraint element is used to indicate how data
  714. communicated between the client and container should be protected.
  715. Used in: security-constraint
  716. -->
  717. <!ELEMENT user-data-constraint (description?, transport-guarantee)>
  718. <!--
  719. The web-resource-collection element is used to identify a subset
  720. of the resources and HTTP methods on those resources within a web
  721. application to which a security constraint applies. If no HTTP methods
  722. are specified, then the security constraint applies to all HTTP
  723. methods.
  724. Used in: security-constraint
  725. -->
  726. <!ELEMENT web-resource-collection (web-resource-name, description?,
  727. url-pattern*, http-method*)>
  728. <!--
  729. The web-resource-name contains the name of this web resource
  730. collection.
  731. Used in: web-resource-collection
  732. -->
  733. <!ELEMENT web-resource-name (#PCDATA)>
  734. <!--
  735. The welcome-file element contains file name to use as a default
  736. welcome file, such as index.html
  737. Used in: welcome-file-list
  738. -->
  739. <!ELEMENT welcome-file (#PCDATA)>
  740. <!--
  741. The welcome-file-list contains an ordered list of welcome files
  742. elements.
  743. Used in: web-app
  744. -->
  745. <!ELEMENT welcome-file-list (welcome-file+)>
  746. <!--
  747. The ID mechanism is to allow tools that produce additional deployment
  748. information (i.e., information beyond the standard deployment
  749. descriptor information) to store the non-standard information in a
  750. separate file, and easily refer from these tool-specific files to the
  751. information in the standard deployment descriptor.
  752. Tools are not allowed to add the non-standard information into the
  753. standard deployment descriptor.
  754. -->
  755. <!ATTLIST auth-constraint id ID #IMPLIED>
  756. <!ATTLIST auth-method id ID #IMPLIED>
  757. <!ATTLIST context-param id ID #IMPLIED>
  758. <!ATTLIST description id ID #IMPLIED>
  759. <!ATTLIST display-name id ID #IMPLIED>
  760. <!ATTLIST distributable id ID #IMPLIED>
  761. <!ATTLIST ejb-link id ID #IMPLIED>
  762. <!ATTLIST ejb-local-ref id ID #IMPLIED>
  763. <!ATTLIST ejb-ref id ID #IMPLIED>
  764. <!ATTLIST ejb-ref-name id ID #IMPLIED>
  765. <!ATTLIST ejb-ref-type id ID #IMPLIED>
  766. <!ATTLIST env-entry id ID #IMPLIED>
  767. <!ATTLIST env-entry-name id ID #IMPLIED>
  768. <!ATTLIST env-entry-type id ID #IMPLIED>
  769. <!ATTLIST env-entry-value id ID #IMPLIED>
  770. <!ATTLIST error-code id ID #IMPLIED>
  771. <!ATTLIST error-page id ID #IMPLIED>
  772. <!ATTLIST exception-type id ID #IMPLIED>
  773. <!ATTLIST extension id ID #IMPLIED>
  774. <!ATTLIST filter id ID #IMPLIED>
  775. <!ATTLIST filter-class id ID #IMPLIED>
  776. <!ATTLIST filter-mapping id ID #IMPLIED>
  777. <!ATTLIST filter-name id ID #IMPLIED>
  778. <!ATTLIST form-error-page id ID #IMPLIED>
  779. <!ATTLIST form-login-config id ID #IMPLIED>
  780. <!ATTLIST form-login-page id ID #IMPLIED>
  781. <!ATTLIST home id ID #IMPLIED>
  782. <!ATTLIST http-method id ID #IMPLIED>
  783. <!ATTLIST icon id ID #IMPLIED>
  784. <!ATTLIST init-param id ID #IMPLIED>
  785. <!ATTLIST jsp-file id ID #IMPLIED>
  786. <!ATTLIST large-icon id ID #IMPLIED>
  787. <!ATTLIST listener id ID #IMPLIED>
  788. <!ATTLIST listener-class id ID #IMPLIED>
  789. <!ATTLIST load-on-startup id ID #IMPLIED>
  790. <!ATTLIST local id ID #IMPLIED>
  791. <!ATTLIST local-home id ID #IMPLIED>
  792. <!ATTLIST location id ID #IMPLIED>
  793. <!ATTLIST login-config id ID #IMPLIED>
  794. <!ATTLIST mime-mapping id ID #IMPLIED>
  795. <!ATTLIST mime-type id ID #IMPLIED>
  796. <!ATTLIST param-name id ID #IMPLIED>
  797. <!ATTLIST param-value id ID #IMPLIED>
  798. <!ATTLIST realm-name id ID #IMPLIED>
  799. <!ATTLIST remote id ID #IMPLIED>
  800. <!ATTLIST res-auth id ID #IMPLIED>
  801. <!ATTLIST res-ref-name id ID #IMPLIED>
  802. <!ATTLIST res-sharing-scope id ID #IMPLIED>
  803. <!ATTLIST res-type id ID #IMPLIED>
  804. <!ATTLIST resource-env-ref id ID #IMPLIED>
  805. <!ATTLIST resource-env-ref-name id ID #IMPLIED>
  806. <!ATTLIST resource-env-ref-type id ID #IMPLIED>
  807. <!ATTLIST resource-ref id ID #IMPLIED>
  808. <!ATTLIST role-link id ID #IMPLIED>
  809. <!ATTLIST role-name id ID #IMPLIED>
  810. <!ATTLIST run-as id ID #IMPLIED>
  811. <!ATTLIST security-constraint id ID #IMPLIED>
  812. <!ATTLIST security-role id ID #IMPLIED>
  813. <!ATTLIST security-role-ref id ID #IMPLIED>
  814. <!ATTLIST servlet id ID #IMPLIED>
  815. <!ATTLIST servlet-class id ID #IMPLIED>
  816. <!ATTLIST servlet-mapping id ID #IMPLIED>
  817. <!ATTLIST servlet-name id ID #IMPLIED>
  818. <!ATTLIST session-config id ID #IMPLIED>
  819. <!ATTLIST session-timeout id ID #IMPLIED>
  820. <!ATTLIST small-icon id ID #IMPLIED>
  821. <!ATTLIST taglib id ID #IMPLIED>
  822. <!ATTLIST taglib-location id ID #IMPLIED>
  823. <!ATTLIST taglib-uri id ID #IMPLIED>
  824. <!ATTLIST transport-guarantee id ID #IMPLIED>
  825. <!ATTLIST url-pattern id ID #IMPLIED>
  826. <!ATTLIST user-data-constraint id ID #IMPLIED>
  827. <!ATTLIST web-app id ID #IMPLIED>
  828. <!ATTLIST web-resource-collection id ID #IMPLIED>
  829. <!ATTLIST web-resource-name id ID #IMPLIED>
  830. <!ATTLIST welcome-file id ID #IMPLIED>
  831. <!ATTLIST welcome-file-list id ID #IMPLIED>