public class WriteTag
extends javax.servlet.jsp.tagext.TagSupport
指定した bean プロパティの値を変換しJspWriterとして
表現するwriteタグの実装クラス。
指定したbeanプロパティの値を取り出し、
Stringとして現在の JspWriter に与える。
プロパティ値のクラス用に構成されているPropertyEditor
がある場合、 getAsText() メソッドが呼ばれる。
それ以外の場合は、通常 toString() での変換が適用される。
また、属性により、以下のように付加変換を行う。
" " と置換" " と置換<br> と置換
なお、このタグを使用する場合、改行コードを残すことができない。
改行コードを残す必要がある場合はstrutsが提供している<bean:write>タグを使用すること。
write タグでは、以下の属性をサポートする。| 属性名 | デフォルト値 | 必須性 | 実行時式 | 概要 |
filter |
true | false |
true |
この属性がtrueにセットされる場合、 表現されたプロパティ値は HTML内でセンシティブな文字のために フィルターされる。 そしてこのような全ての文字は、 等価な文字で置き換えられる。 デフォルトでは、フィルタリングが行われる。 無効にするためには、この属性に明示的に false をセットする必要がある。 |
replaceNullToNbsp |
true | false |
true |
この属性がtrueにセットされ、
指定したbeanプロパティの値が空文字及び、nullの場合
を出力する。
無効にするためには、この属性に明示的に false をセットする必要がある。
|
replaceSpToNbsp |
true | false |
true |
この属性がtrueにセットされ、
指定したbeanプロパティの値に1Byteコードのスペースが存在する場合
に置換する。
無効にするためには、この属性に明示的に false をセットする必要がある。
|
replaceLFtoBR |
true | false |
true |
この属性がtrueにセットされる場合、
指定したbeanプロパティの値の改行コードもしくは復帰文字が
<br>に置換される。
無効にするためには、この属性に明示的に false をセットする必要がある。
|
ignore |
false | false |
true |
この属性がtrueにセットされ、 name と scope属性で指定した bean が存在しない場合、 なにもせずにリターンする。 デフォルト値は false (このタグ ライブラリの中のほかのタグと 矛盾しないように実行時例外がスローされる)。 |
name |
- | true |
true |
property (指定がある場合) によって指定した値を 取り出すために、プロパティがアクセスされる bean の属性名を指定する。 property が指定されない場合、この bean 自身の値が表現される。 |
property |
- | false |
true |
name によって指定した bean 上でアクセスされる プロパティの名前を指定する。 この値はシンプル、インデックス付き、 またはネストされたプロパティ参照式になる。 指定されない場合は、name によって識別された bean は それ自身を表現する。 指定したプロパティがヌルを戻す場合、何も表現されない。 |
scope |
- | false |
true |
name によって指定した bean を取り出すために検索された 可変スコープを指定する。 指定されない場合、PageContext.findAttribute() によって適用されたデフォルトのルールが適用される。 |
fillColumn |
- | false |
true |
fillColumnによって指定された文字数で区切り、 区切った終端に<br>を付与する。 文字数の数え方は半角でも、全角でも 1つの文字とみなす。 |
addBR |
false | false |
true |
この属性がtrueにセットされる場合、プロパティ値の末尾に<br>を付与する。 デフォルトはfalse。 |
| replaceNullToNbsp | addBR | name+property属性で指定したプロパティの値 | 出力結果 |
| true | true | null | |
| true | true | 空文字列 | |
| true | false | null | |
| true | false | 空文字列 | |
| false | true | null | 出力無し |
| false | true | 空文字列 | <br> |
| false | false | null | 出力無し |
| false | false | 空文字列 | 出力無し |
| replaceNullToNbsp | addBR | name属性で指定したbeanの値 | 出力結果 |
| true | true | null | 出力無し |
| true | true | 空文字列 | |
| true | false | null | 出力無し |
| true | false | 空文字列 | |
| false | true | null | 出力無し |
| false | true | 空文字列 | <br> |
| false | false | null | 出力無し |
| false | false | 空文字列 | 出力無し |
<logic:iterate id="form"
property="myMap" indexId="index" >
<t:write name="form" property="value" />
</logic:iterate>
| 修飾子とタイプ | フィールドと説明 |
|---|---|
protected boolean |
addBR
プロパティ値の末尾に<br>を加える。
|
protected int |
fillColumn
fillColumn によって指定された Bean
上でアクセスされるプロパティ名
|
protected boolean |
filter
特殊文字を
HTML に対応した文字に置き換える。 |
protected boolean |
ignore
name と scope 属性で指定された
Bean が存在しない場合、何もしない
|
protected String |
name
property で指定した値を取り出す為の Bean 名
|
protected String |
property
name によって指定された Bean 上で
アクセスされるプロパティ名
|
protected boolean |
replaceLFtoBR
改行コードを
<br>と置換する。 |
protected boolean |
replaceNullToNbsp
nullもしくは空文字を と置換する。 |
protected boolean |
replaceSpToNbsp
半角スペースを
と置換する。 |
protected String |
scope
name によって指定した bean
を取り出す為に検索するスコープ名
|
| コンストラクタと説明 |
|---|
WriteTag() |
| 修飾子とタイプ | メソッドと説明 |
|---|---|
int |
doStartTag()
開始タグの処理を行います。
|
boolean |
getAddBR()
addBR の get メソッド
|
int |
getFillColumn()
fillColumn の get メソッド
|
boolean |
getFilter()
filterのgetメソッド
|
boolean |
getIgnore()
ignore の get メソッド
|
String |
getName()
name の get メソッド
|
String |
getProperty()
property の get メソッド
|
boolean |
getReplaceLFtoBR()
replaceLFtoBR の get メソッド
|
boolean |
getReplaceNullToNbsp()
replaceNullToNbspのgetメソッド
|
boolean |
getReplaceSpToNbsp()
replaceSpToNbsp の get メソッド
|
String |
getScope()
scope の get メソッド
|
void |
release()
すべてのアロケートされた資源を解放する。
|
void |
setAddBR(boolean addBR)
addBR の set メソッド
|
void |
setFillColumn(int fillColumn)
fillColumn の set メソッド
|
void |
setFilter(boolean filter)
filterのsetメソッド
|
void |
setIgnore(boolean ignore)
ignore の set メソッド
|
void |
setName(String name)
name の set メソッド
|
void |
setProperty(String property)
property の set メソッド
|
void |
setReplaceLFtoBR(boolean replaceLFtoBR)
replaceLFtoBR の set メソッド
|
void |
setReplaceNullToNbsp(boolean replaceNullToNbsp)
replaceNullToNbsp の set メソッド
|
void |
setReplaceSpToNbsp(boolean replaceSpToNbsp)
replaceSpToNbsp の set メソッド
|
void |
setScope(String scope)
scope の set メソッド
|
protected boolean filter
特殊文字を HTML に対応した文字に置き換える。
protected boolean replaceNullToNbsp
nullもしくは空文字を と置換する。
protected boolean replaceSpToNbsp
半角スペースを と置換する。
protected boolean replaceLFtoBR
改行コードを<br>と置換する。
protected boolean ignore
name と scope 属性で指定された
Bean が存在しない場合、何もしない
protected String name
property で指定した値を取り出す為の Bean 名
protected String property
name によって指定された Bean 上で
アクセスされるプロパティ名
protected String scope
name によって指定した bean
を取り出す為に検索するスコープ名
protected int fillColumn
fillColumn によって指定された Bean
上でアクセスされるプロパティ名
protected boolean addBR
プロパティ値の末尾に<br>を加える。
public boolean getFilter()
filterのgetメソッド
public void setFilter(boolean filter)
filterのsetメソッド
filter - filter属性値public boolean getReplaceNullToNbsp()
replaceNullToNbspのgetメソッド
null から 変換フラグpublic void setReplaceNullToNbsp(boolean replaceNullToNbsp)
replaceNullToNbsp の set メソッド
replaceNullToNbsp - null から 変換フラグpublic boolean getReplaceSpToNbsp()
replaceSpToNbsp の get メソッド
変換フラグpublic void setReplaceSpToNbsp(boolean replaceSpToNbsp)
replaceSpToNbsp の set メソッド
replaceSpToNbsp - 半角スペースから 変換フラグpublic boolean getReplaceLFtoBR()
replaceLFtoBR の get メソッド
<br> 変換フラグpublic void setReplaceLFtoBR(boolean replaceLFtoBR)
replaceLFtoBR の set メソッド
replaceLFtoBR - 改行コードから <br> 変換フラグpublic boolean getIgnore()
ignore の get メソッド
public void setIgnore(boolean ignore)
ignore の set メソッド
ignore - ignore属性値public String getName()
name の get メソッド
public void setName(String name)
name の set メソッド
name - name属性値public String getProperty()
property の get メソッド
public void setProperty(String property)
property の set メソッド
property - property属性値public String getScope()
scope の get メソッド
public void setScope(String scope)
scope の set メソッド
scope - scope属性値public int getFillColumn()
fillColumn の get メソッド
public void setFillColumn(int fillColumn)
fillColumn の set メソッド
fillColumn - fillColumn属性値public boolean getAddBR()
addBR の get メソッド
public void setAddBR(boolean addBR)
addBR の set メソッド
addBR - addBR属性値public int doStartTag()
throws javax.servlet.jsp.JspException
開始タグの処理を行います。
doStartTag インタフェース内 javax.servlet.jsp.tagext.TagdoStartTag クラス内 javax.servlet.jsp.tagext.TagSupportjavax.servlet.jsp.JspException - JSP例外が発生した場合public void release()
すべてのアロケートされた資源を解放する。
release インタフェース内 javax.servlet.jsp.tagext.Tagrelease クラス内 javax.servlet.jsp.tagext.TagSupportCopyright © 2014. All Rights Reserved.