build-legacy/core/xdocs/userGuide/release-notes.xml

<?xml version="1.0"?> <document url="release-notes.html"> <properties> <title>Struts Release Notes (Nightly Build)</title> </properties> <body> <section name="6.1 Release Notes" href="release_notes"/> <section name="Beta Notes" href="beta"> This section contains the release notes for nightly build of the Struts Framework, for changes that have taken place since <a href="release-notes-1.1.html">Version 1.1 </a> was released. For a complete list of changes since the last production release, see the <a href="#Introduction">Introduction</a> </section> <section name="Beta Fixes" href="beta.Changes"> ApplicationConfig: In Struts 1.2 was removed. </section> <section name="Introduction" href="Introduction"> The remainder of this document contains the release notes for nightly build of the Struts Framework, and covers changes that have taken place since <a href="release-notes-1.1.html">Version 1.1</a> was released. The following sections cover <a href="#New">New Features</a> and <a href="#Changes">Changes</a> to Struts. </section> <section name="What's Included?" href="Included"> The binary distribution of this release includes the following files relevant to Struts: <ul> <li><code>INSTALL</code> - Brief installation instructions. See the <code>Struts Documentation Application</code>, or online at <a href="http://jakarta.apache.org/struts/">http://jakarta.apache.org/struts/</a> for more information.</li> <li><code>LICENSE</code> - The Apache Software Foundation license that defines the terms under which you can use Struts (and other software licensed by Apache).</li> <li><code>README</code> - A brief introduction to Struts.</li> <li><code>lib/</code> - Directory containing files you will need in your own applications. The individual files of interest are: <ul> <li><code>commons-*.jar</code> - Release packages from the <a href="http://jakarta.apache.org/commons/">Jakarta Commons Project</a> that Struts relies on. You are welcome to use these classes in your own applications. These JAR files should be copied into the <code>/WEB-INF/lib</code> directory of your web application.</li> <li><code>struts.jar</code> - JAR file that contains the compiled Java classes of Struts. You must 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, and logic). 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> <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_2.dtd</code> - The Document Type Definition (DTD) for the Struts 1.2 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_1.dtd</code> - The Document Type Definition (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 Definition (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> <li><code>web-app_2_2.dtd</code> - The Document Type Definition (DTD) for web.xml files conforming to the Servlet 2.2 specification. This copy is for reference purposes only.</li> <li><code>web-app_2_3.dtd</code> - The Document Type Definition (DTD) for web.xml files conforming to the Servlet 2.3 specification. This copy is for reference purposes only.</li> </ul></li> <li><code>webapps/</code> - Web Application Archive (WAR) files for the web applications that are included with Struts.</li> </ul> The following Jakarta Commons libraries are included with this release of Struts: <ul> <li>Commons BeanUtils 1.6.1</li> <li>Commons Collections 2.1</li> <li>Commons Digester 1.5</li> <li>Commons FileUpload 1.0</li> <li>Commons Lang 2.0</li> <li>Commons Logging 1.0.3</li> <li>Commons Validator 1.1.0</li> </ul> </section> <section name="What's New?" href="New"> Following are highlights of the new features. In the next section, we provide links to the JavaDocs for the affected classes. New Configuration DTD The Struts Configuration 1.1 DTD has been deprecated in favor of the <code><a href="http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">struts-config_1_2.dtd</a></code>. In the Struts 1.2 release, existing Struts configuration files can be loaded using either DTD version. The new DTD adds two new elements <display-name> and <description> to the struts-config element. There are for use by struts config file tools and document generation. New Dependencies on Commons packages The resource component of Struts 1.1 has 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>. As a result, the current development version of Struts has been modified to rely on this Commons package, rather than the Struts internal version. In nearly every case, this involved changing only the <code>import</code> statements at the top of your classes. Any applications that utilize these classes will need to be modified in the same way. The following Commons packages contain the replacements for the corresponding Struts 1.1 classes: <ul> <li>Resources Package [<a href="http://jakarta.apache.org/commons/resources.html"><code>org.apache.commons.resources</code></a>] - <code>org.apache.struts.utils.MessageResources</code></li> </ul> NOTE! XML Parser Prerequisite Updated 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. SOURCE DEVELOPERS NOTE! Ant Prerequisite Updated To build Struts from source Ant 1.5.2 or later is now required. This does not affect developers that use Struts from the binary distribution. 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. Action Package Additions The following new features have been added to the basic controller framework [<code>org.apache.struts.action</code>]: Actions Package Additions The following new features have been added to the adapters between the incoming HTTP request and the corresponding business logic framework [<code>org.apache.struts.actions</code>]: <ul> <li>The DispatchAction now provides default cancel handler that can be overridden. It also also possible to specify the default handler name.</li> <li>The LookupDispatchAction now provides default cancel handler that can be overridden. It also also possible to specify the default handler name.</li> </ul> Util Package Additions The following new features have been added to the utility classes [<code>org.apache.struts.util</code>]: Validator Package Additions The following new features have been added to the validator classes [<code>org.apache.struts.validator</code>]: <ul> <li>The ValidatorPlugin: It is now possible to force the client side Javascript validation to check all constraints, instead of stopping at the first error. By setting a new property, stopOnFirstError, on the validator plug in tag to false. This is in the struts-config.xml as follow: <pre> <plug-in className="org.apache.struts.validator.ValidatorPlugIn"> <set-property property="pathnames" value="/WEB-INF/validation.xml,/WEB-INF/validator-rules.xml"/> <set-property property="stopOnFirstError" value="true"/> </plug-in> </pre> </li> <li>validator-rules.xml[intRange]: IntRange now checks select-one and radio fields. Example: This allows populating combo boxes with valid choices plus one additional choice with a caption something like "Choose one" and a value 0f "-1". Then when the user attempts to submit the form, you can look for the value of "-1" and yell at them if they failed to pick something. </li> </ul> HTML Taglib Package Additions The following new features have been added to the struts-html custom tag library [<code>org.apache.struts.taglib.html</code>]: Logic Taglib Package Additions The following new features have been added to the struts-logic custom tag library [<code>org.apache.struts.taglib.logic</code>]: Documentation Additions The following new features have been added to the Struts Documentation application (and corresponding contents on the Struts web site): </section> <section name="Operational Changes and Bug Fixes" href="Changes"> Struts Configuration Changes The following changes and bug fixes have occurred in the configuration files related to Struts: <ul> <li>Japanese resources updates for Struts, its example, upload, tiles-documentation.</li> </ul> Config Package Action Package Changes The following changes and bug fixes have occurred in the basic controller framework (package <code>org.apache.struts.action</code>): Upload Package Changes The following changes and bug fixes have occurred in the file upload package (package <code>org.apache.struts.upload</code>): <ul> <li>None.</li> </ul> Utility Package Changes The following changes and bug fixes have occurred in the utilities (package <code>org.apache.struts.util</code>): <ul> <li>RequestUtils: </li> </ul> Bean Taglib Package Changes The following changes and bug fixes have occurred in the struts-bean custom tag library [<code>org.apache.struts.taglib.bean</code>]: HTML Taglib Package Changes The following changes and bug fixes have occurred in the struts-html custom tag library (package <code>org.apache.struts.taglib.html</code>): Logic Taglib Package Changes The following changes and bug fixes have occurred in the struts-logic custom tag library (package <code>org.apache.struts.taglib.logic</code>): <ul> <li>None.</li> </ul> Documentation Application Changes The following changes and bug fixes to the Struts Documentation application (and corresponding contents on the Struts web site) have occurred: MailReader Example Application Changes The following changes and bug fixes to the Struts MailReader Example Application have occurred: Template Example Application Changes The following changes and bug fixes to the Struts Template Example Application have occurred: <ul> <li>Removed.</li> </ul> Exercise Taglib Example Application Changes The following changes and bug fixes to the Struts Exercise Taglib Example Application have occurred: </section> <section name="What's different?" href="diff"> This section provides links to the Struts JavaDoc for any classes that have been added or deprecated since the Struts 1.0 release. Previously deprecated classes and packages removed in Struts 1.2 <ul> <li>Removed: <code>org.apache.struts.xxxx</code> </li> </ul> Packages added in Struts 1.2 Classes added in Struts 1.2 action actions taglib.html taglib.logic upload util Classes with members added in Struts 1.2 <a href="../api/org/apache/struts/action/ActionServlet.html">action.A</a><a href="../api/org/apache/struts/action/ActionServlet.html">ActionServlet</a> <ul> <li>initModuleConfigFactory()</li> <li>methods created for backward-compatiblity only</li> </ul> <a href="../api/org/apache/struts/validator/ValidatorPlugin.html">validator.html</a> <ul> <li>isStopOnFirstError</li> <li>setStopOnFirstError</li> </ul> Classes deprecated between Struts 1.1 and Struts 1.2 action <ul> <li><a href="../api/org/apache/struts/xxx/xxxx.html"> xxx</a></li> </ul> Classes with members deprecated between Struts 1.1 and Struts 1.2 <a href="../api/org/apache/struts/xxxx/xxxx.html">class.method</a> Classes with members removed between Struts 1.1 and Struts 1.2 validator-rules.xml, range() - use intRange() instead. </section> <section> Next: <a href="installation.html">Installation</a> </section> </body> </document>

build-legacy/core/xdocs/userGuide/release-notes.xml (293 lines of code) (raw):