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.fukurou.model;
017
018import org.opengion.fukurou.system.OgRuntimeException;                                                  // 6.4.2.0 (2016/01/29)
019import org.opengion.fukurou.util.StringUtil;                                                                    // 6.2.0.0 (2015/02/27)
020import org.opengion.fukurou.util.FileInfo;                                                                              // 6.2.0.0 (2015/02/27)
021
022import java.util.List;
023import java.util.ArrayList;
024import java.util.Map;                                                                                                                   // 6.1.0.0 (2014/12/26) ConstData を Mapで管理
025import java.util.HashMap;                                                                                                               // 6.1.0.0 (2014/12/26) ConstData を Mapで管理
026import java.util.Arrays;                                                                                                                // 6.2.0.0 (2015/02/27)
027import java.io.File;                                                                                                                    // 6.2.0.0 (2015/02/27)
028
029/**
030 * EXCELやテキストファイルを、イベント方式に準拠して、読み込み処理を行います。
031 * TableModelHelperイベントは、openGion形式のファイル読み取りに準拠した方法をサポートします。
032 * ※ openGion形式のEXCEL/テキストファイルとは、#NAME 列に、カラム名があり、#で始まる
033 *    レコードは、コメントとして判断し、読み飛ばす処理の事です。
034 *
035 * このイベントクラスは、サブクラスを作成し、EXCEL関連の EventReader_XLS、EventReader_XLSX
036 * クラスや、EventReader_TEXT などのテキスト関連のクラスで、eventReader メソッドの引数に指定します。
037 * EventReader_XLS と、EventReader_XLSX は、対象のEXCEL形式が異なりますが、実際は、
038 * POIUtil#eventReader( String , TableModelHelper ) を使用すれば、拡張子に応じて使用するクラスを
039 * 選択します。
040 *
041 * @og.rev 6.0.3.0 (2014/11/13) 新規作成
042 * @og.rev 6.2.0.0 (2015/02/27) パッケージ変更(util → model),クラス名変更(ExcelReaderEvent → TableModelHelper)
043 * @og.group ファイル入力
044 *
045 * @version     6.0
046 * @author      Kazuhiko Hasegawa
047 * @since       JDK7.0,
048 */
049public class TableModelHelper {
050        private int                             nowRowNo        = -1;                                                                   // 現在の行番号
051        private boolean                 isColSkip       ;                                                                               // カラムスキップ中かどうか(true:スキップ中)
052        private boolean                 isNowName       ;                                                                               // カラム名配列の収集中かどうか(true:収集中)
053        private boolean                 isReadBreak     ;                                                                               // 読み取り処理を途中で中止するかどうか(true:中止)
054        private String                  nullBreakClm;                                                                           // データがnullまたはゼロ文字列の場合に、Sheet読み取りを停止
055        private String                  nullSkipClm     ;                                                                               // 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加
056
057        private int                             skipRowCnt      ;                                                                               // 読み飛ばす行数(読み飛ばし中でも ContDataは取得する)
058        private int                             nBrkClmNo = -1;                                                                         // nullBreakClmの列番号
059        private int                             nSkpClmNo = -1;                                                                         // 6.2.3.0 (2015/05/01) nullSkipClmの列番号
060
061        private int                             clmSize = -1 ;                                                                          // カラムサイズ(-1は未設定)
062        private String[]                names           ;                                                                               // カラム名配列
063        private int[]                   colms           ;                                                                               // カラム番号配列 7.3.1.3 (2021/03/09) colList をテンポラリにするため
064        private String[]                vals            ;                                                                               // 値の文字列配列(1行分)
065        private boolean                 useVals         ;                                                                               // 値配列に設定されたか?
066
067        private List<Integer>   colList ;                                                                                       // カラム番号:name が null かゼロ文字列の場合は、飛ばします。
068        private List<String>    nmsList ;                                                                                       // カラム番号に対応したカラム名配列(#NAMEの場合のみ使用)
069
070        private ConstData               cnstData        ;
071
072        private boolean                 useDebug        ;                                                                                       // 6.2.0.0 (2015/02/27) デバッグ情報の出力するかどうか。新規追加
073
074        /**
075         * デフォルトコンストラクター
076         *
077         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
078         */
079        public TableModelHelper() { super(); }          // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
080
081        /**
082         * ファイルの読み取り開始時にイベントが発生します。
083         *
084         * 新しいファイルの読み取り開始毎に、1回呼ばれます。
085         * 戻り値が、true の場合は、そのファイルの読み取りを継続します。
086         * false の場合は、そのファイルの読み取りは行われません。
087         * 初期実装では、固定値設定処理を行っていますので、オーバーライドする場合は、
088         * super.startFile(String,int) してください。
089         * 初期実装では、true を返します。
090         *
091         * @og.rev 6.2.0.0 (2015/02/27) 新規作成
092         *
093         * @param       file    読み取りファイル
094         * @return      読取継続するか [true:継続/false:読取らない]
095         */
096        public boolean startFile( final File file ) {
097                if( useDebug ) { System.out.println( "startFile=[" + file + "]" ); }
098                // ファイル属性を設定する。
099                if( cnstData != null ) { cnstData.putConstFile( file ); }
100                return true;
101        }
102
103        /**
104         * ファイルの読み取り終了時にイベントが発生します。
105         *
106         * 初期実装では、固定値設定処理を行っていますので、オーバーライドする場合は、
107         * super.endFile(File) してください。
108         *
109         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
110         * @og.rev 6.1.0.0 (2014/12/26) シートブレイク処理追加
111         *
112         * @param       file    読み取りファイル
113         */
114        public void endFile( final File file ) {
115                if( useDebug ) { System.out.println( "endFile=[" + file + "]" ); }
116                isReadBreak = false;                    // 読み取り再開
117                endRow();                                               // 行終了処理
118                if( cnstData != null ) { cnstData.clearValsMap( ConstData.END_FILE ); }
119        }
120
121        /**
122         * シートの読み取り開始時にイベントが発生します。
123         *
124         * ※ EXCEL関係以外の読み取りでは、このイベントは発生しません。
125         *
126         * 新しいシートの読み取り開始毎に、1回呼ばれます。
127         * 戻り値が、true の場合は、そのシートの読み取りを継続します。
128         * false の場合は、そのシートの読み取りは行わず、次のシートまで
129         * イベントは発行されません。
130         * 初期実装では、固定値設定処理を行っていますので、オーバーライドする場合は、
131         * super.startSheet(String,int) してください。
132         * 初期実装では、true を返します。
133         *
134         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
135         *
136         * @param       shtNm   シート名
137         * @param       shtNo   シート番号(0~)
138         * @return      読取継続するか [true:継続/false:読取らない]
139         */
140        public boolean startSheet( final String shtNm,final int shtNo ) {
141                if( useDebug ) { System.out.println( "startSheet=[" + shtNm + "], No=[" + shtNo + "]" ); }
142                // シート名を設定する。
143                if( cnstData != null ) { cnstData.putConstSheet( shtNm ); }
144                return true;
145        }
146
147        /**
148         * シートの読み取り終了時にイベントが発生します。
149         *
150         * ※ EXCEL関係以外の読み取りでは、このイベントは発生しません。
151         *
152         * #columnNames( String[] ) や、#values( String[] ,int ) などは、行の処理が完了した時点で
153         * イベントが呼ばれるため、一番最後のレコードの終了条件が判りません。
154         * そこで、このイベントを呼ぶことで、シートの終了(=最終行の終了)処理を行うことができます。
155         *
156         * 引数のシート番号は、参考情報で、#startSheet( String,int ) で呼ばれたシート番号と
157         * 比較できるようにしています。
158         * 初期実装では、固定値設定処理を行っていますので、オーバーライドする場合は、
159         * super.endSheet(int) してください。
160         *
161         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
162         * @og.rev 6.1.0.0 (2014/12/26) シートブレイク処理追加
163         *
164         * @param       shtNo   シート番号(0~)
165         */
166        public void endSheet( final int shtNo ) {
167                if( useDebug ) { System.out.println( "endSheet No=[" + shtNo + "]" ); }
168                isReadBreak = false;                    // 読み取り再開
169                endRow();                                               // 行終了処理
170                if( cnstData != null ) { cnstData.clearValsMap( ConstData.END_SHEET ); }
171        }
172
173        /**
174         * 読み取り状態の時に、rowNo にある行データを引数にイベントが発生します。
175         *
176         * ※ 主に、行データの読み込み処理で使用されるメソッドです。
177         *    このメソッドは、EventReader#eventReader( String , TableModelHelper )メソッドの
178         *    処理の過程で、設定されます。
179         *    このメソッドから、各種イベントが発行されます。
180         *
181         * 行データをセパレータで分解したのち、value( String ,int ,int ) メソッドを呼びます。
182         * ただし、行データが、null、空文字列、#で始まる場合は、呼ばれません。
183         *
184         * @og.rev 6.2.0.0 (2015/02/27) 新規作成
185         * @og.rev 6.2.1.0 (2015/03/13) 先頭に、'0 が含まれる場合のセミコロンや、前後のダブルクオートは削除
186         * @og.rev 6.2.5.0 (2015/06/05) デバック時に1行単位に出力するのを止めます。
187         * @og.rev 7.1.0.0 (2020/01/27) セパレータ分割時にデータ分割されない場合は、エンコードエラーの可能性が高い。
188         * @og.rev 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得できるようにします。
189         * @og.rev 8.4.0.0 (2022/12/23) 7.1.0.0 (2020/01/27) の対応は、ReadTableTag に移動。
190         *
191         * @param       line    行データ
192         * @param       rowNo   行番号(0~)
193         * @param       sepa    セパレータ
194         */
195        protected void value( final String line,final int rowNo,final char sepa ) {
196                nowRowNo = rowNo;       // 現在行の設定
197
198                // 値が存在する場合のみ、処理する。
199                if( line!=null && !line.isEmpty() ) {
200                        // 6.2.5.0 (2015/06/05) デバック時に1行単位に出力するのを止めます。
201        //              if( useDebug ) { System.out.println( "rowNo[" + rowNo + "], line=[" + line + "]" ); }
202
203                        // 先頭カラムのコメント判断と、#NAME列判断
204                        if( line.charAt(0)=='#' ) {
205                                // 互換性の問題。#NAME は、大文字小文字両方対応できないといけない。( 5 == "#NAME".length() の事)
206                                // 7.3.1.3 (2021/03/09) #NAME があれば処理する。
207//                              if( clmSize <= 0 && line.length() >= 5 && "#NAME".equalsIgnoreCase( line.substring( 0,5 ) ) ) {
208                                if( line.length() >= 5 && "#NAME".equalsIgnoreCase( line.substring( 0,5 ) ) ) {
209                                        colList = new ArrayList<>() ;                                                           // 初期化
210                                        nmsList = new ArrayList<>() ;                                                           // 初期化
211                                        final String[] tmpNm = StringUtil.csv2Array( line,sepa );
212                                        for( int colNo=1; colNo<tmpNm.length; colNo++ ) {                       // #NAME を無視(colNo=1~)
213                                                final String nm = tmpNm[colNo];
214                                                // #NAME 設定も、null や、ゼロ文字列の場合は、登録しない。(一番上の if で対処)
215                                                if( nm != null && !nm.isEmpty() ) {
216                                                        colList.add( Integer.valueOf( colNo ) );
217                                                        nmsList.add( nm );
218                                                }
219                                        }
220                                        originalNames( nmsList.toArray( new String[nmsList.size()] ) ); // 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得
221                                        isNowName = true;
222                                }
223                        }
224                        // clmSize > 0 は、#NAME が設定済みという意味
225                        else if( clmSize > 0 && skipRowCnt <= rowNo ) {                                         // skipRowCnt は、値セットだけ影響する。
226                                final String[] tmpVals = StringUtil.csv2Array( line ,sepa );
227        //                      if( cnstData != null ) { tmpVals = cnstData.getConstVals( tmpVals ); }
228        //                      int min = Math.min( clmSize,tmpVals.length );
229
230                //              // 8.4.0.0 (2022/12/23) 7.1.0.0 (2020/01/27) の対応は、ReadTableTag に移動。
231                //              // 7.1.0.0 (2020/01/27) エンコードによってはエラーにならず1カラムのデータとして取れてしまう。
232                //              // カラム数が1以上で、データ数が1の場合は、取り込みミスなので処理を終了する。
233                //              if( clmSize > 1 && tmpVals.length == 1 ) {
234                //                      isReadBreak = true;                                                                                     // 処理の停止
235                //                      clmSize     = 0;                                                                                        // #NAME列未設定と同じ(-1にしないのは、単に初期値と違うという事)
236                //                      return ;                                                                                                        // 即抜ける
237                //              }
238
239                                for( int i=0; i<clmSize; i++ ) {
240//                                      final int indx = colList.get( i );                                                      // カラム番号の位置が 値配列の配列番号
241                                        final int indx = colms[i];                                                                      // 7.3.1.3 (2021/03/09) カラム番号の位置が 値配列の配列番号
242                                        if( indx >= 0 && indx < tmpVals.length ) {
243                                                vals[i] = StringUtil.csvOutQuote( tmpVals[indx] );              // 6.2.1.0 (2015/03/13)
244                                        }
245                                }
246                                useVals = true;
247        //                      values( vals , rowNo );                                                                                 // イベント発行(現在行)
248                        }
249
250                        endRow();                                                                                                                       // 行末処理実行。名前設定処理が走ります。
251                }
252        }
253
254        /**
255         * 読み取り状態の時に、rowNo,colNo にあるセルの値を引数にイベントが発生します。
256         *
257         * ※ 主に、EXCEL関係の読み取り処理で使用されるメソッドです。
258         *    このメソッドは、EventReader#eventReader( String , TableModelHelper )メソッドの
259         *    処理の過程で、設定されます。
260         *    このメソッドから、各種イベントが発行されます。
261         *
262         * 戻り値が、true の場合は、その行の読み取りを継続します。
263         * false の場合は、その行の読み取りは行わず、次の行まで
264         * イベントは発行されません。
265         *
266         * openGion での標準的な処理は、colNo==0 の時に、val の先頭が、# で
267         * 始まる場合は、その行はスキップします。
268         * ここでの return は、#isSkip( int ) と逆になりますので、ご注意ください。
269         * 初期実装では、#NAME処理、行スキップ、行終了処理等を実行します。
270         * オーバーライドする場合は、super.value(String,int,int) してください。
271         *
272         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
273         * @og.rev 6.2.2.0 (2015/03/27) 先頭に、'0 が含まれる場合のセミコロンや、前後のダブルクオートは削除
274         * @og.rev 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加
275         * @og.rev 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得できるようにします。
276         *
277         * @param       val             文字列値
278         * @param       rowNo   行番号(0~)
279         * @param       colNo   列番号(0~)
280         * @return      読み取りするかどうか(true:読み取りする/false:読み取りしない)
281         * @see         #isSkip( int )
282         */
283        protected boolean value( final String val,final int rowNo,final int colNo ) {
284        //      if( useDebug ) { System.out.println( "R[" + rowNo + "," + colNo + "]=" + val ); }
285
286                // 値が存在する場合のみ、処理する。
287                if( val!=null && val.length()>0 ) {
288                        // 行番号が異なった場合は、行の終了処理を実行する。
289                        if( nowRowNo != rowNo ) {
290                                if( isNowName ) {                                                                                               // 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得
291                                        originalNames( nmsList.toArray( new String[nmsList.size()] ) );
292                                }
293
294                                endRow();                                                                                                               // 行終了処理
295                                nowRowNo = rowNo;                                                                                               // 現在行の設定
296                        }
297
298                        // 固定文字の設定なので、コメントもスキップも無関係
299                        if( cnstData != null ) { cnstData.putConstValue( val,rowNo,colNo ); }
300
301                        // 先頭カラムのコメント判断と、#NAME列判断
302                        if( colNo==0 && val.charAt(0)=='#' ) {
303//                              if( "#NAME".equalsIgnoreCase( val ) && clmSize <= 0 ) {                 // clmSize <= 0 は、#NAME未設定という意味
304                                // 7.3.1.3 (2021/03/09) #NAME があれば処理する
305                                if( "#NAME".equalsIgnoreCase( val )) {
306                                        isNowName = true ;
307                                        colList = new ArrayList<>() ;                                                           // 初期化
308                                        nmsList = new ArrayList<>() ;                                                           // 初期化
309                                }
310                                isColSkip = !isNowName;                                                                                 // #NAME の場合は、false(SKIPしない)
311                        }
312                        // #NAME処理中
313                        else if( isNowName ) {
314                                // #NAME 設定も、null や、ゼロ文字列の場合は、登録しない。(一番上の if で対処)
315                                colList.add( Integer.valueOf( colNo ) );
316                                nmsList.add( val );
317                        }
318                        // 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加
319                        else if( nSkpClmNo >= 0 && StringUtil.isNull( vals[nSkpClmNo] ) ) {     // nullSkipClm 処理
320                                isColSkip = true;       // Skip する
321                        }
322                        // clmSize > 0 は、#NAME が設定済みという意味
323                        // 7.3.1.3 (2021/03/09) カラム番号の位置が 値配列の配列番号
324                        else if( clmSize > 0 && skipRowCnt <= rowNo ) {                                         // skipRowCnt は、値セットだけ影響する
325                                for( int i=0; i<clmSize ; i++ ) {                                                               // カラム番号の位置が 値配列の配列番号
326                                        if( colms[i] == colNo ) {
327                                                vals[i] = StringUtil.csvOutQuote( val );                                // 6.2.2.0 (2015/03/27)
328                                                useVals = true;
329                                                break;
330                                        }
331                                }
332                        }
333//                      else if( clmSize > 0 && skipRowCnt <= rowNo ) {                                         // skipRowCnt は、値セットだけ影響する。
334//                              final int indx = colList.indexOf( Integer.valueOf( colNo ) );   // カラム番号の位置が 値配列の配列番号
335//                              if( indx >= 0 ) {
336//                                      vals[indx] = StringUtil.csvOutQuote( val );                                     // 6.2.2.0 (2015/03/27)
337//                                      useVals = true;
338//                              }
339//                      }
340                }
341
342                return !isColSkip;
343        }
344
345        /**
346         * rowNo を元に、この行をスキップするかどうか判定のイベントが発生します。
347         *
348         * ※ EXCEL関係の列毎にイベントが発生する場合の列処理をスキップするのが目的です。
349         *    行単位に読み込む場合や、行のループに入れても、意味はありません。
350         *    引数から、行のループに入れてしまいそうですが、行列のループに入れてください。
351         *
352         * ※ 主に、EXCEL関係の読み取り処理で使用されるメソッドです。
353         *    このメソッドは、EventReader#eventReader( String , TableModelHelper )メソッドの
354         *    処理の過程で、設定されます。
355         *    このメソッドから、各種イベントが発行されます。
356         *
357         * 戻り値が、true の場合は、その行の読み取りをスキップします。
358         * false の場合は、読み取り処理を継続します。
359         * スキップ中は、行に関するイベントは発行されません。
360         *
361         * 値(val)を求める前に、行情報を入手し、スキップ中の現在行と同じ場合に、スキップ(=true)と判定します。
362         * スキップ中かどうかは、#value( String,int,int ) で、判定します。
363         * 初期実装では、スキップ中 かつ 現在行と同じ行の場合、または、シートブレーク中の場合に、true を返します。
364         *
365         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
366         * @og.rev 6.1.0.0 (2014/12/26) シートブレイク処理追加
367         *
368         * @param       rowNo   行番号(0~)
369         * @return      スキップするかどうか(true:スキップする/false:スキップしない)
370         * @see         #value( String,int,int )
371         */
372        protected boolean isSkip( final int rowNo ) {
373                return isColSkip && nowRowNo == rowNo || isReadBreak ;
374        }
375
376        /**
377         * 行の終了時に実行されます。
378         *
379         * ここでは、rowNo がブレークするか、シート終了時に呼ぶことで、
380         * 一番最後の行の処理を行います。
381         *
382         * #NAME 処理中の場合(isNowName == true) は、カラム名配列を作成して、
383         * columnNames イベントを呼び出します。
384         * 値配列が設定されている場合(useVals == true) は、values イベントを
385         * 呼び出します。
386         * #NAME 処理が完了している場合は、値配列の初期化を行います。
387         * そのうえで、スキップの解除(isColSkip = false)と行データ
388         * 未設定(useVals = false)に、初期化します。
389         *
390         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
391         * @og.rev 6.2.2.0 (2015/03/27) Overflow処理は、Tag側に戻す。
392         * @og.rev 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
393         * @og.rev 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得できるようにします。
394         *
395         * @see #columnNames( String[] )
396         * @see #values( String[],int )
397         */
398        private void endRow() {
399                if( isNowName ) {                                                                       // #NAME 処理中の場合
400                        if( clmSize > 0 ) {                                                             // 7.3.1.3 (2021/03/09) names,#NAME が設定済みという意味
401                                isNowName = false;
402                                return;
403                        }
404
405                        // 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
406                        if( colList == null ) {
407                                final String errMsg = "#value(String,int,char) または#value(String,int,int) を先に実行しておいてください。" ;
408                                throw new OgRuntimeException( errMsg );
409                        }
410
411                        clmSize = colList.size();
412                        names   = nmsList.toArray( new String[clmSize] );
413                        colms   = colList.stream().mapToInt(i->i).toArray();    // 7.3.1.3 (2021/03/09)
414
415                        if( nullBreakClm != null ) {
416                                for( int i=0; i<clmSize; i++ ) {
417                                        if( nullBreakClm.equalsIgnoreCase( names[i] ) ) {
418                                                nBrkClmNo = i;
419                                                break;
420                                        }
421                                }
422                        }
423                        // 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加
424                        if( nullSkipClm != null ) {
425                                for( int i=0; i<clmSize; i++ ) {
426                                        if( nullSkipClm.equalsIgnoreCase( names[i] ) ) {
427                                                nSkpClmNo = i;
428                                                break;
429                                        }
430                                }
431                        }
432
433                        if( cnstData != null ) { cnstData.setColumns( names ); }
434                        columnNames( names.clone() );                                                                           // イベント(setNames でも、#NAME でもイベントが発生する)
435                        isNowName = false;
436                        colList   = null ;                                                                                                      // 7.3.1.3 (2021/03/09) 不要
437                        nmsList   = null ;                                                                                                      // 不要
438                }
439                else if( useVals ) {                                                                                                    // 値配列が設定されている場合
440                        if( nBrkClmNo >= 0 && StringUtil.isNull( vals[nBrkClmNo] ) ) {          // nullBreakClm 処理
441                                isReadBreak = true;                                                                                             // ReadBreak する
442                        }
443                        else {
444                                if( cnstData != null ) { vals = cnstData.getConstVals( vals ); }
445                                values( vals , nowRowNo );                                                                              // イベント発行(現在行)
446                        }
447                }
448
449                if( clmSize > 0 ) {                                                                                                             // clmSize > 0 は、#NAME が設定済みという意味
450                        vals = new String[clmSize];                                                                                     // 値配列の初期化
451                }
452
453                isColSkip = false;                                                                                                              // スキップの解除
454                useVals   = false;                                                                                                              // 行データ未設定にする
455        }
456
457        /**
458         * シート数のイベントが発生します。
459         *
460         * ※ EXCEL関係以外の読み取りでは、このイベントは発生しません。
461         *
462         * 処理の開始前に、シート数のイベントが発生します。
463         * これを元に、処理するシート番号の選別が可能です。
464         *
465         * @og.rev 6.1.0.0 (2014/12/26) シートの数のイベント
466         *
467         * @param       size    シート数
468         */
469        public void sheetSize( final int size ) {
470                if( useDebug ) { System.out.println( "sheetSize=[" + size + "]" ); }
471        }
472
473        /**
474         * カラム名配列がそろった段階で、イベントが発生します。
475         *
476         * openGion での標準的な処理は、colNo==0 の時に、val の先頭が、#NAME
477         * で始まるレコードを、名前配列として認識します。
478         * #value( String,int,int ) で、この #NAME だけは、継続処理されます。
479         * その上で、#NAME レコードが終了した時点で、カラム名配列が完成するので
480         * そこで初めて、このメソッドが呼ばれます。(EXCEL関係の場合)
481         *
482         * 外部から設定する、#setNames( String , boolean ) 時も同様に呼ばれます。
483         *
484         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
485         *
486         * @param       names   カラム名配列
487         * @see         #value( String,int,int )
488         * @see         #setNames( String , boolean )
489         */
490        public void columnNames( final String[] names ) {
491                if( useDebug ) { System.out.println( "columnNames=[" + Arrays.toString(names) + "]" ); }
492        }
493
494        /**
495         * #NAME のオリジナルカラム名配列がそろった段階で、イベントが発生します。
496         *
497         * #columnNames( String[] ) は、setNames指定時も、#NAME 指定時もイベントが発生します。
498         * このメソッドは、setNames の設定に関係なく、ファイルに書かれていた #NAME で始まるレコードを、
499         * 名前配列として識別して呼出します。
500         *
501         * #NAME が存在しない場合は、呼び出されません。
502         *
503         * @og.rev 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得できるようにします。
504         *
505         * @param       names   #NAME のオリジナルカラム名配列
506         * @see         #columnNames( String[] )
507         */
508        public void originalNames( final String[] names ) {
509                if( useDebug ) { System.out.println( "originalNames=[" + Arrays.toString(names) + "]" ); }
510        }
511
512        /**
513         * row にあるセルのオブジェクト値がそろった段階で、イベントが発生します。
514         *
515         * 初期実装は、何もありません。
516         *
517         * @og.rev 6.0.3.0 (2014/11/13) 新規作成
518         *
519         * @param       vals    文字列値の1行分の配列
520         * @param       rowNo   行番号(0~)
521         */
522        public void values( final String[] vals,final int rowNo ) {
523                if( useDebug ) { System.out.println( "values[" + rowNo + "]=[" + Arrays.toString(vals) + "]" ); }
524        }
525
526        /**
527         * 外部からCSV形式のカラム名文字列を設定します。
528         *
529         * ※ イベント処理実行前の初期化処理です。
530         *
531         * カラム名配列を、#NAME で始まるレコードではなく、外部から指定します。
532         * ここで設定した場合、#columnNames( String[] )イベントも発生します。
533         * null か、長さゼロのカラム名は、設定されません。
534         *
535         * @og.rev 6.1.0.0 (2014/12/26) カラム名配列設定の対応
536         * @og.rev 7.3.1.3 (2021/03/09) #NAMEのオリジナルを取得できるようにします。
537         *
538         * @param       clms            CSV形式のカラム名文字列
539         * @param       useNumber       行番号情報 [true:使用している/false:していない]
540         * @see         #columnNames( String[] )
541         */
542        public final void setNames( final String clms , final boolean useNumber ) {
543                if( clms != null && clms.length() > 0 ) {
544                        if( useDebug ) { System.out.println( "setNames=[" + clms + "]" ); }
545
546                        colList = new ArrayList<>() ;                                                                           // 初期化
547                        nmsList = new ArrayList<>() ;                                                                           // 初期化
548
549                        final String[] nms = StringUtil.csv2Array( clms );
550                        final int adrs = useNumber ? 1:0 ;                                                                      // useNumber =true の場合は、1件目(No)は読み飛ばす。
551                        for( int i=0; i<nms.length; i++ ) {
552                                // null か、長さゼロのカラム名は、設定されません。
553                                final String nm = nms[i];
554                                if( nm != null && nm.length() > 0 ) {
555                                        colList.add( Integer.valueOf( i+adrs ) );
556                                        nmsList.add( nm );
557                                }
558                        }
559                        isNowName = true;                                                                                                       // 名前設定中
560                        useVals   = false;                                                                                                      // データ未設定
561                        endRow();                                                                                                                       // 行末処理実行。名前設定処理が走ります。
562                }
563        }
564
565        /**
566         * カラム名配列が、設定されたかどうか、返します。
567         *
568         * カラム名配列は、#NAME で始まるレコードか、#setNames( String,boolean )メソッドを
569         * 使用して、外部から指定します。
570         * カラム名配列が未設定の場合は、データもセットできないので、処理の最後の判定に使います。
571         *
572         * @og.rev 6.1.0.0 (2014/12/26) カラム名配列設定の対応
573         *
574         * @return      カラム名配列が、設定されたかどうか(true:設定済み/false:未設定)
575         * @see         #setNames( String,boolean )
576         */
577        public boolean isNameSet() {
578                // clmSize > 0 は、#NAME が設定済みという意味
579                return clmSize > 0;
580        }
581
582        /**
583         * 以降のデータを読み飛ばすかどうかを指定します(初期値:false)。
584         *
585         * データを読み込む途中で、それ以降のデータを読み込む必要がなくなった場合に、
586         * true に設定すると、以降のデータを今のシート/ファイルが終了するまで、スキップします。
587         * 例えば、読み込むべき必須カラムで判定する、nullBreakClm 機能を実現できます。
588         * 初期値は、false:読み飛ばさない です。
589         *
590         * @og.rev 6.1.0.0 (2014/12/26) シートブレイク処理追加
591         *
592         * @param       flag    以降のデータを読み飛ばすかどうか [true:読み飛ばす/false:読み飛ばさない]
593         * @see         #isSkip( int )
594         */
595        public void setReadBreak( final boolean flag ) {
596                isReadBreak = flag ;
597        }
598
599        /**
600         * 先頭データの読み飛ばし件数を設定します。
601         *
602         * ※ イベント処理実行前の初期化処理です。
603         *
604         * データの読み始めの行を指定します。
605         * シート/ファイルの先頭行が、0行としてカウントしますので、設定値は、読み飛ばす
606         * 件数になります。(1と指定すると、1件読み飛ばし、2件目から読み込みます。)
607         * 読み飛ばしは、コメント行などは、無視しますので、実際の行数分読み飛ばします。
608         * #NAME属性や、columns 属性は、読み飛ばし中でも処理対象行になります。
609         *
610         * @og.rev 6.1.0.0 (2014/12/26) Excel関係改善
611         *
612         * @param       count   読み始めの初期値(0なら、読み飛ばしなし)
613         */
614        public void setSkipRowCount( final int count ) {
615                skipRowCnt = count;
616        }
617
618        /**
619         * ここに指定されたカラム列に NULL/ゼロ文字列 が現れた時点でSheetの読み取りを中止します。
620         *
621         * これは、指定のカラムは必須という事を条件に、そのレコードだけを読み取る処理を行います。
622         * 複数Sheetの場合は、次のSheetを読みます。
623         * Sheetが存在しない場合(通常のテキスト等)では、読み取り処理の終了になります。
624         *
625         * @og.rev 6.2.0.0 (2015/02/27) 新規追加
626         *
627         * @param       clm     カラム列
628         */
629        public void setNullBreakClm( final String clm ) {
630                nullBreakClm = clm;
631        }
632
633        /**
634         * ここに指定されたカラム列に NULL が現れたレコードは読み飛ばします。
635         *
636         * 例えば、更新対象カラムで、null の場合は、何もしない、などのケースで使用できます。
637         * 複数カラムの場合は、AND条件やOR条件などが、考えられるため、
638         * カラムを一つにまとめて、指定してください。
639         *
640         * @og.rev 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加
641         *
642         * @param       clm     カラム列
643         */
644        public void setNullSkipClm( final String clm ) {
645                nullSkipClm = clm;
646        }
647
648        /**
649         * 固定値となるカラム名(CSV形式)と、固定値となるアドレス(行-列,行-列...) or(A1,B3...)を設定します。
650         *
651         * ※ イベント処理実行前の初期化処理です。
652         *
653         * アドレスは、EXCEL上の行-列か、EXCEL列のA1,B3 などの形式を、CSV形式で指定します。
654         * 行列は、EXCELオブジェクトに準拠するため、0から始まる整数です。
655         * 0-0 ⇒ A1 , 1-0 ⇒ A2 , 0-1 ⇒ B1 になります。
656         * これにより、シートの一か所に書かれている情報を、DBTableModel のカラムに固定値として
657         * 設定することができます。
658         * 例として、DB定義書で、テーブル名をシートの全レコードに設定したい場合などに使います。
659         *
660         * 5.7.6.3 (2014/05/23) より、
661         *   ①EXCEL表記に準拠した、A1,A2,B1 の記述も処理できるように対応します。
662         *     なお、A1,A2,B1 の記述は、必ず、英字1文字+数字 にしてください。(A~Zまで)
663         *     EXCEL2007形式で列数が拡張されていますが、列数は制限しています。
664         *   ②処理中のEXCELシート名をカラムに割り当てるために、"SHEET" という記号に対応します。
665         * 6.2.0.0 (2015/02/27) より、
666         *   ③EXCEL以外では、"FILE","NAME","SUFIX" が使えます。(EXCEL時にも使えます。)
667         *     NAME は、ファイル名から拡張子を取り除いた文字列になります。(AAA/BBB/CCC.xls → CCC)
668         * 例えば、sheetConstKeys="CLM,LANG,NAME" とし、sheetConstAdrs="0-0,A2,SHEET" とすると、
669         * NAMEカラムには、シート名を読み込むことができます。
670         * これは、内部処理の簡素化のためです。
671         *
672         * ちなみに、EXCELのセルに、シート名を表示させる場合の関数は、下記の様になります。
673         * =RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1)))
674         *
675         * @og.rev 5.5.8.2 (2012/11/09) 新規追加
676         * @og.rev 5.7.6.3 (2014/05/23) EXCEL表記(A2,B1等)の対応と、特殊記号(SHEET)の対応
677         * @og.rev 6.1.0.0 (2014/12/26) カラム名配列設定の対応
678         *
679         * @param       constKeys       固定値となるカラム名(CSV形式)
680         * @param       constAdrs       固定値となるアドレス(行-列,行-列...) or(A1,B3...)
681         */
682        public void setConstData( final String constKeys,final String constAdrs ) {
683                if( constKeys != null && !constKeys.isEmpty() && constAdrs != null && !constAdrs.isEmpty() ) {
684                        cnstData = new ConstData( constKeys,constAdrs );
685                        // setNames( String , boolean ) と、このメソッドの呼び出し順に影響がないようにするため。
686                        if( names != null ) { cnstData.setColumns( names ); }
687                }
688        }
689
690        /**
691         * デバッグ情報を出力するかどうか[true:する/false:しない]を指定します。
692         *
693         * EXCELなどを読み取る場合、シートマージで読み取ると、エラー時の行番号が、連番になるため、
694         * どのシートなのか、判らなくなります。
695         * そこで、どうしてもわからなくなった場合に備えて、デバッグ情報を出力できるようにします。
696         * 通常は使用しませんので、設定を無視します。
697         * 初期値は、false:デバッグ情報を出力しない です。
698         *
699         * @og.rev 6.2.0.0 (2015/02/27) デバッグ情報の出力するかどうか。新規追加
700         *
701         * @param       useDebug        デバッグ出力するか [true:する/false:しない]
702         */
703        public void setDebug( final boolean useDebug ) {
704                this.useDebug = useDebug;
705        }
706
707        /**
708         * デバッグ情報を出力するかどうか[true:する/false:しない]を取得します。
709         *
710         * EXCELなどを読み取る場合、シートマージで読み取ると、エラー時の行番号が、連番になるため、
711         * どのシートなのか、判らなくなります。
712         * そこで、どうしてもわからなくなった場合に備えて、デバッグ情報を出力できるようにします。
713         *
714         * @og.rev 6.2.0.0 (2015/02/27) デバッグ情報の出力するかどうか。新規追加
715         *
716         * @return      デバッグ出力 [true:する/false:しない]
717         */
718        protected boolean isDebug() {
719                return useDebug ;
720        }
721
722        /**
723         * EXCELファイルの所定の位置から、固定値を取り出す処理を管理します。
724         *
725         * この固定値の取出しは、内部処理に、非常に依存しているため、今は、
726         * TableModelHelper クラスに含めていますが、将来的には、分ける予定です。
727         *
728         * @og.rev 6.1.0.0 (2014/12/26) Excel関係改善
729         * @og.rev 6.2.0.0 (2015/02/27) 特殊記号(FILE,NAME,SUFIX)追加
730         *
731         * @version     6.0
732         * @author      Kazuhiko Hasegawa
733         * @since       JDK7.0,
734         */
735        private static final class ConstData {
736                /** 内部情報のクリア方法の指定 {@value} */
737                public static final int END_FILE  = 1 ;
738                /** 内部情報のクリア方法の指定 {@value} */
739                public static final int END_SHEET = 2 ;
740
741                // 6.2.0.0 (2015/02/27) 特殊記号処理 追加 (SHEET,FILE,NAME,SUFIX)
742                private static final String KEYS = ",SHEET,FILE,NAME,SUFIX,";
743
744                // ①cnstMap は、cnstKey をキーに、拾ってきた値を持っています。(Sheet毎のトランザクション)
745                private final Map<String,String> cnstMap = new HashMap<>();                             // 6.1.0.0 (2014/12/26) Mapで管理
746                // ②rowcolMap は、rowcol をキーに、アドレスを持っています。
747                private final Map<String,Integer> rowcolMap = new HashMap<>();                  // 6.1.0.0 (2014/12/26) Mapで管理
748                // ③valsMap は、アドレス をキーに、拾ってきた値を持っています。(Sheet毎のトランザクション)
749                private final Map<Integer,String> valsMap = new HashMap<>();                    // 6.1.0.0 (2014/12/26) Mapで管理
750
751                private final int maxRow  ;             // 6.4.9.1 (2016/08/05) final化。最大値持っておき、判定処理を早める。
752
753                // ※ rowcolMap を使用する為、必ず #setColumns( String... ) の実行後に行います。
754                private boolean isNameSet ;
755                private File    tmpFile   ;
756                private String  tmpShtNm  ;
757
758                /**
759                 * 固定値となるカラム名(CSV形式)と、固定値となるアドレス(行-列,行-列...) or(A1,B3...)を設定します。
760                 *
761                 * アドレスは、EXCEL上の行-列か、EXCEL列のA1,B3 などの形式を、CSV形式で指定します。
762                 * 行列は、EXCELオブジェクトに準拠するため、0から始まる整数です。
763                 * 0-0 ⇒ A1 , 1-0 ⇒ A2 , 0-1 ⇒ B1 になります。
764                 * これにより、シートの一か所に書かれている情報を、DBTableModel のカラムに固定値として
765                 * 設定することができます。
766                 * 例として、DB定義書で、テーブル名をシートの全レコードに設定したい場合などに使います。
767                 *
768                 * 5.7.6.3 (2014/05/23) より、
769                 *   ①EXCEL表記に準拠した、A1,A2,B1 の記述も処理できるように対応します。
770                 *     なお、A1,A2,B1 の記述は、必ず、英字1文字+数字 にしてください。(A~Zまで)
771                 *     EXCEL2007形式で列数が拡張されていますが、列数は制限しています。
772                 *   ②処理中のEXCELシート名をカラムに割り当てるために、"SHEET" という記号に対応します。
773                 * 6.2.0.0 (2015/02/27) より、
774                 *   ③EXCEL以外では、"FILE","NAME","SUFIX" が使えます。
775                 *     NAME は、ファイル名から拡張子を取り除いた文字列になります。(AAA/BBB/CCC.xls → CCC)
776                 * 例えば、sheetConstKeys="CLM,LANG,SHT" とし、sheetConstAdrs="0-0,A2,SHEET" とすると、
777                 * SHTカラムには、シート名を読み込むことができます。
778                 * これは、内部処理の簡素化のためです。
779                 *
780                 * ちなみに、EXCELのセルに、シート名を表示させる場合の関数は、下記の様になります。
781                 * =RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1)))
782                 *
783                 * @og.rev 5.5.8.2 (2012/11/09) 新規追加
784                 * @og.rev 5.7.6.3 (2014/05/23) EXCEL表記(A2,B1等)の対応と、特殊記号(SHEET)の対応
785                 * @og.rev 6.1.0.0 (2014/12/26) カラム名配列設定の対応
786                 * @og.rev 6.2.0.0 (2015/02/27) 特殊記号(FILE,NAME,SUFIX)の追加対応
787                 * @og.rev 6.4.9.1 (2016/08/05) maxRowをfinal化します。
788                 *
789                 * @param       constKeys       固定値となるカラム名(CSV形式)
790                 * @param       constAdrs       固定値となるアドレス(行-列,行-列...) or(A1,B3...)
791                 */
792                ConstData( final String constKeys,final String constAdrs ) {
793                        final String[] cnstKeys = constKeys.split( "," );
794                        final String[] row_col  = constAdrs.split( "," );
795
796                        if( cnstKeys.length != row_col.length ) {
797                                final String errMsg = "キーに対するアドレスの個数が不一致です。Keys=[" + constKeys + "]"
798                                                        + " , Adrs=[" + constAdrs + "]" ;
799                                throw new OgRuntimeException( errMsg );
800                        }
801
802                        int tmpRow = -1;                                                                                                        // 6.4.9.1 (2016/08/05)
803                        // 初期の カラムとアドレス(キーワード)の関連付け
804                        for( int j=0; j<cnstKeys.length; j++ ) {
805                                final String cnstKey = cnstKeys[j].trim();                                              // 前後の不要なスペースを削除
806                                if( !cnstKey.isEmpty() ) {
807                                        String rowcol = row_col[j].trim();                                                      // 前後の不要なスペースを削除
808                                        if( !rowcol.isEmpty() ) {
809                                                // 5.7.6.3 (2014/05/23) EXCEL表記(A2,B1等)の対応と、特殊記号(SHEET)の対応
810                                                final int sep = rowcol.indexOf( '-' );
811                                                if( sep > 0 ) {
812                                                        final int row = Integer.parseInt( rowcol.substring( 0,sep ) );
813                        //                              int col = Integer.parseInt( rowcol.substring( sep+1 ) );
814                                                        if( tmpRow < row ) { tmpRow = row; }                            // 6.4.9.1 (2016/08/05)
815                        //                              rowcol = String.valueOf( (char)('A' + col) ) + String.valueOf( row + 1 ) ;      // row-col 形式なので、不要
816                                                }
817                                                // 6.2.0.0 (2015/02/27) 特殊記号(SHEET,FILE,NAME,SUFIX)の追加対応
818                                                else if( !KEYS.contains( ',' + rowcol + ',' ) ) {
819                                                        final int row = Integer.parseInt( rowcol.substring( 1 ) ) -1;   // C6 の場合、rowは、6-1=5
820                                                        final int col = rowcol.charAt(0) - 'A' ;                                                // C6 の場合、colは、'C'-'A'=2
821                                                        if( tmpRow < row ) { tmpRow = row; }                            // 6.4.9.1 (2016/08/05)
822                                                        rowcol = row + "-" + col ;
823                                                }
824                                                cnstMap.put( cnstKey , rowcol );                                                // 6.1.0.0 (2014/12/26) cnstMap に行列情報を設定する
825                                        }
826                                }
827                        }
828                        maxRow = tmpRow;
829                }
830
831                /**
832                 * カラム名配列を元に、固定値カラムのアドレスを求めます。
833                 * カラム名配列は、順番に、指定する必要があります。
834                 *
835                 * @og.rev 6.1.0.0 (2014/12/26) カラム名配列設定の対応
836                 *
837                 * @param       names   カラム列配列(可変長引数)
838                 */
839                /* default */ void setColumns( final String... names ) {
840                        // 6.1.1.0 (2015/01/17) 可変長引数でもnullは来る。
841                        if( names != null && names.length > 0 ) {
842                                // 5.5.8.2 (2012/11/09) 固定値取得用の cnstIndx の設定を行う。
843                                for( int i=0; i<names.length; i++ ) {
844                                        final String rowcol = cnstMap.get( names[i] );          // cnstKey があれば、rowcol が取得できるはず
845                                        if( rowcol != null ) {
846                                                rowcolMap.put( rowcol , Integer.valueOf( i ) );
847                                        }
848                                }
849                                isNameSet = true;                       // 名前設定がされないと、FILEやSHEET キーワードが使えない。
850
851                                if( tmpFile  != null ) { putConstFile(  tmpFile  ); }
852                                if( tmpShtNm != null ) { putConstSheet( tmpShtNm ); }
853                        }
854                }
855
856                /**
857                 * 読み取り時に、rowNo,colNo にあるセルの値を、固定値となるカラム名に関連付けます。
858                 *
859                 * イベントモデルでは、固定値の指定アドレス(rowNo,colNo)をピンポイントで取得することが
860                 * できないため、イベント発生毎に、チェックする必要があります。
861                 * そのため、固定値を使用すると、処理速度が低下します。
862                 *
863                 * @og.rev 6.1.0.0 (2014/12/26) Excel関係改善
864                 *
865                 * @param       val             文字列値(null またはゼロ文字列は、不可)
866                 * @param       rowNo   行番号(0~)
867                 * @param       colNo   列番号(0~)
868                 */
869                /* default */ void putConstValue( final String val,final int rowNo,final int colNo ) {
870                        if( rowNo <= maxRow ) {
871                                final String rowcol = rowNo + "-" + colNo ;
872                                final Integer adrs = rowcolMap.get( rowcol );
873                                if( adrs != null ) {
874                                        valsMap.put( adrs,val );
875                                }
876                        }
877                }
878
879                /**
880                 * ファイル系特殊記号(FILE,NAME,SUFIX)を指定します。
881                 *
882                 * ../AAA/BBB/CCC.XLS というファイルオブジェクトに対して、
883                 *   FILE    : CCC.XLS ファイル名
884                 *   NAME    : CCC     拡張子なしのファイル名
885                 *   SUFIX   : xls     ピリオド無しの拡張子(小文字に統一)
886                 *
887                 * これは、新しいファイルの読み取り開始時に、設定します。
888                 *
889                 * ※ rowcolMap を使用する為、必ず #setColumns( String... ) の実行後に行います。
890                 *
891                 * @og.rev 6.2.0.0 (2015/02/27) 新規作成
892                 *
893                 * @param       filNm   指定ファイル
894                 */
895                /* default */ void putConstFile( final File filNm ) {
896                        if( filNm != null ) {
897                                tmpFile = filNm;                // 名前設定がされるまで、一時保管する。(順番があるので呼ばれればセットしておく)
898                                if( isNameSet ) {               // 名前設定がされないと、FILEやSHEET キーワードが使えない。
899                                        final FileInfo info = new FileInfo( filNm );
900
901                                        for( final String key : FileInfo.KEY_LIST ) {
902                                                final Integer adrs = rowcolMap.get( key );
903                                                if( adrs != null ) {
904                                                        final String val = info.getValue( key );
905                                                        if( val != null ) {
906                                                                valsMap.put( adrs,val );
907                                                        }
908                                                }
909                                        }
910                                }
911                        }
912                }
913
914                /**
915                 * シート名を外部から指定します。
916                 * アドレス指定の特殊系として、"SHEET" 文字列を指定できます。
917                 * これは、新しいシートの読み取り開始時に、設定します。
918                 *
919                 * ※ rowcolMap を使用する為、必ず #setColumns( String... ) の実行後に行います。
920                 *
921                 * @og.rev 6.1.0.0 (2014/12/26) Excel関係改善
922                 *
923                 * @param       shtNm   シート名
924                 */
925                /* default */ void putConstSheet( final String shtNm ) {
926                        if( shtNm != null ) {
927                                tmpShtNm = shtNm;               // 名前設定がされるまで、一時保管する。
928                                if( isNameSet ) {               // 名前設定がされないと、FILEやSHEET キーワードが使えない。
929                                        final Integer adrs = rowcolMap.get( "SHEET" );
930                                        if( adrs != null ) {
931                                                valsMap.put( adrs,shtNm );
932                                        }
933                                }
934                        }
935                }
936
937                /**
938                 * 内部の valsMap を初期化します。
939                 * 固定値の読み取りは、シートごとに行います。
940                 * 新しいシートにデータが設定されていない場合、前のシートの値が残ります。
941                 * ここでは、シート呼出しごとに、毎回クリアします。
942                 * 引数に応じて、クリアする範囲を限定します。
943                 * END_FILE 時は、すべてクリア。END_SHEET 時は、ファイル情報は残します。
944                 *
945                 * @og.rev 6.1.0.0 (2014/12/26) Excel関係改善
946                 *
947                 * @param       type    内部情報のクリア方法の指定(END_FILE or END_SHEET)
948                 */
949                /* default */ void clearValsMap( final int type ) {
950                        valsMap.clear();
951                        if( type == END_SHEET ) { putConstFile( tmpFile ); }    // 全削除後にファイル情報を再設定
952                }
953
954                /**
955                 * 値配列のデータに、固定値を設定します。
956                 * 引数の文字列配列に、固定値を設定しますので、配列オブジェクト自体を更新します。
957                 *
958                 * @og.rev 6.1.0.0 (2014/12/26) Excel関係改善
959                 * @og.rev 6.4.3.4 (2016/03/11) forループを、forEach メソッドに置き換えます。
960                 *
961                 * @param       vals    文字列値の1行分の配列
962                 * @return      固定値を設定された1行分の文字列配列
963                 */
964                /* default */ String[] getConstVals( final String[] vals ) {
965                        if( vals != null && vals.length > 0 ) {
966                                // 6.4.3.4 (2016/03/11) forループを、forEach メソッドに置き換えます。
967                                valsMap.forEach( (k,v) -> {
968                                                        if( k < vals.length ) { vals[k] = v; }
969                                } );
970                        }
971                        return vals ;
972                }
973        }
974}