release-notes-1.1.html

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

        <li>
          Fixed #17833 - validateShort and isAllDigits for negative numbers.
        </li>
        <li>
          Fixed #17328 - Synchronized loadLocale.
        </li>
        <li>
          Fixed #18018 - Changed field-* variables to camel case and no "-".
        </li>
        <li>
          Fixed #16548 - validateMinLength and validateMaxLength are now independent of the required check.
        </li>
        <li>
         Fixed #17389 - Splice in the I18nFactorySet.calculatePostixes from the attachment, rebuild, and ran the unit tests successfully.
        </li>
        <li>
         Fixed #17273 - Removed extra return statement (RequestUtils).
        </li>
        <li>
         Fixed #17592 - Tag should support a "naked" collection that is not a property of a bean.
        </li>
        <li>
         Fixed #17592 - Made "property" attribute of "optionsCollection" tag be not required, to match same change made for #17592 in base tag.
        </li>
        <li>
         Fixed #17562 - Change the InsertTag to let it use PageContext.include() instead of RequestDispatcher.include(). We are no back to the same mechanism used in the 1.1b3 release.
        </li>
        <li>
         Fixed #18186 - Use temp variable instead of overwriting tag attribute variable.
        </li>
        <li>
         Fixed #18394 - Changed error to info log if DefinitionsFactory is not supplied.
        </li>
        <li>
         Fixed #18538 - Changed shortname to "tiles".
        </li>
        <li>
         Fixed #18591 - Braces placement in message().
        </li>
        <li>
         Fixed #18018 - Don't output requiredif field* javascript variables because they're not used and break other validations.
        </li>
        <li>
         Fixed #18794 -Check ServletContext for ModuleConfig instead of request.
        </li>
        <li>
         Fixed #18864 - Changed Class-Path to conform to jar spec.  The previous patch fixing a bug in  WebLogic caused warnings in Resin.
        </li>
        <li>
         Fixed #18991 - Allow messages object passed to add(ActionMessages) to be null.
        </li>
        <li>
         Fixed #19040 -  Added null checks back to ActionServlet.
        </li>
        <li>
         Fixed #19157 - Implement Serializable in NestedReference.
        </li>
        <li>
         Fixed #18869 - Added display-name to web.xml files.
        </li>
        <li>
        Fixed #19223 - Synchronized token methods for PR.  Post 1.1 these methods should be moved to some kind of TokenProcessor class for reusability by other components such as the RequestProcessor (#16743).
        </li>
        <li>
         Fixed #19236 -  Added "action" attribute to "html-el:frame" tag.
        </li>
        <li>
         Fixed #11932 - Factored common code out of message() and present() into a new private method retrieveMessageResources.
        </li>
        <li>
         Fixed #11922 - Moved Action's token methods to this new class to fix synchronization issues and allow Action to be more focused.
        </li>
        <li>
         Fixed #19594 - Fixed minlength javascript for PR.  Also, removed password field checking from validateMask.
        </li>
        <li>
        Fixed #19773 - EmptyTag and added test to exercise-taglib webapp.
        </li>
        <li>
        Fixed #19835 - Add check against -1 to maxSize.
        </li>
        <li>
        Fixed #20034 - Call releaseInternal() in release() so if error occurs between begin/end of tag next user/request will not be working with old parameters.
        </li>
        <li>
        Fixed #20455 - validateRequiredIf() fails on Strings of whitespace.
        </li>
        <li>
        Fixed #20678 - Struts data-souce pingQuery parameter
        </li>
        <li>
        Fixed #20750 - RequestUtils.retrieveMessageResources (really an RC2 bug)
        </li>
        <li>
        Fixed #20835 - &lt;html:rewrite&gt; tag using page attribute bug
        </li>
        <li>
        Fixed #20877 - MessagesTag has incorrect assignment in release()
        </li>
        <li>
        Fixed #20949 - Tag &lt;html:select&gt; doesn't work well on RC2
        </li>
        <li>
        Fixed #21051 - javascript required validator accepts fields containing only whitespace
        </li>
        <li>
        Fixed #21119 - typo in struts-doc-config.xml
        </li>
    </ul>


</div>
<h2 id="Introduction">Introduction</h2>
<div class="indent">

    <p>The remainder of this document contains the release notes for
    <strong>1.1 Release Candidate 2</strong> build of the Struts Framework,
    and covers changes that have taken place since
    <a href="release-notes-1.0.2.html">Version 1.0.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:</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>commons-*.jar</code> - Release packages from the
            <a href="http://jakarta.apache.org/commons/">Jakarta Commons
            Project</a> that Struts relies on.  You are welcome to use these
            classes in your own applications.  These JAR files should be
            copied into the <code>/WEB-INF/lib</code> directory of
            your web application. See below for the version of each
            Commons library that is included.</li>
        <li>
<code>struts.jar</code> - JAR file that contains the compiled
            Java classes of Struts.  You must
            place this file in the <code>/WEB-INF/lib</code> directory of
            your web application.</li>
        <li>
<code>struts-xxxxx.tld</code> - The tag library descriptor files
            for the Struts 1.1 tag libraries (bean, html, 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>&lt;taglib&gt;</code> directives in your
            web.xml file.</li>
        <li>
<code>jdbc2_0-stdext.jar</code> - The JDBC 2.0 Optional Package
            API classes (package <code>javax.sql</code>).  You will need to
            include this file in the <code>/WEB-INF/lib</code> directory
            of your application, if it is not already made visible to web
            applications by your servlet container.</li>
        <li>
<code>struts-config_1_1.dtd</code> - The Document Type Definition
            (DTD) for the Struts 1.1 configuration file (which is typically named
            <code>/WEB-INF/struts-config.xml</code>).  Your configuration file
            will be validated against an internal copy of this DTD -- this
            copy is available for reference purposes only.</li>
        <li>
<code>struts-config_1_0.dtd</code> - The Document Type Definition
            (DTD) for the Struts 1.0 configuration file (which is typically named
            <code>/WEB-INF/struts-config.xml</code>).  Your configuration file
            will be validated against an internal copy of this DTD -- this
            copy is available for reference purposes only.</li>
        <li>
<code>web-app_2_2.dtd</code> - The Document Type Definition (DTD)
            for web.xml files conforming to the Servlet 2.2 specification.
            This copy is for reference purposes only.</li>
        <li>
<code>web-app_2_3.dtd</code> - The Document Type Definition (DTD)
            for web.xml files conforming to the Servlet 2.3 specification.
            This copy is for reference purposes only.</li>
        </ul>
</li>
    <li>
<code>webapps/</code> - Web Application Archive (WAR) files for the
        web applications that are included with Struts.</li>
    </ul>

    <p>The following Jakarta Commons libraries are included with this release
    of Struts:</p>
    <ul>
    <li>Commons BeanUtils 1.6.1</li>
    <li>Commons Collections 2.1</li>
    <li>Commons Digester 1.5</li>
    <li>Commons FileUpload 1.0</li>
    <li>Commons Lang 1.0.1</li>
    <li>Commons Logging 1.0.3</li>
    <li>Commons Validator 1.0.2</li>
    </ul>

  </div>
<h2 id="New">What's New?</h2>
<div class="indent">

    <p>Following are highlights of the new features. In the next section, we
    provide links to the JavaDocs for the affected classes.</p>

    <p>
<strong>New Configuration DTD</strong>
</p>
    <p> The Struts Configuration 1.0 DTD has been deprecated in favor of the
    <code>
<a href="http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">struts-config_1_1.dtd</a>
</code>.
    In the Struts 1.1 release, existing Struts configuration files can be
    loaded using either DTD version.
    </p>

    <p>
<strong>New Dependencies on Commons packages</strong>
</p>
    <p>Several components of Struts 1.0 have been found to be useful in
    general Java development (and not just useful for building Struts-based
    web applications), and have been migrated into the
    <a href="http://jakarta.apache.org/commons/">Jakarta Commons Project</a>.
    As a result, this release of Struts has been modified
    to rely on the Commons packages containing these classes, rather than the
    Struts internal versions.  In nearly every case, this involved changing
    only the <code>import</code> statements at the top of the classes.  Any
    of your applications that utilize these classes will need to be modified in
    the same way.  </p>
    <p>The following Commons packages contain the replacements for the
    corresponding Struts 1.0 classes:</p>
    <ul>
    <li>
<strong>BeanUtils Package</strong>
        [<a href="http://jakarta.apache.org/commons/beanutils.html">
<code>org.apache.commons.beanutils</code>
</a>] -
        <code>org.apache.struts.utils.BeanUtils</code>,
        <code>org.apache.struts.utils.ConvertUtils</code>, and
        <code>org.apache.struts.utils.PropertyUtils</code>.</li>
    <li>
<strong>Collections Package</strong>
        [<a href="http://jakarta.apache.org/commons/collections.html">
<code>org.apache.commons.collections</code>
</a>]  -
        <code>org.apache.struts.util.ArrayStack</code>,
        <code>org.apache.struts.util.FastArrayList</code>,
        <code>org.apache.struts.util.FastHashMap</code>,
        <code>org.apache.struts.util.FastTreeMap</code>.</li>
    <li>
<strong>Digester Package</strong> -
        [<a href="http://jakarta.apache.org/commons/digester.html">
<code>org.apache.commons.digester</code>
</a>] -
        <code>org.apache.struts.digester.*</code>.</li>
    </ul>
    <p>The following Commons packages are also now used by various components
    of the Struts framework:</p>
    <ul>
    <li>
<strong>FileUpload Package</strong>
    [<a href="http://jakarta.apache.org/commons/fileupload/">
<code>org.apache.commons.fileupload</code>
</a>]</li>
    <li>
<strong>Logging Package</strong>
    [<a href="http://jakarta.apache.org/commons/logging.html">
<code>org.apache.commons.logging</code>
</a>]</li>
    <li>
<strong>Validator Package</strong>
    [<a href="http://jakarta.apache.org/commons/validator/">
<code>org.apache.commons.validator</code>
</a>]</li>
    </ul>


    <p>
<strong>NOTE! XML Parser Prerequisite Updated</strong>
</p>

    <p>Struts now depends on an XML parser that conforms to the JAXP/1.1
    (rather than JAXP/1.0) APIs. Parsers known to work include the JAXP/1.1
    reference implementation, and Xerces 1.3.1.</p>

    <p>
<strong>SOURCE DEVELOPERS NOTE! Ant Prerequisite Updated</strong>
</p>