You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by cr...@locus.apache.org on 2000/09/25 19:55:19 UTC
cvs commit: jakarta-struts/src/doc release.xml index.xml project.xml todo.xml
craigmcc 00/09/25 10:55:18
Modified: . TODO
src/doc index.xml project.xml todo.xml
Added: src/doc release.xml
Log:
Update the docs to reflect changes to date since version 0.5.
Revision Changes Path
1.5 +1 -18 jakarta-struts/TODO
Index: TODO
===================================================================
RCS file: /home/cvs/jakarta-struts/TODO,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- TODO 2000/09/06 22:34:52 1.4
+++ TODO 2000/09/25 17:55:13 1.5
@@ -1,4 +1,4 @@
-$Id: TODO,v 1.4 2000/09/06 22:34:52 craigmcc Exp $
+$Id: TODO,v 1.5 2000/09/25 17:55:13 craigmcc Exp $
Struts TODO List
@@ -43,17 +43,10 @@
sub-package org.apache.struts.action.admin? Motivation: STRUTS-DEV
(07/02/2000) Frank Nestel.
-- Support a configurable "default" action mapping if none of the other
- mappings are triggered. See: STRUTS-DEV (07/02/2000) Frank Nestel.
-
- Add an additional (optional) validate() method that takes useful contextual
arguments (request?, servlet?). DECISIONS: Break backwards compatibility?
new interface? See: STRUTS-USER (08/01/2000) Chris Audley.
-- Configurable option to support calculating a user's Locale (if not already
- present in the session) based on incoming HTTP headers. See:
- STRUTS-USER (07/02/2000) Robert Edgar, STRUTS-DEV (08/22/2000) Pierre Metras.
-
- Consider migrating management of action form population out of ActionServlet
and into ActionMapping. Motivation: STRUTS-DEV (08/14/2000)
Vladimir Blagojevic.
@@ -66,10 +59,6 @@
the <struts:file> tag. See: STRUTS-DEV (08/20/2000) Chris Miller and
follow-ups. Also, STRUTS-USER (07/17/2000) "Re: File uploads support".
-- Support a second perform() method on Action that takes ServletRequest and
- ServletResponse, for use in non-HTTP environments. STRUTS-DEV
- (08/23/2000) Frank Nguyen, and follow-ups.
-
- Support a special type of ActionForward that uses the HTTP "Referer" header
to identify the page to return to, so you can <%@ include %> the same form
onto multiple pages. STRUTS-USER (09/06/2000) Hans Gerwitz.
@@ -181,12 +170,6 @@
Utility Classes [org.apache.struts.util]:
----------------------------------------
-
-- Implement and test the new PropertyUtils class, which supports nested and
- indexed access to properties (both getters and setters) with no data type
- conversions.
-
-- Modify BeanUtils to utilize the new PropertyUtils support methods.
- Modify BeanUtils to support PropertyEditor-based data conversions between
String and the internal property formats.
1.3 +42 -0 jakarta-struts/src/doc/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/index.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index.xml 2000/08/29 00:28:53 1.2
+++ index.xml 2000/09/25 17:55:15 1.3
@@ -45,6 +45,19 @@
<section name="Acquiring Struts" href="Acquiring">
+ <p><strong>NEW!</strong> - A milestone release, <strong>Version 0.5</strong>
+ of Struts has been created and made available at
+ <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v0.5">
+ http://jakarta.apache.org/builds/jakarta-struts/release/v0.5</a>. This
+ release will provide a stable basis for current projects being developed
+ on Struts, while (sometimes incompatible) changes are occurring on the
+ main code branch leading up to a <strong>Version 1.0</strong> release later.
+ You can track the progress towards <strong>Version 1.0</strong>, and get
+ early warning about new features and changes, by monitoring the
+ <a href="http://jakarta.apache.org/struts/release.html">Release Notes</a>
+ that are posted on the Struts project web site, as well as included in the
+ nightly build distributions.</p>
+
<p>You can acquire binary and source distributions of Struts from the
following locations:</p>
<ul>
@@ -76,6 +89,33 @@
</section>
+ <section name="Reporting Bugs and Feature Requests" href="Bugs">
+
+ <p>Thanks to the gracious efforts of
+ <a href="mailto:nick@cortexity.com">Nick Bauman</a> and his employer,
+ Cortexity, there is now an interim bug tracking system available for
+ all of the Jakarta projects (including Struts). To report a bug, or
+ request a feature enhancement, simply point your browser at:
+ <a href="http://znutar.cortexity.com:8888">
+ http://znutar.cortexity.com:8888</a>. When filling out a bug report
+ or feature request, please follow these simple rules:</p>
+ <ul>
+ <li>From the list of projects and categories, select one of the following
+ entries:
+ <ul>
+ <li>Struts / Feature Requests / New Features</li>
+ <li>Struts / Feature Requests / Enhancement</li>
+ <li>Struts / Bug Report / New Bug Report</li>
+ </ul></li>
+ <li>For the <code>Project Release</code> field, enter the Struts version
+ number (such as <strong>0.5</strong>) if you are using a released
+ version, or the date included in the filename of a nightly distribution
+ (such as <strong>20000922</strong>) if you are using that.</li>
+ </ul>
+
+ </section>
+
+
<section name="Getting Involved" href="Involved">
<p>There are a number of ways to get more involved in the Struts
@@ -91,6 +131,8 @@
<a href="mailto:struts-dev-subscribe@jakarta.apache.org">STRUTS-DEV</a>
mailing list to communicate with other developers interested in expanding
and improving the functionality supported by Struts itself.</li>
+ <li><strong>Bug Reports and Feature Requests</strong> Use the
+ <a href="#Bugs">Bug Reporting System</a> to submit these reports.</li>
<li><strong>Patches and Modules</strong> - You can contribute patches and
new modules to Struts by posting them to the STRUTS-DEV mailing list.
After discussion and acceptance, one of the existing Committers will
1.6 +2 -1 jakarta-struts/src/doc/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/project.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- project.xml 2000/09/15 00:40:55 1.5
+++ project.xml 2000/09/25 17:55:15 1.6
@@ -5,10 +5,11 @@
<title>Struts Framework</title>
- <menu name="Overview">
+ <menu name="Documentation">
<item name="Home" href="index.html"/>
<item name="Installation" href="installation.html"/>
<item name="Javadoc" href="api/index.html"/>
+ <item name="Release Notes" href="release.html"/>
<item name="TODO List" href="todo.html"/>
</menu>
1.2 +0 -43 jakarta-struts/src/doc/todo.xml
Index: todo.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/todo.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- todo.xml 2000/09/15 00:40:55 1.1
+++ todo.xml 2000/09/25 17:55:16 1.2
@@ -39,19 +39,6 @@
action and form bean classes, plus the supporting data structures.</p>
</info>
- <task name="Enhanced Configuration">
- <info>
- <p>Implement a new configuration mechanism for the controller servlet
- (replacing <code>action.xml</code>) that is based on the proposed
- <code>struts-config.dtd</code> DTD with future extensibility in mind.
- For backwards compatibility, support the existing configuration format
- at least until 1.0 is released.</p>
- </info>
- <assigned>
- Craig McClanahan
- </assigned>
- </task>
-
<task name="Standard Actions">
<info>
<p>Begin the collection of a set of generally useful standard
@@ -62,13 +49,6 @@
</info>
</task>
- <task name="Default Action">
- <info>
- <p>Support a configurable default action mapping if none of the
- other mappings are selected.</p>
- </info>
- </task>
-
<task name="Enhanced Validation">
<info>
<p>Replace the current <code>ValidatingActionForm.validate()</code>
@@ -76,29 +56,6 @@
servlet?, mapping?) so that it can do more global sorts of validation
checks, as well as access external resources.</p>
<p><strong>NOTE: Likely to break backwards compatibility.</strong></p>
- </info>
- </task>
-
- <task name="Calculate User Locale">
- <info>
- <p>Provide configurable support in <code>ActionServlet</code> to
- attempt a mapping of the values specified in the HTTP
- <code>Accept-Language</code> headers (if any) to a corresponding
- <code>Locale</code>, if one has not been set as a session attribute
- by application code. It should also be possible to request creation
- of this Locale as a request attribute, rather than a session
- attribute, when Struts is used in a session-less environment.</p>
- </info>
- </task>
-
- <task name="Non-HTTP Actions">
- <info>
- <p>Define a second <code>Action.perform()</code> method signature that
- takes <code>ServletRequest</code> and <code>ServletResponse</code> as
- parameters, rather than their HTTP subclasses. Default implementation
- in <code>ActionBase</code> should forward to the HTTP equivalents if
- possible, or throw an exception otherwise, to partially preserve
- backwards compatibility.</p>
</info>
</task>
1.1 jakarta-struts/src/doc/release.xml
Index: release.xml
===================================================================
<?xml version="1.0"?>
<document url="./release.xml">
<properties>
<author>Craig R. McClanahan</author>
<title>Struts Release Notes (Version 1.0)</title>
</properties>
<body>
<section name="Introduction" href="Introduction">
<p>This document contains the release notes for <strong>Version 1.0</strong>
of the Struts Framework. The following sections cover
<a href="#New">New Features</a> and <a href="#Changes">Changes</a> since
the <strong>Version 0.5</strong> of Struts was made available.</p>
</section>
<section name="What's New?" href="New">
<p>The following major new features have been added to the controller
servlet and associated classes
(package <code>org.apache.struts.action</code>):</p>
<ul>
<li>A new configuration file format, including the
<a href="dtds/struts-config_1_0.dtd">Document Type Definition (DTD)</a>
it is based on, is available for configuring the Struts controller
servlet. Support for the previous format is still present, but will
be phased out by the 1.0 release.</li>
<li>If enabled by setting the <code>locale</code> servlet initialization
parameter to <code>true</code>, the controller servlet will now calculate
a Locale for this user (based on the HTTP headers included with the
request) and store it in the user's session, unless the application
has stored one there already.</li>
<li>Application <code>Action</code> instances now have lifecycle support.
The controller servlet will call <code>setServlet()</code> with a
non-null argument when the instance is first created, and call it with
a <code>null</code> argument when the instance is being shut down.</li>
</ul>
</section>
<section name="Changes and Bug Fixes" href="Changes">
<p>The following changes and bug fixes to the controller servlet and
associated classes (package <code>org.apache.struts.action</code>) have
occurred:</p>
<ul>
<li>The <code>ActionMapping</code> interface has been converted to a base
class instead, to reduce the impact of future enhancements. Anyone who
has extended the <code>ActionMappingBase</code> convenience base class
(which has been deprecated) should extend <code>ActionMapping</code>
instead.</li>
<li>In conjunction with the new configuration file format mentioned above,
the properties of <code>ActionMapping</code> have been substantially
updated. See the
<a href="api/org/apache/struts/action/ActionMapping.html">API
Documentation</a> for more information</li>
<li>The <code>Action</code> interface has been converted to a base class
instead, to reduce the impact of future enhancements. Anyone who has
extended the <code>ActionBase</code> convenience base class (which
has been deprecated) should extend <code>Action</code> instead.</li>
<li>In conjunction with the above change, the <code>servlet</code>
argument has been removed from the parameter list for the
<code>perform()</code> method, because it is now redundant -- the
associated servlet is set via the <code>setServlet()</code> method
when the <code>Action</code> instance is first created.</li>
<li>Responsibility for creating <code>Action</code> instances has been moved
from <code>ActionMapping</code> to the controller servlet, so that
instance lifecycle management can be performed. As a side effect of this
change, if you had two actions that used the same Action class name,
there will now be only one (shared) instance of the Action class,
rather than two.</li>
</ul>
<p>The following changes and bug fixes to the Digester module
(package <code>org.apache.struts.digester</code>) have occurred:</p>
<ul>
<li>The <code>Digester.resolveEntity()</code> method has been enhanced
to correctly handle local URIs so that it works with resources loaded via
<code>Class.getResource()</code>.</li>
</ul>
<p>The following changes and bug fixes to the Utilities package
(package <code>org.apache.struts.util</code>) have occurred:</p>
<ul>
<li>Fixed <code>PropertyUtils.getPropertyType()</code> to correctly return
the underlying element type even if there was a non-indexed property
getter method.</li>
<li>Added a missing "return" statement to
<code>PropertyUtils.setIndexedProperty()</code>.</li>
<li>Functionality in <code>BeanUtils</code> that previously duplicated
functionality that was earlier moved to <code>PropertyUtils</code>
has been removed.</li>
</ul>
</section>
</body>
</document>