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.process;
017
018import org.opengion.fukurou.system.OgRuntimeException ;         // 6.4.2.0 (2016/01/29)
019import org.opengion.fukurou.util.Argument;
020import org.opengion.fukurou.util.SystemParameter;
021import org.opengion.fukurou.util.StringUtil;
022import org.opengion.fukurou.system.LogWriter;
023import org.opengion.fukurou.util.HybsEntry ;
024import org.opengion.fukurou.system.Closer;
025import org.opengion.fukurou.model.Formatter;
026import org.opengion.fukurou.db.ConnectionFactory;
027
028import java.util.Map ;
029import java.util.LinkedHashMap ;
030import java.util.Set ;
031import java.util.HashSet ;
032
033import java.sql.Connection;
034import java.sql.Statement;
035import java.sql.PreparedStatement;
036import java.sql.ParameterMetaData;
037import java.sql.SQLException;
038
039/**
040 * Process_DBWriter は、上流から受け取ったデータをデータベースに書き込む
041 * CainProcess インターフェースの実装クラスです。
042 *
043 * 上流(プロセスチェインのデータは上流から下流へと渡されます。)から受け取った
044 * LineModel を元に、データベースへの書き込みを行います。
045 *
046 * データベース接続先等は、ParamProcess のサブクラス(Process_DBParam)に
047 * 設定された接続(Connection)を使用します。
048 *
049 * 引数文字列中にスペースを含む場合は、ダブルコーテーション("") で括って下さい。
050 * 引数文字列の 『=』の前後には、スペースは挟めません。必ず、-key=value の様に
051 * 繋げてください。
052 *
053 * SQL文には、{@DATE.YMDH}等のシステム変数が使用できます。
054 *
055 * @og.formSample
056 *  Process_DBWriter -dbid=DBGE -table=GE41
057 *
058 *   [ -dbid=DB接続ID            ] : -dbid=DBGE (例: Process_DBParam の -configFile で指定する DBConfig.xml ファイルで規定)
059 *   [ -table=登録テーブルID     ] : SQL文を指定する場合は不要。INSERT する場合のテーブルID
060 *   [ -sql=検索SQL文            ] : -sql="UPDATE GE41 SET NAME_JA = [NAME_JA],LABEL_NAME = [LABEL_NAME]
061 *                                         WHERE SYSTEM_ID = [SYSTEM_ID] AND CLM = [CLM]"
062 *   [ -sqlFile=登録SQLファイル      ] : -sqlFile=update.sql
063 *                                 :   -sql や -sqlFile が指定されない場合は、-table で指定のテーブルに全カラム insert です。
064 *   [ -sql_XXXX=固定値          ] : -sql_SYSTEM_ID=GE
065 *                                     SQL文中の{@XXXX}文字列を指定の固定値で置き換えます。
066 *                                     WHERE SYSTEM_ID='{@SYSTEM_ID}' ⇒ WHERE SYSTEM_ID='GE'
067 *   [ -const_XXXX=固定値        ] : -const_FGJ=1
068 *                                     LineModel のキー(const_ に続く文字列)の値に、固定値を設定します。
069 *                                     キーが異なれば、複数のカラム名を指定できます。
070 *   [ -omitClms=AAA,BBB,…      ] : -omitClms=UNIQ,FGJ,DYSET
071 *                                     -table 属性でINSERT文を自動作成する場合、取り除くカラム名を
072 *                                     CSV形式で複数指定できます。
073 *   [ -initSql=開始時SQL文      ] : -initSql="DELETE FROM GE41 WHERE FGJ = '9'"
074 *   [ -initSqlFile=開始時SQLファイル] : -initSqlFile=update.sql
075 *   [ -endSql=終了時SQL文       ] : -endSql="UPDATE GE41 SET FGJ = '1'"
076 *   [ -endSqlFile=終了時SQLファイル ] : -endSqlFile=update.sql
077 *   [ -commitCnt=commit処理指定 ] : 指定数毎にコミットを発行します。0 の場合は、終了までコミットしません。
078 *   [ -display=[false/true]     ] : 結果を標準出力に表示する(true)かしない(false)か(初期値:false[表示しない])
079 *   [ -debug=[false/true]       ] :デバッグ情報を標準出力に表示する(true)かしない(false)か(初期値:false[表示しない])
080 *
081 * @version  4.0
082 * @author   Kazuhiko Hasegawa
083 * @since    JDK5.0,
084 */
085public class Process_DBWriter extends AbstractProcess implements ChainProcess {
086        private static final String CNST_KEY = "const_" ;
087        private static final String SQL_KEY  = "sql_" ;
088
089        private Connection      connection      ;
090        private PreparedStatement pstmt ;
091        private ParameterMetaData pMeta ;               // 5.1.1.0 (2009/11/11) setObject に、Type を渡す。(PostgreSQL対応)
092        private boolean useParamMetaData;               // 5.1.1.0 (2009/11/11) setObject に、Type を渡す。(PostgreSQL対応)
093
094        private String          dbid            ;
095        private String          sql                     ;
096        private String          endSql          ;               // 5.7.2.2 (2014/01/24) 追加
097        private String          table           ;
098        private int[]           clmNos          ;               // ファイルのヘッダーのカラム番号
099        private int                     commitCnt       ;               // コミットするまとめ件数
100        private boolean         display         ;               // false:表示しない
101        private boolean         debug           ;               // 5.7.3.0 (2014/02/07) デバッグ情報
102
103        private String[]        cnstClm         ;               // 固定値を設定するカラム名
104        private int[]           cnstClmNos      ;               // 固定値を設定するカラム番号
105        private String[]        constVal        ;               // カラム番号に対応した固定値
106
107        private boolean         firstRow        = true; // 最初の一行目
108        private int                     count           ;
109        private String[]        omitClms        ;               // 4.0.0.0 (2007/09/21) table 指定時に取り除くカラム
110
111        /** staticイニシャライザ後、読み取り専用にするので、ConcurrentHashMap を使用しません。 */
112        private static final Map<String,String> MUST_PROPARTY   ;               // [プロパティ]必須チェック用 Map
113        /** staticイニシャライザ後、読み取り専用にするので、ConcurrentHashMap を使用しません。 */
114        private static final Map<String,String> USABLE_PROPARTY ;               // [プロパティ]整合性チェック Map
115
116        static {
117                MUST_PROPARTY = new LinkedHashMap<>();
118
119                USABLE_PROPARTY = new LinkedHashMap<>();
120                USABLE_PROPARTY.put( "dbid",    "Process_DBParam の -configFile で指定する DBConfig.xml ファイルで規定" );
121                USABLE_PROPARTY.put( "table",           "INSERT する場合のテーブルID SQL文を指定する場合は不要。" );
122                USABLE_PROPARTY.put( "sql",                     "更新SQL文(sql or sqlFile 必須)" +
123                                                                        CR + "例: \"UPDATE GE41 " +
124                                                                        CR + "SET NAME_JA = [NAME_JA],LABEL_NAME = [LABEL_NAME] " +
125                                                                        CR + "WHERE SYSTEM_ID = [SYSTEM_ID] AND CLM = [CLM]\"" );
126                USABLE_PROPARTY.put( "sqlFile",         "登録SQLファイル(sql or sqlFile 必須)例: update.sql" );
127                USABLE_PROPARTY.put( "sql_",            "SQL文中の{&#064;XXXX}文字列を指定の固定値で置き換えます。" +
128                                                                        CR + "WHERE SYSTEM_ID='{&#064;SYSTEM_ID}' ⇒ WHERE SYSTEM_ID='GE'" );
129                USABLE_PROPARTY.put( "const_",  "LineModel のキー(const_ に続く文字列)の値に、固定値を" +
130                                                                        CR + "設定します。キーが異なれば、複数のカラム名を指定できます。" +
131                                                                        CR + "例: -sql_SYSTEM_ID=GE" );
132                // 4.0.0.0 (2007/09/21) 属性を追加
133                USABLE_PROPARTY.put( "omitClms",        "-table 属性でINSERT文を自動作成する場合、取り除くカラム名を" +
134                                                                        CR + "CSV形式で複数指定できます。" +
135                                                                        CR + "例: -omitClms=UNIQ,FGJ,DYSET" );
136                USABLE_PROPARTY.put( "initSql"   ,      "開始時に一度だけ実行されるSQL文を指定します。" );                   // 5.7.2.2 (2014/01/24) 追加
137                USABLE_PROPARTY.put( "initSqlFile",     "開始時に一度だけ実行されるSQLファイルを指定します。" );        // 5.7.2.2 (2014/01/24) 追加
138                USABLE_PROPARTY.put( "endSql"    ,      "終了時に一度だけ実行されるSQL文を指定します。" );                   // 5.7.2.2 (2014/01/24) 追加
139                USABLE_PROPARTY.put( "endSqlFile" ,     "終了時に一度だけ実行されるSQLファイルを指定します。" );        // 5.7.2.2 (2014/01/24) 追加
140                USABLE_PROPARTY.put( "commitCnt",       "指定数毎にコミットを発行します。" +
141                                                                        CR + "0 の場合は、終了までコミットしません(初期値:0)" );
142                USABLE_PROPARTY.put( "display", "結果を標準出力に表示する(true)かしない(false)か" +
143                                                                                CR + "(初期値:false:表示しない)" );
144                USABLE_PROPARTY.put( "debug",   "デバッグ情報を標準出力に表示する(true)かしない(false)か" +
145                                                                                CR + "(初期値:false:表示しない)" );             // 5.7.3.0 (2014/02/07) デバッグ情報
146        }
147
148        /**
149         * デフォルトコンストラクター。
150         * このクラスは、動的作成されます。デフォルトコンストラクターで、
151         * super クラスに対して、必要な初期化を行っておきます。
152         *
153         */
154        public Process_DBWriter() {
155                super( "org.opengion.fukurou.process.Process_DBWriter",MUST_PROPARTY,USABLE_PROPARTY );
156        }
157
158        /**
159         * プロセスの初期化を行います。初めに一度だけ、呼び出されます。
160         * 初期処理(ファイルオープン、DBオープン等)に使用します。
161         *
162         * @og.rev 4.0.0.0 (2007/09/21) omitClms 属性を追加
163         * @og.rev 5.1.1.0 (2009/11/11) setObject に ParameterMetaData の getParameterType を渡す。(PostgreSQL対応)
164         * @og.rev 5.3.8.0 (2011/08/01) useParamMetaData を ConnectionFactory経由で取得。(PostgreSQL対応)
165         * @og.rev 5.7.2.2 (2014/01/24) initSql,initSqlFile,endSql,endSqlFile 追加
166         *
167         * @param   paramProcess データベースの接続先情報などを持っているオブジェクト
168         */
169        public void init( final ParamProcess paramProcess ) {
170                final Argument arg = getArgument();
171
172                table           = arg.getProparty("table");
173                sql                     = arg.getFileProparty("sql","sqlFile",false);
174                endSql          = arg.getFileProparty("endSql","endSqlFile",false);             // 5.7.2.2 (2014/01/24) 追加
175                commitCnt       = arg.getProparty("commitCnt",commitCnt);
176                display         = arg.getProparty("display",display);
177                debug           = arg.getProparty("debug",debug);                               // 5.7.3.0 (2014/02/07) デバッグ情報
178
179                dbid            = arg.getProparty("dbid");
180                connection      = paramProcess.getConnection( dbid );
181                // 5.1.1.0 (2009/11/11) setObject に ParameterMetaData の getParameterType を渡す。(PostgreSQL対応)
182                useParamMetaData = ConnectionFactory.useParameterMetaData( dbid );      // 5.3.8.0 (2011/08/01)
183
184                // 取り除くカラム名リストを配列に変換します。
185                final String tempClms   = arg.getProparty("omitClms",null);
186                if( tempClms != null ) {
187                        omitClms = StringUtil.csv2Array( tempClms );
188                }
189
190                if( sql == null && table == null ) {
191                        final String errMsg = "sql を指定しない場合は、table を必ず指定してください。";
192                        throw new OgRuntimeException( errMsg );
193                }
194
195                // 3.8.0.1 (2005/06/17) {@DATE.XXXX} 変換処理の追加
196                // {@DATE.YMDH} などの文字列を、yyyyMMddHHmmss 型の日付に置き換えます。
197                // SQL文の {@XXXX} 文字列の固定値への置き換え
198                final HybsEntry[] entry =arg.getEntrys(SQL_KEY);                // 配列
199                final SystemParameter sysParam = new SystemParameter( sql );
200                sql = sysParam.replace( entry );
201
202                // 5.7.2.2 (2014/01/24) initSql,endSql にも{@XXXX} 文字列の置き換えを行います。
203                String initSql = arg.getFileProparty("initSql","initSqlFile",false);    // 5.7.2.2 (2014/01/24) 追加
204                if( initSql != null ) {
205                        final SystemParameter sysParam2 = new SystemParameter( initSql );
206                        initSql = sysParam2.replace( entry );
207                        execSql( initSql );
208                }
209                if( endSql != null ) {
210                        final SystemParameter sysParam3 = new SystemParameter( endSql );
211                        endSql = sysParam3.replace( entry );
212                }
213
214                final HybsEntry[] cnstKey = arg.getEntrys( CNST_KEY );          // 配列
215                final int csize = cnstKey.length;
216                cnstClm         = new String[csize];
217                constVal        = new String[csize];
218                for( int i=0; i<csize; i++ ) {
219                        cnstClm[i]  = cnstKey[i].getKey();
220                        constVal[i] = cnstKey[i].getValue();
221                }
222        }
223
224        /**
225         * プロセスの終了を行います。最後に一度だけ、呼び出されます。
226         * 終了処理(ファイルクローズ、DBクローズ等)に使用します。
227         *
228         * @og.rev 4.0.0.0 (2007/11/27) commit,rollback,remove 処理を追加
229         * @og.rev 5.1.1.0 (2009/11/11) pMeta のクリア
230         * @og.rev 5.7.2.2 (2014/01/24) endSql 処理の追加
231         * @og.rev 6.9.4.1 (2018/04/09) DB_BATCH_SIZE 指定を行います。
232         *
233         * @param   isOK トータルで、OKだったかどうか[true:成功/false:失敗]
234         */
235        public void end( final boolean isOK ) {
236                Throwable th2 = null;
237
238                // 6.9.8.0 (2018/05/28) FindBugs:コンストラクタで初期化されていないフィールドを null チェックなしで null 値を利用している
239                // この、pstmt の nullチェックは、端数処理されない場合の対応なので、AND で判定しても良い。
240//              if( isOK ) {
241                if( isOK && pstmt != null ) {
242                        try {
243                                // 6.9.4.1 (2018/04/09) DB_BATCH_SIZE で、なぜか、端数が処理されない。
244                                pstmt.executeBatch();                           // 6.9.4.1 (2018/04/09) 更新件数を数えない。
245                        }
246                        catch( final Throwable th ) { th2 = th ; }
247                }
248
249                final boolean flag = Closer.stmtClose( pstmt );
250                pstmt = null;
251                pMeta = null;           // 5.1.1.0 (2009/11/11)
252
253//              // 5.7.2.2 (2014/01/24) endSql の実行
254//              Throwable th2 = null;
255
256//              if( isOK && endSql != null ) {
257                if( isOK && endSql != null && th2 == null ) {
258                        try { execSql( endSql ); } catch( final Throwable th) { th2 = th ; }
259                }
260
261                // 5.7.2.2 (2014/01/24) すべて異常がない場合のみ、処理する様に変更。
262                if( isOK && flag && th2 == null ) {
263                        Closer.commit( connection );
264                }
265                else {
266                        Closer.rollback( connection );
267                }
268                ConnectionFactory.remove( connection,dbid );
269
270                if( !flag ) {
271                        final String errMsg = "ステートメントをクローズ出来ません。";
272                        throw new OgRuntimeException( errMsg );
273                }
274
275                // 5.7.2.2 (2014/01/24) endSql の実行失敗時の処理
276                if( th2 != null ) {
277                        final String errMsg = "endSql の実行に失敗しました。sql=[" + endSql + "]" + CR
278                                                                + th2.getMessage() + CR ;
279                        throw new OgRuntimeException( errMsg,th2 );
280                }
281        }
282
283        /**
284         * 引数の LineModel を処理するメソッドです。
285         * 変換処理後の LineModel を返します。
286         * 後続処理を行わない場合(データのフィルタリングを行う場合)は、
287         * null データを返します。つまり、null データは、後続処理を行わない
288         * フラグの代わりにも使用しています。
289         * なお、変換処理後の LineModel と、オリジナルの LineModel が、
290         * 同一か、コピー(クローン)かは、各処理メソッド内で決めています。
291         * ドキュメントに明記されていない場合は、副作用が問題になる場合は、
292         * 各処理ごとに自分でコピー(クローン)して下さい。
293         *
294         * @og.rev 5.1.1.0 (2009/11/11) setObject に ParameterMetaData の getParameterType を渡す。(PostgreSQL対応)
295         * @og.rev 5.3.8.0 (2011/08/01) useParamMetaData  setNull 対応(PostgreSQL対応)
296         * @og.rev 5.7.2.2 (2014/01/24) SQL実行エラーを少し詳細に出力します。
297         * @og.rev 6.9.4.1 (2018/04/09) DB_BATCH_SIZE 指定を行います。
298         *
299         * @param       data    オリジナルのLineModel
300         *
301         * @return      処理変換後のLineModel
302         */
303        public LineModel action( final LineModel data ) {
304                count++ ;
305                try {
306                        if( firstRow ) {
307                                pstmt = makePrepareStatement( table,data );
308                                // 5.1.1.0 (2009/11/11) setObject に ParameterMetaData の getParameterType を渡す。(PostgreSQL対応)
309                                if( useParamMetaData ) {
310                                        pMeta = pstmt.getParameterMetaData();
311                                }
312
313                                final int size   = cnstClm.length;
314                                cnstClmNos = new int[size];
315                                for( int i=0; i<size; i++ ) {
316                                        cnstClmNos[i] = data.getColumnNo( cnstClm[i] );
317                                }
318
319                                firstRow = false;
320                                if( display ) { println( data.nameLine() ); }           // 5.7.3.0 (2014/02/07) デバッグ情報
321                        }
322
323                        // 固定値置き換え処理
324                        for( int j=0; j<cnstClmNos.length; j++ ) {
325                                data.setValue( cnstClmNos[j],constVal[j] );
326                        }
327
328                        // 5.1.1.0 (2009/11/11) setObject に ParameterMetaData の getParameterType を渡す。(PostgreSQL対応)
329                        if( useParamMetaData ) {
330                                for( int i=0; i<clmNos.length; i++ ) {
331                                        final int type = pMeta.getParameterType( i+1 );
332                                        // 5.3.8.0 (2011/08/01) setNull 対応
333                                        final Object val = data.getValue(clmNos[i]);
334//                                      if( val == null || ( val instanceof String && ((String)val).isEmpty() ) ) {
335                                        if( val == null || val instanceof String && ((String)val).isEmpty() ) {                         // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
336                                                pstmt.setNull( i+1, type );
337                                        }
338                                        else {
339                                                pstmt.setObject( i+1, val, type );
340                                        }
341                                }
342                        }
343                        else {
344                                for( int i=0; i<clmNos.length; i++ ) {
345                                        pstmt.setObject( i+1,data.getValue(clmNos[i]) );
346                                }
347                        }
348                        pstmt.addBatch();                                               // 6.9.4.1 (2018/04/09) DB_BATCH_SIZE 指定
349//                      pstmt.execute();
350                        if( count%DB_BATCH_SIZE == 0 ) {                // 6.9.4.1 (2018/04/09) countは、先に++ されている。
351                                pstmt.executeBatch();                           // 6.9.4.1 (2018/04/09) 更新件数を数えない。
352                        }
353
354                        if( commitCnt > 0 && ( count%commitCnt == 0 ) ) {
355                                Closer.commit( connection );
356                        }
357                }
358                catch( final SQLException ex) {
359                        // 5.7.2.2 (2014/01/24) SQL実行エラーを少し詳細に出力します。
360                        final String errMsg = "SQL を実行できませんでした。" + CR
361                                                                + "errMsg=[" + ex.getMessage() + "]" + CR
362                                                                + "errCode=[" + ex.getErrorCode() + "] State=[" + ex.getSQLState() + "]" + CR
363                                                                + "dbid=[" + dbid + "]" + CR
364                                                                + "sql =[" + sql + "]" + CR
365                                                                + "data=[" + data.dataLine() + "]" + CR ;
366                        throw new OgRuntimeException( errMsg,ex );
367                }
368
369                if( display ) { println( data.dataLine() ); }   // 5.1.2.0 (2010/01/01) display の条件変更
370                return data;
371        }
372
373        /**
374         * 内部で使用する PreparedStatement を作成します。
375         * 引数指定の SQL または、LineModel から作成した SQL より構築します。
376         *
377         * @og.rev 4.0.0.0 (2007/09/21) omitClms 属性を追加
378         * @og.rev 5.7.2.2 (2014/01/24) SQL実行エラーを少し詳細に出力します。
379         * @og.rev 6.2.3.0 (2015/05/01) CSV形式の作成を、String#join( CharSequence , CharSequence... )を使用。
380         * @og.rev 6.4.3.4 (2016/03/11) Formatterに新しいコンストラクターを追加する。
381         *
382         * @param       table   処理対象のテーブルID
383         * @param       data    処理対象のLineModel
384         *
385         * @return  PreparedStatementオブジェクト
386         */
387        private PreparedStatement makePrepareStatement( final String table,final LineModel data ) {
388                if( sql == null ) {
389                        String[] names = data.getNames();
390
391                        // カラムを取り除く場合
392                        if( omitClms != null ) {
393                                final Set<String> set = new HashSet<>();
394                                for( int i=0; i<names.length; i++ ) {
395                                        set.add( names[i] );
396                                }
397                                for( int i=0; i<omitClms.length; i++ ) {
398                                        set.remove( omitClms[i] );
399                                }
400                                names = set.toArray( new String[set.size()] );
401                        }
402                        final int size = names.length;
403
404                // 6.2.3.0 (2015/05/01) CSV形式の作成を、String#join( CharSequence , CharSequence... )を使用。
405                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
406                                .append( "INSERT INTO " ).append( table ).append( " (" )
407                                .append( String.join( "," , names ) )           // 6.2.3.0 (2015/05/01)
408                                .append( " ) VALUES ( ?" );
409                        for( int i=1; i<size; i++ ) {
410                                buf.append( ",?" );
411                        }
412                        buf.append( " )" );
413                        sql = buf.toString();
414
415                        // カラム番号を設定します。
416                        clmNos = new int[size];
417                        for( int i=0; i<size; i++ ) {
418                                clmNos[i] = data.getColumnNo( names[i] );               // 4.0.0.0 (2007/09/21)
419                        }
420                }
421                else {
422                        final Formatter format = new Formatter( data,sql );     // 6.4.3.4 (2016/03/11)
423                        sql = format.getQueryFormatString();
424                        clmNos = format.getClmNos();
425                }
426
427                final PreparedStatement ps ;
428                try {
429                        ps = connection.prepareStatement( sql );
430                }
431                catch( final SQLException ex) {
432                        // 5.7.2.2 (2014/01/24) SQL実行エラーを少し詳細に出力します。
433                        final String errMsg = "PreparedStatement を取得できませんでした。" + CR
434                                                                + "errMsg=[" + ex.getMessage() + "]" + CR
435                                                                + "errCode=[" + ex.getErrorCode() + "] State=[" + ex.getSQLState() + "]" + CR
436                                                                + "dbid =[" + dbid + "]" + CR
437                                                                + "sql  =[" + sql + "]" + CR
438                                                                + "table=[" + table + "]" + CR
439                                                                + "data =[" + data.dataLine() + "]" + CR ;
440                        throw new OgRuntimeException( errMsg,ex );
441                }
442
443                return ps;
444        }
445
446        /**
447         * SQL処理を実行します。
448         * 主に、initSql,endSqlの実行用です。
449         * ここでは、エラーが発生しても、connection は閉じません。
450         * 最終的に、endメソッドで処理されるためです。
451         *
452         * @og.rev 5.7.2.2 (2014/01/24) 新規追加
453         * @og.rev 6.4.2.1 (2016/02/05) try-with-resources 文で記述。
454         *
455         * @param   sql 実行するSQL文
456         */
457        private void execSql( final String sql ) {
458                // 6.4.2.1 (2016/02/05) try-with-resources 文
459                try( Statement stmt = connection.createStatement() ) {
460                        stmt.execute( sql );
461                }
462                catch( final SQLException ex) {         // catch は、close() されてから呼ばれます。
463                        // 5.7.2.2 (2014/01/24) SQL実行エラーを少し詳細に出力します。
464                        final String errMsg = "SQL を実行できませんでした。" + CR
465                                                                + "errMsg=[" + ex.getMessage() + "]" + CR
466                                                                + "errCode=[" + ex.getErrorCode() + "] State=[" + ex.getSQLState() + "]" + CR
467                                                                + "dbid=[" + dbid + "]" + CR
468                                                                + "sql =[" + sql + "]" + CR ;
469                        throw new OgRuntimeException( errMsg,ex );
470                }
471        }
472
473        /**
474         * プロセスの処理結果のレポート表現を返します。
475         * 処理プログラム名、入力件数、出力件数などの情報です。
476         * この文字列をそのまま、標準出力に出すことで、結果レポートと出来るような
477         * 形式で出してください。
478         *
479         * @return   処理結果のレポート
480         */
481        public String report() {
482                // 7.2.9.5 (2020/11/28) PMD:Consider simply returning the value vs storing it in local variable 'XXXX'
483                return "[" + getClass().getName() + "]" + CR
484//              final String report = "[" + getClass().getName() + "]" + CR
485                                                        + TAB + "DBID         : " + dbid + CR
486                                                        + TAB + "Output Count : " + count ;
487
488//              return report ;
489        }
490
491        /**
492         * このクラスの使用方法を返します。
493         *
494         * @return      このクラスの使用方法
495         * @og.rtnNotNull
496         */
497        public String usage() {
498                final StringBuilder buf = new StringBuilder( BUFFER_LARGE )
499                        .append( "Process_DBWriter は、上流から受け取ったデータをデータベースに書き込む"          ).append( CR )
500                        .append( "CainProcess インターフェースの実装クラスです。"                                                                ).append( CR )
501                        .append( CR )
502                        .append( "上流(プロセスチェインのデータは上流から下流へと渡されます。)から"                            ).append( CR )
503                        .append( "受け取った LineModel を元に、データベースへの書き込みを行います。"                       ).append( CR )
504                        .append( CR )
505                        .append( "データベース接続先等は、ParamProcess のサブクラス(Process_DBParam)に"                    ).append( CR )
506                        .append( "設定された接続(Connection)を使用します。"                                                                           ).append( CR )
507                        .append( CR )
508                        .append( "引数文字列中に空白を含む場合は、ダブルコーテーション(\"\") で括って下さい。"    ).append( CR )
509                        .append( "引数文字列の 『=』の前後には、空白は挟めません。必ず、-key=value の様に"           ).append( CR )
510                        .append( "繋げてください。"                                                                                                                             ).append( CR )
511                        .append( CR )
512                        .append( "SQL文には、{@DATE.YMDH}等のシステム変数が使用できます。"                                          ).append( CR )
513                        .append( CR ).append( CR )
514                        .append( getArgument().usage() ).append( CR );
515
516                return buf.toString();
517        }
518
519        /**
520         * このクラスは、main メソッドから実行できません。
521         *
522         * @param       args    コマンド引数配列
523         */
524        public static void main( final String[] args ) {
525                LogWriter.log( new Process_DBWriter().usage() );
526        }
527}