This document tracks the changes in Velocity between releases.

この文書は、Velocityの各リリース間の変更点を記録するものです。

1.4-rc1 − 1.4-rc1

This section describes changes to the 1.4 branch after rc1. It was released as v1.4 on April 14, 2004. Update license to Apache Software License v2.0

1.4 − 1.4

This section describes changes to the main branch after the 1.3 release. They were released as part of 1.4 rc1 on Oct-9-2003. Added support for dynamic selection of output character encoding to VelocityServlet. By default, the selected encoding is the value of the output.encoding Velocity property, but can be made dynamic by overriding the new chooseCharacterEncoding() method. (dlr) Bill Boland pointed out that VelocityServlet's pooling of VelocityWriter was preventing the underlying OutputStreamWriter from being garbage collected. This was fixed by clearing the VelocityWriter's reference to its internal OutputStreamWriter to allow the latter to be GC'd while VelocityWriter is pooled. (#18951) Deprecated org.apache.velocity.runtime.Runtime in favor of the RuntimeInstance and RuntimeSingleton classes. (dlr) Fix to MethodMap part of introspector to make the overloaded method selection work as specified in the JLS, from Attila Szegedi. (gmj) Tiny fix for bug where multiple slashes not getting rendered correctly. (#7380) (gmj) Fix for bug where #set($foo = !true) not working. (#7387) (gmj) Fix for bug where $##(nl) foo ate the $ (#7381) (gmj) Disallow any WORD tokens for directives except 1st arg to #macro() or thi 'in' in foreach. (#7383,#7384) (gmj) Remove '=' as a valid token for anything but #set() as nothing else can do assignment. (#7385) (gmj) Fix problem where VM in stringlit as arg to VM NPE'd. Whoops. (gmj) Deprecated Velocity.templateExists(String) in favor of the more appropriately named Velocity.resourceExists(String). (dlr) Deprecated VelocityServlet's properties key in favor of the namespace protected org.apache.velocity.properties key. (dlr) Update user guide - remove confusing (wrong) content. (gmj) Brought all introspective-ish behavior under one umbrella interface, Uberspect, to allow customizable, pluggable introspection. (gmj) `` Fixes for bug 7684 : make sure event handler called with real reference literal even if a quiet reference. Bug 7183 : fixes to win32 .bat files in examples (gmj) Fix for bugs 8517, 6955 : anything ...#set... was confusing the parser (gmj) Removed deprecated use of DEFAULT_OUTPUTTER.output() in Anaka's NodeList (gmj) Upgraded JDOM to v1.0b9 (gmj)

1.3.1-rc2 − 1.3.1-rc2

This section desscribes changes to the VEL_1_3_BRANCH after the 1.3.1-rc2 release. It was released as 1.3.1 on it's own branch, VEL_1_3_1_BRANCH on March 31, 2003. このセクションでは、1.3.1-rc2 リリース以降の VEL_1_3_BRANCH への変更を 記載しています。これは 2003年3月31日に、VEL_1_3_1_BRANCH 上で 1.3.1 として リリースされました。

1.3.1-rc1 − 1.3.1-rc1

This section describes changes to the VEL_1_3_BRANCH after the 1.3.1-rc1 release. This was released as 1.3.1-rc2 on July 24, 2002. このセクションでは、1.3.1-rc1 リリース以降の VEL_1_3_BRANCH への変更を 記載しています。これは 2002年7月24日に、1.3.1-rc2 としてリリースされました。 Another fix to primitive argument introspection problem, suggested by Chris Felaco(gmj) Another minor introspection tweak, for null values (gmj) Chris Felaco から示唆のあった、プリミティブ型の引数のイントロスペクション での問題をさらに修正。(gmj) イントロスペクションで null 値に関してもう一点、少し修正。(gmj)

1.3 − 1.3

This section describes changes to the VEL_1_3_BRANCH after the 1.3 release. This was released as 1.3.1-rc1 on July 22, 2002. このセクションでは 1.3 リリース以降の VEL_1_3_BRANCH への変更を 記載しています。これは 2002年8月22日に 1.3.1-rc1 としてリリースされました。 Fixed primitive argument introspection problem. (gmj) プリミティブ型の引数のイントロスペクションでの問題を修正。(gmj)

1.3-rc1 − 1.3-rc1

This section describes changes to the VEL_1_3_BRANCH after the 1.3-rc1 release. This branch was released as v1.3 on July 7, 2002. このセクションでは、1.3-rc1 リリース以降の VEL_1_3_BRANCH への変更を 記載しています。このバージョンは、 2002年7月7日にバージョン1.3としてリリースされました。 Fixed javadoc in ClasspathResourceLoader (gmj) Backport from HEAD the #foo("#bar('a')") NPE fix (gmj) Update User's Guide - remove confusing and wrong content. (gmj) Fixed problem discovered by Ivan Bella where concurrent method invocations with varying parameters would be incorrect. (gmj) Brought recent Spanish and French translations of the User's Guide to the 1.3 branch. (gmj) ClasspathResourceLoader の Javadoc を修正。(gmj) #foo("#bar('a')") での NullPointerException への対応を CVS の HEAD から後方移植。(gmj) ユーザガイドを更新 ── 混乱を招く内容や誤った内容を削除。(gmj) Ivan Bella が発見した、異なるパラメータでメソッドを同時に呼び出すと、 正しい結果が得られなくなる問題を解決。(gmj) 1.3 ブランチに、最近行なわれたユーザガイドのスペイン語とフランス語の翻訳を追加。 (gmj)

1.3-dev − 1.3-dev

This section describes changes to the main branch after the 1.2 release. This was then branched as VEL_1_3_BRANCH in CVS and released as v1.3-rc on March 17, 2002. このセクションでは、1.2 リリース以降のメインブランチへの変更を 記載しています。これは CVS で VEL_1_3_BRANCH として分岐し、 2002年3月17日に、v1.3-rc としてリリースされました。 Fix to LogSystem. ORed when I should have ANDed. Reported by Matt Gould (mpg@mpgsoftware.com). (gmj) Documentation patch for 'getting started', reported by Yuji Kumasaka (kumasaka@mms.intec.co.jp) (gmj) Changed AnakiaTask to not specify Xerces, but let JDOM find a parser. (gmj) Change reported in bug #4256 by Jim Mackraz (jim@mackraz.com) reviewd and fixed by DLR. (gmj) Fixed Velocimacro autoload infinite loop bug. (gmj) Update docs re autoload VM and repeatability of init() (gmj) Added constructors to VelocityContext for plug and play interoperability with the java.util.Map interface (dlr, gmj) Committed Texen patches from Stephane Bailliez (sbailliez@imediation.com) anticipating review by the Texen aficianados in the Velocity community. (gmj) Fix problem where local-scope VMs were interfering with VM library autoloading. (gmj) Added support for primitive arrays in #foreach() re bug #4370 (gmj) Parser fixes for $foo.bar} and $foo.bar#if (gmj) Changed build targets to not include external dependencies in velocity jars by default. (gmj) Added support for an 'ApplicationContext' to allow the application set an Object accessable to custom loaders and loggers. (gmj) Added cleanup() hook method to TexenTask to easily allow subclasses to perform cleanup activities without overriding execute(). (dlr) ResourceManager and ResourceCache are now pluggable. Default implementations work as they always did. (gmj) Added support for allowing user to configure pluggable directives. We supported it, but offered no way of actually configuring it as such. (gmj) Fixed lonely # in #macro() bug reported by Tim Chamberlain (tchamberlain@sportingnews.com) and added template test. (gmj) Deprecation update : AnakiaTask b/c JDOM, default logger b/c LogKit 1.0. (gmj) New simple log4j logger, uses either an existing category if that is passed to it, or just writes to a new file. Log support enhanced to include automatic selection for default file logger using either Jakarta Avalon Logkit or Jakarta Log4j, whichever it finds in the classpath. (gmj) Fix for problem reported by Robert Edgar where a reference-ish entity like \${foo} wouldn't render the preceeding \ Support for is<Property>() introspection. (gmj) Added better resolution of method ambiguity based on invocation parameters so we better choose between overloaded methods. (gmj) Patch from Michael McKibben for introspector to fix problem where public interface methods implemented by a private or default class were skipped when resolving access. (gmj) Modified the Introspector and environs to make it independent of Velocity-specific imports for reuse by others. (gmj) Patch from Dan Finkelstein to fix problem when a resource loader in named, but has no defined parameters, resulting in NPE from ResourceManager. (gmj) Adjusted formatting of the default error output from VelocityServlet as suggested by Igor Fedulov. (gmj) Fix for so-called runt reference bug reported by Lukas Zimmermann such that $foo.bar()RUNT had following RUNT treated as a reference. (gmj) Update servlet1 example to use the 'new' handleRequest() (gmj) Added support for ${user.home}/build.properties to Ant build file. (dlr) VelocityServlet subclasses may now use a web.xml context parameter as the default value for the path to their velocity.properties file. (dlr) Added patch from Sylwester Lachiewicz (matrix@plusnet.pl) for the DataSourceResourceLoader to bring the javadoc up to date re the properties example, and he also added examples for the DataSource configuration as well as the syntax needed to create a compatible table. (gmj) Small fix to enable logical complement #set($foo = !$bar), as reported by Chris Rousseau. (gmj) Doc fixes by many. Thanks all. (gmj) Fix to StringUtils.chop(). (gmj) Fix to StringLiteral bug found by Stephane Bailliez - in high load situations it was possible to get an NPE if the timing worked out just right. Also fixed a side-effect found by Victor Salaman. (gmj) Fix to $foo## bug reported by Nathan Bubna. (gmj) Fix to VM bug found by Paulo Gaspar, where when using inline-scope VMs and VM recursion the namespace got dumped at the wrong time, killing the recursion. (gmj) Add class to provide bean-like access to Texen. (jvz) Small introspection side-effect fix suggested by Sven Meier, prevents Obj[] from getting altered in event of null value. (gmj) Log4jLogSystem deprecated in favor of the simpler SimpleLog4jLogSystem. (gmj) LogSystem の修正。ANDとすべきところをORにしていた。 Matt Gould (mpg@mpgsoftware.com) からの報告に基づく。(gmj) 「はじめに」への文書化パッチ。Yuji Kumasaka (kumasaka@mms.intec.co.jp) からの報告に基づく。(gmj) AnakiaTask で Xerces 固定でなく、JDOM がパーサを見つけるように 変更。(gmj) Jim Mackraz (jim@mackraz.com) から報告されたバグ番号 4256 の変更。 DLR がレビュー・修正。(gmj) Velocimacro の自動ロード時の無限ループバグを修正。(gmj) Velocimacro の自動リロードと init() が繰り返す可能性があることに関して、 文書を修正。(gmj) VelocityContext に、java.util.Map とのプラグアンドプレイ的 相互運用性のためのコンストラクタを追加。(dlr, gmj) Velocity コミュニティの Texen 同好会 (aficionados) によるレビューを 見越した Stephane Bailliez (sbailliez@imediation.com) からの Texen のパッチを反映。(gmj) ローカルスコープの Velocimacro が Velocimacro ライブラリ自動ロードと干渉する 問題を修正。(gmj) バグ番号4370への対応として、#foreach() でのプリミティブ型配列の サポートを追加。(gmj) $foo.bar} と $foo.bar#if に関するパーサ修正。(gmj) デフォルトでは、Velocity の JAR ファイルに外部の依存関係のファイルを 含めないように、ビルドターゲットを変更。(gmj) アプリケーションから、カスタムのローダやロガーにアクセス可能な Object を セットできるようにする「ApplicationContext」のサポートを追加。 (gmj) execute() をオーバーライドせずに、 サブクラスがクリーンアップアクティビティを簡単に行なえるように、 TexenTask に cleanup() フックメソッドを追加。(dlr) ResourceManager と ResourceCache がプラグイン可能になった。 デフォルトの実装では前と同じように動作する。(gmj) ユーザがプラグイン可能な指示子を設定できるようなサポートを追加。 サポートはしているが、実際にそのように設定する方法は提供していない。(gmj) Tim Chamberlain (tchamberlain@sportingnews.com) から報告のあった、 #macro() 内で # が単独にあった場合のバグを修正し、 テンプレートのテストを追加。(gmj) 非推奨に関する更新： AnakiaTask での JDOM の使用、 デフォルトロガーでの LogKit 1.0 の使用。(gmj) 単純な Log4j のロガーを新規作成。既存のカテゴリが渡されてきたらそれを使い、 そうでなければ新しいファイルに書き込みを行なう。 デフォルトファイルロガーの (Avalon Logkit と Jakarta Log4j からの) 自動選択など、 ログのサポートを強化。どちらを選択するかはクラスパスから決定する。(gmj) Robert Edgar から報告された、\${foo} のようなリファレンスもどきの実体を 指定した場合に、前の \ を処理しない問題を修正。 Support for is<Property>() introspection. (gmj) is<Property>() のイントロスペクションのサポート。(gmj) 呼び出しパラメータに応じて、メソッドをうまく特定できるようにしたので、 メソッドのオーバーロードをうまく使えるようになった。(gmj) Michael McKibben からのイントロスペクタのパッチで、 プライベートまたはデフォルトのアクセス指定のクラスに実装された パブリックのインタフェースメソッドで、 アクセス権の解決処理がスキップされる問題を解決。(gmj) イントロスペクタと環境変数を変更して、Velocity 固有のインポートを 他のところでの再利用のために独立させた。(gmj) Dan Finkelstein からのパッチで、 リソースローダで、定義されていない名前つきパラメータが指定された時に、 ResourceManager で NullPointerException が発生する問題を解決。(gmj) Igor Fedulov からの示唆で、VelocityServlet からのデフォルトのエラー出力のフォーマットを調整。(gmj) Lukas Zimmermann から報告された、$foo.bar()RUNT の RUNTが参照として扱われるという、 いわゆる「runt 参照」のバグを修正。(gmj) handleRequest() で「new」を使うように servlet1 サンプルを更新。(gmj) Ant のビルドファイルに ${user.home}/build.properties のサポートを追加。(dlr) VelocityServlet のサブクラスで velocity.properties ファイルへのパスのデフォルト値として、web.xml のコンテキストパラメータが使えるようになった。(dlr) Sylwester Lachiewicz (matrix@plusnet.pl) からのパッチが追加され、 DataSourceResourceLoader でのプロパティのサンプルについて Javadoc を最新化した。 彼は同時に DataSource の設定のサンプルや、 互換性のあるテーブルを作成するのに必要な構文を追加してくれた。(gmj) Chris Rousseau からの報告で、#set($foo = !$bar) という形式で、 論理補集合が可能なように少し修正。(gmj) 多くの人による文書の修正。みなさんに感謝。(gmj) StringUtils.chop() の修正。(gmj) Stephane Bailliez が発見した、高負荷時にタイミングがぴったり合うと NullPointerException が発生する可能性があるという StringLiteral のバグを修正。 同時に Victor Salaman が見つけた副作用も修正。(gmj) Nathan Bubna から報告された $foo## のバグを修正。(gmj) Paulo Gaspar が見つけた、インラインスコープの Velocimacro や Velocimacro の再帰で、 ネームスペースのダンプのタイミングがおかしくなり、再帰が終了してしまうという、 Velocimacro のバグを修正。(gmj) Texen で Bean ライクなアクセスができるクラスを追加。(jvz) Sven Meier から示唆のあったイントロスペクションの副作用を少し修正。 これにより、Object の配列が null 値の場合に変更されてしまうのを回避。(gmj) より単純な SimpleLog4jLogSystem を使ってもらうために、Log4jLogSystem は非推奨にした。 (gmj)

1.2 − 1.2

1.2 was released on December 9, 2001. 1.2 は 2001年12月9日にリリースされました。

1.2-rc3 − 1.2-rc3

This section describes changes to the VEL_1_2_BRANCH after the 1.2-rc3 release. 1.2-rc3 was released on November 7, 2001 for a quick community check. It is intended to be the final rc for the 1.2 release. このセクションでは、1.2-rc3のリリース以降の VEL_1_2_BRANCH への変更点を記載しています。 1.2-rc3は、コミュニティ内のちょっとしたチェックのために 2001年11月7日にリリースされました。 1.2 に向けた最後の Release Candidate の予定です。 Small fix to Velocity.java and VelocityEngine.java for invokeVelocimacro() - the were broken in the last major VM change (months ago) and never noticed. (gmj) Added notes re the new no-dep jar. (gmj) invokeVelocimacro() 向けに Velocity.java と VelocityEngine.java を修正。 (何ヶ月か前の) 最後の Velocimacro の大きな変更でおかしくなったようだが、 誰も気がつかなかった。(gmj) 新しい no-dep JAR ファイルについての注意書きを追加。(gmj)

1.2-rc2 − 1.2-rc2

This section describes changes to the VEL_1_2_BRANCH after the 1.2-rc2 release. 1.2-rc2 was released on October 18, 2001 as an administrative fix for 1.2-rc1 (files were damaged.) このセクションでは、VEL_1_2_BRANCH への変更点を記載しています。 1.2−rc2 は 1.2-rc1 の管理上の修正 (ファイルが壊れていた) のために、 2001年10月18日にリリースされました。 Backport the 'disappearing curly' and 'nit' fixes from 1.3 (gmj) Backport autoreload infinte loop and local-scope interferance bugs. (gmj ) Backport Texen patches from Stephane Bailliez and follow-on fixes from jvz and dlr. (gmj) Changed build targets to not include external dependencies in velocity jars by default. (gmj) 1.3で「丸括弧が消える問題」とちょっとしたバグの修正を後方移植。(gmj) オートリロードの無限ループとローカルスコープ干渉のバグ修正を後方移植。(gmj ) Texenパッチ (Stephane Bailliez) と、関連する修正 (jvz と dlr) を後方移植。(gmj) デフォルトでは、ビルドターゲットに Velocity の JAR ファイルへの外部依存を 含まないように変更。(gmj)

1.2-rc1 − 1.2-rc1

This section describes changes to the VEL_1_2_BRANCH after the 1.2-rc1 release. These are updates working towards a rc2 or final. このセクションでは、1.2-rc1 リリース以降の VEL_1_2_BRANCH への変更点を記載しています。これらの変更は rc2 および 最終リリースに向けた更新作業です。 Fix to LogSystem. ORed when I should have ANDed. Reported by Matt Gould (mpg@mpgsoftware.com). (gmj) Documentation patch for 'getting started', reported by Yuji Kumasaka (kumasaka@mms.intec.co.jp) (gmj) Changed AnakiaTask to not specify Xerces, but let JDOM find a parser. (gmj) Change reported in bug #4256 by Jim Mackraz (jim@mackraz.com) reviewd and fixed by DLR. (gmj) LogSystem の修正。 AND すべきところを OR していた。 Matt Gould (mpg@mpgsoftware.com) による報告。(gmj) "getting started" のドキュメントのパッチ。 Yuji Kumasaka (kumasaka@mms.intec.co.jp) による報告。(gmj) AnakiaTask で、Xerces を指定せず、 JDOM がパーサを見つけるように変更。(gmj) Jim Mackraz (jim@mackraz.com) による バグ #4256 の報告を元に、 DLR がチェック・修正した変更。 (gmj)

1.2-dev − 1.2-dev

This section describes changes to the main branch after the 1.1 release. This was then branched as VEL_1_2_BRANCH in CVS and released as v1.2-rc1 on September 26, 2001. このセクションでは、1.1 のリリース以降のメインブランチへの変更点を記載 しています。このバージョンはその後、 CVS で VEL_1_2_BRANCH として分岐して、 2001年9月26日に v1.2-rc1 としてリリースされました。 Fix to AbstractContext to 'roll forward' EventCartridges to ensure that the last one added is available at render time. (gmj) Small changes to developer docs re jar-src target and docs target. (gmj) Small changes to AND and OR nodes to support the legal but wacky use like #set( $foo = ($woog || $bar ) ). (gmj) Major change to Parser char stream - no longer using the stock, javacc generated ASCII 8-bit char stream but rather a Unicode 'custom' char stream. This solves the problems reported with 16 bit characters that unluckily have a 0a or 0d in the low-order byte. (gmj) Added additional templates to encoding test using contributions from Ilkka Priha, Michael Zhou and Vitaly Repetenko. Thanks guys! (gmj) Update from Russel Edens to clear fileWriter cache for Texen's Generator.java. (JSS) Fix to VM system to prevent dumping of VM namespace when using namespaces (in local.scope). (gmj) Fix to VM system to have correct 'schmoo' output of a non-reference passed as arg to VM. Thanks to DLR and Paulo for flogging this out of me :) (gmj) Updates to StringUtils from Robert Burrell Donkin. (gmj) Added MIE propogation from #parse() and VMs to propogate out. Thanks to Michael Salmon for pointing this out. (gmj) Added logging interface to Velocity class for completeness. (gmj) Patch by Michael Salmon to WebMacro converter tool to let arbitrary set of files be converted. (gmj) TokenManagerError now thrown as ParserException to allow catching at application level. (Suggested by Tim Joyce.) (gmj) Small parser fix to get ObjectArrray and IntegerRange handling right everywhere. (gmj) Speed optimzations for test provider. (dlr) Enhancement to MIE message suggested by Conor MacNeill to make interpretation of exception more useful when debugging. (gmj) Small fix to #parse() and #include() such that when the template/resource was not file based but stream based, there was no 'parent template' encoding to use for decoding the arg to #parse/#include. Runtime default is used. Thanks to Dan Finkelstein for finding this bug. (gmj) Fix to problem reported by Andreas Wikberger (and patch too!) where two loads were required to have template refresh after change when time-based caching was enabled. (gmj) Updated log4j adapter to be compatible with 1.1.x and updated jars in build/lib to match. (gmj) Changed VMFactory to not output scary messages when library is not found or empty string. Suggested by Tal Dayan. (gmj) Added auto alternator functionality to VelocityFormatter. (dlr) Modified Velocity to support separate runtime instances and added application support class o.a.v.app.VelocityEngine (gmj) Updated junit to v3.7 in build/lib (gmj) Checked in patches from Attila Szegedi which improves the XPath support in Anakia. These are fully backwards compatible with previous versions. (jss) Fixed the build/test.sh convenience script to use Ant. (jss) Intrspector fix using contributions from Attila Szegedi (szegedia@freemail.hu) - removes problems associated with access to inner classes and public interfaces on default or private facades. (gmj) Added new autoreload feature for VM system - VM global libraries will be automatically reloaded on use. See 'Configuration' section of developers guide for more info. (gmj) Logging changes : moved prefix out of RuntimeInstance into logger impl to support better log4j users who don't need it. Changed ExternalLoggerTest to support that as well as sep runtime instance. Needed to support log4j adapter contrib from Jeroen C. van Gelderen. Also, LogSystem.init() now can throw an Exception. (gmj) Also added AvalonLogSystem switch to allow user to simply specify by name a logger from the existing hierarchy. Thanks to Carsten Ziegeler. (gmj) Texen enhancement - allow to use template resources from a jar. (jvz) Allow proper propagation of VelocityExceptions (RNFE, PEE, and MIE) from #parse() and #include(), where appropriate. (gmj) Bug fix to allow formal reference to be passed into VMs. (gmj) Revamping of Introspector to allow dump of cache when classloader change is detected, by Attila Szegedi and Paulo Gaspar. (gmj) Added testcase to verify introspection cache dumped when classloader changed. (gmj) Added PrimordialLogSystem and changed RuntimeInstance to use it. (gmj) Minor fixes to ASTRefernce presentation. (gmj) Texen enhancement - allow multiple properties files to be specified. (jvz) レンダリング時に最後に加えられたものが利用できることを確実にするために、 AbstractContext が EventCartridges を「ロールフォワード」するように修正(gmj) jar-src ターゲットと docs ターゲットに関して開発者ドキュメントを少し変更。 (gmj) 以下のような、間違ってはいないけれど変な使い方をサポートするために、 AND と OR ノードを少し変更。 #set( $foo = ($woog || $bar ) ) (gmj) Parser の文字ストリームへの大きな変更 ── もはや、javaCC が生成した ASCII 8ビット文字ストリームである stock は使えなくなり、Unicode の「カスタム」文字ストリームを使わなければならない。これによって、 16ビット文字で運悪く下位バイトに 0a や 0d が来た場合の不具合が解決する。(gmj) Ilkka Priha、Michael Zhou、Vitaly Repetenko によるエンコーディングテストのテンプレートの追加。感謝。(gmj) Texen の Generator.java で fileWriter キャッシュをクリアするように修正 (Russel Edens) (JSS) (local.scope で)ネームスペース使用時に Velocimacro ネームスペースのダンプが発生しないように Velocimacro システムを修正。 (gmj) Velocimacro に引数として渡される参照以外の実体 [定数など] が、 そのままの形で正しく出力されるように Velocimacro システムを修正。 DLR と Paulo に感謝。(gmj) Robert Burrell Donkin による StringUtils の更新 (gmj) #parse() や Velocimacro からの MethodInvocationException をさらに伝搬する処理を追加。これに関しては Michael Salmon に感謝。(gmj) 完璧にするために Velocity クラスへのログインタフェースの追加 (gmj) 任意のファイルを変換するための WebMacro 変換ツールへの Michael Salmon によるパッチ。(gmj) アプリケーションレベルでキャッチすることができるように、TokenManagerError を ParserException として投げるようにした。(Tim Joyceによる提案)(gmj) ObjectArray と IntegerRange をどこでも正しく扱えるようにパーサを少し修正。 (gmj) テスト用のプロバイダの速度の最適化(dlr) デバッグ時により例外を分かりやすく解釈できるように、 MethodInvocationException メッセージを拡張 (Conor MacNeillの提案)。(gmj) テンプレートやリソースがファイルベースでなくストリームベースの場合、 #parse/#include で使用する親の "parent template" エンコーディングがなくなることがあるので、#parse() と #include() を少し修正し、 実行時のデフォルトを使用するようにした。 Dan Finkelstein によるバグの発見に感謝。(gmj) 時間ベースのキャッシュが有効なときに、変更後のテンプレートのリフレッシュで、 ロードを2回しないといけないという問題に関する、Andreas Wikberger による報告と問題の修正 (それにパッチも!)。(gmj) log4j アダプタを 1.1.x 互換にするよう更新し、それに合わせて build/lib の JAR ファイルを更新。 (gmj) ライブラリが見つからないか、空文字列のときに、恐ろしいメッセージが 出力されないように VMFactory を変更 (Tal Dayan による提案)。(gmj) VelocityFormatter の自動代替機能の追加。(dlr) 別のランタイムインスタンスをサポートするようにVelocityを修正し、 アプリケーションサポートクラスである org.apache.velocity.app.VelocityEngine を追加。(gmj) build/lib の JUnit を3.7に更新。(gmj) Anakia での XPath のサポートを改善する、Attila Szegedi からのパッチのチェックイン。 これらは、以前のバージョンと完全に後方互換である。(jss) Ant を使った build/test.sh 便利スクリプトの修正。(jss) Attila Szegedi(szegedia@freemail.hu) によるイントロスペクタの修正 ── デフォルトまたはプライベートのファサードクラス内の、 内部クラスやパブリックのインタフェースへのアクセスに関する問題を解決。(gmj) Velocimacro システムに新規の自動リロード機能の追加 ── Velocimacro グローバル ライブラリは利用時に自動的にリロードする。詳細については開発者ガイドの 「設定」セクションを参照。(gmj) ロギング変更: RuntimeInstance を使わない log4j ユーザをうまくサポートするために、 RuntimeInstance からロガー実装にプレフィクスを移動。 これとともに別のランタイムインスタンスをサポートするために ExternalLoggerTest を変更。Jeroen C. van Gelderen による log4j アダプタのサポートも必要だった。 また、LogSystem.init() が Exception を投げるようになった。 (gmj) また、AvalonLogSystem に、既存の階層からロガーを単純に名前で指定できるようにする スイッチを追加。Carsten Ziegelerに感謝。(gmj) Texen の強化 ── JAR にあるテンブレートリソースを使用できるようにした。 (jvz) #parse() や #include() で各種 VelocityException (ResourceNotFoundException、ParceErrorException、MethodInvocationException) を適宜伝播できるようにした。 (gmj) 通常参照を Velocimacro 内で渡せるように修正。(gmj) クラスローダーの変更が検出された場合にキャッシュのダンプができるように Introspector を修正 (Attila Szegedi と Paulo Gaspar による)。(gmj) クラスローダー変更時にダンプされた Introspector によるキャッシュをチェックするように検証テストケースを追加(gmj) PrimordialLogSystem を追加し、それを使うために RuntimeInstance を変更。(gmj) ASTRefernce 表記を少し修正。(gmj) Texen の強化 ── 複数のプロパティファイルを指定できるようにした。(jvz)

1.1-rc2 − 1.1-rc2

This section describes changes to the VEL_1_1_BRANCH after the 1.1-rc2 release. This was released as v1.1 on June 16, 2001. このセクションでは、1.1-rc2 リリース以降の VEL_1_1_BRANCH への変更を記載しています。これは、2001年6月16日に バージョン 1.1 として リリースされました。 Update from Russel Edens to clear fileWriter cache for Texen's Generator.java. (JSS) Texen の Generator.java の fileWriter キャッシュをクリアするように更新 (Russel Edens による)。(JSS)

1.1-rc1 − 1.1-rc1

This section describes changes to VEL_1_1_BRANCH after the 1.1-rc1 release. This was released as v1.1-rc2 on June 2, 2001. このセクションでは、1.1-rc1 のリリース以降の VEL_1_1_BRANCH への変更を記載しています。これは、2001年6月2日に v1.1-rc2 として リリースされました。 Fix to AbstractContext to 'roll forward' EventCartridges to ensure that the last one added is available at render time. (gmj) Small changes to developer docs re jar-src target and docs target. (gmj) Small changes to AND and OR nodes to support the legal but wacky use like #set( $foo = ($woog || $bar ) ). (gmj) Major change to Parser char stream - no longer using the stock, javacc generated ASCII 8-bit char stream but rather a Unicode 'custom' char stream. This solves the problems reported with 16 bit characters that unluckily have a 0a or 0d in the low-order byte. (gmj) Added additional templates to encoding test using contributions from Ilkka Priha, Michael Zhou and Vitaly Repetenko. Thanks guys! (gmj) AbstractContext で最後に変更された EventCartridge を、 レンダリング時に確実に使えるように「ロールフォワード」するように修正。(gmj) jar-src ターゲットと docs ターゲットに関する開発者ドキュメントを少し変更。（gmj） #set( $foo = ($woog || $bar ) )のような、間違ってないが変な使い方を サポートするように、AND と OR ノードを少し変更。(gmj) Parserの文字ストリームへの大きな変更 ── もはや、javaCC が生成した ASCII 8ビット文字ストリームである stock は使えなくなり、Unicode の「カスタム」文字ストリームを使わなければならない。これによって、 16ビット文字で運悪く下位バイトに 0a や 0d が来た場合の不具合が解決する。(gmj) Ilkka Priha、Michael Zhou、Vitaly Repetenko によるエンコーディングテストの テンプレートの追加。ありがとう。 (gmj)

1.1-dev − 1.1-dev

This section describes changes to the main branch after the 1.0.1 release. This was then branched as VEL_1_1_BRANCH in CVS and released as v1.1-rc1 on May 20, 2001. このセクションでは、1.0.1 のリリース以降のメインブランチへの変更を記載しています。 その後、CVS で VEL_1_1_BRANCH として分岐して、2001年5月20日に v1.1-rc1 としてリリースされました。 Removed build.sh and build.bat scripts in favor of making people "install" Ant. Added Kent's, others and my changes to VelocityServlet. Fundamental change is changing handleRequest() to take a req, resp and ctx args, as well as making returning null permissible to indicate that request is taken care of. (gmj) Added support for alternate encoding for templates (input sources). It is now controllable by two properties (input and output), and tested with UTF-8. UTF-8 rocks. Why are there others? :) Also added testcase. (gmj) Fixed problem where MethodInvocationExceptions were not correctly generated for method exceptions in a few places. All seems to work now. (gmj) Added fix from Charles Bennet for build.xml to include all necessary parts in classpath for building examples. (gmj) Performance improvment additions for the AST, the majority from Kent Johnson, plus his suggestions for Configuration and ResourceManager (gmj) More MethodInvocationExceptions fun : the LHS of a #set() could throw an Exception, and we wouldn't propogate it. (gmj) EventCartridge support. See docs :) (gmj) Documentation : basic EventCartridge description. (gmj) Added request specific encoding specification for templates. (gmj) Additions from Tim Joyce for more Method Exception propogation and exception event handling. (gmj) Performance patches from Kaspar Nielsen for ASTDirective and Include. (gmj) Texen patch from Robert Burrell Donkin which makes Texen throw all exceptions rather than eating them, and some javadoc. (gmj) Fix for the much acclaimed and dreaded #$foo, $$foo #$#$foofoo, etc bug. (gmj) Added some autoconfigure support for the servlet example to hele users new to Servlets, and added a little README to help then find Tomcat and setup a webapp. (gmj) Removed the .close() of the output stream in VelocityServlet and symmetrized VelocityWriter recycle. (gmj) Converted from using the Velocity Configuration class (now deprecated) to the Jakarta Commons collections component's ExtendedProperties class. (Which came from Velocity and was renamed.) Should result in no changes other than deprecation of Configuration and one deprecated method in o.a.v.app.Velocity. (gmj) Removed build/build.sh and build/build.bat and build/lib/ant*.jar to move to explicit Ant-based build. (jss) Changed JarResourceLoader to use normal 'path' configuration key and added jar test to MultiLoaderTestCase. (gmj) Updated the regexp in the WM conversion tool. (dlr) Added EventHandler test case and example, and removed NullReferenceEventHandler as redundant. (gmj) Moved all event-realated things to o.a.v.app.event package, updated all things that depend upon it, and modified the context stuff to support a public event interface. Also renamed the null set method to something more appropos, and added arg to method. (gmj) Added switch to turn off 'resource found' messages in ResourceManager. Default is on. Key is 'resource.manager.logwhenfound'. (gmj) 利用者に Ant を「インストール」してもらえるように、 build.sh と build.bat スクリプトを削除。 Kent 他の変更点、および私の変更点を VelocityServlet に追加。 基本的変更点は、handleRequest()が req、resp、ctx を引数に取るようにしたことと、 リクエストが処理されていることを示すために null を返せるようにしたこと。(gmj) (入力ソースの)テンプレートで代替エンコーディングのサポートを追加。 これは(入出力の)2つのプロパティで制御でき、UTF-8 でテストされた。 UTF-8 はすごい。これしかありえない :)。 あとテストケースを追加 (gmj) 何ヵ所かで、メソッド例外に対して MethodInvocationException が正しく発生しなかった問題の修正。今はちゃんと動いている模様。（gmj） build.xml でサンプルをビルドするのに classpath で必要な部分を含むように修正を追加 (Charles Bennetから)。(gmj) AST 向けのパフォーマンス改善の追加、大半は Kent Johnson のおかげで、それに加えて Configureation と ResourceManager も提案してくれた。(gmj) MethodInvocationException 群がもっと面白くなった : #set() の左辺は例外をなげる可能性があったが、正しく扱うことができなかった。(gmj) EventCartridge サポート。ドキュメントを参照 :) (gmj) ドキュメント : 基本的なEventCartridgeの説明。 (gmj) テンプレート用のリクエスト固有のエンコーディング仕様を追加。(gmj) Tim Joyceによる、Method Exception の伝搬と例外イベント処理の追加。(gmj) Kaspar Nielsen による、ASTDirective と Include に関するパフォーマンスパッチ。(gmj) Robert Burrell Donkin による、Texen がすべての例外を投げるようにする Texen パッチと、Javadocをいくつか。(gmj) 非常に喝采を浴びつつも怖れられた、#$foo、$$foo、#$#$foofoo などのバグの修正 (gmj) Servlet の初心者を手助けする Servlet サンプル向けの自動コンフィグサポートの追加と、 Tomcat を探して Web アプリケーションをセットアップできるように、 ちょっとした README の追加。(gmj) VelocityServlet とそれに対応する VelocityWrite リサイクルでの出力ストリームの .close() の削除。(gmj) Velocity Configuration クラス (現在は非推奨) から、 Jakarta Commons の Collection コンポーネントの ExtendedProperties クラスへの 変換 (Velocity 由来のものだが、名前が変更された)。 その結果、Configuration が非推奨になったのと、org.apache.velocity.app.Velocity のメソッドの一つが非推奨になった以外は変更はないはず。(gmj) Ant ベースのビルドに明示的に移行するため、build/build.sh、build/build.bat、 build/lib/ant*.jar を削除。 (jss) 通常の "path" 設定キーを使うように JarResourceLoader を変更し、 JAR テストを MultiLoaderTestCase に追加(gmj) WebMacro 変換ツールでの regexp の更新(dlr) EventHander テストケースおよびサンプルの追加と 余分だった NullReferenceEventHander の削除(gmj) すべてのイベント関連の処理を org.apache.velocity.app.event パッケージへ移動し、それに依存するすべてを更新し、 パブリックなイベントインタフェースをサポートするようにコンテキスト関連を修正。 　 同時に、null をセットするメソッドの名前を適切なものに変更し、 メソッドに引数を追加。 (gmj) ResourceManagerの「resource found」メッセージを 表示しないようにするスイッチを追加。デフォルトはON。キーは "resource.manager.logwhenfound" (gmj)

1.0.1-dev − 1.0.1-dev

Released as v1.0.1-rc1 on April 10, 2001. 2001年4月10日に v1.0.1-rc1 としてリリースされました。 No changes following rc1. Released as v1.0.1 on April 22, 2001. rc1以降の変更点はありません。 2001年4月22日に v1.0.1 としてリリースされました。 Small fix to ASTGENode.java to catch NPE if LHS or RHS is null or not int or Integer. (gmj) Added examples-clean-forumdemo target to build.xml for cleaning up after building the forumdemo. (JSS) Small fix to ASTAndNode.java to short circuit if LHS is false, and to log an error of LHS or RHS is null. (gmj) Small fix to ASTGTNode.jave to catch NPE if LHS or RHS is null. (gmj) Documentation : changed license instructions in coding-standards.xml (gmj) Added 'throws Exception' to handleRequest() in VelocityServlet.java (suggestion from Christoph Reck) (gmj) Updates to README.txt and examples/README.txt as suggested by Kent Johnson (gmj) Added Enumerator as a valid iteration type for #foreach() - added warnings to use of same to documentation. (gmj) Added panic sqawk in AvalonLogSystem() to also go to stderr. (gmj) Finished all comparison nodes (NPE prevention and good logging) and enhanced logical.vm test template to try them all. (gmj) Added xmlapp_example to examples, and added to examples build target. Was moved from whiteboard. (gmj) ASTGENode.java で 右辺または左辺が、null、int、Integer でない場合に NullPointerException をキャッチするように少し変更。(gmj) forumdemo をビルドした後にクリーンアップするように、 examples-clean-forumdemo ターゲットを build.xml に追加。(JSS) 左辺が false の場合にショートカットし、右辺または左辺が nullのときにエラーをログに記録するように、ASTAndNode.java を少し修正。(gmj) 右辺または左辺が null の場合に NullPointerException をキャッチするように、 ASTGTNode.java を少し修正。(gmj) ドキュメント : coding-standards.xml でのライセンス説明の変更。(gmj) "throws Exception" を VelocityServlet.java の handleRequest() に追加。 (Christoph Reckの提案)(gmj) Kent Johnson による提案で、README.txt と examples/README.txt を更新。(gmj) #forwach() で妥当な繰り返しの型として Enumerator を追加 ── ドキュメントにも、これを使うことを促す注意書きを追加。(gmj) AvalonLogSystem() に標準エラー出力に出力されるように警告処理を追加。(gmj) すべての比較ノードの使用を中止し (NullPointerException 防止とロギングのため) 、 それらを全て試すように logical.vm テストテンプレートを強化。(gmj) xmlapp_example をサンプルに追加し、サンプルにビルドターゲットを追加。 whiteboard から移動。(gmj)

1.0b3 − 1.0b3

2001年4月2日にバージョン 1.0 としてリリースされました。 Released as version 1.0 on April 2, 2001 Documentation: Fix the VTL Reference guide for the #if statement. Thanks to Joaquim Carvalho for the find. (JSS) Documentation: Fixed the html in the user guide that generates the TOC so that the numbers come out in proper order. (JSS) Added common base class for application-level exceptions in package org.apache.velocity.exception. Thanks to Kyle Downey for the suggestion. (gmj) Added javadoc to o.a.v.context.AbstractContext clarifying which of the internalXXX methods are required. Thanks to Joshua Levy for the suggestion. (gmj) Added license and javadoc to examples/context_example/DBContext.java to clarify why some internalXXX methods are stubbed out. (gmj) Documentation : Clarification of VM properties and added note on VM declaration / usage order in user guide. (gmj) Fixed HttpServletRequestWrap.java - getInputStream() wasn't calling the method on the wrapped HttpServletRequest. Thanks to Shahar Solomianik. (gmj) Removed build.compiler from the build.xml file. (JSS) Fixed problem found by jon where high concurrency would lead to a dry parser pool, which would lead to vast unpleasantness masked as resource access errors. All seems to be better now. Simple fix, so little risk. (gmj) Added parser.pool.size as a configuration parameter to help tune Velocity configurations for high concurrency loads. (gmj) Documentation : developers-guide - information/example on making a custom logger, and start of work on documenting resource loaders. (gmj) Removed some debugging gibberish from InternalContextAdapterImpl.java (gmj) Committed John McNally's Texen patch to texen's Generator.java to keep from accumulating introspection cache data in iterative calls to parse() with template caching off. (gmj) Documentation : added some special-case Context information and a secion on Vel and XML in the developers guide. (gmj) ドキュメント: VTLリファレンスガイドの #if 文を修正。 Joaquim Carvalho の発見に感謝。(JSS) ドキュメント: 目次を生成するユーザガイドの HTML を、適切な順序で数字が 出力されるように修正。(JSS) org.apache.velocity.exception パッケージで、 アプリケーションレベルの例外のための共通ベースクラスを追加。 Kyle Downey の提案に感謝。(gmj) internalXXX メソッドのうちでどれが必要か明確になるように、 org.apache.velocity.context.AbstractContext に Javadoc を追加。 Joshua Levy の提案に感謝。(gmj) internalXXX メソッドのいくつかがスタブになっている理由を明確にするために、 examples/context_example/DBContext.java に Javadocとライセンスを追加。(gmj) ドキュメント: Velocimacro プロパティの明確化と、 Velocimacro の宣言/使用の順序に関する注意をユーザガイドに追加。(gmj) HttpServletRequestWrap.java の修正 ── getInputStream() が ラップされた HttpServletRequest のメソッドを呼び出していなかった。 Shahar Solomianik に感謝。(gmj) build.xml ファイルから build.compiler を削除。(JSS) jon によって見つけられた問題の修正。 同時実行数が多い時にパーサプールが空になってしまい、 リソースアクセスエラーと言う形に姿を変えるという、 望ましくない結果になっていた。現在はよくなっている模様。 単純な修正なのでリスクは小さい。(gmj) 同時実行数による高負荷に備えて Velocity 設定を調整できるように、 設定パラメータとして parser.pool.size を追加。(gmj) ドキュメント : 開発者ガイド ── カスタムログを作成するための情報/サンプル、 それにリソースローダーのドキュメント化作業を開始。(gmj) InternalContextAdapterImpl.java でのデバッグ時の意味不明な部分の削除(gmj) テンプレートをキャッシュしない parse() の反復呼び出しにおいて、 再帰キャッシュデータを蓄積しないようにするための、John McNally による TexenのGenerator.java へのパッチをコミット。(gmj) ドキュメント: 開発者ガイドに、特定の場合の Context に関する情報と、 Velocity と XML についてのセクションを追加。(gmj)

1.0b2 − 1.0b2

Released as version 1.0 beta 2 on March 26, 2001 2001年3月26日に Version 1.0 ベータ2 としてリリースされました。 Make the distribution have CRLF for all of the text files (JSS). Fixed release packaging to create things in the right directory structure (JSS). Re-added 'include' support for Configuration. (JVZ) Fixed VMProxy bug when reference arg was null. (#1074) (gmj) Fixed nullpointer problem in cache refresh in ResourceManager (reported by Ilkka Priha) (gmj) VelocityServlet now respects the 'default.contentType' property again. That must have fallen out during the 'request process' rework in VelServlet. (reported by csterg@aias.gr) (gmj) Changed AnakiaTask and TexenTask to use the canonical template file path rather than the literal string specified. Motivated for ease of gump-tion. Also added failonerror to the testcases.xml for the same reason. (gmj) Added Sam's suggestion for normalizing \n[\r] when comparing results to expected results in the testbed via BaseTestCase (gmj) Qualified import statments in Generator.java. Added tests for automatic boolean mapping in TexenTestCase.java. Added default boolean mapping to texen for properties used with the contextProperties option. Allow variants on boolean values in Configuration.java, and changes to relevant templates in testbed. Added default objects to context in TexenTask.java. (JVZ) Documentation changes to Configuration.java (DLR) Augmented the MethodInvocationException message in ASTMethod to make the stacktraces more useful - noted from some traffic on Turbine list. (gmj) Added powered by logo. Look in xdocs/images/powered-by-logo.psd/.gif (JSS) Changed the internals of the Configuration class so that setProperty(K,V) will replace the value at K with V; addProperty(K,V) works the way setProperty(K,V) used to: if there is a value already stored at K then V is added to the vector. If nothing is being stored at K then the scalar V is simply added. setProperty(K,V) is basically a short form for clearProperty(K)/addProperty(K,V). Also added setConfiguration(C), so that an application using velocity could easily take a subset of the application configuration using C.subset(velocityProps) and set the whole velocity configuration at once. This is now how the velocity service works in Turbine. (JVZ) Added support to the Runtime/Velocity classes for addProperty(K,V). (JVZ) Added support to Runtime/Velocity classes for setConfiguration. (JVZ) Confirmed that the build.bat works on Win98 as well as made the classpath that the build.bat generates equal to the one that build.sh generates. (JSS) 配布のすべてのテキストファイルの改行コードを CR-LF に変更。(JSS) リリースをパッケージ化する際に、正しいディレクトリ構造にするように修正。(JSS) 'include' サポートを Configuration に再度追加(JVZ) reference 引数が null のときの VMProxy バグ修正(#1074) (gmj) ResourceManager でのキャッシュリフレッシュ時の null ポインタ問題の修正 (Ilkka Priha による報告) (gmj) VelocityServlet が「default.contentType」 プロパティを再び優先するようになっている。 VelServletでの「request process」の再作業の間に修正が抜けたと思われる。 (csterg@aias.grによる報告)(gmj) 特定の文字列でなく、正規的 (canonical) なテンプレートファイルパスを使うように、 AnakiaTask と TexenTask を変更。あまり頑張らなくてもいいようにするため。 同じ理由で、testcases.xml に failonerror を追加。(gmj) Samの提案で、BaseTestCase を使った testbed で、 実際の結果と予想結果とを比較する際に、 \n[\r]を正規化するようにした。(gmj) Generator.java で import 文を修飾された形式に変更。TexenTestCase.javaで、 自動 boolean マッピングのテストを追加。contextProperties オプションと一緒に使用されるプロパティ用にTexenにデフォルトの boolean マッピングを追加。Configuration.java で boolean 値の変数を使用可能にし、 testbed の関連するテンプレートも変更。TexenTask.java で コンテキストへのデフォルトオブジェクトを追加。(JVZ) Configuration.java へのドキュメント変更 (DLR) スタックトレースをもっと役立つようにするために、ASTMethod の MethodInvocationException メッセージを増やした ── Turbine メーリングリストのあるスレッドで注意があったため。(gmj) powered by ロゴを追加。 xdocs/images/powered-by-logo.psd、 powered-by-logo.gif を参照。 (JSS) Configuration クラスの内部を変更した。具体的には setProperty(K,V) で K の値を V に置き換えるようにし、 addProperty(K,V) が以前の setProperty(K,V) の動作をするようにした。 以前の setProperty(K,V) の動作としては、もし K に何か格納されていたら、 V が Vector に追加される。もし K に何も格納されていなければ、 V がそのまま追加される。setProperty(K,V) は基本的に、 clearProperty(K)/addProperty(K,V) の短縮形式である。同時に setConfiguration(C) を追加し、Velocity を使うアプリケーションが、 C.subset(velocityProps) でアプリケーション設定の一部を容易に取得できるようにし、 Velocity の設定全体を一度にセットできるようにした。 この方法で、Velocity サービスは Turbine で動作している。(JVZ) Runtime/Velocity クラスに addProperty(K,V) のサポートを追加。(JVZ) Runtime/Velocity クラスで setConfiguration の追加(JVZ) build.bat が Win98 で動くことを確認し、それとともに build.bat が生成する classpath と build.sh が生成する classpath を同じにした。(JSS)

1.0b1 − 1.0b1

Initial release. 初期リリース。