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