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