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シートの {@カラム} 解析データを管理、収集する 雛形レイアウト管理クラスです。
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 繰返必須カラム(なければ通常の1対1処理)
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 * 通常は、雛形とデータは1対1の関係で、雛形より多いデータは、読み取りませんし、
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;    // 行番号の増加数(段組などの場合は、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でない場合、枝番が0のカラムを繰り返します。
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(ヘッダ)と、0のデータのみを使用する。枝番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}