release-notes-1.2.4.html

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

        <ul>
          <li>ValidWhen - The Struts Validator now supports a ValidWhen rule, so that one validation can be dependant on another.
          <a href="dev_validator.html#validWhen">Details ...</a>
</li>
          <li>IntRange now checks select-one and radio fields. Example: This allows populating combo boxes with valid choices plus one additional choice with a caption something like "Choose one" and a value 0f "-1". Then when the user attempts to submit the form, you can look for the value of "-1" and advise if nothing was selected.</li>
          <li>You can now force the clientside Javascript validation to check all constraints, instead of stopping at the first error. By setting a new property,
          <code>stopOnFirstError</code>, on the Validator PlugIn to false.
          <a href="dev_validator.html#stopOnFirstError">Details ...</a>
</li>
          <li>The "required" validation can now handle checkboxes, radio,select-one, and select-multiple field types. See the updated Validator example application to see these new features in action.</li>
          <li>A standard
          <code>validateUrl</code> rule lets you check if a property contains a well-formed URL.</li>
        </ul>
        <p>
        <strong>DigestingPlugIn</strong> - A new standard PlugIn that helps you create your own object graph in application scope. This is handy way to create business objects for Actions to call. Check the latest MailReader eaxmple application to see the DigestingPlugin in action.</p>
        <p>
        <strong>ModuleConfigVerifier</strong> - While not exactly new, a standard class for verifying module configurations is also available in the PlugIn packages. As it stands, the
        <code>ModuleConfigVerifier</code> mainly confirms that various components of the Struts object graph were loaded. However, ambitious developers could extend this class with additional checks to ensure the Struts configuration is internally consistent.</p>
        <p>
        <strong>Maven project files</strong> - While still under development, significant progress has been made toward putting the Struts build process under
        <a href="http://maven.apache.org">Maven</a>. The core JAR and TLDs can be built using Maven, leveraging the shared Maven repository for our many dependencies. You can find the current maven.xml and project.xml in the root directory of the Struts source distribution. However, at this time, the original Ant build files are still the official mechanism for building Struts.</p>
        <p>
        <strong>New Configuration DTD</strong> - The
        <code>
          <a href="http://struts.apache.org/dtds/struts-config_1_2.dtd">struts-config_1_2.dtd</a>
        </code> is preferred to the deprecated Struts Configuration 1.1 DTD. The new DTD adds two new elements &lt;display-name&gt; and &lt;description&gt; to the struts-config element. These elements are for use by struts config file tools and document generation. In the Struts 1.2.x series, existing Struts configuration files can be loaded using either DTD version.</p>
        <p>
        <strong>New Taglib URIs</strong> - The URIs for the tag libraries have been changed to reflect the move of Struts from Jakarta to an Apache top level project. For compatibility purposes, TLDs with the old URIs are still available, but users are encouraged to update their usage accordingly.</p>
        <p>
        <strong>New Committers</strong> - We are pleased to welcome Steve Raeburn, Don Brown, Joe Germuska and Niall Pemberton to the team of Struts Committers.</p>
        <p>
        <strong>Struts-Chain</strong> - Still experimental, this new "contrib" package utilizes the new Chain of Responsibilty package in the Jakarta Sandbox to create a new breed of RequestProcessor. Look for this to become the default implementation in a future release.</p>
        <p>
        <strong>MappingDispatchAction</strong> - A new standard Action that dispatches to a method named by the ActionMapping parameter.</p>
        <p>
        <strong>Cancel handlers</strong> - DispatchAction, LookupDispatchAction, and MappingDispatchAction - Now provide default cancel handler that can be overridden. It also also possible to specify the default handler name.</p>
        <p>
        <strong>Session-scoped ActionMessages</strong> - You can now save ActionMessages in the session and have them cleaned up after the first use. There is now an alternate form of Action.saveMessages() that stores messages in the session. ActionMessages.isAccessed() returns true after the messages have been retrieved one time. RequestProcessor.processCachedMessages() queries isAccessed() to determine if it should remove the messages from the session.</p>
        <p>
        <strong>JA Mailreader</strong> - The Struts Mailreader Example application now includes a Japanese resource file.</p>
        <p>
        <strong>Tiles EL</strong> - The Tiles tags are now avaiable through the Struts EL taglib, which is based on JSTL.</p>
        <p>
        <strong>Wildcard Mappings</strong> - You can now use wildcards in your action-mappings. For details see
        <a href="building_controller.html#action_mapping_wildcards">Using Wildcards in ActionMappings</a> as well as the Struts Mailreader Example application.</p>
        <p>
         <strong>Action attributes</strong> - An Action attribute has been added to the html img tag, to match what's available on the html link tag now.
         </p>
        <p>
       <strong>Module attribute</strong> - A new "module" attribute is available on the forward element as well as several of the core tags. This attribute allows you to specify another module by name (or "prefix") to create direct links between modules. The new module attribute is preferered to the <code>contextRelative</code> attribute and can often be used in lieu of a "SwitchAction".
        </p>

      </div>
      <h2 id="Changes">What Changed?</h2>
<div class="indent">
        <p>This section highlights some of the changes that have taken place since the last release. Subscribers to the
        <a href="../using.html#Lists">struts-dev mailing list</a>, receive reports of all changes as they are made.</p>
        <p>
          <strong>General Changes</strong>
        </p>
        <ul>
          <li>2004-09-02 - URI for Struts DTD changed to reflect move to an Apache top level project.</li>
        </ul>
        <ul>
          <li>2004-08-31 - Code changes to re-enable building with JDK 1.3.</li>
        </ul>
        <ul>
          <li>2003-03-14 - Move license on all source code files to ASL 2.0.</li>
        </ul>
        <ul>
          <li>2003-12-30 - Add inital STATUS LOG.</li>
        </ul>
        <p>
          <strong>Build Changes</strong>
        </p>
        <ul>
            <li>
                2004-07-09: struts.xsl: Give each "src" variable a distinct name to follow XSL rules.
            </li>
            <li>
                2004-07-08: build.properties.sample.lib: Add a simplified build.properties file for use by developers who are not actively involved in Jakarta development. This template assumes the developer is using JARS from our "lib" distribution.
            </li>
        </ul>
        <ul>
         <li>2004-04-14 - project.properties: Adjust properties to use alternate repo for nightly builds.</li>
        </ul>
        <ul>
          <li>2003-08-09 - build.xml: Adjust loading order of properties files to go from most local (current directory) to most global (${user.home}/build.properties).</li>
          <li>2003-08-08 - maven.xml,project.xml - Maven build files.</li>
        </ul>
        <p>
        <strong>Configuration Changes</strong> [
        <code>/conf/shared</code>]</p>
        <ul>
          <li>2003-08-09 - Add two new elements &lt;description-short%gt; and &lt;description-long&gt; for use by struts config file tools and document generation.</li>
        </ul>
        <ul>
          <li>2003-07-04 - struts-config_1_2.dtd: Added 1.2 struts-config.dtd. This is a copy of the 1.1 DTD except that the &lt;data-source&gt; "type" attribute is now required because Struts does not supply a default DataSource implementation.</li>
        </ul>
        <p>
        <strong>Project-wide Changes</strong>
        </p>
          <ul>
              <li>2004-01-14 - Update License format to please Maven Checkstyle reports.</li>
              <li>2004-01-10 - Removed @author javadoc tags from all classes; updated volunteers.xml to list missing people.</li>
         </ul>
        <p>
        <strong>Default Package Changes</strong> [
        <code>org.apache.struts</code>]</p>
        <ul>
          <li>2003-07-04 - Globals: Removed deprecated APPLICATION_KEY.</li>
          <li>2003-07-03 - Globals,ActionServlet,RequestUtils: Moved initialization of module prefix list to the new ActionServlet.initModulePrefixes() method from RequestUtils.getModulePrefixes() because of a potential race condition documented in PR# 21091. This also required a move of the RequestUtils.PREFIXES constant to Globals.MODULE_PREFIXES_KEY.</li>
        </ul>
        <p>
        <strong>Action Package Changes</strong> [
        <code>org.apache.struts.action</code>]</p>
        <ul>
          <li>2004-09-10 - Corrected Japanese translation of message resources.</li>
          <li>2004-09-07 - Action: Use ActionMessages instead of ActionErrors.</li>
          <li>2004-09-03 - ActionServlet: Eliminate performance bottleneck in obtaining request processor.</li>
          <li>2004-09-03 - ActionForward: New copy constructor that takes module parameter; deprecate copy constructor missing this parameter.</li>
          <li>2004-09-02 - Correct javadoc for ActionErrors.</li>
        </ul>
        <ul>
          <li>2004-08-10 - DynaActionForm: Change Map's key from String to Object in toString().</li>
        </ul>
        <ul>
            <li>2004-07-01 - TestDynaActionFormClass: Correct operation of static method calls.</li>
        </ul>
        <ul>
           <li>2004-06-26 - Action: Add getErrors, getMessages, addErrors, and AddMessages methods, to better manage error handling. </li>
        </ul>
        <ul>
          <li>2004-04-01 - ActionConfigMatcher: Added support for multiple wildcard replacements.</li>
        </ul>
        <ul>
           <li>2004-03-16 - ActionForward: Add "copy constructor".</li>
        </ul>
        <ul>
          <li>2004-01-24 - DynaActionForm: Enhance so that it can be initialized using a FormBeanConfig object. Add corresponding method to RequestUtils to create an ActionForm by passing only a FormBeanConfig and an ActionServlet object.</li>
          <li>2004-01-19 - ActionMapping, ActionConfig: Push "findException" from ActionMapping up to ActionConfig so that everyone can take advantage of the superclass search logic.</li>
        </ul>
        <ul>
          <li>2003-09-29 - RequestProcessor,ActionMappingMatcher,WildcardHelper: Added optional wildcard support for action mappings.</li>
          <li>2003-09-11 - Action,ActionMessages,RequestProcessor: Added ability to save ActionMessages in the session and have them cleaned up after the first use.</li>
        </ul>
        <ul>
          <li>2003-08-23 - Action: Deprecate saveErrors(HttpServletRequest, ActionErrors) in favor of saveErrors(HttpServletRequest, ActionMessages).</li>
          <li>2003-08-23 - RequestProcessor: Replaced ActionErrors reference with ActionMessages.</li>
          <li>2003-08-23 - ActionMessages, ActionErrors: Deprecated ActionErrors.GLOBAL_ERROR in favor of ActionMessages.GLOBAL_MESSAGE.</li>
          <li>2003-08-16 - ExceptionHandler: Added storeException() method that takes an ActionMessage instead of ActionError.</li>
          <li>2003-08-13 - ActionError: Deprecate ActionError in favor of ActionMessage</li>
          <li>2003-08-08 - ActionServlet,ActionFormBeans,ActionForwards,ActionMappings.java v 1.13 : Removed references to ActionMappings, ActionFormBeans, and ActionForwards.</li>
        </ul>
        <ul>
          <li>2003-07-26 - Action: getLocale() now calls RequestUtils.getUserLocale() to prevent session creation.</li>
          <li>2003-07-04 - Action,ActionException: Removed deprecated getResources() method.</li>
          <li>2003-07-04 - Action: Removed deprecated perform() methods.</li>
          <li>2003-07-03 - ActionServlet: Removed support for some of the deprecated servlet init parameters.</li>
          <li>2003-07-03 - Globals,ActionServlet,RequestUtils: Moved initialization of module prefix list to the new ActionServlet.initModulePrefixes() method from RequestUtils.getModulePrefixes() because of a potential race condition documented in PR# 21091. This also required a move of the RequestUtils.PREFIXES constant to Globals.MODULE_PREFIXES_KEY.</li>
          <li>2003-07-02 - RequestProcessor: Deprecated log() methods in favor of commons-logging.</li>
          <li>2003-07-02 - ActionSerlvet: Removed deprecated method.</li>
          <li>2003-07-02 - ActionServlet: Removed references to deprecated ApplicationConfig class.</li>
          <li>2003-07-02 - ActionServlet,NoOpAction: Removed deprecated ActionServlet debug level and logging methods.</li>
          <li>2003-07-02 - RequestProcessor: Changed processRoles() to send a 403 Forbidden response if the role check fails. Also removed deprecated methods.</li>
          <li>2003-07-01 - Action: Removed deprecated constants and toHex() method.</li>
        </ul>
        <p>
        <strong>Actions Package Changes</strong> [
        <code>org.apache.struts.actions</code>]</p>
        <ul>
          <li>2004-06-24 - RedeployableActionServlet: Provides support for WebLogi hot-deploy.</li>
        </ul>
        <ul>
          <li>2003-12-22 - DispatchAction: Add detection of recursive calls.</li>
        </ul>
        <ul>
          <li>2003-08-13 - DispatchAction,LookupDispatchAction: Add 'default' and a 'cancel' handlers to DispatchAction and LookupDispatchAction.</li>
          <li>2003-08-12 - MappingDispatchAction: Addition of MappingDispatchAction that dispatches to a method named by the ActionMapping parameter.</li>
        </ul>
        <ul>
          <li>2003-07-11 - DispatchAction,ForwardAction,IncludeAction,SwitchAction: Throw exceptions from execute() method instead of sending a failure response to the client. This allows the exception handling mechanism to respond to the error gracefully.</li>
          <li>2003-07-03 - LookupDispatchAction: Fixed synchronization problem (PR# 21224). Also refactored some code into a new initLookupMap() method.</li>
        </ul>
        <p>
        <strong>Config Package</strong> [
        <code>org.apache.struts.config</code>]</p>
          <ul>
              <li>
              2004-07-31 - Enhance support for "lazy" dynabeans or POJO beans. "Lazy" DynaBeans will hopefully soon be released with Beanutils 1.7.0. These changes will make it easier to plug either a regular JavaBean or a "lazy" DynaBean into struts as an ActionForm. * FormBeanConfig now sets up the properties of DynaBeans which use a MutableDynaClass. * FormBeanConfig now handles POJO beans by wrapping the specified bean using WrapDynaBean and the new BeanValidatorForm. * RequestUtils has been changed so that properties starting with "org.apache.struts" are not attempted to be populated in the ActionForm.
              </li>
          </ul>
        <ul>
         <li>2004-04-14 - ModuleConfig.java: Local, as well as global, ActionForwards now observe pluggable classes. </li>
         <li>2004-04-08 - ModuleConfigImpl: Added a list to store ActionConfigs to ensure when enumerated, they are in the order in which they were added.</li>
        </ul>
        <ul>
          <li>2004-02-17 - Undeprecate and Restore the functionality for the 'type' attribute on form-beans and global-forwards elements in the config file.</li>