Velocity Changes

この文書は、リリースの間で Velocity で変更点をたどります。

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

このセクションは、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 としてリリースされました。

レンダリング時に最後に加えられたものが利用できることを確実にするために、「roll forward」EventCartridges 用に AbstractContext を修正(gmj)
jar-src ターゲットとドキュメントのターゲットに関して開発者ドキュメントへの小さい変更点。(gmj)
以下のようにつかえる素晴らしいけど、正しいサポートするための AND と OR ノードのための小さい変更。 #set( $foo = ($woog || $bar ) ) (gmj)
文字ストリームParserへの大きな変更 - すでに stock javacc 生成された ASCII 8ビット文字ストリーム、しかし、Unicode 'custom'文字ストリーム。これは、16ビット文字で　0a, 0d が下位バイトでの不具合が報告されているものが解決します。(gmj)
Ilkka Priha, Michael Zhou, Vitaly Repetenko によるエンコーディングのためのテストテンプレートの追加。ありがとう (gmj)
Russel Edens からの Texen の Generator.java の fileWriter キャッシュのクリア更新 (JSS)
(local.scope)でのネームスペース使用時に VMネームスペースのダンプが発生しないように VMシステムの修正 (gmj)
VMシステムにVMにargとしてパスされるnon-referenceの正しい『schmoo』出力を修正。 DLR と Paulo に感謝。(gmj)
Robert Burrell Donkin による StringUtils の更新 (gmj)
#parse と VM からの propogate out のための MIE propogation　の追加。 Michael Salmon に対してこの点で感謝します(gmj)
完全にするためにVelocityクラスのためのログインタフェースの追加 (gmj)
WebMacro 変換ツールで変換されるファイルの自由なファイル設定のための Michael Salmon によるパッチ。(gmj)
ParserException として投げられる TokenManagerErrorは、現在、アプリケーションレベルでキャッチすることができる(Tim Joyceによる提案)(gmj)
どこでも正しく ObjectArray と IntegerRange が扱えるようにパーサーの小さな修正(gmj)
テストドライバのための速度最適化(dlr)
デバッグ時により便利な例外の割り込みを作成するための(gmj) Conor MacNeillによるMIEメッセージのための拡張。
#parse() と #include() の小さな修正。テンプレート/リソースがファイルベースでなかったときのようにストームベースではなく、'parent template'エンコーディングが使用される #parse/#include に渡す引数をデコードする。実行時デフォルトは使用される。 Dan Finkelstein によるバグの発見に感謝。(gmj)
Andreas Wikberger による報告と問題の修正(パッチも!) 時間ベースのときに2つのロードが要求されたときにテンプレートが変更後にリフレッシュされる。(gmj)
log4j アダプターで 1.1.x に対応するための build/lib で一致するように jar の更新 (gmj)
ライブラリが見つからないか、空文字列のときに、恐ろしいメッセージが出力されないのを変更。Tal Dayan による提案(gmj)
VelocityFormatterの自動オルタネータの追加(dlr)
Velocityで実行時インスタンスの分割と、アプリケーションサポートクラス o.a.v.app.VelocityEngneの追加と変更(gmj)
build/lib での JUnit 3.7 への更新 (gmj)
Anakia での XPath のサポートの追加。Attila Szegedi にかのパッチのチェックイン。これらは、以前のバージョンと完全互換があります。(jss)
Ant を使った便利な build/test.sh スクリプトの修正。(jss)
Attila Szegedi(szegedia@freemail.hu)によるIntrspector の修正 - 内部クラスへのアクセスとデフォルトやprivate facades の public インターフェースに関連した問題の削除 (gmj)
VMシステムに対する、新規のautoreload 機能の追加 - VM グローバルライブラリは、使用して自動的にリロードします。開発者ガイドの「設定」セクションに詳細があります。(gmj)
ロギング変更: RuntimeInstance の出力プレフィクスを移動して log4jユーザが必要無いのでよりよいサポートの実装。変更された ExternalLoggerTest で実行時インスタンスとをサポート。 log4j アダプターのサポートは、Jeroen C. van Gelderen によります。また、LogSystem.init() は、 Exception を投げます (gmj)
また、AvalonLogSystem の追加で既存の階層から単にロガー名を指定するだけで変更できる。Carsten Ziegeler (gmj)
Texen 拡張 - jar からテンブレートリソースを使用できるようにした (jvz)
#parse()や#include()でのVelocityExceptions (RNFE, PEE, MIE) の適切な伝播を許可 (gmj)
VM内で渡された形式参照の修正(gmj)
Attila Szegedi と Paulo Gaspar によるクラスローダーの変更が検出されたときのきゃっしのダンプを許可するための Introspector の Revamping (gmj)
クラスローダー変更時のintrospectionキャッシュのダンプの検証テストケースの追加(gmj)
PrimordialLogSystem の追加と変更された RuntimeInstance の使用(gmj)
ASTRefernce 表記のための小さな修正 (gmj)
Texen 拡張 - 複数プロパティ指定を許可する (jvz)

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

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

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

最後に変更されたものがレンダリング時に利用できることを確実にするために、「roll forward」のためにAbstractContextにEventCartridgesを修正。(gmj)
jar-src ターゲットとドキュメントに関する開発者ドキュメントへの小さい変更。（gmj）
AND と　OR ノードを便利に使えるようにする小さな変更 #set( $foo = ($woog || $bar ) ). (gmj)
文字ストリームパーサーへの大きな変更 - もはや　stock を使用せず javacc は ASCII 8ビット文字ストリームを生成しますが、Unicode 'カスタム'文字ストリームです。これは、16ビット文字で 0a 0d が含まれる文字列バイトの問題を解決します。(gmj)
Ilkka Priha, Michael Zhou and Vitaly Repetenkoからの貢献を使ったテストをコード化することへの加えられた追加のテンプレート（gmj）

このセクションは、1.0.1リリースの後、主な枝に変更された1.1-devについて説明します。これは、それからCVSでのVEL_1_1_BRANCHとして分岐して、2001年5月20日にv1.1-rc1としてリリースされました。

build.sh と build.bat スクリプトを削除して Ant で作成するようにしました。
Kentと他と私の変更点をVelocityServletに加えました。基本的変更点は、handleRequest()を帰りの null を許されるようにすることと同様にreq（respとctx args）を要求が世話をされることを明らかにするとみなすようにしてす。代替物のために加えられたサポート・テンプレート（入力ソース）のためにコード化します。(gmj)
(入力ソース)テンプレートで別のエンコーディングのサポートを追加しました。それは、(input/output)の2つのプロパティで制御でき、UTF-8でテストしました。 UTF-8 rocks. その他はあるのは何故? :) テストケースの追加 (gmj)
MethodInvocationExceptionsが2、3の位置においてメソッド例外のために正しく発生しなかった問題の修正。正しく動きます。（gmj）
Charles Bennet による修正の追加、classpathに際にビルドする例のために全ての必要な部分を含むbuild.xmlの修正(gmj)
ASTのためのパフォーマンス改善の追加、Kent Johnson からの大きな貢献に加え ConfigureationとResourceManagerの提案(gmj)
さらなる MethodInvocationExceptions : #set()の左辺が例外をなげて、正しく扱うことができない。(gmj)
EventCartridge サポート。ドキュメント参照 :) (gmj)
ドキュメント : 基本 EventCartridge 説明。 (gmj)
テンプレート用のエンコーディング指定の要求追加(gmj)
Tim Joyce の追加によるさらなる Method Exception の取扱いと例外イベントの扱い(gmj)
ASTDirective と　Include に対する Kaspar Nielsen のパフォーマンスパッチ(gmj)
Robert Burrell Donkin からのTexen パッチ。これは、Texen にすべての例外を扱うことができるようにする(gmj)
#$foo, $$foo, #$#$foofoo などの指定の宣言バグの修正 (gmj)
Servlet例のための自動コンフィグサポートの追加でユーザが新規にサーブレットを追加するとにきREADMEに TomcatでWebアプリケーションのHELPを追加(gmj)
VelocityServletと対称のVelocityWriteリサイクルでの出力ストリームの.close() を削除(gmj)
Velocity Configuration クラス(現在推奨されません)から、 Jakarta COmmons collectionコンポーネントの ExtendedPropertiesクラスへの変換。これらはVelocityから名前変更されました。その結果として、その他のConfigurationと推奨されないメソッドが o.a.v.app.Velocityには変更ありません。(gmj)
build/build.sh と　build/build.bat と build/lib/ant*.jar は、削除されAntベースのビルドに変更 (jss)
JarResourceLoader を通常「バス」設定キーに変更し、 MultiLoaderTestCaseに追加(gmj)
WM 変換ツールでの regexp の更新(dlr)
EventHander テストケースと例の追加と余分なNullReferenceEventHanderの削除(gmj)
すべてのイベント関連のものを o.a.v.app.event パッケージへ移動し、それに依存するすべての更新し、コンテキストのものを public イベントインタフェースでサポートするようにした。　またリネームされたものは、nullにメソッドをセットしてなにもしないように変更 (gmj)
ResourceManagerの「resource found」メッセージを変更できるようなスイッチを追加。デフォルトはONキーは「resource.manager.logwhenfound」(gmj)

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

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

ASTGENode.java で右辺または左辺がnullやintやIntegerじゃない場合に NPEをキャッチするように小さな変更(gmj)
examples-clean-forumdemo ターゲットを build.xml に追加。 forumdemoの構築後にクリーンアップする。(JSS)
ASTAndNode.java での小さな修正。右辺がfalse の場合にショートカットするのと、右辺または左辺が nullのときにログにエラーを記録(gmj)
ASTGTNode.java の小さな変更。右辺または左辺がnullの場合にNPEをキャッチする(gmj)
ドキュメント : coding-standards.xmlでのライセンス説明の変更(gmj)
'throws Exception' を VelocityServlet.ajva のhandleRequest()に追加。 (Christoph Reckの提案)(gmj)
README.txt と examples/README.txt の更新。Kent Johnsonによる提案(gmj)
#forwach()　のための　イテレーションが有効な Enumeratorの追加 - 使うときにはドキュメントの警告を読むこと (gmj)
stderr と AvalonLogSystem()にsqawk のpanicを追加(gmj)
すべての比較ノードを完了(NPE 防止とロギング)と logical.vm テストのテンプレートですべてをテストするように追加(gmj)
xmlapp_example で例のテストと例のビルドターゲットを追加。 whiteboardから移動(gmj)

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

ドキュメント: VTLリファレンスガイドの #if 文を修正。 Joaquim Carvalho の発見に感謝(JSS)
ドキュメント: ユーザガイドのHTMLの生成で、目次がちゃんとした順番ででてくるように修正(JSS)
アプリケーションレベルで例外の共通ベースクラスを追加 org.apache.velocity.exceptionパッケージ。Kyle Downey の提案に感謝(gmj)
明らかになっているo.a.v.context.AbstractContextに加えられたjavadoc、internalXXXメソッドのそれは、必要です。Joshua Levyの提案に感謝（gmj）
examples/context_example/DBContext.java に javadoc　とライセンスを追加し internalXXX メソッドがもみ消される理由を明確にした(gmj)
ドキュメント: VMプロパティの明確化とVM宣言と使用順番の注意をユーザガイドに追加(gmj)
Fixed HttpServletRequestWrap.java の修正 - getInputStream() は HttpServletRequest をラップするメソッドを呼び出さない。 Shahar Solomianik に感謝(gmj)
build.xml ファイルから build.compiler を削除 (JSS)
jonによって見つけられた問題の修正。高並列でパーサープールが空になってしまい、そして、それはリソース・アクセス・エラーとしておおわれる巨大な不愉快に至ります。現在はよくなっています。簡単な修正でリスクは小さいです(gmj)
parser.pool.size でパラメータ設定としての追加で Velocity設定で高並列の負荷での調整ができます(gmj)
ドキュメント : 開発者ガイド - カスタムログを作成するめたの情報と例。そしてリソースローダーのドキュメントの開始。(gmj)
InternalContextAdapterImpl.java での意味不明なデバッグの削除(gmj)
John McNally による Texen のパッチのコミット。イントロスペクションをキャッシュしないでいるGenerator.javaは、離れてキャッシュしているテンプレートでparse()に反復相呼び出しにおいてデータをキャッシュします。(gmj)
ドキュメント: ある特定の場合 Context情報と、Vel と XML について開発者ガイドに追加 (gmj)

2001年3月26日にリリースされるVersion 1.0β2

すべてのテキストファイルでCRLFを配布で作成(JSS)
正しいディレクトリ構成でパッケージを生成するように修正(JSS)
'include'サポートを設定に再度追加(JVZ)
reference 引数が null のときの VMProxy バグ修正(#1074) (gmj)
ResourceManagerでのキャッシュリフレッシュ時のnullポインタ問題の修正 (Ilkka Prihaによる報告) (gmj)
VelocityServlet は、現在　'default.contentType' プロパティを再び考慮します。 VelServlet で再び動く'request process'で実施されます(csterg@aias.grによる報告)(gmj)
規範的なテンプレートを使うように変更したAnakiaTaskとTexenTaskは、指定されるリテラル文字列もよりむしろパスをファイルに入れます。 gump-tionの容易さのために動機を与えられますまた、同じもののためのtestcases.xmlへの加えられたfailonerrorは、推理します。 (gmj)
Samの提案で正規化を追加 \n[\r] 比較結果がBaseTestCaseでの testbedの結果として(gmj)
Generator.java.での修飾された import 文。自動booleanに対する検査を加えますTexenTestCase.java.で写像する contextPropertiesで使われるプロパティのためにオプションをtexenに写像している加えられたデフォルトのboolean。 testbed.で関連するテンプレートにConfiguration.javaと変更点でboolean値の上で変化を許してください TexenTask.java.でのコンテキストへの加えられたデフォルトのオブジェクト(JVZ)
Configuration.javaへのドキュメント変更 (DLR)
ASTMethodでのMethodInvocationExceptionメッセージの引数でスタックトレースをさらに便利にする同じトラフックはTrubineリストであります。(gmj)
powerd by ロゴを追加。 xdocs/images/powered-by-logo.psd/.gif 参照。 (JSS)
構成の内部がsetProperty(K,V)がVでKで値を取り替えることになることをそう分類することを変えました; ：への方法setProperty(K,V)が使ったaddProperty(K,V)作業すでに保存される値がKであるならば、Vはベクトルに加えられます。何も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で build.sh生成と同じことを確認(JSS)

初期リリース