org.opengion.fukurou.util

## クラス ExcelReader_XSSF

- java.lang.Object
- - org.opengion.fukurou.util.ExcelReader_XSSF

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

      public final class ExcelReader_XSSF
      extends Object
      implements ExcelReader

       POI による、Excel(xlsx)の読み取りクラスです。

       xlsx形式のEXCELを、イベント方式でテキストデータを読み取ります。
       このクラスでは、XSSF(.xlsx)形式のファイルを、ExcelReaderEvent を介したイベントで読み取ります。
       ExcelReaderEventイベントは、openGion形式のファイル読み取りに準拠した方法をサポートします。
       ※ openGion形式のEXCELファイルとは、#NAME 列に、カラム名があり、#で始まる
          レコードは、コメントとして判断し、読み飛ばす処理の事です。

  変更履歴:

    6.0.3.0 (2014/11/13) 新規作成

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

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

    フィールド
    修飾子とタイプ | フィールドと説明
    --- | ---
    `static String` | `SAX_PARSER` XSSF(.xlsx)ファイル解析用の、SAXParser "org.apache.xerces.parsers.SAXParser"

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

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

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

    All Methods Static Methods Instance Methods Concrete Methods
    修飾子とタイプ | メソッドと説明
    --- | ---
    `void` | `excelReader(String fname, ExcelReaderEvent event)` 引数ファイル(Excel)を、XSSFイベントモデルを使用してテキスト化します。
    `static List` | `getSheetList(org.apache.poi.xssf.eventusermodel.XSSFReader rd, XMLReader parser)` シート一覧を、XSSFReader から取得します。
    `static void` | `main(String[] args)` アプリケーションのサンプルです。

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

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

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

    - #### SAX_PARSER

          public static final String SAX_PARSER

      XSSF(.xlsx)ファイル解析用の、SAXParser "org.apache.xerces.parsers.SAXParser"
      関連項目:
        定数フィールド値

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

    - #### ExcelReader_XSSF

          public ExcelReader_XSSF()

  - ### メソッドの詳細

    - #### excelReader

          public void excelReader(String fname,
                                  ExcelReaderEvent event)

      引数ファイル(Excel)を、XSSFイベントモデルを使用してテキスト化します。 ExcelReaderEventは、EXCEL読み取り処理用の統一されたイベント処理クラスです。 openGion特有のEXCEL処理方法(#NAME , 先頭行#コメントなど)を実装しています。 これは、HSSFやXSSFの処理を、統一的なイベントモデルで扱うためです。 SSモデルが良いのですが、巨大なXSSF(.xlsx)ファイルを解析すると、OutOfMemoryエラーが 発生する為、個々に処理する必要があります。 あくまで、読み取り限定であれば、こちらのイベントモデルで十分です。
      定義:
        `excelReader` インタフェース内 `ExcelReader`
      パラメータ:
        `fname` - 入力ファイル名
        `event` - イベント処理するオブジェクト
      変更履歴:

        6.0.3.0 (2014/11/13) 新規作成
        6.1.0.0 (2014/12/26) シートの数のイベント
        6.2.0.0 (2015/01/30) staticメソッドをインスタンスメソッドに変更。

    - #### getSheetList

          public static List getSheetList(org.apache.poi.xssf.eventusermodel.XSSFReader rd,
                                          XMLReader parser)
                                   throws SAXException,
                                          IOException,
                                          org.apache.poi.openxml4j.exceptions.InvalidFormatException

      シート一覧を、XSSFReader から取得します。 取得元が、XSSFReader なので、xlsx 形式のみの対応です。 汎用的なメソッドではなく、大きな xlsx ファイルは、通常の DOM処理すると、 大量のメモリを消費する為、イベントモデルで処理する場合に、使います。 EXCEL上のシート名を、配列で返します。
      パラメータ:
        `rd` - XSSFReaderオブジェクト
        `parser` - XMLReaderオブジェクト
      戻り値:
        シート名とシートIDを持つオブジェクトのリスト
      例外:
        `SAXException` - SAX の一般的なエラーが発生
        `IOException` - SAXパース処理時のI/Oエラー
        `org.apache.poi.openxml4j.exceptions.InvalidFormatException` - よみとったEXCEL ファイルのフォーマットが異なる。
      変更履歴:

        6.0.3.0 (2014/11/13) 新規作成

    - #### main

          public static void main(String[] args)

      アプリケーションのサンプルです。 入力ファイル名 は必須で、第一引数固定です。 Usage: java org.opengion.fukurou.util.ExcelReader_XSSF 入力ファイル名
      パラメータ:
        `args` - コマンド引数配列
      変更履歴:

        6.0.3.0 (2014/11/13) 新規作成
        6.2.0.0 (2015/01/30) staticメソッドをインスタンスメソッドに変更。

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