This document contains the release notes for Version 1.0 of the Struts Framework, and covers changes that have taken place since Version 1.0-beta-3 was released. The following sections cover New Features and Changes to Struts.
The binary distribution of this release includes the following files relevant to Struts 1.0:
INSTALL
- Brief installation instructions. See
the
Struts Documentation Application
, or online at
http://jakarta.apache.org/struts/
for more information.
LICENSE
- The Apache Software Foundation license that
defines the terms under which you can use Struts (and
other software
licensed by Apache).
README
- A brief introduction to Struts.
lib/
- Directory containing files you will need in
your own applications. The individual files of interest
are:
struts.jar
- JAR file that contains the compiled
Java classes for both version 0.5 and 1.0 of
Struts. You must
place this file in the
/WEB-INF/lib
directory of
your web application.
struts-xxxxx.tld
- The tag library descriptor files
for the Struts 1.0 tag libraries (bean, html,
logic, and
template). You must place these files in the
/WEB-INF
directory of your web application, and reference
them with
appropriate
<taglib>
directives in your
web.xml file.
NOTE
- The struts-form.tld
file is deprecated; you should use the
struts-html.tld file
instead.
jdbc2_0-stdext.jar
- The JDBC 2.0 Optional Package
API classes (package
javax.sql
). You will need to
include this file in the
/WEB-INF/lib
directory
of your application, if it is not already made
visible to web
applications by your servlet container.
struts-config_1_0.dtd
- The document type descriptor
(DTD) for the Struts configuration file (which is
typically named
/WEB-INF/struts-config.xml
. Your configuration file
will be validated against an internal copy of this
DTD -- this
copy is available for reference purposes only.
web-app_2_2.dtd
- The document type descriptor (DTD)
for web.xml files conforming to the Servlet 2.2
specification.
This copy is for reference purposes only.
web-app_2_3.dtd
- The document type descriptor (DTD)
for web.xml files conforming to the Servlet 2.3
specification.
This copy is for reference purposes only.
webapps/
- Web Application Archive (WAR) files for the
web applications that are included with Struts.
For backwards compatibility only, the binary distribution also includes the following files that conform to the Struts 0.5 milestone release APIs. Usage of these files and APIs is deprecated, and they will be removed from releases after Struts 1.0:
lib/
- Directory containing files you will need in
your own applications. The individual files of interest
are:
struts.jar
- JAR file that contains the compiled
Java classes for both version 0.5 and 1.0 of
Struts. You must
place this file in the
/WEB-INF/lib
directory of
your web application.
struts.tld
- The tag library descriptor file for
the 0.5 version of the Struts tags. You must place
this file
in the
/WEB-INF
directory of your web application,
and reference it with appropriate
<taglib>
directives in your web.xml file.
DEPRECATIONS
- The entire custom tag library
that is documented in
struts.tld
has been deprecated.
These tags correspond to the Struts 0.5 functionality that is
also
deprecated, and have been replaced (and considerably enhanced)
in
the various individual tag libraries.
DEPRECATIONS
- The entire custom tag library
that is documented in
struts-form.tld
has been deprecated
because this library has been renamed
struts-html.tld
instead.
DEPRECATIONS
- Several classes in the
org.apache.struts.util
package have been marked as
deprecated in their entirety, because they will be replaced by
versions from the Jakarta Commons project once those packages
are
released. These deprecated classes will
not
be
removed until a release after Struts 1.1. In general, the only
change required inside user code using these classes will be
to
update the
import
statement. The following classes
are involved:
The following new features have been added to the basic
controller
framework (package
org.apache.struts.action
):
The following new features have been added to the utility
classes
(package
org.apache.struts.util
):
The following new features have been added to the
struts-html
custom tag library (package
org.apache.struts.taglib.html
):
<html:link>
tag now supports the optional
title
attribute, that causes some browsers to display
alternate text when the mouse is hovered over a hyperlink.
The following new features have been added to the
struts-logic
custom tag library (package
org.apache.struts.taglib.logic
):
<logic:iterate>
tag now supports a new
attribute,
indexId
. This attribute names a page scope
attribute (and corresponding scripting variable) that will
be
exposed in the nested body of the iteration, which will
contain
the current loop index as a java.lang.Integer.
The following new features have been added to the
struts-template
custom tag library (package
org.apache.struts.taglib.template
):
The following new features have been added to the Struts Documentation application (and corresponding contents on the Struts web site):
The following changes and bug fixes have occurred in the configuration files related to Struts:
struts-config.xml
file has been updated to emphasize
the use of
<set-property>
elements nested inside
the
<data-source>
element. No further additional
attributes will be added to the
<data-source>
element in the DTD to support custom properties of
particular
data source implementations.
The following changes and bug fixes have occurred in the basic
controller framework (package
org.apache.struts.action
):
ActionForm
base class
are now transient, so that
ActionForm
instances can
actually be serialized.
WARNING
- If you deserialize
such an
ActionForm
instance and attempt to use it within
the Struts framework, be sure to call
setServlet()
(and
setMultipartRequestHander()
if appropriate) first.
The following changes and bug fixes have occurred in the file
upload
package (package
org.apache.struts.upload
):
The following changes and bug fixes have occurred in the
utilities
(package
org.apache.struts.util
):
pingQuery
property that
was added in Struts 1.0-b3.
RequestUtils.lookup()
will throw a JspException when the specified bean is
missing, in
accordance with its JavaDoc documentation.
Rule.body()
methods will now trim
leading and trailing whitespace first, consistent with the
behavior
of other body processing performed within the rules.
RequestUtils.absoluteURL()
.
The following changes and bug fixes have occurred in the
struts-bean
custom tag library (package
org.apache.struts.taglib.bean
):
<bean:include>
tag will now pass a session
identifier on to the included request (assuming that it is
part of
the same web application), even if the current request is
maintaining
session identity with cookies. Previously, this only
worked if you
were using URL rewriting.
The following changes and bug fixes have occurred in the
struts-html
custom tag library (package
org.apache.struts.taglib.html
):
checked="checked"
instead of
checked="true"
for the "checked" attribute.
<a name="my name"><>
element when the
linkName
attribute is used on the
<html:link>
tag.
The following changes and bug fixes have occurred in the
struts-logic
custom tag library (package
org.apache.struts.taglib.logic
):
<logic:present>
and
<logic:notPresent>
tags to reflect the changed
behavior of
RequestUtils.lookup()
.
The following changes and bug fixes to the Struts Documentation application (and corresponding contents on the Struts web site) have occurred:
<project>
tags in the
generated HTML, and generated incorrect references to link
colors in
the navigation bar.
The following changes and bug fixes to the Struts Example Application have occurred:
name
and
page
attributes of the
<app:checkLogon>
tag now accept runtime
expressions.
The following changes and bug fixes to the Struts Template Example Application have occurred: