struts-config_1_2.dtd
上传用户:zghglow
上传日期:2022-08-09
资源大小:27227k
文件大小:34k
源码类别:

WEB源码(ASP,PHP,...)

开发平台:

JavaScript

  1. <!--
  2.     Licensed to the Apache Software Foundation (ASF) under one or more
  3.     contributor license agreements.  See the NOTICE file distributed with
  4.     this work for additional information regarding copyright ownership.
  5.     The ASF licenses this file to You under the Apache License, Version 2.0
  6.     (the "License"); you may not use this file except in compliance with
  7.     the License.  You may obtain a copy of the License at
  8.    
  9.          http://www.apache.org/licenses/LICENSE-2.0
  10.    
  11.     Unless required by applicable law or agreed to in writing, software
  12.     distributed under the License is distributed on an "AS IS" BASIS,
  13.     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.     See the License for the specific language governing permissions and
  15.     limitations under the License.
  16. -->
  17. <!--
  18.      DTD for the Struts Application Configuration File
  19.      To support validation of your configuration file, include the following
  20.      DOCTYPE element at the beginning (after the "xml" declaration):
  21.      <!DOCTYPE struts-config PUBLIC
  22.        "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
  23.        "http://struts.apache.org/dtds/struts-config_1_2.dtd">
  24.      $Id$
  25. -->
  26. <!-- ========== Defined Types ============================================= -->
  27. <!-- An "AttributeName" is the identifier of a page, request, session, or
  28.      application scope attribute.
  29. -->
  30. <!ENTITY % AttributeName "CDATA">
  31. <!-- A "BeanName" is the identifier of a JavaBean, such as a form bean,
  32.      and also serves as the name of the corresponding scripting variable
  33.      and the name of the JSP attribute under which the bean is accessed.
  34.      Therefore, it must conform to the rules for a Java identifier.
  35. -->
  36. <!ENTITY % BeanName "CDATA">
  37. <!-- A "Boolean" is the string representation of a boolean (true or false)
  38.      variable.
  39. -->
  40. <!ENTITY % Boolean "(true|false|yes|no)">
  41. <!-- A "ClassName" is the fully qualified name of a Java class that is
  42.      instantiated to provide the functionality of the enclosing element.
  43. -->
  44. <!ENTITY % ClassName "CDATA">
  45. <!-- An "Integer" is a character string consisting solely of numeric digits,
  46.      optionally preceeded by a minus sign, that can be converted to a
  47.      32-bit integer.
  48. -->
  49. <!ENTITY % Integer "CDATA">
  50. <!-- A "Location" is a relative path, delimited by "/" characters, that
  51.      defines the location of a resource relative to the location of the
  52.      Struts configuration file itself.
  53. -->
  54. <!ENTITY % Location "#PCDATA">
  55. <!-- A "PropName" is the name of a JavaBeans property, and must begin with
  56.      a lower case letter and contain only characters that are legal in a
  57.      Java identifier.
  58. -->
  59. <!ENTITY % PropName "CDATA">
  60. <!-- A "RequestPath" is an module-relative URI path, beginning with a
  61.      slash, that identifies a mapped resource (such as a JSP page or a servlet)
  62.      within this web application.
  63. -->
  64. <!ENTITY % RequestPath "CDATA">
  65. <!-- The name of a JSP bean scope within which such a form bean may be
  66.      accessed.
  67. -->
  68. <!ENTITY % RequestScope "(request|session)">
  69. <!-- ========== Top Level Elements ======================================== -->
  70. <!-- The "struts-config" element is the root of the configuration file
  71.      hierarchy, and contains nested elements for all of the other
  72.      configuration settings.
  73. -->
  74. <!ELEMENT struts-config (display-name?, description?, data-sources?, form-beans?, global-exceptions?, global-forwards?, action-mappings?, controller?, message-resources*, plug-in*)>
  75. <!ATTLIST struts-config  id             ID              #IMPLIED>
  76. <!-- The "data-sources" element describes a set of DataSource objects [JDBC 2.0
  77.      Standard Extension]. The individual DataSource objects are configured through
  78.      nested <data-source> elements.
  79. -->
  80. <!ELEMENT data-sources (data-source*)>
  81. <!ATTLIST data-sources   id             ID              #IMPLIED>
  82. <!-- The "data-source" element describes a DataSource object [JDBC 2.0 Standard
  83.      Extension] that will be instantiated, configured, and made available as a
  84.      servlet context attribute (or "application-scope bean"). Any object can be
  85.      specified so long as it implements [javax.sql.DataSource] and can be
  86.      configured entirely from JavaBean properties. The following attributes
  87.      are required:
  88.      className       The configuration bean for this DataSource object. If
  89.                      specified, the object must be a subclass of the default
  90.                      configuration bean.
  91.                      ["org.apache.struts.config.DataSourceConfig"]
  92.      key             Servlet context attribute key under which this data source
  93.                      will be stored.  Default is the value specified by string
  94.                      constant defined by Globals.DATA_SOURCE_KEY. The application
  95.                      module prefix (if any) is appended to the key
  96.                      (${key}$prefix}).
  97.                      [org.apache.struts.Globals.DATA_SOURCE_KEY]
  98.                      NOTE: The application module prefix includes the leading
  99.                      slash, so the default datasource for a module named "foo" is
  100.                      stored under "org.apache.struts.action.DATA_SOURCE/foo".
  101.      type          Fully qualified Java class name for this data source object.
  102.                      The class must implement DataSource [javax.sql.DataSource],
  103.                      and the object must be configurable entirely from JavaBean
  104.                      properties.
  105. -->
  106. <!ELEMENT data-source (set-property*)>
  107. <!ATTLIST data-source    id             ID              #IMPLIED>
  108. <!ATTLIST data-source    className      %ClassName;     #IMPLIED>
  109. <!ATTLIST data-source    key            %AttributeName; #IMPLIED>
  110. <!ATTLIST data-source    type           %ClassName;     #REQUIRED>
  111. <!-- The "form-beans" element describes the set of form bean descriptors for this
  112.      module. The following attributes are defined:
  113.      type            Fully qualified Java class to use when instantiating
  114.                      ActionFormBean objects. If specified, the object must be a
  115.                      subclass of the default class type.
  116.                      WARNING:  For Struts 1.0, this value is ignored.  You
  117.                      can set the default implementation class name with the
  118.                      "formBean" initialization parameter to the Struts
  119.                      controller servlet.
  120. -->
  121. <!ELEMENT form-beans (form-bean*)>
  122. <!ATTLIST form-beans     id             ID              #IMPLIED>
  123. <!ATTLIST form-beans     type           %ClassName;     #IMPLIED>
  124. <!-- The "form-bean" element describes an ActionForm subclass
  125.      [org.apache.struts.action.ActionForm] that can be referenced by an "action"
  126.      element.
  127. The "form-bean" element describes a particular form bean, which is a
  128.      JavaBean that implements the org.apache.struts.action.ActionForm
  129.      class.  The following attributes are defined:
  130.      className       The configuration bean for this form bean object. If
  131.                      specified, the object must be a subclass of the default
  132.                      configuration bean.
  133.                      ["org.apache.struts.config.FormBeanConfig"]
  134.      name            The unique identifier for this form bean. Referenced by the
  135.                      <action> element to specify which form bean to use with its
  136.                      request.
  137.      type            Fully qualified Java class name of the ActionForm subclass
  138.                      to use with this form bean.
  139. -->
  140. <!ELEMENT form-bean (icon?, display-name?, description?, set-property*, form-property*)>
  141. <!ATTLIST form-bean      id             ID              #IMPLIED>
  142. <!ATTLIST form-bean      className      %ClassName;     #IMPLIED>
  143. <!ATTLIST form-bean      dynamic        %Boolean;       #IMPLIED>
  144. <!ATTLIST form-bean      name           %BeanName;      #REQUIRED>
  145. <!ATTLIST form-bean      type           %ClassName;     #REQUIRED>
  146. <!-- The "form-property" element describes a JavaBean property that can be used to
  147.      configure an instance of a DynaActionForm or a subclass thereof. This element
  148.      is only utilized when the "type" attribute of the enclosing "form-bean" element
  149.      is [org.apache.struts.action.DynaActionForm] or a subclass of DynaActionForm. If
  150.      a custom DynaActionForm subclass is used, then the "dynamic" attribute of the
  151.      enclosing <form-bean> element must be set to "true". Since Struts 1.1.
  152.      className       The configuration bean for this form property object. If
  153.                      specified, the object must be a subclass of the default
  154.                      configuration bean.
  155.                      ["org.apache.struts.config.FormPropertyConfig"]
  156.      initial         String representation of the initial value for this property.
  157.                      If not specified, primitives will be initialized to zero and
  158.                      objects initialized to the zero-argument instantiation of that
  159.                      object class.  For example, Strings will be initialized to ""
  160.      name            The name of the JavaBean property described by this element.
  161.      size            The number of array elements to create if the value of the
  162.                      "type" attribute specifies an array, but there is no value
  163.                      specified for the "initial" attribute.
  164.      type            Fully qualified Java class name of the field underlying this
  165.                      property, optionally followed by "[]" to indicate that the
  166.                      field is indexed.
  167. -->
  168. <!ELEMENT form-property  (set-property*)>
  169. <!ATTLIST form-property  className      %ClassName;     #IMPLIED>
  170. <!ATTLIST form-property  initial        CDATA           #IMPLIED>
  171. <!ATTLIST form-property  name           %PropName;      #REQUIRED>
  172. <!ATTLIST form-property  size           %Integer;       #IMPLIED>
  173. <!ATTLIST form-property  type           %ClassName;     #REQUIRED>
  174. <!-- The "global-exceptions" element describes a set of exceptions that might be
  175.      thrown by an Action object. The handling of individual exception types is
  176.      configured through nested exception elements. An <action> element may
  177.      override a global exception handler by registering a local exception handler
  178.      for the same exception type. Since Struts 1.1.
  179. -->
  180. <!ELEMENT global-exceptions (exception*)>
  181. <!ATTLIST global-exceptions id          ID              #IMPLIED>
  182. <!-- The "exception" element registers an ExceptionHandler for an exception type.
  183.      The following attributes are defined:
  184.     bundle           Servlet context attribute for the message resources bundle
  185.                      associated with this handler. The default attribute is the
  186.                      value specified by the string constant declared at
  187.                      Globals.MESSAGES_KEY.
  188.                      [org.apache.struts.Globals.MESSAGES_KEY]
  189.     className        The configuration bean for this ExceptionHandler object.
  190.                      If specified, className must be a subclass of the default
  191.                      configuration bean
  192.                      ["org.apache.struts.config.ExceptionConfig"]
  193.     handler          Fully qualified Java class name for this exception handler.
  194.                      ["org.apache.struts.action.ExceptionHandler"]
  195.     key              The key to use with this handler's message resource bundle
  196.                      that will retrieve the error message template for this
  197.                      exception.
  198.     path             The module-relative URI to the resource that will complete
  199.                      the request/response if this exception occurs.
  200.     scope            The context ("request" or "session") that is used to access
  201.                      the ActionError object [org.apache.struts.action.ActionError]
  202.                      for this exception.
  203.     type             Fully qualified Java class name of the exception type to
  204.                      register with this handler.
  205. -->
  206. <!ELEMENT exception (icon?, display-name?, description?, set-property*)>
  207. <!ATTLIST exception      id             ID              #IMPLIED>
  208. <!ATTLIST exception      bundle         %AttributeName; #IMPLIED>
  209. <!ATTLIST exception      className      %ClassName;     #IMPLIED>
  210. <!ATTLIST exception      handler        %ClassName;     #IMPLIED>
  211. <!ATTLIST exception      key            CDATA           #REQUIRED>
  212. <!ATTLIST exception      path           %RequestPath;   #IMPLIED>
  213. <!ATTLIST exception      scope          CDATA           #IMPLIED>
  214. <!ATTLIST exception      type           %ClassName;     #REQUIRED>
  215. <!-- The "global-forwards" element describes a set of ActionForward objects
  216.      [org.apache.struts.action.ActionForward] that are available to all Action
  217.      objects as a return value. The individual ActionForwards are configured
  218.      through nested <forward> elements. An <action> element may override a global
  219.      forward by defining a local <forward> of the same name.
  220.      type            Fully qualified Java class to use when instantiating
  221.                      ActionForward objects.  If specified, the object must be a
  222.                      subclass of the default class type.
  223.                      WARNING:  For Struts 1.0, this value is ignored.  You
  224.                      can set the default implementation class name with the
  225.                      "forward" initialization parameter to the Struts
  226.                      controller servlet.
  227. -->
  228. <!ELEMENT global-forwards (forward*)>
  229. <!ATTLIST global-forwards id            ID              #IMPLIED>
  230. <!ATTLIST global-forwards type          %ClassName;     #IMPLIED>
  231. <!-- The "forward" element describes an ActionForward that is to be made
  232.      available to an Action as a return value. An ActionForward is referenced by
  233.      a logical name and encapsulates a URI. A "forward" element may be used to
  234.      describe both global and local ActionForwards. Global forwards are available
  235.      to all the Action objects in the module. Local forwards can be
  236.      nested within an <action> element and only available to an Action object
  237.      when it is invoked through that ActionMapping.
  238.      className       Fully qualified Java class name of ActionForward
  239.                      subclass to use for this object.
  240.                      ["org.apache.struts.action.ActionForward"]
  241.     contextRelative  Set this to "true" if, in a modular application, the path
  242.                      attribute starts with a slash "/" and should be considered
  243.                      relative to the entire web application rather than the module.
  244.                      Since Struts 1.1.
  245.                      DEPRECATED.
  246.                      [false]
  247.      module          The module prefix to use with this path. This value should
  248.                      begin with a slash ("/").
  249.      name            The unique identifier for this forward. Referenced by the
  250.                      Action object at runtime to select - by its logical name -
  251.                      the resource that should complete the request/response.
  252.      path            The module-relative or context-relative path to the resources
  253.                      that is encapsulated by the logical name of this ActionForward.
  254.                      If the path is to be considered context-relative when used in
  255.                      a modular application, then the contextRelative attribute
  256.                      should be set to "true". This value should begin with a slash
  257.                      ("/") character.
  258.      redirect        Set to "true" if a redirect instruction should be issued to
  259.                      the user-agent so that a new request is issued for this
  260.                      forward's resource. If true,  RequestDispatcher.Redirect is
  261.                      called. If "false", RequestDispatcher.forward is called instead.
  262.                      [false]
  263. -->
  264. <!ELEMENT forward (icon?, display-name?, description?, set-property*)>
  265. <!ATTLIST forward        id             ID              #IMPLIED>
  266. <!ATTLIST forward        className      %ClassName;     #IMPLIED>
  267. <!ATTLIST forward        contextRelative %Boolean;      #IMPLIED>
  268. <!ATTLIST forward        module         %RequestPath;   #IMPLIED>
  269. <!ATTLIST forward        name           CDATA           #REQUIRED>
  270. <!ATTLIST forward        path           %RequestPath;   #REQUIRED>
  271. <!ATTLIST forward        redirect       %Boolean;       #IMPLIED>
  272. <!-- The "action-mappings" element describes a set of ActionMapping objects
  273.      [org.apache.struts.action.ActionMapping] that are available to process
  274.      requests matching the url-pattern our ActionServlet registered with the
  275.      container. The individual ActionMappings are configured through nested
  276.      <action> elements. The following attributes are defined:
  277.      type           Fully qualified Java class to use when instantiating
  278.                     ActionMapping objects. If specified, the object must be a
  279.                     subclass of the default class type.
  280.                     WARNING:  For Struts 1.0, this value is ignored.  You
  281.                     can set the default implementation class name with the
  282.                     "mapping" initialization parameter to the Struts
  283.                     controller servlet.
  284. -->
  285. <!ELEMENT action-mappings (action*)>
  286. <!ATTLIST action-mappings id             ID              #IMPLIED>
  287. <!ATTLIST action-mappings type           %ClassName;     #IMPLIED>
  288. <!-- The "action" element describes an ActionMapping object that is to be used
  289.      to process a request for a specific module-relative URI. The following
  290.      attributes are defined:
  291.      attribute       Name of the request-scope or session-scope attribute that
  292.                      is used to access our ActionForm bean, if it is other than
  293.                      the bean's specified "name". Optional if "name" is specified,
  294.                      else not valid.
  295.      className       The fully qualified Java class name of the ActionMapping
  296.                      subclass to use for this action mapping object. Defaults to
  297.                      the type specified by the enclosing <action-mappings>
  298.                      element or to "org.apache.struts.action.ActionMapping" if
  299.                      not specified.
  300.                      ["org.apache.struts.action.ActionMapping"]
  301.      forward         Module-relative path of the servlet or other resource that
  302.                      will process this request, instead of the Action class
  303.                      specified by "type".  The path WILL NOT be processed
  304.                      through the "forwardPattern" attribute that is configured
  305.                      on the "controller" element for this module.
  306.                      Exactly one of "forward", "include", or "type" must be
  307.                      specified.
  308.      include         Module-relative path of the servlet or other resource that
  309.                      will process this request, instead of the Action class
  310.                      specified by "type".  The path WILL NOT be processed
  311.                      through the "forwardPattern" attribute that is configured
  312.                      on the "controller" element for this module.
  313.                      Exactly one of "forward", "include", or "type" must be
  314.                      specified.
  315.      input           Module-relative path of the action or other resource to
  316.                      which control should be returned if a validation error is
  317.                      encountered. Valid only when "name" is specified. Required
  318.                      if "name" is specified and the input bean returns
  319.                      validation errors. Optional if "name" is specified and the
  320.                      input bean does not return validation errors.
  321.      name            Name of the form bean, if any, that is associated with this
  322.                      action mapping.
  323.      path            The module-relative path of the submitted request, starting
  324.                      with a "/" character, and without the filename extension if
  325.                      extension mapping is used.
  326.                      NOTE:  Do *not* include a period in your path name,
  327.                      because it will look like a filename extension and
  328.                      cause your Action to not be located.
  329.      parameter       General-purpose configuration parameter that can be used to
  330.                      pass extra information to the Action object selected by
  331.                      this action mapping.
  332.      prefix          Prefix used to match request parameter names to ActionForm
  333.                      property names, if any. Optional if "name" is specified,
  334.                      else not allowed.
  335.      roles           Comma-delimited list of security role names that are allowed
  336.                      access to this ActionMapping object. Since Struts 1.1.
  337.      scope           The context ("request" or "session") that is used to
  338.                      access our ActionForm bean, if any.  Optional if "name" is
  339.                      specified, else not valid. [session]
  340.      suffix          Suffix used to match request parameter names to ActionForm
  341.                      bean property names, if any. Optional if "name" is
  342.                      specified, else not valid.
  343.      type            Fully qualified Java class name of the Action subclass
  344.                      [org.apache.struts.action.Action] that will process requests
  345.                      for this action mapping. Not valid if either the "forward"
  346.                      or "include" attribute is specified.  Exactly one of
  347.                      "forward", "include", or "type" must be specified.
  348.      unknown         Set to "true" if this object should be configured as the
  349.                      default action mapping for this module. If a request does not
  350.                      match another object, it will be passed to the ActionMapping
  351.                      object with unknown set to "true". Only one ActionMapping
  352.                      can be marked as "unknown" within a module.
  353.                      [false]
  354.      validate        Set to "true" if the validate method of the ActionForm bean
  355.                      should be called prior to calling the Action object for this
  356.                      action mapping, or set to "false" if you do not want the
  357.                      validate method called.
  358.                      [true]
  359. -->
  360. <!ELEMENT action (icon?, display-name?, description?, set-property*, exception*, forward*)>
  361. <!ATTLIST action         id             ID              #IMPLIED>
  362. <!ATTLIST action         attribute      %BeanName;      #IMPLIED>
  363. <!ATTLIST action         className      %ClassName;     #IMPLIED>
  364. <!ATTLIST action         forward        %RequestPath;   #IMPLIED>
  365. <!ATTLIST action         include        %RequestPath;   #IMPLIED>
  366. <!ATTLIST action         input          %RequestPath;   #IMPLIED>
  367. <!ATTLIST action         name           %BeanName;      #IMPLIED>
  368. <!ATTLIST action         parameter      CDATA           #IMPLIED>
  369. <!ATTLIST action         path           %RequestPath;   #REQUIRED>
  370. <!ATTLIST action         prefix         CDATA           #IMPLIED>
  371. <!ATTLIST action         roles          CDATA           #IMPLIED>
  372. <!ATTLIST action         scope          %RequestScope;  #IMPLIED>
  373. <!ATTLIST action         suffix         CDATA           #IMPLIED>
  374. <!ATTLIST action         type           %ClassName;     #IMPLIED>
  375. <!ATTLIST action         unknown        %Boolean;       #IMPLIED>
  376. <!ATTLIST action         validate       %Boolean;       #IMPLIED>
  377. <!-- The "controller" element describes the ControllerConfig bean
  378.      [org.apache.struts.config.ControllerConfig] that encapsulates
  379.      a module's runtime configuration. The following
  380.      attributes are defined:
  381.      bufferSize      The size of the input buffer used when processing
  382.                      file uploads.
  383.                      [4096]
  384.      className       Fully qualified Java class name of the
  385.                      ControllerConfig subclass for this controller object.
  386.                      If specified, the object must be a subclass of the
  387.                      default class.
  388.                      ["org.apache.struts.config.ControllerConfig"]
  389.      contentType     Default content type (and optional character encoding) to
  390.                      be set on each response. May be overridden by the Action,
  391.                      JSP, or other resource to which the request is forwarded.
  392.                      ["text/html"]
  393.      forwardPattern  Replacement pattern defining how the "path" attribute of a
  394.                      <forward> element is mapped to a context-relative URL when
  395.                      it starts with a slash (and when the contextRelative
  396.                      property is false). This value may consist of any
  397.                      combination of the following:
  398.                      - "$M" - Replaced by the module prefix of this module
  399.                      - "$P" - Replaced by the "path" attribute of the  selected
  400.                      "forward" element
  401.                      - "$$" - Causes a literal dollar sign to be rendered
  402.                      - "$x" - (Where "x" is any character not defined above)
  403.                      Silently swallowed, reserved for future use
  404.                      If not specified, the default forwardPattern is "$M$P",
  405.                      which is consistent with the previous behavior of
  406.                      forwards.  Since Struts 1.1.  ["$M$P"]
  407.      inputForward    Set to "true" if you want the "input" attribute of
  408.                      <action> elements to be the name of a local or global
  409.                      ActionForward, which will then be used to calculate the
  410.                      ultimate URL. Set to "false" (the default) to treat the
  411.                      "input" parameter of <action> elements as a
  412.                      module-relative path to the resource
  413.                      to be used as the input form. Since Struts 1.1.
  414.                      [false]
  415.      locale          Set to "true" if you want a Locale object stored in the
  416.                      user's session if not already present.
  417.                      [true]
  418.      maxFileSize     The maximum size (in bytes) of a file to be accepted as a
  419.                      file upload.  Can be expressed as a number followed by a
  420.                      "K", "M", or "G", which are interpreted to mean kilobytes,
  421.                      megabytes, or gigabytes, respectively.
  422.                      ["250M"]
  423.      memFileSize     The maximum size (in bytes) of a file whose contents will
  424.                      be retained in memory after uploading. Files larger than
  425.                      this threshold will be written to some alternative storage
  426.                      medium, typically a hard disk. Can be expressed as a number
  427.                      followed by a "K", "M", or "G", which are interpreted to
  428.                      mean kilobytes, megabytes, or gigabytes, respectively.
  429.                      ["256K"]
  430.      multipartClass  The fully qualified Java class name of the multipart
  431.                      request handler class to be used with this module.
  432.                      ["org.apache.struts.upload.CommonsMultipartRequestHandler"]
  433.      nocache         Set to "true" if you want the controller to add HTTP
  434.                      headers for defeating caching to every response from
  435.                      this module.  [false]
  436.      pagePattern     Replacement pattern defining how the "page" attribute of
  437.                      custom tags using it is mapped to a context-relative URL
  438.                      of the corresponding resource.  This value may consist of
  439.                      any combination of the following:
  440.                      - "$M" - Replaced by the module prefix of this module
  441.                      - "$P" - Replaced by the value of the "page" attribute
  442.                      - "$$" - Causes a literal dollar sign to be rendered
  443.                      - "$x" - (Where "x" is any character not defined above)
  444.                               Silently swallowed, reserved for future use
  445.                      If not specified, the default forwardPattern is
  446.                      "$M$P", which is consistent with previous hard coded
  447.                      behavior of URL evaluation for "page" attributes.
  448.                      ["$M$P"]
  449.      processorClass  The fully qualified Java class name of the
  450.                      RequestProcessor subclass to be used with this module.
  451.                      ["org.apache.struts.action.RequestProcessor"]
  452.      tempDir         Temporary working directory to use when processing
  453.                      file uploads.
  454.                      [{Directory provided by servlet container}]
  455. -->
  456. <!ELEMENT controller     (set-property*)>
  457. <!ATTLIST controller     id             ID              #IMPLIED>
  458. <!ATTLIST controller     bufferSize     %Integer;       #IMPLIED>
  459. <!ATTLIST controller     className      %ClassName;     #IMPLIED>
  460. <!ATTLIST controller     contentType    CDATA           #IMPLIED>
  461. <!ATTLIST controller     forwardPattern CDATA           #IMPLIED>
  462. <!ATTLIST controller     inputForward   %Boolean;       #IMPLIED>
  463. <!ATTLIST controller     locale         %Boolean;       #IMPLIED>
  464. <!ATTLIST controller     maxFileSize    CDATA           #IMPLIED>
  465. <!ATTLIST controller     memFileSize    CDATA           #IMPLIED>
  466. <!ATTLIST controller     multipartClass %ClassName;     #IMPLIED>
  467. <!ATTLIST controller     nocache        %Boolean;       #IMPLIED>
  468. <!ATTLIST controller     pagePattern    CDATA           #IMPLIED>
  469. <!ATTLIST controller     processorClass %ClassName;     #IMPLIED>
  470. <!ATTLIST controller     tempDir        CDATA           #IMPLIED>
  471. <!-- The "message-resources" element describes a MessageResources object with
  472.      message templates for this module. The following attributes are defined:
  473.      className       The configuration bean for this message resources object.
  474.                      If specified, the object must be a subclass of the default
  475.                      configuration bean.
  476.                      ["org.apache.struts.config.MessageResourcesConfig"]
  477.      factory         Fully qualified Java class name of the
  478.                      MessageResourcesFactory subclass to use for this message
  479.                      resources object.
  480.                      ["org.apache.struts.util.PropertyMessageResourcesFactory"]
  481.      key             Servlet context attribute under which this message
  482.                      resources bundle will be stored. The default attribute is
  483.                      the value specified by the string constant at
  484.                      [Globals.MESSAGES_KEY]. The module prefix (if
  485.                      any) is appended to the key (${key}${prefix}).
  486.                      [org.apache.struts.Globals.MESSAGES_KEY]
  487.                      NOTE: The module  prefix includes the leading
  488.                      slash, so the default message resource bundle for a module
  489.                      named "foo" is stored under
  490.                      "org.apache.struts.action.MESSAGE/foo".
  491.      null            Set to "true" if you want our message resources to return a
  492.                      null string for unknown message keys, or "false" to return a
  493.                      message with the bad key value.
  494.      parameter       Configuration parameter to be passed to the createResources
  495.                      method of our factory object.
  496. -->
  497. <!ELEMENT message-resources (set-property*)>
  498. <!ATTLIST message-resources id          ID              #IMPLIED>
  499. <!ATTLIST message-resources className   %ClassName;     #IMPLIED>
  500. <!ATTLIST message-resources factory     %ClassName;     #IMPLIED>
  501. <!ATTLIST message-resources key         %AttributeName; #IMPLIED>
  502. <!ATTLIST message-resources null        %Boolean;       #IMPLIED>
  503. <!ATTLIST message-resources parameter   CDATA           #REQUIRED>
  504. <!-- The "plug-in" element specifies the fully qualified class name of a
  505.      general-purpose application plug-in module that receives notification of
  506.      application startup and shutdown events. An instance of the specified class
  507.      is created for each element, and can be configured with nested <set-property>
  508.      elements. The following attributes are supported:
  509.      className       Fully qualified Java class name of the plug-in class; must
  510.                      implement [org.apache.struts.action.PlugIn].
  511. -->
  512. <!ELEMENT plug-in           (set-property*)>
  513. <!ATTLIST plug-in           id          ID              #IMPLIED>
  514. <!ATTLIST plug-in           className   %ClassName;     #REQUIRED>
  515. <!-- ========== Subordinate Elements ====================================== -->
  516. <!-- The "description" element contains descriptive (paragraph length) text
  517.      about the surrounding element, suitable for use in GUI tools.
  518. -->
  519. <!ELEMENT description    (#PCDATA)>
  520. <!ATTLIST description    id             ID              #IMPLIED>
  521. <!-- The "display-name" element contains a short (one line) description of
  522.      the surrounding element, suitable for use in GUI tools.
  523. -->
  524. <!ELEMENT display-name (#PCDATA)>
  525. <!ATTLIST display-name   id             ID              #IMPLIED>
  526. <!-- The "icon" element contains a small-icon and large-icon element which
  527.      specify the location, relative to the Struts configuration file, for small
  528.      and large images used to represent the surrounding element in GUI tools.
  529. -->
  530. <!ELEMENT icon           (small-icon?, large-icon?)>
  531. <!ATTLIST icon           id             ID              #IMPLIED>
  532. <!-- The "large-icon" element specifies the location, relative to the Struts
  533.      configuration file, of a resource containing a large (32x32 pixel)
  534.      icon image.
  535. -->
  536. <!ELEMENT large-icon     (%Location;)>
  537. <!ATTLIST large-icon     id             ID              #IMPLIED>
  538. <!-- The "set-property" element specifies the method name and initial value of
  539.      an additional JavaBean configuration property. When the object representing
  540.      the surrounding element is instantiated, the accessor for the indicated
  541.      property is called and passed the indicated value. The "set-property"
  542.      element is especially useful when a custom subclass is used with
  543.      <data-source>, <forward>, <action>, or <plug-in> elements. The subclass
  544.      can be passed whatever other properties may be required to configure the
  545.      object without changing how the struts-config is parsed.
  546.      property        Name of the JavaBeans property whose setter method
  547.                      will be called.
  548.      value           String representation of the value to which this
  549.                      property will be set, after suitable type conversion
  550. -->
  551. <!ELEMENT set-property   EMPTY>
  552. <!ATTLIST set-property   id             ID              #IMPLIED>
  553. <!ATTLIST set-property   property       %PropName;      #REQUIRED>
  554. <!ATTLIST set-property   value          CDATA           #REQUIRED>
  555. <!-- The "small-icon" element specifies the location, relative to the Struts
  556.      configuration file, of a resource containing a small (16x16 pixel)
  557.      icon image.
  558. -->
  559. <!ELEMENT small-icon     (%Location;)>
  560. <!ATTLIST small-icon     id             ID              #IMPLIED>