This document contains the release notes for Version 1.0-beta-2 of the Struts Framework, and covers changes that have taken place since Version 1.0-beta-1 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.
The build procedure for compiling the Struts source
distribution
has been revised, and now depends on having
Ant 1.2
(or later) installed, with the
$ANT_HOME/bin
directory
on your path. Further information can be found in the
Installation
documentation.
The following new features have been added to the basic
controller
framework (package
org.apache.struts.action
):
<action>
element should
invoke an existing servlet or JSP page resource, rather
than calling an
Action
class, by using the
include
attribute
rather than the
type
attribute. The standard form bean
processing provided by the controller is still performed
first, if you
have configured it, so the included resource can benefit
from this
processing if it wishes to.
initDataSources()
method can now throw a
ServletException
to report that an initialization error
has occurred. Previously, such errors were logged but
otherwise
ignored.
org.apache.struts.actions.ForwardAction
and
org.apache.struts.actions.IncludeAction
. These actions
let you take advantage of the standard processing
performed by the
controller servlet (including form bean population and
calling the
validate()
method), but not have to write Java code to
perform (or wrap) the required business logic.
HttpServletRequest
for handling multipart requests as
identically as possible to standard requests, including
processing
request parameters, populating form beans, transaction
tokens, and
checking for cancellations.
The following new features have been added to the utility
classes
(package
org.apache.struts.util
):
PropertyUtils
can now correctly locate public methods
defined in a nested interface that is implemented by a
bean.
PropertyUtils
methods now throw
IllegalArgumentException
when you pass a null
bean
reference or property
name
.
import
clauses:
org.apache.struts.util.FastArrayListorg.apache.struts.util.FastHashMaporg.apache.struts.util.FastTreeMaporg.apache.struts.util.BeanUtilsorg.apache.struts.util.ConvertUtilsorg.apache.struts.util.PropertyUtilsThe following new features have been added to the
struts-html
custom tag library (package
org.apache.struts.taglib.html
):
<html:link>
tag now accepts an optional
anchor
attribute, to allow the inclusion of a
(possibly calculated) anchor ("#xxx") in the generated
hyperlink.
<html:base>
tag now accepts an optional
target
attribute.
<html:image>
tag now accepts an optional
border
attribute, to define the border with around
this image.
<html:link>
tag
include any current transaction control token in the
generated
hyperlink, by specifying the
transaction
attribute
with a value of
true
.
<html:options>
tag now supports Enumeration
for the
collection
property.
<html:form>
tag now creates attributes for
the tag itself, and the form bean, in request scope
instead of
page scope. Among other benefits, this allows you to nest
the
fields of a form inside a separate page that is accessed
via a
template or a
<jsp:include>
tag.
styleId
attribute has been added to all of the
tags where the corresponding
id
tag is relevant, to
identify a specific tag for the purposes of stylesheet
references.
<html:file>
tag now supports the
size
attribute to set the size of the file list
field.
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 Enumeration
for the
collection
property.
<logic:iterate>
tag now exposes the current
iteration index to nested tags, through a call to the
getIndex()
method.
The following new features have been added to the
struts-template
custom tag library (package
org.apache.struts.taglib.template
):
<template:get>
tag now has an optional
"flush" attribute that causes the response to be committed
prior
to performing the include, if set to "true". This allows
working
around problems on broken servlet containers.
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 basic
controller framework (package
org.apache.struts.action
):
DiskMultipartRequestHandler
now tries to retrieve the
temporary directory provided by the servlet container
before all other
possible temporary directories.
The following changes and bug fixes have occurred in the
utilities
(package
org.apache.struts.util
):
computeURL()
method now returns a
MalformedURLException
if a URL cannot be created.
Previously, this case returned
null
with no error
message, making some problems difficult to track down.
The following changes and bug fixes have occurred in the
struts-html
custom tag library (package
org.apache.struts.taglib.html
):
<html:image>
tag now correctly generates a
closing double quote on the
name
attribute.
<html:form>
tag now generates a hyperlink
that includes any query parameters that were included in
the original
hyperlink value.
<html:link>
tag now correctly places any
specified anchor ("#xxx") in the generated hyperlink.
focus
attribute of the
<html:form>
tag now works even
when you use nested or indexed property expressions.
Previously,
this would generate an invalid JavaScript reference to the
field.
<html:checkbox>
tag now conforms to its
documentation, and sends the specified
value
to the
server if this checkbox is checked at submit time. In
addition, a
default value of
on
is sent if no value attribute is
specified.
<html:link>
and
<html:redirect>
tags now properly omit the port
number if it is the default port for the current request
scheme (80
for http, or 443 for https). Among other things, this
corrects
session management behavior on the standard port numbers.
focus
attribute of the
<html:form>
tag now works when the corresponding input field is a
radio button,
or is otherwise indexed.
disabled
and
readonly
attributes have
been added to all HTML-rendering tags where they are
relevant.
The following changes and bug fixes have occurred in the
struts-logic
custom tag library (package
org.apache.struts.taglib.logic
):
<logic:forward>
tag is now identical to that performed by the Struts
Controller
Servlet when it processes an
ActionForward
that is
returned by an
Action
.
The following changes and bug fixes to the Struts Documentation application (and corresponding contents on the Struts web site) have occurred:
<logic:iterate>
tag can run are now documented.
<bean:define>
documentation now mentions the
JSP 1.1 Specification restriction on using more than one
id
attribute with the same value in the same page.
The following changes and bug fixes to the Struts Example Application have occurred:
WEB-INF/src
.
LinkSubscriptionTag
have been eliminated.
BeanUtils.filter()
have been
replaced by calls to
ResponseUtils.filter()
.
The following changes and bug fixes to the Struts Template Example Application have occurred:
<html>
,
<head>
, and
<body>
tags.
<template:get>
or
<template:insert>
throws an exception, do not
overwrite any "real" exception that has already been
saved.