1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
|
<?xml version="1.0"?>
<document url="release-notes.html">
<properties>
<author>Craig R. McClanahan</author>
<author>Robert Leland</author>
<author>Ted Husted</author>
<author>Martin Cooper</author>
<title>Struts Release Notes (Nightly Build)</title>
</properties>
<body>
<section name="6.1 Release Notes" href="release_notes"/>
<section name="Beta Notes" href="beta">
<p>This section contains the release notes for
<strong>nightly build</strong> of the Struts Framework,
for changes that have taken place since
<a href="release-notes-1.1.html">Version 1.1 </a>
was released. For a complete list of changes since the last
production release, see the <a href="#Introduction">Introduction</a> </p>
</section>
<section name="Beta Fixes" href="beta.Changes">
<p>
<strong>ApplicationConfig:</strong> In Struts 1.2 was removed.
</p>
</section>
<section name="Introduction" href="Introduction">
<p>The remainder of this document contains the release notes for
<strong>nightly build</strong> of the Struts Framework,
and covers changes that have taken place since
<a href="release-notes-1.1.html">Version 1.1</a>
was released. The following sections cover
<a href="#New">New Features</a> and <a href="#Changes">Changes</a>
to Struts.</p>
</section>
<section name="What's Included?" href="Included">
<p>The binary distribution of this release includes the following
files relevant to Struts:</p>
<ul>
<li><code>INSTALL</code> - Brief installation instructions. See
the <code>Struts Documentation Application</code>, or online at
<a href="http://jakarta.apache.org/struts/">http://jakarta.apache.org/struts/</a>
for more information.</li>
<li><code>LICENSE</code> - The Apache Software Foundation license that
defines the terms under which you can use Struts (and other software
licensed by Apache).</li>
<li><code>README</code> - A brief introduction to Struts.</li>
<li><code>lib/</code> - Directory containing files you will need in
your own applications. The individual files of interest are:
<ul>
<li><code>commons-*.jar</code> - Release packages from the
<a href="http://jakarta.apache.org/commons/">Jakarta Commons
Project</a> that Struts relies on. You are welcome to use these
classes in your own applications. These JAR files should be
copied into the <code>/WEB-INF/lib</code> directory of
your web application.</li>
<li><code>struts.jar</code> - JAR file that contains the compiled
Java classes of Struts. You must
place this file in the <code>/WEB-INF/lib</code> directory of
your web application.</li>
<li><code>struts-xxxxx.tld</code> - The tag library descriptor files
for the Struts 1.1 tag libraries (bean, html, and logic).
You must place these files in the <code>/WEB-INF</code>
directory of your web application, and reference them with
appropriate <code><taglib></code> directives in your
web.xml file.</li>
<li><code>jdbc2_0-stdext.jar</code> - The JDBC 2.0 Optional Package
API classes (package <code>javax.sql</code>). You will need to
include this file in the <code>/WEB-INF/lib</code> directory
of your application, if it is not already made visible to web
applications by your servlet container.</li>
<li><code>struts-config_1_2.dtd</code> - The Document Type Definition
(DTD) for the Struts 1.2 configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
will be validated against an internal copy of this DTD -- this
copy is available for reference purposes only.</li>
<li><code>struts-config_1_1.dtd</code> - The Document Type Definition
(DTD) for the Struts 1.1 configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
will be validated against an internal copy of this DTD -- this
copy is available for reference purposes only.</li>
<li><code>struts-config_1_0.dtd</code> - The Document Type Definition
(DTD) for the Struts 1.0 configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
will be validated against an internal copy of this DTD -- this
copy is available for reference purposes only.</li>
<li><code>web-app_2_2.dtd</code> - The Document Type Definition (DTD)
for web.xml files conforming to the Servlet 2.2 specification.
This copy is for reference purposes only.</li>
<li><code>web-app_2_3.dtd</code> - The Document Type Definition (DTD)
for web.xml files conforming to the Servlet 2.3 specification.
This copy is for reference purposes only.</li>
</ul></li>
<li><code>webapps/</code> - Web Application Archive (WAR) files for the
web applications that are included with Struts.</li>
</ul>
<p>The following Jakarta Commons libraries are included with this release
of Struts:</p>
<ul>
<li>Commons BeanUtils 1.6.1</li>
<li>Commons Collections 2.1</li>
<li>Commons Digester 1.5</li>
<li>Commons FileUpload 1.0</li>
<li>Commons Lang 2.0</li>
<li>Commons Logging 1.0.3</li>
<li>Commons Validator 1.1.0</li>
</ul>
</section>
<section name="What's New?" href="New">
<p>Following are highlights of the new features. In the next section, we
provide links to the JavaDocs for the affected classes.</p>
<p><strong>New Configuration DTD</strong></p>
<p> The Struts Configuration 1.1 DTD has been deprecated in favor of the
<code><a href="http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">struts-config_1_2.dtd</a></code>.
In the Struts 1.2 release, existing Struts configuration files can be
loaded using either DTD version. The new DTD adds two new elements <display-name>
and <description> to the struts-config element.
There are for use by struts config file tools and document generation.
</p>
<p><strong>New Dependencies on Commons packages</strong></p>
<p>The resource component of Struts 1.1 has been found to be useful in
general Java development (and not just useful for building Struts-based
web applications), and have been migrated into the
<a href="http://jakarta.apache.org/commons/">Jakarta Commons Project</a>.
As a result, the current development version of Struts has been modified
to rely on this Commons package, rather than the
Struts internal version. In nearly every case, this involved changing
only the <code>import</code> statements at the top of your classes. Any
applications that utilize these classes will need to be modified in the
same way. </p>
<p>The following Commons packages contain the replacements for the
corresponding Struts 1.1 classes:</p>
<ul>
<li><strong>Resources Package</strong>
[<a href="http://jakarta.apache.org/commons/resources.html"><code>org.apache.commons.resources</code></a>] -
<code>org.apache.struts.utils.MessageResources</code></li>
</ul>
<p><strong>NOTE! XML Parser Prerequisite Updated</strong></p>
<p>Struts now depends on an XML parser that conforms to the JAXP/1.1
(rather than JAXP/1.0) APIs. Parsers known to work include the JAXP/1.1
reference implementation, and Xerces 1.3.1.</p>
<p><strong>SOURCE DEVELOPERS NOTE! Ant Prerequisite Updated</strong></p>
<p>To build Struts from source Ant 1.5.2 or later is now required. This
does not affect developers that use Struts from the binary distribution.</p>
<p>The source for these components is available in the Struts source
distribution. Binary distributions may also be made available with the Struts
download area. As optional components, these products have their own
release cycles.</p>
<p><strong>Action Package Additions</strong></p>
<p>The following new features have been added to the basic controller
framework [<code>org.apache.struts.action</code>]:</p>
<p><strong>Actions Package Additions</strong></p>
<p>The following new features have been added to the adapters between the
incoming HTTP request and the corresponding business logic
framework [<code>org.apache.struts.actions</code>]:</p>
<ul>
<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>
</ul>
<p><strong>Util Package Additions</strong></p>
<p>The following new features have been added to the utility classes
[<code>org.apache.struts.util</code>]:</p>
<p><strong>Validator Package Additions</strong></p>
<p>The following new features have been added to the validator classes
[<code>org.apache.struts.validator</code>]:</p>
<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>
<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>
</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><strong>HTML Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-html</em> custom tag library [<code>org.apache.struts.taglib.html</code>]:</p>
<p><strong>Logic Taglib Package Additions</strong></p>
<p>The following new features have been added to the
<em>struts-logic</em> custom tag library [<code>org.apache.struts.taglib.logic</code>]:</p>
<p><strong>Documentation Additions</strong></p>
<p>The following new features have been added to the Struts Documentation
application (and corresponding contents on the Struts web site):</p>
</section>
<section name="Operational Changes and Bug Fixes" href="Changes">
<p><strong>Struts Configuration Changes</strong></p>
<p>The following changes and bug fixes have occurred in the configuration
files related to Struts:</p>
<ul>
<li>Japanese resources updates for Struts, its example, upload, tiles-documentation.</li>
</ul>
<p><strong>Config Package</strong></p>
<p><strong>Action Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the basic
controller framework (package <code>org.apache.struts.action</code>):</p>
<p><strong>Upload Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the file upload
package (package <code>org.apache.struts.upload</code>):</p>
<ul>
<li>None.</li>
</ul>
<p><strong>Utility Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the utilities
(package <code>org.apache.struts.util</code>):</p>
<ul>
<li>RequestUtils: </li>
</ul>
<p><strong>Bean Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the
<em>struts-bean</em> custom tag library
[<code>org.apache.struts.taglib.bean</code>]:</p>
<p><strong>HTML Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
<p><strong>Logic Taglib Package Changes</strong></p>
<p>The following changes and bug fixes have occurred in the
<em>struts-logic</em> custom tag library (package
<code>org.apache.struts.taglib.logic</code>):</p>
<ul>
<li>None.</li>
</ul>
<p><strong>Documentation Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Documentation
application (and corresponding contents on the Struts web site) have
occurred:</p>
<p><strong>MailReader Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts MailReader Example Application
have occurred:</p>
<p><strong>Template Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Template Example
Application have occurred:</p>
<ul>
<li>Removed.</li>
</ul>
<p><strong>Exercise Taglib Example Application Changes</strong></p>
<p>The following changes and bug fixes to the Struts Exercise Taglib Example
Application have occurred:</p>
</section>
<section name="What's different?" href="diff">
<p>This section provides links to the Struts JavaDoc for any classes that have
been added or deprecated since the Struts 1.0 release.
</p>
<p><strong>Previously deprecated classes and packages removed in Struts 1.2</strong></p>
<ul>
<li>Removed:
<code>org.apache.struts.xxxx</code>
</li>
</ul>
<p><strong>Packages added in Struts 1.2</strong></p>
<p><strong>Classes added in Struts 1.2</strong></p>
<p>action</p>
<p>actions</p>
<p>taglib.html</p>
<p>taglib.logic</p>
<p>upload</p>
<p>util</p>
<p><strong>Classes with members added in Struts 1.2</strong></p>
<p><a href="../api/org/apache/struts/action/ActionServlet.html">action.A</a><a href="../api/org/apache/struts/action/ActionServlet.html">ActionServlet</a></p>
<ul>
<li>initModuleConfigFactory()</li>
<li>methods created for backward-compatiblity only</li>
</ul>
<p><a href="../api/org/apache/struts/validator/ValidatorPlugin.html">validator.html</a></p>
<ul>
<li>isStopOnFirstError</li>
<li>setStopOnFirstError</li>
</ul>
<p><strong>Classes deprecated between Struts 1.1 and Struts 1.2</strong></p>
<p>action</p>
<ul>
<li><a href="../api/org/apache/struts/xxx/xxxx.html"> xxx</a></li>
</ul>
<p><strong>Classes with members deprecated between Struts 1.1 and Struts 1.2</strong></p>
<p><a href="../api/org/apache/struts/xxxx/xxxx.html">class.method</a></p>
<p><strong>Classes with members removed between Struts 1.1 and Struts 1.2</strong></p>
<p>validator-rules.xml, range() - use intRange() instead.</p>
</section>
<section>
<p class="right">
Next: <a href="installation.html">Installation</a>
</p>
</section>
</body>
</document>
|
