husted 2003/12/11 04:26:09
Modified: doc/userGuide release-notes.xml
Log:
Start "What's New" section.
Revision Changes Path
1.39 +78 -61 jakarta-struts/doc/userGuide/release-notes.xml
Index: release-notes.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/release-notes.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- release-notes.xml 10 Dec 2003 21:12:06 -0000 1.38
+++ release-notes.xml 11 Dec 2003 12:26:09 -0000 1.39
@@ -71,13 +71,31 @@
<li>Commons Validator 1.1.1-dev</li>
</ul>
</section>
+ <section name="What's new?" href="New">
+ <p>This section highlights new features added and critical changes made since
the last release. Other interesting changes are listed in the
+ <a href="#Changes">What Changed?</a>section. For a complete review of all
changes, see the
+ <a href="../reports/changelog-report.html">changelog reports</a>. 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>Deprecations</strong>- Many constructs were deprecated for the Struts
1.1 release, most of which have now been removed. Before moving to this release, you
should clean-compile your application with deprecation warnings enabled. Alternatives
should be available for all decprecated constructs.
+ <strong>You are strongly advised</strong> to resolve all Struts 1.1.
deprecations before moving to this release. Removed constructs most likely to affect
developers are:</p>
+ <ul>
+ <li>Using the statics from the
+ <code>org.apache.struts.Action</code>class. Use
+ <code>org.apache.struts.Global</code>statics instead.</li>
+ <li>Calling
+ <code>Action.perform</code>. Use
+ <code>Action.execute</code> instead.</li>
+ </ul>
+ <p>
+ <strong>TagUtils</strong>- Many utility methods previously found in
+ <code>org.apache.struts.utils.RequestUtils</code> have been moved to
+ <code>org.apache.struts.taglibs.TagUtils</code>. We are working toward
creating a general "presentation utility" class that technologies like Custom Tags can
use to access the framework API. If you have custom tags that called RequestUtil
methods, they may need to call TagUtils instead.</p>
+ </section>
<section name="What Changed?" href="Changes">
- <p>
- This section highlights some of the changes that have taken place since
the last release.
- For a complete review of all changes, see the <a
href="../reports/changelog-report.html">changelog reports</a>.
- Subscribers to the <a href="../using.html#Lists">struts-dev mailing
list</a>, receive reports of all changes as they are made.
- </p>
-
+ <p>This section highlights some of the changes that have taken place since
the last release. For a complete review of all changes, see the
+ <a href="../reports/changelog-report.html">changelog reports</a>. 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>Configuration Changes</strong> [
<code>/conf/shared</code>]</p>
@@ -85,24 +103,24 @@
<li>
<code>
<a
href="http://jakarta.apache.org/struts/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 <display-name> and <description> 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.</li>
- <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 <data-source> "type" attribute is now
required because Struts does not supply a default DataSource implementation.</li>
+ </code>is preferred to the deprecated Struts Configuration 1.1 DTD. The new
DTD adds two new elements <display-name> and <description> 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.</li>
+ <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 <data-source> "type" attribute is now
required because Struts does not supply a default DataSource implementation.</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>
+ <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>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-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>
@@ -115,7 +133,7 @@
<strong>Actions Package Changes</strong> [
<code>org.apache.struts.actions</code>]</p>
<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-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>
<li>The DispatchAction now provides default cancel handler that can be
overridden. It also also possible to specify the default handler name.</li>
<li>The LookupDispatchAction now provides default cancel handler that can
be overridden. It also also possible to specify the default handler name.</li>
@@ -124,32 +142,30 @@
<strong>Config Package</strong> [
<code>org.apache.struts.config</code>]</p>
<ul>
- <li>2003-07-27 - ConfigHelper: Deprecate methods() since they return
objects that have been deprecated. The ModuleConfig object should be used to lookup
these items.</li>
- <li>2003-07-16 - ModuleConfigFactory: Catch only relevant exceptions
instead of Throwable and made LOG final.</li>
- <li>2003-07-04 - struts-config_1_2.dtd, ControllerConfig.java: Removed
deprecated debug controller attribute.</li>
- <li>2003-07-04 - ActionConfig: Removed deprecated perform() methods.</li>
+ <li>2003-07-27 - ConfigHelper: Deprecate methods() since they return
objects that have been deprecated. The ModuleConfig object should be used to lookup
these items.</li>
+ <li>2003-07-16 - ModuleConfigFactory: Catch only relevant exceptions
instead of Throwable and made LOG final.</li>
+ <li>2003-07-04 - struts-config_1_2.dtd, ControllerConfig.java: Removed
deprecated debug controller attribute.</li>
+ <li>2003-07-04 - ActionConfig: Removed deprecated perform() methods.</li>
<li>ApplicationConfig: removed in favor of ModuleConfig.</li>
</ul>
-
- <p>
- <strong>Contrib Packages</strong> [
- <code>/contrib</code>]</p>
- <ul>
- <li>2003-07-26 - Updated Struts-EL tags to match recent attribute
changes to tags in base library.</li>
- </ul>
-
+ <p>
+ <strong>Contrib Packages</strong> [
+ <code>/contrib</code>]</p>
+ <ul>
+ <li>2003-07-26 - Updated Struts-EL tags to match recent attribute changes
to tags in base library.</li>
+ </ul>
<p>
<strong>Plugins Package</strong> [
<code>org.apache.struts.plugins</code>]</p>
<ul>
<li>No signficant changes.</li>
</ul>
- <p>
- <strong>Taglib Package Changes</strong> [
- <code>org.apache.struts.taglib</code>]</p>
- <ul>
- <li>2003-07-26 - TagUtils,RequestUtils: Added TagUtils class for taglibs
to use instead of RequestUtils. We should migrate any method in RequestUtils that
takes a PageContext parameter and/or throws JspException. A clean separation will help
keep RequestUtils smaller and allow the taglibs to be easily split off of the core
Struts distribution.</li>
- </ul>
+ <p>
+ <strong>Taglib Package Changes</strong> [
+ <code>org.apache.struts.taglib</code>]</p>
+ <ul>
+ <li>2003-07-26 - TagUtils,RequestUtils: Added TagUtils class for taglibs to
use instead of RequestUtils. We should migrate any method in RequestUtils that takes a
PageContext parameter and/or throws JspException. A clean separation will help keep
RequestUtils smaller and allow the taglibs to be easily split off of the core Struts
distribution.</li>
+ </ul>
<p>
<strong>Bean Taglib Package Changes</strong> [
<code>org.apache.struts.taglib.bean</code>]</p>
@@ -182,31 +198,29 @@
<strong>Tiles Taglib Package Changes</strong> [
<code>org.apache.struts.taglib.tiles</code>]:</p>
<ul>
- <li>2003-07-27 - xmlDefinition/XmlParser: Remove deprecated/non
functional digester logging method.</li>
- <li>2003-07-10 - TagUtils: Deprecated getProperty() because it provided
no value over calling PropertyUtils.getProperty() directly.</li>
- <li>2003-07-08 - TilesServlet,ActionComponentServlet: Formatted code,
removed deprecated constant.</li>
+ <li>2003-07-27 - xmlDefinition/XmlParser: Remove deprecated/non functional
digester logging method.</li>
+ <li>2003-07-10 - TagUtils: Deprecated getProperty() because it provided no
value over calling PropertyUtils.getProperty() directly.</li>
+ <li>2003-07-08 - TilesServlet,ActionComponentServlet: Formatted code,
removed deprecated constant.</li>
<li>2003-07-04 - ActionController: Call Action.execute() instead of
perform().</li>
</ul>
-
-
<p>
<strong>Tiles Package Changes</strong> [
<code>org.apache.struts.tiles</code>]:</p>
<ul>
- <li>2003-07-31 - xmlDefinition/I18nFactorySet: Replace deprecated
constant reference with it's base interface equal.</li>
- <li>2003-07-31 - actions/DefinitionDispatcherAction: Replace deprecated
method with current one. Still one method DefinitionUtil.setActionDefinition that
doesn't have a replacement. It's a simple method but I don't know where a good place
to move it would be.</li>
- <li>2003-07-31 - actions/ReloadDefinitionsAction: Use
TilesUtil.createDefinitionsFactory(request,context) instead of deprecated
method().</li>
- <li>2003-07-21 - struts-*config.xml: Remove the use of the deprecated
action NoOpAction. Replace by ForwardAction.</li>
- <li>2003-07-21 - *Action: Replace the deprecated perform(..) method by
the new execute(...) method.</li>
- <li>2003-07-12 - DefinitionDispatcherAction: Use commons-logging to
record error messages instead of printing them to the response.</li>
- <li>2003-07-10 - TilesAction: Removed deprecated perform() method.</li>
- <li>2003-07-09 - Removed deprecated TilesUtil.applicationClass()
method.</li>
- <li>2003-07-08 - DefinitionsUtil.java: Deprecated debug level constants,
removed some deprecated methods.</li>
- <li>2003-07-08 - ChannelFactorySet: Use commons-logging instead of
printing to stdout.</li>
- <li>2003-07-07 - InsertTag: Fixed exception handling. Instead of
swallowing exceptions or printing the stack trace on the page, the exceptions are
logged and rethrown as JspException for the page error handling mechanism to deal
with.</li>
- <li>2003-07-07 - InsertTag: More code cleanup, removed deprecated method,
deprecated ROLE_DELIMITER because it is only used internally to this class</li>
- <li>2003-07-04 - ComponentContext: Removed deprecated constructor</li>
- <li>2003-07-02 - Changed UntyppedAttribute class name to UntypedAttribute
(spelling error).</li>
+ <li>2003-07-31 - xmlDefinition/I18nFactorySet: Replace deprecated constant
reference with it's base interface equal.</li>
+ <li>2003-07-31 - actions/DefinitionDispatcherAction: Replace deprecated
method with current one. Still one method DefinitionUtil.setActionDefinition that
doesn't have a replacement. It's a simple method but I don't know where a good place
to move it would be.</li>
+ <li>2003-07-31 - actions/ReloadDefinitionsAction: Use
TilesUtil.createDefinitionsFactory(request,context) instead of deprecated
method().</li>
+ <li>2003-07-21 - struts-*config.xml: Remove the use of the deprecated
action NoOpAction. Replace by ForwardAction.</li>
+ <li>2003-07-21 - *Action: Replace the deprecated perform(..) method by the
new execute(...) method.</li>
+ <li>2003-07-12 - DefinitionDispatcherAction: Use commons-logging to record
error messages instead of printing them to the response.</li>
+ <li>2003-07-10 - TilesAction: Removed deprecated perform() method.</li>
+ <li>2003-07-09 - Removed deprecated TilesUtil.applicationClass()
method.</li>
+ <li>2003-07-08 - DefinitionsUtil.java: Deprecated debug level constants,
removed some deprecated methods.</li>
+ <li>2003-07-08 - ChannelFactorySet: Use commons-logging instead of printing
to stdout.</li>
+ <li>2003-07-07 - InsertTag: Fixed exception handling. Instead of swallowing
exceptions or printing the stack trace on the page, the exceptions are logged and
rethrown as JspException for the page error handling mechanism to deal with.</li>
+ <li>2003-07-07 - InsertTag: More code cleanup, removed deprecated method,
deprecated ROLE_DELIMITER because it is only used internally to this class</li>
+ <li>2003-07-04 - ComponentContext: Removed deprecated constructor</li>
+ <li>2003-07-02 - Changed UntyppedAttribute class name to UntypedAttribute
(spelling error).</li>
</ul>
<p>
<strong>Upload Package Changes</strong> [
@@ -218,9 +232,9 @@
<strong>Utility Package Changes</strong> [
<code>org.apache.struts.util</code>]:</p>
<ul>
- <li>2003-07-26 - TagUtils,RequestUtils: Added TagUtils class for taglibs
to use instead of RequestUtils. We should migrate any method in RequestUtils that
takes a PageContext parameter and/or throws JspException. A clean separation will help
keep RequestUtils smaller and allow the taglibs to be easily split off of the core
Struts distribution.</li>
- <li>2003-07-25 - RequestUtils: Backwards compatibility fix. Changed
ModuleConfig lookups to use getModuleConfig so that default module config is returned
if one is not already present in the request</li>
- <li>2003-07-16 - RequestUtils: Make retrieveMessageResources()
module-aware by adding the module prefix to the bundle name when retrieving from
application context.</li>
+ <li>2003-07-26 - TagUtils,RequestUtils: Added TagUtils class for taglibs to
use instead of RequestUtils. We should migrate any method in RequestUtils that takes a
PageContext parameter and/or throws JspException. A clean separation will help keep
RequestUtils smaller and allow the taglibs to be easily split off of the core Struts
distribution.</li>
+ <li>2003-07-25 - RequestUtils: Backwards compatibility fix. Changed
ModuleConfig lookups to use getModuleConfig so that default module config is returned
if one is not already present in the request</li>
+ <li>2003-07-16 - RequestUtils: Make retrieveMessageResources() module-aware
by adding the module prefix to the bundle name when retrieving from application
context.</li>
<li>2003-07-03 - LabelValueBean: Added equals and hashCode() methods.</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 - RequestUtils,TestRequestUtils: Removed deprecated
"application" methods in favor of "module" methods.</li>
@@ -230,10 +244,10 @@
<strong>Validator Package Changes</strong> [
<code>org.apache.struts.validator</code>]</p>
<ul>
- <li>2003-07-30 validator-rules.xml: Remove deprecated range() method.</li>
+ <li>2003-07-30 validator-rules.xml: Remove deprecated range() method.</li>
<li>2003-07-30 - validator-rules.xml: Allow intRange validation of
select-one and radio fields. In some form combo boxes you might have the combo boxes
populated 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 yell at them if they failed to pick something.</li>
- <li>2003-07-28 - JavascriptValidatorTag.java,ValidatorPlugIn.java:
Enhancement to allow checking of all constraints instead of aborting. The default is
same as struts 1.1.</li>
- <li>2003-07-26 - Resources: Deprecated Resources.getLocale() because it
created sessions. Use RequestUtils.getUserLocale() instead.</li>
+ <li>2003-07-28 - JavascriptValidatorTag.java,ValidatorPlugIn.java:
Enhancement to allow checking of all constraints instead of aborting. The default is
same as struts 1.1.</li>
+ <li>2003-07-26 - Resources: Deprecated Resources.getLocale() because it
created sessions. Use RequestUtils.getUserLocale() instead.</li>
<li>2003-07-02 - Resources: Rewrote getArgs() method to use arrays and
loops, which removes limitation of 4 args.</li>
<li>2003-07-02 - Resources: Remove deprecated methods</li>
<li>2003-07-02 - Validator,ValdiatorUtils: Changed processRoles() to send a
403 Forbidden response if the role check fails. Also removed deprecated methods.</li>
@@ -246,14 +260,17 @@
</ul>
<ul>
<li>The ValidatorPlugin: It is now possible to force the client side
Javascript validation to check all constraints, instead of stopping at the first
error. By setting a new property, stopOnFirstError, on the validator plug in tag to
false. This is in the struts-config.xml as follow:
-<pre><code><![CDATA[
+ <pre>
+<code>
+ <![CDATA[
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
<set-property property="pathnames"
value="/WEB-INF/validation.xml,/WEB-INF/validator-rules.xml"/>
<set-property property="stopOnFirstError" value="true"/>
</plug-in>
-]]></code></pre>
-</li>
+]]>
+</code>
+</pre></li>
<li>validator-rules.xml[intRange]: 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 yell
at them if they failed to pick something.</li>
</ul>
<p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
