Velocity

Velocityについて

コミュニティ

ドキュメント

比較

ツール

インストール

Velocityは、Java 2 VMがインストールしてあるさまざまなプラットホームで実行できます。 ソース・コードからVelocityをコンパイルしたい場合には、J2SDKが必要です。

配布からVelocityをビルドするのに必要なものは、 CVS または 夜間ビルドから入手することができます。 また、すばらしいJavaベースのツールであるAntをインストールする必要があります。 AntもまたJakartaプロジェクトの、 ここにあります。

配布ディレクトリツリーは、以下のようになります

jakarta-velocity
  /build        - ビルドスクリプトが含まれる
  /bin          - 構築されたjarやclassが収まる場所
  /src          - Velocity, Anakia, Texenのソースコード
  /docs         - HTML 形式のドキュメント
  /docs/api     - VelocityソースのJavadocs
  /examples     - 例とドキュメントのコード
  /convert      - WebMacroテンプレートからの変換のためのツール
  /test         - テストプログラムとテンプレート
  /xdocs        - 私たちのドキュメントのソース


ビルド

Velocityを簡単に一貫性をもたせてビルドするために、我々は Jakartaプロジェクトで Antと呼んでいる ビルドプロセスのバージョン1.3またはそれ以降が必要です。 我々は、あなたがAntのインストール指示に従って、 正しくそれをインストールしてもらうと仮定します。 それは、難しくなくないし、私はあたなのプログラマーの道具箱に このすばらしいツールを追加するだろうと思います。

下記の個々の場合には、あなたがCVSからの配布やナイトリービルドや最新版を 得て、unpackに成功していると仮定しています。 また、あなたが『jakarta-velocity』ディレクトリ(配布ツリーのルート)に いると仮定しています。 全てのディレクトリ・リファレンスは、「jakarta-velocity」に関連しています。

build ディレクトリに移動してください (cd build)。 それから、jarファイルを構築するためには、単に次のようにタイプします。

ant

このスクリプトを実行すると、Velocity配布ディレクトリの中に binディレクトリが作成されます。 binディレクトリはvelocity-XX.jarファイルと 同様にコンパイルされたクラス・ファイル(classesディレクトリ内で) が含まれます。ここで、XXは現在のバージョン番号です。 必ずVelocityの.jarファイルを含めるためにあなたの クラスパスを更新してください。

開発者ガイドで詳述されるように、 構築するためには、なにかしら構築ターゲットを指定することに注意してください。 単にターゲット名をコマンド行に追加してください。 例えば、Javadoc APIドキュメトを構築するには以下のようにします。

ant javadocs

Velocityは、『箱から出して』つまり、あなたのclasspathから独立させて構築すべきです。 あなたがVelocity構築中にエラーが出た場合には、別の夜間構築(時々我々が間違いをして、毎夜のスナップショットの時点でCVSが完全でないので)またはCVS(開発者がものを中でチェックしていたが、あなたはCVSスナップショットを得たかもしれません)からリフレッシュを試みてください。

問題が存続するならば、我々のメール・リストを通してVelocityコミュニティで 質問するのをためらわないでください。 それは、ここで見つけることができます。Jakartaメールにでも参加するためにガイドラインをよく読んで理解してください。


インストール後のテスト

Velocity開発者は自動化されたテスト機能を使います、そして、それは配布に含まれています。 あなたは、あなたが構築したVelocityで全てが問題ないことを確認するために、 それを使うことができます。

テストスーツを実行するために、構築ターゲットを test としてビルドします。

ant test

うまくいけば、出力はこうなります。

test:
Running JUnit template tests for Velocity ...
Adding TemplateTestCase : arithmetic
Adding TemplateTestCase : array
Adding TemplateTestCase : block
   .
   .
   .
Adding TemplateTestCase : math
Adding TemplateTestCase : range
Adding TemplateTestCase : get
Adding TemplateTestCase : velocimacro2
Adding TemplateTestCase : foreach-type
Adding ContextSafetyTestCase.
......................................
Time: 2.553

OK (38 tests)

たくさんのテストと多くの実行結果が表示されます。 テストの実行後に'OK'が表示されればすべてOKです。 さて、Velocityを使う時がやってきました。



このドキュメントは、 熊坂祐二 が訳しました。コメントがある場合は、 jajakarta-report@jajakarta.good-day.net までお願いします。
Copyright © 1999-2001, Apache Software Foundation