struts-config_1_0.dtd

A J2EE & Jsp Example

<?xml version="1.0" encoding="ISO-8859-1"?>


<!--
     DTD for the Struts Application Configuration File, Version 1.0

     To support validation of your configuration file, include the following
     DOCTYPE element at the beginning (after the "xml" declaration):

     <!DOCTYPE struts-config PUBLIC
       "-//Apache Software Foundation//DTD Struts Configuration 1.0//EN"
       "http://jakarta.apache.org/struts/dtds/struts-config_1_0.dtd">

     $Id: struts-config_1_0.dtd,v 1.4.2.1 2001/06/02 18:18:25 craigmcc Exp $
-->


<!-- ========== Defined Types ============================================= -->


<!-- A "BeanName" is the identifier of a JavaBean, such as a form bean,
     and also serves as the name of the corresponding scripting variable
     and the name of the JSP attribute under which the bean is accessed.
     Therefore, it must conform to the rules for a Java identifier.
-->
<!ENTITY % BeanName "CDATA">


<!-- A "Boolean" is the string representation of a boolean (true or false)
     variable.
-->
<!ENTITY % Boolean "(true|false|yes|no)">


<!-- A "ClassName" is the fully qualified name of a Java class that is
     instantiated to provide the functionality of the enclosing element.
-->
<!ENTITY % ClassName "CDATA">


<!-- An "Integer" is a character string consisting solely of numeric digits,
     optionally preceeded by a minus sign, that can be converted to a
     32-bit integer.
-->
<!ENTITY % Integer "CDATA">


<!-- A "Location" is a relative path, delimited by "/" characters, that
     defines the location of a resource relative to the location of the
     Struts configuration file itself.
-->
<!ENTITY % Location "#PCDATA">


<!-- A "PropName" is the name of a JavaBeans property, and must begin with
     a lower case letter and contain only characters that are legal in a
     Java identifier.
-->
<!ENTITY % PropName "CDATA">


<!-- A "RequestPath" is a context-relative URI path, beginning with a slash,
     that identifies a mapped resource (such as a JSP page or a servlet)
     within this web application.
-->
<!ENTITY % RequestPath "CDATA">


<!-- The name of a JSP bean scope within which such a form bean may be
     accessed.
-->
<!ENTITY % RequestScope "(request|session)">


<!-- ========== Top Level Elements ======================================== -->


<!-- The "struts-config" element is the root of the configuration file
     hierarchy, and contains nested elements for all of the other
     configuration settings.
-->
<!ELEMENT struts-config (data-sources?, form-beans?, global-forwards?, action-mappings?)>
<!ATTLIST struts-config  id             ID              #IMPLIED>


<!-- The "data-sources" element describes a set of JDBC 2.0 Standard Extension
     data source objects which will be configured according to the nested
     "data-source" elements found inside.
-->

<!ELEMENT data-sources (data-source*)>
<!ATTLIST data-sources   id             ID              #IMPLIED>


<!-- The "data-source" element describes a JDBC 2.0 Standard Extension data
     source object (that implements javax.sql.DataSource) which will be
     configured according to the properties and nested elements found here,
     and made available as a servlet context attribute (i.e. application
     scope bean).  The following attributes are required:

     key             Servlet context attribute key under which this data
                     source will be stored.  Default is the value specified
                     by string constant Action.DATA_SOURCE_KEY.

     type            Fully qualified Java class name of the implementation
                     class (must implement javax.sql.DataSource).  Default
                     value is 'org.apache.struts.util.GenericDataSource'.

     NOTE:  The following attributes are defined by the default data source
     implementation, and only take effect for that class or subclasses of
     that class.

     WARNING:  The use of these attributes is deprecated.  You should use
     nested &lt;set-property&gt; elements to configure *all* properties of
     your data source implementation.

     autoCommit      The default auto-commit state for newly created
                     connections.

     description     The description of this data source.

     driverClass     The Java class name of the JDBC driver to be used.
                     [REQUIRED]

     loginTimeout    The maximum number of seconds to wait for a connection
                     to be created or returned.  Default is driver dependent.

     maxCount        The maximum number of connections to be created.

     minCount        The minimum number of connections to be created.

     password        The database password to use when connecting. [REQUIRED]

     readOnly        The default read-only state for newly created
                     connections.

     url             The JDBC URL to use when connecting. [REQUIRED]

     user            The database username to use when connecting. [REQUIRED]

-->
<!ELEMENT data-source (set-property*)>
<!ATTLIST data-source    id             ID              #IMPLIED>
<!ATTLIST data-source    key            %BeanName;      #IMPLIED>
<!ATTLIST data-source    type           %ClassName;     #IMPLIED>
<!-- All of the following attributes are deprecated.  Use a nested          -->
<!-- set-property element to configure data source properties.              -->
<!ATTLIST data-source    autoCommit     %Boolean;       #IMPLIED>
<!ATTLIST data-source    description    CDATA           #IMPLIED>
<!ATTLIST data-source    driverClass    %ClassName;     #IMPLIED>
<!ATTLIST data-source    loginTimeout   %Integer;       #IMPLIED>
<!ATTLIST data-source    maxCount       %Integer;       #IMPLIED>
<!ATTLIST data-source    minCount       %Integer;       #IMPLIED>
<!ATTLIST data-source    password       CDATA           #IMPLIED>
<!ATTLIST data-source    readOnly       %Boolean;       #IMPLIED>
<!ATTLIST data-source    url            CDATA           #IMPLIED>
<!ATTLIST data-source    user           CDATA           #IMPLIED>


<!-- The "form-beans" element is the root of the set of form bean descriptors
     for this application.  The following attributes are defined:

     type            Fully qualified Java class name of the implementation
                     class used for ActionFormBean objects.  DEPRECATED.

                     WARNING:  For Struts 1.0, this value is ignored.  You
                     can set the default implementation class name with the
                     "formBean" initialization parameter to the Struts
                     controller servlet.
-->
<!ELEMENT form-beans (form-bean*)>
<!ATTLIST form-beans     id             ID              #IMPLIED>
<!ATTLIST form-beans     type           %ClassName;     "org.apache.struts.action.ActionFormBean">


<!-- The "form-bean" element describes a particular form bean, which is a
     JavaBean that implements the org.apache.struts.action.ActionForm
     class.  The following attributes are defined:

     className       Fully qualified Java class name of the ActionFormBean
                     implementation class to use.  Defaults to the value
                     configured as the "formBean" initialization parameter
                     to the Struts controller servlet.

     name            Unique identifier of this bean, used to reference it
                     in corresponding action mappings.

     type            Fully qualified Java class name of the implementation
                     class to be used or generated
-->
<!ELEMENT form-bean (icon?, display-name?, description?, set-property*)>
<!ATTLIST form-bean      id             ID              #IMPLIED>
<!ATTLIST form-bean      className      %ClassName;     #IMPLIED>
<!ATTLIST form-bean      name           %BeanName;      #REQUIRED>
<!ATTLIST form-bean      type           %ClassName;     #REQUIRED>


<!-- The "global-forwards" element configures the global mappings of logical
     names (used within the application) to mappable resources (identified
     by context-relative URI paths).  A global "forward" with a particular name
     can be locally overridden by defining a "forward" of the same name within
     an "action" element.  The following attribute are defined:

     type            Fully qualified Java class name of the implementation
                     class used for ActionForward objects.  DEPRECATED.