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.taglib;
017
018import org.opengion.fukurou.system.OgRuntimeException ;         // 6.4.2.0 (2016/01/29)
019import org.opengion.hayabusa.common.HybsSystem;
020import org.opengion.hayabusa.common.HybsSystemException;
021import org.opengion.hayabusa.common.HybsOverflowException;              // 6.2.5.0 (2015/06/05)
022import org.opengion.hayabusa.resource.GUIInfo;
023import org.opengion.hayabusa.db.DBColumn;
024import org.opengion.hayabusa.db.ColumnActionListener;                   // 6.2.2.0 (2015/03/27)
025import org.opengion.hayabusa.io.TableReader;
026import org.opengion.fukurou.db.Transaction;
027import org.opengion.fukurou.util.ErrorMessage;                                  // 6.2.5.0 (2015/06/05)
028import org.opengion.fukurou.util.StringUtil;
029import org.opengion.fukurou.system.Closer ;
030import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
031import org.opengion.fukurou.util.FileInfo;                                              // 6.2.3.0 (2015/05/01)
032import org.opengion.fukurou.model.Formatter;
033import org.opengion.fukurou.model.ArrayDataModel;
034
035import static org.opengion.fukurou.util.StringUtil.nval ;
036import static org.opengion.fukurou.system.HybsConst.BR;                 // 6.1.0.0 (2014/12/26) refactoring
037
038import java.sql.Connection;
039import java.sql.PreparedStatement;
040import java.sql.SQLException;
041
042import java.io.File;
043
044/**
045 * 指定のファイルを直接データベースに登録するデータ入力タグです。
046 *
047 * 通常の readTable などは、DBTableModelオブジェクトを介して全件メモリに
048 * ロードしてから表示させる為、大量データ処理ができません。
049 * このタグでは、直接ファイルを読み取りながらデータベース登録するので
050 * 大量データをバッチ的に登録する場合に使用します。
051 *
052 * 読み取るファイルは、先頭(または実データが現れるまでに) #NAME 行が必要です。
053 * これは、ファイルデータのカラム名を指定しています。また、columns 属性を使用すれば、
054 * ファイルの#NAME 行より優先して(つまり存在していなくても良い)データのカラム名を
055 * 指定することが出来ます。
056 * この#NAME 行は、ファイルのセパレータと無関係に必ずタブ区切りで用意されています。
057 * タグのBODY部に、実行するSQL文を記述します。
058 * このSQL文は、
059 * INSERT INTO GE41 (CLM,NAME_JA,SYSTEM_ID,FGJ,DYSET)
060 * VALUES ([CLM],[NAME_JA],[SYSTEM_ID],'1','{@USER.YMDH}')
061 * と、いう感じで、ファイルから読み込んだ値は、[カラム名]に割り当てられます。
062 * もちろん、通常の固定値(FGJに'1'をセット)や、リクエスト変数(DYSETの{@USER.YMDH})
063 * なども使用できます。
064 *
065 * ※ 6.2.3.0 (2015/05/01)
066 *    BODY部にSQL文を記述しない場合は、table 属性に、INSERTするテーブルIDを指定します。
067 * ※ 6.2.4.0 (2015/05/15)
068 *    omitNames に、WRITABLE と ROWID を、強制的に含めます(無条件)。
069 *
070 * ※ このタグは、Transaction タグの対象です。
071 *
072 * @og.formSample
073 * ●形式:<og:directTableInsert filename="[・・・]" ・・・ >INSERT INTO ・・・ </og:directTableInsert >
074 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します)
075 *
076 * ●Tag定義:
077 *   <og:directTableInsert
078 *       readerClass        【TAG】実際に読み出すクラス名の略称(TableReader_**** の ****)をセットします
079 *                                  (初期値:TABLE_READER_DEFAULT_CLASS[={@og.value SystemData#TABLE_READER_DEFAULT_CLASS}])
080 *  専   commitBatch        【TAG】指定数毎にコミットを発行します(初期値:0 終了までコミットしません)
081 *  専   dbid               【TAG】(通常は使いません)検索時のDB接続IDを指定します(初期値:DEFAULT)
082 *  専   table              【TAG】BODYのSQL文を指定しない場合に使用するテーブルIDを指定します
083 *       command            【TAG】コマンド (NEW,RENEW)をセットします(初期値:NEW)
084 *       fileURL            【TAG】読取元ディレクトリ名を指定します(初期値:FILE_URL)
085 *       filename           【TAG】ファイルを作成するときのファイル名をセットします (初期値:FILE_FILENAME[=file.xls])
086 *       encode             【TAG】ファイルを作成するときのファイルエンコーディング名をセットします(初期値:FILE_ENCODE)
087 *       skipRowCount       【TAG】(通常は使いません)データの読み飛ばし件数を設定します
088 *       maxRowCount        【TAG】読取時の最大取り込み件数をセットします (初期値:0:[無制限])
089 *       errRowCount        【TAG】読取時の最大エラー件数をセットします (初期値:{@og.value ReadTableTag#ERROR_ROW_COUNT})(0:[無制限])
090 *       separator          【TAG】可変長ファイルを作成するときの項目区切り文字をセットします
091 *       columns            【TAG】読取元ファイルのカラム列を、外部(タグ)よりCSV形式で指定します
092 *       omitNames          【TAG】読取対象外のカラム列を、外部(タグ)よりCSV形式で指定します
093 *       modifyType         【TAG】ファイル取り込み時の モディファイタイプ(A(追加),C(更新),D(削除))を指定します
094 *       displayMsg         【TAG】query の結果を画面上に表示するメッセージIDを指定します(初期値:VIEW_DISPLAY_MSG[={@og.value SystemData#VIEW_DISPLAY_MSG}]))
095 *       overflowMsg        【TAG】読取データが最大検索数をオーバーした場合に表示するメッセージリソースIDを指定します (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました])
096 *       notfoundMsg        【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])
097 *  ※   sheetName          【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)
098 *  ※   sheetNos           【TAG】EXCELファイルを読み込むときのシート番号を複数設定できます(初期値:0)
099 *  ※   sheetConstKeys     【TAG】EXCELファイルを読み込むときの固定値となるカラム名(CSV形式)
100 *  ※   sheetConstAdrs     【TAG】EXCELファイルを読み込むときの固定値となるアドレス(行-列,行-列,・・・)
101 *       nullBreakClm       【TAG】カラム列に NULL が現れた時点で読取を中止します(複数Sheetの場合は、次のSheetを読みます)。
102 *       nullSkipClm        【TAG】カラム列に NULL が現れたレコードは読み飛ばします。
103 *       useNumber          【TAG】行番号情報を、使用している/していない[true/false]を指定します(初期値:true)
104 *       useRenderer        【TAG】読取処理でKEY:VAL形式のコードリソースから、KEYを取り出す処理を行うかどうかを指定します(初期値:USE_TABLE_READER_RENDERER[=false])
105 *       adjustColumns      【TAG】読取元ファイルのデータ変換を行うカラム列をカンマ指定します
106 *       checkColumns       【TAG】読取元ファイルの整合性チェックを行うカラム列をカンマ指定します
107 *       nullCheck          【TAG】NULL チェックすべきカラム列をCSV形式(CSV形式)で指定します
108 *       matchKeys          【TAG】レコードの読取条件指定時のカラム列をCSV形式で指定します 6.4.6.0 (2016/05/27)
109 *       matchVals          【TAG】レコードの読取条件指定時のカラム列に対応する正規表現データをCSV形式で指定します 6.4.6.0 (2016/05/27)
110 *       language           【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します
111 *       stopZero           【TAG】読込件数が0件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する])
112 *       mainTrans          【TAG】(通常は使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:false)
113 *       tableId            【TAG】(通常は使いません)sessionから所得する DBTableModelオブジェクトの ID
114 *       scope              【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session)
115 *       useTimeView        【TAG】処理時間を表示する TimeView を表示するかどうかを指定します
116 *                                                                              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
117 *       useSLabel          【TAG】7.0.7.0 (2019/12/13) エラーメッセージにSLABELを利用するかどうか[true/false]を指定します(初期値:false)
118 *       caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 5.7.7.2 (2014/06/20)
119 *       caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20)
120 *       caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
121 *       caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
122 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
123 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
124 *   >   ... Body ...
125 *   </og:directTableInsert>
126 *
127 * ●使用例
128 *     <og:directTableInsert
129 *         dbid         = "ORCL"                接続データベースID(初期値:DEFAULT)
130 *         separator    = ","                   ファイルの区切り文字(初期値:タブ)
131 *         fileURL      = "{@USER.ID}"     読み取り元ディレクトリ名
132 *         filename     = "{@filename}"    読み取り元ファイル名
133 *         encode       = "Shift_JIS"           読み取り元ファイルエンコード名
134 *         displayMsg   = "MSG0040"             登録完了後のメッセージ
135 *         columns      = "CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG"
136 *                                              #NAME の代わりに使用するカラム列名
137 *         commitBatch  = "100"                 この件数ずつコミットを発行(初期値:無制限)
138 *         useColumnCheck  = "true"             カラムチェックを行うかどうか(初期値:false)
139 *         useColumnAdjust = "true"             カラム変換を行うかどうか(初期値:false)
140 *         nullCheck       = "CLM,SYSTEM_ID"    NULLチェックを実行します。
141 *     >
142 *          INSERT INTO GE41
143 *              (CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG,
144 *                 FGJ,DYSET,DYUPD,USRSET,USRUPD,PGUPD)
145 *          VALUES
146 *              ([CLM],[NAME_JA],[LABEL_NAME],[KBSAKU],[SYSTEM_ID],[LANG],
147 *                '1','{@USER.YMDH}','{@USER.YMDH}','{@USER.ID}','{@USER.ID}','{@GUI.KEY}')
148 *     </og:directTableInsert >
149 *
150 * @og.group ファイル入力
151 *
152 * @version  4.0
153 * @author   Kazuhiko Hasegawa
154 * @since    JDK5.0,
155 */
156public class DirectTableInsertTag extends ReadTableTag {
157        /** このプログラムのVERSION文字列を設定します。   {@value} */
158        private static final String VERSION = "7.0.7.0 (2019/12/13)" ;
159        private static final long serialVersionUID = 707020191213L ;
160
161        // 6.2.4.0 (2015/05/15) 無条件でOMITする名称を指定します(WRITABLE,ROWID)
162        private static final String DEFAULT_OMIT = "WRITABLE,ROWID" ;
163
164        // 4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
165        private String          dbid            ;
166        private int                     commitBatch     ;                               // コミットするまとめ件数
167        private String          sql                     ;
168        private String          table           ;                               // 6.2.3.0 (2015/05/01)
169        private long            dyStart         ;                               // 実行時間測定用のDIV要素を出力します。
170        private boolean useTimeView             = HybsSystem.sysBool( "VIEW_USE_TIMEBAR" );             // 6.3.6.0 (2015/08/16)
171
172        /**
173         * デフォルトコンストラクター
174         *
175         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
176         */
177        public DirectTableInsertTag() { super(); }              // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
178
179        /**
180         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
181         *
182         * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
183         * @og.rev 6.2.3.0 (2015/05/01) table属性追加。BODYのSQL文が無くても、table属性で自動生成します。
184         * @og.rev 6.2.4.0 (2015/05/15) 無条件でOMITする名称を指定します。
185         *
186         * @return      後続処理の指示( EVAL_BODY_BUFFERED )
187         */
188        @Override
189        public int doStartTag() {
190                dyStart = System.currentTimeMillis();
191
192                // 6.2.4.0 (2015/05/15) 無条件でOMITする名称を指定します。
193                addOmitNames( DEFAULT_OMIT );
194
195                // 6.2.3.0 (2015/05/01) table属性追加
196                // 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
197                return table == null || table.isEmpty()
198                                        ? EVAL_BODY_BUFFERED            // Body を評価する。( extends BodyTagSupport 時)
199                                        : SKIP_BODY ;                           // Body を評価しない
200        }
201
202        /**
203         * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
204         *
205         * @og.rev 3.6.0.2 (2004/10/04) SQL文の [カラム] 対応とパーサー機能追加
206         * @og.rev 3.8.6.3 (2006/11/30) SQL 文の前後のスペースを取り除きます。
207         * @og.rev 6.2.3.0 (2015/05/01) table属性追加。BODYのSQL文が無くても、table属性で自動生成します。
208         *
209         * @return      後続処理の指示(SKIP_BODY)
210         */
211        @Override
212        public int doAfterBody() {
213                sql = getBodyString();
214                if( sql == null || sql.isEmpty() || sql.trim().isEmpty() ) {
215                        final String errMsg = "table属性を指定しない場合は、BODY 部の登録用 Insert/Update文は、必須です。";
216                        throw new HybsSystemException( errMsg );
217                }
218
219                return SKIP_BODY ;                              // Body を評価しない
220        }
221
222        /**
223         * #doEndTag() の後続処理を記述します。
224         * 
225         * これは、サブクラスで、DBTableModel以外の処理を行う場合に、
226         * 処理内容を分けるために用意します。
227         *
228         * @og.rev 6.2.2.0 (2015/03/27) #afterEnd() メソッド 新規作成。
229         * @og.rev 6.2.5.0 (2015/06/05) AutoReaderの仕様変更。checkColumns エラー処理が抜けていたので、追加します。
230         * @og.rev 7.0.7.0 (2019/12/13) useSLabel 属性を追加。
231         *
232         * @return      後続処理の指示
233         */
234        @Override
235        protected int afterEnd() {
236                // 6.2.5.0 (2015/06/05) エラー処理の追加
237                final ErrorMessage errMsg = clmAct.getErrorMessage();
238                if( !errMsg.isOK() ) {
239//                      jspPrint( TaglibUtil.makeHTMLErrorTable( errMsg,getResource() ) );
240                        jspPrint( TaglibUtil.makeHTMLErrorTable( errMsg,getResource(),useSLabel ) );            // 7.0.7.0 (2019/12/13)
241                        return SKIP_PAGE ;
242                }
243
244                // 実行件数の表示
245                // 4.0.0 (2005/11/30) 出力順の変更。一番最初に出力します。
246                if( displayMsg != null && displayMsg.length() > 0 ) {
247                        final String status = executeCount + getResource().getLabel( displayMsg ) ;
248                        jspPrint( status + BR );
249                }
250
251                // 5.7.6.2 (2014/05/16) 検索結果の件数を、"DB.COUNT" キーでリクエストにセットする。
252                setRequestAttribute( "DB.COUNT" , String.valueOf( executeCount ) );
253
254                // 5.7.6.2 (2014/05/16) 件数0件かつ stopZero = true
255                if( executeCount == 0 && stopZero ) { return SKIP_PAGE; }
256
257                final long dyTime = System.currentTimeMillis()-dyStart;
258
259                // 4.0.0 (2005/01/31) セキュリティチェック(データアクセス件数登録)
260                final GUIInfo guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY );
261                if( guiInfo != null ) { guiInfo.addWriteCount( executeCount,dyTime,sql ); }
262
263                if( useTimeView ) {             // 6.3.6.0 (2015/08/16)
264                        // 時間測定用の DIV 要素を出力
265                        jspPrint( "<div id=\"queryTime\" value=\"" + (dyTime) + "\"></div>" );  // 3.5.6.3 (2004/07/12)
266                }
267                return EVAL_PAGE ;
268        }
269
270        /**
271         * タグリブオブジェクトをリリースします。
272         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
273         *
274         * @og.rev 3.6.0.2 (2004/10/04) useColumnCheck,useColumnAdjust 属性追加
275         * @og.rev 3.8.0.2 (2005/06/30) nullCheck 属性追加
276         * @og.rev 4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
277         * @og.rev 5.5.7.1 (2012/10/05) skipRowCount追加
278         * @og.rev 5.7.6.2 (2014/05/16) stopZero属性追加
279         * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
280         * @og.rev 6.2.3.0 (2015/05/01) table属性追加
281         */
282        @Override
283        protected void release2() {
284                super.release2();
285                dbid                    = null;
286                commitBatch             = 0;                                    // コミットするまとめ件数
287                table                   = null;                                 // 6.2.3.0 (2015/05/01) 
288                useTimeView     = HybsSystem.sysBool( "VIEW_USE_TIMEBAR" );     // 6.3.6.0 (2015/08/16)
289        }
290
291        /**
292         * ファイルオブジェクト より読み込み、データベースに書き込みます。
293         *
294         * @og.rev 3.6.0.2 (2004/10/04) カラムオブジェクトのDBType属性の整合性チェック
295         * @og.rev 3.8.0.2 (2005/06/30) nullチェック確認
296         * @og.rev 3.8.5.1 (2006/05/08) 取込データが name 列より少ない場合の対応を追加
297         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
298         * @og.rev 4.0.0.0 (2005/01/31) CheckColumnDataクラス static 化、引数にResourceManager追加
299         * @og.rev 4.0.0.1 (2007/12/03) try ~ catch ~ finally をきちんと行う。
300         * @og.rev 5.1.9.0 (2010/08/01) Transaction 対応
301         * @og.rev 5.2.2.0 (2010/11/01)) ""で囲われているデータに改行が入っていた場合の対応
302         * @og.rev 5.3.7.0 (2011/07/01) TransactionReal の引数変更
303         * @og.rev 5.3.8.0 (2011/08/01) pstmt.setObject で、useParamMetaData の判定を避けるため、pstmt.setString で代用(PostgreSQL対応)
304         * @og.rev 5.5.7.1 (2012/10/05) omitFirstLine対応
305         * @og.rev 5.7.0.3 (2013/11/22) BufferedReaderのclose処理をこのメソッド内のfinallyで行う
306         * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
307         * @og.rev 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加
308         * @og.rev 6.2.4.2 (2015/05/29) executeCount の設定がおかしい。DirectTableInsertTagでは、初期値が -1 のため、件数が1件少なくなっていた。
309         * @og.rev 6.2.5.0 (2015/06/05) AutoReaderの仕様変更。checkColumns エラー処理が抜けていたので、追加します。
310         * @og.rev 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
311         * @og.rev 6.4.3.3 (2016/03/04) HybsSystem.newInstance(String,String) への置き換え。
312         * @og.rev 6.6.0.1 (2016/12/07) エンコードが複数ある場合、SQLのパースで、上書きするとカラム名が取れないバグ修正。
313         * @og.rev 7.0.4.3 (2019/07/15) AutoReaderでencode指定の場合、columnNamesを複数回通ることがあるため、executeCountは都度クリアする
314         *
315         * @param   file ファイルオブジェクト
316         */
317        @Override
318        protected void create( final File file )  {
319
320                // 6.3.6.1 (2015/08/28) Transaction で処理
321                try( final Transaction tran = getTransaction() ) {
322                        /**
323                         * ColumnActionListenerインターフェースの内部無名クラス
324                         *
325                         * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
326                         * @og.rev 6.3.6.1 (2015/08/28) Transaction で処理
327                         *
328                         * @param names カラム名配列
329                         */
330                        final ColumnActionListener listener = new ColumnActionListener() {
331                                private DBColumn[]      dbClms ;
332                                private String[]        clmKeys         ;                               // SQL文の[カラム名]配列
333                                private int                     commitCount ;
334
335                                private int[] clmNos    ;
336                                private int   clmNosLen ;
337
338                                private PreparedStatement pstmt  ;
339                                private final Connection conn = tran.getConnection( dbid );             // 6.3.6.1 (2015/08/28) 
340
341                                /**
342                                 * 一連の作業終了時に呼ばれます。
343                                 *
344                                 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
345                                 * @og.rev 6.3.6.1 (2015/08/28) Transaction で処理
346                                 *
347                                 */
348                                @Override
349                                public void end() {
350                                        Closer.stmtClose( pstmt );
351                                        tran.commit();                                  // 6.3.6.1 (2015/08/28) ここでは常にcommit()させる。
352                                }
353
354                                /**
355                                 * カラム名の配列が設定された場合に、呼び出されます。
356                                 *
357                                 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
358                                 * @og.rev 6.2.4.2 (2015/05/29) executeCount の設定がおかしい。DirectTableInsertTagでは、初期値が -1 のため、件数が1件少なくなっていた。
359                                 * @og.rev 6.3.6.1 (2015/08/28) Transaction で処理
360                                 * @og.rev 6.4.1.1 (2016/01/16) HybsOverflowException をthrow するとき、最大件数を引数に渡す。
361                                 * @og.rev 6.4.3.4 (2016/03/11) Formatterに新しいコンストラクターを追加する。
362                                 * @og.rev 6.6.0.1 (2016/12/07) エンコードが複数ある場合、SQLのパースで、上書きするとカラム名が取れないバグ修正。
363                                 * @og.rev 6.9.5.0 (2018/04/23) カラム名が存在しない場合に、Exception を throw するかどうかを指定可能にする。
364                                 * @og.rev 7.0.4.3 (2019/07/15) AutoReaderでencode指定の場合、columnNamesを複数回通ることがあるため、executeCountは都度クリアする
365                                 *
366                                 * @param names カラム名配列
367                                 */
368                                @Override
369                                public void columnNames( final String[] names ) {
370                                        String pstSql = null;                   // 6.6.0.1 (2016/12/07)
371
372                                        final String[] nms = clmAct.makeNames( names );
373
374                                        // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
375                                        if( table == null || table.isEmpty() ) {
376                                                if( sql != null && !sql.isEmpty() ) {
377//                                                      final ArrayDataModel nmdata = new ArrayDataModel( nms );
378                                                        final ArrayDataModel nmdata = new ArrayDataModel( nms,true );   // 6.9.5.0 (2018/04/23) カラム名が存在しない場合に、Exception を throw する
379                                                        final Formatter format = new Formatter( nmdata,sql.trim() );    // 6.4.3.4 (2016/03/11)
380                                                        clmNos          = format.getClmNos();                                                           // 指定されたセルのカラム番号。存在しなければ、Exception を throw する
381                                                        clmNosLen       = clmNos.length ;
382                                                        clmKeys         = format.getClmKeys();
383                                                        pstSql          = format.getQueryFormatString();                                        // 6.6.0.1 (2016/12/07)
384                                                }
385                                        }
386                                        else {
387                                                if( "FILE.NAME".equals( table ) ) {
388                                                        table = FileInfo.getNAME( file );
389                                                }
390
391                                                clmNosLen = nms.length;
392                                                clmNos  = new int[clmNosLen];
393                                                clmKeys = nms;
394
395                                                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
396                                                buf.append( "INSERT INTO " ).append( table ).append( " ( " )
397                                                        .append( String.join( ",",nms ) )
398                                                        .append( " ) VALUES ( ?" );
399                                                clmNos[0] = 0;
400                                                for( int i=1; i<clmNosLen; i++ ) {
401                                                        clmNos[i] = i;
402                                                        buf.append( ",?" );
403                                                }
404                                                buf.append( ')' );
405                                                pstSql = buf.toString();                        // 6.6.0.1 (2016/12/07)
406                                        }
407
408                                        try {
409                                                pstmt = conn.prepareStatement( pstSql );                        // 6.6.0.1 (2016/12/07)
410                                        }
411                                        catch( final SQLException ex ) {
412                                                final String errMsg = CR + ex.getMessage()                                                                      + CR
413                                                                                        + " sql   =["            + sql                                          + "]"   + CR
414                                                                                        + " names =[" + StringUtil.array2csv( names )   + "]"   + CR            // 6.6.0.1 (2016/12/07)
415                                                                                        + " encode=[" + encode                                                  + "]"   + CR            // 6.6.0.1 (2016/12/07)
416                                                                                        + " ErrorCode=[" + ex.getErrorCode()                    + "]"
417                                                                                        + " State=["     + ex.getSQLState()                             + "]"   + CR ;
418                                                jspPrint( errMsg );
419                                                tran.rollback();                                                                                // 6.3.6.1 (2015/08/28) Transaction で処理
420                                //              tran.close();                                                                                   // 6.3.6.1 (2015/08/28) Transaction で処理
421                                                sqlError = true;                                                                                // 6.3.6.1 (2015/08/28) DirectTableInsertTag でSQLException発生時
422                                                throw new HybsSystemException( errMsg,ex );                             // 6.2.4.2 (2015/05/29) refactoring
423                                        }
424
425                                        dbClms = new DBColumn[nms.length];
426                                        for( int no=0; no<nms.length; no++ ) {
427                                                dbClms[no] = getDBColumn( nms[no] );
428                                        }
429                                        // 6.2.4.2 (2015/05/29) executeCount の設定がおかしい。DirectTableInsertTagでは、初期値が -1 のため、件数が1件少なくなっていた。
430                                        // 7.0.4.3 (2019/07/15) AutoReaderでencode指定の場合、columnNamesを複数回通ることがあるため、executeCountは都度クリアする
431//                                      executeCount++ ;
432                                        executeCount = 0;                       // 7.0.4.3 (2019/07/15)
433                                }
434
435                                /**
436                                 * 1行分のデータが設定された場合に、呼び出されます。
437                                 *
438                                 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。
439                                 * @og.rev 6.2.5.0 (2015/06/05) 読み取り件数オーバーフロー時、HybsOverflowException を throw します。
440                                 * @og.rev 6.3.6.1 (2015/08/28) Transaction で処理
441                                 * @og.rev 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
442                                 * @og.rev 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加。条件に一致しなければ、null が返されます。
443                                 *
444                                 * @param   vals    文字列値の1行分の配列
445                                 * @param   rowNo   行番号(0~)
446                                 */
447                                @Override
448                                public void values( final String[] vals, final int rowNo ) {
449                                        if( maxRowCount <= 0 || executeCount <= maxRowCount ) {         // 読み取り件数無制限か、最大件数以下の場合
450                                                // 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs)
451                                                // 6.4.1.1 (2016/01/16) PMD refactoring. 処理の順番を入れ替えます。
452                                                if( pstmt == null || clmNos == null ) {
453                                                        final String errMsg = "#columnNames(String[])を先に実行しておいてください。"  ;
454                                                        throw new OgRuntimeException( errMsg );
455                                                }
456
457                                                try {
458                                                        final String[] newVals = clmAct.clmAction( vals , dbClms , rowNo );             // この処理結果が、getErrorMessage() に反映するので、移動不可
459
460                                                        // 6.2.5.0 (2015/06/05) エラー発生時は、以下の処理は行いません。
461                                                        // 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加。条件に一致しなければ、null が返されます。
462                                                        if( newVals == null || !clmAct.getErrorMessage().isOK() || sqlError ) { return; }               // 6.3.6.1 (2015/08/28)
463
464                                                        // ※ skipTailCount:末尾から指定行数分は取り込まない処理を入れる場合、newVals[]をListにaddしておき、指定件数以上で先頭を処理する。
465                                                        for( int i=0; i<clmNosLen; i++ ) {
466                                                                pstmt.setString( i+1,newVals[clmNos[i]] );
467                                                        }
468                                                        pstmt.execute();
469                                                        if( commitBatch > 0 && ( executeCount%commitBatch == 0 ) ) {
470                                                                conn.commit();                  // 5.1.9.0 (2010/08/01) Transaction 対応
471                                                                commitCount = executeCount;
472                                                        }
473                                                        executeCount++ ;
474                                                }
475                                                catch( final SQLException ex ) {
476                                                        final String errMsg = CR + ex.getMessage()                                                      + CR
477                                                                                + " sql   =[" + sql                                                             + "]"   + CR
478                                                                                + " encode=[" + encode                                                  + "]"   + CR            // 6.6.0.1 (2016/12/07)
479                                                                                + " keys  =[" + StringUtil.array2csv( clmKeys ) + "]"   + CR
480                                                                                + " vals  =[" + StringUtil.array2csv( vals )    + "]"   + CR
481                                                                                + " 行番号=["    + (rowNo+1)         + "]"
482                                                                                + " 登録件数=["  + commitCount       + "]"  + CR
483                                                                                + " ErrorCode=[" + ex.getErrorCode() + "]"
484                                                                                + " State=["     + ex.getSQLState()  + "]"  + CR ;
485                                                        jspPrint( errMsg );
486                                                        tran.rollback();                                                                // 6.3.6.1 (2015/08/28) Transaction で処理
487                                        //              tran.close();                                                                   // 6.3.6.1 (2015/08/28) Transaction で処理
488                                                        sqlError = true;                                                                // 6.3.6.1 (2015/08/28) DirectTableInsertTag でSQLException発生時
489                                                        throw new HybsSystemException( errMsg,ex );
490                                                }
491                                        }
492                                        else {
493                                                throw new HybsOverflowException( maxRowCount ); // 6.4.1.1 (2016/01/16)
494                                        }
495                                }
496                        };
497
498                        final TableReader reader = HybsSystem.newInstance( "TableReader_" , readerClass );      // 3.5.5.3 (2004/04/09)
499
500                        reader.setSeparator( separator );
501                        reader.setColumns( columns );                                   // 3.5.4.5 (2004/01/23) 、6.2.0.0 (2015/02/27) 削除
502                        reader.setUseNumber( useNumber );                               // 3.7.0.5 (2005/04/11)
503                        reader.setSkipRowCount( skipRowCount );                 // 5.1.6.0 (2010/05/01)
504                        reader.setDebug( isDebug() );                                   // 5.5.7.2 (2012/10/09) デバッグ情報を出力するかどうかを指定
505                        // 6.2.0.0 (2015/02/27) EXCELでない場合でも、メソッドは呼び出す。(空振りします)
506                        reader.setSheetName( sheetName );                               // 3.5.4.2 (2003/12/15)
507                        reader.setSheetNos( sheetNos );                                 // 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるようにする。
508                        reader.setSheetConstData( sheetConstKeys,sheetConstAdrs ) ;             // 5.5.8.2 (2012/11/09) 固定値となるカラム名、アドレスの指定
509                        reader.setNullBreakClm( nullBreakClm ) ;                // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
510                        reader.setNullSkipClm( nullSkipClm ) ;                  // 6.2.3.0 (2015/05/01) 行読み飛ばし
511                        // 6.6.0.1 (2016/12/07) setColumnActionListener は、内部処理が走るため、他の設定が終わってから呼び出す。
512                        reader.setColumnActionListener( listener );             // 6.2.2.0 (2015/03/27)
513
514                        reader.readDBTable( file,encode );                              // 6.2.0.0 (2015/02/27) 追加
515
516                        listener.end();                                                                 // 6.3.6.1 (2015/08/28) tran.commit() は、この、end メソッドで行われる。
517                }
518        }
519
520                // 6.3.6.1 (2015/08/28) Transaction で処理
521
522        /**
523         * 【TAG】(通常は使いません)検索時のDB接続IDを指定します(初期値:DEFAULT)。
524         *
525         * @og.tag
526         *   検索時のDB接続IDを指定します。初期値は、DEFAULT です。
527         *
528         * @param       id データベース接続ID
529         */
530        public void setDbid( final String id ) {
531                dbid = nval( getRequestParameter( id ),dbid );
532        }
533
534        /**
535         * 【TAG】指定数毎にコミットを発行します(初期値:0 終了までコミットしません)。
536         *
537         * @og.tag
538         * 通常は、全ての処理が正常に終了するか、なにもしないか(トランザクション)
539         * を判断すべきで、途中でのコミットはしません。
540         * しかし、場合によって、件数が異常に多い場合や、再実行可能な場合は、
541         * 途中でコミットして、都度、処理できるものだけを処理してしまうという方法があります。
542         * また、ロールバックエリアの関係などで、データ量が多い場合に、処理時間が異常に
543         * 長くなる事があり、指定件数ごとのコミット機能を用意しています。
544         * 0 に設定すると、終了までコミットしません。初期値は、0 です。
545         *
546         * @param   cmtBat コミットを発行する行数 (初期値:0)
547         */
548        public void setCommitBatch( final String cmtBat ) {
549                commitBatch = nval( getRequestParameter( cmtBat ),commitBatch );
550        }
551
552        /**
553         * 【TAG】BODYのSQL文を指定しない場合に使用するテーブルIDを指定します。
554         *
555         * @og.tag
556         * 通常は、BODYに記述したSQL文を実行しますが、テーブルIDを指定すると、
557         * INSERT用のSQL文を自動作成します。
558         * その場合は、BODYのSQL文は設定不要です。
559         * また、FILE.NAME という文字列を指定した場合は、file1 に指定した
560         * ファイル名から、拡張子を取り除いた名称をテーブル名として使用します。
561         *
562         * @og.rev 6.2.3.0 (2015/05/01) table属性追加
563         *
564         * @param   tbl テーブルID
565         */
566        public void setTable( final String tbl ) {
567                table = nval( getRequestParameter( tbl ),table );
568        }
569
570        /**
571         * 【TAG】処理時間を表示する TimeView を表示するかどうか[true:する/false:しない]を指定します
572         *              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
573         *
574         * @og.tag
575         * true に設定すると、処理時間を表示するバーイメージが表示されます。
576         * これは、DB検索、APサーバー処理、画面表示の各処理時間をバーイメージで
577         * 表示させる機能です。処理時間の目安になります。
578         * (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
579         *
580         * @og.rev 6.3.6.0 (2015/08/16) useTimeView の初期値を、VIEW_USE_TIMEBAR にする。
581         *
582         * @param       flag    処理時間を表示 [true:する/false:しない]
583         */
584        public void setUseTimeView( final String flag ) {
585                useTimeView = nval( getRequestParameter( flag ),useTimeView );
586        }
587
588        /**
589         * このオブジェクトの文字列表現を返します。
590         * 基本的にデバッグ目的に使用します。
591         *
592         * @return このクラスの文字列表現
593         * @og.rtnNotNull
594         */
595        @Override
596        public String toString() {
597                return ToString.title( this.getClass().getName() )
598                                .println( "VERSION"                     ,VERSION                )
599                                .println( "dbid"                        ,dbid                   )
600        //                      .println( "clmKeys"                     ,clmKeys                )
601                                .println( "sql"                         ,sql                    )
602                                .println( "commitBatch"         ,commitBatch    )
603                                .println( "Other..."            ,getAttributes().getAttribute() )
604                                .fixForm().toString() ;
605        }
606}