You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2002/06/27 01:36:11 UTC
cvs commit: jakarta-struts/doc/userGuide release-notes.xml release-notes-1.1-b1.xml
husted 2002/06/26 16:36:11
Modified: doc/userGuide release-notes.xml release-notes-1.1-b1.xml
Log:
Restore release notes from 1.1 beta 1 and move yesterday's changes into the nightly build release notes instead (oops).
Revision Changes Path
1.2 +204 -31 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.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- release-notes.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ release-notes.xml 26 Jun 2002 23:36:11 -0000 1.2
@@ -1,11 +1,11 @@
<?xml version="1.0"?>
-<document url="./release-notes-1.0.xml">
+<document url="./release-notes.xml">
<properties>
<author>Craig R. McClanahan</author>
<author>Robert Leland</author>
<author>Ted Husted</author>
- <title>Struts Release Notes (current nightly build)</title>
+ <title>Struts Release Notes (Version 1.1 Beta 1)</title>
</properties>
<body>
@@ -15,7 +15,7 @@
<p>This document contains the release notes for
<strong>nightly build</strong> of the Struts Framework,
and covers changes that have taken place since
- <a href="release-notes-1.0.1.html">Version 1.0.1</a>
+ <a href="release-notes-1.0.2.html">Version 1.0.2</a>
was released. The following sections cover
<a href="#New">New Features</a> and <a href="#Changes">Changes</a>
to Struts.</p>
@@ -50,20 +50,23 @@
place this file in the <code>/WEB-INF/lib</code> directory of
your web application.</li>
<li><code>struts-xxxxx.tld</code> - The tag library descriptor files
- for the Struts 1.0 tag libraries (bean, html, logic, and
+ for the Struts 1.1 tag libraries (bean, html, logic, and
template). You must place these files in the <code>/WEB-INF</code>
directory of your web application, and reference them with
appropriate <code><taglib></code> directives in your
- web.xml file. <strong>NOTE</strong> - The struts-form.tld
- file is deprecated; you should use the struts-html.tld file
- instead.</li>
+ web.xml file.</li>
<li><code>jdbc2_0-stdext.jar</code> - The JDBC 2.0 Optional Package
API classes (package <code>javax.sql</code>). You will need to
include this file in the <code>/WEB-INF/lib</code> directory
of your application, if it is not already made visible to web
applications by your servlet container.</li>
<li><code>struts-config_1_1.dtd</code> - The document type descriptor
- (DTD) for the Struts configuration file (which is typically named
+ (DTD) for the Struts 1.1 configuration file (which is typically named
+ <code>/WEB-INF/struts-config.xml</code>. Your configuration file
+ will be validated against an internal copy of this DTD -- this
+ copy is available for reference purposes only.</li>
+ <li><code>struts-config_1_0.dtd</code> - The document type descriptor
+ (DTD) for the Struts 1.0 configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
will be validated against an internal copy of this DTD -- this
copy is available for reference purposes only.</li>
@@ -80,16 +83,20 @@
</section>
-
<section name="What's New?" href="New">
- <p><strong>DEPRECATIONS</strong>:</p>
- <ul>
- <li><code>struts-config.dtd</code> in favor of <code>struts-config_1_1.dtd</code>.</li>
- </ul>
+ <p>Following are highlights of the new features. In the next section, we
+ provide links to the JavaDocs for the affected classes.</p>
- <p><strong>COMMONS PACKAGES</strong>:
- Several components of Struts 1.0 have been found to be useful in
+ <p><strong>New Configuration DTD</strong></p>
+ <p> The Struts Configuration 1.0 DTD has been deprecated in favor of the
+ <code><a href="http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">struts-config_1_1.dtd</a></code>.
+ In the Struts 1.1 release, existing Struts configuration files can be
+ loaded using either DTD version.
+ </p>
+
+ <p><strong>New Dependancies on Commons packages</strong></p>
+ <p>Several components of Struts 1.0 have been found to be useful in
general Java development (and not just useful for building Struts-based
web applications), and have been migrated into the
<a href="http://jakarta.apache.org/commons/">Jakarta Commons Project</a>.
@@ -116,36 +123,60 @@
<code>org.apache.struts.digester.*</code>.</li>
</ul>
- <p><strong>XML PARSER PREREQUISITE UPDATED</strong>: Struts now depends
- on an XML parser that conforms to the JAXP/1.1 (rather than JAXP/1.0)
- APIs. Parser known to work include the JAXP/1.1 reference implementation,
- and Xerces 1.3.1.</p>
+ <p><strong>NOTE! XML Parser Prerequisite Updated</strong></p>
+
+ <p>Struts now depends on an XML parser that conforms to the JAXP/1.1
+ (rather than JAXP/1.0) APIs. Parsers known to work include the JAXP/1.1
+ reference implementation, and Xerces 1.3.1.</p>
+
+ <p><strong>SOURCE DEVELOPERS NOTE! Ant Prerequiste Updated</strong></p>
+ <p>To build Struts from source Ant 4.0 or later is now required. This
+ does not affect developers that use Struts from the binary distribution.</p>
+
+ <p><strong>Struts Validator Integration</strong></p>
+ <p>The new Commons-Validator is now integrated with Struts and exposed
+ through the new Validator package.</p>
+
+ <p><strong>Tiles - An advanced templating taglib</strong></p>
+ <p>The Tiles JSP assembly framework has been integrated with Struts.</p>
- <p><strong>CONTRIB Directory</strong>:
- A new directory (<code>contrib</code>) in the CVS source repository has
+ <p><strong>Nested - An very cool taglib extension</strong></p>
+ <p>The Nested taglib is bundled with Struts and enhances the functionality
+ of the existing Struts tags.</p>
+
+ <p><strong>New Example Applications</strong></p>
+ <p>New example applications for the Validator and Tiles are now part
+ of the Struts distribution.</p>
+
+ <p><strong>New Contrib directory for optional compoonents</strong></p>
+ <p>A new directory (<code>contrib</code>) in the CVS source repository has
been added to accumulate Struts add-on extensions that are generally
useful but have not yet been integrated into the standard code base.</p>
<p>
<ul>
- <li>ValidatorForm - Client and Server-side validation library.</li>
- <li>Tiles - Advanced templating library (see Struts-Tiles.war).</li>
+ <li>Scaffold - Library of reusable classes for building web applications.</li>
<li>Service Manager - Add custom services without subclassing controller.</li>
</ul>
</p>
- <p><strong>UNIT TESTING SUPPORT</strong>: Support for running unit tests
- on Struts components and custom tags is being added, utilizing the
- <a href="http://jakarta.apache.org/cactus/">Jakarta Cactus</a> product.</p>
+ <p>The source for these components is available in the Struts source
+ distribution. Binary distributions may also be made available with the Struts
+ download area. As optional components, these products have their own
+ release cycles.</p>
+ <p><strong>Action Package Additions</strong></p>
<p>The following new features have been added to the basic controller
framework (package <code>org.apache.struts.action</code>):</p>
<ul>
+ <li>The ActionServlet now provides support for modular Struts applications and
+ sports several new extension points.</li>
<li>The new <code>ActionMessages</code> class will support a superset of
the capabilities of <code>ActionErrors</code>, and will be useful as
a collection of general purpose messages, not just errors.</li>
</ul>
+ <p><strong>Util Package Additions</strong></p>
<p>The following new features have been added to the utility classes
(package <code>org.apache.struts.util</code>):</p>
<ul>
@@ -156,6 +187,7 @@
<li>Change RequestUtils to encode ampersands when building a query string.</li>
</ul>
+ <p><strong>Bean Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-bean</em> custom tag library (package
<code>org.apache.struts.taglib.bean</code>):</p>
@@ -169,6 +201,7 @@
a bean or bean property.</li>
</ul>
+ <p><strong>HTML Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
@@ -185,6 +218,7 @@
<li>Added indexed property to the SubmitTag, SelectTag, LinkTag.java, CheckboxTag, ButtonTag, ImageTag, RadioTag, and TextArea.Tag.</li>
</ul>
+ <p><strong>Logic Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-logic</em> custom tag library (package
<code>org.apache.struts.taglib.logic</code>):</p>
@@ -196,6 +230,7 @@
empty strings.</li>
</ul>
+ <p><strong>Template Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-template</em> custom tag library (package
<code>org.apache.struts.taglib.template</code>):</p>
@@ -203,6 +238,7 @@
<li>None.</li>
</ul>
+ <p><strong>Documentation Additions</strong></p>
<p>The following new features have been added to the Struts Documentation
application (and corresponding contents on the Struts web site):</p>
<ul>
@@ -215,20 +251,19 @@
</section>
-
<section name="Changes and Bug Fixes" href="Changes">
+ <p><strong>Struts Configuration Changes</strong></p>
<p>The following changes and bug fixes have occurred in the configuration
files related to Struts:</p>
<ul>
<li>Remove deprecated support for the old (Struts 0.5) configuration file
format.</li>
</ul>
+ <p><strong>Action Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the basic
controller framework (package <code>org.apache.struts.action</code>):</p>
<ul>
- <li>Add InvokeAction and CreateActionForm methods to allow direct chaining of Actions.</li>
- <li>Add ContextHelper to expose framework elements to alternate presentation layers.</li>
<li>ActionForms and related classes now use a StringBuffer when responding a toString request in order to conserve resources.</li>
<li>Add standard LookupDispatchAction to help select between internationalized buttons.</li>
<li>Modify ActionForm class to use ActionServletWrapper rather than expose ActionServlet.</li>
@@ -245,6 +280,7 @@
<li>The initial order a property/key is added in is now maintained by ActionMessages class.</li>
</ul>
+ <p><strong>Upload Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the file upload
package (package <code>org.apache.struts.upload</code>):</p>
<ul>
@@ -256,6 +292,7 @@
<li>Additional fix for file corruption problem with uploads and new line characters.</li>
</ul>
+ <p><strong>Utility Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the utilities
(package <code>org.apache.struts.util</code>):</p>
<ul>
@@ -266,6 +303,7 @@
<li><code>ConvertUtils.convertCharacter()</code> will now detect empty strings and return the default value.</li>
</ul>
+ <p><strong>Bean Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occured in the
<em>struts-bean</em> custom tag library (package
<code>org.apache.struts.taglib.bean</code>):</p>
@@ -279,6 +317,7 @@
"private".</li>
</ul>
+ <p><strong>HTML Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occured in the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
@@ -290,6 +329,7 @@
<li>Correctly URLEncode the query string parameter value on ImgTag, even if there is only a single parameter.</li>
</ul>
+ <p><strong>Logic Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the
<em>struts-logic</em> custom tag library (package
<code>org.apache.struts.taglib.logic</code>):</p>
@@ -297,6 +337,7 @@
<li>None.</li>
</ul>
+ <p><strong>Documentation Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Documentation
application (and corresponding contents on the Struts web site) have
occurred:</p>
@@ -312,26 +353,158 @@
<li>Various updates regarding other release notes.</li>
</ul>
- <p>The following changes and bug fixes to the Struts Example Application
+ <p><strong>MailReader Example Application Changes</strong></p>
+ <p>The following changes and bug fixes to the Struts MailReader Example Application
have occurred:</p>
<ul>
- <li>Add Russiand and Japanese translations of the application resources and set the character set for the example JSP pages to "UTF-8" so that it can display either English or Japanese.</li>
+ <li>Add Russian and Japanese translations of the application resources and set the character set for the example JSP pages to "UTF-8" so that it can display either English or Japanese.</li>
<li>Exchange "name" for "attribute" properties for Edit mappings in Struts configuration file.</li>
<li>Remove references to saving database data from "tour" document, since this functionality was removed.</li>
</ul>
+ <p><strong>Template Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Template Example
Application have occurred:</p>
<ul>
<li>None.</li>
</ul>
+ <p><strong>Exercise Taglib Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Excercise Taglib Example
Application have occurred:</p>
<ul>
<li>Added test case for <html:select> using <html:options> based on a collection
saved in the page context.</li>
</ul>
+
+ </section>
+
+ <section name="What's different?" href="diff">
+
+ <p>This section provides links to the Struts JavaDoc for any classes that have
+ been added or deprecated since the Struts 1.0 release.
+ </p>
+
+ <strong>Packages added in Struts 1.1</strong>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/config/package-summary.html">config</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/package-summary.html">taglib.nested</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/bean/package-summary.html">taglib.nested.bean</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/html/package-summary.html">taglib.nested.html</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/logic/package-summary.html">taglib.nested.logic</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/validator/package-frame.html">validator</a></li>
+ </ul>
+
+ <strong>Classes added in Struts 1.1</strong>
+ <p>action</p>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMessage.html"> ActionMessage</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMessages.html"> ActionMessages</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/DynaActionForm.html"> DynaActionForm</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/DynaActionFormClass.html"> DynaActionFormClass</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ExceptionHandler.html"> ExceptionHandler</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/RequestProcessor.html"> RequestProcessor</a></li>
+ </ul>
+ <p>actions</p>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/actions/LookupDispatchAction.html"> LookupDispatchAction</a></li>
+ </ul>
+ <p>taglib.html</p>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/FrameTag.html"> FrameTag</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/JavascriptValidatorTag.html"> JavascriptValidatorTag</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/MessagesTag.html">MessagesTag</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/OptionsCollectionTag.html"> OptionsCollectionTag</a></li>
+ </ul>
+ <p>taglib.logic</p>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/logic/EmptyTag.html"> EmptyTag</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/logic/MessagesNotPresentTag.html"> MessagesNotPresentTag</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/logic/MessagesPresentTag.html"> MessagesPresentTag</a></li>
+ </ul>
+ <p>util</p>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/util/LabelValueBean.html"> LabelValueBean</a></li>
+ </ul>
+ <strong>Classes with members added in Struts 1.1</strong>
+ <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/Action.html">action.Action</a></p>
+ <ul>
+ <li>ACTION_SERVLET_KEY</li>
+ <li>APPLICATION_KEY</li>
+ <li>MESSAGE_KEY</li>
+ <li>PLUG_INS_KEY</li>
+ <li>REQUEST_PROCESSOR_KEY</li>
+ <li>execute</li>
+ <li>getResources(javax.servlet.http.HttpServletRequest)</li>
+ <li>saveMessages</li>
+ </ul>
+ <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">action.A</a><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">ctionServlet</a></p>
+ <ul>
+ <li>configDigester</li>
+ <li>convertHack</li>
+ <li>log</li>
+ <li>processor</li>
+ <li>getInternal</li>
+ <li>destroyApplications</li>
+ <li>destroyConfigDigester</li>
+ <li>getApplicationConfig</li>
+ <li>getRequestProcessor</li>
+ <li>initApplicationConfig</li>
+ <li>initApplicationDataSources</li>
+ <li>initApplicationPlugIns</li>
+ <li>initApplicationMessageResources</li>
+ <li>initConfigDigester</li>
+ <li>methods created for backward-compatiblity only
+ <ul>
+ <li>defaultControllerConfig</li>
+ <li>defaultFormBeansConfig</li>
+ <li>defaultForwardsConfig</li>
+ <li>defaultMappingsConfig</li>
+ <li>defaultMessageResourcesConfig</li>
+ </ul>
+ </li>
+ </ul>
+ <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/BaseHandlerTag.html">taglib.html.BaseHandlerTag</a></p>
+ <ul>
+ <li>indexed</li>
+ <li>setIndexed</li>
+ <li>getIndexed</li>
+ </ul>
+ <strong>Classes deprecated between Struts 1.0 and Struts 1.1</strong>
+ <p>action</p>
+ <ul>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionException.html"> ActionException</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionFormBeans.html"> ActionFormBeans</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionForwards.html"> ActionForwards</a></li>
+ <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMappings.html"> ActionMappings</a></li>
+ </ul>
+ <strong>Classes with members deprecated between Struts 1.0 and Struts 1.1</strong>
+ <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/Action.html">action.Action</a></p>
+
+ <ul>
+ <li>FORM_BEANS_KEY</li>
+ <li>FORWARDS_KEY</li>
+ <li>MAPPINGS_KEY</li>
+ <li>getResources()</li>
+ <li>perform</li>
+ </ul>
+ <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">actionActionServlet</a></p>
+ <ul>
+ <li>findDataSource</li>
+ <li>findFormBean</li>
+ <li>findForward</li>
+ <li>findMapping</li>
+ <li>initDataSources</li>
+ <li>methods created for backward-compatiblity only
+ <ul>
+ <li>defaultControllerConfig</li>
+ <li>defaultFormBeansConfig</li>
+ <li>defaultForwardsConfig</li>
+ <li>defaultMappingsConfig</li>
+ <li>defaultMessageResourcesConfig</li>
+ </ul>
+ </li>
+ </ul>
<p>
Next: <a href="installation.html">Installation</a>
1.3 +30 -203 jakarta-struts/doc/userGuide/release-notes-1.1-b1.xml
Index: release-notes-1.1-b1.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/release-notes-1.1-b1.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- release-notes-1.1-b1.xml 25 Jun 2002 15:19:51 -0000 1.2
+++ release-notes-1.1-b1.xml 26 Jun 2002 23:36:11 -0000 1.3
@@ -5,7 +5,7 @@
<author>Craig R. McClanahan</author>
<author>Robert Leland</author>
<author>Ted Husted</author>
- <title>Struts Release Notes (Version 1.1 Beta 1)</title>
+ <title>Struts Release Notes (current nightly build)</title>
</properties>
<body>
@@ -15,7 +15,7 @@
<p>This document contains the release notes for
<strong>Version 1.1 Beta 1</strong> of the Struts Framework,
and covers changes that have taken place since
- <a href="release-notes-1.0.2.html">Version 1.0.2</a>
+ <a href="release-notes-1.0.1.html">Version 1.0.1</a>
was released. The following sections cover
<a href="#New">New Features</a> and <a href="#Changes">Changes</a>
to Struts.</p>
@@ -50,23 +50,20 @@
place this file in the <code>/WEB-INF/lib</code> directory of
your web application.</li>
<li><code>struts-xxxxx.tld</code> - The tag library descriptor files
- for the Struts 1.1 tag libraries (bean, html, logic, and
+ for the Struts 1.0 tag libraries (bean, html, logic, and
template). You must place these files in the <code>/WEB-INF</code>
directory of your web application, and reference them with
appropriate <code><taglib></code> directives in your
- web.xml file.</li>
+ web.xml file. <strong>NOTE</strong> - The struts-form.tld
+ file is deprecated; you should use the struts-html.tld file
+ instead.</li>
<li><code>jdbc2_0-stdext.jar</code> - The JDBC 2.0 Optional Package
API classes (package <code>javax.sql</code>). You will need to
include this file in the <code>/WEB-INF/lib</code> directory
of your application, if it is not already made visible to web
applications by your servlet container.</li>
<li><code>struts-config_1_1.dtd</code> - The document type descriptor
- (DTD) for the Struts 1.1 configuration file (which is typically named
- <code>/WEB-INF/struts-config.xml</code>. Your configuration file
- will be validated against an internal copy of this DTD -- this
- copy is available for reference purposes only.</li>
- <li><code>struts-config_1_0.dtd</code> - The document type descriptor
- (DTD) for the Struts 1.0 configuration file (which is typically named
+ (DTD) for the Struts configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
will be validated against an internal copy of this DTD -- this
copy is available for reference purposes only.</li>
@@ -83,20 +80,16 @@
</section>
- <section name="What's New?" href="New">
- <p>Following are highlights of the new features. In the next section, we
- provide links to the JavaDocs for the affected classes.</p>
+ <section name="What's New?" href="New">
- <p><strong>New Configuration DTD</strong></p>
- <p> The Struts Configuration 1.0 DTD has been deprecated in favor of the
- <code><a href="http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">struts-config_1_1.dtd</a></code>.
- In the Struts 1.1 release, existing Struts configuration files can be
- loaded using either DTD version.
- </p>
+ <p><strong>DEPRECATIONS</strong>:</p>
+ <ul>
+ <li><code>struts-config.dtd</code> in favor of <code>struts-config_1_1.dtd</code>.</li>
+ </ul>
- <p><strong>New Dependancies on Commons packages</strong></p>
- <p>Several components of Struts 1.0 have been found to be useful in
+ <p><strong>COMMONS PACKAGES</strong>:
+ Several components of Struts 1.0 have been found to be useful in
general Java development (and not just useful for building Struts-based
web applications), and have been migrated into the
<a href="http://jakarta.apache.org/commons/">Jakarta Commons Project</a>.
@@ -123,60 +116,36 @@
<code>org.apache.struts.digester.*</code>.</li>
</ul>
- <p><strong>NOTE! XML Parse Prerequisite Updated</strong></p>
-
- <p>Struts now depends on an XML parser that conforms to the JAXP/1.1
- (rather than JAXP/1.0) APIs. Parsers known to work include the JAXP/1.1
- reference implementation, and Xerces 1.3.1.</p>
-
- <p><strong>SOURCE DEVELOPERS NOTE! Ant Prerequiste Updated</strong></p>
- <p>To build Struts from source Ant 4.0 or later is now required. This
- does not affect developers that use Struts from the binary distribution.</p>
-
- <p><strong>Struts Validator Integration</strong></p>
- <p>The new Commons-Validator is now integrated with Struts and exposed
- through the new Validator package.</p>
-
- <p><strong>Tiles - An advanced templating taglib</strong></p>
- <p>The Tiles JSP assembly framework has been integrated with Struts.</p>
+ <p><strong>XML PARSER PREREQUISITE UPDATED</strong>: Struts now depends
+ on an XML parser that conforms to the JAXP/1.1 (rather than JAXP/1.0)
+ APIs. Parser known to work include the JAXP/1.1 reference implementation,
+ and Xerces 1.3.1.</p>
- <p><strong>Nested - An very cool taglib extension</strong></p>
- <p>The Nested taglib is bundled with Struts and enhances the functionality
- of the existing Struts tags.</p>
-
- <p><strong>New Example Applications</strong></p>
- <p>New example applications for the Validator and Tiles are now part
- of the Struts distribution.</p>
-
- <p><strong>New Contrib directory for optional compoonents</strong></p>
- <p>A new directory (<code>contrib</code>) in the CVS source repository has
+ <p><strong>CONTRIB Directory</strong>:
+ A new directory (<code>contrib</code>) in the CVS source repository has
been added to accumulate Struts add-on extensions that are generally
useful but have not yet been integrated into the standard code base.</p>
<p>
<ul>
- <li>Scaffold - Library of reusable classes for building web applications.</li>
+ <li>ValidatorForm - Client and Server-side validation library.</li>
+ <li>Tiles - Advanced templating library (see Struts-Tiles.war).</li>
<li>Service Manager - Add custom services without subclassing controller.</li>
</ul>
</p>
- <p>The source for these components is available in the Struts source
- distribution. Binary distributions may also be made available with the Struts
- download area. As optional components, these products have their own
- release cycles.</p>
+ <p><strong>UNIT TESTING SUPPORT</strong>: Support for running unit tests
+ on Struts components and custom tags is being added, utilizing the
+ <a href="http://jakarta.apache.org/cactus/">Jakarta Cactus</a> product.</p>
- <p><strong>Action Package Additions</strong></p>
<p>The following new features have been added to the basic controller
framework (package <code>org.apache.struts.action</code>):</p>
<ul>
- <li>The ActionServlet now provides support for modular Struts applications and
- sports several new extension points.</li>
<li>The new <code>ActionMessages</code> class will support a superset of
the capabilities of <code>ActionErrors</code>, and will be useful as
a collection of general purpose messages, not just errors.</li>
</ul>
- <p><strong>Util Package Additions</strong></p>
<p>The following new features have been added to the utility classes
(package <code>org.apache.struts.util</code>):</p>
<ul>
@@ -187,7 +156,6 @@
<li>Change RequestUtils to encode ampersands when building a query string.</li>
</ul>
- <p><strong>Bean Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-bean</em> custom tag library (package
<code>org.apache.struts.taglib.bean</code>):</p>
@@ -201,7 +169,6 @@
a bean or bean property.</li>
</ul>
- <p><strong>HTML Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
@@ -218,7 +185,6 @@
<li>Added indexed property to the SubmitTag, SelectTag, LinkTag.java, CheckboxTag, ButtonTag, ImageTag, RadioTag, and TextArea.Tag.</li>
</ul>
- <p><strong>Logic Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-logic</em> custom tag library (package
<code>org.apache.struts.taglib.logic</code>):</p>
@@ -230,7 +196,6 @@
empty strings.</li>
</ul>
- <p><strong>Template Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-template</em> custom tag library (package
<code>org.apache.struts.taglib.template</code>):</p>
@@ -238,7 +203,6 @@
<li>None.</li>
</ul>
- <p><strong>Documentation Additions</strong></p>
<p>The following new features have been added to the Struts Documentation
application (and corresponding contents on the Struts web site):</p>
<ul>
@@ -251,19 +215,20 @@
</section>
+
<section name="Changes and Bug Fixes" href="Changes">
- <p><strong>Struts Configuration Changes</strong></p>
<p>The following changes and bug fixes have occurred in the configuration
files related to Struts:</p>
<ul>
<li>Remove deprecated support for the old (Struts 0.5) configuration file
format.</li>
</ul>
- <p><strong>Action Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the basic
controller framework (package <code>org.apache.struts.action</code>):</p>
<ul>
+ <li>Add InvokeAction and CreateActionForm methods to allow direct chaining of Actions.</li>
+ <li>Add ContextHelper to expose framework elements to alternate presentation layers.</li>
<li>ActionForms and related classes now use a StringBuffer when responding a toString request in order to conserve resources.</li>
<li>Add standard LookupDispatchAction to help select between internationalized buttons.</li>
<li>Modify ActionForm class to use ActionServletWrapper rather than expose ActionServlet.</li>
@@ -280,7 +245,6 @@
<li>The initial order a property/key is added in is now maintained by ActionMessages class.</li>
</ul>
- <p><strong>Upload Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the file upload
package (package <code>org.apache.struts.upload</code>):</p>
<ul>
@@ -292,7 +256,6 @@
<li>Additional fix for file corruption problem with uploads and new line characters.</li>
</ul>
- <p><strong>Utility Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the utilities
(package <code>org.apache.struts.util</code>):</p>
<ul>
@@ -303,7 +266,6 @@
<li><code>ConvertUtils.convertCharacter()</code> will now detect empty strings and return the default value.</li>
</ul>
- <p><strong>Bean Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occured in the
<em>struts-bean</em> custom tag library (package
<code>org.apache.struts.taglib.bean</code>):</p>
@@ -317,7 +279,6 @@
"private".</li>
</ul>
- <p><strong>HTML Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occured in the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
@@ -329,7 +290,6 @@
<li>Correctly URLEncode the query string parameter value on ImgTag, even if there is only a single parameter.</li>
</ul>
- <p><strong>Logic Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the
<em>struts-logic</em> custom tag library (package
<code>org.apache.struts.taglib.logic</code>):</p>
@@ -337,7 +297,6 @@
<li>None.</li>
</ul>
- <p><strong>Documentation Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Documentation
application (and corresponding contents on the Struts web site) have
occurred:</p>
@@ -353,158 +312,26 @@
<li>Various updates regarding other release notes.</li>
</ul>
- <p><strong>MailReader Example Application Changes</strong></p>
- <p>The following changes and bug fixes to the Struts MailReader Example Application
+ <p>The following changes and bug fixes to the Struts Example Application
have occurred:</p>
<ul>
- <li>Add Russian and Japanese translations of the application resources and set the character set for the example JSP pages to "UTF-8" so that it can display either English or Japanese.</li>
+ <li>Add Russiand and Japanese translations of the application resources and set the character set for the example JSP pages to "UTF-8" so that it can display either English or Japanese.</li>
<li>Exchange "name" for "attribute" properties for Edit mappings in Struts configuration file.</li>
<li>Remove references to saving database data from "tour" document, since this functionality was removed.</li>
</ul>
- <p><strong>Template Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Template Example
Application have occurred:</p>
<ul>
<li>None.</li>
</ul>
- <p><strong>Exercise Taglib Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Excercise Taglib Example
Application have occurred:</p>
<ul>
<li>Added test case for <html:select> using <html:options> based on a collection
saved in the page context.</li>
</ul>
-
- </section>
-
- <section name="What's different?" href="diff">
-
- <p>This section provides links to the Struts JavaDoc for any classes that have
- been added or deprecated since the Struts 1.0 release.
- </p>
-
- <strong>Packages added in Struts 1.1</strong>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/config/package-summary.html">config</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/package-summary.html">taglib.nested</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/bean/package-summary.html">taglib.nested.bean</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/html/package-summary.html">taglib.nested.html</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/nested/logic/package-summary.html">taglib.nested.logic</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/validator/package-frame.html">validator</a></li>
- </ul>
-
- <strong>Classes added in Struts 1.1</strong>
- <p>action</p>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMessage.html"> ActionMessage</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMessages.html"> ActionMessages</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/DynaActionForm.html"> DynaActionForm</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/DynaActionFormClass.html"> DynaActionFormClass</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ExceptionHandler.html"> ExceptionHandler</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/RequestProcessor.html"> RequestProcessor</a></li>
- </ul>
- <p>actions</p>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/actions/LookupDispatchAction.html"> LookupDispatchAction</a></li>
- </ul>
- <p>taglib.html</p>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/FrameTag.html"> FrameTag</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/JavascriptValidatorTag.html"> JavascriptValidatorTag</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/MessagesTag.html">MessagesTag</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/OptionsCollectionTag.html"> OptionsCollectionTag</a></li>
- </ul>
- <p>taglib.logic</p>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/logic/EmptyTag.html"> EmptyTag</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/logic/MessagesNotPresentTag.html"> MessagesNotPresentTag</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/logic/MessagesPresentTag.html"> MessagesPresentTag</a></li>
- </ul>
- <p>util</p>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/util/LabelValueBean.html"> LabelValueBean</a></li>
- </ul>
- <strong>Classes with members added in Struts 1.1</strong>
- <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/Action.html">action.Action</a></p>
- <ul>
- <li>ACTION_SERVLET_KEY</li>
- <li>APPLICATION_KEY</li>
- <li>MESSAGE_KEY</li>
- <li>PLUG_INS_KEY</li>
- <li>REQUEST_PROCESSOR_KEY</li>
- <li>execute</li>
- <li>getResources(javax.servlet.http.HttpServletRequest)</li>
- <li>saveMessages</li>
- </ul>
- <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">action.A</a><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">ctionServlet</a></p>
- <ul>
- <li>configDigester</li>
- <li>convertHack</li>
- <li>log</li>
- <li>processor</li>
- <li>getInternal</li>
- <li>destroyApplications</li>
- <li>destroyConfigDigester</li>
- <li>getApplicationConfig</li>
- <li>getRequestProcessor</li>
- <li>initApplicationConfig</li>
- <li>initApplicationDataSources</li>
- <li>initApplicationPlugIns</li>
- <li>initApplicationMessageResources</li>
- <li>initConfigDigester</li>
- <li>methods created for backward-compatiblity only
- <ul>
- <li>defaultControllerConfig</li>
- <li>defaultFormBeansConfig</li>
- <li>defaultForwardsConfig</li>
- <li>defaultMappingsConfig</li>
- <li>defaultMessageResourcesConfig</li>
- </ul>
- </li>
- </ul>
- <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/html/BaseHandlerTag.html">taglib.html.BaseHandlerTag</a></p>
- <ul>
- <li>indexed</li>
- <li>setIndexed</li>
- <li>getIndexed</li>
- </ul>
- <strong>Classes deprecated between Struts 1.0 and Struts 1.1</strong>
- <p>action</p>
- <ul>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionException.html"> ActionException</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionFormBeans.html"> ActionFormBeans</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionForwards.html"> ActionForwards</a></li>
- <li><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMappings.html"> ActionMappings</a></li>
- </ul>
- <strong>Classes with members deprecated between Struts 1.0 and Struts 1.1</strong>
- <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/Action.html">action.Action</a></p>
-
- <ul>
- <li>FORM_BEANS_KEY</li>
- <li>FORWARDS_KEY</li>
- <li>MAPPINGS_KEY</li>
- <li>getResources()</li>
- <li>perform</li>
- </ul>
- <p><a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">actionActionServlet</a></p>
- <ul>
- <li>findDataSource</li>
- <li>findFormBean</li>
- <li>findForward</li>
- <li>findMapping</li>
- <li>initDataSources</li>
- <li>methods created for backward-compatiblity only
- <ul>
- <li>defaultControllerConfig</li>
- <li>defaultFormBeansConfig</li>
- <li>defaultForwardsConfig</li>
- <li>defaultMappingsConfig</li>
- <li>defaultMessageResourcesConfig</li>
- </ul>
- </li>
- </ul>
<p>
Next: <a href="installation.html">Installation</a>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>