|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjavax.servlet.jsp.tagext.TagSupport
jp.terasoluna.fw.web.taglib.DateFormatterTagBase
public abstract class DateFormatterTagBase
日付時刻をフォーマットして出力、あるいはスクリプティング変数として 定義するカスタムタグための抽象基底クラス。
日付時刻のフォーマットを行うカスタムタグのクラスはこの基底クラスを 継承して作成する。
フォーマット対象となる日付時刻データとしては、java.util.Date
型、あるいは java.lang.String
型をサポートする。ただし、
java.lang.String
型のデータをフォーマットする際には、
その文字列が "yyyy/MM/dd hh:mm:ss"
の形式となっている必要がある。
DateFormatterTagBase
クラスを継承したサブクラスでは、
実際に文字列のフォーマットを行う抽象メソッド
doFormat(Date date)
を実装する。
DateFormatterTagBase
では、以下の属性をサポートする。
属性名 | デフォルト値 | 必須性 | 実行時式 | 概要 |
id |
- | false |
false |
フォーマットされた文字列をレスポンスへ出力せずに、
スクリプティング変数にセットする際に指定する。
フォーマットされた文字列をスクリプティング変数にセットする場合には、
filter 属性の指定に関わらずHTML
特殊文字はエスケープされない。
|
filter |
true |
false |
true |
フォーマットされた文字列を出力する際に、HTML特殊文字を
エスケープするかどうかを指定する。ただし、id 属性が
指定されていた場合には、無視される。
|
ignore |
false |
false |
true |
name 属性で指定した beanが
見つからなかったときに無視するかどうかを指定する。false
を指定すると、beanが見つからなかったときに JspException
が投げられる。
|
name |
- | false |
true |
フォーマット対象の文字列をプロパティに持つ
beanの名前。property 属性が指定されて
いなかったときには、name 属性で指定されたインスタンスが
がフォーマットの対象となる。この場合は、
そのインスタンス自身が java.util.Date 型であるか、あるいは
java.lang.String 型(かつ"yyyy/MM/dd hh:mm:ss"
の形式となっているもの)のどちらかである必要がある。value
属性が指定されていた場合には、無視される。
|
property |
- | false |
true |
name 属性で指定された bean
においてアクセスされるプロパティの名前。value 属性が
指定されていた場合には無視される。
|
scope |
false |
true |
(findAttribute() メソッドの検索順序) |
name 属性で指定された bean
を検索する際のスコープ。
|
value |
- | false |
true |
フォーマットする文字列。文字列は、
"yyyy/MM/dd hh:mm:ss"の形式となっている必要がある。
value 属性を指定した場合には、name
属性、および property
属性は無視される。
|
pattern |
- | true |
true |
フォーマットする出力形式。pattern
属性で指定した出力形式は、DateFormatterTagBase
クラスのサブクラスで解釈される。詳細は、サブクラスのドキュメントを
参照のこと。
|
DateFormatterTagBase
では以下の変数をサポートする。
変数名 | 型 | 有効範囲 | 記述 |
カスタムタグの id 属性で指定された名前 |
String |
開始タグ以降 | このカスタムタグで出力せず、スクリプティング変数へ 設定する場合の変数名。 |
DateTag
,
JDateTag
,
直列化された形式フィールドの概要 | |
---|---|
private static java.lang.String |
DATE_FORMAT
日付時刻のフォーマット。 |
protected boolean |
filter
出力中のHTML特殊文字をフィルターするかどうか。 |
protected java.lang.String |
id
そのページ内で利用できるようにするためのスクリプティング変数の名前。 |
protected boolean |
ignore
beanが見つからなかったときに、単に無視する(何も出力しない)かどうか。 |
private static Log |
log
ログクラス。 |
protected java.lang.String |
name
フォーマット対象のデータを含むbeanの名前。 |
protected java.lang.String |
pattern
出力のフォーマットを指定するパターン。 |
protected java.lang.String |
property
指定されたbeanにおいてアクセスされるプロパティの名前。 |
protected java.lang.String |
scope
指定されたbeanを検索するスコープ。 |
protected java.lang.String |
value
フォーマット対象の値(文字列)。 |
クラス javax.servlet.jsp.tagext.TagSupport から継承されたフィールド |
---|
pageContext |
インタフェース javax.servlet.jsp.tagext.IterationTag から継承されたフィールド |
---|
EVAL_BODY_AGAIN |
インタフェース javax.servlet.jsp.tagext.Tag から継承されたフィールド |
---|
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE |
コンストラクタの概要 | |
---|---|
DateFormatterTagBase()
|
メソッドの概要 | |
---|---|
protected abstract java.lang.String |
doFormat(java.util.Date date)
日付時刻のフォーマットを行う抽象メソッド。 |
int |
doStartTag()
タグ評価開始時に呼ばれるメソッド。 |
void |
release()
すべてのアロケートされた資源を解放する。 |
void |
setFilter(boolean filter)
出力中のHTML特殊文字をフィルターするかどうかを設定する。 |
void |
setId(java.lang.String id)
スクリプティング変数の名前を設定する。 |
void |
setIgnore(boolean ignore)
beanが見つからなかった場合に無視するかどうかを設定する。 |
void |
setName(java.lang.String name)
フォーマット対象のデータを含むbeanの名前を設定する。 |
void |
setPattern(java.lang.String pattern)
出力のフォーマットを指定するパターンを設定する。 |
void |
setProperty(java.lang.String property)
指定されたbeanにおいてアクセスされるプロパティ名を設定する。 |
void |
setScope(java.lang.String scope)
指定されたbeanを検索するスコープを設定する。 |
void |
setValue(java.lang.String value)
フォーマット対象の値を設定する。 |
クラス javax.servlet.jsp.tagext.TagSupport から継承されたメソッド |
---|
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setPageContext, setParent, setValue |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
---|
private static Log log
private static final java.lang.String DATE_FORMAT
protected java.lang.String id
protected boolean filter
true
。
protected boolean ignore
false
(例外を投げる)。
protected java.lang.String name
protected java.lang.String property
protected java.lang.String scope
protected java.lang.String pattern
SimpleDateFormat
と同じ書式で指定する。
protected java.lang.String value
コンストラクタの詳細 |
---|
public DateFormatterTagBase()
メソッドの詳細 |
---|
public void setId(java.lang.String id)
javax.servlet.jsp.tagext.TagSupport
内の setId
id
- スクリプティング変数名public void setFilter(boolean filter)
filter
- 出力中のHTML特殊文字をフィルターする場合は
true
public void setIgnore(boolean ignore)
ignore
- 無視する場合は true
public void setName(java.lang.String name)
name
- beanの名前public void setProperty(java.lang.String property)
property
- プロパティ名public void setScope(java.lang.String scope)
scope
- スコープpublic void setPattern(java.lang.String pattern)
pattern
- パターンpublic void setValue(java.lang.String value)
value
- フォーマット対象の値public int doStartTag() throws javax.servlet.jsp.JspException
javax.servlet.jsp.tagext.Tag
内の doStartTag
javax.servlet.jsp.tagext.TagSupport
内の doStartTag
SKIP_BODY
javax.servlet.jsp.JspException
- JSP例外public void release()
javax.servlet.jsp.tagext.Tag
内の release
javax.servlet.jsp.tagext.TagSupport
内の release
protected abstract java.lang.String doFormat(java.util.Date date)
date
- 日付時刻
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |