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

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

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


デフォルトの Domino タグの属性
次の表に、Domino JSP タグの属性のデフォルト値として設定できる変数を示します。これらの変数は、次の属性のいずれかを作成します。
属性が明示的に指定される場合は、その値はこれらのデフォルトの変数値に優先します。


属性
変数名
説明
スーパークラス

bundle
msgbundle
国際化されたメッセージを見つけ出すために使用するメッセージバンドルの名前。デフォルトは次のとおりです。

messages



host
host
ローカルの NOI (Notes Object Interface) の呼び出しを使用する代わりに、タグが通信する CORBA (Common Object Request Broker Architecture) サーバーの名前。セッションタグが使用されていない場合は、すべてのタグはこの属性の有無を調べ、NOI セッションを初期化します。すべての「ローカル」データベースは、CORBA サーバーに対してローカルと考えられます。ローカルの NOI (Notes Object Interface) の呼び出しを使用する代わりに、タグが通信する CORBA (Common Object Request Broker Architecture) サーバーの名前。セッションタグが使用されていない場合は、すべてのタグはこの属性の有無を調べ、NOI セッションを初期化します。すべての「ローカル」データベースは、CORBA サーバーに対してローカルと考えられます。
db、form、ftsearch、session、view

dbname
dbname
アクセスされるデータベースの名前。
db、form、ftsearch、view

dbserver
dbserver
アクセスされるデータベースを保存するリモート Domino server の名前。この属性が使用されることは稀です。アプリケーションのデータの内容が、アプリケーションの設計データが保存されているデータベースと別のデータベースに保存されている場合に指定する必要があります。デフォルトは次のとおりです。

Local


db、form、ftsearch、view

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

<languageCode>_<countryCode>

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



onfailure
onfailure
失敗した場合の処理方法を示します。inline か exception のいずれかを指定します。
すべてのタグ

password
password
指定されるユーザー ID に関連付けられるパスワード。

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


db、form、ftsearch、session、view

responseto
responseto
応答文書が応答する親文書の Domino ユニーク ID。
form

timezone
timezone
日付をフォーマットおよび解析する際に使用するタイムゾーン。デフォルトはサーバーのタイムゾーンです (ブラウザではありません)。
すべてのタグ

unid
unid
コンテキスト文書の Domino ユニーク ID。
form

user
user
セッションにログインするためのユーザー ID。デフォルトは Anonymous です。
db、form、ftsearch、session、view

viewname
viewname
表示するビュー、またはフォームや検索条件のためのビューのコンテキストとして使用されるビューの名前。
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>

上記表に従って検索しても属性値が見つからない場合は、例外がスローされます。

関連項目