jp.terasoluna.fw.web.taglib
クラス WriteTag

java.lang.Object
  上位を拡張 javax.servlet.jsp.tagext.TagSupport
      上位を拡張 jp.terasoluna.fw.web.taglib.WriteTag
すべての実装されたインタフェース:
java.io.Serializable, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class WriteTag
extends javax.servlet.jsp.tagext.TagSupport

指定した bean プロパティの値を変換しJspWriterとして 表現するwriteタグの実装クラス。

指定したbeanプロパティの値を取り出し、 Stringとして現在の JspWriter に与える。 プロパティ値のクラス用に構成されているPropertyEditor がある場合、 getAsText() メソッドが呼ばれる。 それ以外の場合は、通常 toString() での変換が適用される。 また、属性により、以下のように付加変換を行う。

  • nullもしくは空文字を " " と置換
  • 半角スペースを " " と置換
  • 改行コードを <br> と置換
  • 改行文字を無視

  • タグがサポートする属性
  • write タグでは、以下の属性をサポートする。


  • 属性名 デフォルト値 必須性 実行時式 概要
    filter - false true この属性がtrueにセットされる場合、 表現されたプロパティ値は HTML内でセンシティブな文字のために フィルターされる。 そしてこのような全ての文字は、 等価な文字で置き換えられる。 デフォルトでは、フィルタリングが行われる。 無効にするためには、この属性に明示的に false をセットする必要がある。
    replaceNullToNbsp - false true この属性がtrueにセットされ、 指定したbeanプロパティの値が空文字及び、nullの場合 &nbsp;を出力する。 無効にするためには、この属性に明示的に false をセットする必要がある。
    replaceSpToNbsp - false true この属性がtrueにセットされ、 指定したbeanプロパティの値に1Byteコードのスペースが存在する場合 &nbsp;に置換する。 無効にするためには、この属性に明示的に false をセットする必要がある。
    replaceLFtoBR - false true この属性がtrueにセットされる場合、 指定したbeanプロパティの値の改行コードもしくは復帰文字が <br>に置換される。 無効にするためには、この属性に明示的に false をセットする必要がある。
    ignore - 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 true この属性がtrueにセットされる場合、プロパティ値の末尾に<br>を付与する。 デフォルトは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
               namescope 属性で指定された Bean が存在しない場合、何もしない
    private static org.apache.commons.logging.Log log
              ログクラス
    protected  java.lang.String name
               property で指定した値を取り出す為の Bean
    protected  java.lang.String property
               name によって指定された Bean 上で アクセスされるプロパティ名
    protected  boolean replaceLFtoBR
               改行コードを<br>と置換する。
    protected  boolean replaceNullToNbsp
               nullもしくは空文字を と置換する。
    protected  boolean replaceSpToNbsp
               半角スペースを &nbsp; と置換する。
    protected  java.lang.String scope
               name によって指定した bean を取り出す為に検索するスコープ名
    private static long serialVersionUID
              シリアルバージョンID
     
    クラス javax.servlet.jsp.tagext.TagSupport から継承されたフィールド
    id, pageContext
     
    インタフェース javax.servlet.jsp.tagext.IterationTag から継承されたフィールド
    EVAL_BODY_AGAIN
     
    インタフェース javax.servlet.jsp.tagext.Tag から継承されたフィールド
    EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
     
    コンストラクタの概要
    WriteTag()
               
     
    メソッドの概要
     int doStartTag()
              開始タグの処理を行います。
     boolean getAddBR()
               addBRget メソッド
     int getFillColumn()
               fillColumnget メソッド
     boolean getFilter()
               filtergetメソッド
     boolean getIgnore()
               ignoreget メソッド
     java.lang.String getName()
               nameget メソッド
     java.lang.String getProperty()
               propertyget メソッド
     boolean getReplaceLFtoBR()
               replaceLFtoBRget メソッド
     boolean getReplaceNullToNbsp()
               replaceNullToNbspgetメソッド
     boolean getReplaceSpToNbsp()
               replaceSpToNbspget メソッド
     java.lang.String getScope()
               scopeget メソッド
     void release()
              すべてのアロケートされた資源を解放する。
     void setAddBR(boolean addBR)
               addBRset メソッド
     void setFillColumn(int fillColumn)
               fillColumnset メソッド
     void setFilter(boolean filter)
               filtersetメソッド
     void setIgnore(boolean ignore)
               ignoreset メソッド
     void setName(java.lang.String name)
               nameset メソッド
     void setProperty(java.lang.String property)
               propertyset メソッド
     void setReplaceLFtoBR(boolean replaceLFtoBR)
               replaceLFtoBRset メソッド
     void setReplaceNullToNbsp(boolean replaceNullToNbsp)
               replaceNullToNbspset メソッド
     void setReplaceSpToNbsp(boolean replaceSpToNbsp)
               replaceSpToNbspset メソッド
     void setScope(java.lang.String scope)
               scopeset メソッド
     
    クラス javax.servlet.jsp.tagext.TagSupport から継承されたメソッド
    doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
     
    クラス java.lang.Object から継承されたメソッド
    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
     

    フィールドの詳細

    serialVersionUID

    private static final long serialVersionUID
    シリアルバージョンID

    関連項目:
    定数フィールド値

    log

    private static org.apache.commons.logging.Log log
    ログクラス


    filter

    protected boolean filter

    特殊文字を HTML に対応した文字に置き換える。


    replaceNullToNbsp

    protected boolean replaceNullToNbsp

    nullもしくは空文字を と置換する。


    replaceSpToNbsp

    protected boolean replaceSpToNbsp

    半角スペースを &nbsp; と置換する。


    replaceLFtoBR

    protected boolean replaceLFtoBR

    改行コードを<br>と置換する。


    ignore

    protected boolean ignore

    namescope 属性で指定された Bean が存在しない場合、何もしない


    name

    protected java.lang.String name

    property で指定した値を取り出す為の Bean


    property

    protected java.lang.String property

    name によって指定された Bean 上で アクセスされるプロパティ名


    scope

    protected java.lang.String scope

    name によって指定した bean を取り出す為に検索するスコープ名


    fillColumn

    protected int fillColumn

    fillColumn によって指定された Bean 上でアクセスされるプロパティ名


    addBR

    protected boolean addBR

    プロパティ値の末尾に<br>を加える。

    コンストラクタの詳細

    WriteTag

    public WriteTag()
    メソッドの詳細

    getFilter

    public boolean getFilter()

    filtergetメソッド

    戻り値:
    filter filter

    setFilter

    public void setFilter(boolean filter)

    filtersetメソッド

    パラメータ:
    filter - filter属性値

    getReplaceNullToNbsp

    public boolean getReplaceNullToNbsp()

    replaceNullToNbspgetメソッド

    戻り値:
    replaceNullToNbsp null から &nbsp; 変換フラグ

    setReplaceNullToNbsp

    public void setReplaceNullToNbsp(boolean replaceNullToNbsp)

    replaceNullToNbspset メソッド

    パラメータ:
    replaceNullToNbsp - null から &nbsp; 変換フラグ

    getReplaceSpToNbsp

    public boolean getReplaceSpToNbsp()

    replaceSpToNbspget メソッド

    戻り値:
    replaceSpToNbsp 半角スペースから &nbsp; 変換フラグ

    setReplaceSpToNbsp

    public void setReplaceSpToNbsp(boolean replaceSpToNbsp)

    replaceSpToNbspset メソッド

    パラメータ:
    replaceSpToNbsp - 半角スペースから &nbsp; 変換フラグ

    getReplaceLFtoBR

    public boolean getReplaceLFtoBR()

    replaceLFtoBRget メソッド

    戻り値:
    replaceLFtoBR 改行コードから <br> 変換フラグ

    setReplaceLFtoBR

    public void setReplaceLFtoBR(boolean replaceLFtoBR)

    replaceLFtoBRset メソッド

    パラメータ:
    replaceLFtoBR - 改行コードから <br> 変換フラグ

    getIgnore

    public boolean getIgnore()

    ignoreget メソッド

    戻り値:
    ignore ignore属性値

    setIgnore

    public void setIgnore(boolean ignore)

    ignoreset メソッド

    パラメータ:
    ignore - ignore属性値

    getName

    public java.lang.String getName()

    nameget メソッド

    戻り値:
    name

    setName

    public void setName(java.lang.String name)

    nameset メソッド

    パラメータ:
    name - name属性値

    getProperty

    public java.lang.String getProperty()

    propertyget メソッド

    戻り値:
    property

    setProperty

    public void setProperty(java.lang.String property)

    propertyset メソッド

    パラメータ:
    property - property属性値

    getScope

    public java.lang.String getScope()

    scopeget メソッド

    戻り値:
    scope

    setScope

    public void setScope(java.lang.String scope)

    scopeset メソッド

    パラメータ:
    scope - scope属性値

    getFillColumn

    public int getFillColumn()

    fillColumnget メソッド

    戻り値:
    fillColumn

    setFillColumn

    public void setFillColumn(int fillColumn)

    fillColumnset メソッド

    パラメータ:
    fillColumn - fillColumn属性値

    getAddBR

    public boolean getAddBR()

    addBRget メソッド

    戻り値:
    addBR addBR属性値

    setAddBR

    public void setAddBR(boolean addBR)

    addBRset メソッド

    パラメータ:
    addBR - addBR属性値

    doStartTag

    public int doStartTag()
                   throws javax.servlet.jsp.JspException

    開始タグの処理を行います。

    定義:
    インタフェース javax.servlet.jsp.tagext.Tag 内の doStartTag
    オーバーライド:
    クラス javax.servlet.jsp.tagext.TagSupport 内の doStartTag
    戻り値:
    int 処理制御指示
    例外:
    javax.servlet.jsp.JspException - JSP例外が発生した場合

    release

    public void release()

    すべてのアロケートされた資源を解放する。

    定義:
    インタフェース javax.servlet.jsp.tagext.Tag 内の release
    オーバーライド:
    クラス javax.servlet.jsp.tagext.TagSupport 内の release