| Home | |
|---|---|
| Jakarta Taglibs | |
| JCPに標準化されているタグ・ライブラリ | |
|---|---|
| Standard: JSTL (1.2) | |
| 拡張ツール | |
|---|---|
| UltraDev 4.0 | |
| 砂箱(Sandbox) |
|---|
| Jakarta コミュニティ | |
|---|---|
| さらに深く | |
| メーリングリスト | |
| CVSリポジトリ | |
| リファレンス・ライブラリ | |
| バグ・データベース | |
| JAKARTA-TAGLIBS コミッターからの承認 |
|
新規のタグライブラリまたはctlx の作成は taglibs-dev メーリングリストに提案されなければなりません。ソースリポジトリにはそれが承認されたときにはじめて追加されます。この手続きにはタグライブラリや ctlx にユニークな{taglib-name}を選択することが含まれます。その{taglib-name}はjakarta-taglibsソースリポジトリにあるタグライブラリのディレクトリとファイル名の一部として使用されます。
|
| 新規タグライブラリの作成またはCTLXディレクトリとファイルの構成 |
|
新しいタグライブラリやCTLX用のディレクトリやファイルの構成は ant のビルドターゲット
上記のように作成されたxmlファイルをカスタマイズして新しいタグライブラリを作る必要があります。
xmlファイル内の変更すべきテキストを大括弧
もし新しく作成するタグライブラリがservlet.jar以外のAPIまたは指定された以外のバージョンのAPIを使っている時は |
| タグライブラリのコーディング規約 |
|
タグライブラリをインプレメントするすべてのクラスは
HOWTO-RELEASEファイルを読んで下さい。この文書はタグライブラリのリリースサイクルについて説明しています。
Apache Software Foundation のライセンス条項をすべての java ソースコードの先頭に付けておいてください。
Apache Software Foundation ライセンス条項の２行目から以下のCVSタグをつけてください。 * $Header$ * $Revision$ * $Date$ファイルがコミットされるたびにCVS は上記のタグを元に変更履歴を書き込んでいきます。
JavaDoc が作成するタグライブラリのAPIの説明を生成できるように適切なコメントをつけてください。
標準的なjava のコーディング規約に則ってください。
次のような規約に基づいて、タグ、属性、スクリプト変数ビーン属性の名前を付けてください。
theSecondWord.
JSPタグのライフサイクルがどのようにJSPタグのデザインに影響を及ぼすかが明確でない場合は、
Taglib開発者へのガイドラインを参考にして下さい。
Java のクラスの命名については次のガイダンスにしたがってください。
もし新規に作成するタグライブラリが、外部のJARファイルを必要とするとき、
CVSリポジトリにそれらのファイルをチェックインしてしまいたいと思うかもしれ
ません。しかし、このような行為は Jakarta プロジェクトのガイドラインによって禁止
されています。共有ライブラリのバージョンの相互依存関係のために多くのエラーを引き起こしかねないからです。
そのかわりにそのライブラリに必要なライブラリやその他のコンポーネントの取得の方法を文書化しておいてください。
|
| タグライブラリへのタグの追加 |
|
cd コマンドなどで、作成するタグライブラリのディレクトリに入ってください。
新しい
新しいタグを作成するための java ソースコードを記述します。
|
| タグライブラリの構築 |
|
cd コマンドなどで、タグライブラリのディレクトリに入ってください。
Ant を使用してのタグライブラリの構築の仕方についてはJAKARTA-TAGLIBS ソースディストリビューションの使用にあたって
を参照して下さい。
|
| jakarta-taglibs リポジトリへのタグライブラリの追加 |
|
jakarta-taglibs へのコミット権限がなければ、そのタグライブラリのソースを zip で圧縮し、taglibs-dev メーリングリストにタグライブラリの追加をしたい旨を伝えてください。
もしコミット権限をもっているならば CVS を利用して新しいタグライブラリのディレクトリとファイルを add し、それから commit してください。jakarta-taglibs リポジトリでの CVS の使い方
については
CVSの使用文書中の「Full Remote CVS Access」のセクションを参照して下さい。
|
| タグライブラリのhttp://jakarta.apache.org/taglibs への公開 |
|
<newsitem>を<news>セクションの先頭につけ、新しい
タグライブラリについてアナウンスします。
<!-- news item の例
<newsitem date="05/19/2001" libname="MyTaglib">
The new cool MyTaglib has been added. (チョーかっこいい MyTaglib が加わります)
</newsitem>
-->
タグライブラリには<taginfo>を<tagindex>セクションに追加してください。
<!-- taginfo の例。初期状態は「開発中」であること。
Example taginfo, initial state should be "develop"
<taginfo name="DBTags" state="develop">
DBTags (以前は JDBC と呼ばれていた)タグライブラリには
SQLデータベースの読み書きに役立つタグが入っています。
</taginfo>
-->
カスタムタグライブラリ拡張(CTLX)には<ctlxindex>セクションに <ctlxinfo>を追加してください。
<!-- ctlxinfoの例
<ctlxindex>
<ctlxinfo name="UltraDev" state="develop">
UltraDev CTLX は UltraDev 4.0 を利用した JSP ページを作る際に使用する JSPカスタムタグを提供します。
</ctlxinfo>
</ctlxindex>
-->
新しいタグライブラリができたことを公表するために、
jakarta-taglibs build.xml を編集します。
<target> を追加します。
<!-- タグライブラリターゲットの例
<target name="log">
<ant dir="./log" target="dist"/>
</target>
-->
<!-- ctlx ターゲットの例
<target name="ultradev4">
<ant dir="./tools/UltraDev/4.0/ctlx" target="dist"/>
</target>
-->
{taglib-name}を<target>のファイルの末尾の方にある、 depends 属性に"dist"という名前で追加します。
メインの jakarta-taglibs ディレクトリで
メインの jakarta-taglibs ディレクトリ中で、
jakarta サイトに公開されるタグライブラリや ctlx のweb ページは
すべてのものが正しくビルドされたことを確認したら、jakarta-taglibs CVS リポジトリにそれらの変更をすべてコミットしてください。
この時点ではまだそのタグライブラリの状態は「開発中」のままです。
次に述べるナイトリービルドで、そのタグライブラリは http://jakarta.apache.org
にあるタグライブラリについてのjakarta-taglibsの情報に加えられます。
毎晩 http://jakarta.apache.org では次の更新をするスクリプトが動きます。
|
| マイルストーン版のリリース |
|
マイルストーンリリースを行う時には HOWTO-RELEASE ファイルを見てください。
タグライブラリのデザインがすべてインプレメントされたなら、このステップは飛ばして、ベータ版のリリースにいってください。
taglibs-dev メーリングリストにマイルストーン版を公開したいと伝えてください。jakarta-taglib 委員に承認されてはじめてマイルストーン版のリリースができます。
Taglibのメジャー、マイナー、マイルストーンリリース番号を決めてください。マイルストーン版のバージョンは１から始まり、順次番号があがって行きます。
リリース名(
そのリリースのファイル名は、
jakarta ウェブサイト
jakarta ウェブサイトのドキュメント
xml/{taglib-name}.xml の <revision> セクションを更新して、新しいタグライブラリのchanges.htmlが最新のものになるようにします。
{taglib-name}とjakarta-taglibsの変更を CVS にコミットすることを忘れないで下さい。
CVS に {taglib-name} ソースのブランチを作る。
taglibs-dev メーリングリストへメールを投稿して、Jakarta-Taglibs
プロジェクトリリースマネージャにタグライブラリやCTLXのマイルストーンリリースをお願いしてください。
タグライブラリのリリース分のドキュメントは下記の場所に入ります。
http://jakarta.apache.org/taglibs/doc/{taglib-name}-doc/{release-name}/
タグライブラリのリリース分は下記の場所からダウンロード可能です。
http://jakarta.apache.org/builds/jakarta-taglibs/releases/{taglib-name}/
|
| ベータ版のリリース |
|
ベータ版をリリースする際には HOWTO-RELEASE ファイルを参照して下さい。
taglibs-dev メーリングリストにベータ版がリリースされることを伝えてください。
jakarta-taglib 委員が承認したらベータリリースを行うことができます。
メージャ、マイナー番号、バグ修正、ベータリリース番号を決めてください。
ベータ版のバージョン番号は１から始まり順次リリースにしたがって増加します。
リリース名
この場合ファイル名は、
xml/{taglib-name}.xml の <revision> セクションを変更し、新しいタグライブラリの changes.html
が最新のものになるようにします。
{taglib-name}とjakarta-taglibsの変更を CVS にコミットすることを忘れないで下さい。
次のようにして{taglib-name} ソースのブランチを CVS に作成します。
taglibs-dev メーリングリストにメールを投稿し、Jakarta-Taglibs プロジェクトのリリースマネージャにタグライブラリまたはCTLXのベータ版のリリースをしたいことを伝えてください。
タグライブラリのリリースドキュメントはhttp://jakarta.apache.org/taglibs/doc/{taglib-name}-doc/{release-name}に置かれます。
タグライブラリのリリースはhttp://jakarta.apache.org/builds/jakarta-taglibs/releases/{taglib-name}/
からダウンロードできます。
|
| 正式版のリリース |
|
正式版をリリースする場合も HOWTO-RELEASE ファイルを参照して下さい。
taglibs-dev メーリングリストに正式版をリリースすることを伝えてください。
jakarata-taglib 委員に承認されたらリリースをすることができます。
そのタグライブラリのメジャー、マイナー、バグフィックスの番号を決めてください。
リリース名
正式版のファイル名は
xml/{taglib-name}.xml の<revision>セクションを changes.html ファイルが最新に保たれるように変更します。
必ず すべての{taglib-name} と jakarta-taglibs の変更を CVS にコミットしてください。
{taglib-name} ソースのブランチを CVS の中に作成します。
taglibs-dev メーリングリストの Jakarta-Taglibs プロジェクトのリリースマネージャにタグライブラリやCTLXの正式版をリリースしたい旨を伝えてください。
タグライブラリの正式版のドキュメントは
http://jakarta.apache.org/taglibs/doc/{taglib-name}-doc/{release-name}/
にあります。
タグライブラリの正式版は以下の場所からダウンロード可能です。
http://jakarta.apache.org/builds/jakarta-taglibs/releases/{taglib-name}/
|
| リリースマネージャの役目 |
|
前提条件：
リリースの構築
その出来上がったリリースを http://jakarta.apache.org/ に公開します。
|