husted 2003/12/11 19:20:53
Modified: doc project.xml status.xml
doc/userGuide building_controller.xml configuration.xml
installation.xml introduction.xml release-notes.xml
Log:
Minor tweaks.
Revision Changes Path
1.44 +0 -4 jakarta-struts/doc/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/project.xml,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- project.xml 28 Nov 2003 17:30:01 -0000 1.43
+++ project.xml 12 Dec 2003 03:20:53 -0000 1.44
@@ -81,14 +81,10 @@
</menu>
<menu name="Development">
- <item name="CVS Access" href="reports/cvs-usage.html"/>
<item
name="CVS Repository"
href="http://cvs.apache.org/viewcvs/jakarta-struts/";
/>
- <item name="CVS Changelog" href="reports/changelog-report.html"/>
- <item name="File Activity" href="reports/file-activity-report.html"/>
- <item name="Build Dependencies" href="reports/dependencies.html"/>
<item
name="Release Guidelines"
href="releases.html"
1.53 +2 -2 jakarta-struts/doc/status.xml
Index: status.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/status.xml,v
retrieving revision 1.52
retrieving revision 1.53
diff -u -r1.52 -r1.53
--- status.xml 10 Dec 2003 01:03:33 -0000 1.52
+++ status.xml 12 Dec 2003 03:20:53 -0000 1.53
@@ -481,7 +481,7 @@
</section>
<section>
- <p class="version">Website updated from CVS: 2003 NOV 26 by husted.</p>
+ <p class="version">Website updated from CVS: 2003 DEC 11 by husted.</p>
<p class="version">Javadocs updated from CVS: 2003 NOV 26 by husted.</p>
</section>
1.73 +8 -8 jakarta-struts/doc/userGuide/building_controller.xml
Index: building_controller.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/building_controller.xml,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -r1.72 -r1.73
--- building_controller.xml 11 Dec 2003 20:38:12 -0000 1.72
+++ building_controller.xml 12 Dec 2003 03:20:53 -0000 1.73
@@ -38,8 +38,8 @@
<li>
Write an <code>ActionForm</code> class to mediate between the Model
- and the View, as described in <a href="building_model.html">Building
- Model Components</a>.
+ and the View. (See also <a href="../faqs/actionForm.html">Building
+ an ActionForm</a>).
</li>
<li>
@@ -110,11 +110,12 @@
</ul>
<p>
- The Struts controller delegates most of this grunt work to Action classes.
+ The Struts controller delegates most of this grunt work to the
+ <a href="#request_processor">Request Processor</a> and Action classes.
</p>
<p>
- In addition to being the controller for your application, the
+ In addition to being the front controller for your application, the
ActionServlet instance also is responsible for initialization and
clean-up of resources.
When the controller initializes, it first loads the application config
@@ -354,10 +355,9 @@
If you override a "stub" method, and provide error messages in the
standard application resource, Struts will automatically validate the
input from the form (using your method).
- See "<a href="./building_view.html#form_validation">
- Action Form Validation</a>" for details.
- Of course, you can also ignore the ActionForm validation and provide your
- own in the Action object.
+ See "<a href="./building_view.html#form_validation">Automatic Form
+ Validation</a>" for details. Of course, you can also ignore the
+ ActionForm validation and provide your own in the Action object.
</li>
<li>
1.29 +2 -178 jakarta-struts/doc/userGuide/configuration.xml
Index: configuration.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/configuration.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- configuration.xml 17 Sep 2003 18:54:25 -0000 1.28
+++ configuration.xml 12 Dec 2003 03:20:53 -0000 1.29
@@ -78,8 +78,8 @@
moved to this section of <code>struts-config.xml</code> in order to allow
different modules in the same web application to be configured differently.
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> or the list below.
+ <a href="http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd";>
+ struts-config_1_2.dtd</a> or the list below.
</p>
@@ -662,7 +662,6 @@
<strong>WARNING</strong> - If you define
an object of the same name in more than one configuration file,
the last one loaded quietly wins.
-
</li>
<li>
@@ -698,181 +697,6 @@
</li>
</ul>
-
-
- <p>
- The following parameters may still be used with the Struts 1.1 release
- but are <strong>deprecated</strong>.
- </p>
-
- <ul>
-
- <li>
- <strong>application</strong> - Java class name of the application
- resources bundle base class.
- [NONE]
- <em>DEPRECATED - Configure this using the "parameter" attribute
- of the <message-resources> element.</em>
- </li>
-
- <li><strong>bufferSize</strong> - The size of the input buffer used
- when processing file uploads.
- [4096]
- <em>DEPRECATED - Configure this using the "bufferSize" attribute
- of the <controller> element.</em>
- </li>
-
- <li>
- <strong>content</strong> - Default content type and character encoding
- to be set on each response; may be overridden by a forwarded-to
- servlet or JSP page.
- [text/html]
- <em>DEPRECATED - Configure this using the "contentType" attribute
- of the <controller> element.</em>
- </li>
-
- <li>
- <strong>debug</strong> - The debugging detail level that controls
- how much information is logged for this servlet.
- Accepts values 0 (off) and from 1 (least serious) through 6
- (most serious). [0]
- <em>DEPRECATED - Configure the logging detail level in your
- underlying logging implementation.</em>
- </li>
-
- <li>
- <strong>factory</strong> - The Java class name of the
- <code>MessageResourcesFactory</code> used to create the application
- <code>MessageResources</code> object.
- [org.apache.struts.util.PropertyMessageResourcesFactory]
- <em>DEPRECATED - Configure this using the "factory" attribute
- of the <message-resources> element.</em>
- </li>
-
- <li>
- <strong>formBean</strong> - The Java class name of the ActionFormBean
- implementation to use
- [org.apache.struts.action.ActionFormBean].
- <em>DEPRECATED - Configure this using the "className" attribute
- of each <form-bean> element.</em>
- </li>
-
- <li>
- <strong>forward</strong> - The Java class name of the ActionForward
- implementation to use
- [org.apache.struts.action.ActionForward].
- Two convenient classes you may wish to use are:
- <ul>
-
- <li>
- <em>org.apache.struts.action.ForwardingActionForward</em> -
- Subclass of <code>org.apache.struts.action.ActionForward</code>
- that defaults the <code>redirect</code> property to
- <code>false</code> (same as the ActionForward default value).
- </li>
-
- <li>
- <em>org.apache.struts.action.RedirectingActionForward</em> -
- Subclass of <code>org.apache.struts.action.ActionForward</code>
- that defaults the <code>redirect</code> property to
- <code>true</code>.
- </li>
-
- </ul>
- <em>DEPRECATED - Configure this using the "className" attribute of
- each <forward> element.</em>
- </li>
-
- <li>
- <strong>locale</strong> - If set to <code>true</code>, and there is a
- user session, identify and store an appropriate
- <code>java.util.Locale</code> object (under the standard key
- identified by <code>Globals.LOCALE_KEY</code>) in the user's session
- if there is not a Locale object there already.
- [true]
- <em>DEPRECATED - Configure this using the "locale" attribute of
- the <controller> element.</em>
- </li>
-
- <li>
- <strong>mapping</strong> - The Java class name of the ActionMapping
- implementation to use
- [org.apache.struts.action.ActionMapping].
- Two convenient classes you may wish to use are:
-
- <ul>
-
- <li>
- <em>org.apache.struts.action.RequestActionMapping</em> - Subclass
- of <code>org.apache.struts.action.ActionMapping</code> that
- defaults the <code>scope</code> property to "request".
- </li>
-
- <li>
- <em>org.apache.struts.action.SessionActionMapping</em> - Subclass
- of <code>org.apache.struts.action.ActionMapping</code> that
- defaults the <code>scope</code> property to "session".
- (Same as the ActionMapping default value).
- </li>
-
- </ul>
-
- <em>DEPRECATED - Configure this using the "className" attribute of
- each <action> element, or globally for a module by using the
- "type" attribute of the <action-mappings> element.</em>
- </li>
-
- <li>
- <strong>maxFileSize</strong> - 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]
- <em>DEPRECATED - Configure this using the "maxFileSize" attribute of
- the <controller> element.</em>
- </li>
-
- <li>
- <strong>multipartClass</strong> - The fully qualified name of the
- MultipartRequestHandler implementation class to be used for processing
- file uploads.
- If set to <code>none</code>, disables Struts multipart request
- handling.
- [org.apache.struts.upload.CommonsMultipartRequestHandler]
- <em>DEPRECATED - Configure this using the "multipartClass" attribute
- of the <controller> element.</em>
- </li>
-
- <li>
- <strong>nocache</strong> - If set to <code>true</code>, add HTTP
- headers to every response intended to defeat browser caching of
- any response we generate or forward to.
- [false]
- <em>DEPRECATED - Configure this using the "nocache" attribute of
- the <controller> element.</em>
- </li>
-
- <li>
- <strong>null</strong> - If set to <code>true</code>, set our
- application resources to return <code>null</code> if an unknown
- message key is used.
- Otherwise, an error message including the offending message key will
- be returned.
- [true]
- <em>DEPRECATED - Configure this using the "null" attribute of
- the <message-resources> element.</em>
- </li>
-
- <li>
- <strong>tempDir</strong> - The temporary working directory to use when
- processing file uploads.
- [The working directory provided to this web application as a servlet
- context attribute]
- <em>DEPRECATED - Configure this using the "tempDir" attribute of
- the <controller> element.</em>
- </li>
-
- </ul>
<p>
<strong>WARNING</strong> - Struts will not
1.36 +16 -22 jakarta-struts/doc/userGuide/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation.xml,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- installation.xml 15 Sep 2003 00:33:03 -0000 1.35
+++ installation.xml 12 Dec 2003 03:20:53 -0000 1.36
@@ -84,33 +84,31 @@
<a
href="http://java.sun.com/products/jdbc/download.html";>http://java.sun.com/products/jdbc/download.html</a>.</li>
<li>
- <strong>Jakarta Commons Packages</strong> - Struts utilizes several
- packages from the <a href="http://jakarta.apache.org/commons/";>Jakarta
+ <strong>Other Packages</strong> - Struts utilizes several
+ packages from other open source projects, especially the <a
href="http://jakarta.apache.org/commons/";>Jakarta
Commons Project</a>.
These are the packages which must be available if you wish to
build Struts from source:
<ul>
- <li><em>Beanutils</em> (Version 1.6.1 or later)</li>
- <li><em>Collections</em> (Version 2.1 or later)</li>
- <li><em>Digester</em> (Version 1.5 or later)</li>
- <li><em>FileUpload</em> (Version 1.0 or later)</li>
- <li><em>Lang</em> (Version 1.0.1 or later)</li>
- <li><em>Logging</em> (Version 1.0.3 or later when it is available)</li>
- <li><em>Struts-Legacy</em> (Version 1.0 or later)</li>
- <li><em>Validator</em> (Version 1.0.2 or later) </li>
+ <li><em>ANTLR</em> (Version 2.7.2 or later)</li>
+ <li><em>Commons Beanutils</em> (Version 1.6.1 or later)</li>
+ <li><em>Commons Collections</em> (Version 2.1 or later)</li>
+ <li><em>Commons Digester</em> (Version 1.5 or later)</li>
+ <li><em>Commons FileUpload</em> (Version 1.0 or later)</li>
+ <li><em>Commons Lang</em> (Version 2.0 or later)</li>
+ <li><em>Commons Logging</em> (Version 1.0.3 or later when it is
available)</li>
+ <li><em>Commons Validator</em> (Version 1.1.1-dev) </li>
+ <li><em>Jakarta ORO</em> (Version 2.0.7 or later)</li>
</ul>
+ ANTLR is a public domain library; all other libraries are distributed under
the
+ Apache Software License.
For your convenience, the requisite JARs are provided as a single
download under the <code>lib</code> sub-directory with each release
- and beta distribution.
- Please note that the minimum requirements may change between releases
- and betas, and some JARs may need to be updated to use the latest
- Nightly Build.
+ distribution.
+ Please note that the minimum requirements may change between releases,
+ and some JARs may need to be updated to use the latest Nightly Build.
</li>
- <li><strong>Jakarta ORO</strong> -
- <a href="http://jakarta.apache.org/oro/index.html";>Apache Jakarta ORO</a>
- version 2.0.6 (or later) is required to build Struts from source.</li>
-
<li><strong>Xalan XSLT Processor</strong> - If you are building Struts from
the source distribution, you will need a version of Xalan to perform
XSLT transformations. If you are using the JAXP/1.1 XML parser, you
@@ -148,10 +146,6 @@
from the Jakarta Commons project that are utilized within Struts
itself. When you assemble a Struts-based application, you will need
to copy these files to the <code>WEB-INF/lib</code> directory.</li>
- <li><strong>lib/jdbc2_0-stdext.jar</strong> - The JDBC 2.0 Optional Package
- API classes. You will need to copy this file to your
- <code>WEB-INF/lib</code> directory if you are utilizing the data
- sources support provided by Struts.</li>
<li><strong>lib/struts.jar</strong> - This JAR file contains all of the
Java classes included in Struts. It should be copied into the
<code>WEB-INF/lib</code> directory of your web application.
1.19 +13 -11 jakarta-struts/doc/userGuide/introduction.xml
Index: introduction.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/introduction.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- introduction.xml 9 Sep 2003 17:49:18 -0000 1.18
+++ introduction.xml 12 Dec 2003 03:20:53 -0000 1.19
@@ -151,10 +151,10 @@
<p>
The <em>View</em> portion of a Struts-based application is most often
- constructed using JavaServer Pages (JSP) technology. JSP pages can
+ constructed using JavaServer Pages (JSP) technology. JSP pages can
contain static HTML (or XML) text called "template text", plus the
ability to insert dynamic content based on the interpretation (at page
- request time) of special action tags. The JSP environment includes a
+ request time) of special action tags. The JSP environment includes a
set of standard action tags, such as <code><jsp:useBean></code>
whose purpose is described in the <a
href="http://java.sun.com/products/jsp/download.html";>JavaServer Pages
Specification</a>.
In addition to the built-in actions, there is a standard facility to
@@ -163,9 +163,10 @@
<p>
Struts includes a set of custom tag libraries that facilitate
- creating user interfaces that are fully internationalized, and that
- interact gracefully with <code>ActionForm</code> beans that are part
- of the <em>Model</em> portion of the system.
+ creating user interfaces that are fully internationalized and
+ interact gracefully with <code>ActionForm</code> beans.
+ ActionForms capture and validate whatever input is required by
+ the application.
</p>
<p>
@@ -188,22 +189,23 @@
Controller is a servlet of class <code>ActionServlet</code>. This servlet
is configured by defining a set of <code>ActionMappings</code>.
An ActionMapping defines a <code>path</code> that is matched against the
- request URI of the incoming request, and usually specifies the
+ request URI of the incoming request and usually specifies the
fully qualified class name of an Action class. All Actions
are subclassed from <code>org.apache.struts.action.Action</code>. Actions
- encapsulate the business logic, interpret the outcome, and ultimately
dispatch
- control to the appropriate View component to create the response.
+ encapsulate calls to business logic classes, interpret the outcome, and
+ ultimately dispatch control to the appropriate View component to create the
+ response.
</p>
<p>
Struts also supports the ability to use <code>ActionMapping</code>
classes that have additional properties beyond the standard ones required
to operate the framework. This allows you to store additional information
- specific to your application, but still utilize the remaining features of
+ specific to your application and still utilize the remaining features of
the framework. In addition, Struts lets you define logical "names" to which
control should be forwarded so that an action method can ask for the
- "Main Menu" page (for example), without knowing what the actual name of the
- corresponding JSP page is. These features greatly assist you in separating
+ "Main Menu" page (for example), without knowing the location of the
+ corresponding JSP page. These features greatly assist you in separating
the control logic (what to do) with the view logic (how it's rendered).
</p>
1.43 +2 -18 jakarta-struts/doc/userGuide/release-notes.xml
Index: release-notes.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/release-notes.xml,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -r1.42 -r1.43
--- release-notes.xml 11 Dec 2003 20:37:25 -0000 1.42
+++ release-notes.xml 12 Dec 2003 03:20:53 -0000 1.43
@@ -11,7 +11,7 @@
<section name="Introduction" href="Introduction">
<p>This section contains release notes for
<strong>nightly build</strong> of the Struts Framework, for changes that have
taken place since
- <a href="release-notes-1.1.html">Version 1.1</a>was released.</p>
+ <a href="release-notes-1.1.html">Version 1.1</a> was released.</p>
</section>
<section name="What's Included?" href="Included">
<p>The binary distribution of this release includes the following files
relevant to Struts:</p>
@@ -63,23 +63,7 @@
<li>
<code>webapps/</code> - Web Application Archive (WAR) files for the
web applications that are included with Struts.</li>
</ul>
- <p>The following libraries are included with this release of Struts:</p>
- <ul>
- <li>ANTLR 2.7.2</li>
- <li>Commons BeanUtils 1.6.1</li>
- <li>Commons Collections 2.1</li>
- <li>Commons Digester 1.5</li>
- <li>Commons FileUpload 1.0</li>
- <li>Commons Lang 2.0</li>
- <li>Commons Logging 1.0.3</li>
- <li>Jakarta ORO 2.0.7</li>
- </ul>
- <p>All of the forgoing libraries are a stable release and are distributed
under an Apache-style license.</p>
- <p>The following libraries are
- <strong>not</strong> at stable release stage, and are distributed only as
part of Struts own unstable development build.</p>
- <ul>
- <li>Commons Validator 1.1.1-dev</li>
- </ul>
+ <p>For the version requirements of each library, see the<a
href="installation.html">Installation chapter</a>.</p>
</section>
<section name="What's new?" href="New">
<p>This section highlights new features added and critical changes made since
the last release. Other interesting changes are listed in the
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
