org.opengion.hayabusa.io

## クラス AbstractTableReader

- java.lang.Object
- - org.opengion.hayabusa.io.AbstractTableReader

- すべての実装されたインタフェース:
    TableReader
  直系の既知のサブクラス:
    TableReader_Default, TableReader_JExcel

      public abstract class AbstractTableReader
      extends Object
      implements TableReader

  指定の区切り記号(初期値:タブ区切り)ファイルの読み取りクラスです。 名前，データの入力部のみオーバーライドすれば，各種入力フォーマットに合わせた サブクラスを実現する事が可能です。
  機能階層
    ファイル入力
  バージョン
    4.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK5.0,

- - ### フィールドの概要

    フィールド
    修飾子とタイプ | フィールドと説明
    --- | ---
    `protected String` | `columns`
    `protected DBColumn[]` | `dbColumn`
    `protected DBTableModel` | `table`

    - ### インタフェースから継承されたフィールド org.opengion.hayabusa.io.TableReader

      `TAB_SEPARATOR`

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

    コンストラクタ
    コンストラクタと説明
    `AbstractTableReader()`

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `DBTableModel` | `getDBTableModel()` 内部の DBTableModel を返します。
    `protected String` | `getEncode()` 読み取り元ファイルのエンコード文字列を取得します。
    `int` | `getMaxRowCount()` DBTableModelのデータとして登録する最大件数をこの値に設定します。
    `String` | `getSeparator()` データを書き込む場合の,区切り文字を返します。
    `int` | `getSkipRowCount()` データの読み始めの初期値を取得します。
    `boolean` | `isExcel()` このクラスが、EXCEL対応機能を持っているかどうかを返します。
    `protected boolean` | `isUseNumber()` 行番号情報を、使用している(true)/していない(false)を返します。
    `protected String[]` | `readData(String data, int clmSize)` １行のデータを テーブルモデルにセットするように分割します。
    `abstract void` | `readDBTable()` DBTableModel から 各形式のデータを作成して,BufferedReader より読み取ります。
    `abstract void` | `readDBTable(BufferedReader reader)` DBTableModel から 各形式のデータを作成して,BufferedReader より読み取ります。
    `void` | `setColumns(String clms)` 読み取り元ファイルのカラム列を、外部(タグ)より指定します。
    `void` | `setEncode(String enc)` 読み取り元ファイルのエンコード文字列を指定します。
    `void` | `setFilename(String filename)` 読み取り元ファイル名をセットします。
    `void` | `setMaxRowCount(int maxRowCount)` DBTableModelのデータとして登録する最大件数をこの値に設定します。
    `void` | `setResourceManager(ResourceManager resource)` リソースマネージャーをセットします。
    `void` | `setSeparator(String sep)` データを読み込む場合の,区切り文字をセットします。
    `void` | `setSheetName(String sheetName)` DBTableModelのデータとして読み込むときのシート名を設定します。
    `void` | `setSkipRowCount(int count)` データの読み飛ばし件数を設定します。
    `protected void` | `setTableColumnValues(String[] values)` DBTableModelオブジェクトに、１行分のデータを追加します。
    `protected void` | `setTableDBColumn(String[] names)` DBColumn オブジェクトをDBTable に設定します。
    `void` | `setUseNumber(boolean useNumber)` 行番号情報を指定[true:使用している/false:していない]します(初期値:true)。
    `void` | `setUseRenderer(boolean useRenderer)` 読取処理でラベルをコードリソースに逆変換を行うかどうかを指定します。

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

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

- - ### フィールドの詳細

    - #### table

          protected DBTableModel table

    - #### dbColumn

          protected DBColumn[] dbColumn

    - #### columns

          protected String columns

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

    - #### AbstractTableReader

          public AbstractTableReader()

  - ### メソッドの詳細

    - #### readDBTable

          public abstract void readDBTable()

      DBTableModel から 各形式のデータを作成して,BufferedReader より読み取ります。 コメント/空行を除き、最初の行は、必ず項目名が必要です。 それ以降は、コメント/空行を除き、データとして読み込んでいきます。 このメソッドは、EXCEL 読み込み時に使用します。
      定義:
        `readDBTable` インタフェース内 `TableReader`
      関連項目:
        `isExcel()`

    - #### readDBTable

          public abstract void readDBTable(BufferedReader reader)

      DBTableModel から 各形式のデータを作成して,BufferedReader より読み取ります。 コメント/空行を除き、最初の行は、必ず項目名が必要です。 それ以降は、コメント/空行を除き、データとして読み込んでいきます。
      定義:
        `readDBTable` インタフェース内 `TableReader`
      パラメータ:
        `reader` - BufferedReaderオブジェクト

    - #### setResourceManager

          public void setResourceManager(ResourceManager resource)

      リソースマネージャーをセットします。 これは、言語(ロケール)に応じた DBColumn をあらかじめ設定しておく為に 必要です。 リソースマネージャーが設定されていない、または、所定のキーの DBColumn が リソースに存在しない場合は、内部で DBColumn オブジェクトを作成します。
      定義:
        `setResourceManager` インタフェース内 `TableReader`
      パラメータ:
        `resource` - リソースマネージャー
      変更履歴:

        4.0.0 (2005/01/31) lang ⇒ ResourceManager へ変更

    - #### setTableDBColumn

          protected void setTableDBColumn(String[] names)

      DBColumn オブジェクトをDBTable に設定します。
      パラメータ:
        `names` - カラム名配列
      変更履歴:

        3.5.4.2 (2003/12/15) private を protected に変更。
        3.5.4.5 (2004/01/23) DBColumn 配列に値をセットします。
        5.2.1.0 (2010/10/01) useRenderer対応(コードリソース毎のラベル逆引き)

    - #### setTableColumnValues

          protected void setTableColumnValues(String[] values)

      DBTableModelオブジェクトに、１行分のデータを追加します。 これ自体は、メソッドの共通化による 拡張をしやすくするために用意しました。
      パラメータ:
        `values` - １行分のデータ配列
      変更履歴:

        5.2.1.0 (2010/10/01) 新規作成

    - #### readData

          protected String[] readData(String data,
                          int clmSize)

      １行のデータを テーブルモデルにセットするように分割します。 なお、読込みは，NAME項目分を読み込みます。データ件数が少ない場合は、 "" をセットしておきます。 データの分割は、separator文字を使用します。
      パラメータ:
        `data` - １行のデータ
        `clmSize` - カラム数
      戻り値:
        分割された文字列配列
      変更履歴:

        3.3.3.1 (2003/07/18) ファイルリード/ライト時に後ろスペースの除去を行います。
        3.7.0.5 (2005/04/11) useNumber 属性を考慮します。

    - #### getDBTableModel

          public DBTableModel getDBTableModel()

      内部の DBTableModel を返します。
      定義:
        `getDBTableModel` インタフェース内 `TableReader`
      戻り値:
        テーブルモデル

    - #### setSeparator

          public void setSeparator(String sep)

      データを読み込む場合の,区切り文字をセットします。 なお，このメソッドは,サブクラスによっては,使用しない場合があります。 もし，使用しないサブクラスを作成する場合は, UnsupportedOperationException を throw するように,サブクラスで実装して下さい。
      定義:
        `setSeparator` インタフェース内 `TableReader`
      パラメータ:
        `sep` - 区切り文字
      変更履歴:

        3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。

    - #### getSeparator

          public String getSeparator()

      データを書き込む場合の,区切り文字を返します。
      戻り値:
        区切り文字

    - #### getMaxRowCount

          public int getMaxRowCount()

      DBTableModelのデータとして登録する最大件数をこの値に設定します。 サーバーのメモリ資源と応答時間の確保の為です。
      定義:
        `getMaxRowCount` インタフェース内 `TableReader`
      戻り値:
        最大検索件数

    - #### setMaxRowCount

          public void setMaxRowCount(int maxRowCount)

      DBTableModelのデータとして登録する最大件数をこの値に設定します。 サーバーのメモリ資源と応答時間の確保の為です。
      定義:
        `setMaxRowCount` インタフェース内 `TableReader`
      パラメータ:
        `maxRowCount` - 最大検索件数
      変更履歴:

        3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。

    - #### setSheetName

          public void setSheetName(String sheetName)

      DBTableModelのデータとして読み込むときのシート名を設定します。 初期値は、第一シートです。 ※ このクラスでは実装されていません。
      定義:
        `setSheetName` インタフェース内 `TableReader`
      パラメータ:
        `sheetName` - シート名
      変更履歴:

        3.5.4.2 (2003/12/15) 新規追加

    - #### isExcel

          public boolean isExcel()

      このクラスが、EXCEL対応機能を持っているかどうかを返します。 EXCEL対応機能とは、シート名のセット、読み込み元ファイルの Fileオブジェクト取得などの、特殊機能です。 本来は、インターフェースを分けるべきと考えますが、taglib クラス等の 関係があり、問い合わせによる条件分岐で対応します。
      定義:
        `isExcel` インタフェース内 `TableReader`
      戻り値:
        EXCEL対応機能を持っているかどうか
      変更履歴:

        3.5.4.3 (2004/01/05) 新規追加

    - #### setFilename

          public void setFilename(String filename)

      読み取り元ファイル名をセットします。(DIR + Filename) これは、EXCEL追加機能として実装されています。 ※ このクラスでは実装されていません。
      定義:
        `setFilename` インタフェース内 `TableReader`
      パラメータ:
        `filename` - 読み取り元ファイル名
      変更履歴:

        3.5.4.3 (2004/01/05) 新規作成

    - #### setColumns

          public void setColumns(String clms)

      読み取り元ファイルのカラム列を、外部(タグ)より指定します。 ファイルに記述された #NAME より優先して使用されます。
      定義:
        `setColumns` インタフェース内 `TableReader`
      パラメータ:
        `clms` - 読み取り元ファイルのカラム列(カンマ区切り文字)
      変更履歴:

        3.5.4.5 (2004/01/23) 新規作成

    - #### setEncode

          public void setEncode(String enc)

      読み取り元ファイルのエンコード文字列を指定します。 ファイルは、BufferedReader で受け取る為、本来は、エンコードは不要ですが、 固定長ファイルの読み取り時のバイトコード分割時に、指定のエンコードで 分割する必要があります。(例えば、半角文字は、Shift_JIS では、１バイト)
      定義:
        `setEncode` インタフェース内 `TableReader`
      パラメータ:
        `enc` - ファイルのエンコード文字列
      変更履歴:

        3.5.4.5 (2004/01/23) 新規作成

    - #### getEncode

          protected String getEncode()

      読み取り元ファイルのエンコード文字列を取得します。 ファイルは、BufferedReader で受け取る為、本来は、エンコードは不要ですが、 固定長ファイルの読み取り時のバイトコード分割時に、指定のエンコードで 分割する必要があります。(例えば、半角文字は、Shift_JIS では、１バイト)
      戻り値:
        ファイルのエンコード文字列
      変更履歴:

        3.5.4.5 (2004/01/23) 新規作成

    - #### setUseNumber

          public void setUseNumber(boolean useNumber)

      行番号情報を指定[true:使用している/false:していない]します(初期値:true)。 通常のフォーマットでは、各行の先頭に行番号が出力されています。 読み取り時に、#NAME 属性を使用する場合は、この行番号を無視しています。 #NAME 属性を使用せず、columns 属性でカラム名を指定する場合(他システムの 出力ファイルを読み取るケース等)では、行番号も存在しないケースがあり、 その様な場合に、useNumber="false" を指定すれば、データの最初から読み取り始めます。 この場合、出力データのカラムの並び順が変更された場合、columns 属性も 指定しなおす必要がありますので、できるだけ、#NAME 属性を使用するように してください。 なお、EXCEL 入力には、この設定は適用されません。(暫定対応) 初期値は、true(使用する) です。
      定義:
        `setUseNumber` インタフェース内 `TableReader`
      パラメータ:
        `useNumber` - 行番号情報 [true:使用する/false:使用しない]
      変更履歴:

        3.7.0.5 (2005/04/11) 新規追加

    - #### getSkipRowCount

          public int getSkipRowCount()

      データの読み始めの初期値を取得します。 TAB区切りテキストやEXCEL等のデータの読み始めの初期値を指定します。 ファイルの先頭行が、０行としてカウントしますので、設定値は、読み飛ばす 件数になります。(１と指定すると、１件読み飛ばし、２行目から読み込みます。) 読み飛ばしは、コメント行などは、無視しますので、実際の行数分読み飛ばします。 ＃NAME属性や、columns 属性は、有効です。
      戻り値:
        読み始めの初期値
      変更履歴:

        5.1.6.0 (2010/05/01) 新規作成

    - #### setSkipRowCount

          public void setSkipRowCount(int count)

      データの読み飛ばし件数を設定します。 TAB区切りテキストやEXCEL等のデータの読み始めの初期値を指定します。 ファイルの先頭行が、０行としてカウントしますので、設定値は、読み飛ばす 件数になります。(１と指定すると、１件読み飛ばし、２行目から読み込みます。) 読み飛ばしは、コメント行などは、無視しますので、実際の行数分読み飛ばします。 ＃NAME属性や、columns 属性は、有効です。
      定義:
        `setSkipRowCount` インタフェース内 `TableReader`
      パラメータ:
        `count` - 読み始めの初期値
      変更履歴:

        5.1.6.0 (2010/05/01) 新規作成

    - #### setUseRenderer

          public void setUseRenderer(boolean useRenderer)

      読取処理でラベルをコードリソースに逆変換を行うかどうかを指定します。 TableWriter_Renderer 系のクラスで出力した場合は、コードリソースがラベルで出力されます。 そのファイルを読み取ると、当然、エラーになります。 ここでは、コードリソースのカラムに対して、ラベルからコードを求める逆変換を行うことで、 Renderer 系で出力したファイルを取り込むことができるようにします。 ここでは、TableWriter 系と同様に、TableReader_Renderer 系のクラスを作るのではなく、 属性値のフラグで、制御します。 将来的には、TableWriter 系も廃止して、同様のフラグで制御するように変更する予定です。
      定義:
        `setUseRenderer` インタフェース内 `TableReader`
      パラメータ:
        `useRenderer` - コードリソースのラベル変換を行うかどうかを指定
      変更履歴:

        5.2.1.0 (2010/10/01) 新規作成

    - #### isUseNumber

          protected boolean isUseNumber()

      行番号情報を、使用している(true)/していない(false)を返します。 通常のフォーマットでは、各行の先頭に行番号が出力されています。 読み取り時に、#NAME 属性を使用する場合は、この行番号を無視しています。 #NAME 属性を使用せず、columns 属性でカラム名を指定する場合(他システムの 出力ファイルを読み取るケース等)では、行番号も存在しないケースがあり、 その様な場合に、useNumber="false" を指定すれば、データの最初から読み取り始めます。 この場合、出力データのカラムの並び順が変更された場合、columns 属性も 指定しなおす必要がありますので、できるだけ、#NAME 属性を使用するように してください。 なお、EXCEL 入力には、この設定は適用されません。(暫定対応) 初期値は、true(使用する) です。
      戻り値:
        行番号情報を、使用している(true)/していない(false)を指定
      変更履歴:

        3.7.0.5 (2005/04/11) 新規追加
        4.0.0 (2007/07/20) メソッド名変更(getUseNumber() ⇒ isUseNumber())

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.