a) 一般的なタグライブラリの作成

タグライブラリをインストールするには、次の手順を実行する必要があります。

1. タグクラスをjarファイルにバンドルします。taglib{library}.tldファイルが/WEB-INFディレクトリ
2. にあることを確認してください。{library}.jarファイルをCLASSPATH
3. にコピーし、次のものをコピーします{library}.jarファイルを/WEB-INF/libディレクトリ
4. タグライブラリ要素を次のファイルで定義します/WEB-INF/web.xmlfile. 例えば

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

5. JSPページでタグ拡張を定義します。ディレクティブ<taglib-uri>とuriディレクティブは一致する必要があります。プレフィックスは、JSPページ内のタグライブラリ内のタグを識別します。例えば

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

b) Jakarta-Taglibsライブラリの追加

Jakarta-Taglibsにタグライブラリサブプロジェクトを追加するには、次のことを行う必要があります。

1. プロジェクトの最上位ディレクトリを作成します。
2. 既存のサブプロジェクトの1つから次の最上位ファイルをコピーします
   • build.sh
   • build.bat
   • build.xml
3. taglib.nameプロパティを新しいカスタムタグライブラリサブプロジェクト名に変更しますプロパティを新しいカスタムタグライブラリサブプロジェクト名に変更します
4. 既存のサブプロジェクトの1つからディレクトリ構造を複製します
5. 新しいライブラリを含めるように最上位のJakarta-Taglibsbuild.xmlファイルを変更します

c) タグライブラリのデプロイ

プロジェクトのビルドスクリプトを使用しますjakarta-taglibswarファイルを作成するプロジェクト。warファイルを作成したら、そのファイルを$TOMCAT_HOME/webappsディレクトリ。Tomcatはクラスをロードし、新しいコンテキストを作成します。

warファイルには、次の構造が必要です。

  META-INF/
  META-INF/MANIFEST.MF
  WEB-INF/
  WEB-INF/classes/
  WEB-INF/lib/
  WEB-INF/lib/{tagLibrary}.jar
  WEB-INF/web.xml
  WEB-INF/{tagLibrary}.tld

jarファイルを使用しない場合は、すべてのクラスファイルを/WEB-INF/classesディレクトリに配置できます。

warファイルの詳細については、Java Servlet Specification, v2.2を参照してください。

Hello Worldタグハンドラー

Hello Worldタグのタグハンドラーは、次の場所にあります。/WEB-INF/classes/basic基本パッケージの一部であるため、ディレクトリにあります。

  package basic;

JSP およびタグクラスをインポートします。

  import javax.servlet.jsp.*;
  import javax.servlet.jsp.tagext.*;

Hello World タグハンドラーは、以下を実装します。doStartTag開始タグが現れたときに呼び出される()メソッド。

    public int doStartTag() throws JspException {
        try {
            pageContext.getOut().print("Hello World");
        } catch (Exception ex) {
            throw new JspException("IO problems");
        }
        return SKIP_BODY;
    }

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。pageContextは JSP コンテナによって設定され、タグハンドラーで使用できます。SKIP_BODYの値は、タグボディの評価が行われないようにします。

Hello World タグライブラリ記述子

  <?xml version="1.0" encoding="ISO-8859-1" ?>

デプロイメント記述子DOCTYPEを記述するXMLヘッダー。デプロイメント記述子には、Webアプリケーションの要素と構成情報が含まれています。

  <!DOCTYPE taglib
            PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" 
            "http://java.sun.com/j2ee/dtds/web-jsptaglib_1_1.dtd">

最初のタグライブラリの説明

  <taglib>
    <!-- The version number of this tag library -->
    <tlibversion>1.0</tlibversion>

    <!-- The JSP specification version required to function -->
    <jspversion>1.1</jspversion>

    <!-- The short name of this tag library -->
    <shortname>utility</shortname>

    <!-- Public URI that uniquely identifies this version of the tag library -->
    <uri>http://jakarta.apache.org/taglibs/utilitytags</uri>

    <!-- General information about this tag library -->
    <info>
          A simple tag library for the examples
    </info>

Hello World タグの説明。

• tagclass 要素は、Hello World タグハンドラーを Hello World タグに関連付けます
• bodycontenttag は、タグがボディを含まないことを示します

  <!-- Hello tag -->
    <tag>
      <name>Hello</name>
      <tagclass>basic.Hello</tagclass>
      <bodycontent>empty</bodycontent>
      <info>
        Print Hello World
      </info>
    </tag>

web.xml ファイル

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。web.xmlファイルは、taglib 間のマッピングを記述しますuriおよびタグライブラリ記述子の場所。

ここで、ユニークなtaglib-uri "http://jakarta.apache.org/taglibs/utilitytags" は、以下のタグライブラリ記述子に関連付けられています/WEB-INF/tld/utilitytags.tld.

  <web-app>
    <taglib>
       <taglib-uri>
         http://jakarta.apache.org/taglibs/utilitytags
       </taglib-uri>
       <taglib-location>
         /WEB-INF/tld/utilitytags.tld
       </taglib-location>
    </taglib>
  </web-app>

Hello World jsp

次のディレクティブは、JSP コンテナに "を使用するように指示します。http://jakarta.apache.org/taglibs/utilitytags" uriで定義されたweb.xml. "jLib" は、タグのプレフィックス値として定義されています。

  <%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="jLib" %>

Hello World タグが呼び出されます。タグ名 "Hello" は、タグライブラリ記述子で定義されています。

  <jLib:Hello/>

If タグハンドラー

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。BodyTagSupportclass は、インターフェースを実装し、便利な追加メソッドを追加します。これらのメソッドの一部には、次のものがあります。BodyTagインターフェースであり、以下のゲッターメソッドを持っていますbodyContentプロパティ。

  public class IfTag extends BodyTagSupport {

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。doStartTag()開始タグが現れたときに呼び出されるメソッドで、ローカルgetPredicate()メソッドを呼び出します。戻り値が true の場合、タグボディの残りの部分が評価され、それ以外の場合はスキップされます。

  public int doStartTag() {
    if (getPredicate()) return EVAL_BODY_TAG;
    else return SKIP_BODY;
  }

doAfterBody()は、一部のボディが評価された後に呼び出されます。空のタグや

  public int doAfterBody() throws JspException {
    try {
      bodyContent.writeOut(bodyContent.getEnclosingWriter());
      return SKIP_BODY;
    } catch (IOException ex) {
      throw new JspTagException(ex.toString());
    }
  }

If タグライブラリ記述子

  <!-- IF tag -->
    <tag>
      <name>If</name>
      <tagclass>lang.IfTag</tagclass>

If タグには必須の属性が 1 つあります。以下のためrtexprvalueが true に設定されているため、属性の値としてスクリプトレット式を使用できます。値は、リクエスト時に動的に計算できます。

      <attribute>
        <name>predicate</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <info>
        Conditional Tag.
      </info>
    </tag>  

web.xml ファイル

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。web.xmlファイルは、taglib 間のマッピングを記述しますuriおよびタグライブラリ記述子の場所。

ここで、ユニークなtaglib-uri "http://jakarta.apache.org/taglibs/utilitytags" は、以下のタグライブラリ記述子に関連付けられています/WEB-INF/tld/utilitytags.tld.

If JSP

If タグには 1 つの属性が必要です。predicate 属性には、実行時に評価されるスクリプトレットが含まれています。predicate 属性の値に基づいて、jLib:Helloタグが評価されるかスキップされます。

  <jlib:if predicate="<%= x==5 %>">
    <jLib:Hello/>   
  </jlib:if>

1. はじめに

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。utilitytagsカスタムタグライブラリには、いくつかの基本的なタグの例が含まれています。これは、いくつかの簡単なカスタムタグライブラリのコーディングテクニックを示しています。

2. 前提ソフトウェア

このカスタムタグライブラリは、JavaServer Pages 仕様、バージョン 1.1をサポートするサーブレットコンテナ以外のソフトウェアは必要ありません。

3. 構成情報

このタグライブラリを使用して Web アプリケーションを構成するには、次の手順に従います

• タグライブラリ記述子ファイル (utilitytags/utilitytags.tld) を/WEB-INFWeb アプリケーションのサブディレクトリにコピーします。
• タグライブラリ JAR ファイルをコピーします (utilitytags/utilitytags.jar) を/WEB-INF/libWeb アプリケーションのサブディレクトリにコピーします。
• を追加します<taglib>要素を、以下のような Web アプリケーションのデプロイメント記述子に追加します/WEB-INF/web.xml次のようになります。

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

このライブラリのタグを JSP ページで使用するには、各ページの先頭に次のディレクティブを追加します

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

4. タグのドキュメント

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。utilitytagsタグライブラリには、次のタグが含まれています

Hello タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。Helloタグは、「Hello World」というテキストを出力します。属性はありません。

Copy タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。MacroCopyタグは、属性テキストをライターにコピーします。

Paste タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。MacroPasteタグは、ライターで指定されたテキストを貼り付けます。

ShowSource タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。ShowSourceタグは jspFile を受け取り、その内容をライターにコピーします。

Include タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。Includeタグは、指定された URL の出力をインラインで含めます。

If タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。Ifタグは基本的な条件付きタグです。

For タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。Forタグは基本的なループタグです。

useBean タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。useBeanタグは、Java オブジェクトのインスタンスを特定の ID に関連付けます。

Validate タグ

class は、インターフェースを実装し、次のものを含む便利な追加メソッドを追加するユーティリティクラスです。Validateタグは、HTML フォームを検証するための Javascript を生成します。