直線上に配置
Strutsのページにある Struts Release Notes (Version 1.1 Release Candidate 1)の日本語訳です
Getting Started
6.1 Release Notes

Contributors:

  • Craig R. McClanahan
  • Robert Leland
  • Ted Husted
  • Martin Cooper
Beta Notes

This section contains the release notes for nightly build of the Struts Framework, for changes that have taken place since Version 1.1 beta 2 was released. For a complete list of changes since the last production release, see the Introduction

この章は、Strutsフレームワークのnightly buildに関するリリースノートと、Version 1.1 beta 2がリリースされてからの変更点を含んでいます。 最後のプロダクションリリースからの変更の完全なリストは、Introductionを参照してください

Beta Fixes

ApplicationConfig: In Struts 1.1. beta 3, the ApplicationConfig class is renamed to ModuleConfig, to conform with the venacular.

ApplicationConfig: Struts 1.1. beta 3では、ApplicationConfigクラスはModuleConfigに名前が変わりました。

Dyna*Form: In Struts 1.1. beta 3, the reset method was changed so that it conforms to the original ActionForm implementation.

Dyna*Form: Struts 1.1. beta 3では、 オリジナルのActionFormの実装 に一致するによう、リセットメソッドが変更されました。

Blank application: Fixed configuration problem with Struts Blank application.

Blank application: Struts Blank アプリケーションに伴う設定の問題を修正しました。
Introduction

The remainder of this document contains the release notes for nightly build of the Struts Framework, and covers changes that have taken place since Version 1.0.2 was released. The following sections cover New Features and Changes to Struts.

このドキュメントの残りは、Strutsフレームワークのnightly buildのリリースノートを含んでおり、 Version 1.0.2がリリースされてからの変更点をカバーしています。

What's Included?

The binary distribution of this release includes the following files relevant to Struts:

このリリースのバイナリディストリビューションは、Struts に関連した以下のファイルを含んでいます。:

  • 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:
    • commons-*.jar - Release packages from the Jakarta Commons Project that Struts relies on. You are welcome to use these classes in your own applications. These JAR files should be copied into the /WEB-INF/lib directory of your web application.
    • struts.jar - JAR file that contains the compiled Java classes 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.1 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.
    • 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_1.dtd - The document type descriptor (DTD) for the Struts 1.1 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.
    • struts-config_1_0.dtd - The document type descriptor (DTD) for the Struts 1.0 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.
  • INSTALL - インストール説明の概要。 詳しい情報は Struts Documentation Application、またはオンラインの http://jakarta.apache.org/struts/ を見てください。
  • LICENSE - Apache Software Foundation license です。 これには、Struts(とその他の Apacheによりライセンスされるソフトウェア)の使用条件が 定義されています。
  • README - Struts の 紹介の概要。
  • lib/ - アプリケーションで必要となるファイルを含んだディレクトリ。 それぞれのファイルの関連は
    • commons-*.jar - Struts に関係のある Jakarta Commons Project からの リリースパッケージ。 これらは、Webアプリケーションの /WEB-INF/lib ディレクトリに コピーされるべき JARファイルです。
    • struts.jar - Struts の コンパイル済み Javaクラスを含む JAR ファイル。 このファイルは、Web アプリケーションの /WEB-INF/lib ディレクトリ に配置する必要があります。
    • struts-xxxxx.tld - Struts 1.1 タグライブラリ(bean、html、logic、template) のタグライブラリ記述子ファイル。 このファイルは Web アプリケーションの /WEB-INF ディレクトリに配置する必要があります。 そして、web.xml ファイル内の <taglib> 指示で適切にそれを参照します。
    • jdbc2_0-stdext.jar - JDBC 2.0 の Optional Package API クラス (package javax.sql)。servletコンテナの構成によって Webアプリケーションから 見えない場合は、このファイルを Webアプリケーションの /WEB-INF/lib に配置してください。
    • struts-config_1_1.dtd - Strut 1.1 のコンフィグレーションファイル(通常は /WEB-INF/struts-config.xml という名称)のドキュメントタイプ記述子(DTD) 。 コンフィグレーションファイルは、このDTDの内部コピーに対して有効です。 -- このコピーは参照時のみ利用可能です。
    • struts-config_1_0.dtd - Strut 1.0 のコンフィグレーションファイル(通常は /WEB-INF/struts-config.xml という名称)のドキュメントタイプ記述子(DTD) 。 コンフィグレーションファイルは、このDTDの内部コピーに反していないかを検査されます。 -- このコピーは参照時のみ利用可能です。
    • web-app_2_2.dtd - Servlet 2.2 仕様に準拠する web.xml ファイル のための、 ドキュメントタイプ記述子(DTD) 。これは参照用です。
    • web-app_2_3.dtd - Servlet 2.3 仕様に準拠する web.xml ファイル のための、 ドキュメントタイプ記述子(DTD) 。これは参照用です。
  • webapps/ - Struts に含まれる Web アプリケーションのための、 Web アプリケーション アーカイブ(WAR) ファイル。
What's New?

Following are highlights of the new features. In the next section, we provide links to the JavaDocs for the affected classes.

以下は、新機能のハイライトです。次の章では、影響を受けたクラスのJavaDocsへのリンクを提供します。

New Configuration DTD

新しいコンフィグレーション DTD

The Struts Configuration 1.0 DTD has been deprecated in favor of the struts-config_1_1.dtd. In the Struts 1.1 release, existing Struts configuration files can be loaded using either DTD version.

Strutsコンフィグレーション 1.0 DTDは、struts-config_1_1.dtd.を支持し、大いに非難されました。Struts1.1リリースでは、Sturtsコンフィグレーションファイルは、どちらか一方のDTDバージョンをロードして利用する事が可能です。

New Dependencies on Commons packages

Commons パッケージ内の新たな依存

Several components of Struts 1.0 have 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 Jakarta Commons Project. As a result, the current development version of Struts has been modified to rely on the Commons packages containing these classes, rather than the Struts internal versions. In nearly every case, this involved changing only the import statements at the top of your classes. Any applications that utilize these classes will need to be modified in the same way.

Struts 1.0 のいくつかのコンポーネントは、一般のJavaデベロッパー (StrutsベースのWebアプリケーションの役に立つだけではなくて)の役にたつことがわかりました。 そのため、Jakarta Commons Projectに移動しました。 結果として、現在バージョンのStruts の開発は、Struts の内のバージョンよりも、 これらのクラスを含む Commonパッケージを適用するように修正されましたq。 ほとんどすべてのケースで、クラスのトップの import文のだけの変更を必要としました。 これらのクラスを使っているどのアプリケーションでも、同様な方法で修正する必要があります。

The following Commons packages contain the replacements for the corresponding Struts 1.0 classes:

次の Commonsパッケージは、対応する Struts 1.0クラスで変換するものを含んでいます。

  • BeanUtils Package [org.apache.commons.beanutils] - org.apache.struts.utils.BeanUtils, org.apache.struts.utils.ConvertUtils, and org.apache.struts.utils.PropertyUtils.
  • Collections Package [org.apache.commons.collections] - org.apache.struts.util.ArrayStack, org.apache.struts.util.FastArrayList, org.apache.struts.util.FastHashMap, org.apache.struts.util.FastTreeMap.
  • Digester Package - [org.apache.commons.digester] - org.apache.struts.digester.*.

The following Commons packages are also now used by various components of the Struts framework:

下記のCommonsパッケージは、Strutsフレームワークの様々なコンポーネントによって現在利用されています:

NOTE! XML Parser Prerequisite Updated

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.

ノート! XML パーザ必要条件のアップデート

Strutsは現在、JAXP/1.1(JAXP/1.0よりも) に従う XMLパーサに依存します。 既知の動作パーサーは、JAXP/1.1リファレンス実装や、Xerces 1.3.1 です。

SOURCE DEVELOPERS NOTE! Ant Prerequisite Updated

To build Struts from source Ant 1.4 or later is now required. This does not affect developers that use Struts from the binary distribution.

ソース開発者ノート! Ant 必要条件のアップデート

ソースからStrutsをビルドするには、Ant 1.4または最新版が現在必要です。 バイナリディストリビューションからStrutsを利用する開発者には影響しません。

Struts Validator Integration

The new Commons-Validator is now integrated with Struts and exposed through the new Validator package.

Struts Validator の統合

新しいCommons-ValidatorはStrutsに統合され、新しいValidatorパッケージとして公開されました

Tiles - An advanced templating taglib

The Tiles JSP assembly framework has been integrated with Struts.

Tiles - 先進的テンプレーティング タグライブラリ

Tiles JSP 組立フレームワークは、Strutsに統合されました

Nested - An very cool taglib extension

The Nested taglib is bundled with Struts and enhances the functionality of the existing Struts tags.

Nested - とてもクールな拡張タグライブラリ

Nestedタグライブラリは、Strutsにバンドルされ、既存のStrutsタグの機能性を増強します

New Example Applications

New example applications for the Validator and Tiles are now part of the Struts distribution.

新しいサンプルアプリケーション

ValidatorとTilesのための新しいサンプルアプリケーションは、 Sturtsディストリビューションの一部として配布されています

New Contrib directory for optional components

A new directory (contrib) in the CVS source repository has been added to accumulate Struts add-on extensions that are generally useful but have not yet been integrated into the standard code base.

オプショナルコンポーネントのための新しいContribディレクトリ

CVSソースリポジトリ内の新しいディレクトリ(contrib)は、 一般的に有用ではあるが、まだ標準のコードベースへ統合されていないStrutsアドオン拡張を蓄積するために追加されました。

  • Scaffold - An extension of the Commons Scaffold toolkit of reusable classes for building web applications.
  • Struts-el - The optional Struts-el taglib makes it easy to use Struts with JSTL (container with servlet 2.3 support required).

  • Scaffold - Webアプリケーションを構築するための再利用可能なクラスのCommons Scaffoldツールキットの拡張
  • Struts-el - オプションのStruts-elタグライブラリは、JSTLをStrutsで利用する事を容易にします。(サーブレットコンテナは2.3をサポートしている必要があります).

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.

これらのコンポーネントのためのソースは、Strutsソースディストリビューション内で利用可能です。バイナリディストリビューションも、Strutsダウンロードエリアで利用可能になるでしょう。オプションのコンポーネントとしてこれらのプロダクトは、自分のリリースサイクルを持っています。

Action Package Additions

The following new features have been added to the basic controller framework [org.apache.struts.action]:

  • The ActionServlet now provides support for modular Struts applications and sports several new extension points.
  • The new ActionMessages class will support a superset of the capabilities of ActionErrors, and will be useful as a collection of general purpose messages, not just errors.

Action パッケージへの追加

下記の新しい機能がベーシックコントローラフレームワーク[org.apache.struts.action]に追加されました:

  • ActionServletは現在、モジュール式のStrutsアプリケーションのサポートとと、いくつかの新しい拡張ポイントを提供しています
  • 新しい ActionMessages は、ActionErrors の能力のスーパーセットをサポートし、エラーだけではなく 一般的なメッセージの目的のコレクションに役に立つでしょう

Upload Package Additions

The following new features have been added to the file upload classes [org.apache.struts.upload]:

  • CommonsMultipartRequestHandler: New class that implements file upload using the Jakarta Commons FileUpload package.

Upload パッケージへの追加

下記の新しい機能がファイルアップロードクラス群 [org.apache.struts.upload]に追加されました:

  • CommonsMultipartRequestHandler: Jakarta Commons FileUploadパッケージを使い、ファイルアップロードを実装した新しいクラス

Util Package Additions

The following new features have been added to the utility classes [org.apache.struts.util]:

  • LocalStrings: Correct message regarding replaceable parameter so that it does not append an extraneous character.
  • LabelValueBean: New class that defines a collection of name/value pairs that can be used with the <html:options> tag, and elsewhere.
  • MessageResources: Escape any single quote characters that are included in the specified message string.
  • computeParameters: Allow a transaction token to be the only parameter in .
  • RequestUtils: Change to encode ampersands when building a query string.

Util パッケージへの追加

下記の新しい機能がユーティリティクラス群[org.apache.struts.util]に追加されました:

  • LocalStrings: 置換可能なパラメータに関して,無関係な文字を追加しないようにメッセージを修正。
  • LabelValueBean: <html:options>タグと他の所で利用可能な、名前/値のペアのコレクションを定義した新しいクラス。
  • MessageResources: 指定されたメッセージストリングに含まれている全てのシングルクォート文字をエスケープします
  • computeParameters: パラーメータのためだけのトランザクショントークンを提供します
  • RequestUtils: Change to encode ampersands when building a query string.
  • 要求文字列を構築する場合のアンパサンドをエンコード変換します

Bean Taglib Package Additions

The following new features have been added to the struts-bean custom tag library [org.apache.struts.taglib.bean]:

  • <bean:write>: Add format, locale and bundle attributes to support formatting values according to current user locale, format string from attribute or format string from string resources.
  • <bean:cookie>, <bean:header>, or <bean:parameter>: Correct the generated scripting variable type when tag is used with the "multiple" attribute.
  • <bean:message>: Added name, property, and scope attributes to the tag, so that the message source key can be obtained dynamically from a bean or bean property.

Bean タグライブラリパッケージへの追加

下記の新機能がstruts-bean カスタムタグライブラリ[org.apache.struts.taglib.bean]に追加されました:

  • <bean:write>: format、locale と bundle属性のフォーマットを追加し、現在のユーザの locale や、 属性、もしくは文字列リソースからのフォーマット文字列にしたがって値のフォーマッティングをサポートします
  • <bean:cookie>, <bean:header>, or <bean:parameter>: "multiple" 属性とともに使われる場合に生成するスクリプトの変数の型を修正しました
  • <bean:message>: namepropertyscope属性をタグに追加しました。よってメッセージリソースキーを、bean や、beanプロパティから動的に 取得することができます。

HTML Taglib Package Additions

The following new features have been added to the struts-html custom tag library [org.apache.struts.taglib.html]:

  • <html:link>: Added 'action' attribute.
  • <html:options>: If the property specified by the 'property' attribute returns null, tag now throws an error message that indicates what the real problem is, rather than causing an NPE.
  • <html:option> and <html:options>: Added 'style' and 'styleClass' attributes.
  • <html:optionsCollection>: New tag providing a cleaner way of populating HTML options from a collection.
  • <bean:message>: Added 'name', 'property' and 'scope' attributes so that the message resource key can be obtained dynamically from a bean.
  • <html:messages>: New tag to iterate through a message collection in the new ActionMessages class.
  • ActionForm: Tag will now call reset() if it instantiates the ActionForm bean. This also requires that the bean instantiated by the tag to be an ActionForm subclass.
  • <html:image>: Added the 'align' attribute.
  • <html:img>: Added the mouse event attributes ('onclick', 'ondblclick', 'onmousedown', 'onmouseup', 'onmouseover', 'onmousemove', 'onmouseout').
  • SubmitTag, SelectTag, LinkTag.java, CheckboxTag, ButtonTag, ImageTag, RadioTag, and TextArea tags: Added indexed property.

HTML タグライブラリパッケージへの追加

下記の新しい機能が struts-html カスタムタグライブラリ[org.apache.struts.taglib.html]に追加されました:

  • <html:link>: 'action' 属性の追加.
  • <html:options>: もし、'property'によるプロパティ属性が定義された場合の戻り値がnullなら、タグは現在、NPE(Null Pointer Exception)を引き起こすのではなく、本来の問題は何かを表示したエラーメッセージを表示します。
  • <html:option> and <html:options>: 'style' と 'styleClass' 属性を追加しました
  • <html:optionsCollection>: コレクションから HTML オプションをセットするための,より明快な方法を提供する新しいタグ。
  • <bean:message>: Beanからメッセージリソースキーをダイナミックに得る事が出来るように、'name', 'property' と'scope' 属性を追加しました。
  • <html:messages>: 新しいActionMessagesクラス内のメッセージコレクションによって繰り返す新しいタグ
  • ActionForm: タグは現在、もし、ActionFormビーンのインスタンスならreset() を呼び出します。これには、ActionFormのサブクラスであり、タグによってインスタンス化されたビーンである事が必要です。
  • <html:image>: 'align' 属性の追加
  • <html:img>: マウスイベント属性('onclick', 'ondblclick', 'onmousedown', 'onmouseup', 'onmouseover', 'onmousemove', 'onmouseout')の追加
  • SubmitTag, SelectTag, LinkTag.java, CheckboxTag, ButtonTag, ImageTag, RadioTag, and TextArea tags: indexed プロパティの追加

Logic Taglib Package Additions

The following new features have been added to the struts-logic custom tag library [org.apache.struts.taglib.logic]:

  • <logic:empty> and <logic:notEmpty>: New tags that are similar to <logic:present> and <logic:notPresent> except for the treatment of empty strings.

Logic タグライブラリパッケージへの追加

以下の新しい機能をstruts-logic カスタムタグライブラリ[org.apache.struts.taglib.logic]に追加しました:

  • <logic:empty><logic:notEmpty>: 新しいタグは空のストリングの扱いという事以外は <logic:present><logic:notPresent> に似ています

Template Taglib Package Additions

The following new features have been added to the struts-template custom tag library [org.apache.struts.taglib.template]:

  • None.

Template タグパッケージへの追加

以下の新しい機能をstruts-template カスタムタグライブラリ [org.apache.struts.taglib.template]に追加しました:

  • なし.

Documentation Additions

The following new features have been added to the Struts Documentation application (and corresponding contents on the Struts web site):

  • Version Differences: New section in Release Notes to link to the JavaDocs for all Struts classes and members added or changed between versions.
  • FAQ/HowTos: New documentation category organizes our FAQs and example-driven howTos. New HowTos include "Building Applications", "Using SSL", and using Struts with Eclipse or NetBeans.
  • User Guide Preface: New section to overview the enabling technologies behind Struts.
  • Developer Guides: Added "cover page" to guides. These then link to the Package Descriptions and the API guides.
  • HTML tag documentation: expanded to cover using indexed properties with iterate.
  • Site Menu: Removed separate links to taglib documentation, since these are now in the Developer Guide.
  • Newbie FAQ: The questions most likely to be asked by new developers using Struts. Still under development.
  • Kickstart FAQ: The questions most likely to be asked when selecting Struts.
  • 1.0 JavaDoc: Added archival copy to web site for future reference.
  • The UserGuide "Building" pages: General revisions to reflect new features and current practices.
  • Installation: Updated instructions for SilverStream and Resin. Add installation notes for Jetty. Added RexIP to list of nominal containers.
  • JavaDocs: New @since Struts 1.1 tag to indicate new packages, classes, and members added after the Struts 1.0.x version

ドキュメントへの追加

下記の新しい機能がStrutsドキュメントアプリケーション(と対応するStruts Webサイト)に追加されました:

  • Version Differences:リリースノート内の新しいセクションは、バージョン間の全てのStrutsクラスとメンバへの追加または変更のJavaDocへのリンクです
  • FAQ/HowTos: 新しいドキュメントカテゴリは、私たちのFAQと例題に基ずくハウトゥーから構成されています。新しいハウトゥーは、“アプリケーションの作成”、“SSLを使う”とEclipse、NetBeansでStrutsを使うを含んでいます
  • User Guide Preface: 新しいセクションは、Strutsを支持する有効なテクノロジの概要です
  • Developer Guides: ガイドの表紙を追加しました。パッケージ記述とAPIガイドにリンクしています
  • HTML tag documentation: 繰り返におけるindexed属性の使い方をカバーするように拡張しました
  • Site Menu: タグドキュメントへの個別のリンクを削除し、現在は開発者ガイド内にあります。
  • Newbie FAQ: Strutsを使う新しい開発者から尋ねられるよくある質問と答え
  • Kickstart FAQ: Strutsを選択した時に尋ねられるよくある質問と答え
  • 1.0 JavaDoc: アーカイブの将来の参照用のwebサイトへのコピーを追加
  • The UserGuide "Building" pages: 新しい機能と現在の実際を反映する一般的な変更の追加
  • Installation: Updated instructions for SilverStream and Resin. Add installation notes for Jetty. Added RexIP to list of nominal containers. SilverStreamとResinへの指示の更新。Jettyへのインストールノートの追加。 コンテナの名前のリストにRexIPを追加
  • JavaDocs: Struts 1.0.xバージョン以降の新しいパッケージとクラスとメンバに新しいタグ@since Struts 1.1を追加
Operational Changes and Bug Fixes

Struts Configuration Changes

The following changes and bug fixes have occurred in the configuration files related to Struts:

  • Deprecated (Struts 0.5) configuration file format: Remove support.
  • Deprecated (Struts 0.5) methods: Remove from codebase.

Struts の設定変更

下記の変更とバグフィックスがStrutsに関連する設定ファイル内に発生しました:

  • Struts 0.5の設定ファイルフォーマットは推奨されません: サポートの削除.
  • Struts 0.5メソッドは推奨されません: コードベースから削除.

Added Config Package

  • ControllerConfig: Added inputForward property to indicate that ActionMapping.input is a forward rather than a URI.
  • ControllerConfig: Added forwardPattern and inputPattern to help manage page directories in application modules.
  • Added package to provide more flexibility in configuring the controller and to provide support for modular applications

Configパッケージへの追加

  • ControllerConfig: ActionMappingを提示するinputForwardプロパティを追加。インプットはURLではなくforwardです
  • ControllerConfig: アプリケーションモジュール内のページディレクトリの管理を助けるforwardPatternとinputPatternを追加
  • コントローラの設定をもっとフレキシブルにし、 アプリケーションのモジュール化のサポートを提供するパッケージを追加

Action Package Changes

The following changes and bug fixes have occurred in the basic controller framework (package org.apache.struts.action):

  • ActionMapping: input property may now refer to an ActionForward rather than a module-relative path if inputForward is set to true on the module's ControllerConfig bean [org.apache.struts.config.ControllerConfig.
  • ActionServlet: Added convertNull parameter to simulate the Struts 1.0 behavior when populating forms. If set to true, the numeric Java wrapper class types (like java.lang.Integer) will default to null (rather than 0).
  • ActionServlet: Added "config/$foo" parameter and deprecated several others in favor of components in the new config package.
  • ActionForms and related classes: now use a StringBuffer when responding a toString request in order to conserve resources.
  • LookupDispatchAction: Added standard Action to help select between internationalized buttons.
  • ActionForm class: Modified to use ActionServletWrapper rather than expose ActionServlet.
  • ActionServletWrapper class: Added for use by ActionForm to prevent the Public String properties of ActionServlet from being changed via a query string.
  • Action.MAPPING_KEY request attribute: Unconditionally pass the selected mapping as a request attribute ("org.apache.struts.action.mapping.instance") even if no form bean is specified.
  • ActionServlet: Avoid a NullPointerException in corner cases caused by failed initialization of servlet.
  • ActionForm class: Now truly serializable, because the two non-serializable instance variables (servlet and multipartRequestHandler) have been made transient. However, if you actually do serialize and deserialize such instances, it is your responsibility to reset these two properties.
  • ActionMessages and ActionErrors: The initial order a property/key is added in is now retained.

Action パッケージへの変更

下記の変更とバグフィックスがベーシックコントローラフレームワーク (package org.apache.struts.action)に行われました:

  • ActionMapping: モジュールのControllerConfigビーン[org.apache.struts.config.ControllerConfig]内のinputForwardがtrueにセットされている場合、input属性は現在、モジュール関係パスではなくActionForwardを参照するでしょう
  • ActionServlet: フォームへの設定の場合のStruts1.0の振る舞いをシミュレートするconvertNullパラメータを追加。もしtrueに設定した場合、数値のJavaラッパクラスタイプ(java.lang.Integerのような)のデフォルトはnullです(0ではなく)
  • ActionServlet: "config/$foo"パラメータを追加するとともに,他のいくつかのオプションを非推奨にして,新しいconfigパッケージのコンポーネントを推奨するようにしました
  • ActionForms and related classes: リソースを保存するためにtoStringリクエストに答える場合、現在はStringBufferを使用します
  • LookupDispatchAction: 国際化ボタンの選択を助ける標準アクションを追加
  • ActionForm class: ActionServletを露出するのではなく、ActionServletWrapperを使用するための更新をしました。
  • ActionServletWrapper class: ActionServletのPublic文字列プロパティがクエリ文字列によって変更されるのを防ぐために、ActionFormから使われるように変更しました
  • Action.MAPPING_KEY request attribute: formビーンが指定されなくても、リクエスト属性 ("org.apache.struts.action.mapping.instance")として選択されたマッピングを無条件に渡します
  • ActionServlet: servletの初期化失敗によって引き起こされたようなケースでのNullPointerExceptionを回避します
  • ActionForm class: 現在は真にシリアライズできます。なぜなら2つの非シリアライズインスタンス変数 (servlet and multipartRequestHandler)はtansientになりました。しかし、実際にそのようなインスタンスをシリアライズとデシリアライズするなら、これら2つのプロパティをリセットするのはあなたの責任です
  • ActionMessages and ActionErrors: property/keyの初期化オーダは追加され、現在は保持されます

Upload Package Changes

The following changes and bug fixes have occurred in the file upload package (package org.apache.struts.upload):

  • CommonsMultipartRequestHandler: New implementation of file upload based on the Jakarta Commons FileUpload package. This new implementation is now the default.
  • BufferedMultipartInputStream: Fixed lost byte problem.
  • ArrayIndexOutOfBoundsException: Fixed situations where this was known to occur.
  • Multipart requests: Better reporting for premature closing of input streams while reading multipart requests.
  • New line characters: Additional fix for file corruption problem with uploads and new line characters.

Upload パッケージへの変更

下記の変更とバグフィックスがfile uploadパッケージ(package org.apache.struts.upload)に行われました:

  • CommonsMultipartRequestHandler: Jakarata Commons FileUploadパッケージをベースとしたファイルアップロードの新しい実装。この新しい実装は現在の標準です
  • BufferedMultipartInputStream: バイトが紛失する問題を修正
  • ArrayIndexOutOfBoundsException: 既知のこれが発生する状況の修正
  • Multipart requests: マルチパートリクエストの場合の入力ストリームの早すぎるクローズのためのよりよい報告
  • New line characters: アップロードおよび改行文字に関してファイルが壊れる問題を追加修正

Utility Package Changes

The following changes and bug fixes have occurred in the utilities (package org.apache.struts.util):

  • RequestUtils: Added support for forwardPattern, pagePattern, and inputForward properties on ControllerConfig.
  • GenericDataSource: Deprecated and modified to act as a thin wrapper around [org.apache.commons.dbpc.BasicDataSource]. Replaced by direct use of BasicDataSource or other compatible component.
  • RequestUtils class: Modify to use ActionServletWrapper rather than expose ActionServlet.
  • Added error message for the getActionErrors and getActionMessages method.
  • getActionErrors and getActionMessages: Added methods to generate the correct corresponding object based on the object retrieved from request scope based on the key passed in.
  • ActionErrors or ActionMessages: The logic for creating one of these objects has been moved to a utility method in RequestUtils.
  • JspException message: Now generated in RequestUtils.
  • ConvertUtils.convertCharacter(): Will now detect empty strings and return the default value.

Utility パッケージへの変更

下記の変更とバグフィックスがユーティリティ(package org.apache.struts.util)に行われました:

  • RequestUtils: ControllerConfigのforwardPattern, pagePatternとinputForwardプロパティのサポート追加
  • GenericDataSource: 非推奨となり,[org.apache.commons.dbpc.BasicDataSource]の単純なラッパとして振る舞うように修正されました。BasicDataSource やその互換コンポーネントを直接利用するように置き換えられました。
  • RequestUtils class: ActionServletを直接よりむしろActionServletWrapperを使うように修正しました
  • getActionErrorsとgetActionMessagesメソッド用のエラーメッセージを追加しました
  • getActionErrors and getActionMessages: キーに基づいてリクエストスコープから取り出されたオブジェクトに基づいて、正確に対応するオブジェクトを生成するメソッドを追加しました
  • ActionErrors or ActionMessages: これらのオブジェクトのうち1つを生成するロジックをRequestUtils内のユーティリティメソッドに移動した。
  • JspException message:現在、RequestUtils内で生成されます。
  • ConvertUtils.convertCharacter(): 現在、空の文字列を検出し、デフォルト値を戻します

Bean Taglib Package Changes

The following changes and bug fixes have occurred in the struts-bean custom tag library [org.apache.struts.taglib.bean]:

  • <html:errors>: When the property tag is specified, errors are no longer printed if the specified property has no errors. Previously errors were always printed ! Future enhancements would include additional attributes to always turn off the header or footer.
  • Made the remaining helper methods "protected" rather than "private".

Bean Taglib パッケージへの変更

下記の変更とバグフィックスがstruts-bean カスタムタグライブラリ[org.apache.struts.taglib.bean]に行われました:

  • <html:errors>: propertyタグが定義された場合、もし、指定されたプロパティがエラーを持っていないならば、エラーはもはやプリントされません。以前はエラーがいつもプリントされていました。将来の拡張はいつでも無効にできるヘッダとフッタ属性の追加です
  • "private"ではなく"protected"にヘルパメソッドをリネーミングしました

HTML Taglib Package Changes

The following changes and bug fixes have occurred in the struts-html custom tag library (package org.apache.struts.taglib.html):

  • FormTag: Fixed to exclude query string when identifying action mapping name.
  • ImgTag: Correctly URLEncode the query string parameter value even if there is only a single parameter.
  • MultiboxTag.doAfterBody(): Corrected to return SKIP_BODY instead of SKIP_PAGE.

HTML Taglib パッケージへの変更

下記の変更とバグフックスがstruts-html カスタムタグライブラリ(packageorg.apache.struts.taglib.html)に行われました:

  • FormTag: アクションマッピング名の識別時にクエリ文字列を含まないように変更
  • ImgTag: もしも単一パラーメタだとしてもクエリ文字列パラーメタの値を正しくURLEncodeする
  • MultiboxTag.doAfterBody(): SKIP_PAGEの代わりのSKIP_BODYを返却するようにした

Logic Taglib Package Changes

The following changes and bug fixes have occurred in the struts-logic custom tag library (package org.apache.struts.taglib.logic):

  • None.

Logic Taglib パッケージへの変更

下記の変更とバグフィックスが struts-logic カスタムタグライブラリ(package org.apache.struts.taglib.logic)に行われました:

  • なし.

Documentation Application Changes

The following changes and bug fixes to the Struts Documentation application (and corresponding contents on the Struts web site) have occurred:

  • Reorganized Resources into separate pages..
  • In the Tag Developers Guide, add more detail regarding file upload requirements.
  • In Building View Components, clarify that additional i18n support may be provided by the browser, and is outside the scope of the framework.
  • In Building Controller Components, document 'validating' init-param, add defaults for various parameters, clarify that some web.xml settings are not Struts-specific.
  • Tag library documentation: Moved under User's Guide.
  • Reorganized to separate 1.0 material from nightly build material.

ドキュメントアプリケーションへの変更

下記の変更とバグフィックスがStrutsドキュメントアプリケーション(と対応するStruts Webサイト)に行われました:

  • 個別のページへの再編されたリソース・・
  • タグ開発者ガイドにおいて、ファイルアップロード要求関連のさらなる詳細
  • ビューコンポーネントの作成において、付加的なi18nサポートを、フレームワークのスコープの外とブラウザが備えている事とで明確化した。
  • コントローラコンポーネントの作成において、ドキュメント'validating' init-param 、さまざまなパラーメタのデフォルト追加、いくつかのweb.xml設定がStrutsの設定ではないのを綺麗にしました
  • Tag library documentation: ユーザガイドに移動しました
  • ナイトリービルドの資源から1.0の資源を分離し再編しました

MailReader Example Application Changes

The following changes and bug fixes to the Struts MailReader Example Application have occurred:

  • Add Russian and Japanese translations of the application resources and set the character set for the example JSP pages to "UTF-8" so that it can display either English or Japanese.
  • Exchange "name" for "attribute" properties for Edit mappings in Struts configuration file.
  • Remove references to saving database data from "tour" document, since this functionality was removed.

メール購読サンプルアプリケーションへの変更

下記の変更とバグフィックスがメール購読サンプルアプリケーションに行われました

  • ロシア語と日本語のアプリケーションリソースの翻訳が追加されました、そして 英語と日本語の両方を表示できるようにサンプルのJSPページの文字セットが"UTF-8"に設定されました。
  • Struts設定ファイルの Edit マッピング中の "name" 属性を "attributte" 属性と交換しました。
  • "tour"ドキュメントからデータベースデータ保存への参照を削除しました。この機能は削除します

Template Example Application Changes

The following changes and bug fixes to the Struts Template Example Application have occurred:

  • None.

Exercise Taglib サンプルアプリケーションへの変更

下記の変更とバグフィックスがStrutsExercise Taglibサンプルアプリケーションに行われました:

  • "action"属性を使う <html:link>のテストケースを追加しました
  • ページコンテキスト内に保存されるコレクションのベースの<html:options>を使う<html:select> のテストケースを追加しまいた
What's different?

This section provides links to the Struts JavaDoc for any classes that have been added or deprecated since the Struts 1.0 release.

この章は Struts 1.0 のリリース以降で追加または非推奨になったいくつかのクラスのStruts JavaDocへのリンクを提供します

Previously deprecated classes and packages removed in Struts 1.1

以前に非推奨になったクラスとパッケージはStruts1.1では削除されました

  • Removed: org.apache.struts.utils.BeanUtils, org.apache.struts.utils.ConvertUtils, and org.apache.struts.utils.PropertyUtils - replaced by org.apache.commons.beanutils
  • Removed: org.apache.struts.util.ArrayStack, org.apache.struts.util.FastArrayList, org.apache.struts.util.FastHashMap, org.apache.struts.util.FastTreeMap - replaced by org.apache.commons.collections
  • Removed: org.apache.struts.digester.* - replaced by org.apache.commons.digester
  • Removed: The struts-config.dtd - Replaced by struts-config_1_1.dtd.
  • Removed: The omnibus "struts" taglib and its associated TLD - replaced by separate bean, logic, and html taglibs.
  • Removed: The "form" taglib and its associated TLD - replaced by (renamed as) the html taglib.
  • 削除: org.apache.struts.utils.BeanUtils, org.apache.struts.utils.ConvertUtils, と org.apache.struts.utils.PropertyUtils - org.apache.commons.beanutilsによって置き換えられました
  • 削除: org.apache.struts.util.ArrayStack, org.apache.struts.util.FastArrayList, org.apache.struts.util.FastHashMap, org.apache.struts.util.FastTreeMap - org.apache.commons.collectionsによって置き換えられました
  • 削除: org.apache.struts.digester.* - org.apache.commons.digesterによって置き換えられました
  • 削除: struts-config.dtd - struts-config_1_1.dtdによって置き換えられました
  • 削除: 統括的な"struts"タグライブラリと、その関連したTLD - 個別のbean, logic, and html タグライブラリに置き換えられました
  • 削除: The "form" taglib and its associated TLD - replaced by (renamed as) the html taglib. "form"タグライブラリとその関連したTLD - htmlタグライブラリに置き換え(名前変更)られました

Packages added in Struts 1.1

Struts 1.1に追加されたパッケージ

Classes added in Struts 1.1

Struts 1.1に追加されたクラス

action

actions

taglib.html

taglib.logic

upload

util

Classes with members added in Struts 1.1

Struts 1.1でのクラスへのメンバ追加

action.Action

  • ACTION_SERVLET_KEY
  • APPLICATION_KEY
  • MESSAGE_KEY
  • PLUG_INS_KEY
  • REQUEST_PROCESSOR_KEY
  • execute
  • getResources(javax.servlet.http.HttpServletRequest)
  • saveMessages

action.ActionServlet

  • configDigester
  • convertHack
  • log
  • processor
  • getInternal
  • destroyApplications
  • destroyConfigDigester
  • getApplicationConfig
  • getRequestProcessor
  • initApplicationConfig
  • initApplicationDataSources
  • initApplicationPlugIns
  • initApplicationMessageResources
  • initConfigDigester
  • methods created for backward-compatiblity only
    • defaultControllerConfig
    • defaultFormBeansConfig
    • defaultForwardsConfig
    • defaultMappingsConfig
    • defaultMessageResourcesConfig

taglib.html.BaseHandlerTag

  • indexed
  • setIndexed
  • getIndexed

Classes deprecated between Struts 1.0 and Struts 1.1

Struts 1.0 から Struts 1.1において非推奨になったクラス

action

Classes with members deprecated between Struts 1.0 and Struts 1.1

Struts 1.0 から Struts 1.1において非推奨になったクラスのメンバ

action.Action

  • FORM_BEANS_KEY
  • FORWARDS_KEY
  • MAPPINGS_KEY
  • getResources()
  • perform

ActionServlet

  • findDataSource
  • findFormBean
  • findForward
  • findMapping
  • initDataSources
  • methods created for backward-compatiblity only
    • defaultControllerConfig
    • defaultFormBeansConfig
    • defaultForwardsConfig
    • defaultMappingsConfig
    • defaultMessageResourcesConfig

Copyright (c) 2000-2002, Apache Software Foundation
直線上に配置
Translated by Yukimitsu Kurozumi
Cooperator : Keiichi Matsunaga