[Struts Wiki] Update of "StrutsActionRelease135" by WendySmoak

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Struts Wiki" for change notification.

The following page has been changed by WendySmoak:
http://wiki.apache.org/struts/StrutsActionRelease135

New page:
= Struts Action 1.3.5 Release =

== Info ==

 1. Struts [http://struts.apache.org/releases.html#Releases Release Guidelines]
 
 2. [http://wiki.apache.org/incubator/SigningReleases Signing Releases]

 3. Apache [http://apache.org/dev/mirrors.html Mirroring Guidelines]
 
== Release Manager ==

The release manager is '''TBD'''

== How to Help ==

Everyone in the Struts community, users, developers, and committers, is encouraged to test a release, report any issues, and post to dev@ any comments on the overall quality of the release.

To help everyone get started with Struts Action 1.3.5 (when it is available), here are the simplest installation instructions that can possibly work:

 * Download the Struts 1.3.5 distribution from http://svn.apache.org/dist/struts/action/v1.3.5/ (when it is available.) (Until then, try a [http://cvs.apache.org/builds/struts/maven/trunk/nightly/struts-action/ snapshot].)
 * Extract the distribution to a likely location (/opt/struts-action-1.3.5)
 * Install Java and set JAVA_HOME 
 * Install Maven 2 and set MAVEN_HOME
 * Install Apache Tomcat 
 * http://wiki.apache.org/struts/StrutsMaintenanceMaven
 * Change to the new folder (e.g., /opt/struts-action-1.3.5/src)
 * $ mvn
 * Wait about five minutes for Maven to download and build everything
 ** If you see any error messages, please do a quick search of the mail archives and/or post them on the Dev list, and if they appear to be newly introduced issues, a Jira tickets will need to be created so we can track and resolve the issue as quickly as possible.  Oh, and THANK YOU for your help.

== Issues ==

[http://issues.apache.org/struts/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=10121&fixfor=21721 Resolved Issues]

[http://issues.apache.org/struts/secure/ReleaseNote.jspa?version=21721&styleName=Text&projectId=10121&Create=Create JIRA Release Notes]

== TO DO ==

== Preparation Checklist ==

|| '''#''' || '''Description''' || '''Status''' ||
|| 1. || Announce plan to dev@ list ||  ||
|| 2. || Review/Resolve Outstanding Bugs ||  ||
|| 3. || Update Release Notes ||  ||
|| 4. || Check Dependencies ||  ||

The Commons [http://jakarta.apache.org/commons/releases/prepare.html Preparation Guide] is a helpful preparation backgrounder, but Commons
uses the "beta/release-candidate/final" process.

Likewise, the [http://httpd.apache.org/dev/release.html HTTPD Release Guidelines] is a helpful "overall process" backgrounder,
but HTTPD does not use a test-build stage.

External Dependency versions for this release:

|| '''Dependency''' || '''Version''' || '''Status''' ||'''Used In''' ||
|| Antlr || 2.7.2 || Released || Struts Validator ||
|| Bean Scripting Framework || 2.3.0 || Released || Scripting ||
|| Commons !BeanUtils || 1.7.0 || Released || core (!ActionServlet, configuration, !DynaActionForm) ||
|| Commons Chain || 1.0 || Released || core (!RequestProcessor) ||
|| Commons Digester || 1.6 || Released || core (!ActionServlet, configuration) ||
|| Commons !FileUpload || 1.1 || Released || Struts Upload ||
|| Commons IO || 1.1 || Released || Required by Commons !FileUpload ||
|| Commons Logging || 1.0.4 || Released || core (logging all over) ||
|| Commons Validator || 1.3.0 || Released || Struts Validator ||
|| Jakarta Oro || 2.0.8 || Released || Commons Validator ||

'''Note:''' This release of Struts Action depends on Struts Build 1.0.0 for the Checkstyle config file.

== Testing Checklist ==

=== Testing Summary ===

|| '''#''' || '''Description''' || '''Completed''' ||
|| 1. || Run Unit Test targets  ||  ||
|| 2. || Run Cactus Tests (see below) ||  ||
|| 3. || Play test examples application (TC 5.0.x) ||  ||


'''Note:''' Cactus tests are not working and have been moved to the sandbox.

== Test Build Checklist (A) ==

See also Commons [http://jakarta.apache.org/commons/releases/release.html Step-by-Step Guide]

|| '''#''' || '''Description''' || '''Completed''' ||
|| A0. || Update all pom.xml files to omit "-SNAPSHOT" ||  ||
|| A1. || Tag release in svn: STRUTS_ACTION_1_3_5 ||   ||
|| A2. || Check out a clean copy using the '''''tag''''' created in A1 and see StrutsMavenRelease ||  ||
|| A3. || Deploy Test Build to cvs.apache.org/maven-snapshot-repository ||  ||
|| A4. || Upload Distribution to people.apache.org:/www/cvs.apache.org/dist/struts/action/v1.3.5 ||  ||
|| A5. || Update all pom.xml files to "1.3.5-SNAPSHOT" ||  ||
|| A6. || Announce the Test Build on dev@ and user@ lists (optional) ||  ||
|| A7. || Post release-quality vote on dev@ list  ||   ||
|| A8. || Create a new JIRA version level (1.3.6) ||  ||

== Vote (A) ==

|| PMC Member || Quality ||

Voting thread is [here]

If release vote fails, including for a lack of quorum, remove from dist 
folder.      

== Point Release Checklist (B) ==

|| '''#''' || '''Description''' || '''Completed''' ||
|| B1. || Create Sums and Sign Distributions [2] ||  ||
|| B2. || Update "Acquiring" page on website and Test Downloads ||  ||

== Vote (B) ==

|| PMC Member || Quality ||

Voting continues until a GA or "withdraw" vote passes, or there is a
subsequent release.

== General Availability Checklist (C) ==

|| '''#''' || '''Description''' || '''Completed''' ||
|| C1. || Copy Distribution to Mirrored Directories [3] || _ ||
|| C2. || Promote Test Build from maven-snapshot-repository to dist/maven-repository || _ ||
|| C3. || After 24 hours, update "Acquiring" page on website || _ ||
|| C4. || Post an announcement to lists and website || _ ||
----

== Proposed Release Announcement ==

Subject: [ANNOUNCE] Struts Action Framework v1.3.5 [Alpha|Beta|]

The Apache Struts team is pleased to announce the release of Struts Action Framework 1.3.5 [Alpha|Beta|for General Availability].

Struts Action is available in both a full distribution, and a library distribution containing only the framework and dependencies.

     http://struts.apache.org/download.cgi

Major changes since Struts Action 1.2 include

    * Composable Request Processor
    * Arbitrary configuration properties
    * Opt-In Cancel Handling
    * Enhanced Global Exception Handlers
    * Extends attribute
    * "isCommitted" Exception Handling
    * Postback Actions
    * Wildcard ActionConfig properties

Composable Request Processor: For Action 1.3, we turned the request processor methods into Commands that are part of a flexible Chain of Commands.

Arbitrary configuration properties: Most every Struts configuration element now accepts a map of key/value pairs. Arbitrary configuration properties let us externalize more of our configurations, encouraging reuse.

Opt-In Cancel Handling: In Struts Action 1.3, the Cancel token is only honored if the new property "cancellable" is set for the Action Mapping. If the Cancel token is present, but cancellable is not set, then an InvalidCancelException is thrown. The InvalidCancelExeption may be caught by a Declarative Exception Handler, like any other Exception.

Enhanced Global Exception Handlers: We now support use of global exception handlers in cases when no ActionConfig has yet been identified, as in with "preprocessing" commands in a custom request processing chain. 

Extends attribute: In the Struts configuration file, we can now use the extends  attribute to adopt default settings from another element, as we already can in the Tiles configuration files.

"isCommitted" Exception Handling: When using Tiles, sometimes the response is already committed when an exception occurs. Now, the ExceptionHandler tests response.isCommitted  , and, if true, includes the configured view path, rather than forwarding to it. 

Postback Forms: The action attribute of the Form taglib is now optional. If omitted, the original URI of the original request is used.

Wildcard ActionConfig properties: Wildcards can now be used in the properties of an ActionConfig. 

The 1.3.x series of Struts Action Framework has a minumum requirement of the following specification versions:

    * Java Servlet 2.3 and JavaServer Pages (JSP) 1.2
    * Java 2 Standard Platform Edition (J2SE) 1.4

The release notes are available online at:
    
    http://struts.apache.org/struts-action/userGuide/release-notes.html

Notes on upgrading from prior versions can be found on the community-maintained wiki:
    
    http://wiki.apache.org/struts/StrutsUpgradeNotes12to13