パッケージ org.opengion.fukurou.xml

# クラス TagElement

java.lang.Object
org.opengion.fukurou.xml.TagElement

public class TagElement extends Object
このｸﾗｽは、XMLﾌｧｲﾙのﾀｸﾞｴﾚﾒﾝﾄを表すｵﾌﾞｼﾞｪｸﾄです。 ﾀｸﾞとしては、ｺﾝｽﾄﾗｸﾀにMapを指定すれば(defaultMap)ﾀｸﾞのｶﾗﾑを 初期設定します。この場合、Map に LinkedHashMap を指定すれば、ｶﾗﾑの 順番も指定順になります。 ここで指定したMapの値は、put ﾒｿｯﾄﾞにより上書きされます。 setAfterMap で指定したMapは、既存の内部情報を上書きします。ｷｰがあれば、 afterMap の値が上書きされ、ｷｰが無ければ新規にｷｰが追加されます。 一般には、XMLﾌｧｲﾙから構築された後で、XMLﾌｧｲﾙの情報を一括して 書き換える場合などに使用します。 処理の途中にｾｯﾄした場合は、それまでの値が上書きされ、それ以降の値は、 put により設定された値が 優先されます。 toString() により、簡易的に ｵﾗｸﾙXDK形式のXMLﾌｧｲﾙの 1ﾚｺｰﾄﾞ 分の情報を返します。 ｵﾗｸﾙXDK形式のXMLﾌｧｲﾙとは、下記のような ROWSET をﾄｯﾌﾟとする ROW の 集まりで1ﾚｺｰﾄﾞを表し、各ROWには、ｶﾗﾑ名をｷｰとするXMLになっています。 <ROWSET> <ROW num="1"> ← この部分のみ <ｶﾗﾑ1>値1</ｶﾗﾑ1> ← この部分のみ ･･･ ← この部分のみ <ｶﾗﾑn>値n</ｶﾗﾑn> ← この部分のみ </ROW> ← この部分のみ ･･･ <ROW num="n"> ･･･ </ROW> <ROWSET> この形式であれば、XDK(Oracle XML Developer's Kit)を利用すれば、非常に簡単に ﾃﾞｰﾀﾍﾞｰｽとXMLﾌｧｲﾙとの交換が可能です。 XDK(Oracle XML Developer's Kit)

導入されたバージョン:
  JDK5.0,

- ## コンストラクタの概要

  コンストラクタ
  コンストラクタ
  説明
  `TagElement(String name)`
  Tag名を指定して、ｵﾌﾞｼﾞｪｸﾄを構築します。
  `TagElement(String name, Map<String,String> defaultMap)`
  Tag名と初期化ﾏｯﾌﾟを指定して、ｵﾌﾞｼﾞｪｸﾄを構築します。

- ## メソッドの概要

  修飾子とタイプ
  メソッド
  説明
  `String`
  `get(String key)`
  ｷｰを指定して値を取得します。
  `String`
  `getBody()`
  BODY部の文字列を取得します。
  `String[]`
  `getKeys()`
  ｶﾗﾑの配列を返します。
  `String`
  `getName()`
  Tag名を取得します。
  `String`
  `getRowNo()`
  行番号を取得します。
  `String[]`
  `getValues()`
  ｶﾗﾑ配列の順と同じ、値の配列を返します。
  `String[]`
  `getValues(String... clms)`
  引数のｶﾗﾑ名の配列の順番で、ｶﾗﾑ配列の値の配列を返します。
  `String[]`
  `getValues(List<String> clms)`
  引数のｶﾗﾑ名のListの順番で、ｶﾗﾑ配列の値の配列を返します。
  `void`
  `put(String key, String val)`
  ｶﾗﾑと値のﾍﾟｱを登録します。
  `void`
  `setAfterMap(Map<String,String> afterMap)`
  すでに構築済みの ｶﾗﾑと値に、上書きで ﾏｯﾌﾟ情報を追加します。
  `void`
  `setBody(String body)`
  BODY部の文字列を設定します。
  `void`
  `setRowNo(String num)`
  行番号を設定します。
  `String`
  `toString()`
  内部情報の文字列表現を返します。

  ### クラスから継承されたメソッド java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- ## コンストラクタの詳細

  - ### TagElement

    public TagElement(String name)
    Tag名を指定して、ｵﾌﾞｼﾞｪｸﾄを構築します。
    パラメータ:
      `name` - Tag名

  - ### TagElement

    public TagElement(String name, Map<String,String> defaultMap)
    Tag名と初期化ﾏｯﾌﾟを指定して、ｵﾌﾞｼﾞｪｸﾄを構築します。
    パラメータ:
      `name` - Tag名
      `defaultMap` - 初期化ﾏｯﾌﾟ
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。

- ## メソッドの詳細

  - ### getName

    public String getName()
    Tag名を取得します。
    戻り値:
      Tag名

  - ### put

    public void put(String key, String val)
    ｶﾗﾑと値のﾍﾟｱを登録します。 すでに 内部に同一ｶﾗﾑが存在する場合は、値の書き換えを、ｶﾗﾑが 存在しない場合は、ｶﾗﾑの追加を行います。 ｶﾗﾑは、追加された順番を再現してXML化できます。
    パラメータ:
      `key` - ｶﾗﾑ
      `val` - 値
    変更履歴:
      5.6.6.1 (2013/07/12) key が null や ｾﾞﾛ文字列の場合は、Map に追加しません。, 6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。

  - ### setAfterMap

    public void setAfterMap(Map<String,String> afterMap)
    すでに構築済みの ｶﾗﾑと値に、上書きで ﾏｯﾌﾟ情報を追加します。 すでに 内部に同一ｶﾗﾑが存在する場合は、値の書き換えを、ｶﾗﾑが 存在しない場合は、ｶﾗﾑの追加を行います。 ｶﾗﾑは、追加された順番を再現してXML化できます。
    パラメータ:
      `afterMap` - 後設定ﾏｯﾌﾟ
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。

  - ### get

    public String get(String key)
    ｷｰを指定して値を取得します。
    パラメータ:
      `key` - ｶﾗﾑ
    戻り値:
      値
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。

  - ### getRowNo

    public String getRowNo()
    行番号を取得します。
    戻り値:
      値

  - ### setRowNo

    public void setRowNo(String num)
    行番号を設定します。
    パラメータ:
      `num` - 値

  - ### getBody

    public String getBody()
    BODY部の文字列を取得します。
    戻り値:
      値

  - ### setBody

    public void setBody(String body)
    BODY部の文字列を設定します。
    パラメータ:
      `body` - 値

  - ### getKeys

    public String[] getKeys()
    ｶﾗﾑの配列を返します。
    戻り値:
      ｶﾗﾑの配列(順序は、ｶﾗﾑの登録順)
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。
    このﾒｿｯﾄﾞは、nullを返しません

  - ### getValues

    public String[] getValues()
    ｶﾗﾑ配列の順と同じ、値の配列を返します。
    戻り値:
      値の配列(順序は、ｶﾗﾑの登録順と一致しています。)
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。
    このﾒｿｯﾄﾞは、nullを返しません

  - ### getValues

    public String[] getValues(List<String> clms)
    引数のｶﾗﾑ名のListの順番で、ｶﾗﾑ配列の値の配列を返します。
    パラメータ:
      `clms` - ｶﾗﾑ名のListｵﾌﾞｼﾞｪｸﾄ
    戻り値:
      値の配列(順序は、ｶﾗﾑの登録順と一致しています。)
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。

  - ### getValues

    public String[] getValues(String... clms)
    引数のｶﾗﾑ名の配列の順番で、ｶﾗﾑ配列の値の配列を返します。 ｶﾗﾑ名が、存在しない場合は、値は、null を返します。
    パラメータ:
      `clms` - ｶﾗﾑ名の文字列配列(可変長引数)
    戻り値:
      値の配列(順序は、ｶﾗﾑの配列順と一致しています。)
    変更履歴:
      6.4.3.1 (2016/02/12) Collections.synchronizedMap に置き換え。ついでに変数名変更。

  - ### toString

    public String toString()
    内部情報の文字列表現を返します。 1ﾚｺｰﾄﾞ分を表す ROW のXML表現を作成します。前後に、ROWSET を 追加すれば、ｵﾗｸﾙXDK形式のXMLを作成できます。
    オーバーライド:
      `toString` クラス内 `Object`
    戻り値:
      内部情報の文字列表現
    このﾒｿｯﾄﾞは、nullを返しません