その他のJakarta プロジェクトのものと同じように、ナイトリービルドとリリースされた JAKARTA-TAGLIBS バージョンのダウンロードは Jakarta ウェブサイト http://jakarta.apache.org/downloads/binindex.htmlから出来ます。 ダウンロードをし、適当な場所で展開して下さい。

配布されたアーカイブは次のようなディレクトリ構造をしています。

• LICENSE - Jakarta プロジェクトのソフトウェアの配布基準となっているApache Software Foundation のライセンスのコピー
• README - 参照可能なドキュメントの格納場所を表した README ファイル
• doc - このファイルを含め、JAKARTA-TAGLIBS プロジェクト全体のドキュメントを集めたディレクトリ。 次のものが含まれます。
  • JAKARTA-TAGLIBSバイナリ配布物の使用について (this document このファイル)
  • JAKARTA-TAGLIBSソース配布物 の使用について
  • JAKARTA-TAGLIBS へのカスタムタグの追加および拡張
  • Taglib 開発のガイドライン
• JAKARTA-TAGLIBS プロジェクトに含まれる、個々のカスタムタグライブラリのディレクトリ。 ディレクトリ名はプロジェクトの簡略名と一致します。それぞれのディレクトリには次のファイルが含まれます。以下の説明で{library} はプロジェクトの簡略名を意味します。
  • {library}.tld - このカスタムタグライブラリのタグライブラリディスクリプタファイル 通常このファイルは作成される web アプリケーションの/WEB-INF ディレクトリにコピーされ、web アプリケーションの DD (デプロイメントディスクリプタ) (/WEB-INF/web.xml)ファイルの<taglib> 要素で参照されます。
  • {library}.jar - このタグライブラリを構成するJava クラスと関連するリソースが入っている JAR ファイル。このファイルは通常 webアプリケーションの/WEB-INF/lib ディレクトリに入り、自動的にアプリケーションから参照可能となります。
  • {library}-doc.war - アプリケーションからどのようにしてこのタグライブラリを使用するかを説明する開発者向けのドキュメントが入っている web アプリケーションです。 このweb アプリケーションはサーブレットAPI 2.2 以降のものと互換のあるサーブレットコンテナに配置したら実行可能になります。
  • {library}-examples.war - このカスタムタグライブラリの使用法について説明するいくつかのサンプルを含む web アプリケーションです。 これらもアプリケーションはサーブレットAPI 2.2 以降のものと互換のあるサーブレットコンテナに配置したら実行可能になります。

JAKARTA-TAGLIBS に含まれるカスタムタグライブラリを使用するためには、次の手順を踏んで下さい。

• {library}.tldファイルをアプリケーションの/WEB-INF ディレクトリにコピーします。
• {library}.jar ファイルを /WEB-INF/lib ディレクトリにコピーします。
• 使用したいカスタムタグライブラリに必要な JAR ファイルを自作したWebアプリケーションの /WEB-INF/lib にコピーします。（タグライブラリのドキュメントを参照して下さい）
• 使用するタグライブラリの一つ一つについて<taglib> を web アプリケーションの deployment descriptor ファイル(/WEB-INF/web.xml)) に追加してください。 個々のエントリは次のようになります。

      <taglib>
  	<taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri>
  	<taglib-location>/WEB-INF/{library}.tld</taglib-location>
      </taglib>
      

• カスタムタグライブラリを使用する JSP ページの先頭に<%@ taglib%> ディレクティブを使い、そのライブラリの URI を指定します。（そのURIはwebアプリケーションの deployment descriptor ファイルの <taglib-uri> と一致しなければなりません） またそこにはそのJSPページでタグライブラリからのタグを見分けるためのタグ名の前置子（プレフィックス）を指定します。次に例を挙げます。

      <%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
      

• このライブラリからタグを使いたい場合は、 taglib ディレクティブで指定した前置子を記述して使ってください。またタグライブラリのドキュメントに説明されている属性名と値を使ってください。例えば、magic というタグを含むライブラリを上記の例で例示した通り、"x"という前置子を用いて使用するとすれば、以下のようになります。

      <x:magic/>
      

  もしそのタグに属性とボディ部のテキストが必要ならば

      <x:magic id="beanName" name="xyz">
  	... 本文またはネストされたタグ ...
      </x:magic>
      

  のようになります。
• ライブラリ中のタグについての説明はそれぞれのカスタムタグライブラリに付属しているドキュメントを参照して下さい。