クラス ExcelLayout


  • public class ExcelLayout
    extends Object
    【EXCEL取込】雛形EXCELシートの {@カラム} 解析データを管理、収集する 雛形レイアウト管理クラスです。 POIのHSSFListener などで、雛形情報を収集し、HSSFSheet などで、雛形情報のアドレス(行列)から 必要な情報を取得し、このオブジェクトに設定しておきます。 EXCELシート毎に、INSERT文と、対応する文字列配列を取り出します。
    変更履歴:
    3.8.0.0 (2005/06/07) 新規追加
    機能分類
    帳票システム
    バージョン
    4.0
    作成者
    Kazuhiko Hasegawa
    導入されたバージョン:
    JDK5.0,
    • コンストラクタの詳細

      • ExcelLayout

        public ExcelLayout​(int sheetSize)
        コンストラクター 雛形の最大シート数を設定します。 ここでは、連番で管理している為、その雛形シート番号が処理対象外であっても、 雛形EXCEL上に存在するシート数を設定する必要があります。 具体的には、HSSFListener#processRecord( Record )で、BoundSheetRecord.sid の イベントの数を数えて設定します。
        パラメータ:
        sheetSize - 最大シート数
    • メソッドの詳細

      • addModel

        public void addModel​(int sheetNo,
                             String key,
                             int rowNo,
                             short colNo)
        雛形EXCELの {@カラム} 解析情報を設定します。 雛形EXCELは、HSSFListener を使用して、イベント駆動で取得します。その場合、 {@カラム}を含むセルを見つける都度、このメソッドを呼び出して、{@カラム}の 位置(行列番号)を設定します。 データEXCELからデータを読み出す場合は、ここで登録したカラムの行列より、読み込みます。 具体的には、HSSFListener#processRecord( Record )で、SSTRecord.sid の 情報をキープしておき、 LabelSSTRecord.sid 毎に、{@カラム}を含むかチェックし、含む場合に、このメソッドに 解析情報を設定します。
        パラメータ:
        sheetNo - シート番号
        key - 処理カラム
        rowNo - 行番号
        colNo - 列番号
      • getLayoutDataIterator

        public Iterator<ExcelLayoutData> getLayoutDataIterator​(int sheetNo,
                                                               String loopClm)
        雛形EXCELの {@カラム} 解析情報(ExcelLayoutData)を配列で取得します。 雛形EXCELは、イベント処理で取り込む為、すべての処理が終了してから、このメソッドで 処理結果を取り出す必要があります。 解析情報は、ExcelLayoutData オブジェクトにシート単位に保管されています。 この ExcelLayoutData オブジェクト ひとつに、{@カラム} ひとつ、つまり、 ある特定の行列番号を持っています。 データEXCELを読取る場合、この ExcelLayoutData配列から、行列情報を取り出し、 addData メソッドで、キー情報と関連付けて登録する為に、使用します。
        パラメータ:
        sheetNo - シート番号
        loopClm - 繰返必須カラム(なければ通常の1対1処理)
        戻り値:
        ExcelLayoutData配列
      • addData

        public void addData​(String clm,
                            int edbn,
                            String value)
        解析情報(clm,edbn)と関連付けて、データEXCELの値を設定します。 データEXCELは、雛形EXCELの解析情報を元に、行列番号から設定値を取り出します。 その設定値は、取りだした ExcelLayoutData の clm,edbn と関連付けて、このメソッドで登録します。 この処理は、シート毎に、初期化して使う必要があります。 初期化メソッドする場合は、dataClear() を呼び出してください。
        パラメータ:
        clm - カラム名
        edbn - 枝番
        value - データ値
        変更履歴:
        6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
      • dataClear

        public void dataClear()
        データEXCELの設定情報を初期化します。 データEXCELと、雛形EXCELの解析情報を関連付ける処理は、シート毎に行う必要があります。 処理終了時(シート切り替え時)このメソッドを呼び出して、初期化しておく必要があります
      • getHeaderInsertQuery

        public String getHeaderInsertQuery​(String table)
        ヘッダー情報のINSERT用Query文字列を取得します。 シート単位に、データEXCELより、INSERT用のQuery文字列を作成します。 この、Query は、シート単位に登録したキー情報の最大数(使用されているすべてのキー)を 元に、PreparedStatement で処理できる形の INSERT文を作成します。 シート単位に呼び出す必要があります。
        パラメータ:
        table - ヘッダー情報を登録するデータベース名(HEADERDBID)
        戻り値:
        ヘッダー情報のINSERT用Query文字列
      • getBodyInsertQuery

        public String getBodyInsertQuery​(String table)
        ボディ(明細)情報のINSERT用Query文字列を取得します。 シート単位に、データEXCELより、INSERT用のQuery文字列を作成します。 この、Query は、シート単位に登録したキー情報の最大数(使用されているすべてのキー)を 元に、PreparedStatement で処理できる形の INSERT文を作成します。 シート単位に呼び出す必要があります。
        パラメータ:
        table - ボディ(明細)情報を登録するデータベース名(BODYDBID)
        戻り値:
        ボディ(明細)情報のINSERT用Query文字列
      • getHeaderInsertData

        public String[] getHeaderInsertData​(String systemId,
                                            int ykno,
                                            int sheetNo)
        ヘッダー情報のINSERT用Queryに対応する、データ配列を取得します。 getHeaderInsertQuery( String ) で取りだした PreparedStatement に設定する値配列です。 シート単位に呼び出す必要があります。
        パラメータ:
        systemId - システムID(SYSTEM_ID)
        ykno - 要求番号(YKNO)
        sheetNo - 登録するデータEXCELのシート番号(SHEETNO)
        戻り値:
        データ配列
        このメソッドは、nullを返しません
      • getBodyInsertData

        public List<String[]> getBodyInsertData​(String systemId,
                                                int ykno,
                                                int sheetNo)
        ボディ(明細)情報のINSERT用Queryに対応する、データ配列のリスト(String[] のList)を取得します。 getHeaderInsertQuery( String ) で取りだした PreparedStatement に設定する値配列です。 シート単位に呼び出す必要があります。
        パラメータ:
        systemId - システムID(SYSTEM_ID)
        ykno - 要求番号(YKNO)
        sheetNo - 登録するデータEXCELのシート番号(SHEETNO)
        戻り値:
        データ配列のリスト