JSP カスタムタグのライブラリ

デフォルトの JSP の属性の値を設定する
JSP タグは、ページにタグを記述する際に、その属性を指定できます。また、アプリケーション、セッション、要求、またはページの存続中、タグの属性の値が変わらない場合は、その属性値にデフォルトの値を設定しておけば、そのタグを参照するたびに属性値を指定する手間が省けます。

このセクションでは次の事項について説明します。


デフォルトの Lotus Domino タグの属性

次の表に、Lotus Domino JSP タグの属性のデフォルト値として設定できる変数を示します。これらの変数は、次の属性のいずれかを作成します。


属性が明示的に指定される場合は、その値はこれらのデフォルトの変数値に優先します。
属性変数名説明スーパークラス
bundlemsgbundle国際化されたメッセージを見つけ出すために使用するメッセージバンドルの名前。デフォルトは次のとおりです。

messages

hosthostローカルの NOI (Notes Object Interface) の呼び出しを使用する代わりに、タグが通信する CORBA (Common Object Request Broker Architecture) サーバーの名前。セッションタグが使用されていない場合は、すべてのタグはこの属性の有無を調べ、NOI セッションを初期化します。すべての「ローカル」データベースは、CORBA サーバーに対してローカルと考えられます。db、form、ftsearch、session、view
dbnamedbnameアクセスされるデータベースの名前。db、form、ftsearch、view
dbserverdbserverアクセスされるデータベースを保存するリモート Lotus Domino サーバーの名前。この属性が使用されることは稀です。アプリケーションのデータの内容が、アプリケーションの設計データが保存されているデータベースと別のデータベースに保存されている場合に指定する必要があります。デフォルトは次のとおりです。

Local

db、form、ftsearch、view
localelocale国際化されたメッセージを見つけ出したり、出力のためのフォーマットを実行する場合に使用するロケールの名前。次のように記述します。

<languageCode>_<countryCode>

デフォルトでは、locale はコンテナによってブラウザの Acceptlang 文字列から取り出されます。言語および国コードについては、「ロケールコード」を参照してください。

onfailureonfailure失敗した場合の処理方法を示します。inline か exception のいずれかを指定します。すべてのタグ
passwordpassword指定されるユーザー ID に関連付けられるパスワード。

メモ デフォルトのページパラメータを使用してパスワードを指定すると、URL の文字列に表示されてしまいます。コンテナ管理アクセスを使用して、これを防ぐことができます。

db、form、ftsearch、session、view
responsetoresponseto返答文書に対応する親文書の Lotus Domino ユニーク ID。form
timezonetimezone日付をフォーマットおよび解析する際に使用するタイムゾーン。デフォルトはサーバーのタイムゾーンです (ブラウザではありません)。すべてのタグ
unidunidコンテキスト文書の Lotus Domino ユニーク ID。form
useruserセッションにログインするためのユーザー ID。デフォルトは Anonymous です。 db、form、ftsearch、session、view
viewnameviewname表示するビュー、またはフォームや検索条件のためのビューのコンテキストとして使用されるビューの名前。form、view

属性値を設定する

JSP タグは、常に、次に示される属性値を探します。

1. 明示的に指定される属性。


2. サーブレットのコンテキスト*に保存される初期化パラメータの値。次のいずれかの方法で設定します。
3. ページのコンテキスト*に保存される属性値。次のいずれかの方法で設定します。 4. 要求する URL 検索文字列のパラメータ。
5. タグを実装するコード中に定義されたデフォルトの値。
*サーブレットのコンテキストについては http://java.sun.com/products/servlet/download.html にある Servlet 2.2 仕様を、JSP ページのコンテキストについては http://java.sun.com/products/jsp/download.html にある JSP 1.1 仕様を参照してください。

標準の JSP 変数

次の表は、ページで使用可能な標準の JSP 変数です。
データ型変数
HttpServletRequestrequest
HttpServletResponseresponse
PageContextpageContext
HttpSessionsession
ServletContextapplication
ServletConfigconfig
JspWriterout

デフォルト値の検索順番

次の表は、デフォルトのタグ属性値が設定されていない場合に、JSP タグが環境を検索する際に使用する階層を示したものです。
範囲検索メソッド変数名(<varname>)
タグ属性値
ServletContextServletContext.getInitParameter()lotus.domino.preset.<varname>
APPLICATION_SCOPEPageContext.getAttribute()lotus.domino.preset.<varname>
SESSION_SCOPEPageContext.getAttribute()lotus.domino.preset.<varname>
REQUEST_SCOPEPageContext.getAttribute()lotus.domino.preset.<varname>
PAGE_SCOPEPageContext.getAttribute()lotus.domino.preset.<varname>
検索文字列HTTPServletRequest.getParameter()<varname>
PAGE_SCOPEPageContext.getAttribute()lotus.domino.default.<varname>
REQUEST_SCOPEPageContext.getAttribute()lotus.domino.default.<varname>
SESSION_SCOPEPageContext.getAttribute()lotus.domino.default.<varname>
APPLICATION_SCOPEPageContext.getAttribute()lotus.domino.default.<varname>
ServletContextServletContext.getInitParameter()lotus.domino.default.<varname>
上記表に従って検索しても属性値が見つからない場合は、例外がスローされます。

関連項目