本文へジャンプ

Lotus  >  Lotus Developer Domain  >  
　 　
　

Lotus Domino と IBM WebSphere の統合ソリューション: Domino JSP タグライブラリー
　
　
コンテンツ
はじめに
始める前に
J2EE アプリケーション環境の設定
domtags を使用する
ビューの検索
フォーム
まとめ
リソース
ダウンロード
筆者について(原文のまま)
L Jeffrey Lo
Advisory Software Engineer, IBM Corporation
レベル：中級
原文の掲載： 2005年3月8日
更 新 日：2005年7月22日更新
原文はこちら


はじめに

Lotus Domino でデータを管理し、Domino XML または Domino JSP タグライブラリーを使用して、IBM WebSphere のスケーラブルでトランザクショナルな J2EE プラットフォームを活用しましょう。このシリーズのパート 2 では、Domino JSP タグライブラリーを取り上げます。
この 2 部構成のパート 1 では、Domino XML (DXL とも呼ばれます) を使用して Lotus Domino と IBM WebSphere を統合する方法について解説しました。DXL を使用すると、Lotus Domino を詳しく理解していなくても Domino オブジェクトにアクセスできます。しかし、DXL を使用する方法では、ある程度の Java の経験が必要です。Java の経験がほとんどない Notes アプリケーション開発者のために、Lotus Domino Toolkit for WebSphere Studio(現在リンク切れ)に Domino JSP タグライブラリが含まれています (ツールキットは Lotus Notes/Domino 6.0.2 以降で使用できます。パスポート・アドバンテージを契約されている方もツールキットをダウンロードできます)。

Lotus は、Lotus Domino 6 から 2 つの JSP タグライブラリを搭載しています。これらのライブラリによって、ほとんどすべての J2EE 準拠アプリケーション・サーバー上で Lotus Domino とインタラクトできる J2EE アプリケーションを開発する機能が得られます。タグライブラリが提供される前は、JSP 開発者はアプリケーションを Lotus Domino へ接続するために、CORBA および IIOP 呼び出しをアプリケーション内に構築する必要がありました。この結果、複雑でほとんど再利用ができないデータベース固有のコードが生成されます。相互運用の要求が高まるにつれ、より洗練された強力なソリューションが必要とされています。

Lotus はこのような要求を認識し、Lotus Domino と J2EE の一般的な機能を抽象化およびカプセル化する 2 つのタグライブラリを作成することで対応しました。これらのライブラリは、タグライブラリ記述子である domtag.tld と domutils.tld によって定義されています。Domutils.tld には、すべての J2EE アプリケーションに共通するタスクを扱うユーティリティー・タグが記述されています。これらのタグは Lotus Domino 固有のものではなく、Domino Server に依存しない任意のアプリケーションで使用できます。domtag.tld で記述されているタグは、Lotus Domino 固有のタグです。これらのタグによって、設計、アクセス制御リスト、文書を含むほとんどすべての Domino 要素にプログラムからアクセスできます。この記事では、Domino 固有のタグ (domtag.tld で定義されているタグ) を中心に解説します。これ以降は、このタグライブラリを単に taglib と呼ぶことにします。

上に戻る



始める前に


taglib を使用する方法は、前の記事で説明した XML の方法よりも、Lotus Domino に関してより深い知識を必要とします。この方法では、Domino フレームワークに関係のある用語やコントロールが使用されます。taglib を効果的に使用するには、Lotus Domino、さまざまな設計要素、およびアクセスするデータの構造を十分に理解していることが重要です。どちらの方法が自分の環境やアプリケーションに適しているかを知るには、パート 1 の「ロードマップ」のセクションを参照してください。

要件
taglib は JSP 1.1 および Servlet 2.2 の仕様に適合し、J2EE に準拠するほとんどのアプリケーション・サーバーをサポートします。この記事に掲載するサンプルは、IBM WebSphere Application Server 5.1 にインストールされ、WebSphere Studio Application Developer で開発されました。この記事は、Domino のオブジェクトと用語、および WebSphere Studio Application Developer を使用した基本的な J2EE プログラミングに慣れているものとして書かれています。

メモ: IIOP を扱うための Lotus Domino での準備を除き、taglib を使用するために、CORBA または IIOP のプログラミング知識はまったく必要ありません。

ソフトウェアの要件は次のとおりです。
  • WebSphere Application Server 5.x または他の J2EE 準拠のアプリケーション・サーバー
  • DIIOP サービスがインストールされて有効になっている Lotus Domino 6.x

Lotus Domino の準備
taglib は CORBA (Command Object Request Broker Architecture) および IIOP (Internet Inter-ORB Protocol) テクノロジーを使用して、Lotus Domino と通信します。このため、IIOP 要求を listen するよう Domino Server を設定する必要があります。まず、DIIOP がインストールされていることを確認します。Domino コンソールで show task コマンドまたは load diiop コマンドを発行すると、DIIOP が存在するかどうかを判断できます。インストールされていない場合は、Domino インストール CD からインストールしてください。

次に、Lotus Domino の起動時に DIIOP が自動的にロードされるよう Domino Server の Notes.ini ファイルを編集します。ServerTasks で始まる行を見つけます。この行の最後に、diiop を追加します。Domino Server を再起動し、DIIOP サーバーの起動メッセージをチェックします。

図 1. サーバーの起動時に開始された DIIOP プロセス
画面イメージ

DIIOP プロセスの開始時に、diiop_ior.txt という IOR (Internet Object Reference) が Domino HTTP ルート・ディレクトリー (Windows にインストールされた Domino のデフォルトでは C:\lotus\domino\data\domino\html) に作成されます。Lotus Domino を HTTP サーバーとして使用する場合は、次の手順を省略できます。

Lotus Domino を HTTP サーバーとして使用しない場合は、HTTP サーバーのルート HTML ディレクトリーにファイルを置くよう DIIOP を設定する必要があります。
  1. Domino Server のサーバー文書を開きます。
  2. [インターネット] タブ - [DIIOP] サブタブを選択します。
  3. [外部 HTML ディレクトリ] フィールドに、Domino 以外の HTTP サーバーのルート HTML ディレクトリーへのフルパスを入力します。
  4. サーバー文書を保存し、DIIOP を再起動します。

図 2. サーバー文書の [DIIOP] セクション
画面イメージ

Web ブラウザーから「http://127.0.0.1/diiop_ior.txt」と入力して、ファイルにアクセスできるかどうかテストします。

図 3. Web に表示された diiop_ior.txt ファイル
画面イメージ

上に戻る


J2EE アプリケーション環境の設定


taglib を使用するには、NCSO.jar または Notes.jar (後出の囲み記事を参照) と domtag.jar の 2 つの JAR ファイルが必要です。

  1. Windows Explorer で [Notes のインストールパス]\Data\domino\java を開きます。domtags.jar と NCSO.jar を見つけ、Web アプリケーションの WEB-INF/lib ディレクトリーにコピーします。

    メモ: 複数の Web アプリケーションが taglib を使用する場合は、これらのファイルをアプリケーション・サーバーの共有ライブラリ・ディレクトリーにコピーしてください。

図 4. WebSphere Studio Application Developer の J2EE パースペクティブ
画面イメージ

  1. [Notes のインストールパス]\Data\domino\java で domtags.tld を見つけ、プロジェクトの WEB-INF ディレクトリーにコピーします。このファイルがタグライブラリ記述子 (つまり、TLD 拡張) です。これには、基本の Java コードに関連するタグが記述されているため、アプリケーション・サーバーがタグを理解できます。
  2. 次に、Web アプリケーションの web.xml を開きます。次の taglib 参照を追加し、変更を保存します。


<taglib id="domtags">
     <taglib-uri>domtags.tld</taglib-uri>
     <taglib-location>/WEB-INF/domtags.tld</taglib-location>
</taglib>

web.xml の例を示します。


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app id="WebApp">
     <display-name>ArticleWeb</display-name>
     <welcome-file-list>
          <welcome-file>index.html</welcome-file>
          <welcome-file>index.htm</welcome-file>
          <welcome-file>index.jsp</welcome-file>
          <welcome-file>default.html</welcome-file>
          <welcome-file>default.htm</welcome-file>
          <welcome-file>default.jsp</welcome-file>
     </welcome-file-list>
     <taglib id="domtags">
          <taglib-uri>domtags.tld</taglib-uri>
          <taglib-location>/WEB-INF/domtags.tld</taglib-location>
     </taglib>
</web-app>

Domino オブジェクトにプログラムからアクセスするために、Domino には 2 つの JAR ファイルが含まれています。Notes.jar と NCSO.jar です。Notes.jar は、Domino Server にローカルにアクセスするときに使用します (Lotus Domino と Java プログラムが同じマシンにある場合です)。NCSO.jar には、リモート・サーバーにアクセスする CORBA/IIOP コードが追加されています。

どちらの JAR を使用するか決めるときは、次の点を考慮してください。

Lotus Domino に対して、Java プログラムをどこで実行しますか? 同じマシンで実行する場合は、Notes.jar の方がパフォーマンスが向上します。
スケーラビリティは重要ですか? 現在、Java プログラム (スタンドアロン Java アプリケーションで J2EE 非対応) と Lotus Domino を同じマシンで実行している場合でも、将来的には、専用のサーバーへと拡張する必要があるかもしれません。このような場合は、NCSO.jar を使用した方が適応性が高まります。
Java プログラムをアプリケーション・サーバーで実行するつもりですか? WebSphere を使用するときは、Lotus Domino が同じマシン上にある場合でも NCSO.jar が必要です。

デフォルト・パラメータの設定
taglib には、web.xml ファイルで設定できる多くのコンテキスト・パラメータがあります。ポータビリティを高め、将来のメンテナンスの手間を省くために、アプリケーション全体に関わるこれらのパラメータをできる限り使用することを推奨します。

この例では、ホスト (127.0.0.1) とデータベース (articleSample.nsf) をコンテキスト・パラメータとして設定します。これらは、順に lotus.domino.default.host と lotus.domino.default.dbname です。

この設定を行なうために、web.xml を開き、次の行を追加して保存します。


<context-param id="dominohost">
     <param-name>lotus.domino.default.host</param-name>
     <param-value>127.0.0.1</param-value>
</context-param>
<context-param id="dominodbname">
     <param-name>lotus.domino.default.dbname</param-name>
     <param-value>articlesample.nsf</param-value>
</context-param>


上に戻る


domtags を使用する

次のセクションでは、前の記事でも使用した Car データベースを使用します。ここでは、次のことを行なう 4 つの JSP を作成します。
  • 文書を表示する
  • Domino ビューの内容を表示する
  • Domino ビューを検索できるようにする
  • ユーザーに文書の作成と編集を許可する

始める前に、taglib を使用するすべての JSP にこの taglib 宣言を含める必要があります。この宣言は、アプリケーション・サーバーに対し、domino という単語で始まるどのタグ (たとえば、<domino:db>) も、domtags タグライブラリ記述子内のエントリーへの参照であることを示します (他の接頭辞を使用することも可能ですが、できるだけ domino を使用してください)。

<%@ taglib uri="domtags.tld" prefix="domino" %>

文書を表示する
まず、Notes 文書の内容を表示するシンプルな JSP から始めましょう。これは、unid と呼ばれる 1 つの querystring パラメータを受け取ります。このパラメータの値は、要求された文書の文書固有 ID です。JSP エディターで、disptagcar.jsp という名前の新しい JSP を作成します。先ほど説明した taglib 宣言の入力から始めます。lotus.domino.* というインポート行を含めると、Domino オブジェクトに直接アクセスできます。これについては後述します。


<%@ taglib uri="domtags.tld" prefix="domino" %>
<%@page import="lotus.domino.*"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<%@ page 
language="java"
contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"
%>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Vehicle information using Domino Tag Library</title>
</head>
<body>
<h1>Vehicle information using Domino Tag Library for <%= (String) request.getParameter("unid")%></h1>
<domino:document>
<table border="1" width="100%" cellspacing="0" cellpadding="0">
     <tr bgcolor="#ccff00">
          <th>Make</th>
          <th>Model</th>
          <th>Body Type</th>
          <th>Engine</th>
          <th>Year</th>
          <th>Specifications</th>
     </tr>
     <tr>
          <td>
                <domino:item name="make"/>
          </td>
          <td>
               <domino:item name="model"/>
          </td>
          <td>
               <domino:item name="bodytype"/>
          </td>
          <td>
               <domino:item name="enginetype"/>
          </td>
          <td>
               <domino:item name="year"/>
          </td>
          <td>
               <domino:item name="specifications" format="<LI>"/>
          </td>
     </tr>
</table>
</domino:document>
</body>
</html>

<domino:document> タグは、Notes 文書のコンテキストを提供します。このコンテキスト内で、特定の文書のほとんどすべてのアイテムとプロパティにコードからアクセスできます。場合によっては、document タグの dbserver、dbname、および unid の各属性に値を渡すケースもあります。しかし、この例ではそれを行ないませんでした。その理由は、必要な情報がすでに別の場所で指定されているからです。サーバーのホスト名とデータベースのファイル名は、Web デプロイメント記述子 (web.xml) によってすでに定義されています。UNID は、querystring パラメータの unid で明示的に指定されています。

何らかの理由で URL 内に UNID を表示したくない場合は、別の方法で document タグの unid 属性に UNID を明示的に指定しなければなりません。

<%
String unid = [[code that obtains the document unid]];
%>

<domino:document unid=?<%= unid %>?>

<domino:item> タグは、name 属性で指定されたアイテムの内容を表示します。たとえば、<domino:item name="make"/> は make アイテムに格納されている値を表示します。specifications フィールドを参照している最後の item タグには format 属性があります。この属性は、値を JSP でどのように表示するのかをタグライブラリに伝えます。この属性に与える値をキーワードと呼びます。format 属性では複数のキーワードを使用できます。

specifications フィールドは複数値フィールドであることを思い出してください。したがって、このフィールドには複数の値を格納できます。<li> キーワードは、specifications 内の各値を <li> タグと </li> タグで囲むことを <domino:item> タグに伝えます。

ビューの内容を表示する
Domino ビューは、<domino:view> タグを介してアクセスできます。たとえば、自動車のサンプルでは、vin と make の 2 つの列を持つシンプルな [Cars\By VIN] ビューがあります。このビューは vins という別名を持っています。view タグではこの別名を参照します。

図 5. Notes Client での VINs ビューの表示
画面イメージ

VINs ビューを HTML として表示する JSP のコードは次のとおりです。


<%@ taglib uri="domtags.tld" prefix="domino" %>
<%@page import="lotus.domino.*"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<%@ page 
language="java"
contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"
%>
<%
String count = "30";
if(request.getParameter("count")!=null);
count = (String)request.getParameter("count");
%>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Car List using Domino Tag Library</title>
</head>
<body>
<h1>Car List using Domino Tag Library</h1>
<domino:db>
   <table border="1">
     <tr bgcolor="#ffcccc">
          <th>
             VIN
          </th>
          <th>
            Make
          </th>
          <th>
            Model
          </th>
     </tr>
     <domino:view viewname="vins" max="<%= count %>">
            <domino:viewloop>
               <tr>
                    <td>
                         <domino:formlink href="disptagcar.jsp" >
                         <domino:viewitem name="vin" />
                         </domino:formlink>
                    </td> 
                    <td>
                          <domino:viewitem name="make" />
                    </td>
                    <td>
                         <domino:item name="model" /> 
                    </td> 
              </tr>
            </domino:viewloop>
     </domino:view>
   </table>
</domino:db>
</body>
</html>

図 6. VINs ビューの内容を表示する JSP
画面イメージ

「ビュー」JSP を調べる
上記の JSP を調べましょう。次のセクションで、この JSP を使用して検索ページを作成します。

  • Database
    <domino:db> タグは、データベースのコンテキストをアプリケーションに与えます。web.xml でデフォルトのデータベースを定義済みなので、ここでそれを定義する必要はありません。web.xml でデフォルト・データベースが定義されていない場合、または web.xml で定義されているデータベース以外のデータベースにアクセスする場合は、dbname 属性を定義することによって、データベースの情報をここで与える必要があります。データベースが別のサーバーにあるときは、dbserver も指定してください。
  • View
    <domino:db> タグのコンテキスト内に <domino:view> タグを記述することにより、このデータベース内の指定されたビューにアクセスできます。ビューの名前を viewname 属性の値として指定する必要があります。ビューの別名を使用できます。max 属性は、1 ページに表示するエントリー数を制御します。
  • Viewloop
    このタグは、ループを用いてビュー内の各エントリーに順番にアクセスします。このタグによって、ビューのコンテンツにアクセスできます。たとえば、後述の viewitem タグを使用すると、ビューの内容をそのまま印刷できます。
  • Formlink
    <domino:formlink> タグは、指定された JSP への <a href> リンクを動的に作成します。結果のページには、文書の内容を表示できるタグライブラリのコードが含まれています。このサンプルでは、前のセクションで作成した JSP (disptagcar.jsp) を使用しています。
  • Viewitem
    <domino:viewitem> タグは、ビュー・エントリーへの直接のアクセスを提供します。name 属性はビュー内の列名を参照します。name の値は大文字と小文字が区別され、列名と正確に一致しなければなりません。
    <domino:viewitem name="vin" />
    <domino:viewitem name="make" />
  • Item
    <domino:item> タグは、文書内のフィールドへのアクセスを提供します。name 属性は、どのフィールドを取得するのかを指定します。


<domino:item> と <domino:viewitem> の違いは次のとおりです。<domino:item> は値を取得する文書を開く必要があるのに対し、<domino:viewitem> はビューに表示される任意の値を使用できます。パフォーマンスが大幅に低下する可能性があるので、viewloop のコンテキストでは、できるだけ item タグを使用しないでください。

上に戻る



ビューの検索

このセクションでは、検索機能をサポートするために、作成した「ビュー」JSP を変更する方法を説明します。

全文検索を正しく機能させるには、Domino データベースで全文索引をオンにする必要があります。データベースに全文索引が作成されているかどうかを確認するには、[データベース] プロパティボックスを開き、[全文検索] タブをクリックします。データベースの全文索引が作成されていない場合は、[索引の作成] ボタンをクリックします。要求がキューに登録されると、Notes Client のステータスバーにそれを示すメッセージが表示されます。通常、全文索引はすぐに作成されます。

図 7. [データベース] プロパティボックスの [全文検索] タブ
画面イメージ

検索をカスタマイズできるようにするため、検索フォームには、クエリー、検索結果の最大数、および結果の各ページに表示するエントリー数を入力する 3 つのフィールドを含めます。「検索」JSP のベースとして、前のセクションで作成した「ビュー」JSP を使用します。

検索を処理する JSP コードの一部を以下に示します。


<domino:view viewname="vins" ftsearch='<%= query %>' max='<%= max %>'>
     <domino:page rows='<%= count %>'>
          <tr><td colspan="3" align="right">Go to page: 
          <domino:pagebar navstyle="NextPrev" />&nbsp;&nbsp;&nbsp;
          <domino:pagenext>Next></domino:pagenext></td></tr>
          <domino:viewloop>
            <tr>
               <td>
                <domino:formlink href="disptagcar.jsp" >
                <domino:viewitem name="vin" />
                </domino:formlink>
               </td> 
                  <td>
                    <domino:viewitem name="make" />
                  </td>
                  <td>
                 <domino:item name="model" /> 
                  </td>
            </tr>
           </domino:viewloop>
         <domino:novalues>
          <tr>
          <td>
            The search for <%= query %> found no matches. Use another keyword and try again.
          </td>
          </tr>
         </domino:novalues>
         <tr><td colspan="3" align="right">Go to page: 
         <domino:pagebar navstyle="NextPrev" />&nbsp;&nbsp;&nbsp;
         <domino:pagenext>Next></domino:pagenext></td></tr>
     </domino:page>
</domino:view>

「ビューの検索」JSP を調べる
「ビューの検索」JSP を詳しく見ていきましょう。

  • View
    ビューの検索を作成するために、ftsearch と max の 2 つの属性を <domino:view> に追加します。ftsearch はクエリー文字列で、max は返される結果の最大数です。
  • Page
    このタグは、ビューの内容と検索結果を表示するために、ページを制御できるようにします。rows 属性は 1 ページに表示するエントリー数を制限します。このタグは、ナビゲーション機能のタグ用のコンテキストを提供します。
  • Pagebar
    page タグのコンテキスト内で、<domino:pagebar> は検索結果が表示されるページへのリンクを自動的に生成します。現在のページへのリンクは太字で示され、クリックできません。
  • Pagenext
    このタグは、次のページへのリンクを自動的に作成します。このタグの本文は、リンクのテキストラベルです。このサンプルでは、「Next >」というラベルを使用します。このタグを pagebar と共に使用することにより、図 8. に示すようなページ・ナビゲーションを作成できます。

    図 8. ナビゲーション・バー
    画面イメージ

  • Novalues
    このタグの本文は、検索結果が見つからなかったときに表示するテキストです。このサンプルでは、「The search for [query] found no matches. Use another keyword and try again.」というメッセージを使用します。


上に戻る



フォーム


この最後のセクションでは、ユーザーが Notes 文書を作成または変更するときに使用する JSP フォームを作成します。説明を簡単にするために、このサンプル・データベースでは、匿名ユーザーに [作成者] のアクセス権を許可します。セキュリティーが重要な実際のアプリケーションでは、一元化されたユーザー・レジストリー (LDAP など) とシングル・サインオン (SSO) を使用して、より厳密な方法にします。Lotus Domino の認証および権限を扱うために、WebSphere をトラステッド・コンテナーとして設定してください。WebSphere と Lotus Domino の SSO の詳細については、WebSphere Application Server InfoCenter を参照してください。

サンプルのフォームには、次の機能があります。
  • ユーザーが文書を作成できるようにします。ユーザーが新しい文書を作成していることを示すメッセージを表示します。
  • ユーザーが既存の文書を編集できるようにします。ユーザーが既存の文書を編集していることを示すメッセージを表示します。
  • 入力を検証します。検証に失敗した場合は、カスタマイズされたエラーメッセージを表示します。
  • フォームの送信に成功したら、感謝のページにユーザーを移動します。

「フォーム」JSP のすべてのコードについては、付録のファイル「Form JSP code」を参照してください。

form タグ
<domino:form> タグは、指定された文書への編集アクセス権を与えます。このタグでは、詳細な操作を行なうホストをサポートするいくつかの属性を使用できます。このサンプルでは、最も一般的な属性が使用されています。これについて、詳しく見ていきましょう。

  • Name
    これは、フォーム・オブジェクトの名前です。また、この値は HTML フォーム名として使用されます。この値は、各 JSP で固有でなければなりません。
  • Schema
    この値は、この文書の保存に使用する Domino フォームの名前に対応します。Domino フォームの保存前の処理 (QuerySave) が文書に行なわれます。この値を設定すると、文書の form フィールドにその値が暗黙的に設定されます。
  • Editmode
    この属性は、display、edit、および delete の 3 つの値を受け入れます。属性の値をハードコードすることもできますが、コード内の特定のロジックに基づいて値をプログラムで代入する方が実用的でしょう。
  • Validhref
    この値は、フォームの検証と保存の後で、ユーザーを移動する移動先のページを示します。
  • Clientvalidate
    この値を true に設定すると、検証タグに基づいて、フォームでユーザー入力が検証されます。逆に、この値を false に設定すると、フォームですべての検証タグが無視されます。
  • User
    Domino データにアクセスするユーザーの名前を指定します。J2EE コンテナーを使用して認証を行なう場合は、この値を *webuser に設定してください。taglib のセキュリティーの詳細については『Domino Designer ヘルプ』を参照してください。
  • Unid
    JSP の querystring に unid パラメータがある場合、form タグはその unid を使用して文書を開きます。別の方法として、unid 属性で unid を渡すこともできます。
  • 入力タグ
    入力タグは、HTML 入力フィールドを作成します。name 属性は、値を保存するアイテムの名前を指定します。デフォルトでは、データ型はテキストです。別のデータ型が必要な場合は、フォームのスキーマでそのフィールドに一致するデータ型属性を指定します。複数値フィールドの場合は multivalue="true" を設定し、mveditseparator と mvdisplayseparator を使用して値の区切り記号を指定します。このサンプルでは、編集用に値を区切るときはカンマを使用し、表示用に値を区切るときはセミコロンを使用します。
  • 検証タグ
    これらのタグは、フォームが保存される前に、入力の検証を実行します。異なるデータ型の検証を処理するために、Lotus からいくつかの検証タグが提供されています。このサンプルでは、最も一般的なタグの validaterequired と validatepattern を使用しています。1 つのフィールドに複数の検証タグを使用できます。

使用した検証タグは次のとおりです。

  • Validatesummary
    このタグは、検証の失敗を検出する検証タグの message 属性の値を表示します。どの入力が正しくなかったのかをユーザーにわかりやすく示すために、このタグはフォームの一番上に配置します。
  • Validaterequired
    このタグは、name 属性で示すフィールドが null であるかどうかを判断します。null でない場合は、このタグの本文がページに表示されます。このタグは、ユーザーが注意しなければならないフィールドの横に正しく配置します。
  • Validatepattern
    基本的な検証タグで十分でない場合は、このタグを使用して、カスタマイズした検証を作成できます。このタグは、Apache の regexp ライブラリに従って入力値を検証します。期待する値の形式を表す正規表現を作成し、これを pattern 属性に入れます。タグは、この正規表現に基づいてユーザーの入力を比較します。このサンプルでは、validatepattern タグは year フィールドが数値で長さが 4 文字であるかどうかをチェックします。

document タグ
<domino:document> タグは、Notes 文書自身へのアクセスを提供します。id 属性が存在すると、taglib は lotus.domino.Document オブジェクトに id タグ自身の値を名前として割り当てます。このサンプルでは、このオブジェクトは doc です。この方法により、プログラムからオブジェクトのプロパティとメソッドに完全にアクセスでき、taglib の用途が通常の Java コードでのプログラミングへと大きく拡張されます。この強力な機能は、taglib のほとんどのタグに利用できます。Domino Java クラスの詳細については、『Domino Designer ヘルプ』を参照してください。

上に戻る



まとめ

この記事では、Domino 対応の強力な J2EE アプリケーションを構築するために、Domino JSP タグライブラリを使用したプログラミングの方法について解説しました。また、サンプルを通して、よく使用されるタグやその背景にある概念を解説しました。この連続記事に書かれている情報は、既存の Domino 環境に J2EE を導入する際に役立つでしょう。

上に戻る



リソース

  • このシリーズのパート 1 『Lotus Domino と IBM WebSphere の統合ソリューション: Domino XML』をお読みください。
  • 「フォーム」JSP のすべてのコードについては、この付録ファイルを参照してください。
  • Lotus Domino Toolkit for WebSphere Studio の詳細についてはToolkit（現在リンク切れ）のページを参照してください。
  • WebSphere の詳細については、developerWorks WebSphere サイトにアクセスしてください。技術文書、方法を解説した記事、教育、ダウンロード、製品情報などが掲載されています。
  • developerWorks ブログを通して developerWorks コミュニティに参加できます。
上に戻る



ダウンロード

説明 名前 サイズ ダウンロード方法
この記事に関連するコード・サンプル DominoJSPArticle.zip 1.9 MB FTP

ダウンロード方法の説明(US)
上に戻る



筆者について(原文のまま)

Jeffrey Lo is an Advisory Software Engineer for alphaWorks, IBM's resource for emerging technologies. Jeff has been with IBM since 1999, spending his waking hours architecting and building applications around Lotus Domino and IBM WebSphere. His responsibilities include the alphaWorks Web site, its content management system, and a number of backend applications. On the weekends, he likes to go biking in California's Santa Cruz mountains and taking photos of the Pacific Coast.
上に戻る