Velocity - GenericTools

Generic Tools

ツールドキュメント

その他のサブプロジェクト

Overview

GenericTools contains a collection of reusable and well documented tools and utility classes of general interest to Velocity users. These classes and tools have no dependency on the VelocityView or VelocityStruts sub-projects. The tools may be used as you would any other POJO ("plain old java object").

GenericTools には Velocity の利用者が一般的に関心を持つ、再利用が可能で十分にドキュメントが整備されたツールやユーティリティーのクラスが集められています。これらのクラスやツールは VelocityView または VelocityStruts サブプロジェクトとは依存関係を持ちません。これらのツールは他の POJO ("plain old java object" ごく普通のJavaオブジェクトの意) と同じように利用することが出来ます。

Tools:

DateTool: A tool for manipulating and formatting dates.
MathTool: A tool for performing floating point math.
NumberTool: A tool for formatting numbers.
IteratorTool: A convenience tool to use with #foreach loops. It wraps a list to let the designer specify a condition to terminate the loop, and reuse the same list in different loops.
RenderTool: A tool to evaluate and render arbitrary strings of VTL (Velocity Template Language).

Utilities:

CommonsLogLogSystem: An implementation of Velocity's LogSystem interface that redirects log output to a Commons-Logging Log instance.
LogSystemCommonsLog: An implementation of Commons-Logging's Log interface that redirects log output to Velocity's LogSystem.

Tools:

DateTool: 日付の操作とフォーマットを行うツールです。
MathTool: 浮動少数点演算を行うツールです。
NumberTool: 数値のフォーマットを行うツールです。
IteratorTool: #foreach の繰り返し内で利用することの出来る便利なツールです。このツールはリストをラップし、テンプレートデザイナの指定した条件でループを終了させることができます。また、同じリストを別のループ内で再利用することもできます。
RenderTool: 任意の VTL (Velocity Template Language) 文字列を評価し、表示するツールです。

Utilities:

CommonsLogLogSystem: ログの出力を Commons-Logging の Log インスタンスに対して送る Velocity の LogSystem インターフェイスの実装です。
LogSystemCommonsLog: ログの出力を Velocity の LogSystem に対して送る Commons-Logging のインターフェイスの実装です。

Contributions

We welcome your contributions to this library. Patches can be sent to the mailing list or attached to a bugzilla ticket. The Wiki can also be a good place to discuss and develop ideas.

このライブラリへの貢献を歓迎します。パッチはメーリングリストに送るか、 bugzillaのチケットとして添付してください。また、Wiki もアイデアを議論、発展させる為の良い手段となります。

Checklist for Contributions

Velocity coding conventions
JavaDoc included (the more detailed the better)
Examples included (in JavaDoc or as stand-alone template example)

貢献していただく際のチェックリスト

Velocity コーディング規約
JavaDoc が含まれていること (詳細なものであればなお良い)
例が含まれていること (JavaDoc 内の記述、または単独で動作するテンプレートの例)

[訳注: この文書は日置聡高橋達男が翻訳しました。日本語訳に対するコメントがあれば、report@jajakarta.orgに送って下さい。]