You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2006/01/21 01:21:00 UTC
svn commit: r370938 [39/50] - in /struts: action/trunk/
action/trunk/conf/java/ action/trunk/src/java/org/apache/struts/
action/trunk/src/java/org/apache/struts/action/
action/trunk/src/java/org/apache/struts/chain/
action/trunk/src/java/org/apache/str...
Modified: struts/action/trunk/xdocs/userGuide/release-notes-1.0-b2.xml
URL: http://svn.apache.org/viewcvs/struts/action/trunk/xdocs/userGuide/release-notes-1.0-b2.xml?rev=370938&r1=370937&r2=370938&view=diff
==============================================================================
--- struts/action/trunk/xdocs/userGuide/release-notes-1.0-b2.xml (original)
+++ struts/action/trunk/xdocs/userGuide/release-notes-1.0-b2.xml Fri Jan 20 16:19:02 2006
@@ -1,333 +1,677 @@
<?xml version="1.0"?>
<document url="release-notes-1.0-b2.html">
- <properties>
- <title>Struts Release Notes (Version 1.0-beta-2)</title>
- </properties>
-
- <body>
-
- <section name="Introduction" href="Introduction">
-
- <p>This document contains the release notes for
- <strong>Version 1.0-beta-2</strong> of the Struts Framework,
- and covers changes that have taken place since
- <a href="release-notes-1.0-b1.html">Version 1.0-beta-1</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>The build procedure for compiling the Struts source distribution
- has been revised, and now depends on having <strong>Ant 1.2</strong>
- (or later) installed, with the <code>$ANT_HOME/bin</code> directory
- on your path. Further information can be found in the
- <a href="installation.html">Installation</a> documentation.</p>
-
- <p>The following new features have been added to the basic controller
- framework (package <code>org.apache.struts.action</code>):</p>
- <ul>
- <li>You can now specify that an <code><action></code> element should
- invoke an existing servlet or JSP page resource, rather than calling an
- <code>Action</code> class, by using the <code>include</code> attribute
- rather than the <code>type</code> attribute. The standard form bean
- processing provided by the controller is still performed first, if you
- have configured it, so the included resource can benefit from this
- processing if it wishes to.</li>
- <li>The <code>initDataSources()</code> method can now throw a
- <code>ServletException</code> to report that an initialization error
- has occurred. Previously, such errors were logged but otherwise
- ignored.</li>
- <li>It is now possible to integrate business logic that is already
- encapsulated as a servlet or JSP page, via use of two new standard
- actions: <code>org.apache.struts.actions.ForwardAction</code> and
- <code>org.apache.struts.actions.IncludeAction</code>. These actions
- let you take advantage of the standard processing performed by the
- controller servlet (including form bean population and calling the
- <code>validate()</code> method), but not have to write Java code to
- perform (or wrap) the required business logic.</li>
- <li>A wrapper class has been added around the standard
- <code>HttpServletRequest</code> for handling multipart requests as
- identically as possible to standard requests, including processing
- request parameters, populating form beans, transaction tokens, and
- checking for cancellations.</li>
- </ul>
-
- <p>The following new features have been added to the utility classes
- (package <code>org.apache.struts.util</code>):</p>
- <ul>
- <li><code>PropertyUtils</code> can now correctly locate public methods
- defined in a nested interface that is implemented by a bean.</li>
- <li><code>PropertyUtils</code> methods now throw
- <code>IllegalArgumentException</code> when you pass a null
- <code>bean</code> reference or property <code>name</code>.</li>
- <li><strong>DEPRECATIONS</strong> - The following classes have been
- deprecated in their entirety, because they will be replaced by
- corresponding classes (with identical functionality) from the
- <a href="http://jakarta.apache.org/commons">Jakarta Commons Project</a>
- at some point after Struts 1.0 final release. The only change that
- will ultimately be required in user code is to change the package
- names on the <code>import</code> clauses:
- <ul>
- <li><code>org.apache.struts.util.FastArrayList</code></li>
- <li><code>org.apache.struts.util.FastHashMap</code></li>
- <li><code>org.apache.struts.util.FastTreeMap</code></li>
- <li><code>org.apache.struts.util.BeanUtils</code></li>
- <li><code>org.apache.struts.util.ConvertUtils</code></li>
- <li><code>org.apache.struts.util.PropertyUtils</code></li>
- </ul></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>The <code><html:link></code> tag now accepts an optional
- <code>anchor</code> attribute, to allow the inclusion of a
- (possibly calculated) anchor ("#xxx") in the generated hyperlink.</li>
- <li>The <code><html:base></code> tag now accepts an optional
- <code>target</code> attribute.</li>
- <li>The <code><html:image></code> tag now accepts an optional
- <code>border</code> attribute, to define the border with around
- this image.</li>
- <li>You can now request that the <code><html:link></code> tag
- include any current transaction control token in the generated
- hyperlink, by specifying the <code>transaction</code> attribute
- with a value of <code>true</code>.</li>
- <li>The <code><html:options></code> tag now supports Enumeration
- for the <code>collection</code> property.</li>
- <li>The <code><html:form></code> tag now creates attributes for
- the tag itself, and the form bean, in request scope instead of
- page scope. Among other benefits, this allows you to nest the
- fields of a form inside a separate page that is accessed via a
- template or a <code><jsp:include></code> tag.</li>
- <li>The <code>styleId</code> attribute has been added to all of the
- tags where the corresponding <code>id</code> tag is relevant, to
- identify a specific tag for the purposes of stylesheet references.</li>
- <li>The <code><html:file></code> tag now supports the
- <code>size</code> attribute to set the size of the file list
- field.</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>
- <li>The <code><logic:iterate></code> tag now supports Enumeration
- for the <code>collection</code> property.</li>
- <li>The <code><logic:iterate></code> tag now exposes the current
- iteration index to nested tags, through a call to the
- <code>getIndex()</code> method.</li>
- </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>
- <li>Attribute getter methods have been added to all of the custom
- tag implementation classes to facilitate reuse.</li>
- <li>The <code><template:get></code> tag now has an optional
- "flush" attribute that causes the response to be committed prior
- to performing the include, if set to "true". This allows working
- around problems on broken servlet containers.</li>
- </ul>
-
- <p>The following new features have been added to the Struts Documentation
- application (and corresponding contents on the Struts web site):</p>
- <ul>
- <li>Platform specific installation notes for a wide variety of application
- server and servlet container environments have been accumulated and
- published.</li>
- </ul>
-
- </section>
-
-
- <section name="Changes and Bug Fixes" href="Changes">
-
- <p>The following changes and bug fixes have occurred in the basic
- controller framework (package <code>org.apache.struts.action</code>):</p>
- <ul>
- <li><code>DiskMultipartRequestHandler</code> now tries to retrieve the
- temporary directory provided by the servlet container before all other
- possible temporary directories.</li>
- </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>computeURL()</code> method now returns a
- <code>MalformedURLException</code> if a URL cannot be created.
- Previously, this case returned <code>null</code> with no error
- message, making some problems difficult to track down.</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>The <code><html:image></code> tag now correctly generates a
- closing double quote on the <code>name</code> attribute.</li>
- <li>The <code><html:form></code> tag now generates a hyperlink
- that includes any query parameters that were included in the original
- hyperlink value.</li>
- <li>The <code><html:link></code> tag now correctly places any
- specified anchor ("#xxx") in the generated hyperlink.</li>
- <li>The JavaScript code generated to implement the <code>focus</code>
- attribute of the <code><html:form></code> tag now works even
- when you use nested or indexed property expressions. Previously,
- this would generate an invalid JavaScript reference to the field.</li>
- <li>The <code><html:checkbox></code> tag now conforms to its
- documentation, and sends the specified <code>value</code> to the
- server if this checkbox is checked at submit time. In addition, a
- default value of <code>on</code> is sent if no value attribute is
- specified.</li>
- <li>The hyperlinks created by the <code><html:link></code> and
- <code><html:redirect></code> tags now properly omit the port
- number if it is the default port for the current request scheme (80
- for http, or 443 for https). Among other things, this corrects
- session management behavior on the standard port numbers.</li>
- <li>The <code>focus</code> attribute of the <code><html:form></code>
- tag now works when the corresponding input field is a radio button,
- or is otherwise indexed.</li>
- <li>The <code>disabled</code> and <code>readonly</code> attributes have
- been added to all HTML-rendering tags where they are relevant.</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>
- <li>Hyperlink processing in the <code><logic:forward></code>
- tag is now identical to that performed by the Struts Controller
- Servlet when it processes an <code>ActionForward</code> that is
- returned by an <code>Action</code>.</li>
- </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>The Java types of collections (and arrays) over which the
- <code><logic:iterate></code> tag can run are now documented.</li>
- <li>The <code><bean:define></code> documentation now mentions the
- JSP 1.1 Specification restriction on using more than one
- <code>id</code> attribute with the same value in the same page.</li>
- </ul>
-
- <p>The following changes and bug fixes to the Struts Example Application
- have occurred:</p>
- <ul>
- <li>The Java source code of these applications is now included in the
- corresponding WAR files, in subdirectory <code>WEB-INF/src</code>.</li>
- <li>Excessive filter() calls in <code>LinkSubscriptionTag</code>
- have been eliminated.</li>
- <li>Calls to the deprecated <code>BeanUtils.filter()</code> have been
- replaced by calls to <code>ResponseUtils.filter()</code>.</li>
- <li>Removed any attempt to save the pseudo-database at application
- shutdown, because there is no portable mechanism to accomplish
- this task.</li>
- </ul>
-
- <p>The following changes and bug fixes to the Struts Template Example
- Application have occurred:</p>
- <ul>
- <li>Refactored the example pages to eliminate the creation of redundant
- <code><html></code>, <code><head></code>, and
- <code><body></code> tags.</li>
- <li>If <code><template:get></code> or
- <code><template:insert></code> throws an exception, do not
- overwrite any "real" exception that has already been saved.</li>
- <li>The text of the various pages in the example has been updated so
- that they are not identical.</li>
- </ul>
+ <properties>
+ <title>Struts Release Notes (Version 1.0-beta-2)</title>
+ </properties>
+
+ <body>
+
+ <section name="Introduction" href="Introduction">
+
+ <p>This document contains the release notes for
+ <strong>Version 1.0-beta-2</strong>
+ of the Struts Framework,
+ and covers changes that have taken place since
+ <a href="release-notes-1.0-b1.html">Version 1.0-beta-1</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>The build procedure for compiling the Struts source
+ distribution
+ has been revised, and now depends on having
+ <strong>Ant 1.2</strong>
+ (or later) installed, with the
+ <code>$ANT_HOME/bin</code>
+ directory
+ on your path. Further information can be found in the
+ <a href="installation.html">Installation</a>
+ documentation.
+ </p>
+
+ <p>The following new features have been added to the basic
+ controller
+ framework (package
+ <code>org.apache.struts.action</code>
+ ):
+ </p>
+ <ul>
+ <li>You can now specify that an
+ <code><action></code>
+ element should
+ invoke an existing servlet or JSP page resource, rather
+ than calling an
+ <code>Action</code>
+ class, by using the
+ <code>include</code>
+ attribute
+ rather than the
+ <code>type</code>
+ attribute. The standard form bean
+ processing provided by the controller is still performed
+ first, if you
+ have configured it, so the included resource can benefit
+ from this
+ processing if it wishes to.
+ </li>
+ <li>The
+ <code>initDataSources()</code>
+ method can now throw a
+ <code>ServletException</code>
+ to report that an initialization error
+ has occurred. Previously, such errors were logged but
+ otherwise
+ ignored.
+ </li>
+ <li>It is now possible to integrate business logic that is
+ already
+ encapsulated as a servlet or JSP page, via use of two new
+ standard
+ actions:
+ <code>org.apache.struts.actions.ForwardAction</code>
+ and
+ <code>org.apache.struts.actions.IncludeAction</code>
+ . These actions
+ let you take advantage of the standard processing
+ performed by the
+ controller servlet (including form bean population and
+ calling the
+ <code>validate()</code>
+ method), but not have to write Java code to
+ perform (or wrap) the required business logic.
+ </li>
+ <li>A wrapper class has been added around the standard
+ <code>HttpServletRequest</code>
+ for handling multipart requests as
+ identically as possible to standard requests, including
+ processing
+ request parameters, populating form beans, transaction
+ tokens, and
+ checking for cancellations.
+ </li>
+ </ul>
+
+ <p>The following new features have been added to the utility
+ classes
+ (package
+ <code>org.apache.struts.util</code>
+ ):
+ </p>
+ <ul>
+ <li>
+ <code>PropertyUtils</code>
+ can now correctly locate public methods
+ defined in a nested interface that is implemented by a
+ bean.
+ </li>
+ <li>
+ <code>PropertyUtils</code>
+ methods now throw
+ <code>IllegalArgumentException</code>
+ when you pass a null
+ <code>bean</code>
+ reference or property
+ <code>name</code>
+ .
+ </li>
+ <li>
+ <strong>DEPRECATIONS</strong>
+ - The following classes have been
+ deprecated in their entirety, because they will be
+ replaced by
+ corresponding classes (with identical functionality) from
+ the
+ <a href="http://jakarta.apache.org/commons">Jakarta
+ Commons Project</a>
+ at some point after Struts 1.0 final release. The only
+ change that
+ will ultimately be required in user code is to change the
+ package
+ names on the
+ <code>import</code>
+ clauses:
+ <ul>
+ <li>
+ <code>org.apache.struts.util.FastArrayList</code>
+ </li>
+ <li>
+ <code>org.apache.struts.util.FastHashMap</code>
+ </li>
+ <li>
+ <code>org.apache.struts.util.FastTreeMap</code>
+ </li>
+ <li>
+ <code>org.apache.struts.util.BeanUtils</code>
+ </li>
+ <li>
+ <code>org.apache.struts.util.ConvertUtils</code>
+ </li>
+ <li>
+ <code>org.apache.struts.util.PropertyUtils</code>
+ </li>
+ </ul>
+ </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>The
+ <code><html:link></code>
+ tag now accepts an optional
+ <code>anchor</code>
+ attribute, to allow the inclusion of a
+ (possibly calculated) anchor ("#xxx") in the generated
+ hyperlink.
+ </li>
+ <li>The
+ <code><html:base></code>
+ tag now accepts an optional
+ <code>target</code>
+ attribute.
+ </li>
+ <li>The
+ <code><html:image></code>
+ tag now accepts an optional
+ <code>border</code>
+ attribute, to define the border with around
+ this image.
+ </li>
+ <li>You can now request that the
+ <code><html:link></code>
+ tag
+ include any current transaction control token in the
+ generated
+ hyperlink, by specifying the
+ <code>transaction</code>
+ attribute
+ with a value of
+ <code>true</code>
+ .
+ </li>
+ <li>The
+ <code><html:options></code>
+ tag now supports Enumeration
+ for the
+ <code>collection</code>
+ property.
+ </li>
+ <li>The
+ <code><html:form></code>
+ tag now creates attributes for
+ the tag itself, and the form bean, in request scope
+ instead of
+ page scope. Among other benefits, this allows you to nest
+ the
+ fields of a form inside a separate page that is accessed
+ via a
+ template or a
+ <code><jsp:include></code>
+ tag.
+ </li>
+ <li>The
+ <code>styleId</code>
+ attribute has been added to all of the
+ tags where the corresponding
+ <code>id</code>
+ tag is relevant, to
+ identify a specific tag for the purposes of stylesheet
+ references.
+ </li>
+ <li>The
+ <code><html:file></code>
+ tag now supports the
+ <code>size</code>
+ attribute to set the size of the file list
+ field.
+ </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>
+ <li>The
+ <code><logic:iterate></code>
+ tag now supports Enumeration
+ for the
+ <code>collection</code>
+ property.
+ </li>
+ <li>The
+ <code><logic:iterate></code>
+ tag now exposes the current
+ iteration index to nested tags, through a call to the
+ <code>getIndex()</code>
+ method.
+ </li>
+ </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>
+ <li>Attribute getter methods have been added to all of the
+ custom
+ tag implementation classes to facilitate reuse.</li>
+ <li>The
+ <code><template:get></code>
+ tag now has an optional
+ "flush" attribute that causes the response to be committed
+ prior
+ to performing the include, if set to "true". This allows
+ working
+ around problems on broken servlet containers.
+ </li>
+ </ul>
+
+ <p>The following new features have been added to the Struts
+ Documentation
+ application (and corresponding contents on the Struts web
+ site):</p>
+ <ul>
+ <li>Platform specific installation notes for a wide variety of
+ application
+ server and servlet container environments have been
+ accumulated and
+ published.</li>
+ </ul>
+
+ </section>
+
+
+ <section name="Changes and Bug Fixes" href="Changes">
+
+ <p>The following changes and bug fixes have occurred in the basic
+ controller framework (package
+ <code>org.apache.struts.action</code>
+ ):
+ </p>
+ <ul>
+ <li>
+ <code>DiskMultipartRequestHandler</code>
+ now tries to retrieve the
+ temporary directory provided by the servlet container
+ before all other
+ possible temporary directories.
+ </li>
+ </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>computeURL()</code>
+ method now returns a
+ <code>MalformedURLException</code>
+ if a URL cannot be created.
+ Previously, this case returned
+ <code>null</code>
+ with no error
+ message, making some problems difficult to track down.
+ </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>The
+ <code><html:image></code>
+ tag now correctly generates a
+ closing double quote on the
+ <code>name</code>
+ attribute.
+ </li>
+ <li>The
+ <code><html:form></code>
+ tag now generates a hyperlink
+ that includes any query parameters that were included in
+ the original
+ hyperlink value.
+ </li>
+ <li>The
+ <code><html:link></code>
+ tag now correctly places any
+ specified anchor ("#xxx") in the generated hyperlink.
+ </li>
+ <li>The JavaScript code generated to implement the
+ <code>focus</code>
+ attribute of the
+ <code><html:form></code>
+ tag now works even
+ when you use nested or indexed property expressions.
+ Previously,
+ this would generate an invalid JavaScript reference to the
+ field.
+ </li>
+ <li>The
+ <code><html:checkbox></code>
+ tag now conforms to its
+ documentation, and sends the specified
+ <code>value</code>
+ to the
+ server if this checkbox is checked at submit time. In
+ addition, a
+ default value of
+ <code>on</code>
+ is sent if no value attribute is
+ specified.
+ </li>
+ <li>The hyperlinks created by the
+ <code><html:link></code>
+ and
+ <code><html:redirect></code>
+ tags now properly omit the port
+ number if it is the default port for the current request
+ scheme (80
+ for http, or 443 for https). Among other things, this
+ corrects
+ session management behavior on the standard port numbers.
+ </li>
+ <li>The
+ <code>focus</code>
+ attribute of the
+ <code><html:form></code>
+ tag now works when the corresponding input field is a
+ radio button,
+ or is otherwise indexed.
+ </li>
+ <li>The
+ <code>disabled</code>
+ and
+ <code>readonly</code>
+ attributes have
+ been added to all HTML-rendering tags where they are
+ relevant.
+ </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>
+ <li>Hyperlink processing in the
+ <code><logic:forward></code>
+ tag is now identical to that performed by the Struts
+ Controller
+ Servlet when it processes an
+ <code>ActionForward</code>
+ that is
+ returned by an
+ <code>Action</code>
+ .
+ </li>
+ </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>The Java types of collections (and arrays) over which the
+ <code><logic:iterate></code>
+ tag can run are now documented.
+ </li>
+ <li>The
+ <code><bean:define></code>
+ documentation now mentions the
+ JSP 1.1 Specification restriction on using more than one
+ <code>id</code>
+ attribute with the same value in the same page.
+ </li>
+ </ul>
+
+ <p>The following changes and bug fixes to the Struts Example
+ Application
+ have occurred:</p>
+ <ul>
+ <li>The Java source code of these applications is now included
+ in the
+ corresponding WAR files, in subdirectory
+ <code>WEB-INF/src</code>
+ .
+ </li>
+ <li>Excessive filter() calls in
+ <code>LinkSubscriptionTag</code>
+ have been eliminated.
+ </li>
+ <li>Calls to the deprecated
+ <code>BeanUtils.filter()</code>
+ have been
+ replaced by calls to
+ <code>ResponseUtils.filter()</code>
+ .
+ </li>
+ <li>Removed any attempt to save the pseudo-database at
+ application
+ shutdown, because there is no portable mechanism to
+ accomplish
+ this task.</li>
+ </ul>
+
+ <p>The following changes and bug fixes to the Struts Template
+ Example
+ Application have occurred:</p>
+ <ul>
+ <li>Refactored the example pages to eliminate the creation of
+ redundant
+ <code><html></code>
+ ,
+ <code><head></code>
+ , and
+ <code><body></code>
+ tags.
+ </li>
+ <li>If
+ <code><template:get></code>
+ or
+ <code><template:insert></code>
+ throws an exception, do not
+ overwrite any "real" exception that has already been
+ saved.
+ </li>
+ <li>The text of the various pages in the example has been
+ updated so
+ that they are not identical.</li>
+ </ul>
- </section>
+ </section>
- </body>
+ </body>
</document>
Modified: struts/action/trunk/xdocs/userGuide/release-notes-1.0-b3.xml
URL: http://svn.apache.org/viewcvs/struts/action/trunk/xdocs/userGuide/release-notes-1.0-b3.xml?rev=370938&r1=370937&r2=370938&view=diff
==============================================================================
--- struts/action/trunk/xdocs/userGuide/release-notes-1.0-b3.xml (original)
+++ struts/action/trunk/xdocs/userGuide/release-notes-1.0-b3.xml Fri Jan 20 16:19:02 2006
@@ -1,259 +1,488 @@
<?xml version="1.0"?>
<document url="release-notes-1.0-b3.html">
- <properties>
- <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>
-
- <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>
-
-
- </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>
-
-
- <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>
+ <properties>
+ <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>
+
+ <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>
+
+
+ </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>
+
+
+ <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>
- <p>The following changes and bug fixes to the Struts Template Example
- Application have occurred:</p>
+ </section>
- </section>
-
-
- </body>
+ </body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org