Velocity Changes

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

1.2は2001年12月9日にリリースされました。

このセクションは、1.2-rc3のリリース後にVEL_1_2_BRANCH への変更点について説明しています。 1.2-rc3は、コミュニティ内のちょっとしたチェックのために 2001年11月7日にリリースされました。 1.2に向けた最後のRelease Candidateの予定です。

invokeVelocimacro()向けにVelocity.javaとVelocityEngine.javaを修正。 (何ヶ月か前の)最後のメジャーなVM変更でおかしくなったようだが、誰も気がつかなかった。(gmj)
新しいno-dep JARについての注意書きを追加。(gmj)

このセクションでは、VEL_1_2_BRANCHへの変更点について説明します。 1.2－rc2は1.2-rc1の管理上の修正(ファイルが壊れていた)のために、 2001年10月18日にリリースされました。

1.3で「丸括弧が消える問題」とちょっとしたバグの修正を後方移植。(gmj)
オートリロードの無限ループとローカルスコープ干渉のバグ修正を後方移植。(gmj )
Texenパッチ(Stephane Bailliez)と、関連する修正(jvzとdlr)を後方移植。(gmj)
デフォルトでは、ビルドターゲットにVelocityのJARファイルへの外部依存を含まないように変更。(gmj)

このセクションは、1.2-rc1 リリースの後、VEL_1_2_BRANCH への変更点について説明しています。

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.1 のリリース後のメインブランチへの変更点について説明します。このバージョンはその後、 CVS で VEL_1_2_BRANCH として分岐して、 2001年9月26日に v1.2-rc1 としてリリースされました。

レンダリング時に最後に加えられたものが利用できることを確実にするために、 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で)ネームスペース使用時に VMネームスペースのダンプが発生しないように VMシステムを修正。 (gmj)
Velocimacro に引数として渡される参照以外の実体 [定数など] が、そのままの形で正しく出力されるように Velocimacro システムを修正。 DLR と Paulo に感謝。(gmj)
Robert Burrell Donkin による StringUtils の更新 (gmj)
#parse()とVMからのMethodInvocationException伝搬をさらに伝搬する処理を追加。 Michael Salmon に対してこの点で感謝。(gmj)
完璧にするためにVelocityクラスへのログインタフェースの追加 (gmj)
任意のファイルを変換するためのWebMacro 変換ツールへの Michael Salmon によるパッチ。(gmj)
アプリケーションレベルでキャッチすることができるように、TokenManagerErrorを ParserException としてThrowするようにした。(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)
ライブラリが見つからないか、空文字列のときに、恐ろしいメッセージが出力されないように変更(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)によるIntrospectorの修正 - 内部クラスへのアクセスとdefaultまたはprivateのファサードに対するpublic インタフェースに関連した問題を解決。(gmj)
VMシステムに新規の自動リロード機能の追加 - VM グローバルライブラリは利用時に自動的にリロードする。詳細については開発者ガイドの「設定」セクションを参照。(gmj)
ロギング変更: 必要としない優良な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)
通常参照をVM内で渡せるように修正。(gmj)
クラスローダーの変更が検出された場合にキャッシュのダンプができるように Introspectorを修正(Attila Szegedi と Paulo Gaspar による)。(gmj)
クラスローダー変更時にダンプされたIntrospector によるキャッシュをチェックするように検証テストケースを追加(gmj)
PrimordialLogSystemを追加し、それを使うためにRuntimeInstanceを変更。(gmj)
ASTRefernce表記を少し修正。(gmj)
Texenの強化 - 複数のプロパティファイルを指定できるようにした。(jvz)

このセクションでは、1.1-rc2リリース後のVEL_1_1_BRANCH への変更を説明します。これは、2001年6月16日にv1.1としてリリースされました。

TexenのGenerator.javaのfileWriterキャッシュをクリアするように更新 (Russel Edensによる)。(JSS)

このセクションでは、1.1-rc1のリリース後のVEL_1_1_BRANCH への変更を説明します。これは、2001年6月2日にv1.1-rc2としてリリースされました。

AbstractContextで最後に変更されたEventCartridges を、レンダリング時に確実に使えるように「ロールフォワード」するように修正。(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.0.1のリリース後のメインブランチへの変更について説明します。その後、CVSでVEL_1_1_BRANCHとして分岐して、2001年5月20日にv1.1-rc1としてリリースされました。

利用者にAntを「インストール」してもらえるように、 build.sh と build.bat スクリプトを削除。
Kent他の変更点、および私の変更点をVelocityServletに追加。基本的変更点は、handleRequest()がreq、resp、ctxを引数に取るようにしたことと、 requestが処理されていることを示すためにnullを返せるようにしたこと。(gmj)
(入力ソースの)テンプレートで代替エンコーディングのサポートを追加。これは(入出力の)2つのプロパティで制御でき、UTF-8でテストされた。 UTF-8はすごい。他はありえない :)。あとテストケースを追加 (gmj)
何箇所かで、メソッド例外に対してMethodInvocationExceptions が正しく発生しなかった問題の修正。今はちゃんと動いている模様。（gmj）
build.xmlでサンプルをビルドするためのclasspathで必要な部分を含むように修正を追加 (Charles Bennetから)。(gmj)
ASTのためのパフォーマンス改善の追加、大半はKent Johnsonのおかげで、それに加えて ConfigureationとResourceManagerも提案してくれた。(gmj)
MethodInvocationException群がもっと面白くなった : #set()の左辺は例外をなげる可能性があったが、正しく扱うことができなかった。(gmj)
EventCartridge サポート。ドキュメントを参照 :) (gmj)
ドキュメント : 基本的なEventCartridgeの説明。 (gmj)
テンプレート用のrequest固有のエンコーディング仕様を追加。(gmj)
Tim Joyceによる、Method Exception の伝搬と例外イベント処理の追加。(gmj)
Kaspar Nielsenによる、ASTDirectiveとIncludeに関するパフォーマンスパッチ。(gmj)
Robert Burrell Donkin による、Texenが例外を全てthrowするようにする Texen パッチと、javadocをいくつか。(gmj)
非常に喝采を浴び、怖れられた、#$foo, $$foo, #$#$foofoo などのバグの修正 (gmj)
Servletがはじめてのユーザを手助けするServlet サンプル用に自動コンフィグサポートの追加と、 Tomcatを見つけてWebアプリケーションをセットアップすきるように、ちょっとしたREADMEの追加。(gmj)
VelocityServletとそれに対応するVelocityWriteリサイクルでの出力ストリームの .close()の削除。(gmj)
Velocity Configuration クラス(現在は非推奨)から、 Jakarta Commons コレクションコンポーネントの 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)
WM 変換ツールでの regexp の更新(dlr)
EventHander テストケースとサンプルの追加と余分だったNullReferenceEventHanderの削除(gmj)
すべてのイベント関連の処理を org.apache.velocity.app.event パッケージへ移動し、それに依存するすべてを更新し、 public イベントインタフェースをサポートするようにコンテキスト関連を修正。　同時に、NULLをセットするメソッドの名前を適切なものに変更し、メソッドに引数を追加。 (gmj)
ResourceManagerの"resource found"メッセージを表示しないようにするスイッチを追加。デフォルトはON。キーは "resource.manager.logwhenfound" (gmj)

2001年4月10日にv1.0.1-rc1としてリリースされました。

rc1以降の変更点はありません。 2001年4月22日にv1.0.1としてリリースされました。

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.ajva の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)

2001年4月2日にバージョン1.0としてリリースされました。

ドキュメント: 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)
ドキュメント: VMプロパティの明確化とVM宣言と使用順番の注意をユーザガイドに追加。(gmj)
Fixed 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情報と、開発者ガイドにVelとXMLについてのセクションを追加。(gmj)

2001年3月26日にVersion 1.0β2としてリリースされました。

配布のすべてのテキストファイルの改行コードをCRLFに変更。(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メッセージを増やした - Trubineメーリングリストのあるスレッドから注意があったので。(gmj)
powerd 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)

初期リリース。