    001/*
    002 * Copyright (c) 2009 The openGion Project.
    003 *
    004 * Licensed under the Apache License, Version 2.0 (the "License");
    005 * you may not use this file except in compliance with the License.
    006 * You may obtain a copy of the License at
    007 *
    008 *     http://www.apache.org/licenses/LICENSE-2.0
    009 *
    010 * Unless required by applicable law or agreed to in writing, software
    011 * distributed under the License is distributed on an "AS IS" BASIS,
    012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
    013 * either express or implied. See the License for the specific language
    014 * governing permissions and limitations under the License.
    015 */
    016package org.opengion.hayabusa.report;
    017
    018import org.opengion.fukurou.system.OgRuntimeException ;         // 6.4.2.0 (2016/01/29)
    019import org.opengion.hayabusa.common.HybsSystemException;
    020import static org.opengion.fukurou.system.HybsConst.BUFFER_MIDDLE;      // 6.1.0.0 (2014/12/26) refactoring
    021
    022import java.util.Map;
    023import java.util.HashMap;
    024import java.util.List;
    025import java.util.ArrayList;
    026import java.util.Iterator ;
    027import java.util.NoSuchElementException;
    028import java.util.Arrays ;
    029
    030/**
    031 * 【EXCEL取込】雛形EXCELシートの {&#064;カラム} 解析データを管理、収集する 雛形レイアウト管理クラスです。
    032 * POIのHSSFListener などで、雛形情報を収集し、HSSFSheet などで、雛形情報のアドレス(行列)から
    033 * 必要な情報を取得し、このオブジェクトに設定しておきます。
    034 * EXCELシート毎に、INSERT文と、対応する文字列配列を取り出します。
    035 *
    036 * @og.rev 3.8.0.0 (2005/06/07) 新規追加
    037 * @og.group 帳票システム
    038 *
    039 * @version  4.0
    040 * @author   Kazuhiko Hasegawa
    041 * @since    JDK5.0,
    042 */
    043public class ExcelLayout {
    044
    045        /** 6.4.3.1 (2016/02/12) キー、値の null 許可のロジックを見直すまで、ConcurrentHashMap に置き換えできません。  */
    046        private final Map<String,String> headMap  = new HashMap<>();    // シート単位のヘッダーキーを格納します。
    047        /** 6.4.3.1 (2016/02/12) キー、値の null 許可のロジックを見直すまで、ConcurrentHashMap に置き換えできません。  */
    048        private final Map<String,String> bodyMap  = new HashMap<>();    // シート単位のボディーキーを格納します。
    049        /** 6.4.3.1 (2016/02/12) キー、値の null 許可のロジックを見直すまで、ConcurrentHashMap に置き換えできません。  */
    050        private final Map<Integer,Map<String,String>> dataMap  = new HashMap<>();       // シート単位のデータを格納するMapを格納します。(キーは、GEEDNO)
    051
    052        private final List<ExcelLayoutData>[] model  ;  // シート毎にExcelLayoutDataが格納されます。
    053
    054        private String loopClm  ;                                               // 繰返必須カラム(なければnull))
    055        private ExcelLayoutDataIterator iterator        ;       // ExcelLayoutData を返す、Iterator
    056
    057        /**
    058         * コンストラクター
    059         *
    060         * 雛形の最大シート数を設定します。
    061         * ここでは、連番で管理している為、その雛形シート番号が処理対象外であっても、
    062         * 雛形EXCEL上に存在するシート数を設定する必要があります。
    063         * 具体的には、HSSFListener#processRecord( Record )で、BoundSheetRecord.sid の
    064         * イベントの数を数えて設定します。
    065         *
    066         * @param       sheetSize       最大シート数
    067         */
    068        @SuppressWarnings(value={"unchecked","rawtypes"})
    069        public ExcelLayout( final int sheetSize ) {
    070                model = new ArrayList[sheetSize];
    071                for( int i=0; i<sheetSize; i++ ) {
    072                        model[i] = new ArrayList<>();
    073                }
    074        }
    075
    076        /**
    077         * 雛形EXCELの {&#064;カラム} 解析情報を設定します。
    078         *
    079         * 雛形EXCELは、HSSFListener を使用して、イベント駆動で取得します。その場合、
    080         * {&#064;カラム}を含むセルを見つける都度、このメソッドを呼び出して、{&#064;カラム}の
    081         * 位置(行列番号)を設定します。
    082         * データEXCELからデータを読み出す場合は、ここで登録したカラムの行列より、読み込みます。
    083         * 具体的には、HSSFListener#processRecord( Record )で、SSTRecord.sid の 情報をキープしておき、
    084         * LabelSSTRecord.sid 毎に、{&#064;カラム}を含むかチェックし、含む場合に、このメソッドに
    085         * 解析情報を設定します。
    086         *
    087         * @param       sheetNo シート番号
    088         * @param       key             処理カラム
    089         * @param       rowNo   行番号
    090         * @param       colNo   列番号
    091         */
    092        public void addModel( final int sheetNo, final String key, final int rowNo, final short colNo ) {
    093                model[sheetNo].add( new ExcelLayoutData( key,rowNo,colNo ) );
    094        }
    095
    096        /**
    097         * 雛形EXCELの {&#064;カラム} 解析情報(ExcelLayoutData)を配列で取得します。
    098         *
    099         * 雛形EXCELは、イベント処理で取り込む為、すべての処理が終了してから、このメソッドで
    100         * 処理結果を取り出す必要があります。
    101         * 解析情報は、ExcelLayoutData オブジェクトにシート単位に保管されています。
    102         * この ExcelLayoutData オブジェクト ひとつに、{&#064;カラム} ひとつ、つまり、
    103         * ある特定の行列番号を持っています。
    104         * データEXCELを読取る場合、この ExcelLayoutData配列から、行列情報を取り出し、
    105         * addData メソッドで、キー情報と関連付けて登録する為に、使用します。
    106         *
    107         * @param       sheetNo シート番号
    108         * @param       loopClm 繰返必須カラム(なければ通常の１対１処理)
    109         *
    110         * @return      ExcelLayoutData配列
    111         */
    112        public Iterator<ExcelLayoutData> getLayoutDataIterator( final int sheetNo, final String loopClm ) {
    113                this.loopClm = loopClm ;
    114                final ExcelLayoutData[] datas = model[sheetNo].toArray( new ExcelLayoutData[model[sheetNo].size()] );
    115                iterator = new ExcelLayoutDataIterator( datas,loopClm );
    116                return iterator ;
    117        }
    118
    119        /**
    120         * 解析情報(clm,edbn)と関連付けて、データEXCELの値を設定します。
    121         *
    122         * データEXCELは、雛形EXCELの解析情報を元に、行列番号から設定値を取り出します。
    123         * その設定値は、取りだした ExcelLayoutData の clm,edbn と関連付けて、このメソッドで登録します。
    124         * この処理は、シート毎に、初期化して使う必要があります。
    125         * 初期化メソッドする場合は、dataClear() を呼び出してください。
    126         *
    127         * @og.rev 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
    128         *
    129         * @param       clm             カラム名
    130         * @param       edbn    枝番
    131         * @param       value   データ値
    132         */
    133        public void addData( final String clm, final int edbn, final String value ) {
    134                if( loopClm != null && loopClm.equals( clm ) && edbn >= 0 && ( value == null || value.isEmpty() ) ) {
    135                        // 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
    136                        if( iterator == null ) {
    137                                final String errMsg = "#getLayoutDataIterator(int,String)を先に実行しておいてください。" ;
    138                                throw new OgRuntimeException( errMsg );
    139                        }
    140
    141                        iterator.setEnd();
    142                        final Integer edbnObj = Integer.valueOf( edbn );
    143                        dataMap.remove( edbnObj );              // 枝番単位のMapを削除
    144                        return ;
    145                }
    146
    147                final Integer edbnObj = Integer.valueOf( edbn );
    148                Map<String,String> map = dataMap.get( edbnObj );                // 枝番単位のMapを取得
    149                if( map == null ) { map = new HashMap<>(); }
    150                map.put( clm,value );                           // 枝番に含まれるキーと値をセット
    151                dataMap.put( edbnObj,map );                     // そのMapを枝番に登録
    152
    153                if( edbn < 0 ) {
    154                        headMap.put( clm,null );
    155                }
    156                else {
    157                        bodyMap.put( clm,null );
    158                }
    159        }
    160
    161        /**
    162         * データEXCELの設定情報を初期化します。
    163         *
    164         * データEXCELと、雛形EXCELの解析情報を関連付ける処理は、シート毎に行う必要があります。
    165         * 処理終了時(シート切り替え時)このメソッドを呼び出して、初期化しておく必要があります
    166         *
    167         */
    168        public void dataClear() {
    169                dataMap.clear();
    170                headMap.clear();
    171                bodyMap.clear();
    172        }
    173
    174        /**
    175         * ヘッダー情報のINSERT用Query文字列を取得します。
    176         *
    177         * シート単位に、データEXCELより、INSERT用のQuery文字列を作成します。
    178         * この、Query は、シート単位に登録したキー情報の最大数(使用されているすべてのキー)を
    179         * 元に、PreparedStatement で処理できる形の INSERT文を作成します。
    180         * シート単位に呼び出す必要があります。
    181         *
    182         * @param       table   ヘッダー情報を登録するデータベース名(HEADERDBID)
    183         *
    184         * @return      ヘッダー情報のINSERT用Query文字列
    185         */
    186        public String getHeaderInsertQuery( final String table ) {
    187                // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
    188                return table == null || table.isEmpty() || headMap.isEmpty() ? null : makeQuery( table,headMap );
    189
    190        }
    191
    192        /**
    193         * ボディ(明細)情報のINSERT用Query文字列を取得します。
    194         *
    195         * シート単位に、データEXCELより、INSERT用のQuery文字列を作成します。
    196         * この、Query は、シート単位に登録したキー情報の最大数(使用されているすべてのキー)を
    197         * 元に、PreparedStatement で処理できる形の INSERT文を作成します。
    198         * シート単位に呼び出す必要があります。
    199         *
    200         * @param       table   ボディ(明細)情報を登録するデータベース名(BODYDBID)
    201         *
    202         * @return      ボディ(明細)情報のINSERT用Query文字列
    203         */
    204        public String getBodyInsertQuery( final String table ) {
    205                // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
    206                return table == null || table.isEmpty() || bodyMap.isEmpty() ? null : makeQuery( table,bodyMap );
    207
    208        }
    209
    210        /**
    211         * ヘッダー情報のINSERT用Queryに対応する、データ配列を取得します。
    212         *
    213         * getHeaderInsertQuery( String ) で取りだした PreparedStatement に設定する値配列です。
    214         * シート単位に呼び出す必要があります。
    215         *
    216         * @param       systemId        システムID(SYSTEM_ID)
    217         * @param       ykno    要求番号(YKNO)
    218         * @param       sheetNo 登録するデータEXCELのシート番号(SHEETNO)
    219         *
    220         * @return      データ配列
    221         * @og.rtnNotNull
    222         */
    223        public String[] getHeaderInsertData( final String systemId,final int ykno,final int sheetNo ) {
    224                final String[] keys = headMap.keySet().toArray( new String[headMap.size()] );
    225                if( keys == null || keys.length == 0 ) { return new String[0]; }
    226
    227                final Integer edbnObj = Integer.valueOf( -1 );          // ヘッダー
    228                final Map<String,String> map = dataMap.get( edbnObj );
    229                if( map == null ) { return new String[0]; }
    230
    231                String[] rtnData = new String[keys.length+4];
    232
    233                rtnData[0] = systemId;
    234                rtnData[1] = String.valueOf( ykno );
    235                rtnData[2] = String.valueOf( sheetNo );
    236                rtnData[3] = String.valueOf( -1 );              // 枝番
    237
    238                for( int i=0; i<keys.length; i++ ) {
    239                        rtnData[i+4] = map.get( keys[i] );
    240                }
    241
    242                return rtnData;
    243        }
    244
    245        /**
    246         * ボディ(明細)情報のINSERT用Queryに対応する、データ配列のリスト(String[] のList)を取得します。
    247         *
    248         * getHeaderInsertQuery( String ) で取りだした PreparedStatement に設定する値配列です。
    249         * シート単位に呼び出す必要があります。
    250         *
    251         * @param       systemId        システムID(SYSTEM_ID)
    252         * @param       ykno    要求番号(YKNO)
    253         * @param       sheetNo 登録するデータEXCELのシート番号(SHEETNO)
    254         *
    255         * @return      データ配列のリスト
    256         */
    257        public List<String[]> getBodyInsertData( final String systemId,final int ykno,final int sheetNo ) {
    258                final String[] keys = bodyMap.keySet().toArray( new String[bodyMap.size()] );
    259                if( keys == null || keys.length == 0 ) { return null; }
    260
    261                final List<String[]> rtnList = new ArrayList<>();
    262
    263                final Integer[] edbnObjs = dataMap.keySet().toArray( new Integer[dataMap.size()] );
    264                for( int i=0; i<edbnObjs.length; i++ ) {
    265                        final int edbn = edbnObjs[i].intValue();
    266                        if( edbn < 0 ) { continue; }            // ヘッダーの場合は、読み直し
    267
    268                        String[] rtnData = new String[keys.length+4];   // 毎回、新規に作成する。
    269                        rtnData[0] = systemId;
    270                        rtnData[1] = String.valueOf( ykno );
    271                        rtnData[2] = String.valueOf( sheetNo );
    272                        rtnData[3] = String.valueOf( edbn );    // 枝番
    273
    274                        final Map<String,String> map = dataMap.get( edbnObjs[i] );
    275                        for( int j=0; j<keys.length; j++ ) {
    276                                rtnData[j+4] = map.get( keys[j] );
    277                        }
    278                        rtnList.add( rtnData );
    279                }
    280
    281                return rtnList;
    282        }
    283
    284        /**
    285         * 内部情報Mapより、INSERT用Query文字列を取得します。
    286         *
    287         * シート単位に、データEXCELより、INSERT用のQuery文字列を作成します。
    288         * この、Query は、シート単位に登録したキー情報の最大数(使用されているすべてのキー)を
    289         * 元に、PreparedStatement で処理できる形の INSERT文を作成します。
    290         * シート単位に呼び出す必要があります。
    291         *
    292         * @param       table   テーブル名
    293         * @param       map             ボディ(明細)情報を登録する内部情報Map
    294         *
    295         * @return      INSERT用Query文字列
    296         */
    297        private String makeQuery( final String table,final Map<String,String> map ) {
    298                final String[] keys = map.keySet().toArray( new String[map.size()] );
    299
    300                if( keys == null || keys.length == 0 ) { return null; }
    301
    302                final StringBuilder buf1 = new StringBuilder( BUFFER_MIDDLE )
    303                        .append( "INSERT INTO " ).append( table )
    304                        .append( " ( GESYSTEM_ID,GEYKNO,GESHEETNO,GEEDNO" );
    305
    306                final StringBuilder buf2 = new StringBuilder( BUFFER_MIDDLE )
    307                        .append( " ) VALUES (?,?,?,?" );
    308
    309                for( int i=0; i<keys.length; i++ ) {
    310                        buf1.append( ',' ).append( keys[i] );           // 6.0.2.5 (2014/10/31) char を append する。
    311                        buf2.append( ",?" );
    312                }
    313                buf2.append( ')' );                                                             // 6.0.2.5 (2014/10/31) char を append する。
    314                buf1.append( buf2 );
    315
    316                return buf1.toString();
    317        }
    318}
    319
    320/**
    321 * ExcelLayoutData (雛形解析結果)のシート毎のIteratorを返します。
    322 * ExcelLayout では、データEXCELは、シート毎に解析します。
    323 * 通常は、雛形とデータは１対１の関係で、雛形より多いデータは、読み取りませんし、
    324 * 少ないデータは、NULL値でデータ登録します。
    325 * ここで、繰返必須カラム(LOOPCLM)を指定することで、指定のカラムが必須であることを利用して、
    326 * データが少ない場合は、そこまでで処理を中止して、データが多い場合は、仮想的にカラムが
    327 * 存在すると仮定して、雛形に存在しない箇所のデータを読み取れるように、Iterator を返します。
    328 * データがオーバーする場合は、仮想的にカラムの存在するアドレスを求める必要があるため、
    329 * 最低 カラム_0 と カラム_1 が必要です。さらに、各カラムは、行方向に並んでおり、
    330 * 列方向は、同一であるという前提で、読み取るべき行列番号を作成します。
    331 *
    332 * @og.rev 3.8.0.0 (2005/06/07) 新規追加
    333 * @og.group 帳票システム
    334 *
    335 * @version  4.0
    336 * @author   Kazuhiko Hasegawa
    337 * @since    JDK5.0,
    338 */
    339class ExcelLayoutDataIterator implements Iterator<ExcelLayoutData> {
    340        private final ExcelLayoutData[] layoutDatas ;
    341        private final String    loopClm ;
    342        private int             incSize = 1;    // 行番号の増加数(段組などの場合は、１以上となる)
    343        private int             count   ;               // 現在処理中の行番号
    344        private int             edbnCnt ;               // 処理中の枝番に相当するカウント値
    345        private int             stAdrs  = -1;   // 繰返し処理を行う開始アドレス
    346        private int             edAdrs  = -1;   // 繰返し処理を行う終了アドレス
    347
    348        /**
    349         * ExcelLayoutData の配列を受け取って、初期情報を設定します。
    350         *
    351         * 繰返必須カラム(LOOPCLM)がnullでない場合、枝番が０のカラムを繰り返します。
    352         * 繰り返す場合、行番号と枝番を指定して、既存のExcelLayoutDataオブジェクトを作成し、
    353         * 仮想的に繰返します。
    354         *
    355         * ※ 設定する ExcelLayoutData の配列 は、そのまま、内部配列に設定されます。(コピーされません)
    356         *    よって、外部からパラメータに指定した ExcelLayoutData の配列を変更した場合の動作は保証されません。
    357         *    また、受け取った配列は、ExcelLayoutData の自然順序(枝番順)にソートされます。
    358         *
    359         * @param       datas   ExcelLayoutDataの配列
    360         * @param       lpClm   繰返必須カラム(LOOPCLM)
    361         */
    362        public ExcelLayoutDataIterator( final ExcelLayoutData[] datas,final String lpClm ) {
    363                layoutDatas = datas;
    364                loopClm     = lpClm;
    365
    366                final int size    = layoutDatas.length;         // 配列の最大値
    367
    368                Arrays.sort( layoutDatas );             // 枝番順にソートされます。
    369                // loopClm を使う場合は、枝番 -1(ヘッダ)と、０のデータのみを使用する。枝番１は、増加数の取得のみに用いる。
    370                if( loopClm != null ) {
    371                        int zeroRow = -1;
    372                        for( int i=0; i<size; i++ ) {
    373                                // System.out.println( "count=" + i + ":" + layoutDatas[i] );
    374                                final int edbn = layoutDatas[i].getEdbn();
    375                                if( stAdrs < 0 && edbn == 0 ) { stAdrs = i; }   // 初の枝番0アドレス＝開始(含む)
    376                                if( edAdrs < 0 && edbn == 1 ) { edAdrs = i; }   // 初の枝番1アドレス＝終了(含まない)
    377                                if( loopClm.equals( layoutDatas[i].getClm() ) ) {
    378                                        if( edbn == 0 ) {
    379                                                zeroRow = layoutDatas[i].getRowNo();    // loopClm の枝番0 の行番号
    380                                        }
    381                                        else if( edbn == 1 ) {
    382                                                incSize = layoutDatas[i].getRowNo() - zeroRow;  // 増加数=枝番1-枝番0
    383                                                break;
    384                                        }
    385                                }
    386                        }
    387                        // 繰返がある場合(枝番が0以上)でloopClmが見つからない場合はエラー
    388                        if( zeroRow < 0 && stAdrs >= 0 ) {
    389                                final String errMsg = "繰返必須カラムがシート中に存在しません。[" + loopClm + "]";
    390                                throw new HybsSystemException( errMsg );
    391                        }
    392                }
    393                if( stAdrs < 0 ) { stAdrs = 0; }        // 開始(含む)
    394                if( edAdrs < 0 ) { edAdrs = size; }     // 終了(含まない)
    395        //      System.out.println( "stAdrs=" + stAdrs + " , edAdrs=" + edAdrs  );
    396        }
    397
    398        /**
    399         * 繰り返し処理でさらに要素がある場合に true を返します。
    400         * つまり、next が例外をスローしないで要素を返す場合に true を返します。
    401         *
    402         * @return      反復子がさらに要素を持つ場合は true
    403         */
    404        public boolean hasNext() {
    405                if( loopClm != null && count == edAdrs ) {
    406                        count = stAdrs;
    407                        edbnCnt++;
    408                }
    409        //      System.out.print( "count=[" + count + "]:" );
    410                return count < edAdrs ;
    411        }
    412
    413        /**
    414         * 繰り返し処理で次の要素を返します。
    415         *
    416         * @return 繰り返し処理で次の要素
    417         * @throws NoSuchElementException 繰り返し処理でそれ以上要素がない場合
    418         */
    419        public ExcelLayoutData next() throws NoSuchElementException {
    420                if( layoutDatas == null || layoutDatas.length == count ) {
    421                        final String errMsg = "行番号がレイアウトデータをオーバーしました。" +
    422                                                " 行番号=[" + count + "]" ;
    423                        throw new NoSuchElementException( errMsg );
    424                }
    425
    426                ExcelLayoutData data = layoutDatas[count++];
    427
    428                if( edbnCnt > 0 ) {     // 繰返必須項目機能が働いているケース
    429                        final int rowNo = data.getRowNo() + edbnCnt * incSize ;
    430                        data = data.copy( rowNo,edbnCnt );
    431        //              System.out.println( "row,edbn=[" + rowNo + "," + edbnCnt + "]:" + data );
    432                }
    433
    434                return data;
    435        }
    436
    437        /**
    438         * このメソッドは、このクラスからは使用できません。
    439         * ※ このクラスでは実装されていません。
    440         * このメソッドでは、必ず、UnsupportedOperationException が、throw されます。
    441         */
    442        public void remove() {
    443                final String errMsg = "このメソッドは、このクラスからは使用できません。";
    444                throw new UnsupportedOperationException( errMsg );
    445        }
    446
    447        /**
    448         * 繰返し処理を終了させます。
    449         *
    450         */
    451        public void setEnd() {
    452                edAdrs = -1;
    453        }
    454}