1. Added a title to section 7.1
2. Fixed a spelling error in section 7.2
3. Copied the parameter docs for controller element from config DTD.
Documenting possible paremeters is more consistent with sections 7.3.1
and 7.2.2
--------
Tim O'Brien
Transolutions, Inc.
W 847-574-2143
M 847-863-7045
> -----Original Message-----
> From: Craig R. McClanahan [mailto:[EMAIL PROTECTED]]
> Sent: Monday, December 02, 2002 10:45 AM
> To: Struts Developers List
> Subject: Re: Using a property of type Map in a DynaActionForm
>
>
>
>
> On Sun, 1 Dec 2002, Martin Cooper wrote:
>
> > Date: Sun, 1 Dec 2002 22:18:05 -0800 (PST)
> > From: Martin Cooper <[EMAIL PROTECTED]>
> > Reply-To: Struts Developers List <[EMAIL PROTECTED]>
> > To: [EMAIL PROTECTED]
> > Subject: Using a property of type Map in a DynaActionForm
> >
> > As far as I can determine, it is not possible to create a
> > DynaActionForm which has a property of type Map. It is also not
> > possible to extend it to be able to accept a property of type Map.
> > This seems like an unfortunate omission, so I'd like to fix
> it. First,
> > though, I'd like to get some feedback on whether there is a reason
> > it's not currently supported, and on the best way of resolving it.
> >
>
> It's *supposed* to work if you declare the property type to
> be java.util.Map instead of a concrete implementation of Map.
> You'll still need to create your own Map instance at the
> moment -- I do mine in a custom reset() method, but we
> probably also need a better solution based on an initial expression.
>
> Craig
>
>
> --
> To unsubscribe, e-mail:
> <mailto:struts-dev-> [EMAIL PROTECTED]>
> For
> additional commands,
> e-mail: <mailto:[EMAIL PROTECTED]>
>
Index: configuration.xml
===================================================================
RCS file: /home/cvspublic/jakarta-struts/doc/userGuide/configuration.xml,v
retrieving revision 1.1
diff -u -r1.1 configuration.xml
--- configuration.xml 2 Dec 2002 13:09:07 -0000 1.1
+++ configuration.xml 5 Dec 2002 01:58:20 -0000
@@ -12,12 +12,13 @@
<author>Eddie Bush</author>
<author>Yann Cebron</author>
<author>David Graham</author>
+ <author>Tim O'Brien</author>
</properties>
<body>
<chapter name="7. Configuring Applications" href="config_apps">
- <section name="7.1">
+ <section name="7.1 Overview" href="config-overview">
<p>
[:TODO:]
@@ -30,7 +31,7 @@
<p>
The <a href="building_controller.html#config">Building Controller
Components</a> chapter covered writing the form-bean and action-mapping
- portions of the Stgruts configuration file.
+ portions of the Struts configuration file.
These elements usually play an important role in the development of a
Struts application.
The other elements in Struts configuration file tend to be static:
@@ -52,8 +53,155 @@
The <controller> element allows you to configure the ActionServlet.
Many of the controller parameters were previously defined by servlet init.
parameters in your web.xml file but have been moved to this section of
struts-config.xml.
For full details on available parameters see the
- <a
href="http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd";>struts-config_1_1.dtd</a>.
+ <a
+href="http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd";>struts-config_1_1.dtd</a>
+ or the list below:
</p>
+
+ <blockquote>
+ <ul>
+ <li>
+ <b>className</b> -
+ Classname of configuration bean.
+ [org.apache.struts.config.MessageResourcesConfig] (optional)
+ </li>
+ <li>
+ <b>bufferSize</b> -
+ The size (bytes) of the input buffer used when processing file uploads.
+ Default: 4096
+ </li>
+ <li>
+ <b>className</b> -
+ Fully qualified Java class name of the
+ ControllerConfig subclass for this controller object.
+ If specified, the object must be a subclass of the
+ default class.
+ Default: "org.apache.struts.config.ControllerConfig"
+ </li>
+ <li>
+ <b>contentType</b> -
+ Default content type (and optional character encoding) to
+ be set on each response. May be overridden by the Action,
+ JSP, or other resource to which the request is forwarded.
+ Default: "text/html"
+ </li>
+ <li>
+ <b>debug</b> -
+ Debugging detail level for this module.
+ Default: 0
+ </li>
+ <li>
+ <b>forwardPattern</b> -
+ Replacement pattern defining how the "path" attribute of a
+ <forward> element is mapped to a context-relative URL when
+ it starts with a slash (and when the contextRelative
+ property is false). This value may consist of any
+ combination of the following:
+
+ <ul>
+ <li>
+ <b>"$A"</b> -
+ Replaced by the app prefix of this module
+ </li>
+ <li>
+ <b>"$P"</b> -
+ Replaced by the "path" attribute of the selected
+ "forward" element
+ </li>
+ <li>
+ <b>"$$"</b> -
+ Causes a literal dollar sign to be rendered
+ </li>
+ <li>
+ <b>"$x"</b> -
+ (Where "x" is any character not defined above)
+ Silently swallowed, reserved for future use
+ </li>
+ </ul>
+
+ Default: If not specified, the default forwardPattern is "$A$P",
+ which is consistent with the previous behavior of forwards.
+ </li>
+ <li>
+ <b>inputForward</b> -
+ Set to "true" if you want the "input" attribute of <action>
+ elements to be the name of a local or global ActionForward,
+ which will then be used to calculate the ultimate URL. Set
+ to "false" (the default) to treat the "input" parameter of
+ <action> elements as a module-relative path to the resource
+ to be used as the input form. Since Struts 1.1.
+ Default: false
+ </li>
+ <li>
+ <b>locale</b> -
+ Set to "true" if you want a Locale object stored in the
+ user agent's session if not already present.
+ Default: true
+ </li>
+ <li>
+ <b>maxFileSize</b> -
+ 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.
+ Default: "250M"
+ </li>
+ <li>
+ <b>multipartClass</b> -
+ The fully qualified Java class name of the multipart request
+ handler class to be used with this module.
+ Default: "org.apache.struts.upload.CommonsMultipartRequestHandler"
+ </li>
+ <li>
+ <b>nocache</b> -
+ Set to "true" if you want the controller to add HTTP headers
+ for defeating caching to every response from this module.
+ Default: false
+ </li>
+ <li>
+ <b>pagePattern</b> -
+ 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:
+
+ <ul>
+ <li>
+ <b>"$A"</b> -
+ Replaced by the app prefix of this subapp
+ </li>
+ <li>
+ <b>"$P"</b> -
+ Replaced by the value of the "page" attribute
+ </li>
+ <li>
+ <b>"$$"</b> -
+ Causes a literal dollar sign to be rendered
+ </li>
+ <li>
+ <b>"$x"</b> -
+ (Where "x" is any character not defined above)
+ Silently swallowed, reserved for future use
+ </li>
+ </ul>
+
+ Default: If not specified, the default forwardPattern is
+ "$A$P", which is consistent with previous hard coded
+ behavior of URL evaluation for "page" attributes.
+ </li>
+ <li>
+ <b>processorClass</b> -
+ The fully qualified Java class name of the
+ RequestProcessor subclass to be used with this module.
+ Default: "org.apache.struts.action.RequestProcessor"
+ </li>
+ <li>
+ <b>tempDir</b> -
+ Temporary working directory to use when processing
+ file uploads.
+ Default: {Directory provided by servlet container}
+ </li>
+ </ul>
+ </blockquote>
+
<p>
This example uses the default values for several controller parameters.
If you only want default behavior you can omit the controller section
altogether.
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
