基本的に Anakia は
JDOM と
Velocity
を用いて、XML 文書をあなたの選択したフォーマットに変換する XML 変換ツールです。
Anakia は、XML ファイルを処理する Ant の <style> タスクと
XSL に替わる機能を提供します。
AnakiaTask が使う基本モデルは、かなり簡単です。
- JDOM ドキュメント内で XML を解析:
SAXBuilder builder;
Document root = null;
try
{
builder = new SAXBuilder(
"org.apache.xerces.parsers.SAXParser" );
root = builder.build( file );
}
catch( Exception )
{
System.out.println( ... );
}
- ドキュメント (または root 要素) に内容を入れ:
context.put("root", root );
- Velocity を使ってテンプレートをレンダリングします。
テンプレート内部で、XML 文書に含まれるデータにアクセスすために
JDOM のメソッドを利用できます。
Anakia は、XSL よりも簡単に使い方を覚えられるかもしれませんが、
XSL と同等の機能を提供します。
暗号のような <xsl:> タグを学ぶ必要はもうありません;
提供されたコンテキスト・オブジェクト、JDOM と Velocity
の単純な指令を使う方法を知る必要があるだけです。
Anakia は、Xalan の XSL プロセッサと比べ、非常に高速にページを生成します。
（23 ページを生成するのに、JDK1.3 とクライアント Hotspot で Pentium III の 500MHz の
Win98 上で 7 〜 8 秒で生成します。Ant の <style> タスクを使った同じようなシステムでは
14 〜 15 秒かかり−約 2 倍の速度差があります。）
Anakia は、Stylebook の置き換えを目的としています。
Stylebook は、元々全てのページが同じ見た目を持つような単純で静的な Web サイトを生成するために使われました。Anakia は、ドキュメンテーション/プロジェクトの Web サイト（例えば
www.apache.org サイト
と
jakarta.apache.org サイト
）に最適です。
Anakia は、使用目的を絞り込むことで、XSL の「余分な」機能の一部は提供しません。
jakarta-velocity/examples/anakia ディレクトリにあるサンプルは
Anakia の良い使い方を示しています。
あなたは、Anakia が非常に使いやすことが分かるはずです。
Anakia は、あなたの project.xml ページの（オプションの）JDOM 文書オブジェクトと同様にコンテキスト（それは .xml ページの JDOM 文書オブジェクトを含みます）を生成します。
.vsl ページは、(Velocity を使って) コンテキストで実行されます。
あなたは、それからあなたの .xml ファイル処理し、
単に JDOM 文書オブジェクトのメソッドを実行して情報を引き出すことができます。
Anakia は、この Web サイトのドキュメントを作成するためだけでなく
、Jakarta プロジェクトで活動している多くのプロジェクトの Web サイトや、
ドキュメント生成に利用されています。
この過程は、サイト上のdocumentedにあります。
あなたは、Velocity のあなた自身のニーズのためにを使うことを歓迎します。
