<?xml version="1.0" encoding="Shift_JIS"?>
<!--
  Copyright 2003-2004 The Apache Software Foundation.

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.

  $Id: changes.xml,v 1.7 2005/03/19 07:56:56 nekop Exp $
-->
<document>
  <properties>
    <title>Velocity Tools Changes</title>
    <author email="nathan@esha.com">Nathan Bubna</author>
    <translator email="fwhw4835@mb.infoweb.ne.jp">日置 聡</translator>
    <translator email="tatakaha@jajakarta.org">高橋 達男</translator>
    <projectfile>xdocs-ja/menu.xml</projectfile>
  </properties>
<body>
  <section name="Velocity Tools Changes" alias="Velocity Tools 変更履歴">
    <primary>
    <p>This document tracks the changes in Velocity Tools between releases.</p>
    </primary>
    <p>この文書は Velocity Tools のリリース間において行われた変更内容を記載します。</p>

    <subsection name="1.1">
      <primary>
      <p>This section describes changes after the 1.1-rc1 release.</p>
      <ul>
      <li>Deprecated StrutsUtils' getActionErrors() and getActionMessages() in favor of getErrors() and getMessages(). (ndb)</li>
      <li>Fixed javadoc warnings during build (patch contributed by Nathan Green). (ndb)</li>
      <li>Some minor improvements to Struts example apps. (maj)</li>
      </ul>
      </primary>
      
      <p>この項では 1.1-rc1 リリース以降の変更内容を記載します。</p>
      <ul>
      <li>StrutsUtil の getActionErrors() と getActionMessages() が非推奨となります。代わりに getErrors() と getMessages() を使用してください。 (ndb)</li>
      <li>ビルド中に発生する javadoc の警告が修正されました(Nathan Green 提供のパッチ)。 (ndb)</li>
      <li>Strutsのサンプルアプリケーションに若干の改良を加えました。 (maj)</li>
      </ul>
    </subsection>

    <subsection name="1.1-rc1">
      <primary>
      <p>This section describes changes after the 1.1-beta release.</p>
      <ul>
      <li>Changed recommended keys for MessageTool and ActionMessagesTool to $text and $messages. (ndb)</li>
      <li>Changed XMLToolboxManager to use thread context classloader when digesting toolbox. (ndb)</li>
      <li>Fixed session tool initialization/synchronization issue. (ndb)</li>
      <li>Added TilesTool methods to import attributes to specific scopes (page/request/session/application). (maj)</li>
      <li>Added new demos for using ValidatorTool, TilesTool, and SecureLinkTool to VelocityStruts example app. (maj)</li>
      <li>Upgraded/refactored MathTool to add floor() and ceil(), make type-handling more intuitive and flexible, and improve number parsing. (ndb)</li>
      <li>Improved resource bundle support in ActionMessagesTool. (ndb)</li>
      <li>ErrorsTool now extends ActionMessagesTool. (ndb)</li>
      <li>LinkTool now encodes URLs using the response's character encoding. (ndb)</li>
      <li>Removed inadvertant JDK 1.4 dependencies from ImportSupport. (ndb)</li>
      <li>Made XMLToolboxManager not abstract (#24840). (ndb)</li>
      <li>De-staticized non-private methods in RenderTool and LinkTool. (ndb)</li>
      <li>Added NumberTool for formatting numbers (contributed by Mike Kienenberger). (ndb)</li>
      <li>Filled out and cleaned up DateTool's toDate(...) methods. (ndb)</li>
      <li>Changed VelocityViewServlet's error method to print the stack trace of the root cause when it encounters a MethodInvocationException. (ndb)</li>
      <li>Added importAttributes() method to TilesTool to automatically put all attributes of the current Tiles context into the Velocity context. (maj)</li>
      <li>Replaced TilesTool's getString(String) method with getAttribute(String) in order to support "put lists." (maj)</li>
      </ul>
      </primary>

      <p>この項では 1.1-beta リリース以降の変更内容を記載します。</p>
      <ul>
      <li>MessageTool と ActionMessagesTool の推奨されるキー名を $text と $messages に変更しました。 (ndb)</li>
      <li>XMLToolboxManager が toolbox を構築する際に スレッドコンテキストクラスローダーを使用するように変更しました。 (ndb)</li>
      <li>セッションツールの初期化/同期化の問題を修正しました。 (ndb)</li>
      <li>指定されたスコープ(page/request/session/application)に対して属性を設定するメソッドを TilesTool に追加しました。 (maj)</li>
      <li>ValidatorTool / TilesTool / SecureLinkToolを使用した VelocityStruts のサンプルアプリケーションの新しいデモを追加しました。 (maj)</li>
      <li>MathTool に floor() と ceil() を追加し、型の扱いをより直感的で柔軟にしました。また、数値の解析処理を改善しました。 (ndb)</li>
      <li>ActionMessagesTool のリソースバンドルのサポートが改善されました。 (ndb)</li>
      <li>ErrorsTool が ActionMessagesTool を継承するようになりました。 (ndb)</li>
      <li>LinkTool が URLをエンコードする際にレスポンスの文字エンコーディングを使用するようにしました。 (ndb)</li>
      <li>不注意による JDK 1.4 への依存部分を ImportSupport から削除しました。 (ndb)</li>
      <li>XMLToolboxManager の abstract 指定をやめました [抽象クラスではなくなりました] (#24840)。 (ndb)</li>
      <li>RenderTool と LinkTool の private ではないメソッドから static を外しました。 (ndb)</li>
      <li>数値をフォーマットする NumberTool を追加しました(Mike Kienenberger から提供)。 (ndb)</li>
      <li>DateTool の toDate(...) メソッドで不足していたものを追加し、不要なものを削除しました。 (ndb)</li>
      <li>VelocityViewServlet のエラーメソッドを変更し、MethodInvocationException が発生した場合に本来の原因である例外のスタックトレースを出力するようにしました。 (ndb)</li>
      <li>Velocity コンテキストに現在の Tiles コンテキストの全ての属性を自動的に設定する importAttributes() メソッドを TilesTool に追加しました。 (maj)</li>
      <li>「Listオブジェクトの設定」("put lists") をサポートする為に、TilesTool の getString(String) メソッドをgetAttribute(String) に置き換えました。 (maj)</li>
      </ul>
    </subsection>

    <subsection name="1.1-beta1">
      <primary>
      <p>This section describes changes after the 1.0 release.</p>
      <ul>
      <li>Made VelocityViewServlet use response.getOutputStream() if response.getWriter() fails.  This is functionality is deprecated and provided as a migration path from 1.0 behavior. (dlr, ndb)</li>
      <li>De-staticized MathTool to make it extendable. (ndb)</li>
      <li>Factored common functionality of ErrorsTool, MessageTool, and ActionMessagesTool into abstract MessageResourcesTool. (ndb)</li>
      <li>Added ImportTool as a simple ImportSupport-based tool. (maj)</li>
      <li>Converted TilesTool to extend ImportSupport. This allows easy mixing of view technologies (JSP, Velocity, etc.) in VelocityStruts applications. (thanks go to Matthew Payne for the idea!) (maj)</li>
      <li>Added ImportSupport class for building tools that can import resources from local or remote URLS. (maj)</li>
      <li>Overhauled DateTool to make it more extendable, user-friendly, and add support for standard, localized date-time styles (see DateTool javadoc for more). (ndb)</li>
      <li>Added support for specifying message resource bundles to StrutsUtils, ErrorsTool, ActionMessagesTool, and MessageTool. (maj,ndb)</li>
      <li>Added commons-validator (1.0.2) and sslext jars to library. (maj)</li>
      <li>Added SecureLinkTool for using Struts SSL Extension with VelocityStruts. (maj)</li>
      <li>Added ValidatorTool to provide Struts 1.1 javascript validation for VelocityStruts. (maj)</li>
      <li>output.encoding property (if non-default) is appended to default content-type as the charset. (ndb)</li>
      <li>VelocityViewServlet now uses response.getWriter() instead of response.getOutputStream() as suggested by Matthew Payne. (ndb)</li>
      <li>Improved VelocityViewServlet error handling (exceptions are logged and error() is now more robust). (ndb)</li>
      <li>Put VelocityViewServlet's requestCleanup() call in a 'finally' clause to allow clean after errors during a request. (dlr)</li>
      <li>Fixed miscellaneous javadoc and doc typos (many of which were reported by Takayoshi Kimura) (ndb)</li>
      <li>Allow system to reclaim objects held by pooled writers in VelocityViewServlet (see bug 18951) (ndb)</li>
      <li>Changed LinkTool to automatically check for XHTML setting (ndb)</li>
      <li>Added support for standard XHTML mode setting via toolbox config (ndb)</li>
      <li>Moved request/response/session/application keys to ViewContext and add getAttribute() method (ndb)</li>
      <li>Added selectModule() and getForwardURL() to StrutsUtils (maj)</li>
      <li>Convert VelocityStruts tools to use new StrutsUtils methods and be module aware (maj)</li>
      <li>Removed unused imports from StrutsLinkTool (ndb)</li>
      <li>Refactor StrutsUtils to use Struts 1.1 classes and support modules (maj)</li>
      <li>Added TilesTool (maj)</li>
      <li>Allow subclasses of VelocityViewServlet to use different ToolboxManager implementations (ndb)</li>
      <li>Added CookieTool (contributed by Dmitri Colebatch) (ndb)</li>
      <li>Added demo of &lt;data&gt; elements to simple VelocityView example (ndb)</li>
      <li>Made simple VelocityStruts example catch Commons-Logging output with LogSystemCommonsLog (ndb)</li>
      <li>Convert toolbox setup to use Digester instead of dom4j (ndb)</li>
      <li>Added LogSystemCommonsLog and CommonsLogLogSystem to provide bridges between Commons-Logging and Velocity's LogSystem (ndb)</li>
      <li>Added Commons Logging 1.0.3 jar (ndb)</li>
      <li>Added ActionMessagesTool (ndb)</li>
      <li>Upgrade deprecated Struts 1.0 uses in examples (ndb)</li>
      <li>Updated jars to Struts 1.1, BeanUtils 1.6.1, Digester 1.5, Collections 2.1 (ndb)</li>
      </ul>
      </primary>

      <p>この項では 1.0 リリース以降の変更内容を記載します。</p>
      <ul>
      <li>VelocityViewServlet で response.getWriter() に失敗した場合に、 response.getOutputStream() を使用するようにしました。この機能は推奨されませんが、1.0からの移行のために提供されます。 (dlr, ndb)</li>
      <li>MathTool を継承可能とするために、static を外しました。 (ndb)</li>
      <li>ErrorsTool / MessageTool / ActionMessagesTool の持つ共通機能を、新設したMessageResourcesTool という抽象クラスに移動しました。 (ndb)</li>
      <li>ImportTool を追加しました。これは ImportSupport をベースとしたシンプルなツールです。. (maj)</li>
      <li>TilesTool を ImportSupport を継承するように変更しました。これにより、ビュー(JSPやVelocity等) [訳注：MVCのVの部分] の技術を VelocityStruts アプリケーション内で混在させて利用するのが簡単になります。(Matthew Payne、このアイデアをありがとう！) (maj)</li>
      <li>ローカル、またはリモートURLからリソースをインポートできるツールを作成するための ImportSupport クラスを追加しました。 (maj)</li>
      <li>DateTool を拡張[継承]可能でユーザーフレンドリーな形に改修しました。また、標準的で国際化された日付・時刻のスタイルをサポートする機能を追加しました(詳細は DateTool の javadoc を参照)。 (ndb)</li>
      <li>メッセージリソースバンドルを指定する機能を StrutsUtils / ErrorsTool / ActionMessagesTool / MessageTool に追加しました。 (maj,ndb)</li>
      <li>ライブラリとして commons-validator (1.0.2) と sslext の JAR ファイルを追加しました。 (maj)</li>
      <li>VelocityStruts で Struts SSL Extension を使用するための SecureLinkTool を追加しました。 (maj)</li>
      <li>Struts 1.1 の JavaScript による入力チェック機能を VelocityStruts に提供する ValidatorTool を追加しました。 (maj)</li>
      <li>（デフォルトではない場合）output.encodingプロパティが、文字コード(charset)としてデフォルトのコンテントタイプに追加されます。(ndb)</li>
      <li>Matthew Payne の提案で、response.getOutputStream() の代わりに response.getWriter() を使うように VelocityViewServlet を変更しました。 (ndb)</li>
      <li>VelocityViewServlet のエラー処理を改善しました(例外をログ出力し、error() をより堅牢にしました)。 (ndb)</li>
      <li>VelocityViewServlet の requestCleanup() の呼び出しをfinally 節に移動し、リクエスト処理中にエラーが起こった場合も後片付けができるようにしました。 (dlr)</li>
      <li>ドキュメントと javadoc 内の記述ミスを色々と修正しました。(その多くは木村 貴由からの報告によるものです)。(ndb)</li>
      <li>VelocityViewServlet 内にプールされた writer が保持するオブジェクトをシステムが再利用できるようにしました。 (bug 18951 参照) (ndb)</li>
      <li>LinkTool を変更し、自動的に XHTML の設定をチェックするようにしました。 (ndb)</li>
      <li>ツールボックス設定ファイルで標準 XHTML モードの設定を行う機能を追加しました。 (ndb)</li>
      <li>request/response/session/application のキーを ViewContext に移動し、 getAttribute() メソッドを追加しました。 (ndb)</li>
      <li>StrutsUtils に selectModule() と getForwardURL() を追加しました。 (maj)</li>
      <li>VelocityStruts ツールを変更し、新しい StrutsUtils のメソッドを使用し、モジュールを認識できるようにしました。 (maj)</li>
      <li>StrutsLinkTool で使用していない import 宣言を削除しました。 (ndb)</li>
      <li>StrutsUtils をリファクタリングし、Struts 1.1 のクラスを使用し、モジュールをサポートするようにしました。 (maj)</li>
      <li>TilesTool を追加しました。 (maj)</li>
      <li>VelocityViewServlet のサブクラスで、ToolboxManager の別の実装を利用できるようにしました。 (ndb)</li>
      <li>CookieTool を追加しました。(Dmitri Colebatchから提供) (ndb)</li>
      <li>単純な VelocityView のサンプルに &lt;data&gt; 要素のデモを追加しました。 (ndb)</li>
      <li>単純な VelocityStruts のサンプルで、Commons-Logging の出力を LogSystemCommonsLog で取得するようにしました。 (ndb)</li>
      <li>ツールボックスの初期化処理を変更し、 dom4j の代わりに Digester を使用するようにしました。 (ndb)</li>
      <li>Commons-Logging と Velocity とを橋渡しする為に LogSystemCommonsLog と CommonsLogLogSystem を追加しました。 (ndb)</li>
      <li>Commons Logging 1.0.3 のJARファイルを追加しました。 (ndb)</li>
      <li>ActionMessagesTool を追加しました。 (ndb)</li>
      <li>サンプル内で非推奨だった Struts 1.0 の利用を改めました。 (ndb)</li>
      <li>JARファイルのうち、Struts を 1.1 に、 BeanUtils を 1.6.1 に、 Digester を 1.5 に、 Collections を 2.1 に、それぞれ更新しました。 (ndb)</li>
      </ul>
    </subsection>

    <subsection name="1.0">
      <ul>
      <primary><li>Initial release.</li></primary>
      <li>最初のリリース。</li>
      </ul>
    </subsection>

  </section>

</body>
</document>
