<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <title>Struts Release Notes (Version 1.0-beta-3)</title> <meta content="text/html; charset=utf-8" http-equiv="Content-Type" /> <meta content="Craig R. McClanahan" name="author" /> <link href="../struts.css" type="text/css" rel="stylesheet" /> </head> <body> <div id="heading"> <a href="http://apache.org/"> <img id="asf_logo_wide" alt="The Apache Project" src="../images/asf_logo_wide.gif" /> </a> <a href="http://struts.apache.org/"> <img id="struts-logo" alt="Struts Framework" src="../images/struts.gif" /> </a> </div> <!--end heading--> <div id="content"> <div id="menu"> <p>User Guide</p> <ul> <li> <a href="index.html">Table of Contents</a> </li> <li> <a href="preface.html">Preface</a> </li> <li> <a href="introduction.html">Introduction</a> </li> <li> <a href="building_model.html">Model Components</a> </li> <li> <a href="building_view.html">View Components</a> </li> <li> <a href="building_controller.html">Controller Components</a> </li> <li> <a href="configuration.html">Configuration</a> </li> <li> <a href="release-notes.html">Release Notes</a> </li> <li> <a href="installation.html">Installation</a> </li> </ul> <p>Developer Guides</p> <ul> <li> <a href="dev_bean.html">Bean Tags</a> </li> <li> <a href="dev_html.html">HTML Tags</a> </li> <li> <a href="dev_logic.html">Logic Tags</a> </li> <li> <a href="dev_nested.html">Nested Tags</a> </li> <li> <a href="dev_tiles.html">Tiles Tags</a> </li> <li> <a href="dev_util.html">Utilities</a> </li> <li> <a href="dev_validator.html">Validator</a> </li> </ul> <p>Quick Links</p> <ul> <li> <a href="../index.html">Welcome</a> </li> <li> <a href="index.html">User and Developer Guides *</a> </li> <li> <a href="../faqs/index.html">FAQs and HowTos</a> </li> </ul> <div class="authors"> <p> <strong>Contributors</strong> </p> <ul> <li>Craig R. McClanahan</li> </ul> </div> </div> <!--end menu--> <div id="main"> <h2 id="Introduction">Introduction</h2> <div class="indent"> <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> </div> <h2 id="Included">What's Included?</h2> <div class="indent"> <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> </div> <h2 id="New">What's New?</h2> <div class="indent"> <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> <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> <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> <p>The following new features have been added to the Struts Documentation application (and corresponding contents on the Struts web site):</p> </div> <h2 id="Changes">Changes and Bug Fixes</h2> <div class="indent"> <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> <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 occurred 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> <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> <p>The following changes and bug fixes to the Struts Template Example Application have occurred:</p> </div> </div> <!--end main--> </div> <!--end content--> <div id="footer"> <img id="powered-logo" alt="Powered by Struts" src="../images/struts-power.gif" /> Copyright (c) 2000-2005, The Apache Software Foundation <span class="noprint">- <a href="http://wiki.apache.org/struts/StrutsDocComments">Comments?</a> </span> </div> <!--end footer--> </body> </html>