パッケージ 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() により、簡易的に オラクルＸＤＫ形式のＸＭＬファイルの １レコード 分の情報を返します。 オラクルＸＤＫ形式のＸＭＬファイルとは、下記のような ROWSET をトップとする ROW の 集まりで１レコードを表し、各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()
    内部情報の文字列表現を返します。 １レコード分を表す ROW のXML表現を作成します。前後に、ROWSET を 追加すれば、オラクルXDK形式のXMLを作成できます。
    オーバーライド:
      `toString` クラス内 `Object`
    戻り値:
      内部情報の文字列表現
    このﾒｿｯﾄﾞは、nullを返しません