タグ ライブラリの使用

タグ ライブラリを使用すると、JSP 内でカスタム タグを使用できます。タグ ライブラリを定義するには、JSP 内で taglib ディレクティブを使用します。タグ ライブラリの定義が完了すれば、このライブラリにあるタグにアクセスできるようになります。

JRun では、JRun のホーム ディレクトリ/servers/lib/jruntags.jar ファイルにタグ ライブラリの例が添付されています。JSP ファイルに次のステートメントを挿入して、このタグ ライブラリを JRun サーバー上で実行されている Web アプリケーション内で使用できます。

<%@ taglib uri="jruntags" prefix="tagLibPrefix" %>

ここで、tagLibPrefix は JRun タグ ライブラリで、タグのためにユーザが定義した接頭辞です。

global.properties ファイルには、上記の taglib のディレクティブを使用している jruntags.jar ファイルを参照できるマップが含まれています。すべての JRun サーバー上の Web アプリケーションで、ユーザがカスタマイズしたタグ ライブラリを使用可能にするために、同様のマップを作成できます。あるいは、特定の JRun サーバー上の Web アプリケーションで、そのタグ ライブラリを使用可能にするために、そのサーバーの local.properties ファイルにマップを追加できます。

この例では、デモ用のタグ ライブラリから 2 つのタグを使用しています。forminput です。これらのタグを使用すると、HTML フォームを作成し、クライアントがこのフォームに適切な値を入力したことが検証できます。

この例では、example5.jsp の JSP により、クライアントが First Name フィールドに文字列、Balance フィールドに浮動小数点値を入力したことが確認されます。クライアントが入力した値が適切でなかった場合、これらのタグにはエラー メッセージが表示され、クライアントは値を入力し直すことができます。次の図は、example5.jsp の出力を示します。

example5.jsp ファイルには次のコードが含まれています。

<html>
<head><title>Tag Library Example</title></head>
<body>
<p>
<h1>Validate input balance using a tag library</h1>
<br>

<%-- ライブラリ タグのタグ ライブラリとタグ接頭辞を定義します。--%>
<%@ taglib uri="jruntags" prefix="mylib" %>

<h2>Enter your name and balance</h2>

<%-- 
  タグ mylib:form を使用して、2 種類の入力を持つフォームを定義します。
  各入力について、入力タイプを定義してください。First Name のタイプは
 text です。Balance のタイプは float です。
  クライアントが入力した値が適切でない場合は、
  エラー メッセージが表示されます。入力内容が正しい場合は、
  要求が example5a.jsp に渡されます。
--%>
<mylib:form name="form1" action="example5a.jsp">
First name:<mylib:input name="fName" type="text" required="true" />
Balance:<mylib:input name="bal" type="float" required="true" />
<input type="submit" value="submit">
</mylib:form>

</body>
</html>

送信を実行すると、フォーム データが example5a.jsp ファイルに送信されます。次に、このファイルは request オブジェクトからフォーム情報を取得します。