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: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>