[prev in list] [next in list] [prev in thread] [next in thread] 

List:       jakarta-servletapi-dev
Subject:    cvs commit: jakarta-servletapi-4/src/share/dtd web-app_2_3.dtd
From:       dannyc () apache ! org
Date:       2001-07-26 21:49:14
[Download RAW message or body]

dannyc      01/07/26 14:49:14

  Modified:    src/share/dtd web-app_2_3.dtd
  Log:
  Updated DTD file with the following editorial changes.
  
  1. Fixed couple of spelling mistakes and a comment that had gotten attached to the \
wrong element.  
  2. All DTD comments for elements include a description of which other elements use \
this element.  
  3. The root element remains the first element in the DTD. howevere, the listing of \
the subelements is now alphabetical.  
  Revision  Changes    Path
  1.5       +754 -583  jakarta-servletapi-4/src/share/dtd/web-app_2_3.dtd
  
  Index: web-app_2_3.dtd
  ===================================================================
  RCS file: /home/cvs/jakarta-servletapi-4/src/share/dtd/web-app_2_3.dtd,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- web-app_2_3.dtd	2001/04/24 19:58:47	1.4
  +++ web-app_2_3.dtd	2001/07/26 21:49:14	1.5
  @@ -1,332 +1,685 @@
  +<!--
  +Copyright 2000-2001 Sun Microsystems, Inc. 901 San Antonio Road,
  +Palo Alto, CA  94303, U.S.A.  All rights reserved.
   
  +This product or document is protected by copyright and distributed
  +under licenses restricting its use, copying, distribution, and
  +decompilation.  No part of this product or documentation may be
  +reproduced in any form by any means without prior written authorization
  +of Sun and its licensors, if any.
   
  -<!--
  -The web-app element is the root of the deployment descriptor for
  -a web application
  --->
  +Third party software, including font technology, is copyrighted and
  +licensed from Sun suppliers.
   
  -<!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*)>
  +Sun, Sun Microsystems, the Sun Logo, Solaris, Java, JavaServer Pages, Java
  +Naming and Directory Interface, JDBC, JDK, JavaMail and Enterprise JavaBeans,
  +are trademarks or registered trademarks of Sun Microsystems, Inc in the U.S.
  +and other countries.
   
  -<!--
  -Declares a filter in the web application. The filter is mapped to either a servlet \
                or a URL 
  -pattern in the filter-mapping element, using the filter-name value to reference. \
                Filters 
  -can access the initialization parameters declared in the deployment descriptor at 
  -runtime via the FilterConfig interface.
  --->
  +All SPARC trademarks are used under license and are trademarks
  +or registered trademarks of SPARC International, Inc.
  +in the U.S. and other countries. Products bearing SPARC
  +trademarks are based upon an architecture developed by Sun Microsystems, Inc.
   
  -<!ELEMENT filter (icon?, filter-name, display-name?, description?,
  -filter-class, init-param*)> 
  +PostScript is a registered trademark of Adobe Systems, Inc.
   
  -<!--
  -The canonical name of the filter. This name is used to map the filter. 
  -Each filter name is unique within the web application.
  +Federal Acquisitions: Commercial Software - Government Users Subject to
  +Standard License Terms and Conditions.
  +
  +DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED
  +CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
  +IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  +PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT
  +TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY
  +INVALID.
  +
  +_________________________________________________________________________
  +
  +Copyright 2000-2001 Sun Microsystems, Inc.,
  +901 San Antonio Road, Palo Alto, CA  94303, Etats-Unis.
  +Tous droits re'serve's.
  +
  +
  +Ce produit ou document est prote'ge' par un copyright et distribue' avec
  +des licences qui en restreignent l'utilisation, la copie, la distribution,
  +et la de'compilation.  Aucune partie de ce produit ou de sa documentation
  +associe'e ne peut e^tre reproduite sous aucune forme, par quelque moyen
  +que ce soit, sans l'autorisation pre'alable et e'crite de Sun et de ses
  +bailleurs de licence, s'il y en a.
  +
  +Le logiciel de'tenu par des tiers, et qui comprend la technologie
  +relative aux polices de caracte`res, est prote'ge' par un copyright
  +et licencie' par des fournisseurs de Sun.
  +
  +Sun, Sun Microsystems, le logo Sun, Solaris, Java, JavaServer Pages, Java
  +Naming and Directory Interface, JDBC, JDK, JavaMail, et Enterprise JavaBeans,
  +sont des marques de fabrique ou des marques de'pose'es de Sun
  +Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
  +
  +Toutes les marques SPARC sont utilise'es sous licence et sont
  +des marques de fabrique ou des marques de'pose'es de SPARC
  +International, Inc. aux Etats-Unis et  dans
  +d'autres pays. Les produits portant les marques SPARC sont
  +base's sur une architecture de'veloppe'e par Sun Microsystems, Inc.
  +
  +Postcript est une marque enregistre'e d'Adobe Systems Inc.
  +
  +LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS,
  +DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES,
  +DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT
  +TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE
  +A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON.
   -->
  -<!ELEMENT filter-name (#PCDATA)>
   
   <!--
  -The fully qualified classname of the filter.
  +This is the XML DTD for the Servlet 2.3 deployment descriptor.
  +All Servlet 2.3 deployment descriptors must include a DOCTYPE
  +of the following form:
  +
  +  <!DOCTYPE web-app PUBLIC
  +	"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
  +	"http://java.sun.com/dtd/web-app_2_3.dtd">
  +
   -->
  -<!ELEMENT filter-class (#PCDATA)>
   
   <!--
  -Declaration of the filter mappings in this web application. The container uses 
  -the filter-mapping declarations to decide which filters to apply to a request, 
  -and in what order. The container matches the request URI to a Servlet in the 
  -normal way. To determine which filters to apply it matches filter-mapping \
                declarations 
  -either on servlet-name, or on url-pattern for each filter-mapping element, \
                depending 
  -on which style is used. The order in which filters are invoked is the order in \
                which 
  -filter-mapping declarations that match a request URI for a servlet appear in the \
                list 
  -of filter-mapping elements.The filter-name value must be the value of the \
                <filter-name> 
  -sub-elements of one of the <filter> declarations in the deployment descriptor.
  --->
  +The following conventions apply to all J2EE deployment descriptor
  +elements unless indicated otherwise.
   
  -<!ELEMENT filter-mapping (filter-name, (url-pattern | servlet-name))>
  +- In elements that contain PCDATA, leading and trailing whitespace
  +  in the data may be ignored.
   
  -<!--
  -The icon element contains small-icon and large-icon elements that
  -specify the file names for small and a large GIF or JPEG icon images
  -used to represent the parent element in a GUI tool.
  +- In elements whose value is an "enumerated type", the value is
  +  case sensitive.
  +
  +- In elements that specify a pathname to a file within the same
  +  JAR file, relative filenames (i.e., those not starting with "/")
  +  are considered relative to the root of the JAR file's namespace.
  +  Absolute filenames (i.e., those starting with "/") also specify
  +  names in the root of the JAR file's namespace.  In general, relative
  +  names are preferred.  The exception is .war files where absolute
  +  names are preferred for consistency with the servlet API.
   -->
   
  -<!ELEMENT icon (small-icon?, large-icon?)>
   
   <!--
  -The small-icon element contains the name of a file
  -containing a small (16 x 16) icon image. The file
  -name is a path relative to the root of the WAR.
  +The web-app element is the root of the deployment descriptor for
  +a web application.
  +-->
  +<!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*)>
   
  -The image may be either in the JPEG or GIF format.
  -The icon can be used by tools.
  +<!--
  +The auth-constraint element indicates the user roles that should
  +be permitted access to this resource collection. The role-name
  +used here must either correspond to the role-name of one of the
  +security-role elements defined for this web application, or be
  +the specially reserved role-name "*" that is a compact syntax for
  +indicating all roles in the web application. If both "*" and
  +rolenames appear, the container interprets this as all roles.
  +If no roles are defined, no user is allowed access to the portion of
  +the web application described by the containing security-constraint.
  +The container matches role names case sensitively when determining
  +access.
   
  -Example:
   
  -<small-icon>/employee-service-icon16x16.jpg</small-icon>
  +Used in: security-constraint
   -->
  -
  -<!ELEMENT small-icon (#PCDATA)>
  +<!ELEMENT auth-constraint (description?, role-name*)>
   
   <!--
  -The large-icon element contains the name of a file
  -containing a large (32 x 32) icon image. The file
  -name is a path relative to the root of the WAR.
  +The auth-method element is used to configure the authentication
  +mechanism for the web application. As a prerequisite to gaining access to any web \
resources which are protected by an authorization  +constraint, a user must have \
authenticated using the configured  +mechanism. Legal values for this element are \
"BASIC", "DIGEST",  +"FORM", or "CLIENT-CERT".
   
  -The image may be either in the JPEG or GIF format.
  -The icon can be used by tools.
  +Used in: login-config
  +-->
  +<!ELEMENT auth-method (#PCDATA)>
   
  -Example:
  +<!--
  +The context-param element contains the declaration of a web
  +application's servlet context initialization parameters.
   
  -<large-icon>/employee-service-icon32x32.jpg</large-icon>
  +Used in: web-app
   -->
  +<!ELEMENT context-param (param-name, param-value, description?)>
   
  -<!ELEMENT large-icon (#PCDATA)>
  +<!--
  +The description element is used to provide text describing the parent
  +element.  The description element should include any information that
  +the web application war file producer wants to provide to the consumer of
  +the web application war file (i.e., to the Deployer). Typically, the tools
  +used by the web application war file consumer will display the description
  +when processing the parent element that contains the description.
  +
  +Used in: 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)>
   
   <!--
   The display-name element contains a short name that is intended to be
   displayed by tools.  The display name need not be unique.
   
  +Used in: filter, security-constraint, servlet, web-app
  +
   Example:
   
   <display-name>Employee Self Service</display-name>
   -->
  -
   <!ELEMENT display-name (#PCDATA)>
   
   <!--
  -The description element is used to provide text describing the parent
  -element.  The description element should include any information that
  -WAR producer wants to provide to the consumer of
  -WAR (i.e., to the Deployer). Typically, the tools
  -used by WAR consumer will display the description
  -when processing the parent element that contains the description.
  --->
  -
  -<!ELEMENT description (#PCDATA)>
  -
  -<!--
   The distributable element, by its presence in a web application
   deployment descriptor, indicates that this web application is
   programmed appropriately to be deployed into a distributed servlet
   container
  --->
   
  +Used in: web-app
  +-->
   <!ELEMENT distributable EMPTY>
   
   <!--
  -The context-param element contains the declaration of a web
  -application's servlet context initialization parameters.
  --->
  +The ejb-link element is used in the ejb-ref or ejb-local-ref
  +elements to specify that an EJB reference is linked to an
  +enterprise bean.
   
  -<!ELEMENT context-param (param-name, param-value, description?)>
  +The name in the ejb-link element is composed of a
  +path name specifying the ejb-jar containing the referenced enterprise
  +bean with the ejb-name of the target bean appended and separated from
  +the path name by "#".  The path name is relative to the war file
  +containing the web application that is referencing the enterprise bean.
  +This allows multiple enterprise beans with the same ejb-name to be
  +uniquely identified.
   
  -<!--
  -The param-name element contains the name of a parameter. Each parameter
  -name must be unique in the web application.
  --->
  +Used in: ejb-local-ref, ejb-ref
   
  -<!ELEMENT param-name (#PCDATA)>
  +Examples:
   
  -<!--
  -The param-value element contains the value of a parameter.
  --->
  +	<ejb-link>EmployeeRecord</ejb-link>
   
  -<!ELEMENT param-value (#PCDATA)>
  +	<ejb-link>../products/product.jar#ProductEJB</ejb-link>
   
  -<!--
  -The listener element indicates the deployment properties for a web application \
                listener bean.
   -->
  -
  -<!ELEMENT listener (listener-class)>
  +<!ELEMENT ejb-link (#PCDATA)>
   
   <!--
  -The listener-class element declares a class in the application must be registered \
                as 
  -a web application listener bean. The value is the fully qualified classname
  -of the listener class.
  --->
  +The ejb-local-ref element is used for the declaration of a reference to
  +an enterprise bean's local home. The declaration consists of:
   
  -<!ELEMENT listener-class (#PCDATA)>
  +	- an optional description
  +	- the EJB reference name used in the code of the web application
  +	  that's referencing the enterprise bean
  +	- the expected type of the referenced enterprise bean
  +	- the expected local home and local interfaces of the referenced
  +	  enterprise bean
  +	- optional ejb-link information, used to specify the referenced
  +	  enterprise bean
   
  +Used in: web-app
  +-->
  +<!ELEMENT ejb-local-ref (description?, ejb-ref-name, ejb-ref-type,
  +		local-home, local, ejb-link?)>
   
   <!--
  -The servlet element contains the declarative data of a
  -servlet. If a jsp-file is specified and the load-on-startup element is
  -present, then the JSP should be precompiled and loaded.
  --->
  +The ejb-ref element is used for the declaration of a reference to
  +an enterprise bean's home. The declaration consists of:
   
  -<!ELEMENT servlet (icon?, servlet-name, display-name?, description?,
  -(servlet-class|jsp-file), init-param*, load-on-startup?, run-as?, \
security-role-ref*)>  +	- an optional description
  +	- the EJB reference name used in the code of
  +	  the web application that's referencing the enterprise bean
  +	- the expected type of the referenced enterprise bean
  +	- the expected home and remote interfaces of the referenced
  +	  enterprise bean
  +	- optional ejb-link information, used to specify the referenced
  +	  enterprise bean
   
  -<!--
  -The servlet-name element contains the canonical name of the
  -servlet. Each servlet name is unique within the web application.
  +Used in: web-app
   -->
  -
  -<!ELEMENT servlet-name (#PCDATA)>
  +<!ELEMENT ejb-ref (description?, ejb-ref-name, ejb-ref-type,
  +		home, remote, ejb-link?)>
   
   <!--
  -The servlet-class element contains the fully qualified class name
  -of the servlet.
  --->
  +The ejb-ref-name element contains the name of an EJB reference. The
  +EJB reference is an entry in the web application's environment and is
  +relative to the java:comp/env context.  The name must be unique
  +within the web application.
   
  -<!ELEMENT servlet-class (#PCDATA)>
  +It is recommended that name is prefixed with "ejb/".
   
  -<!--
  -The jsp-file element contains the full path to a JSP file within
  -the web application beginning with a `/'.
  --->
  +Used in: ejb-local-ref, ejb-ref
   
  -<!ELEMENT jsp-file (#PCDATA)>
  +Example:
   
  -<!--
  -The init-param element contains a name/value pair as an
  -initialization param of the servlet
  +<ejb-ref-name>ejb/Payroll</ejb-ref-name>
   -->
  -
  -<!ELEMENT init-param (param-name, param-value, description?)>
  +<!ELEMENT ejb-ref-name (#PCDATA)>
   
   <!--
  -The load-on-startup element indicates that this servlet should be
  -loaded (instantiated and have its init() called) on the startup 
  -of the web application. The optional contents of
  -these element must be an integer indicating the order in which
  -the servlet should be loaded. If the value is a negative integer, 
  -or the element is not present, the container is free to load the 
  -servlet whenever it chooses. If the value is a positive integer 
  -or 0, the container must load and initialize the servlet as the 
  -application is deployed. The container must guarantee that 
  -servlets marked with lower integers are loaded before servlets 
  -marked with higher integers. The container may choose the order 
  -of loading of servlets with the same load-on-start-up value.
  --->
  +The ejb-ref-type element contains the expected type of the
  +referenced enterprise bean.
   
  -<!ELEMENT load-on-startup (#PCDATA)>
  +The ejb-ref-type element must be one of the following:
  +
  +	<ejb-ref-type>Entity</ejb-ref-type>
  +	<ejb-ref-type>Session</ejb-ref-type>
   
  +Used in: ejb-local-ref, ejb-ref
  +-->
  +<!ELEMENT ejb-ref-type (#PCDATA)>
  +
   <!--
  -The servlet-mapping element defines a mapping between a servlet
  -and a url pattern
  +The env-entry element contains the declaration of a web application's
  +environment entry. The declaration consists of an optional
  +description, the name of the environment entry, and an optional
  +value.  If a value is not specified, one must be supplied
  +during deployment.
   -->
  +<!ELEMENT env-entry (description?, env-entry-name, env-entry-value?,
  +env-entry-type)>
   
  -<!ELEMENT servlet-mapping (servlet-name, url-pattern)>
  +<!--
  +The env-entry-name element contains the name of a web applications's
  +environment entry.  The name is a JNDI name relative to the
  +java:comp/env context.  The name must be unique within a web application.
   
  +Example:
   
  -<!--
  -The url-pattern element contains the url pattern of the
  -mapping. Must follow the rules specified in Section 11.2 of the Servlet API \
                Specification.
  --->
  +<env-entry-name>minAmount</env-entry-name>
   
  -<!ELEMENT url-pattern (#PCDATA)>
  +Used in: env-entry
  +-->
  +<!ELEMENT env-entry-name (#PCDATA)>
   
   <!--
  -The session-config element defines the session parameters for
  -this web application.
  --->
  +The env-entry-type element contains the fully-qualified Java type of
  +the environment entry value that is expected by the web application's
  +code.
   
  -<!ELEMENT session-config (session-timeout?)>
  +The following are the legal values of env-entry-type:
  +
  +	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
  +
  +Used in: env-entry
  +-->
  +<!ELEMENT env-entry-type (#PCDATA)>
   
   <!--
  -The session-timeout element defines the default session timeout
  -interval for all sessions created in this web application. The
  -specified timeout must be expressed in a whole number of minutes.
  -If the timeout is 0 or less, the container ensures the default 
  -behaviour of sessions is never to time out.
  +The env-entry-value element contains the value of a web application's
  +environment entry. The value must be a String that is valid for the
  +constructor of the specified type that takes a single String
  +parameter, or for java.lang.Character, a single character.
  +
  +Example:
  +
  +<env-entry-value>100.00</env-entry-value>
  +
  +Used in: env-entry
   -->
  +<!ELEMENT env-entry-value (#PCDATA)>
   
  -<!ELEMENT session-timeout (#PCDATA)>
  +<!--
  +The error-code contains an HTTP error code, ex: 404
   
  +Used in: error-page
  +-->
  +<!ELEMENT error-code (#PCDATA)>
  +
   <!--
  -The mime-mapping element defines a mapping between an extension
  -and a mime type.
  +The error-page element contains a mapping between an error code
  +or exception type to the path of a resource in the web application
  +
  +Used in: web-app
   -->
  +<!ELEMENT error-page ((error-code | exception-type), location)>
   
  -<!ELEMENT mime-mapping (extension, mime-type)>
  +<!--
  +The exception type contains a fully qualified class name of a
  +Java exception type.
  +
  +Used in: error-page
  +-->
  +<!ELEMENT exception-type (#PCDATA)>
   
   <!--
   The extension element contains a string describing an
   extension. example: "txt"
  --->
   
  +Used in: mime-mapping
  +-->
   <!ELEMENT extension (#PCDATA)>
   
   <!--
  -The mime-type element contains a defined mime type. example:
  -"text/plain"
  +Declares a filter in the web application. The filter is mapped to
  +either a servlet or a URL pattern in the filter-mapping element, using
  +the filter-name value to reference. Filters can access the
  +initialization parameters declared in the deployment descriptor at
  +runtime via the FilterConfig interface.
  +
  +Used in: web-app
   -->
  +<!ELEMENT filter (icon?, filter-name, display-name?, description?,
  +filter-class, init-param*)>
   
  -<!ELEMENT mime-type (#PCDATA)>
  +<!--
  +The fully qualified classname of the filter.
  +
  +Used in: filter
  +-->
  +<!ELEMENT filter-class (#PCDATA)>
   
   <!--
  -The welcome-file-list contains an ordered list of welcome files
  -elements.
  +Declaration of the filter mappings in this web application. The
  +container uses the filter-mapping declarations to decide which filters
  +to apply to a request, and in what order. The container matches the
  +request URI to a Servlet in the normal way. To determine which filters
  +to apply it matches filter-mapping declarations either on servlet-name,
  +or on url-pattern for each filter-mapping element, depending on which
  +style is used. The order in which filters are invoked is the order in
  +which filter-mapping declarations that match a request URI for a
  +servlet appear in the list of filter-mapping elements.The filter-name
  +value must be the value of the <filter-name> sub-elements of one of the
  +<filter> declarations in the deployment descriptor.
  +
  +Used in: web-app
   -->
  +<!ELEMENT filter-mapping (filter-name, (url-pattern | servlet-name))>
   
  -<!ELEMENT welcome-file-list (welcome-file+)>
  +<!--
  +The logical name of the filter. This name is used to map the filter.
  +Each filter name is unique within the web application.
   
  +Used in: filter, filter-mapping
  +-->
  +<!ELEMENT filter-name (#PCDATA)>
  +
   <!--
  -The welcome-file element contains file name to use as a default
  -welcome file, such as index.html
  +The form-error-page element defines the location in the web app
  +where the error page that is displayed when login is not successful
  +can be found. The path begins with a leading / and is interpreted
  +relative to the root of the WAR.
  +
  +Used in: form-login-config
   -->
  +<!ELEMENT form-error-page (#PCDATA)>
   
  -<!ELEMENT welcome-file (#PCDATA)>
  +<!--
  +The form-login-config element specifies the login and error pages
  +that should be used in form based login. If form based authentication
  +is not used, these elements are ignored.
  +
  +Used in: login-config
  +-->
  +<!ELEMENT form-login-config (form-login-page, form-error-page)>
   
   <!--
  -The taglib element is used to describe a JSP tag library.
  +The form-login-page element defines the location in the web app
  +where the page that can be used for login can be found. The path
  +begins with a leading / and is interpreted relative to the root of the WAR.
  +
  +Used in: form-login-config
   -->
  +<!ELEMENT form-login-page (#PCDATA)>
   
  -<!ELEMENT taglib (taglib-uri, taglib-location)>
  +<!--
  +The home element contains the fully-qualified name of the enterprise
  +bean's home interface.
  +
  +Used in: ejb-ref
   
  +Example:
  +
  +<home>com.aardvark.payroll.PayrollHome</home>
  +-->
  +<!ELEMENT home (#PCDATA)>
  +
   <!--
  -The taglib-uri element describes a URI, relative to the location
  -of the web.xml document, identifying a Tag Library used in the Web
  -Application.
  +The http-method contains an HTTP method (GET | POST |...).
  +
  +Used in: web-resource-collection
   -->
  +<!ELEMENT http-method (#PCDATA)>
   
  -<!ELEMENT taglib-uri (#PCDATA)>
  +<!--
  +The icon element contains small-icon and large-icon elements that
  +specify the file names for small and a large GIF or JPEG icon images
  +used to represent the parent element in a GUI tool.
   
  +Used in: filter, servlet, web-app
  +-->
  +<!ELEMENT icon (small-icon?, large-icon?)>
  +
   <!--
  -the taglib-location element contains the location (as a resource
  -relative to the root of the web application) where to find the Tag
  -Libary Description file for the tag library.
  +The init-param element contains a name/value pair as an
  +initialization param of the servlet
  +
  +Used in: filter, servlet
   -->
  +<!ELEMENT init-param (param-name, param-value, description?)>
   
  -<!ELEMENT taglib-location (#PCDATA)>
  +<!--
  +The jsp-file element contains the full path to a JSP file within
  +the web application beginning with a `/'.
  +
  +Used in: servlet
  +-->
  +<!ELEMENT jsp-file (#PCDATA)>
   
   <!--
  -The error-page element contains a mapping between an error code
  -or exception type to the path of a resource in the web application
  +The large-icon element contains the name of a file
  +containing a large (32 x 32) icon image. The file
  +name is a relative path within the web application's
  +war file.
  +
  +The image may be either in the JPEG or GIF format.
  +The icon can be used by tools.
  +
  +Used in: icon
  +
  +Example:
  +
  +<large-icon>employee-service-icon32x32.jpg</large-icon>
   -->
  +<!ELEMENT large-icon (#PCDATA)>
   
  -<!ELEMENT error-page ((error-code | exception-type), location)>
  +<!--
  +The listener element indicates the deployment properties for a web
  +application listener bean.
  +
  +Used in: web-app
  +-->
  +<!ELEMENT listener (listener-class)>
   
   <!--
  -The error-code contains an HTTP error code, ex: 404
  +The listener-class element declares a class in the application must be
  +registered as a web application listener bean. The value is the fully qualified \
classname of the listener class.  +
  +
  +Used in: listener
   -->
  +<!ELEMENT listener-class (#PCDATA)>
   
  -<!ELEMENT error-code (#PCDATA)>
  +<!--
  +The load-on-startup element indicates that this servlet should be
  +loaded (instantiated and have its init() called) on the startup
  +of the web application. The optional contents of
  +these element must be an integer indicating the order in which
  +the servlet should be loaded. If the value is a negative integer,
  +or the element is not present, the container is free to load the
  +servlet whenever it chooses. If the value is a positive integer
  +or 0, the container must load and initialize the servlet as the
  +application is deployed. The container must guarantee that
  +servlets marked with lower integers are loaded before servlets
  +marked with higher integers. The container may choose the order
  +of loading of servlets with the same load-on-start-up value.
   
  +Used in: servlet
  +-->
  +<!ELEMENT load-on-startup (#PCDATA)>
  +
   <!--
  -The exception type contains a fully qualified class name of a
  -Java exception type.
  +
  +The local element contains the fully-qualified name of the
  +enterprise bean's local interface.
  +
  +Used in: ejb-local-ref
  +
   -->
  +<!ELEMENT local (#PCDATA)>
   
  -<!ELEMENT exception-type (#PCDATA)>
  +<!--
   
  +The local-home element contains the fully-qualified name of the
  +enterprise bean's local home interface.
  +
  +Used in: ejb-local-ref
  +-->
  +<!ELEMENT local-home (#PCDATA)>
  +
   <!--
  -The location element contains the location of the resource in the
  -web application relative to the root of the web application. The value of 
  +The location element contains the location of the resource in the web
  +application relative to the root of the web application. The value of
   the location must have a leading `/'.
  --->
   
  +Used in: error-page
  +-->
   <!ELEMENT location (#PCDATA)>
   
  +<!--
  +The login-config element is used to configure the authentication
  +method that should be used, the realm name that should be used for
  +this application, and the attributes that are needed by the form login
  +mechanism.
  +
  +Used in: web-app
  +-->
  +<!ELEMENT login-config (auth-method?, realm-name?, form-login-config?)>
  +
   <!--
  -The resource-env-ref element contains a declaration of a servlet's
  +The mime-mapping element defines a mapping between an extension
  +and a mime type.
  +
  +Used in: web-app
  +-->
  +<!ELEMENT mime-mapping (extension, mime-type)>
  +
  +<!--
  +The mime-type element contains a defined mime type. example:
  +"text/plain"
  +
  +Used in: mime-mapping
  +-->
  +<!ELEMENT mime-type (#PCDATA)>
  +
  +<!--
  +The param-name element contains the name of a parameter. Each parameter
  +name must be unique in the web application.
  +
  +
  +Used in: context-param, init-param
  +-->
  +<!ELEMENT param-name (#PCDATA)>
  +
  +<!--
  +The param-value element contains the value of a parameter.
  +
  +Used in: context-param, init-param
  +-->
  +<!ELEMENT param-value (#PCDATA)>
  +
  +<!--
  +The realm name element specifies the realm name to use in HTTP
  +Basic authorization.
  +
  +Used in: login-config
  +-->
  +<!ELEMENT realm-name (#PCDATA)>
  +
  +<!--
  +The remote element contains the fully-qualified name of the enterprise
  +bean's remote interface.
  +
  +Used in: ejb-ref
  +
  +Example:
  +
  +<remote>com.wombat.empl.EmployeeService</remote>
  +-->
  +<!ELEMENT remote (#PCDATA)>
  +
  +<!--
  +The res-auth element specifies whether the web application code signs
  +on programmatically to the resource manager, or whether the Container
  +will sign on to the resource manager on behalf of the web application. In the
  +latter case, the Container uses information that is supplied by the
  +Deployer.
  +
  +The value of this element must be one of the two following:
  +
  +	<res-auth>Application</res-auth>
  +	<res-auth>Container</res-auth>
  +
  +Used in: resource-ref
  +-->
  +<!ELEMENT res-auth (#PCDATA)>
  +
  +<!--
  +The res-ref-name element specifies the name of a resource manager
  +connection factory reference.  The name is a JNDI name relative to the
  +java:comp/env context.  The name must be unique within a web application.
  +
  +Used in: resource-ref
  +-->
  +<!ELEMENT res-ref-name (#PCDATA)>
  +
  +<!--
  +The res-sharing-scope element specifies whether connections obtained
  +through the given resource manager connection factory reference can be
  +shared. The value of this element, if specified, must be one of the
  +two following:
  +
  +	<res-sharing-scope>Shareable</res-sharing-scope>
  +	<res-sharing-scope>Unshareable</res-sharing-scope>
  +
  +The default value is Shareable.
  +
  +Used in: resource-ref
  +-->
  +<!ELEMENT res-sharing-scope (#PCDATA)>
  +
  +<!--
  +The res-type element specifies the type of the data source. The type
  +is specified by the fully qualified Java language class or interface
  +expected to be implemented by the data source.
  +
  +Used in: resource-ref
  +-->
  +<!ELEMENT res-type (#PCDATA)>
  +
  +<!--
  +The resource-env-ref element contains a declaration of a web application's
   reference to an administered object associated with a resource
  -in servlet's environment.  It consists of an optional
  +in the web application's environment.  It consists of an optional
   description, the resource environment reference name, and an
   indication of the resource environment reference type expected by
  -servlet code.
  +the web application code.
  +
  +Used in: web-app
   
   Example:
   
  @@ -335,38 +688,39 @@
       <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)>
   
  -<!ELEMENT resource-env-ref (description?, resource-env-ref-name, 
  -resource-env-ref-type)>
  -
  -<!-- 
  +<!--
   The resource-env-ref-name element specifies the name of a resource
   environment reference; its value is the environment entry name used in
  -servlet code.  The name is a JNDI name relative to the
  +the web application code.  The name is a JNDI name relative to the
   java:comp/env context and must be unique within a web application.
  - -->
   
  +Used in: resource-env-ref
  +-->
   <!ELEMENT resource-env-ref-name (#PCDATA)>
   
  -<!-- 
  +<!--
   The resource-env-ref-type element specifies the type of a resource
   environment reference.  It is the fully qualified name of a Java
   language class or interface.
  --->
   
  +Used in: resource-env-ref
  +-->
   <!ELEMENT resource-env-ref-type (#PCDATA)>
   
   <!--
  -The resource-ref element contains a declaration of a servlet's
  +The resource-ref element contains a declaration of a web application's
   reference to an external resource. It consists of an optional
   description, the resource manager connection factory reference name,
   the indication of the resource manager connection factory type
  -expected by servlet code, the type of authentication
  +expected by the web application code, the type of authentication
   (Application or Container), and an optional specification of the
   shareability of connections obtained from the resource (Shareable or
   Unshareable).
   
  -%USED
  +Used in: web-app
   
   Example:
   
  @@ -376,513 +730,330 @@
   	<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?)>  +<!ELEMENT resource-ref (description?, res-ref-name, res-type, \
res-auth,  +		res-sharing-scope?)>
   
   <!--
  -The res-ref-name element specifies the name of the resource
  -factory reference name.
  --->
  -
  -<!ELEMENT res-ref-name (#PCDATA)>
  +The role-link element is a reference to a defined security role. The
  +role-link element must contain the name of one of the security roles
  +defined in the security-role elements.
   
  -<!--
  -The res-ref-name element specifies the name of a resource manager
  -connection factory reference.  The name is a JNDI name relative to the
  -java:comp/env context.  The name must be unique within web application.
  +Used in: security-role-ref
   -->
  -
  -<!ELEMENT res-type (#PCDATA)>
  +<!ELEMENT role-link (#PCDATA)>
   
   <!--
  -The res-auth element specifies whether the servlet code signs
  -on programmatically to the resource manager, or whether the Container
  -will sign on to the resource manager on behalf of the servlet. In the
  -latter case, the Container uses information that is supplied by the
  -Deployer.
  +The role-name element contains the name of a security role.
   
  -The value of this element must be one of the two following:
  +The name must conform to the lexical rules for an NMTOKEN.
   
  -	<res-auth>Application</res-auth>
  -	<res-auth>Container</res-auth>
  +Used in: auth-constraint, run-as, security-role, security-role-ref
   -->
  -
  -<!ELEMENT res-auth (#PCDATA)>
  -
  -<!-- 
  -The res-sharing-scope element specifies whether connections obtained
  -through the given resource manager connection factory reference can be
  -shared. The value of this element, if specified, must be one of the
  -two following:
  +<!ELEMENT role-name (#PCDATA)>
   
  -	<res-sharing-scope>Shareable</res-sharing-scope>
  -	<res-sharing-scope>Unshareable</res-sharing-scope>
  +<!--
  +The run-as element specifies the run-as identity to be used for the
  +execution of the web application. It contains an optional description, and
  +the name of a security role.
   
  -The default value is Shareable.
  +Used in: servlet
   -->
  -
  -<!ELEMENT res-sharing-scope (#PCDATA)>
  +<!ELEMENT run-as (description?, role-name)>
   
   <!--
   The security-constraint element is used to associate security
   constraints with one or more web resource collections
  --->
   
  +Used in: web-app
  +-->
   <!ELEMENT security-constraint (display-name?, web-resource-collection+,
   auth-constraint?, user-data-constraint?)>
   
   <!--
  -The web-resource-collection element is used to identify a subset
  -of the resources and HTTP methods on those resources within a web
  -application to which a security constraint applies. If no HTTP methods
  -are specified, then the security constraint applies to all HTTP
  -methods.
  --->
  +The security-role element contains the definition of a security
  +role. The definition consists of an optional description of the
  +security role, and the security role name.
   
  -<!ELEMENT web-resource-collection (web-resource-name, description?,
  -url-pattern*, http-method*)>
  +Used in: web-app
   
  -<!--
  -The web-resource-name contains the name of this web resource
  -collection
  --->
  -
  -<!ELEMENT web-resource-name (#PCDATA)>
  +Example:
   
  -<!--
  -The http-method contains an HTTP method (GET | POST |...)
  +    <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 http-method (#PCDATA)>
  +<!ELEMENT security-role (description?, role-name)>
   
   <!--
  -The user-data-constraint element is used to indicate how data
  -communicated between the client and container should be protected
  --->
  +The security-role-ref element contains the declaration of a security
  +role reference in the web application's code. The declaration consists
  +of an optional description, the security role name used in the code,
  +and an optional link to a security role. If the security role is not
  +specified, the Deployer must choose an appropriate security role.
   
  -<!ELEMENT user-data-constraint (description?, transport-guarantee)>
  +The value of the role-name element must be the String used as the
  +parameter to the EJBContext.isCallerInRole(String roleName) method
  +or the HttpServletRequest.isUserInRole(String role) method.
   
  -<!--
  -The transport-guarantee element specifies that the communication
  -between client and server should be NONE, INTEGRAL, or
  -CONFIDENTIAL. NONE means that the application does not require any
  -transport guarantees. A value of INTEGRAL means that the application
  -requires that the data sent between the client and server be sent in
  -such a way that it can't be changed in transit. CONFIDENTIAL means
  -that the application requires that the data be transmitted in a
  -fashion that prevents other entities from observing the contents of
  -the transmission. In most cases, the presence of the INTEGRAL or
  -CONFIDENTIAL flag will indicate that the use of SSL is required.
  --->
  +Used in: servlet
   
  -<!ELEMENT transport-guarantee (#PCDATA)>
  -
  -<!--
  -The auth-constraint element indicates the user roles that should
  -be permitted access to this resource collection. The role-name 
  -used here must either correspond to the role-name of one of the 
  -security-role elements defined for this web application, or be 
  -the specially reserved role-name "*" that is a compact syntax for 
  -indicating all roles in the web application. If both "*" and 
  -rolenames appear, the container interprets this as all roles.
  -If no roles are defined, no user is allowed access to the portion of
  -the web application described by the containing security-constraint.
  -The container matches role names case sensitively when determining 
  -access.
  --->
  -
  -<!ELEMENT auth-constraint (description?, role-name*)>
  -
  -<!--
  -The role-name element contains the name of a security role.
   -->
  -
  -<!ELEMENT role-name (#PCDATA)>
  +<!ELEMENT security-role-ref (description?, role-name, role-link?)>
   
   <!--
  -The login-config element is used to configure the authentication
  -method that should be used, the realm name that should be used for
  -this application, and the attributes that are needed by the form login
  -mechanism.
  --->
  -
  -<!ELEMENT login-config (auth-method?, realm-name?, form-login-config?)>
  +The servlet element contains the declarative data of a
  +servlet. If a jsp-file is specified and the load-on-startup element is
  +present, then the JSP should be precompiled and loaded.
   
  -<!--
  -The realm name element specifies the realm name to use in HTTP
  -Basic authorization
  +Used in: web-app
   -->
  -
  -<!ELEMENT realm-name (#PCDATA)>
  +<!ELEMENT servlet (icon?, servlet-name, display-name?, description?,
  +(servlet-class|jsp-file), init-param*, load-on-startup?, run-as?, \
security-role-ref*)>  
   <!--
  -The form-login-config element specifies the login and error pages
  -that should be used in form based login. If form based authentication
  -is not used, these elements are ignored.
  --->
  -
  -<!ELEMENT form-login-config (form-login-page, form-error-page)>
  +The servlet-class element contains the fully qualified class name
  +of the servlet.
   
  -<!--
  -The form-login-page element defines the location in the web app
  -where the page that can be used for login can be found. The path
  -begins with a leading / and is interpreted relative to the root of the
  -WAR.
  +Used in: servlet
   -->
  -
  -<!ELEMENT form-login-page (#PCDATA)>
  +<!ELEMENT servlet-class (#PCDATA)>
   
   <!--
  -The form-error-page element defines the location in the web app
  -where the error page that is displayed when login is not successful
  -can be found. The path begins with a leading / and is interpreted 
  -relative to the root of the WAR.
  +The servlet-mapping element defines a mapping between a servlet
  +and a url pattern
   
  +Used in: web-app
   -->
  -
  -<!ELEMENT form-error-page (#PCDATA)>
  +<!ELEMENT servlet-mapping (servlet-name, url-pattern)>
   
   <!--
  -The auth-method element is used to configure the authentication
  -mechanism for the web application. As a prerequisite to gaining 
  -access to any web resources which are protected by an authorization
  -constraint, a user must have authenticated using the configured
  -mechanism. Legal values for this element are "BASIC", "DIGEST",
  -"FORM", or "CLIENT-CERT".
  --->
  -
  -<!ELEMENT auth-method (#PCDATA)>
  +The servlet-name element contains the canonical name of the
  +servlet. Each servlet name is unique within the web application.
   
  -<!--
  -The security-role element contains the declaration of a security
  -role which is used in the security-constraints placed on the web
  -application.
  +Used in: filter-mapping, servlet, servlet-mapping
   -->
  -
  -<!ELEMENT security-role (description?, role-name)>
  +<!ELEMENT servlet-name (#PCDATA)>
   
   <!--
  -The security-role-ref element defines a mapping between the name of 
  -role called from a Servlet using 
  -isUserInRole(String name) and the name of a security role defined 
  -for the web application. For example, 
  -to map the security role reference "FOO" to the security role 
  -with role-name "manager" the sytax would 
  -be:
  -
  -<security-role-ref>
  -  
  -
  -
  -
  -<role-name>FOO</role-name>
  -  
  -<role-link>manager</manager>
  -</security-role-ref>
  +The session-config element defines the session parameters for
  +this web application.
   
  -In this case if the servlet called by a user belonging to the "manager" 
  -security role made the API call 
  -isUserInRole("FOO") the result would be true.
  -Since the role-name "*" has a special meaning for authorization 
  -constraints, its value is not permitted here.
  +Used in: web-app
   -->
  -
  -<!ELEMENT security-role-ref (description?, role-name, role-link)>
  +<!ELEMENT session-config (session-timeout?)>
   
   <!--
  -The role-link element is used to link a security role reference
  -to a defined security role. The role-link element must contain the
  -name of one of the security roles defined in the security-role
  -elements.
  --->
  -
  -<!ELEMENT role-link (#PCDATA)>
  +The session-timeout element defines the default session timeout
  +interval for all sessions created in this web application. The
  +specified timeout must be expressed in a whole number of minutes.
  +If the timeout is 0 or less, the container ensures the default
  +behaviour of sessions is never to time out.
   
  -<!--
  -The env-entry element contains the declaration of a web application's
  -environment entry. The declaration consists of an optional
  -description, the name of the environment entry, and an optional
  -value.  If a value is not specified, one must be supplied
  -during deployment.
  +Used in: session-config
   -->
  -
  -<!ELEMENT env-entry (description?, env-entry-name, env-entry-value?,
  -env-entry-type)>
  +<!ELEMENT session-timeout (#PCDATA)>
   
   <!--
  -The env-entry-name element contains the name of a web applications's
  -environment entry.  The name is a JNDI name relative to the
  -java:comp/env context.  The name must be unique within a web application.
  -
  -Example: 
  +The small-icon element contains the name of a file
  +containing a small (16 x 16) icon image. The file
  +name is a relative path within the web application's
  +war file.
   
  -<env-entry-name>minAmount</env-entry-name>
  --->
  +The image may be either in the JPEG or GIF format.
  +The icon can be used by tools.
   
  -<!ELEMENT env-entry-name (#PCDATA)>
  +Used in: icon
   
  -<!--
  -The env-entry-value element contains the value of A_COMPONENT's
  -environment entry. The value must be a String that is valid for the
  -constructor of the specified type that takes a single String
  -parameter, or for java.lang.Character, a single character.
  -
  -Example: 
  +Example:
   
  -<env-entry-value>100.00</env-entry-value>
  +<small-icon>employee-service-icon16x16.jpg</small-icon>
   -->
  -
  -<!ELEMENT env-entry-value (#PCDATA)>
  +<!ELEMENT small-icon (#PCDATA)>
   
   <!--
  -The env-entry-type element contains the fully-qualified Java type of
  -the environment entry value that is expected by THE_COMPONENT's
  -code.
  -
  -The following are the legal values of env-entry-type:
  +The taglib element is used to describe a JSP tag library.
   
  -	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
  +Used in: web-app
   -->
  -
  -<!ELEMENT env-entry-type (#PCDATA)>
  +<!ELEMENT taglib (taglib-uri, taglib-location)>
   
   <!--
  -The ejb-ref element is used for the declaration of a reference to
  -an enterprise bean's home. The declaration consists of:
  +the taglib-location element contains the location (as a resource
  +relative to the root of the web application) where to find the Tag
  +Libary Description file for the tag library.
   
  -	- an optional description
  -	- the EJB reference name used in the code of
  -	  the servlet that's referencing the enterprise bean
  -	- the expected type of the referenced enterprise bean
  -	- the expected home and remote interfaces of the referenced
  -	  enterprise bean
  -	- optional ejb-link information, used to specify the referenced
  -	  enterprise bean
  - 
  +Used in: taglib
   -->
  -
  -<!ELEMENT ejb-ref (description?, ejb-ref-name, ejb-ref-type, home, 
  -remote, ejb-link?)>
  +<!ELEMENT taglib-location (#PCDATA)>
   
   <!--
  -The ejb-ref-name element contains the name of an EJB reference. The
  -EJB reference is an entry in the servlet's environment and is
  -relative to the java:comp/env context.  The name must be unique
  -within the web application.
  -
  -It is recommended that name is prefixed with "ejb/".
  -
  -Example: 
  -
  -<ejb-ref-name>ejb/Payroll</ejb-ref-name>
  --->
  -
  -<!ELEMENT ejb-ref-name (#PCDATA)>
  -
  -<!-- The ejb-ref-type element contains the expected type of the 
  -referenced enterprise bean. The ejb-ref-type element must be one of the following:
  +The taglib-uri element describes a URI, relative to the location
  +of the web.xml document, identifying a Tag Library used in the Web
  +Application.
   
  -   <ejb-ref-type>Entity</ejb-ref-type>
  -   <ejb-ref-type>Session</ejb-ref-type>
  +Used in: taglib
   -->
  -
  -<!ELEMENT ejb-ref-type (#PCDATA)>
  +<!ELEMENT taglib-uri (#PCDATA)>
   
   <!--
  -The home element contains the fully-qualified name of the enterprise
  -bean's home interface.
  -
  -Example:
  +The transport-guarantee element specifies that the communication
  +between client and server should be NONE, INTEGRAL, or
  +CONFIDENTIAL. NONE means that the application does not require any
  +transport guarantees. A value of INTEGRAL means that the application
  +requires that the data sent between the client and server be sent in
  +such a way that it can't be changed in transit. CONFIDENTIAL means
  +that the application requires that the data be transmitted in a
  +fashion that prevents other entities from observing the contents of
  +the transmission. In most cases, the presence of the INTEGRAL or
  +CONFIDENTIAL flag will indicate that the use of SSL is required.
   
  -<home>com.aardvark.payroll.PayrollHome</home>
  +Used in: user-data-constraint
   -->
  -
  -<!ELEMENT home (#PCDATA)>
  +<!ELEMENT transport-guarantee (#PCDATA)>
   
   <!--
  -The remote element contains the fully-qualified name of the enterprise
  -bean's remote interface.
  -
  -Example: 
  +The url-pattern element contains the url pattern of the mapping. Must
  +follow the rules specified in Section 11.2 of the Servlet API
  +Specification.
   
  -<remote>com.wombat.empl.EmployeeService</remote>
  +Used in: filter-mapping, servlet-mapping, web-resource-collection
   -->
  -
  -<!ELEMENT remote (#PCDATA)>
  +<!ELEMENT url-pattern (#PCDATA)>
   
   <!--
  -The ejb-link element is used in the ejb-ref or ejb-local-ref
  -elements to specify that an EJB reference is linked to another
  -enterprise bean.
  -
  -The value of the ejb-link element must be the ejb-name of an
  -enterprise bean in the same J2EE application unit.
  -
  -The name in the ejb-link element may be composed of a
  -path name specifying the ejb-jar containing the referenced enterprise
  -bean with the ejb-name of the target bean appended and separated from
  -the path name by "#".  The path name is relative to the WAR
  -containing the web application that is referencing the enterprise bean.
  -This allows multiple enterprise beans with the same ejb-name to be
  -uniquely identified.
  -
  -Examples: 
  -
  -	<ejb-link>EmployeeRecord</ejb-link>
  -
  -	<ejb-link>../products/product.jar#ProductEJB</ejb-link>
  +The user-data-constraint element is used to indicate how data
  +communicated between the client and container should be protected.
   
  +Used in: security-constraint
   -->
  -
  -<!ELEMENT ejb-link (#PCDATA)>
  -
  +<!ELEMENT user-data-constraint (description?, transport-guarantee)>
   
   <!--
  -The ejb-local-ref element is used for the declaration of a reference to
  -an enterprise bean's local home. The declaration consists of:
  +The web-resource-collection element is used to identify a subset
  +of the resources and HTTP methods on those resources within a web
  +application to which a security constraint applies. If no HTTP methods
  +are specified, then the security constraint applies to all HTTP
  +methods.
   
  -	- an optional description
  -	- the EJB reference name used in the code of THE_COMPONENT
  -	  that's referencing the enterprise bean
  -	- the expected type of the referenced enterprise bean
  -	- the expected local home and local interfaces of the referenced
  -	  enterprise bean
  -	- optional ejb-link information, used to specify the referenced
  -	  enterprise bean
  +Used in: security-constraint
   -->
  -
  -<!ELEMENT ejb-local-ref (description?, ejb-ref-name, ejb-ref-type,
  -		local-home, local, ejb-link?)>
  -
  -<!-- 
  -
  -The local element contains the fully-qualified name of the
  -enterprise bean's local interface. 
  +<!ELEMENT web-resource-collection (web-resource-name, description?,
  +url-pattern*, http-method*)>
   
  -Used by ejb-local-ref
  +<!--
  +The web-resource-name contains the name of this web resource
  +collection.
   
  +Used in: web-resource-collection
   -->
  -<!ELEMENT local (#PCDATA)>
  -
  -<!-- 
  +<!ELEMENT web-resource-name (#PCDATA)>
   
  -The local-home element contains the fully-qualified name of the
  -enterprise bean's local home interface. 
  +<!--
  +The welcome-file element contains file name to use as a default
  +welcome file, such as index.html
   
  -Used by ejb-local-ref
  +Used in: welcome-file-list
   -->
  -<!ELEMENT local-home (#PCDATA)>
  -
  -
  -
  +<!ELEMENT welcome-file (#PCDATA)>
   
   <!--
  -The run-as element, if defined for a servlet, overrides the security 
  -identity used to call an EJB
  -by that servlet in this web application. The role-name is one of the 
  -security roles already
  -defined for this web application.
  +The welcome-file-list contains an ordered list of welcome files
  +elements.
   
  -Used by: <servlet>
  +Used in: web-app
   -->
  -<!ELEMENT run-as (description?, role-name)>
  -
  -
  +<!ELEMENT welcome-file-list (welcome-file+)>
   
   <!--
  -The ID mechanism is to allow tools to easily make tool-specific
  -references to the elements of the deployment descriptor. This allows
  -tools that produce additional deployment information (i.e information
  -beyond the standard deployment descriptor information) to store the
  -non-standard information in a separate file, and easily refer from
  -these tools-specific files to the information in the standard web-app
  -deployment descriptor.
  +The ID mechanism is to allow tools that produce additional deployment
  +information (i.e., information beyond the standard deployment
  +descriptor information) to store the non-standard information in a
  +separate file, and easily refer from these tool-specific files to the
  +information in the standard deployment descriptor.
  +
  +Tools are not allowed to add the non-standard information into the
  +standard deployment descriptor.
   -->
   
  -<!ATTLIST web-app id ID #IMPLIED>
  +<!ATTLIST auth-constraint id ID #IMPLIED>
  +<!ATTLIST auth-method id ID #IMPLIED>
  +<!ATTLIST context-param id ID #IMPLIED>
  +<!ATTLIST description id ID #IMPLIED>
  +<!ATTLIST display-name id ID #IMPLIED>
  +<!ATTLIST distributable id ID #IMPLIED>
  +<!ATTLIST ejb-link id ID #IMPLIED>
  +<!ATTLIST ejb-local-ref id ID #IMPLIED>
  +<!ATTLIST ejb-ref id ID #IMPLIED>
  +<!ATTLIST ejb-ref-name id ID #IMPLIED>
  +<!ATTLIST ejb-ref-type id ID #IMPLIED>
  +<!ATTLIST env-entry id ID #IMPLIED>
  +<!ATTLIST env-entry-name id ID #IMPLIED>
  +<!ATTLIST env-entry-type id ID #IMPLIED>
  +<!ATTLIST env-entry-value id ID #IMPLIED>
  +<!ATTLIST error-code id ID #IMPLIED>
  +<!ATTLIST error-page id ID #IMPLIED>
  +<!ATTLIST exception-type id ID #IMPLIED>
  +<!ATTLIST extension id ID #IMPLIED>
   <!ATTLIST filter id ID #IMPLIED>
  -<!ATTLIST filter-name id ID #IMPLIED>
   <!ATTLIST filter-class id ID #IMPLIED>
   <!ATTLIST filter-mapping id ID #IMPLIED>
  +<!ATTLIST filter-name id ID #IMPLIED>
  +<!ATTLIST form-error-page id ID #IMPLIED>
  +<!ATTLIST form-login-config id ID #IMPLIED>
  +<!ATTLIST form-login-page id ID #IMPLIED>
  +<!ATTLIST home id ID #IMPLIED>
  +<!ATTLIST http-method id ID #IMPLIED>
   <!ATTLIST icon id ID #IMPLIED>
  -<!ATTLIST small-icon id ID #IMPLIED>
  +<!ATTLIST init-param id ID #IMPLIED>
  +<!ATTLIST jsp-file id ID #IMPLIED>
   <!ATTLIST large-icon id ID #IMPLIED>
  -<!ATTLIST display-name id ID #IMPLIED>
  -<!ATTLIST description id ID #IMPLIED>
  -<!ATTLIST distributable id ID #IMPLIED>
  -<!ATTLIST context-param id ID #IMPLIED>
  -<!ATTLIST param-name id ID #IMPLIED>
  -<!ATTLIST param-value id ID #IMPLIED>
   <!ATTLIST listener id ID #IMPLIED>
   <!ATTLIST listener-class id ID #IMPLIED>
  -<!ATTLIST servlet id ID #IMPLIED>
  -<!ATTLIST servlet-name id ID #IMPLIED>
  -<!ATTLIST servlet-class id ID #IMPLIED>
  -<!ATTLIST jsp-file id ID #IMPLIED>
  -<!ATTLIST init-param id ID #IMPLIED>
   <!ATTLIST load-on-startup id ID #IMPLIED>
  -<!ATTLIST servlet-mapping id ID #IMPLIED>
  -<!ATTLIST url-pattern id ID #IMPLIED>
  -<!ATTLIST session-config id ID #IMPLIED>
  -<!ATTLIST session-timeout id ID #IMPLIED>
  +<!ATTLIST local id ID #IMPLIED>
  +<!ATTLIST local-home id ID #IMPLIED>
  +<!ATTLIST location id ID #IMPLIED>
  +<!ATTLIST login-config id ID #IMPLIED>
   <!ATTLIST mime-mapping id ID #IMPLIED>
  -<!ATTLIST extension id ID #IMPLIED>
   <!ATTLIST mime-type id ID #IMPLIED>
  -<!ATTLIST welcome-file-list id ID #IMPLIED>
  -<!ATTLIST welcome-file id ID #IMPLIED>
  -<!ATTLIST taglib id ID #IMPLIED>
  -<!ATTLIST taglib-uri id ID #IMPLIED>
  -<!ATTLIST taglib-location id ID #IMPLIED>
  -<!ATTLIST error-page id ID #IMPLIED>
  -<!ATTLIST error-code id ID #IMPLIED>
  -<!ATTLIST exception-type id ID #IMPLIED>
  -<!ATTLIST location id ID #IMPLIED>
  +<!ATTLIST param-name id ID #IMPLIED>
  +<!ATTLIST param-value id ID #IMPLIED>
  +<!ATTLIST realm-name id ID #IMPLIED>
  +<!ATTLIST remote id ID #IMPLIED>
  +<!ATTLIST res-auth id ID #IMPLIED>
  +<!ATTLIST res-ref-name id ID #IMPLIED>
  +<!ATTLIST res-sharing-scope id ID #IMPLIED>
  +<!ATTLIST res-type id ID #IMPLIED>
   <!ATTLIST resource-env-ref id ID #IMPLIED>
   <!ATTLIST resource-env-ref-name id ID #IMPLIED>
   <!ATTLIST resource-env-ref-type id ID #IMPLIED>
   <!ATTLIST resource-ref id ID #IMPLIED>
  -<!ATTLIST res-ref-name id ID #IMPLIED>
  -<!ATTLIST res-type id ID #IMPLIED>
  -<!ATTLIST res-auth id ID #IMPLIED>
  -<!ATTLIST res-sharing-scope id ID #IMPLIED>
  -<!ATTLIST security-constraint id ID #IMPLIED>
  -<!ATTLIST web-resource-collection id ID #IMPLIED>
  -<!ATTLIST web-resource-name id ID #IMPLIED>
  -<!ATTLIST http-method id ID #IMPLIED>
  -<!ATTLIST user-data-constraint id ID #IMPLIED>
  -<!ATTLIST transport-guarantee id ID #IMPLIED>
  -<!ATTLIST auth-constraint id ID #IMPLIED>
  +<!ATTLIST role-link id ID #IMPLIED>
   <!ATTLIST role-name id ID #IMPLIED>
  -<!ATTLIST login-config id ID #IMPLIED>
  -<!ATTLIST realm-name id ID #IMPLIED>
  -<!ATTLIST form-login-config id ID #IMPLIED>
  -<!ATTLIST form-login-page id ID #IMPLIED>
  -<!ATTLIST form-error-page id ID #IMPLIED>
  -<!ATTLIST auth-method id ID #IMPLIED>
  +<!ATTLIST run-as id ID #IMPLIED>
  +<!ATTLIST security-constraint id ID #IMPLIED>
   <!ATTLIST security-role id ID #IMPLIED>
   <!ATTLIST security-role-ref id ID #IMPLIED>
  -<!ATTLIST role-link id ID #IMPLIED>
  -<!ATTLIST env-entry id ID #IMPLIED>
  -<!ATTLIST env-entry-name id ID #IMPLIED>
  -<!ATTLIST env-entry-value id ID #IMPLIED>
  -<!ATTLIST env-entry-type id ID #IMPLIED>
  -<!ATTLIST ejb-ref id ID #IMPLIED>
  -<!ATTLIST ejb-ref-name id ID #IMPLIED>
  -<!ATTLIST ejb-ref-type id ID #IMPLIED>
  -<!ATTLIST home id ID #IMPLIED>
  -<!ATTLIST remote id ID #IMPLIED>
  -<!ATTLIST ejb-link id ID #IMPLIED>
  -<!ATTLIST ejb-local-ref id ID #IMPLIED>
  -<!ATTLIST local-home id ID #IMPLIED>
  -<!ATTLIST local id ID #IMPLIED>
  -<!ATTLIST run-as id ID #IMPLIED>
  +<!ATTLIST servlet id ID #IMPLIED>
  +<!ATTLIST servlet-class id ID #IMPLIED>
  +<!ATTLIST servlet-mapping id ID #IMPLIED>
  +<!ATTLIST servlet-name id ID #IMPLIED>
  +<!ATTLIST session-config id ID #IMPLIED>
  +<!ATTLIST session-timeout id ID #IMPLIED>
  +<!ATTLIST small-icon id ID #IMPLIED>
  +<!ATTLIST taglib id ID #IMPLIED>
  +<!ATTLIST taglib-location id ID #IMPLIED>
  +<!ATTLIST taglib-uri id ID #IMPLIED>
  +<!ATTLIST transport-guarantee id ID #IMPLIED>
  +<!ATTLIST url-pattern id ID #IMPLIED>
  +<!ATTLIST user-data-constraint id ID #IMPLIED>
  +<!ATTLIST web-app id ID #IMPLIED>
  +<!ATTLIST web-resource-collection id ID #IMPLIED>
  +<!ATTLIST web-resource-name id ID #IMPLIED>
  +<!ATTLIST welcome-file id ID #IMPLIED>
  +<!ATTLIST welcome-file-list id ID #IMPLIED>
  
  
  


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic