husted 2002/06/25 08:19:51
Modified: doc/userGuide release-notes-1.1-b1.xml
Log:
Additonal updates to the release notes for 1.1 -- still a lot to do though.
Especially need better verbiage for the Validator, Tiles, Nesting additions,
and a summary of the whiz-bang enhancements to ActionServlet =:0)
Revision Changes Path
1.2 +193 -23 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.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- release-notes-1.1-b1.xml 20 Mar 2002 03:07:13 -0000 1.1
+++ release-notes-1.1-b1.xml 25 Jun 2002 15:19:51 -0000 1.2
@@ -83,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>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>COMMONS PACKAGES</strong>:
- Several components of Struts 1.0 have been found to be useful in
+ <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>.
@@ -119,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. Parsers known to work include the JAXP/1.1 reference implementation,
- and Xerces 1.3.1.</p>
+ <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>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>
@@ -159,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>
@@ -172,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>
@@ -188,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>
@@ -199,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>
@@ -206,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>
@@ -218,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>
@@ -248,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>
@@ -259,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>
@@ -269,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>
@@ -282,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>
@@ -293,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>
@@ -300,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>
@@ -315,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>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
