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.Tag
doStartTag
クラス内 javax.servlet.jsp.tagext.TagSupport
javax.servlet.jsp.JspException
- JSP例外が発生した場合public void release()
すべてのアロケートされた資源を解放する。
release
インタフェース内 javax.servlet.jsp.tagext.Tag
release
クラス内 javax.servlet.jsp.tagext.TagSupport
Copyright © 2016. All Rights Reserved.