| <?xml version="1.0"?> |
| <document url="./release-notes-1.0-b3.xml"> |
| |
| <properties> |
| <author>Craig R. McClanahan</author> |
| <title>Struts Release Notes (Version 1.0-beta-3)</title> |
| </properties> |
| |
| <body> |
| |
| <section name="Introduction" href="Introduction"> |
| |
| <p>This document contains the release notes for |
| <strong>Version 1.0-beta-3</strong> of the Struts Framework, |
| and covers changes that have taken place since |
| <a href="release-notes-1.0-b2.html">Version 1.0-beta-2</a> |
| was released. The following sections cover |
| <a href="#New">New Features</a> and <a href="#Changes">Changes</a> |
| to Struts.</p> |
| |
| </section> |
| |
| |
| <section name="What's Included?" href="Included"> |
| |
| <p>The binary distribution of this release includes the following |
| files relevant to Struts 1.0:</p> |
| <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>struts.jar</code> - JAR file that contains the compiled |
| Java classes for both version 0.5 and 1.0 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.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. <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_0.dtd</code> - The document type descriptor |
| (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> |
| <li><code>web-app_2_2.dtd</code> - The document type descriptor (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 descriptor (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> |
| |
| <p>For backwards compatibility only, the binary distribution also |
| includes the following files that conform to the Struts 0.5 milestone |
| release APIs. Usage of these files and APIs is deprecated, and they |
| will be removed from releases after Struts 1.0:</p> |
| <ul> |
| <li><code>lib/</code> - Directory containing files you will need in |
| your own applications. The individual files of interest are: |
| <ul> |
| <li><code>struts.jar</code> - JAR file that contains the compiled |
| Java classes for both version 0.5 and 1.0 of Struts. You must |
| place this file in the <code>/WEB-INF/lib</code> directory of |
| your web application.</li> |
| <li><code>struts.tld</code> - The tag library descriptor file for |
| the 0.5 version of the Struts tags. You must place this file |
| in the <code>/WEB-INF</code> directory of your web application, |
| and reference it with appropriate <code><taglib></code> |
| directives in your web.xml file.</li> |
| </ul></li> |
| </ul> |
| |
| </section> |
| |
| |
| <section name="What's New?" href="New"> |
| |
| <p><strong>DEPRECATIONS</strong> - The entire custom tag library |
| that is documented in <code>struts.tld</code> has been deprecated. |
| These tags correspond to the Struts 0.5 functionality that is also |
| deprecated, and have been replaced (and considerably enhanced) in |
| the various individual tag libraries.</p> |
| |
| <p><strong>DEPRECATIONS</strong> - The entire custom tag library |
| that is documented in <code>struts-form.tld</code> has been deprecated |
| because this library has been renamed <code>struts-html.tld</code> |
| instead.</p> |
| |
| <p><strong>DEPRECATIONS</strong> - Several classes in the |
| <code>org.apache.struts.util</code> package have been marked as |
| deprecated in their entirety, because they will be replaced by |
| versions from the Jakarta Commons project once those packages are |
| released. These deprecated classes will <strong>not</strong> be |
| removed until a release after Struts 1.1. In general, the only |
| change required inside user code using these classes will be to |
| update the <code>import</code> statement. The following classes |
| are involved:</p> |
| <ul> |
| <li>ArrayStack</li> |
| <li>BeanUtils</li> |
| <li>ConvertUtils</li> |
| <li>FastArrayList</li> |
| <li>FastHashMap</li> |
| <li>FastTreeMap</li> |
| <li>GenericConnection</li> |
| <li>GenericDataSource</li> |
| <li>PropertyUtils</li> |
| </ul> |
| |
| <p>The following new features have been added to the basic controller |
| framework (package <code>org.apache.struts.action</code>):</p> |
| <ul> |
| </ul> |
| |
| <p>The following new features have been added to the utility classes |
| (package <code>org.apache.struts.util</code>):</p> |
| <ul> |
| <li><code>GenericDataSource</code> can now be configured with a "ping" |
| type command (via the <code>pingCommand</code> and |
| <code>pingQuery</code> properties) that will be executed before |
| returning a connection from <code>getConnection()</code>. This |
| can be used to detect stale connections due to timeouts or a |
| database server restart. If the ping command fails, the corresponding |
| connection will be thrown away, and a new one allocated.</li> |
| </ul> |
| |
| |
| <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> |
| <ul> |
| <li>It is now possible to use any object in the values and labels |
| collections for the <code><html:options></code> tag.</li> |
| <li>Added the missing <code>tabindex</code> attribute to the |
| <code><html:radio></code> tag.</li> |
| <li>On the <code><html:img></code>, <code><html:link></code>, |
| and <code><html:rewrite></code> tags, you can now specify |
| arbitrary object values in the <code>Map</code> used to include |
| dynamic request attributes, as long as the <code>toString()</code> |
| method renders the values appropriately.</li> |
| <li>In all cases where "minimized" attributes were being generated |
| (<code>checked</code>, <code>disabled</code>, <code>multiple</code>, |
| <code>readonly</code>, and <code>selected</code>), the generated |
| attribute has a value (such as <code>selected="true"</code>) for |
| XML syntax compatibility.</li> |
| </ul> |
| |
| <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> |
| <ul> |
| </ul> |
| |
| <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> |
| <ul> |
| </ul> |
| |
| <p>The following new features have been added to the Struts Documentation |
| application (and corresponding contents on the Struts web site):</p> |
| <ul> |
| </ul> |
| |
| </section> |
| |
| |
| <section name="Changes and Bug Fixes" href="Changes"> |
| |
| <p>The following changes and bug fixes have occurred in the configuration |
| files related to Struts:</p> |
| <ul> |
| <li>The DTD for <code>struts-config.xml</code> files had an incorrect |
| ENTITY declaration for the <code>Location</code> element.</li> |
| <li>The DTD for version 2.3 web application deployment descriptors has |
| been updated to the most recent (Proposed Final Draft 2) version.</li> |
| </ul> |
| |
| <p>The following changes and bug fixes have occurred in the basic |
| controller framework (package <code>org.apache.struts.action</code>):</p> |
| <ul> |
| </ul> |
| |
| <p>The following changes and bug fixes have occurred in the utilities |
| (package <code>org.apache.struts.util</code>):</p> |
| <ul> |
| <li>The <code>FastArrayMap()</code>, <code>FastHashMap()</code>, and |
| <code>FastTreeMap()</code> classes not correctly implement the |
| <code>clone()</code>, <code>equals()</code>, and |
| <code>hashCode()</code> methods consistent with the requirements |
| of the Java standard Collections APIs.</li> |
| <li><code>PropertyUtils</code> can now access public methods defined |
| in nested interfaces.</li> |
| <li>A misleading error message returned by <code>BeanUtils</code> |
| has been corrected.</li> |
| <li>Work around a problem compiling the <code>FastXxxxx</code> classes |
| with the VAJ compiler, because the superclass already includes a |
| private class named <code>Iterator</code>.</li> |
| <li>Remove a JDK 1.3 dependency that prevented compiling |
| <code>BeanUtils</code> under JDK 1.2.</li> |
| <li>Generate "&amp;" instead of "&" in query strings that |
| contain more than one name/value pair.</li> |
| </ul> |
| |
| <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> |
| <ul> |
| <li>Restore the ability of the <code><html:button></code> tag to |
| retrieve the button text from the nested body content (so that it |
| can be easily internationalized).</li> |
| <li>If the property name used in the <code>labelProperty</code> |
| attribute of an <code><html:options></code> tag is invalid, |
| report the correct property name in the error message.</li> |
| </ul> |
| |
| <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> |
| <ul> |
| </ul> |
| |
| <p>The following changes and bug fixes to the Struts Documentation |
| application (and corresponding contents on the Struts web site) have |
| occurred:</p> |
| <ul> |
| <li>Fix a reference to an old Struts 0.5 tag in one of the User's Guide |
| examples.</li> |
| <li>Fix the stylesheet used to transform XML into HTML documentation so |
| that nested <code><body></code> tags are not created.</li> |
| <li>The DTD for Struts configuration files has been refined to highlight |
| the fact that you should use <code><set-property></code> |
| elements to configure your data source implementation.</li> |
| </ul> |
| |
| <p>The following changes and bug fixes to the Struts Example Application |
| have occurred:</p> |
| <ul> |
| </ul> |
| |
| <p>The following changes and bug fixes to the Struts Template Example |
| Application have occurred:</p> |
| <ul> |
| </ul> |
| |
| </section> |
| |
| |
| </body> |
| |
| </document> |