org.opengion.plugin.io

## クラス TableReader_JExcel

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

- すべての実装されたインタフェース:
    TableReader

      public class TableReader_JExcel
      extends AbstractTableReader

       JExcelによるEXCELバイナリファイルを読み取る実装クラスです。

       ファイル名、シート名を指定して、データを読み取ることが可能です。
       第一カラムが # で始まる行は、コメント行なので、読み飛ばします。
       カラム名の指定行で、カラム名が null の場合は、その列は読み飛ばします。

  変更履歴:

    3.5.4.8 (2004/02/23) 新規作成

  機能分類
    ファイル入力
  バージョン
    4.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK5.0,

- - ### フィールドのサマリー

    - ### クラスから継承されたフィールド org.opengion.hayabusa.io.AbstractTableReader

      `BUFFER_MIDDLE, columns, CR, dbColumn, table`

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

      `TAB_SEPARATOR`

  - ### コンストラクタのサマリー

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

  - ### メソッドのサマリー

    All Methods Instance Methods Concrete Methods
    修飾子とタイプ | メソッドと説明
    --- | ---
    `boolean` | `isExcel()` このクラスが、EXCEL対応機能を持っているかどうかを返します。
    `void` | `readDBTable()` DBTableModel から 各形式のデータを作成して,BufferedReader より読み取ります。
    `void` | `readDBTable(BufferedReader reader)` DBTableModel から 各形式のデータを作成して,BufferedReader より読み取ります。
    `void` | `setFilename(String filename)` 読み取り元ファイル名をセットします。
    `void` | `setSheetName(String sheetName)` DBTableModelのデータとしてEXCELファイルを読み込むときのシート名を設定します。
    `void` | `setSheetNos(String sheetNos)` EXCELファイルを読み込むときのシート番号を指定します(初期値:0)。

    - ### クラスから継承されたメソッド org.opengion.hayabusa.io.AbstractTableReader

      `getDBTableModel, getEncode, getMaxRowCount, getSeparator, getSkipRowCount, isDebug, isUseNumber, readData, setColumns, setDebug, setEncode, setMaxRowCount, setNullBreakClm, setResourceManager, setSeparator, setSheetConstData, setSkipRowCount, setTableColumnValues, setTableDBColumn, setUseNumber, setUseRenderer`

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

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

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

    - #### TableReader_JExcel

          public TableReader_JExcel()

  - ### メソッドの詳細

    - #### readDBTable

          public void readDBTable()

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

        4.0.0.0 (2006/09/31) 新規追加
        5.1.6.0 (2010/05/01) columns 処理 追加
        5.1.6.0 (2010/05/01) skipRowCount , useNumber の追加
        5.2.1.0 (2010/10/01) setTableColumnValues メソッドを経由して、テーブルにデータをセットする。
        5.5.7.2 (2012/10/09) sheetNos 追加による複数シートのマージ読み取りサポート

    - #### readDBTable

          public void readDBTable(BufferedReader reader)

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

        3.5.4.3 (2004/01/05) 引数に、BufferedReader を受け取る要に変更します。
        4.0.0.0 (2006/09/31) UnsupportedOperationException を発行します。

    - #### setSheetName

          public void setSheetName(String sheetName)

      DBTableModelのデータとしてEXCELファイルを読み込むときのシート名を設定します。 これにより、複数の形式の異なるデータを順次読み込むことや、シートを指定して 読み取ることが可能になります。 sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。エラーにはならないのでご注意ください。 のでご注意ください。
      定義:
        `setSheetName` インタフェース内 `TableReader`
      オーバーライド:
        `setSheetName` クラス内 `AbstractTableReader`
      パラメータ:
        `sheetName` - シート名
      関連項目:
        `TableReader.setSheetNos( String )`
      変更履歴:

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

    - #### setSheetNos

          public void setSheetNos(String sheetNos)

      EXCELファイルを読み込むときのシート番号を指定します(初期値:0)。 EXCEL読み込み時に複数シートをマージして取り込みます。 シート番号は、0 から始まる数字で表します。 ヘッダーは、最初のシートのカラム位置に合わせます。（ヘッダータイトルの自動認識はありません。） よって、指定するシートは、すべて同一レイアウトでないと取り込み時にカラムのずれが発生します。 シート番号の指定は、カンマ区切りで、複数指定できます。また、N-M の様にハイフンで繋げることで、 N 番から、M 番のシート範囲を一括指定可能です。また、"*" による、全シート指定が可能です。 これらの組み合わせも可能です。（ 0,1,3,5-8,10-* ） ただし、"*" に関しては例外的に、一文字だけで、すべてのシートを表すか、N-* を最後に指定するかの どちらかです。途中には、"*" は、現れません。 シート番号は、重複(1,1,2,2)、逆転(3,2,1) での指定が可能です。これは、その指定順で、読み込まれます。 sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。エラーにはならないのでご注意ください。 このメソッドは、isExcel() == true の場合のみ利用されます。 初期値は、0（第一シート） です。 ※ このクラスでは実装されていません。
      定義:
        `setSheetNos` インタフェース内 `TableReader`
      オーバーライド:
        `setSheetNos` クラス内 `AbstractTableReader`
      パラメータ:
        `sheetNos` - EXCELファイルのシート番号（0から始まる）
      関連項目:
        `setSheetName( String )`
      変更履歴:

        5.5.7.2 (2012/10/09) 新規追加

    - #### isExcel

          public boolean isExcel()

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

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

    - #### setFilename

          public void setFilename(String filename)

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

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

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