release-notes-1.1.html

struts api,学习使用struts必备的文档

    <p>To build Struts from source Ant 1.4 or later is now required. This
    does not affect developers that use Struts from the binary distribution.</p>

    <p>
<strong>Struts Validator Integration</strong>
</p>
    <p>The new Commons Validator is now integrated with Struts and exposed
    through the new Validator package.</p>

    <p>
<strong>Tiles - An advanced templating taglib</strong>
</p>
    <p>The Tiles JSP assembly framework has been integrated with Struts.</p>

    <p>
<strong>Nested - An very cool taglib extension</strong>
</p>
    <p>The Nested taglib is bundled with Struts and enhances the functionality
     of the existing Struts tags.</p>

    <p>
<strong>New Example Applications</strong>
</p>
    <p>New example applications for the Validator and Tiles are now part
    of the Struts distribution.</p>

    <p>
<strong>New Contrib directory for optional components</strong>
</p>
    <p>A new directory (<code>contrib</code>) in the CVS source repository has
    been added to accumulate Struts add-on extensions that are generally
    useful but have not yet been integrated into the standard code base.</p>

    <ul>
    <li>Scaffold - An extension of the Commons Scaffold toolkit of reusable
    classes for building web applications.</li>
    <li>Struts-EL - The optional Struts-EL taglib makes it easy to use Struts
    with JSTL. (Container with Servlet 2.3 support required.)</li>
    </ul>

    <p>The source for these components is available in the Struts source
    distribution. Binary distributions may also be made available in the Struts
    download area. As optional components, these products have their own
    release cycles.</p>

    <p>
<strong>Action Package Additions</strong>
</p>
    <p>The following new features have been added to the basic controller
    framework [<code>org.apache.struts.action</code>]:</p>
    <ul>
    <li>The ActionServlet now provides support for modular Struts applications and
    sports several new extension points.</li>
    <li>The new <code>ActionMessages</code> class will support a superset of
        the capabilities of <code>ActionErrors</code>, and will be useful as
        a collection of general purpose messages, not just errors.</li>
    </ul>

    <p>
<strong>Upload Package Additions</strong>
</p>
    <p>The following new features have been added to the file upload classes
    [<code>org.apache.struts.upload</code>]:</p>
    <ul>
    <li>
<code>CommonsMultipartRequestHandler:</code> New class that implements
        file upload using the Jakarta Commons FileUpload package. This is now
        the default file upload implementation for Struts.</li>
    </ul>

    <p>
<strong>Util Package Additions</strong>
</p>
    <p>The following new features have been added to the utility classes
    [<code>org.apache.struts.util</code>]:</p>
    <ul>
    <li>
<code>LocalStrings:</code> Correct message regarding replaceable parameter so that it does not append an extraneous character.</li>
    <li>
<code>LabelValueBean:</code> New class that defines a collection of name/value pairs that can be used with the &lt;html:options&gt; and &lt;html:optionsCollection&gt; tags, and elsewhere.</li>
    <li>
<code>MessageResources:</code> Escape any single quote characters that are included in the specified message string.</li>
    <li>
<code>computeParameters:</code> Allow a transaction token to be the only parameter.</li>
    <li>
<code>RequestUtils:</code> Change to encode ampersands when building a query string.</li>
    </ul>

    <p>
<strong>Bean Taglib Package Additions</strong>
</p>
    <p>The following new features have been added to the
    <em>struts-bean</em> custom tag library
    [<code>org.apache.struts.taglib.bean</code>]:</p>
    <ul>
    <li>
<code>&lt;bean:write&gt;</code>: Add format, locale and bundle attributes to support formatting values according to current
    user locale, format string from attribute or format string from string resources.</li>
    <li>
<code>&lt;bean:cookie&gt;, &lt;bean:header&gt;, or &lt;bean:parameter&gt;:</code> Correct the generated scripting variable type when tag is used with the "multiple" attribute.</li>
    <li>
<code>&lt;bean:message&gt;:</code> Added <code>name</code>, <code>property</code>, and  <code>scope</code> attributes to the tag, so that the message source key can be obtained dynamically from a bean or bean property.</li>
    </ul>

    <p>
<strong>HTML Taglib Package Additions</strong>
</p>
    <p>The following new features have been added to the
    <em>struts-html</em> custom tag library [<code>org.apache.struts.taglib.html</code>]:</p>
    <ul>
    <li>
<code>&lt;html:link&gt;:</code> Added 'action' attribute.</li>
    <li>
<code>&lt;html:options&gt;:</code> If the property specified by the 'property' attribute returns null, tag now throws an error message that indicates what the real problem is, rather than causing an NPE.</li>
    <li>
<code>&lt;html:option&gt; and &lt;html:options&gt;:</code> Added 'style' and 'styleClass' attributes.</li>
    <li>
<code>&lt;html:optionsCollection&gt;:</code> New tag providing a cleaner way of populating HTML options from a collection.</li>
    <li>
<code>&lt;bean:message&gt;:</code> Added 'name', 'property' and 'scope' attributes so that the message resource key can be obtained dynamically from a bean.</li>
    <li>
<code>&lt;html:messages&gt;:</code> New tag to iterate through a message collection in the new <code>ActionMessages</code> class.</li>
    <li>
<code>ActionForm:</code> Tag will now call <code>reset()</code> if it instantiates the ActionForm bean. This also requires that the bean instantiated by the tag to be an <code>ActionForm</code> subclass. </li>
    <li>
<code>&lt;html:image&gt;:</code> Added the 'align' attribute.</li>
    <li>
<code>&lt;html:img&gt;:</code> Added the mouse event attributes ('onclick', 'ondblclick', 'onmousedown', 'onmouseup', 'onmouseover', 'onmousemove', 'onmouseout').</li>
    <li>
<code>SubmitTag, SelectTag, LinkTag.java, CheckboxTag, ButtonTag, ImageTag, RadioTag, and TextArea tags:</code> Added indexed property. </li>
    </ul>

    <p>
<strong>Logic Taglib Package Additions</strong>
</p>
    <p>The following new features have been added to the
    <em>struts-logic</em> custom tag library [<code>org.apache.struts.taglib.logic</code>]:</p>
    <ul>
    <li>
<code>&lt;logic:empty&gt;</code> and
        <code>&lt;logic:notEmpty&gt;</code>: New tags that are similar to
        <code>&lt;logic:present&gt;</code> and
        <code>&lt;logic:notPresent&gt;</code> except for the treatment of
        empty strings.</li>
    </ul>

    <p>
<strong>Template Taglib Package Additions</strong>
</p>
    <p>The following new features have been added to the
    <em>struts-template</em> custom tag library
    [<code>org.apache.struts.taglib.template</code>]:</p>
    <ul>
    <li>None.</li>
    </ul>

    <p>
<strong>Documentation Additions</strong>
</p>
    <p>The following new features have been added to the Struts Documentation
    application (and corresponding contents on the Struts web site):</p>
    <ul>
    <li>Version Differences: New section in Release Notes to link to the JavaDocs for all Struts classes and members added or changed between versions.</li>
    <li>FAQ/HowTos: New documentation category organizes our FAQs and example-driven howTos.
    New HowTos include "Building Applications", "Using SSL", and using Struts with Eclipse or NetBeans.</li>
    <li>User Guide Preface: New section to overview the enabling technologies behind Struts.</li>
    <li>Developer Guides: Added "cover page" to guides. These then link to the Package Descriptions and the API guides.</li>
    <li>HTML tag documentation: expanded to cover using indexed properties with iterate.</li>
    <li>Site Menu: Removed separate links to taglib documentation, since these are now in the Developer Guide.</li>
    <li>Newbie FAQ: The questions most likely to be asked by new developers using Struts. Still under development.</li>
    <li>Kickstart FAQ: The questions most likely to be asked when selecting Struts.</li>
    <li>1.0.2 JavaDoc: Added archival copy to web site for future reference.</li>
    <li>The UserGuide "Building" pages: General revisions to reflect new features and current practices.</li>
    <li>Installation: Updated instructions for SilverStream and Resin. Add installation notes for Jetty. Added RexIP to list of nominal containers.</li>
    <li>JavaDocs: New <code>@since Struts 1.1</code> tag to indicate new packages, classes, and members added after the Struts 1.0.x version</li>
    </ul>

  </div>
<h2 id="Changes">Operational Changes and Bug Fixes</h2>
<div class="indent">

    <p>
<strong>Struts Configuration Changes</strong>
</p>
    <p>The following changes and bug fixes have occurred in the configuration
    files related to Struts:</p>
    <ul>
    <li>Deprecated (Struts 0.5) configuration file format: Remove support.</li>
    <li>Deprecated (Struts 0.5) methods: Remove from codebase.</li>
    </ul>
    <p>
<strong>Added Config Package</strong>
</p>
    <ul>
    <li>ControllerConfig: Added inputForward property to indicate that ActionMapping.input is a forward rather than a URI.</li>
    <li>ControllerConfig: Added forwardPattern and inputPattern to help manage page directories in application modules.</li>
    <li>Added package to provide more flexibility in configuring the controller and to provide support for modular applications</li>
    </ul>
    <p>
<strong>Action Package Changes</strong>
</p>
    <p>The following changes and bug fixes have occurred in the basic
    controller framework (package <code>org.apache.struts.action</code>):</p>
    <ul>
    <li>All constants in the Action class: Deprecated in favor of equivalents in new Globals class.</li>
    <li>ActionMapping: input property may now refer to an ActionForward rather than a module-relative path if inputForward is set to true on the module's ControllerConfig bean [org.apache.struts.config.ControllerConfig.</li>
    <li>ActionServlet: Added convertNull parameter to simulate the Struts 1.0 behavior when populating forms. If set to true, the numeric Java wrapper class types (like java.lang.Integer) will default to null (rather than 0).</li>
    <li>ActionServlet: Added "config/$foo" parameter and deprecated several others in favor of components in the new config package. </li>
    <li>ActionForms and related classes: Now use a StringBuffer when responding to a toString request in order to conserve resources.</li>
    <li>LookupDispatchAction: Added standard Action to help select between internationalized buttons.</li>
    <li>ActionForm class: Modified to use ActionServletWrapper rather than expose ActionServlet.</li>
    <li>ActionServletWrapper class: Added for use by ActionForm to prevent the Public String properties of ActionServlet from being changed via a query string.</li>
    <li>Action.MAPPING_KEY request attribute: Unconditionally pass the selected mapping as a request attribute ("org.apache.struts.action.mapping.instance") even if no form bean is specified.</li>
    <li>ActionServlet: Avoid a NullPointerException in corner cases caused by failed initialization of servlet.</li>
    <li>ActionForm class: Now truly serializable, because
        the two non-serializable instance variables (servlet and
        multipartRequestHandler) have been made transient.  However, if you
        actually do serialize and deserialize such instances, it is your
        responsibility to reset these two properties.</li>
    <li>ActionMessages and ActionErrors: The initial order a property/key is added in is now retained.</li>
    <li>processActionForward(): Deprecated in favor of processForwardConfig</li>
    </ul>

    <p>
<strong>Upload Package Changes</strong>
</p>
    <p>The following changes and bug fixes have occurred in the file upload
    package (package <code>org.apache.struts.upload</code>) [part of the Upload webapp]:</p>
    <ul>
    <li>CommonsMultipartRequestHandler: New implementation of file upload based
        on the Jakarta Commons FileUpload package. This new implementation is
        now the default.</li>
    <li>BufferedMultipartInputStream: Fixed lost byte problem.</li>
    <li>ArrayIndexOutOfBoundsException: Fixed situations where this was known to occur.</li>
    <li>Multipart requests: Better reporting for premature closing of input streams while reading multipart requests.</li>
    <li>New line characters: Additional fix for file corruption problem with uploads and new line characters.</li>
    </ul>

    <p>
<strong>Utility Package Changes</strong>
</p>
    <p>The following changes and bug fixes have occurred in the utilities
    (package <code>org.apache.struts.util</code>):</p>
    <ul>
    <li>RequestUtils: Added support for forwardPattern, pagePattern, and inputForward properties on ControllerConfig.</li>
    <li>GenericDataSource: Deprecated and modified to act as a thin wrapper around
    [<code>org.apache.commons.dbpc.BasicDataSource</code>].
    Replaced by direct use of BasicDataSource or other compatible component.</li>
    <li>RequestUtils class: Modify to use ActionServletWrapper rather than expose ActionServlet.</li>
    <li>Added error message for the getActionErrors and getActionMessages method.</li>
    <li>getActionErrors and getActionMessages: Added methods to generate the correct corresponding
    object based on the object retrieved from request scope based on the key passed in.</li>
    <li>ActionErrors or ActionMessages: The logic for creating one of these objects has been moved
    to a utility method in RequestUtils.</li>
    <li>JspException message: Now generated in RequestUtils.</li>
    <li>ConvertUtils.convertCharacter(): Will now detect empty strings and return the default value.</li>
    </ul>

    <p>
<strong>Bean Taglib Package Changes</strong>
</p>
    <p>The following changes and bug fixes have occurred in the
    <em>struts-bean</em> custom tag library
    [<code>org.apache.struts.taglib.bean</code>]:</p>
    <ul>
    <li>&lt;html:errors&gt;: When the property tag is
    specified, errors are no longer printed if the specified property
    has no errors. Previously errors were always printed ! Future
    enhancements would include additional attributes to always turn
    off the header or footer. </li>
    <li>Made the remaining helper methods "protected" rather than
    "private".</li>
    </ul>

    <p>
<strong>HTML Taglib Package Changes</strong>
</p>
    <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>FormTag: Fixed to exclude query string when identifying action mapping name.</li>
    <li>ImgTag: Correctly URLEncode the query string parameter value even if there is only a single parameter.</li>
    <li>MultiboxTag.doAfterBody(): Corrected to return SKIP_BODY instead of SKIP_PAGE.</li>
    <li>Errortag: defaultLocale method is deprecated as it is unused.</li>
    </ul>

    <p>
<strong>Logic Taglib Package Changes</strong>
</p>
    <p>The following changes and bug fixes have occurred in the
    <em>struts-logic</em> custom tag library (package
    <code>org.apache.struts.taglib.logic</code>):</p>
    <ul>
    <li>None.</li>
    </ul>

    <p>
<strong>Documentation Application Changes</strong>
</p>