| <!-- |
| DTD for the Struts Application Configuration File |
| |
| 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.2//EN" |
| "http://jakarta.apache.org/struts/dtds/struts-jericho-config_2_0.dtd"> |
| |
| $Id: struts-jericho-config_2_0.dtd,v 1.5 2003/12/19 02:35:07 husted Exp $ |
| --> |
| |
| |
| <!-- ========== Defined Types ============================================= --> |
| |
| |
| <!-- An "Identifier" is the name of a programming construct and must conform |
| to the rules for identifiers in the Java language. |
| --> |
| <!ENTITY % Identifier "CDATA"> |
| |
| |
| <!-- An "AttributeName" is the identifier of a page, request, session, or |
| application scope attribute. |
| --> |
| <!ENTITY % AttributeName "CDATA"> |
| |
| |
| <!-- A "PropObject" is the identifier of an object, such as an input form, |
| and also serves as the name of the corresponding scripting variable |
| and the name of the attribute under which the object is accessed. |
| Therefore, it must conform to the rules for an Identifier. |
| --> |
| <!ENTITY % PropObject "CDATA"> |
| |
| |
| <!-- A "Boolean" is the string representation of a boolean (true or false) |
| variable. |
| --> |
| <!ENTITY % Boolean "(true|false)"> |
| |
| |
| <!-- A "ClassName" is the fully qualified name of a compiled 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 "Resource" 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 % Resource "#PCDATA"> |
| |
| |
| <!-- A "PropName" is the name of an object property, and must begin with |
| a lower case letter and contain only characters that are legal in a |
| identifier. |
| --> |
| <!ENTITY % PropName "CDATA"> |
| |
| |
| <!-- A "RequestPath" is an application-relative URI path, beginning with a |
| slash, that identifies a mapped resource (such as a server page or a |
| servlet) within this web application. |
| --> |
| <!ENTITY % RequestPath "CDATA"> |
| |
| |
| <!-- The name of a scope within which a object, such as an input handler, may be accessed. |
| --> |
| <!ENTITY % Scope "(request|session|application)"> |
| |
| |
| <!-- A "LocationType" is the string representation of the alternate ways a response |
| can be rendered |
| --> |
| <!ENTITY % LocationType "(forward|include|redirect)"> |
| |
| |
| <!-- ========== 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 ( |
| display-name?, |
| description?, |
| property*, |
| catalog*, |
| inputs?, |
| locations?, |
| exceptions?, |
| processors?, |
| mappings?, |
| bundles, |
| plug-in*)> |
| |
| <!ATTLIST struts-config id ID #IMPLIED> |
| |
| <!-- The <property> element refers to the location of a properties file, |
| relative to the Struts configuration file, that contains replacement |
| variables to use when processing the elements. The properties defined |
| can be referred to using the standard "shell" notation: ${property}. |
| |
| Properties can be used to avoid redundacy. For example, an often-used |
| class name can be listed in the properties file: |
| |
| inputHandler = app.struts.MyInputHandler |
| |
| and then referred to as the value for an attribute: |
| |
| handler = ${inputHandler} |
| |
| The following attribute is defined: |
| |
| resource The path to the properties file, relative to the Struts |
| Configuration file being processed. |
| --> |
| <!ELEMENT property> |
| <!ATTLIST property id ID #IMPLIED> |
| <!ATTLIST property resource %Resource; #REQUIRED> |
| |
| |
| <!-- The <catalog> element refers to the location of a Catalog file, |
| relative to the Struts configuration file, that contains a registry |
| of Command Chains that can be referred to in the "command" attributes |
| of other elements. |
| |
| The following attribute is defined: |
| |
| resource The path to the Catalog file, relative to the Struts |
| Configuration file being processed. |
| --> |
| <!ELEMENT property> |
| <!ATTLIST property id ID #IMPLIED> |
| <!ATTLIST property resource %Resource; #REQUIRED> |
| |
| |
| <!-- The <inputs> element describes the set of input descriptors. |
| The following attribute is defined: |
| |
| config Fully qualified Java class to use when instantiating |
| Input objects. If specified, the object must implement |
| org.apache.struts.core.Input. |
| ["org.apache.struts.core.InputBase"] |
| |
| handler Fully qualified Java class to use when instantiating |
| InputHandler objects. If specified, the object must implement |
| org.apache.struts.core.InputHandler. |
| ["org.apache.struts.core.DynaInputHandlerBase"] |
| --> |
| <!ELEMENT inputs (input*)> |
| <!ATTLIST inputs id ID #IMPLIED> |
| <!ATTLIST inputs config %ClassName; #IMPLIED> |
| <!ATTLIST inputs handler %ClassName; #IMPLIED> |
| |
| |
| <!-- The <input> element describes an InputHandler (org.apache.struts.core.InputHandler) |
| instance that can be referenced by a Mapping instance. |
| |
| name The unique identifier for this input descriptor. |
| Referenced by the "input" attribute of the <mapping> element |
| to specify which input handler to use with a matching request. May also |
| be referenced by an "extends" attribute in another <input> element. |
| |
| extends Name of an input descriptor that is used as a value template for |
| this element. All attributes from the template are available to |
| the new element. Any attribute inherited from the template can |
| be overloaded by providing a new value. |
| |
| config Fully qualified class name of the Input class to use with |
| this input that implements org.apache.struts.core.Input. |
| ["org.apache.struts.core.InputBase"] |
| |
| handler Fully qualified class name of the InputHandler class to use with |
| this input that implements org.apache.struts.core.InputHandler. |
| ["org.apache.struts.core.DynaInputHandlerBase"] |
| |
| --> |
| <!ELEMENT input (icon?, display-name?, description?, set-property*, input-property*)> |
| <!ATTLIST input id ID #IMPLIED> |
| <!ATTLIST input name CDATA #REQUIRED> |
| <!ATTLIST input extends CDATA #IMPLIED> |
| <!ATTLIST input config %ClassName; #IMPLIED> |
| <!ATTLIST input handler %ClassName; #REQUIRED> |
| |
| |
| <!-- The <input-property> element describes an object property that can be used to |
| configure an instance of a DynaInputHandler. This element is only utilized when the |
| "handler" attribute of the enclosing <input> element implements |
| org.apache.struts.core.DynaInputHandler. |
| |
| name The name of the object property described by this element. |
| |
| extends Name of an input descriptor that is used as a value template for |
| this element. All attributes from the template are available to |
| the new element. Any attribute inherited from the template can |
| be overloaded by providing a new value. |
| |
| config Fully qualified Java class to use when instantiating |
| DynaInputProperty objects. If specified, the object must implement |
| org.apache.struts.core.DynaInputProperty. |
| ["org.apache.struts.core.DynaInputPropertyBase"] |
| |
| handler Fully qualified class name of the field that will handle this |
| property, optionally followed by "[]" to indicate that the |
| field is indexed. |
| |
| initial String representation of the initial value for this property. |
| If not specified, primitives will be initialized to zero and |
| objects initialized to the zero-argument instantiation of that |
| object class. For example, Strings will be initialized to "" |
| |
| size The number of array elements to create if the value of the |
| "handler" attribute specifies an array, but there is no value |
| specified for the "initial" attribute. |
| --> |
| <!ELEMENT input-property (set-property*)> |
| <!ATTLIST input-property name CDATA #REQUIRED> |
| <!ATTLIST input-property extends CDATA #IMPLIED> |
| <!ATTLIST input-property config %ClassName; #IMPLIED> |
| <!ATTLIST input-property handler %ClassName; #REQUIRED> |
| <!ATTLIST input-property initial CDATA #IMPLIED> |
| <!ATTLIST input-property size %Integer; #IMPLIED> |
| |
| |
| <!-- The <locations> element describes a set of Location objects |
| (org.apache.struts.core.Location) that may be referenced by other elements |
| and returned by an MappingHandler's execute method. The individual Locations |
| are configured through nested <location> elements. Other elements, such |
| as <exception> and <mapping>, may also provide nested locations specific |
| to that element (local scope). The following attribute is defined: |
| |
| handler Fully qualified Java class to use when instantiating |
| Location objects. If specified, the object must implement |
| org.apache.struts.core.Location. |
| ["org.apache.struts.core.LocationBase"] |
| --> |
| <!ELEMENT locations (location*)> |
| <!ATTLIST locations id ID #IMPLIED> |
| <!ATTLIST locations className %ClassName; #IMPLIED> |
| |
| |
| <!-- The <location> element is referenced by |
| a logical name and encapsulates a URI or a reference to a mapping. A |
| "location" element may be used to describe both global and local locations. |
| Global locations are available to all the elements. Local locations can be |
| nested within an <exception> or <mapping> element and only available when it |
| is invoked in that context. |
| |
| name The unique identifier for this location. Referenced by |
| other elements and by the MappingHandler object at runtime |
| to select - by its logical name - the resource that should |
| complete the request/response. May also be referenced by |
| an "extends" attribute of another <location> element. |
| |
| extends Name of a location descriptor that is used as a value template for |
| this element. All attributes from the template are available to |
| the new element. Any attribute inherited from the template can |
| be overridden by providing a new value. |
| |
| command Name of a Command to execute before dispatching control to |
| the resource for this element. The Command can be used to |
| prepare the contexts for the resource. |
| |
| resource The module-relative or context-relative path to the resource |
| that is encapsulated by the logical name of this Location. |
| If the path is to be considered relative to the root application |
| context when used in a modular application, then the "appRelative" |
| attribute should be set to "true". This value should begin with |
| a slash ("/") character. |
| |
| mappingRef Set to "true" if the path specified for "resource" is a reference |
| to a Mapping. If "true", calling "getResource" will return a URI to |
| the Mapping with the appropriate prefix or extension resolved. |
| ["false"] |
| |
| appRelative Set to "true" if, in a modular application, the resource |
| attribute starts with a slash "/" and should be considered |
| relative to the application root rather than the current module. |
| ["false"] |
| |
| merge Set to "true" if the resource path should be scanned for replacement |
| parameters: {[scope:]xyz}. Replacement parameters must begin |
| with a letter. If a scope is not specified, all scopes are |
| checked in turn (request, session, application). |
| |
| type May be set to "forward", "include", or "redirect" to indicate |
| what approach is to be taken to render response. |
| ["forward"] |
| --> |
| <!ELEMENT location (icon?, display-name?, description?, set-property*)> |
| <!ATTLIST location id ID #IMPLIED> |
| <!ATTLIST location name CDATA #IMPLIED> |
| <!ATTLIST location extends CDATA #IMPLIED> |
| <!ATTLIST location command CDATA #IMPLIED> |
| <!ATTLIST location resource %RequestPath; #REQUIRED> |
| <!ATTLIST location mappingRef %Boolean; #IMPLIED> |
| <!ATTLIST location appRelative %Boolean; #IMPLIED> |
| <!ATTLIST location merge %Boolean; #IMPLIED> |
| <!ATTLIST location redirect %Boolean; #IMPLIED> |
| <!ATTLIST location type %LocationType; #IMPLIED> |
| |
| |
| <!-- The <exceptions> element describes a set of exceptions that might be |
| thrown by an MappingHandler object. The handling of individual exception |
| classes can be configured through nested exception elements. |
| If a <mapping> element registers a local exception handler for the same |
| exception type, the local handler overrides the global exception handler. |
| The following attribute is defined: |
| |
| handler Fully qualified Java class to use when instantiating |
| ExceptionConfig objects. If specified, the object must implement |
| org.apache.struts.core.ExceptionConfig. |
| --> |
| <!ELEMENT exceptions (exception*)> |
| <!ATTLIST exceptions id ID #IMPLIED> |
| |
| |
| <!-- The <exception> element registers an ExceptionHandler |
| (org.apache.struts.core.ExceptionHandler) for an exception class. |
| The following attributes are defined: |
| |
| name A unique identifier for this <exception> element so that it |
| can be referenced by an "extends" attribute. |
| |
| extends Name of an <exception> element that is used as a value template |
| for this element. All attributes from the template are available |
| to the new element. Any attribute inherited from the template |
| can be overridden by providing a new value. |
| |
| config Fully qualified class name to use when instantiating |
| ExceptionConfig objects. If specified, the object must implement |
| org.apache.struts.core.ExceptionConfig. |
| ["org.apache.struts.core.ExceptionConfigBase"] |
| |
| handler Fully qualified class name of the exception handler to use |
| with this exception. |
| ["org.apache.struts.core.ExceptionHandlerBase"] |
| |
| location The name of the <location> element (local or global) that will |
| complete the request/response if the Exception specified by the |
| "trigger" attribute is thrown. |
| |
| scope The scope ("request" or "session") that is used to access |
| the Message object (org.apache.struts.core.Message) |
| for this exception. |
| |
| bundleName Attribute name for the message bundle associated with this |
| handler. [org.apache.struts.core.Keys.BUNDLE_KEY] |
| |
| key The key to use with this handler's message bundle |
| that will retrieve the message template to use with this |
| exception. |
| |
| trigger Fully qualified class name of the Exception class to |
| register with this handler. |
| --> |
| <!ELEMENT exception (icon?, display-name?, description?, set-property*, location*)> |
| <!ATTLIST exception id ID #IMPLIED> |
| <!ATTLIST exception name CDATA #IMPLIED> |
| <!ATTLIST exception extends CDATA #IMPLIED> |
| <!ATTLIST exception config %ClassName; #IMPLIED> |
| <!ATTLIST exception handler %ClassName; #IMPLIED> |
| <!ATTLIST exception location CDATA #IMPLIED> |
| <!ATTLIST exception scope %Scope; #IMPLIED> |
| <!ATTLIST exception bundleName %AttributeName; #IMPLIED> |
| <!ATTLIST exception key CDATA #REQUIRED> |
| <!ATTLIST exception trigger %ClassName; #REQUIRED> |
| |
| |
| <!-- The <processors> element describes a set of Processor objects |
| (org.apache.struts.core.Processor) that are available to process |
| requests. The individual Processors are configured through nested |
| <processor> elements. The following attributes are defined: |
| |
| config Fully qualified class name to use when instantiating |
| Processor objects. If specified, the object must implement |
| org.apache.struts.core.Processor. |
| ["org.apache.struts.core.ProcessorBase"] |
| --> |
| <!ELEMENT processors (processor*)> |
| <!ATTLIST processors id ID #IMPLIED> |
| <!ATTLIST processors config %ClassName; #IMPLIED> |
| |
| |
| <!-- The <processor> element describes the a Processor object |
| [org.apache.struts.core.Processor] that is used to manage a |
| request/response event. Each <mapping> element can specify |
| its own Processor object, if needed. The following attributes |
| are defined: |
| |
| name A unique identifier for this <processor> element so that it |
| can be referenced by an "extends" attribute. |
| |
| extends Name of a <processor> element that is used as a value template |
| for this element. All attributes from the template are available |
| to the new element. Any attribute inherited from the template |
| can be overridden by providing a new value. |
| |
| config Fully qualified class name to use when instantiating |
| Processor objects. If specified, the object must implement |
| org.apache.struts.core.Processor. |
| ["org.apache.struts.core.ProcessorBase"] |
| |
| handler The fully qualified class name of the |
| RequestHandler subclass to be used with this module. |
| ["org.apache.struts.core.RequestHandler"] |
| |
| locale Set to "false" if you do not want a Locale object stored in the |
| user's session. |
| ["true"] |
| |
| pathPattern Replacement pattern defining how the "resource" attribute of a |
| <location> element is mapped to a context-relative URL when |
| it starts with a slash (and when the appRelative |
| property is false). This value may consist of any |
| combination of the following: |
| - "$M" - Replaced by the module prefix of this module |
| - "$R" - Replaced by the "resource" attribute of the |
| selected "location" element |
| - "$P" - Same as "$R". |
| - "$$" - Causes a literal dollar sign to be rendered |
| - "$x" - (Where "x" is any character not defined above) |
| Silently swallowed, reserved for future use |
| ["$M$R"] |
| |
| pagePattern Replacement pattern defining how the "page" attribute of |
| custom tags using it is mapped to a context-relative URL |
| of the corresponding resource. This value may consist of |
| any combination of the following: |
| - "$M" - Replaced by the module prefix of this module |
| - "$P" - Replaced by the value of the "page" attribute |
| - "$$" - Causes a literal dollar sign to be rendered |
| - "$x" - (Where "x" is any character not defined above) |
| Silently swallowed, reserved for future use |
| ["$M$P"] |
| |
| contentType Default content type (and optional character encoding) to |
| be set on each response. May be overridden by the Action, |
| server page, or other resource to which the request is forwarded. |
| ["text/html"] |
| |
| nocache Set to "true" if you want the controller to add HTTP |
| headers for defeating caching to every response from |
| this module. |
| ["false"] |
| |
| bufferSize The size of the input buffer used when processing |
| file uploads. |
| ["4096"] |
| |
| maxFileSize The maximum size (in bytes) of a file to be accepted as a |
| file upload. Can be expressed as a number followed by a |
| "K", "M", or "G", which are interpreted to mean kilobytes, |
| megabytes, or gigabytes, respectively. |
| ["250M"] |
| |
| memFileSize The maximum size (in bytes) of a file whose contents will |
| be retained in memory after uploading. Files larger than |
| this threshold will be written to some alternative storage |
| medium, typically a hard disk. Can be expressed as a number |
| followed by a "K", "M", or "G", which are interpreted to |
| mean kilobytes, megabytes, or gigabytes, respectively. |
| ["256K"] |
| |
| multipartClass The fully qualified Java class name of the multipart |
| request handler class to be used with this module. |
| ["org.apache.struts.upload.CommonsMultipartRequestHandler"] |
| |
| tempDir Temporary working directory to use when processing |
| file uploads. |
| [{Directory provided by servlet container}] |
| --> |
| <!ELEMENT processor (set-property*)> |
| <!ATTLIST processor id ID #IMPLIED> |
| <!ATTLIST processor name CDATA #IMPLIED> |
| <!ATTLIST processor extends CDATA #IMPLIED> |
| <!ATTLIST processor config %ClassName; #IMPLIED> |
| <!ATTLIST processor handler %ClassName; #IMPLIED> |
| <!ATTLIST processor locale %Boolean; #IMPLIED> |
| <!ATTLIST processor pathPattern CDATA #IMPLIED> |
| <!ATTLIST processor pagePattern CDATA #IMPLIED> |
| <!ATTLIST processor contentType CDATA #IMPLIED> |
| <!ATTLIST processor nocache %Boolean; #IMPLIED> |
| <!ATTLIST processor bufferSize %Integer; #IMPLIED> |
| <!ATTLIST processor maxFileSize CDATA #IMPLIED> |
| <!ATTLIST processor memFileSize CDATA #IMPLIED> |
| <!ATTLIST processor multipartClass %ClassName; #IMPLIED> |
| <!ATTLIST processor tempDir CDATA #IMPLIED> |
| |
| |
| <!-- The <mappings> element describes a set of Mapping objects |
| (org.apache.struts.core.Mapping) that are available to process |
| requests. The individual Mappings are configured through nested |
| <mapping> elements. The following attributes are defined: |
| |
| config Fully qualified class name to use when instantiating |
| Mapping objects. If specified, the object must implement |
| org.apache.struts.core.Mapping. |
| ["org.apache.struts.core.MappingBase"] |
| --> |
| <!ELEMENT mappings (action*)> |
| <!ATTLIST mappings id ID #IMPLIED> |
| <!ATTLIST mappings config %ClassName; #IMPLIED> |
| |
| |
| <!-- The <mapping> element describes an Mapping object that is to be used |
| to process a request. The following attributes are defined: |
| |
| name A unique identifier for this exception element so that it |
| can be referenced by an "extends" attribute. (This is *not* |
| a reference to an <input> element!) |
| |
| extends Name of an <mapping> element that is used as a value template |
| for this element. All attributes from the template are available |
| to the new element. Any attribute inherited from the template |
| can be overridden by providing a new value. |
| |
| config The fully qualified class name of the Mapping object to use |
| with this instance. Defaults to the type specified by the |
| enclosing <mappings> element or to |
| "org.apache.struts.core.MappingBase" if not specified. |
| ["org.apache.struts.core.MappingBase"] |
| |
| command Name of a Command to execute in order to process this |
| request. The Command is passed a StrutsContext object wrapping |
| the request. If the Command returns "false", the Location |
| object is processed to complete the response. |
| (org.apache.struts.action.Action now implements Command |
| and provides default behavior for backward compatibility.) |
| |
| location The default location to set in the Context for this Mapping. |
| If not changed by a Command, this Location will be used to render |
| the reponse. |
| [null] |
| |
| matches The path to match against the submitted request, |
| starting with a "/" character, and without the filename extension |
| if extension mapping is used. |
| |
| NOTE: Do *not* include a period in your path name, |
| because it will look like a filename extension and |
| may cause your Mapping not to found. |
| |
| processor Name of a Processor object to use when handling this request. |
| If not specified, the "unnamed" processor is used. |
| |
| default Set to "true" if this object should be configured as the |
| default mapping. If a request does not match another mapping, |
| it will be passed to the Mapping object with default set to |
| "true". Only one Mapping can be marked as "default" within a |
| module. |
| [false] |
| |
| secure whether to force secure access to this mapping (via SSL). |
| |
| roles Comma-delimited list of security role names that are allowed |
| access to this Mapping object. |
| |
| parameter General-purpose configuration parameter that can be used to |
| pass extra information to the Command object selected by |
| this mapping. |
| |
| attribute Name of the request-scope or session-scope attribute that |
| is used to access our InputHandler object, if it is other than |
| the object's default "input". Optional if "input" is specified, |
| else not valid. |
| |
| input Name of the input descriptor, if any, to use with this mapping. |
| (This is *not* the dispatch Location if validate fails.) |
| |
| scope The scope ("request" or "session") that is used to |
| access our InputHandler, if any. Optional if <input> is |
| specified, else not valid. |
| |
| populate Set to "false" if the populate method of the InputHandler |
| should not be called prior to calling the MappingHandler for |
| this request. If "false", the reset method is also bypassed. |
| [true] |
| |
| validate Set to "false" if the validate method of the InputHandler |
| should not be called prior to calling the MappingHandler for |
| this request. |
| [true] |
| |
| onInvalid Name of a local or global Location that should handle the |
| response if a validation message is generated. |
| Valid only when "input" is specified. |
| Required if "input" is specified and the InputHandler returns |
| validation messages. |
| Optional if "input" is specified and the |
| InputHandler does not return validation messages. |
| |
| onCancel Name of a local or global Location that should handle the |
| response if "cancel" is signaled in the request. |
| --> |
| <!ELEMENT mapping (icon?, display-name?, description?, set-property*, exception*, location*)> |
| <!ATTLIST mapping id ID #IMPLIED> |
| <!ATTLIST mapping name CDATA #IMPLIED> |
| <!ATTLIST mapping extends CDATA #IMPLIED> |
| <!ATTLIST mapping config %ClassName; #IMPLIED> |
| <!ATTLIST mapping command CDATA #IMPLIED> |
| <!ATTLIST mapping forward %RequestPath; #IMPLIED> |
| <!ATTLIST mapping include %RequestPath; #IMPLIED> |
| <!ATTLIST mapping matches %RequestPath; #REQUIRED> |
| <!ATTLIST mapping processor CDATA #IMPLIED> |
| <!ATTLIST mapping default %Boolean; #IMPLIED> |
| <!ATTLIST mapping secure %Boolean; #IMPLIED> |
| <!ATTLIST mapping roles CDATA #IMPLIED> |
| <!ATTLIST mapping parameter CDATA #IMPLIED> |
| <!ATTLIST mapping attribute %PropName; #IMPLIED> |
| <!ATTLIST mapping input CDATA; #IMPLIED> |
| <!ATTLIST mapping scope %Scope; #IMPLIED> |
| <!ATTLIST mapping populate %Boolean; #IMPLIED> |
| <!ATTLIST mapping validate %Boolean; #IMPLIED> |
| <!ATTLIST mapping onInvalid CDATA #IMPLIED> |
| <!ATTLIST mapping onCancel CDATA #IMPLIED> |
| |
| |
| <!-- The <bundles> element describes a set of Bundle objects |
| (org.apache.struts.core.MessageBundle) that are available to provide |
| message bundles. The individual Bundles are configured through nested |
| <bundle> elements. The following attributes are defined: |
| |
| config Fully qualified class name to use when instantiating |
| Bundle objects. If specified, the object must implement |
| org.apache.struts.core.MessageBundle. |
| ["org.apache.struts.core.MessageBundleBase"] |
| --> |
| <!ELEMENT bundles (processor*)> |
| <!ATTLIST bundles id ID #IMPLIED> |
| <!ATTLIST bundles config %ClassName; #IMPLIED> |
| |
| |
| <!-- The <bundle> element describes a MessageBundle object with |
| message templates for this module. The following attributes are defined: |
| |
| name A unique identifier for this bundle element so that it |
| can be referenced by an "extends" attribute. |
| |
| extends Name of an <bundle> element that is used as a value template |
| for this element. All attributes from the template are available |
| to the new element. Any attribute inherited from the template |
| can be overridden by providing a new value. |
| |
| config The fully qualified class name of the MessageBundle object to use |
| with this instance. Defaults to the type specified by the |
| enclosing <bundles> element or to |
| "org.apache.struts.core.MessageBundleBase" if not specified. |
| ["org.apache.struts.core.MappingBase"] |
| |
| factory Fully qualified Java class name of the |
| MessageBundleFactory subclass to use for this message |
| bundle object. |
| ["org.apache.struts.util.PropertyMessageBundleFactory"] |
| |
| key Servlet context attribute under which this message |
| bundle will be stored. The default attribute is |
| the value specified by the string constant at |
| [Keys.BUNDLE_KEY]. The application module prefix (if |
| any) is appended to the key (${key}${prefix}). |
| [org.apache.struts.core.Keys.BUNDLE_KEY] |
| |
| NOTE: The application module prefix includes the leading |
| slash, so the default message resource bundle for a module |
| named "foo" is stored under |
| "org.apache.struts.core.BUNDLE/foo". |
| |
| null Set to "true" if you want this message bundle to return a |
| null string for unknown message keys, or "false" to return a |
| message with the bad key value. |
| |
| parameter Configuration parameter to be passed to the createBundle |
| method of our factory object. |
| --> |
| <!ELEMENT bundle (set-property*)> |
| <!ATTLIST bundle id ID #IMPLIED> |
| <!ATTLIST bundle handler %ClassName; #IMPLIED> |
| <!ATTLIST bundle factory %ClassName; #IMPLIED> |
| <!ATTLIST bundle key %AttributeName; #IMPLIED> |
| <!ATTLIST bundle null %Boolean; #IMPLIED> |
| <!ATTLIST bundle parameter CDATA #REQUIRED> |
| |
| |
| <!-- The <plug-in> element specifies the fully qualified class name of a |
| general-purpose application plug-in component that receives notification of |
| application startup and shutdown events. An instance of the specified class |
| is created for each element, and can be configured with nested <set-property> |
| elements. The following attributes are supported: |
| |
| handler Fully qualified Java class name of the plug-in class; must |
| implement [org.apache.struts.action.PlugIn]. |
| --> |
| <!ELEMENT plug-in (set-property*)> |
| <!ATTLIST plug-in id ID #IMPLIED> |
| <!ATTLIST plug-in handler %ClassName; #REQUIRED> |
| |
| |
| <!-- ========== Subordinate Elements ====================================== --> |
| |
| |
| <!-- The "description" element contains descriptive (paragraph length) text |
| about the surrounding element, suitable for use in GUI tools. |
| --> |
| <!ELEMENT description (#PCDATA)> |
| <!ATTLIST description id ID #IMPLIED> |
| |
| |
| <!-- The "display-name" element contains a short (one line) description of |
| the surrounding element, suitable for use in GUI tools. |
| --> |
| <!ELEMENT display-name (#PCDATA)> |
| <!ATTLIST display-name id ID #IMPLIED> |
| |
| |
| <!-- The "icon" element contains a small-icon and large-icon element which |
| specify the location, relative to the Struts configuration file, for small |
| and large images used to represent the surrounding element in GUI tools. |
| --> |
| <!ELEMENT icon (small-icon?, large-icon?)> |
| <!ATTLIST icon id ID #IMPLIED> |
| |
| |
| <!-- The "large-icon" element specifies the location, relative to the Struts |
| configuration file, of a resource containing a large (32x32 pixel) |
| icon image. |
| --> |
| <!ELEMENT large-icon (%Location;)> |
| <!ATTLIST large-icon id ID #IMPLIED> |
| |
| |
| <!-- The "set-property" element specifies the method name and initial value of |
| an additional JavaBean configuration property. When the object representing |
| the surrounding element is instantiated, the accessor for the indicated |
| property is called and passed the indicated value. The "set-property" |
| element is especially useful when a custom subclass is used with |
| <location>, <mapping>, or <plug-in> elements. The subclass |
| can be passed whatever other properties may be required to configure the |
| object without changing how the struts-config is parsed. |
| |
| property Name of the JavaBeans property whose setter method |
| will be called. |
| |
| value String representation of the value to which this |
| property will be set, after suitable type conversion |
| --> |
| <!ELEMENT set-property EMPTY> |
| <!ATTLIST set-property id ID #IMPLIED> |
| <!ATTLIST set-property property %PropName; #REQUIRED> |
| <!ATTLIST set-property value CDATA #REQUIRED> |
| |
| |
| <!-- The "small-icon" element specifies the location, relative to the Struts |
| configuration file, of a resource containing a small (16x16 pixel) |
| icon image. |
| --> |
| <!ELEMENT small-icon (%Location;)> |
| <!ATTLIST small-icon id ID #IMPLIED> |
| |