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.fukurou.system.OgCharacterException ; // 6.5.0.1 (2016/10/21) 020import org.opengion.fukurou.system.ThrowUtil ; // 6.4.2.0 (2016/01/29) 021import org.opengion.fukurou.util.ErrorMessage; 022import org.opengion.fukurou.util.StringUtil ; 023import org.opengion.fukurou.util.ToString; // 6.1.1.0 (2015/01/17) 024import org.opengion.fukurou.util.FileInfo; // 6.2.0.0 (2015/02/27) 025import org.opengion.fukurou.util.ArraySet; // 6.4.3.4 (2016/03/11) 026import org.opengion.hayabusa.common.HybsSystem; 027import org.opengion.hayabusa.common.HybsSystemException; 028import org.opengion.hayabusa.common.HybsOverflowException; // 6.2.2.0 (2015/03/27) 029import org.opengion.hayabusa.db.DBTableModelUtil; // 6.2.1.0 (2015/03/13) 030import org.opengion.hayabusa.db.DBTableModel; 031import org.opengion.hayabusa.db.DBColumn; 032import org.opengion.hayabusa.db.ColumnActionListener; // 6.2.2.0 (2015/03/27) 033import org.opengion.hayabusa.io.TableReader; 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.util.Locale ; 039import java.util.List ; // 6.2.5.0 (2015/06/05) 040import java.util.Set; // 6.4.3.4 (2016/03/11) 041import java.util.ArrayList ; // 6.2.5.0 (2015/06/05) 042import java.util.Map; // 6.4.6.0 (2016/05/27) 043import java.util.HashMap ; // 6.4.6.0 (2016/05/27) 044import java.io.File; 045 046/** 047 * 指定のファイルを DBTableModelオブジェクトに読み取るファイル入力タグです。 048 * 049 * データ(DBTableModel)と、コントローラ(ReadTableタグ)を与えて、外部からコントロールすることで、 050 * 各種形式で データ(DBTableModel)を表示させることが できます。 051 * ReadTableタグ に対して、コマンドを与えることにより、内部のコントローラの実装に対応した 052 * 形式でデータを作成します。 053 * すべての読取の初期クラス名を リソースファイルの TABLE_READER_DEFAULT_CLASS で指定可能です。 054 * その場合、AutoReader を指定すると、Excel と Text(テキスト) を以下の順番で試します。 055 * Excel,Calc,Text(UnicodeLittle),Text(Windows-31J),Text(UTF-8),Text(EUC-JP),POI 056 * UTF-8 のTEXTとWindows-31JのTEXTは、ヘッダー部での区別ができないため、正確なTextの自動読取できません。 057 * 058 * ※ 6.2.5.0 (2015/06/05) 仕様変更 059 * ・AutoReader で、encode を指定すると、Text(encode) を先に試します。 060 * ・Textで、encode を指定しない場合は、システム変数の FILE_ENCODE を使用します。 061 * 062 * 入力件数を"DB.COUNT" キーでリクエストにセットしています。 063 * 064 * @og.formSample 065 * ●形式: 066 * <og:readTable 067 * command = "NEW" 068 * fileURL = "{@USER.ID}" 読取元ディレクトリ名 069 * filename = "{@filename}" 読取元ファイル名 070 * encode = "UnicodeLittle" 読取元ファイルエンコード名 071 * maxRowCount = "10000" 読取最大件数(初期値:0:[無制限]) 072 * /> 073 * ●body:なし 074 * 075 * ●Tag定義: 076 * <og:readTable 077 * readerClass 【TAG】実際に読み出すクラス名の略称(TableReader_**** の ****)をセットします 078 * (初期値:TABLE_READER_DEFAULT_CLASS[={@og.value SystemData#TABLE_READER_DEFAULT_CLASS}]) 079 * command 【TAG】コマンド (NEW,RENEW)をセットします(初期値:NEW) 080 * fileURL 【TAG】読取元ディレクトリ名を指定します(初期値:FILE_URL) 081 * filename 【TAG】ファイルを読み出すときのファイル名をセットします (初期値:FILE_FILENAME[=file.xls]) 082 * encode 【TAG】ファイルを読み出すときのファイルエンコーディング名をセットします(初期値:FILE_ENCODE) 083 * skipRowCount 【TAG】(通常は使いません)データの読み飛ばし件数を設定します 084 * maxRowCount 【TAG】読取時の最大取り込み件数をセットします (初期値:0:[無制限]) 085 * errRowCount 【TAG】読取時の最大エラー件数をセットします (初期値:{@og.value #ERROR_ROW_COUNT})(0:[無制限]) 086 * separator 【TAG】可変長ファイルを読み出すときの項目区切り文字をセットします 087 * columns 【TAG】読取元ファイルのカラム列を、外部(タグ)よりCSV形式で指定します 088 * omitNames 【TAG】読取対象外のカラム列を、外部(タグ)よりCSV形式で指定します 089 * modifyType 【TAG】ファイル取り込み時の モディファイタイプ(A(追加),C(更新),D(削除))を指定します 090 * displayMsg 【TAG】query の結果を画面上に表示するメッセージIDを指定します(初期値:VIEW_DISPLAY_MSG[={@og.value SystemData#VIEW_DISPLAY_MSG}])) 091 * overflowMsg 【TAG】読取データが最大検索数をオーバーした場合に表示するメッセージリソースIDを指定します (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました]) 092 * notfoundMsg 【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした]) 093 * ※ sheetName 【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし) 094 * ※ sheetNos 【TAG】EXCELファイルを読み込むときのシート番号を複数設定できます(初期値:0) 095 * ※ sheetConstKeys 【TAG】EXCELファイルを読み込むときの固定値となるカラム名(CSV形式) 096 * ※ sheetConstAdrs 【TAG】EXCELファイルを読み込むときの固定値となるアドレス(行-列,行-列,・・・) 097 * nullBreakClm 【TAG】カラム列に NULL が現れた時点で読取を中止します(複数Sheetの場合は、次のSheetを読みます)。 098 * nullSkipClm 【TAG】カラム列に NULL が現れたレコードは読み飛ばします。 099 * useNumber 【TAG】行番号情報を、使用している/していない[true/false]を指定します(初期値:true) 100 * useRenderer 【TAG】読取処理でKEY:VAL形式のコードリソースから、KEYを取り出す処理を行うかどうかを指定します(初期値:USE_TABLE_READER_RENDERER[=false]) 101 * adjustColumns 【TAG】読取元ファイルのデータ変換を行うカラム列をカンマ指定します("*" で全カラム) 102 * checkColumns 【TAG】読取元ファイルの整合性チェックを行うカラム列をカンマ指定します("*" で全カラム) 103 * nullCheck 【TAG】NULL チェックすべきカラム列をCSV形式(CSV形式)で指定します 104 * matchKeys 【TAG】レコードの読取条件指定時のカラム列をCSV形式で指定します 6.4.6.0 (2016/05/27) 105 * matchVals 【TAG】レコードの読取条件指定時のカラム列に対応する正規表現データをCSV形式で指定します 6.4.6.0 (2016/05/27) 106 * language 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します 107 * stopZero 【TAG】読込件数が0件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する]) 108 * mainTrans 【TAG】(通常は使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:false) 109 * tableId 【TAG】(通常は使いません)sessionから所得する DBTableModelオブジェクトの ID 110 * scope 【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session) 111 * useSLabel 【TAG】7.0.7.0 (2019/12/13) エラーメッセージにSLABELを利用するかどうか[true/false]を指定します(初期値:false) 112 * caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 5.7.7.2 (2014/06/20) 113 * caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20) 114 * caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20) 115 * caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20) 116 * caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない) 117 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) 118 * /> 119 * 120 * ●使用例 121 * 122 * <og:readTable 123 * command = "NEW" 124 * readerClass = "Text" テキストファイルの読取 125 * modifyType = "{@modifyType}" 読取時のモディファイタイプ(A,C等) 126 * fileURL = "{@USER.ID}" 読取元ディレクトリ名 127 * filename = "{@filename}" 読取元ファイル名 128 * encode = "Shift_JIS" 読取元ファイルエンコード名 129 * maxRowCount = "10000" 読取最大件数(0:[無制限]) 130 * columns = "OYA,KO,HJO,SU,DYSTR,DYEND" #NAME に対応するカラム列 131 * useNumber = "false" 行番号の存在しないデータを読取ます。 132 * adjustColumns = "OYA,KO,HJO,SU" データ変換するカラム列("*" で全カラム) 133 * checkColumns = "OYA,KO,HJO,SU" 整合性チェックするカラム列("*" で全カラム) 134 * nullCheck = "OYA,KO,SU" NULLチェックを実行します("*" で全カラム) 135 * stopZero = "true" 取得0件の場合に以降の処理を停止します 136 * skipRowCount = "4" データの読み飛ばし件数(読み込み開始は、この数字+1行目から) 137 * /> 138 * 139 * @og.group ファイル入力 140 * 141 * @version 4.0 142 * @author Kazuhiko Hasegawa 143 * @since JDK5.0, 144 */ 145public class ReadTableTag extends CommonTagSupport { 146 /** このプログラムのVERSION文字列を設定します。 {@value} */ 147 private static final String VERSION = "7.0.7.0 (2019/12/13)" ; 148 private static final long serialVersionUID = 707020191213L ; 149 150 private static final int ERROR_ROW_COUNT = 200 ; // 4.0.0 (2007/05/25) 151 152 /** command 引数に渡す事の出来る コマンド 新規作成 {@value} */ 153 public static final String CMD_NEW = "NEW" ; 154 /** command 引数に渡す事の出来る コマンド 再検索 {@value} */ 155 public static final String CMD_RENEW = "RENEW" ; 156 157 // 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 158 private static final Set<String> COMMAND_SET = new ArraySet<>( CMD_NEW , CMD_RENEW ); 159 160 // 6.2.0.0 (2015/02/27) AutoReaderの対応方法変更。拡張子に応じて、チェック対象を変更する。null は全対象 161 // 6.2.2.0 (2015/03/27) マクロ付Excel(.xlsm)対応 162 // 6.2.5.0 (2015/06/05) 文字列配列から、内部クラスに変更 163 // 6.4.5.1 (2016/04/28) 順番の変更と、CSV対応 164 165 private static final List<AutoReaderParam> AUTO_READER_PARAM = new ArrayList<>() ; 166 static { 167 AUTO_READER_PARAM.add( new AutoReaderParam( "Excel" , null , "xls,xlsx,xlsm" ) ); 168 AUTO_READER_PARAM.add( new AutoReaderParam( "CSV" , "Windows-31J" , "csv" ) ); // 6.4.5.1 (2016/04/28) 追加 169 AUTO_READER_PARAM.add( new AutoReaderParam( "CSV" , "UTF-8" , "csv" ) ); // 6.4.5.1 (2016/04/28) 追加 170 AUTO_READER_PARAM.add( new AutoReaderParam( "Text" , "UnicodeLittle" , null ) ); 171 AUTO_READER_PARAM.add( new AutoReaderParam( "Text" , "Windows-31J" , null ) ); 172 AUTO_READER_PARAM.add( new AutoReaderParam( "Text" , "UTF-8" , null ) ); 173 AUTO_READER_PARAM.add( new AutoReaderParam( "Text" , "EUC-JP" , null ) ); 174 AUTO_READER_PARAM.add( new AutoReaderParam( "POI" , null , "ppt,pptx,doc,docx,xls,xlsx,xlsm" ) ); // 6.2.5.0 (2015/06/05) 追加 175 AUTO_READER_PARAM.add( new AutoReaderParam( "Calc" , null , "ods" ) ); // 6.4.5.1 (2016/04/28) 位置変更 176 } 177 178 /** 項目区切り文字 */ 179 protected String separator = TableReader.TAB_SEPARATOR; // 項目区切り文字 6.2.0.0 (2015/02/27) protected化 180 private String fileURL = HybsSystem.sys( "FILE_URL" ); 181 private String filename = HybsSystem.sys( "FILE_FILENAME" ); // ファイル名 182 /** ファイルエンコーディング */ 183 protected String encode ; // 6.2.5.0 (2015/06/05) ファイルエンコーディング 184 /** 読取クラス名 */ 185 protected String readerClass ; // 6.2.0.0 (2015/02/27) protected化 186 /** 最大行 */ 187 protected int maxRowCount ; // 6.2.0.0 (2015/02/27) 初期値を無制限に変更 188 /** ディスプレイメッセージ */ 189 protected String displayMsg = HybsSystem.sys( "VIEW_DISPLAY_MSG" ); // 6.2.0.0 (2015/02/27) protected化 190 private String overflowMsg = "MSG0007"; // 検索結果が、制限行数を超えましたので、残りはカットされました。 191 private String notfoundMsg = "MSG0077"; // 対象データはありませんでした。 192 /** 実行件数 */ 193 protected int executeCount = -1; // 検索/実行件数 194 private String modifyType ; 195 196 private transient DBTableModel table ; 197 private String command = CMD_NEW; 198 private String tableId = HybsSystem.TBL_MDL_KEY ; 199 /** シート名 */ 200 protected String sheetName ; // 3.5.4.2 (2003/12/15) 201 /** シート番号 */ 202 protected String sheetNos ; // 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるようにする。 203 /** 固定値となるカラム名 */ 204 protected String sheetConstKeys ; // 5.5.8.2 (2012/11/09) 固定値となるカラム名(CSV形式) 205 /** 固定値となるアドレス */ 206 protected String sheetConstAdrs ; // 5.5.8.2 (2012/11/09) 固定値となるアドレス(行-列,行-列,・・・) 207 /** 取込み条件/Sheet BREAK条件 */ 208 protected String nullBreakClm ; // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件 209 /** 行読み飛ばし */ 210 protected String nullSkipClm ; // 6.2.3.0 (2015/05/01) 行読み飛ばし 211 212 /** 3.5.4.5 (2004/01/23) 外部よりカラム列(CSV形式)を指定できるようにする。 */ 213 protected String columns ; // 6.2.0.0 (2015/02/27) protected化 214 /** 6.1.0.0 (2014/12/26) 読取対象外のカラム列を、外部(タグ)より指定する。 */ 215 protected boolean useNumber = true; // 3.7.0.5 (2005/04/11) 216 /** stopZero属性 */ 217 protected boolean stopZero ; // 4.3.7.0 (2009/06/01) stopZero属性追加 218 219 private boolean isMainTrans = true; // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し 220 /** データの読み飛ばし設定 */ 221 protected int skipRowCount ; // 5.1.6.0 (2010/05/01) データの読み飛ばし設定 222 223 /** 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 */ 224 protected transient ColumnAction clmAct = new ColumnAction(); // 6.3.9.0 (2015/11/06) transient 追加 225 226 /** 6.3.6.1 (2015/08/28) DirectTableInsertTag でSQLException発生時にセットする。(暫定対応) */ 227 protected boolean sqlError ; // 6.3.6.1 (2015/08/28) 228 229 /** 7.0.7.0 (2019/12/13) エラーメッセージにSLABELを利用するかどうか[true/false]を指定します(初期値:false) */ 230 protected boolean useSLabel ; 231 232 /** 233 * デフォルトコンストラクター 234 * 235 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. 236 */ 237 public ReadTableTag() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 238 239 /** 240 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。 241 * 242 * @og.rev 3.0.1.4 (2003/03/17) displayMsg が 0Byteの場合は、件数も表示しないように変更。 243 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 244 * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader を、InputStream に変更。 245 * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream を、 BufferedReader に戻す。 246 * @og.rev 3.5.6.5 (2004/08/09) 暫定的に、DBTableModelを先行削除します。 247 * @og.rev 3.6.0.0 (2004/09/24) DBTableModel の先行削除は、scope="session" の場合のみ。 248 * @og.rev 3.6.0.2 (2004/10/04) 取り込み時チェック用に、checkColumns,adjustColumns 属性追加 249 * @og.rev 3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェックを行います。 250 * @og.rev 3.8.5.3 (2006/08/07) readerClassが "Excel"でエラーが発生したとき、もう一度Defaultで再読取を行います。 251 * @og.rev 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行います。 252 * @og.rev 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel ) 253 * @og.rev 4.3.1.1 (2008/10/08) columnsが指定されている場合は、AutoReader禁止 254 * @og.rev 4.3.7.0 (2009/06/01) stopZero機能,DB.COUNTリクエストキーへ読込件数セットを追加 255 * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。 256 * @og.rev 5.1.8.0 (2010/07/01) AutoReaderのCalc対応 257 * @og.rev 5.1.9.0 (2010/08/01) AutoReaderでのExceptionの判定をThrowableに変更 258 * @og.rev 5.7.1.2 (2013/12/20) tempMsg.toString() ⇒ errMsg 変更 259 * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加 260 * @og.rev 6.0.2.5 (2014/10/31) debug=true 時のエラー情報を増やします。 261 * @og.rev 6.2.0.0 (2015/02/27) TableReader クラスの呼び出し元メソッドの共通化(EXCEL,TEXT) 262 * @og.rev 6.2.0.0 (2015/02/27) EXCEL出力のparamLevel初期値変更 3:標準推奨 → 4:個人設定可 263 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 264 * @og.rev 6.2.3.0 (2015/05/01) 複数処理を考慮して、例外処理は発行しない。 265 * @og.rev 6.2.3.0 (2015/05/01) columnsが指定されていても、AutoReader を使えるようにします。 266 * @og.rev 6.2.4.2 (2015/05/29) エラーを画面に出します。 267 * @og.rev 6.2.5.0 (2015/06/05) AutoReaderの仕様変更。 268 * @og.rev 6.3.6.1 (2015/08/28) DirectTableInsertTag でSQLException発生時のみ throwする。 269 * @og.rev 6.4.2.0 (2016/01/29) StringUtil#ogStackTrace(Throwable) を、ThrowUtil#ogStackTrace(String,Throwable) に置き換え。 270 * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 271 * @og.rev 6.4.5.1 (2016/04/28) CSV 指定時は、readerClass="Text" , separator="," に、再設定します。 272 * @og.rev 6.5.0.1 (2016/10/21) Throwable ではなく、OgCharacterException をキャッチして、処理を継続します。 273 * @og.rev 7.0.4.0 (2019/05/31) encode指定時の処理順序変更 274 * @og.rev 7.0.5.0 (2019/09/09) OgCharacterExceptionでは、取りこぼしがあるため、OgRuntimeException も継続処理するように変更。 275 * 276 * @return 後続処理の指示 277 */ 278 @Override 279 public int doEndTag() { 280 debugPrint(); // 4.0.0 (2005/02/28) 281 // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加 282 if( !useTag() ) { return EVAL_PAGE ; } 283 284 int rtnCode = EVAL_PAGE; 285 286 if( check( command, COMMAND_SET ) ) { 287 useMainTrans( isMainTrans ); // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し 288 startQueryTransaction( tableId ); // 3.6.0.8 (2004/11/19) 289 290 // 3.5.6.5 (2004/08/09) 削除するのは、セッションのオブジェクトでよい。 291 // 3.6.0.0 (2004/09/24) 削除するのは、scope="session" の場合のみ。 292 if( "session".equals( getScope() ) ) { 293 removeSessionAttribute( tableId ); 294 removeSessionAttribute( HybsSystem.VIEWFORM_KEY ); 295 } 296 297 // 6.2.5.0 (2015/06/05) AutoReaderの仕様変更。 298 299 // 6.2.0.0 (2015/02/27) EXCEL出力のparamLevel初期値変更 3:標準推奨 → 4:個人設定可 300 if( readerClass == null ) { 301 readerClass = nval( sys( "TABLE_READER_DEFAULT_CLASS" ) , "AutoReader" ); 302 } 303 304 // ファイル の読み込み:AutoReader 処理 305 // 6.2.5.0 (2015/06/05) AutoReaderParam 内部クラスを使用します。 306 final List<AutoReaderParam> readerParam = new ArrayList<>() ; 307 308 if( "AutoReader".equalsIgnoreCase( readerClass ) ) { 309 // 4.3.1.1 (2008/10/08) 310 // // 6.2.3.0 (2015/05/01) columnsが指定されていても、AutoReader を使えるようにします。 311 // if( columns != null && columns.length() > 0 ) { 312 // final String errMsg = "columnsが指定されている場合は、readerClass=\"AutoReader\"は使えません"; 313 // throw new HybsSystemException( errMsg ); // 4.3.4.4 (2009/01/01) 314 // } 315 // 6.2.5.0 (2015/06/05) AutoReaderParam 内部クラスを使用します。 316 // 6.5.0.1 (2016/10/21) encode 指定時の優先は、拡張子が、txt か、csv のみとします。 317 // if( encode != null ) { readerParam.add( new AutoReaderParam( "Text" , encode , null ) ); } // encode 指定時は優先 318// if( encode != null ) { readerParam.add( new AutoReaderParam( "Text" , encode , "csv,txt,xls" ) ); } // encode 指定時は優先 319// if( encode != null ) { readerParam.add( new AutoReaderParam( "Text" , encode , "txt,csv,xls" ) ); } // encode 指定時は優先 7.0.4.0 (2019/05/31) 順序変更 320 if( encode != null ) { 321 readerParam.add( new AutoReaderParam( "Text" , encode , "txt,csv,xls" ) ); // encode 指定時は優先 7.0.4.0 (2019/05/31) 順序変更 322 readerParam.add( new AutoReaderParam( "Text" , encode , null ) ); // 7.1.0.0 (2020/01/20) 拡張子に関係ない分も追加 323 } 324 readerParam.addAll( AUTO_READER_PARAM ); // 標準のパラメータを追加します。 325 } 326 else { 327 // 6.2.5.0 (2015/06/05) readerClass が "Text" で、encode が null の場合は、FILE_ENCODE を使用する。 328 if( "Text".equalsIgnoreCase( readerClass ) && encode == null ) { encode = HybsSystem.sys( "FILE_ENCODE" ); } 329 readerParam.add( new AutoReaderParam( readerClass , encode , null ) ); 330 } 331 332 final String directory = HybsSystem.url2dir( fileURL ); 333 final File file = new File( directory,filename ); 334 335 final String sufix = FileInfo.getSUFIX( file ) ; // 6.2.3.0 (2015/05/01) 拡張子に応じて、チェックを変更する。 336 337 StringBuilder tempMsg = new StringBuilder( BUFFER_MIDDLE ); 338 // 6.2.5.0 (2015/06/05) AutoReaderParam 内部クラスを使用します。 339 for( final AutoReaderParam arParam : readerParam ) { 340 // 6.2.0.0 (2015/02/27) 拡張子に応じて、チェックを変更する。 341 if( !arParam.useSufix( sufix ) ) { continue; } // false:対象外の場合は、次のreaderClassを使う。 342 343 readerClass = arParam.CLASS; 344 encode = arParam.ENCODE; 345 346 // 6.4.5.1 (2016/04/28) CSV 指定時は、readerClass="Text" , separator="," に、再設定します。 347 if( "CSV".equalsIgnoreCase( readerClass ) || "CSV".equalsIgnoreCase( sufix ) ) { 348 readerClass = "Text"; 349 separator = ","; 350 } 351 352 if( isDebug() ) { 353 final String errMsg = "File=[" + file + "] , class=[" + readerClass + "] , encode=[" + encode + "]" + BR ; 354 jspPrint( errMsg ); 355 System.out.println( errMsg ); 356 } 357 358 try { 359 clmAct.isDebug = isDebug(); 360 sqlError = false; // 6.3.6.1 (2015/08/28) DirectTableInsertTag でSQLException発生時のみ処理する。 361 create( file ); // 6.2.0.0 (2015/02/27) TableReader クラスの呼び出し元メソッドの共通化(EXCEL,TEXT) 362 363 // 成功すれば、エラーメッセージをクリアして、その場で抜ける。 364 tempMsg = null; 365 break; 366 } 367 // 6.2.2.0 (2015/03/27) HybsOverflowException処理をタグ側で行う。 368 catch( final HybsOverflowException ex ) { 369 // table.setOverflow( true ); は、処理済み。ループから抜けて処理を継続する。 370 tempMsg = null; 371 break; 372 } 373 // 6.3.6.1 (2015/08/28) DirectTableInsertTag でSQLException発生時のみ処理する。 374 catch( final HybsSystemException ex ) { 375 if( sqlError ) { throw ex; } // SQLException発生時は処理中止 376 } 377 // 3.8.5.3 (2006/08/07) readerClassが "Excel"でエラーが発生したとき、もう一度Defaultで再読取を行います。 378 // 5.1.9.0 (2010/08/01) RuntimeException系のExceptionがキャッチできないため、Throwableで受ける 379 // 6.5.0.1 (2016/10/21) Throwable ではなく、OgCharacterException をキャッチして、処理を継続します。 380 catch( final OgCharacterException ex ) { 381 tempMsg.append( "File=[" ).append( file ) 382 .append( "] , Class=[" ).append( readerClass ) 383 .append( "] , Encode=[" ).append( encode ) 384 .append( "] Error!" ).append( CR ) 385 .append( ex.getMessage() ).append( CR ) ; 386 // if( isDebug() ) { 387 // jspPrint( "<pre>" + tempMsg.toString() + "</pre>" ); // 6.2.4.2 (2015/05/29) 画面にも出力します。 388 // tempMsg.append( ThrowUtil.ogStackTrace( ex ) ).append( CR ) ; // 6.4.2.0 (2016/01/29) 389 // } 390 } 391 // 7.0.5.0 (2019/09/09) OgCharacterExceptionでは、取りこぼしがあるため、OgRuntimeException も継続処理するように変更。 392 catch( final OgRuntimeException ex ) { 393 tempMsg.append( "File=[" ).append( file ) 394 .append( "] , Class=[" ).append( readerClass ) 395 .append( "] , Encode=[" ).append( encode ) 396 .append( "] Error!" ).append( CR ) 397 .append( ex.getMessage() ).append( CR ) ; 398 399 // 拡張子が、xls 以外は、処理を停止します。 400 if( !"xls".equalsIgnoreCase( sufix ) ) { 401 tempMsg.append( ThrowUtil.ogStackTrace( ex ) ).append( CR ) ; 402 // break; 様子見。当面は、止めません。 403 } 404 } 405 // 6.5.0.1 (2016/10/21) Throwable をキャッチして、処理を中断します。 406 catch( final Throwable th ) { 407 tempMsg.append( "File=[" ).append( file ) 408 .append( "] , Class=[" ).append( readerClass ) 409 .append( "] , Encode=[" ).append( encode ) 410 .append( "] Error!" ).append( CR ) 411 .append( ThrowUtil.ogStackTrace( th ) ).append( CR ) ; // 6.4.2.0 (2016/01/29) 412 break; 413 } 414 } 415 416 // 6.2.3.0 (2015/05/01) 複数処理を考慮して、例外処理は発行しない。 417 // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..; 418 if( tempMsg == null ) { 419 // 6.2.2.0 (2015/03/27) #afterEnd() メソッド 新規作成。 420 rtnCode = afterEnd(); 421 } 422 else { // 最後までエラーがあれば、例外処理を発行します。 423 final String errMsg = tempMsg.toString(); 424 System.err.print( errMsg ); 425 jspPrint( "<pre>" + errMsg + "</pre>" ); // 6.2.4.0 (2015/05/15) エラーを画面に出します。 426 rtnCode = SKIP_PAGE; // 6.2.4.2 (2015/05/29) エラー時はSKIP 427 } 428 } 429 430 return rtnCode ; 431 } 432 433 /** 434 * #doEndTag() の後続処理を記述します。 435 * 436 * これは、サブクラスで、DBTableModel以外の処理を行う場合に、 437 * 処理内容を分けるために用意します。 438 * 439 * @og.rev 6.2.2.0 (2015/03/27) #afterEnd() メソッド 新規作成。 440 * @og.rev 6.2.4.2 (2015/05/29) executeCount の設定がおかしい。ReadTableTagでは、設定されていなかった。 441 * @og.rev 6.2.5.0 (2015/06/05) エラー処理は、継承先でも行うので、メソッド化します。 442 * @og.rev 7.0.7.0 (2019/12/13) useSLabel 属性を追加。 443 * 444 * @return 後続処理の指示 445 */ 446 protected int afterEnd() { 447 if( table != null ) { 448 // 6.2.4.2 (2015/05/29) executeCount が設定されなくなった件 449 executeCount = table.getRowCount(); 450 451 // 3.6.0.2 (2004/10/04) 452 // 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行います。 453 454 // 6.2.5.0 (2015/06/05) エラー処理は、継承先でも行うので、メソッド化します。 455 final ErrorMessage errMsg = clmAct.getErrorMessage(); 456 if( !errMsg.isOK() ) { 457// jspPrint( TaglibUtil.makeHTMLErrorTable( errMsg,getResource() ) ); 458 jspPrint( TaglibUtil.makeHTMLErrorTable( errMsg,getResource(),useSLabel ) ); // 7.0.7.0 (2019/12/13) 459 return SKIP_PAGE ; 460 } 461 } 462 463 // 3.6.0.8 (2004/11/19) トランザクションチェックを行います。 464 if( ! commitTableObject( tableId, table ) ) { 465 jspPrint( "ReadTableTag Query処理が割り込まれました。DBTableModel は登録しません。" ); 466 return SKIP_PAGE ; 467 } 468 469 final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE ); 470 471 // 実行件数の表示 command="NEW" のときのみ、displayMsg を表示させます。 472 // 4.0.0 (2005/11/30) 出力順の変更。一番最初に出力します。 473 if( CMD_NEW.equals( command ) ) { 474 if( executeCount > 0 && displayMsg != null && displayMsg.length() > 0 ) { 475 buf.append( executeCount ) 476 .append( getResource().getLabel( displayMsg ) ) 477 .append( BR ); 478 } 479 else if( executeCount == 0 && notfoundMsg != null && notfoundMsg.length() > 0 ) { 480 buf.append( getResource().getLabel( notfoundMsg ) ) 481 .append( BR ); 482 } 483 } 484 485 // 4.3.7.0 (2009/06/01) 読込件数を、"DB.COUNT" キーでリクエストにセットする。 486 setRequestAttribute( "DB.COUNT" , String.valueOf( executeCount ) ); 487 488 // 6.2.0.0 (2015/02/27) オーバーフロー時のメッセージを表示 489 if( table != null && table.isOverflow() && overflowMsg != null && overflowMsg.length() > 0 ) { 490 buf.append( getResource().getLabel( overflowMsg ) ) 491 .append( BR ); 492 } 493 494 jspPrint( buf.toString() ); 495 496 // 4.3.7.0 (2009/06/01) stopZero機能を追加 497 return executeCount == 0 && stopZero ? SKIP_PAGE : EVAL_PAGE ; 498 } 499 500 /** 501 * タグリブオブジェクトをリリースします。 502 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 503 * 504 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 505 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 506 * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する。 507 * @og.rev 3.1.4.0 (2003/04/18) command 属性に、初期値(NEW)を設定する。 508 * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更。 509 * @og.rev 3.5.4.5 (2004/01/23) 外部よりカラム列(CSV形式)を指定できるようにする。 510 * @og.rev 3.6.0.2 (2004/10/04) checkColumns,adjustColumns,allColumnCheck 属性追加 511 * @og.rev 3.7.0.5 (2005/04/11) useNumber 属性を追加します。 512 * @og.rev 3.8.0.2 (2005/06/30) nullCheck 属性追加 513 * @og.rev 3.8.5.3 (2006/08/07) readerClass 属性の初期値をシステムリソースより取得します。 514 * @og.rev 4.3.7.0 (2009/06/01) stopZero属性追加 515 * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。 516 * @og.rev 5.1.6.0 (2010/05/01) データの読み飛ばし設定 skipRowCount 属性追加 517 * @og.rev 5.2.1.0 (2010/10/01) 読取処理でコードリソースのラベル変換を行うかどうか useRenderer 属性追加 518 * @og.rev 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるように、sheetNos属性追加 519 * @og.rev 5.5.8.2 (2012/11/09) 固定値となるカラム名、アドレスの指定のための、sheetConstKeys、sheetConstAdrs属性追加 520 * @og.rev 5.5.8.2 (2012/11/09) カラム列に NULL が現れた時点で読取を中止する、nullBreakClm属性追加 521 * @og.rev 6.1.0.0 (2014/12/26) omitNames 属性を追加 522 * @og.rev 6.2.0.0 (2015/02/27) オーバーフロー時のメッセージを表示 523 * @og.rev 6.2.0.0 (2015/02/27) EXCEL出力のparamLevel初期値変更 3:標準推奨 → 4:個人設定可 524 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 525 * @og.rev 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加 526 * @og.rev 6.2.5.0 (2015/06/05) ファイルエンコードの初期化を遅らせます。 527 * @og.rev 7.0.7.0 (2019/12/13) useSLabel 属性を追加。 528 */ 529 @Override 530 protected void release2() { 531 super.release2(); 532 separator = TableReader.TAB_SEPARATOR; // 項目区切り文字 533 fileURL = HybsSystem.sys( "FILE_URL" ); 534 filename = HybsSystem.sys( "FILE_FILENAME" ); // ファイル名 535 encode = null; // 6.2.5.0 (2015/06/05) ファイルエンコーディング 536 readerClass = null; // 6.2.0.0 (2015/02/27) 537 maxRowCount = 0 ; // 6.2.2.0 (2015/03/27) 538 displayMsg = HybsSystem.sys( "VIEW_DISPLAY_MSG" ); 539 overflowMsg = "MSG0007"; // 検索結果が、制限行数を超えましたので、残りはカットされました。 540 notfoundMsg = "MSG0077"; // 対象データはありませんでした。 541 executeCount = -1; // 検索/実行件数 542 modifyType = null; 543 command = CMD_NEW; 544 table = null; 545 tableId = HybsSystem.TBL_MDL_KEY ; 546 sheetName = null; // 3.5.4.2 (2003/12/15) 547 sheetNos = null; // 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるようにする。 548 sheetConstKeys = null; // 5.5.8.2 (2012/11/09) 固定値となるカラム名(CSV形式) 549 sheetConstAdrs = null; // 5.5.8.2 (2012/11/09) 固定値となるアドレス(行-列,行-列,・・・) 550 nullBreakClm = null; // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件 551 nullSkipClm = null; // 6.2.3.0 (2015/05/01) 行読み飛ばし 552 columns = null; // 3.5.4.5 (2004/01/23) 553 useNumber = true; // 3.7.0.5 (2005/04/11) 554 stopZero = false; // 4.3.7.0 (2009/06/01) soptZero追加 555 isMainTrans = true; // 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し 556 skipRowCount = 0; // 5.1.6.0 (2010/05/01) データの読み飛ばし設定 557 clmAct = new ColumnAction(); // 6.2.2.0 (2015/03/27) 558 useSLabel = false; // 7.0.7.0 (2019/12/13) エラーメッセージにSLABELを利用するかどうか[true/false]を指定します(初期値:false) 559 } 560 561 /** 562 * TableReader の実オブジェクトを生成して,BufferedReader に書き込みます。 563 * 564 * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader を、InputStream に変更。 565 * @og.rev 3.5.4.2 (2003/12/15) TableReader のサブクラス名変更。 566 * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更。 567 * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream を、 BufferedReader に戻す。 568 * @og.rev 3.5.4.5 (2004/01/23) TableReader に、encode を渡すように変更。 569 * @og.rev 3.5.6.0 (2004/06/18) 各種プラグイン関連付け設定を、システムパラメータ に記述します。 570 * @og.rev 3.7.0.5 (2005/04/11) useNumber 属性を追加します。 571 * @og.rev 4.0.0.0 (2005/01/31) キーの指定を、TableReader. から、TableReader_ に変更します。 572 * @og.rev 4.0.0.0 (2005/01/31) lang ⇒ ResourceManager へ変更 573 * @og.rev 5.1.6.0 (2010/05/01) データの読み飛ばし設定 skipRowCount 属性追加 574 * @og.rev 5.2.1.0 (2010/10/01) 読取処理でコードリソースのラベル変換を行うかどうか設定 useRenderer 属性追加 575 * @og.rev 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるように、sheetNos属性追加 576 * @og.rev 5.5.8.2 (2012/11/09) 固定値となるカラム名、アドレスの指定のための、sheetConstKeys、sheetConstAdrs属性追加 577 * @og.rev 5.5.8.2 (2012/11/09) カラム列に NULL が現れた時点で読取を中止する、nullBreakClm属性追加 578 * @og.rev 6.0.4.0 (2014/11/28) NullPointerException が発生するので、事前にチェックします。 579 * @og.rev 6.2.0.0 (2015/02/27) TableReader クラスの呼び出し元メソッドの共通化(EXCEL,TEXT) 580 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 581 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。 582 * @og.rev 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加 583 * @og.rev 6.4.1.2 (2016/01/22) setColumnActionListener は、内部処理が走るため、他の設定が終わってから呼び出す。 584 * @og.rev 6.4.3.3 (2016/03/04) HybsSystem.newInstance(String,String) への置き換え。 585 * 586 * @param file 出力するFileオブジェクト 587 */ 588 protected void create( final File file ) { 589 table = DBTableModelUtil.newDBTable(); // 6.2.1.0 (2015/03/13) 590 591 /** 592 * ColumnActionListenerインターフェースの内部無名クラス 593 * 594 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。 595 * 596 * @param names カラム名配列 597 */ 598 final ColumnActionListener listener = new ColumnActionListener() { 599 private DBColumn[] dbClms ; // 6.3.9.1 (2015/11/27) 修飾子を、なし → private に変更。 600 601 /** 602 * カラム名の配列が設定された場合に、呼び出されます。 603 * 604 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。 605 * 606 * @param names カラム名配列 607 */ 608 @Override 609 public void columnNames( final String[] names ) { 610 final String[] nms = clmAct.makeNames( names ); 611 table.init( nms.length ); 612 dbClms = new DBColumn[nms.length]; 613 for( int no=0; no<nms.length; no++ ) { 614 dbClms[no] = getDBColumn( nms[no] ); 615 table.setDBColumn( no,dbClms[no] ); 616 } 617 } 618 619 /** 620 * 1行分のデータが設定された場合に、呼び出されます。 621 * 622 * @og.rev 6.2.2.0 (2015/03/27) ColumnActionListener 対応。 623 * @og.rev 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加。条件に一致しなければ、null が返されます。 624 * 625 * @param vals 文字列値の1行分の配列 626 * @param rowNo 行番号(0~) 627 */ 628 @Override 629 public void values( final String[] vals, final int rowNo ) { 630 if( maxRowCount > 0 && rowNo > maxRowCount ) { // 読み取り件数オーバーフロー 631 table.setOverflow( true ); 632 throw new HybsOverflowException(); 633 } 634 635 final String[] newVals = clmAct.clmAction( vals , dbClms , rowNo ); 636 // 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加。条件に一致しなければ、null が返されます。 637 if( newVals != null ) { 638 table.addColumnValues( newVals,modifyType,true ); // 値配列、変更タイプ、書込許可 639 } 640 } 641 }; 642 final TableReader reader = HybsSystem.newInstance( "TableReader_" , readerClass ); // 3.5.5.3 (2004/04/09) 643 644 reader.setSeparator( separator ); 645 reader.setColumns( columns ); // 3.5.4.5 (2004/01/23) 、6.2.0.0 (2015/02/27) 削除 646 reader.setUseNumber( useNumber ); // 3.7.0.5 (2005/04/11) 647 reader.setSkipRowCount( skipRowCount ); // 5.1.6.0 (2010/05/01) 648 reader.setDebug( isDebug() ); // 5.5.7.2 (2012/10/09) デバッグ情報を出力するかどうかを指定 649 // 6.2.0.0 (2015/02/27) EXCELでない場合でも、メソッドは呼び出す。(空振りします) 650 reader.setSheetName( sheetName ); // 3.5.4.2 (2003/12/15) 651 reader.setSheetNos( sheetNos ); // 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるようにする。 652 reader.setSheetConstData( sheetConstKeys,sheetConstAdrs ) ; // 5.5.8.2 (2012/11/09) 固定値となるカラム名、アドレスの指定 653 reader.setNullBreakClm( nullBreakClm ) ; // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件 654 reader.setNullSkipClm( nullSkipClm ) ; // 6.2.3.0 (2015/05/01) 行読み飛ばし 655 // 6.4.1.2 (2016/01/22) setColumnActionListener は、内部処理が走るため、他の設定が終わってから呼び出す。 656 reader.setColumnActionListener( listener ); // 6.2.2.0 (2015/03/27) 657 658 reader.readDBTable( file,encode ); // 6.2.0.0 (2015/02/27) 追加 659 } 660 661 /** 662 * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します 663 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。 664 * 665 * @og.tag 666 * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に 667 * 渡す場合に、通常は、session を利用します。その場合の登録キーです。 668 * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、 669 * この tableId 属性を利用して、メモリ空間を分けます。 670 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。 671 * 672 * @param id テーブルID (sessionに登録する時のID) 673 */ 674 public void setTableId( final String id ) { 675 tableId = nval( getRequestParameter( id ), tableId ); 676 } 677 678 /** 679 * 【TAG】可変長ファイルを作成するときの項目区切り文字をセットします。 680 * 681 * @og.tag 可変長ファイルを作成するときの項目区切り文字をセットします。 682 * 683 * @param separator 項目区切り文字 684 */ 685 public void setSeparator( final String separator ) { 686 this.separator = nval( getRequestParameter( separator ),this.separator ); 687 } 688 689 /** 690 * 【TAG】読取元ディレクトリ名を指定します 691 * (初期値:FILE_URL[={@og.value SystemData#FILE_URL}])。 692 * 693 * @og.tag 694 * この属性で指定されるディレクトリより、ファイルを読取ます。 695 * 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、2文字目が、 696 * ":" (Windows)の場合は、指定のURLそのままのディレクトリに、そうでない場合は、 697 * fileURL = "{@USER.ID}" と指定すると、FILE_URL 属性で指定のフォルダの下に、 698 * さらに、各個人ID別のフォルダを作成して、そこを操作します。 699 * (初期値:システム定数のFILE_URL[={@og.value SystemData#FILE_URL}])。 700 * 701 * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend メソッドの利用 702 * @og.rev 4.0.0.0 (2007/11/20) 指定されたディレクトリ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。 703 * @og.rev 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。 704 * 705 * @param url 読取元ディレクトリ名 706 * @see org.opengion.hayabusa.common.SystemData#FILE_URL 707 */ 708 public void setFileURL( final String url ) { 709 final String furl = nval( getRequestParameter( url ),null ); 710 if( furl != null ) { 711 fileURL = StringUtil.urlAppend( fileURL,furl ); 712 } 713 } 714 715 /** 716 * 【TAG】ファイルを作成するときのファイル名をセットします 717 * (初期値:FILE_FILENAME[={@og.value SystemData#FILE_FILENAME}])。 718 * 719 * @og.tag ファイルを作成するときのファイル名をセットします。 720 * (初期値:システム定数のFILE_FILENAME[={@og.value SystemData#FILE_FILENAME}])。 721 * 722 * @param filename ファイル名 723 * @see org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK 724 */ 725 public void setFilename( final String filename ) { 726 this.filename = nval( getRequestParameter( filename ),this.filename ); 727 } 728 729 /** 730 * 【TAG】ファイルを作成するときのファイルエンコーディング名をセットします 731 * (初期値:FILE_ENCODE[={@og.value SystemData#FILE_ENCODE}])。 732 * 733 * @og.tag 734 * readerClass="AutoReader" の場合、ここで設定した encode が優先されます。 735 * readerClass="Text" の場合、encode が指定されていない場合は、初期値 の FILE_ENCODE が使用されます 736 * 737 * Shift_JIS,MS932,Windows-31J,UTF-8,ISO-8859-1,UnicodeLittle 738 * (初期値:システム定数のFILE_ENCODE[={@og.value SystemData#FILE_ENCODE}])。 739 * 740 * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更 741 * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する。 742 * 743 * @param enc ファイルエンコーディング名 744 * @see <a href="http://www.iana.org/assignments/character-sets">IANA Charset Registry</a> 745 * @see org.opengion.hayabusa.common.SystemData#FILE_ENCODE 746 */ 747 public void setEncode( final String enc ) { 748 encode = nval( getRequestParameter( enc ),encode ); 749 } 750 751 /** 752 * 【TAG】実際に読み出すクラス名の略称(TableReader_**** の ****)をセットします 753 * (初期値:TABLE_READER_DEFAULT_CLASS[={@og.value SystemData#TABLE_READER_DEFAULT_CLASS}])。 754 * 755 * @og.tag 756 * 実際に読み出すクラス名(の略称)をセットします。 757 * これは、org.opengion.hayabusa.io 以下の TableReader_**** クラスの **** を 758 * 与えます。これらは、TableReader インターフェースを継承したサブクラスです。 759 * 属性クラス定義の {@link org.opengion.hayabusa.io.TableReader TableReader} を参照願います。 760 * {@og.doc03Link readerClass TableReader_**** クラス} 761 * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する。 762 * 763 * "AutoReader" は特別な名前で、Excel と Text(テキスト) を以下の順番で試します。 764 * Excel,Calc,Text(UnicodeLittle),Text(Windows-31J),Text(Windows-31J),Text(UTF-8),Text(EUC-JP) 765 * Excel については、拡張子を自動判定して、(xlsx か xls) 適切な処理を行います。 766 * 従来からの 拡張子のみ、xls のテキストファイルは、#NAME を見つけることができないため、エラーになり、 767 * 次のText読み取りにゆだねられます。 768 * UTF-8 のTEXTとWindows-31JのTEXTは、ヘッダー部での区別ができないため、java.nio.file.Files と Pathを 769 * 使用した読み取り方式に変更しています。 770 * "AutoReader" に設定した場合は、上記の様に、encode を順番に確かめるため、encode属性の指定は無視されます。 771 * (初期値:TABLE_READER_DEFAULT_CLASS[={@og.value SystemData#TABLE_READER_DEFAULT_CLASS}])。 772 * 773 * @og.rev 6.2.1.0 (2015/03/13) Default廃止に伴い、Defaultが指定された場合は、Textに置き換える。 774 * 775 * @param readerCls クラス名(の略称) 776 * @see org.opengion.hayabusa.io.TableReader TableReaderのサブクラス 777 */ 778 public void setReaderClass( final String readerCls ) { 779 readerClass = nval( getRequestParameter( readerCls ),readerClass ); 780 781 // 6.2.1.0 (2015/03/13) 互換性の為。 782 if( "Default".equals( readerClass ) ) { readerClass = "Text" ; } 783 } 784 785 /** 786 * 【TAG】読取時の最大取り込み件数をセットします(初期値:0:無制限)。 787 * 788 * @og.tag 789 * DBTableModelのデータとして登録する最大件数をこの値に設定します。 790 * サーバーのメモリ資源と応答時間の確保の為です。 791 * 0 をセットすると、無制限になります。 792 * (初期値:0:無制限) 793 * 794 * @og.rev 5.5.8.5 (2012/11/27) 0を無制限として処理します。 795 * @og.rev 6.2.2.0 (2015/03/27) 初期値を、無制限に変更 796 * 797 * @param count 最大件数 798 */ 799 public void setMaxRowCount( final String count ) { 800 maxRowCount = nval( getRequestParameter( count ),maxRowCount ); 801 } 802 803 /** 804 * 【TAG】読取時の最大エラー件数をセットします (初期値:{@og.value #ERROR_ROW_COUNT})。 805 * 806 * @og.tag 807 * DBTableModelのデータチェックを行う場合、エラーの最大件数をこの値に設定します。 808 * エラー最大件数がこの値を超えると、処理を打ち切ります。 809 * 0 をセットすると、無制限になります。 810 * (初期値:{@og.value #ERROR_ROW_COUNT})。 811 * 812 * @og.rev 6.2.2.0 (2015/03/27) 読取時の最大エラー件数(errRowCount) を新規追加 813 * 814 * @param count 最大件数 815 */ 816 public void setErrRowCount( final String count ) { 817 clmAct.errRowCount = nval( getRequestParameter( count ),ERROR_ROW_COUNT ); 818 } 819 820 /** 821 * 【TAG】コマンド (NEW,RENEW)をセットします(初期値:NEW)。 822 * 823 * @og.tag 824 * コマンドは,HTMLから(get/post)指定されますので,CMD_xxx で設定される 825 * フィールド定数値のいづれかを、指定できます。 826 * 何も設定されない、または、null の場合は、"NEW" が初期値にセットされます。 827 * 828 * @param cmd コマンド (public static final 宣言されている文字列) 829 * @see <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.ReadTableTag.CMD_NEW">コマンド定数</a> 830 */ 831 public void setCommand( final String cmd ) { 832 final String cmd2 = getRequestParameter( cmd ); 833 if( cmd2 != null && cmd2.length() > 0 ) { command = cmd2.toUpperCase(Locale.JAPAN); } 834 } 835 836 /** 837 * 【TAG】query の結果を画面上に表示するメッセージIDを指定します 838 * (初期値:VIEW_DISPLAY_MSG[={@og.value SystemData#VIEW_DISPLAY_MSG}])。 839 * 840 * @og.tag 841 * ここでは、検索結果の件数や登録された件数をまず出力し、 842 * その次に、ここで指定したメッセージをリソースから取得して 843 * 表示します。 844 * 件数を表示させる場合は、displayMsg = "MSG0033"[ 件検索しました] をセットしてください。 845 * 表示させたくない場合は, displayMsg = "" をセットしてください。 846 * (初期値:システム定数のVIEW_DISPLAY_MSG[={@og.value SystemData#VIEW_DISPLAY_MSG}])。 847 * 848 * @og.rev 6.2.0.0 (2015/02/27) リクエスト変数を使用できるように修正。 849 * 850 * @param id 処理結果表示メッセージID 851 */ 852 public void setDisplayMsg( final String id ) { 853 final String ids = getRequestParameter( id ); 854 if( ids != null ) { displayMsg = ids; } 855 } 856 857 /** 858 * 【TAG】読取データが最大検索数をオーバーした場合に表示するメッセージリソースIDを指定します 859 * (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました])。 860 * 861 * @og.tag 862 * 読取結果が、maxRowCount で設定された値より多い場合、何らかのデータは読取されず 863 * 切り捨てられたことになります。 864 * ここでは、displayMsg を表示した後、必要に応じて、このメッセージを表示します。 865 * 表示させたくない場合は, overflowMsg = "" をセットしてください。 866 * 初期値は、MSG0007[検索結果が、制限行数を超えましたので、残りはカットされました]です。 867 * 868 * @og.rev 6.2.0.0 (2015/02/27) オーバーフロー時のメッセージを表示 869 * 870 * @param id 検索数オーバー時メッセージID 871 */ 872 public void setOverflowMsg( final String id ) { 873 final String ids = getRequestParameter( id ); 874 if( ids != null ) { overflowMsg = ids; } 875 } 876 877 /** 878 * 【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])。 879 * 880 * @og.tag 881 * ここでは、検索結果がゼロ件の場合のみ、特別なメッセージを表示させます。 882 * 従来は、displayMsg と兼用で、『0 件検索しました』という表示でしたが、 883 * displayMsg の初期表示は、OFF になりましたので、ゼロ件の場合のみ別に表示させます。 884 * 表示させたくない場合は, notfoundMsg = "" をセットしてください。 885 * 初期値は、MSG0077[対象データはありませんでした]です。 886 * 887 * @param id ゼロ件時表示メッセージID 888 */ 889 public void setNotfoundMsg( final String id ) { 890 final String ids = getRequestParameter( id ); 891 if( ids != null ) { notfoundMsg = ids; } 892 } 893 894 /** 895 * 【TAG】ファイル取り込み時の 更新タイプ [A:追加/C:更新/D:削除]を指定します。 896 * 897 * @og.tag 898 * ファイル読み込み時に、そのデータをA(追加)、C(更新)、D(削除)の 899 * 更新タイプをつけた状態にします。 900 * その状態で、そのまま、update する事が可能になります。 901 * 902 * @param type 更新タイプ [A:追加/C:更新/D:削除] 903 */ 904 public void setModifyType( final String type ) { 905 modifyType = getRequestParameter( type ); 906 } 907 908 /** 909 * 【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)。 910 * 911 * @og.tag 912 * EXCELファイルを読み込む時に、シート名を指定します。これにより、複数の形式の 913 * 異なるデータを順次読み込むことや、シートを指定して読み取ることが可能になります。 914 * sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。エラーにはならないのでご注意ください。 915 * 初期値は、指定なしです。 916 * 917 * @og.rev 3.5.4.2 (2003/12/15) 新規追加 918 * 919 * @param sheet EXCELファイルのシート名 920 * @see #setSheetNos( String ) 921 */ 922 public void setSheetName( final String sheet ) { 923 sheetName = nval( getRequestParameter( sheet ),sheetName ); 924 } 925 926 /** 927 * 【TAG】EXCELファイルを読み込むときのシート番号を指定します(初期値:0)。 928 * 929 * @og.tag 930 * EXCEL読み込み時に複数シートをマージして取り込みます。 931 * シート番号は、0 から始まる数字で表します。 932 * ヘッダーは、最初のシートのカラム位置に合わせます。(ヘッダータイトルの自動認識はありません。) 933 * よって、指定するシートは、すべて同一レイアウトでないと取り込み時にカラムのずれが発生します。 934 * 935 * シート番号の指定は、CSV形式で、複数指定できます。また、N-M の様にハイフンで繋げることで、 936 * N 番から、M 番のシート範囲を一括指定可能です。また、"*" による、全シート指定が可能です。 937 * これらの組み合わせも可能です。( 0,1,3,5-8,10-* ) 938 * ただし、"*" に関しては例外的に、一文字だけで、すべてのシートを表すか、N-* を最後に指定するかの 939 * どちらかです。途中には、"*" は、現れません。 940 * シート番号は、重複(1,1,2,2)、逆転(3,2,1) での指定が可能です。これは、その指定順で、読み込まれます。 941 * sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。エラーにはならないのでご注意ください。 942 * 943 * 初期値は、0(第一シート) です。 944 * 945 * @og.rev 5.5.7.2 (2012/10/09) 新規追加 946 * 947 * @param sheet EXCELファイルのシート番号(0から始まる) 948 * @see #setSheetName( String ) 949 */ 950 public void setSheetNos( final String sheet ) { 951 sheetNos = nval( getRequestParameter( sheet ),sheetNos ); 952 if( sheetNos != null && sheetNos.length() > 0 ) { 953 boolean errFlag = false; 954 for( int i=0; i<sheetNos.length(); i++ ) { 955 final char ch = sheetNos.charAt(i); 956 if( ch == '-' || ch == ',' ) { continue; } 957 if( ch == '*' && ( i==0 || i==sheetNos.length()-1 ) ) { continue; } 958 if( ch < '0' || ch > '9' ) { errFlag = true; break; } 959 } 960 if( errFlag ) { 961 final String errMsg = "sheetNos の指定を見直してください。sheetNos=[" + sheetNos + "]"; 962 throw new HybsSystemException( errMsg ); 963 } 964 } 965 } 966 967 /** 968 * 【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのカラム名を指定します。 969 * 970 * @og.tag 971 * カラム名は、CSV形式で指定します。 972 * これにより、シートの一か所に書かれている情報を、DBTableModel のカラムに固定値として 973 * 設定することができます。 974 * 例として、DB定義書で、テーブル名をシートの全レコードに設定したい場合などに使います。 975 * このメソッドは、isExcel() == true の場合のみ利用されます。 976 * 977 * @og.rev 5.5.8.2 (2012/11/09) 新規追加 978 * 979 * @param constKeys 固定値となるカラム名 (CSV形式) 980 * @see #setSheetConstAdrs( String ) 981 */ 982 public void setSheetConstKeys( final String constKeys ) { 983 sheetConstKeys = nval( getRequestParameter( constKeys ),null ); 984 } 985 986 /** 987 * 【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのカラム名に対応するアドレスを指定します。 988 * 989 * @og.tag 990 * アドレスは、EXCEL上の行-列をCSV形式で指定します。 991 * 行列は、EXCELオブジェクトに準拠するため、0から始まる整数です。 992 * 0-0 ⇒ A1 , 1-0 ⇒ A2 , 0-1 ⇒ B1 になります。 993 * これにより、シートの一か所に書かれている情報を、DBTableModel のカラムに固定値として 994 * 設定することができます。 995 * 例として、DB定義書で、テーブル名をシートの全レコードに設定したい場合などに使います。 996 * このメソッドは、isExcel() == true の場合のみ利用されます。 997 * 998 * 5.7.6.3 (2014/05/23) より、 999 * ①EXCEL表記に準拠した、A1,A2,B1 の記述も処理できるように対応します。 1000 * なお、A1,A2,B1 の記述は、必ず、英字1文字+数字 にしてください。(A~Zまで) 1001 * ②処理中のEXCELシート名をカラムに割り当てるために、"SHEET" という記号に対応します。 1002 * 例えば、sheetConstKeys="CLM,LANG,NAME" とし、sheetConstAdrs="0-0,A2,SHEET" とすると、 1003 * NAMEカラムには、シート名を読み込むことができます。 1004 * これは、内部処理の簡素化のためです。 1005 * 1006 * ちなみに、EXCELのセルに、シート名を表示させる場合の関数は、下記の様になります。 1007 * =RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1))) 1008 * 1009 * @og.rev 5.5.8.2 (2012/11/09) 新規追加 1010 * 1011 * @param constAdrs 固定値となるアドレス (行-列,行-列,・・・) 1012 * @see #setSheetConstKeys( String ) 1013 */ 1014 public void setSheetConstAdrs( final String constAdrs ) { 1015 sheetConstAdrs = nval( getRequestParameter( constAdrs ),null ); 1016 } 1017 1018 /** 1019 * 【TAG】ここに指定されたカラム列に NULL が現れた時点で読取を中止します。 1020 * 1021 * @og.tag 1022 * これは、指定のカラムは必須という事を条件に、そのレコードだけを読み取る処理を行います。 1023 * 複数Sheetの場合は、次のSheetを読みます。 1024 * 現時点では、Excel の場合のみ有効です。 1025 * 1026 * @og.rev 5.5.8.2 (2012/11/09) 新規追加 1027 * 1028 * @param clm カラム列 1029 */ 1030 public void setNullBreakClm( final String clm ) { 1031 nullBreakClm = nval( getRequestParameter( clm ),null ); 1032 } 1033 1034 /** 1035 * 【TAG】ここに指定されたカラム列に NULL が現れたレコードは読み飛ばします。 1036 * 1037 * @og.tag 1038 * 例えば、更新対象カラムで、null の場合は、何もしない、などのケースで使用できます。 1039 * 複数カラムの場合は、AND条件やOR条件などが、考えられるため、 1040 * カラムを一つにまとめて、指定してください。 1041 * 1042 * @og.rev 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加 1043 * 1044 * @param clm カラム列 1045 */ 1046 public void setNullSkipClm( final String clm ) { 1047 nullSkipClm = nval( getRequestParameter( clm ),null ); 1048 } 1049 1050 /** 1051 * 【TAG】読取元ファイルのカラム列を、外部(タグ)より指定します。 1052 * 1053 * @og.tag 1054 * 読取元ファイルのカラム列を、外部(タグ)より指定します。 1055 * ファイルに記述された #NAME より優先して使用されます。 1056 * これは、元ファイルのカラムを順番に指定のカラム名に割り当てる機能で 1057 * ファイルの特定のカラム列を抜き出して取り込む機能ではありません。 1058 * 1059 * ※ 7.2.6.0 (2020/06/30) 1060 * readerClass="POI"の場合、TEXT(テキスト)、CMNT(コメント)の位置は変えられません。 1061 * また、カラム数も、必ず、2以上必要です。 1062 * それより多い場合は、null値のカラムが作成されます。 1063 * 1064 * @og.rev 3.5.4.5 (2004/01/23) 新規作成 1065 * 1066 * @param clms 読取元ファイルのカラム列 (CSV形式) 1067 */ 1068 public void setColumns( final String clms ) { 1069 columns = nval( getRequestParameter( clms ),columns ); 1070 } 1071 1072 /** 1073 * 【TAG】読取対象外のカラム列を、外部(タグ)よりCSV形式で指定します。 1074 * 1075 * @og.tag 1076 * 指定するカラム名に対して、読取処理を行いません。 1077 * ここで指定するカラム名は、ファイルの #NAME または、columns で 1078 * 指定するカラム名に対して、含まれている必要はありません。 1079 * その場合は、ここでの指定は無視されます。 1080 * 1081 * @og.rev 6.1.0.0 (2014/12/26) omitNames 属性を追加 1082 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 1083 * 1084 * @param clms 読取対象外のカラム列 (CSV形式) 1085 */ 1086 public void setOmitNames( final String clms ) { 1087 clmAct.omitNames = nval( getRequestParameter( clms ),null ); 1088 } 1089 1090 /** 1091 * 読取対象外のカラム列を、追加指定します。 1092 * 1093 * 内部的な処理で、DirectTableInsertTag で、WRITABLE,ROWID などの 1094 * データベースに存在しないカラムを、omit するための機能です。 1095 * 属性定義してもよいのですが、統一的な処理方法が決まらないので、 1096 * 取りあえず、暫定的に、サブクラスからのみ、して可能にしておきます。 1097 * このメソッドは、setOmitNames( String ) が呼び出された後でしか 1098 * 有効に機能しません。 1099 * 1100 * @og.rev 6.2.4.0 (2015/05/15) 無条件でOMITする名称を指定します。 1101 * 1102 * @param omit 読取対象外の追加カラム列 (CSV形式) 1103 */ 1104 protected void addOmitNames( final String omit ) { 1105 if( clmAct.omitNames == null ) { 1106 clmAct.omitNames = omit; 1107 } 1108 else { 1109 clmAct.omitNames = "," + omit ; 1110 } 1111 } 1112 1113 /** 1114 * 【TAG】読取元ファイルの整合性チェックを行うカラム列をカンマ指定します。 1115 * 1116 * @og.tag 1117 * カラムオブジェクトのDBType属性に対応したチェックを行います。 1118 * 指定のカラム名をCSV形式(CSV)で複数指定できます。 1119 * 全てのカラムのチェックを行う場合は、"*" を指定して下さい。 1120 * 分解方法は、通常のパラメータ取得後に、CSV分解します。 1121 * 1122 * @og.rev 3.6.0.2 (2004/10/04) 新規追加 取り込み時チェック用 1123 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 1124 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 1125 * 1126 * @param clms 整合性チェックを行うカラム列 (CSV形式) 1127 */ 1128 public void setCheckColumns( final String clms ) { 1129 clmAct.checkColumns = nval( getRequestParameter( clms ),null ); 1130 } 1131 1132 /** 1133 * 【TAG】読取元ファイルのデータ変換を行うカラム列をカンマ指定します。 1134 * 1135 * @og.tag 1136 * カラムオブジェクトのDBType属性に対応したデータ変換を行います。 1137 * 指定のカラム名をCSV形式(CSV)で複数指定できます。 1138 * 全てのカラムをデータ変換する場合は、"*" を指定して下さい。 1139 * 分解方法は、通常のパラメータ取得後に、CSV分解します。 1140 * 1141 * @og.rev 3.6.0.2 (2004/10/04) 新規追加 取り込み時データ変換 1142 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 1143 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 1144 * 1145 * @param clms データ変換を行うカラム列 (CSV形式) 1146 */ 1147 public void setAdjustColumns( final String clms ) { 1148 clmAct.adjustColumns = nval( getRequestParameter( clms ),null ); 1149 } 1150 1151 /** 1152 * 【TAG】NULL チェックすべきカラム列をCSV形式(CSV形式)で指定します。 1153 * 1154 * @og.tag nullCheck="AAA,BBB,CCC,DDD" 1155 * 分解方法は、通常のパラメータ取得後に、CSV分解します。 1156 * 1157 * @og.rev 3.8.0.2 (2005/06/30) 新規追加 1158 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 1159 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 1160 * 1161 * @param clms カラム列(CSV形式) 1162 */ 1163 public void setNullCheck( final String clms ) { 1164 clmAct.nullCheck = nval( getRequestParameter( clms ),null ); 1165 } 1166 1167 /** 1168 * 【TAG】行番号情報を、使用している/していない[true/false]を指定します(初期値:true)。 1169 * 1170 * @og.tag 1171 * 通常のフォーマットでは、各行の先頭に行番号が出力されています。 1172 * 読取時に、#NAME 属性を使用する場合は、この行番号を無視しています。 1173 * #NAME 属性を使用せず、columns 属性でカラム名を指定する場合(他システムの 1174 * 出力ファイルを読み取るケース等)では、行番号も存在しないケースがあり、 1175 * その様な場合に、useNumber="false" を指定すれば、データの最初から読取始めます。 1176 * この場合、出力データのカラムの並び順が変更された場合、columns 属性も 1177 * 指定しなおす必要がありますので、できるだけ、#NAME 属性を使用するように 1178 * してください。 1179 * なお、EXCEL 入力には、この設定は適用されません。(暫定対応) 1180 * 初期値は、true(使用する) です。 1181 * 1182 * @og.rev 3.7.0.5 (2005/04/11) 新規追加 1183 * 1184 * @param useNo 行番号情報 [true:使用する/false:使用しない] 1185 */ 1186 public void setUseNumber( final String useNo ) { 1187 useNumber = nval( getRequestParameter( useNo ),useNumber ); 1188 } 1189 1190 /** 1191 * 【TAG】読込件数が0件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する])。 1192 * 1193 * @og.tag 1194 * 初期値は、false(続行する)です。 1195 * 1196 * @og.rev 4.3.7.0 (2009/06/01) 新規追加 1197 * 1198 * @param cmd 0件時停止可否 [true:処理を中止する/false:続行する] 1199 */ 1200 public void setStopZero( final String cmd ) { 1201 stopZero = nval( getRequestParameter( cmd ), stopZero ); 1202 } 1203 1204 /** 1205 * 【TAG】(通常は使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:true)。 1206 * 1207 * @og.tag 1208 * この値は、ファイルダウンロード処理に影響します。この値がtrueに指定された時にcommitされたDBTableModelが 1209 * ファイルダウンロードの対象の表になります。 1210 * 1211 * このパラメーターは、通常、各タグにより実装され、ユーザーが指定する必要はありません。 1212 * 但し、1つのJSP内でDBTableModelが複数生成される場合に、前に処理したDBTableModelについてファイルダウンロードをさせたい 1213 * 場合は、後ろでDBTableModelを生成するタグで、明示的にこの値をfalseに指定することで、ファイルダウンロード処理の対象から 1214 * 除外することができます。 1215 * 1216 * @og.rev 5.1.6.0 (2010/05/01) 新規作成 1217 * 1218 * @param flag メイントランザクションかどうか [true:メイン/false:その他] 1219 */ 1220 public void setMainTrans( final String flag ) { 1221 isMainTrans = nval( getRequestParameter( flag ),isMainTrans ); 1222 } 1223 1224 /** 1225 * 【TAG】(通常は使いません)データの読み飛ばし件数を設定します。 1226 * 1227 * @og.tag 1228 * TAB区切りテキストやEXCEL等のデータの読み始めの初期値を指定します。 1229 * ファイルの先頭行が、0行としてカウントしますので、設定値は、読み飛ばす 1230 * 件数になります。(1と指定すると、1件読み飛ばし、2行目から読み込みます。) 1231 * 読み飛ばしは、コメント行などは、無視しますので、実際の行数分読み飛ばします。 1232 * #NAME属性や、columns 属性は、有効です。 1233 * 1234 * @og.rev 5.1.6.0 (2010/05/01) 新規作成 1235 * 1236 * @param count 読み始めの初期値 1237 */ 1238 public void setSkipRowCount( final String count ) { 1239 skipRowCount = nval( getRequestParameter( count ),skipRowCount ); 1240 } 1241 1242 /** 1243 * 【TAG】読取処理でKEY:VAL形式のコードリソースから、KEYを取り出す処理を行うかどうかを指定します 1244 * (初期値:USE_TABLE_READER_RENDERER[={@og.value SystemData#USE_TABLE_READER_RENDERER}])。 1245 * 1246 * @og.tag 1247 * TableWriter_Renderer 系のクラスで出力した場合は、コードリソースがラベルで出力されます。 1248 * そのファイルを読み取ると、当然、エラーになります。 1249 * ここでは、コードリソースのカラムに対して、ラベルからコードを求める逆変換を行うことで、 1250 * Renderer 系で出力したファイルを取り込むことができるようにします。 1251 * 1252 * ここでは、TableWriter 系と同様に、TableReader_Renderer 系のクラスを作るのではなく、 1253 * 属性値のフラグで、制御します。 1254 * 将来的には、TableWriter 系も廃止して、同様のフラグで制御するように変更する予定です。 1255 * (初期値:システム定数のUSE_TABLE_READER_RENDERER[={@og.value SystemData#USE_TABLE_READER_RENDERER}])。 1256 * 1257 * @og.rev 5.2.1.0 (2010/10/01) 新規作成 1258 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction インナークラスでパラメータを整理する。 1259 * 1260 * @param flag ラベル逆変換を行うかどうか [true:行う/false:行わない] 1261 * @see org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER 1262 */ 1263 public void setUseRenderer( final String flag ) { 1264 clmAct.useRenderer = nval( getRequestParameter( flag ),HybsSystem.sysBool( "USE_TABLE_READER_RENDERER" ) ); 1265 } 1266 1267 /** 1268 * 【TAG】matchKeysをCSV形式で指定します。 1269 * 1270 * @og.tag 1271 * ファイルから特定の行のみを読み取るためのmatchKeysを指定します。 1272 * matchKeysで指定したカラムに対して、matchValsの正規表現でチェックします。 1273 * 何も指定しない場合は、読取対象になります。 1274 * matchVals と個数を合わせてください。 1275 * 1276 * @og.rev 6.4.6.0 (2016/05/27) 新規追加 1277 * 1278 * @param keys カラム列(CSV形式文字) 1279 * @see #setMatchVals( String ) 1280 */ 1281 public void setMatchKeys( final String keys ) { 1282 clmAct.matchKeys = getCSVParameter( keys ); 1283 } 1284 1285 /** 1286 * 【TAG】matchValsをCSV形式で指定します。 1287 * 1288 * @og.tag 1289 * ファイルから特定の行のみを読み取るためのmatchValsを指定します。 1290 * matchKeysで指定したカラムに対して、matchValsの正規表現でチェックします。 1291 * この機能はTableReader_Defaultのみ有効です。 1292 * 何も指定しない場合は、読取対象になります。 1293 * matchKeys と個数を合わせてください。 1294 * 1295 * @og.rev 6.4.6.0 (2016/05/27) 新規追加 1296 * 1297 * @param vals カラム列に対する正規表現(CSV形式文字) 1298 * @see #setMatchKeys( String ) 1299 */ 1300 public void setMatchVals( final String vals ) { 1301 clmAct.matchVals = getCSVParameter( vals ); 1302 } 1303 1304 /** 1305 * 【TAG】エラーメッセージにSLABELを利用するかどうか[true/false]を指定します(初期値:false)。 1306 * 1307 * @og.tag 1308 * 通常のエラーメッセージは、ラベル(長)が使われますが、これをラベル(短)を使いたい場合に、true にセットします。 1309 * ここでのラベル(短)は、タグ修飾なしの、ラベル(短)です。 1310 * 標準はfalse:利用しない=ラベル(長)です。 1311 * true/false以外を指定した場合はfalse扱いとします。 1312 * 1313 * ラベルリソースの概要説明があれば表示しますが、useSLabel="true" 時は、概要説明を表示しません。 1314 * 1315 * @og.rev 7.0.7.0 (2019/12/13) 新規追加 1316 * 1317 * @param prm SLABEL利用 [true:利用する/false:利用しない] 1318 */ 1319 public void setUseSLabel( final String prm ) { 1320 useSLabel = nval( getRequestParameter( prm ),useSLabel ); 1321 } 1322 1323 /** 1324 * カラム処理を行う、内部クラス 1325 * 1326 * カラム個別に行う処理をまとめたクラスです。 1327 * omitNames : 読取対象外のカラム列を、外部(タグ)よりCSV形式で指定します 1328 * adjustColumns : 読取元ファイルのデータ変換を行うカラム列をカンマ指定します 1329 * checkColumns : 読取元ファイルの整合性チェックを行うカラム列をカンマ指定します 1330 * nullCheck : NULL チェックすべきカラム列をCSV形式(CSV形式)で指定します 1331 * 1332 * 名前配列設定で対象のカラムをピックアップし、値設定処理で、個々に処理します。 1333 * 1334 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction 新規作成 1335 */ 1336 protected static final class ColumnAction { 1337 private String omitNames ; // 読取対象外のカラム列を、外部(タグ)よりCSV形式で指定します 1338 private String adjustColumns ; // 読取元ファイルのデータ変換を行うカラム列をカンマ指定します 1339 private String checkColumns ; // 読取元ファイルの整合性チェックを行うカラム列をカンマ指定します 1340 private String nullCheck ; // NULL チェックすべきカラム列をCSV形式(CSV形式)で指定します 1341 private int errRowCount = ERROR_ROW_COUNT; // NULL チェックすべきカラム列をCSV形式(CSV形式)で指定します 1342 private boolean useRenderer ; // 読取処理でKEY:VAL形式のコードリソースから、KEYを取り出す処理を行うかどうかを指定 1343 private boolean isDebug ; // debug フラグ 1344 private ErrorMessage errMsgObj ; // 6.2.5.0 (2015/06/05) 初期化します。 1345 1346 private int[] clmNos ; // 新名前配列に対応した、値配列のアドレス 1347 private int[] actFlg ; // カラム処理の実行有無のフラグ管理 1348 private String[] mtVals ; // 6.4.6.0 (2016/05/27) 新名前配列に対応した、判定処理用のデータ(正規表現) 1349 1350 private String[] matchKeys ; // 6.4.6.0 (2016/05/27) レコードの読取条件指定時のカラム列を配列で指定します 1351 private String[] matchVals ; // 6.4.6.0 (2016/05/27) レコードの読取条件指定時のカラム列に対応する正規表現データを配列で指定します 1352 1353 private static final int OMIT = -1; // OMIT だけ別。clmNosで、OMITフラグは除外する。 1354 private static final int ADJUST = 1; // adjustColumns 処理フラグ 1355 private static final int CHECK = 2; // checkColumns 処理フラグ 1356 private static final int NULL_CH = 4; // nullCheck 処理フラグ 1357 private static final int MAT_KYS = 8; // 6.4.6.0 (2016/05/27) matchKeys 処理フラグ 1358 1359 /** 1360 * 名前配列が設定された場合に、対象カラムのピックアップを行います。 1361 * このクラスでは、名前の再設定で、初期化されます。 1362 * 1363 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction 新規作成 1364 * @og.rev 6.2.5.0 (2015/06/05) ErrorMessage を、初期化します。 1365 * @og.rev 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加 1366 * 1367 * @param orgNms オリジナル名前配列 1368 * @return OMIT等考慮した、新名前配列 1369 */ 1370 public String[] makeNames( final String[] orgNms ) { 1371 errMsgObj = new ErrorMessage( "Check Columns Error!" ); // 6.2.5.0 (2015/06/05) 初期化します。 1372 1373 // omit だけ、他のフラグセットと異なり、処理された数は、除外されるので逆になります。 1374 final int[] temp = new int[orgNms.length]; 1375 final int size = orgNms.length - actionFlagSet( omitNames, orgNms, OMIT, temp ); 1376 1377 if( size == 0 ) { // 有りえないが、omitNames="*" を誤って指定した場合にはありうる。 1378 final String errMsg = "カラムがありません。omitNames=[" + omitNames + "]"; 1379 throw new HybsSystemException( errMsg ); 1380 } 1381 1382 final String[] names = new String[size]; 1383 clmNos = new int[size]; 1384 int no = 0; 1385 for( int i=0; i<temp.length; i++ ) { 1386 if( temp[i] != OMIT ) { // 除外しない場合 1387 names[no] = orgNms[i]; // 名前配列に、オリジナルの名前をセット 1388 clmNos[no]= i; // カラムアドレスをセット(TableModelのカラム番号になる) 1389 no++ ; 1390 } 1391 } 1392 1393 actFlg = new int[size]; // 新名前配列に対応した、処理フラグを作成(フラグを加算) 1394 actionFlagSet( adjustColumns, names, ADJUST, actFlg ); // それぞれのフラグが加算される。 1395 actionFlagSet( checkColumns, names, CHECK, actFlg ); 1396 actionFlagSet( nullCheck, names, NULL_CH, actFlg ); 1397 1398 // 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加。ほとんど使わない機能。 1399 if( matchKeys != null && matchKeys.length > 0 ) { 1400 final Map<String,String> keyMap = makeMatchMap( matchKeys , matchVals ); 1401 mtVals = new String[size]; 1402 for( int i=0; i<size; i++ ) { 1403 mtVals[i] = keyMap.get( names[i] ); 1404 if( mtVals[i] != null ) { actFlg[i] += MAT_KYS; } // 一致するカラムにフラグを加算する。 1405 } 1406 } 1407 1408 return names; 1409 } 1410 1411 /** 1412 * 値配列に対して、変換処理、チェック処理を行った結果を返します。 1413 * 1414 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction 新規作成 1415 * @og.rev 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs) 1416 * @og.rev 6.4.1.2 (2016/01/22) HybsOverflowException をthrow するとき、最大件数を引数に渡す。 1417 * @og.rev 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加 1418 * @og.rev 7.2.9.4 (2020/11/20) spotbugs:null になっている可能性があるメソッドの戻り値を利用している 1419 * 1420 * @param vals 値配列 1421 * @param dbClms カラムオブジェクト配列 1422 * @param row 行番号(エラーメッセージの表示用) 1423 * @return 変換、チェック処理結果の値配列。このレコードを使用しない場合は、null を返します。 1424 */ 1425 public String[] clmAction( final String[] vals , final DBColumn[] dbClms , final int row ) { 1426 // 6.3.9.0 (2015/11/06) コンストラクタで初期化されていないフィールドを null チェックなしで利用している(findbugs) 1427 if( clmNos == null || actFlg == null ) { 1428 final String errMsg = "#makeNames(String[])を先に実行しておいてください。" ; 1429 throw new OgRuntimeException( errMsg ); 1430 } 1431 1432// if( mtVals == null ) { return null; } // 7.2.9.4 (2020/11/20) 1433 1434 final String[] rtnVals = new String[clmNos.length] ; 1435 boolean isError = false; 1436 1437 for( int no=0; no<clmNos.length; no++ ) { 1438 String val = vals[clmNos[no]]; 1439 if( useRenderer ) { // useRenderer(KEY:VAL) 処理 1440 val = dbClms[no].getReaderValue( val ); 1441 } 1442 if( (actFlg[no] & ADJUST) == ADJUST ) { // adjustColumns 処理 1443 val = dbClms[no].valueSet( val ); 1444 } 1445 if( (actFlg[no] & CHECK) == CHECK ) { // checkColumns 処理 1446 final ErrorMessage msg = dbClms[no].valueCheck( val ); 1447 if( msg.getKekka() > ErrorMessage.OK ) { 1448 isError = true; 1449 errMsgObj.append( row+1,msg ); 1450 } 1451 } 1452 if( (actFlg[no] & NULL_CH) == NULL_CH ) { // nullCheck 処理 1453 if( val == null || val.isEmpty() ) { 1454 isError = true; 1455 // ERR0012 : 指定のデータがセットされていません。(NULLエラー)。key={0} 1456 errMsgObj.addMessage( row+1,ErrorMessage.NG,"ERR0012",dbClms[no].getLabel() ); 1457 } 1458 } 1459 // 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加 1460 // 6.9.7.0 (2018/05/14) PMD These nested if statements could be combined 1461// if( (actFlg[no] & MAT_KYS) == MAT_KYS ) { // 読取条件指定 1462// // このフラグが立っているということは、mtVals も、その値も、null ではない。 1463// if( !val.matches( mtVals[no] ) ) { return null; } // マッチしない場合は、null を返します。 1464// } 1465 // 6.9.8.0 (2018/05/28) FindBugs:コンストラクタで初期化されていないフィールドを null チェックなしで null 値を利用している 1466 // このフラグが立っているということは、mtVals も、その値も、null ではない。 1467 if( (actFlg[no] & MAT_KYS) == MAT_KYS && !val.matches( mtVals[no] ) ) { return null; } // マッチしない場合は、null を返します。 1468 1469 rtnVals[no] = val; 1470 } 1471 1472 // 5.5.7.2 (2012/10/09) エラー時のデバッグ出力 1473 if( isDebug && isError ) { 1474 errMsgObj.addMessage( row+1,ErrorMessage.NG,"Debug",vals ); 1475 } 1476 1477 // isDebug == true 時には、件数は倍になるが、仕方がない。 1478 if( errMsgObj.size() > errRowCount ) { throw new HybsOverflowException( errRowCount ); } // 6.4.1.1 (2016/01/16) 1479 1480 // adjustColumns 処理結果を反映させます。 1481 return rtnVals; 1482 } 1483 1484 /** 1485 * ErrorMessageオブジェクトを返します。 1486 * 1487 * @og.rev 6.2.5.0 (2015/06/05) 新規作成 1488 * 1489 * @return ErrorMessageオブジェクト 1490 */ 1491 public ErrorMessage getErrorMessage() { 1492 return errMsgObj ; 1493 } 1494 1495 /** 1496 * 処理実行可否を判断し、フラグをセットします。 1497 * 1498 * フラグのセットは、"|"(論理和)するのが良いのですが、OMITもここで判定している関係で、 1499 * 単なる加算にしています。 1500 * (マイナスをフラグにしているので、マイナスの論理和が良く判らないためです(^^)) 1501 * 1502 * @og.rev 6.2.2.0 (2015/03/27) ColumnAction 新規作成 1503 * 1504 * @param clms 指定のカラム名 (CSV形式) 1505 * @param names 名前配列 1506 * @param flag 設定するフラグ(既存の配列に加算) 1507 * @param actFlg オリジナル名前配列 1508 * @return 処理を行った件数 1509 */ 1510 private int actionFlagSet( final String clms , final String[] names , final int flag , final int[] actFlg ) { 1511 int cnt = 0; 1512 if( clms != null ) { 1513 final String clmStr = ',' + clms.replaceAll( " ","" ) + ',' ; // 前後に カンマ(',') を追加、中間スペース削除 1514 for( int i=0; i<names.length; i++ ) { 1515 // "*" はループの外で判定して、2回それぞれでループを回す方が早い・・・かな? 1516 if( "*".equals( clms ) || clmStr.indexOf( ',' + names[i] + ',' ) >= 0 ) { 1517 cnt++ ; 1518 actFlg[i] += flag; // 一致するカラムにフラグを加算する。 1519 } 1520 } 1521 } 1522 return cnt ; 1523 } 1524 1525 /** 1526 * コードの読取条件指定のキーと値を関連付けるMapを作成します。 1527 * 1528 * ほとんど使用しない処理なので、できるだけ本体処理の影響が無いように、 1529 * メソッドを分けています。 1530 * このメソッドは、keys の、nullチェックを行ったうえで呼び出しています。 1531 * key,vals の個数が異なる場合は、エラーにしています。 1532 * 1533 * @og.rev 6.4.6.0 (2016/05/27) 新規作成 1534 * 1535 * @param keys 指定のカラム名配列(呼び出し前に、nullでないことを確認済み) 1536 * @param vals 指定の値配列 1537 * @return カラム名と値のMap 1538 * @og.rtnNotNull 1539 */ 1540 private Map<String,String> makeMatchMap( final String[] keys , final String[] vals ) { 1541 1542 // 6.4.6.0 (2016/05/27) レコードの読取条件指定を追加。個数判定 1543 if( vals != null && keys.length != vals.length ) { 1544 final String errMsg = "keys属性とvals属性の個数が合いません。" + CR 1545 + " keys=[" + keys.length + "]:KEYS=" + StringUtil.array2csv( keys ) + CR 1546 + " vals=[" + vals.length + "]:VLAS=" + StringUtil.array2csv( vals ) + CR ; 1547 throw new HybsSystemException( errMsg ); 1548 } 1549 1550 final Map<String,String> keyMap = new HashMap<>(); // 6.4.9.1 (2016/08/05) 1551 for( int i=0; i<keys.length; i++ ) { 1552 keyMap.put( keys[i] , vals[i] ); 1553 } 1554 1555 return keyMap; 1556 } 1557 } 1558 1559 /** 1560 * AutoReader用の 簡易パラメータ管理用の内部クラスです。 1561 * 1562 * 3つのパラメータ(クラス、エンコード、サフィックス)を管理します。 1563 * 1564 * CLASS TableReader_**** クラス の ****部分を指定します。(Excel,Calc,Text,PIO など) 1565 * ENCODE クラスが、Text の場合のエンコード(UnicodeLittle,Windows-31J,UTF-8,EUC-JP など) 1566 * SUFIX 処理対象の拡張子(xls,xlsx,xlsm,ods など) 1567 * 1568 * @og.rev 6.2.5.0 (2015/06/05) 新規追加。AutoReader用の 簡易パラメータ管理用の内部クラス 1569 */ 1570 private static final class AutoReaderParam { 1571 public final String CLASS ; 1572 public final String ENCODE ; 1573 public final String SUFIX ; 1574 1575 /** 1576 * AutoReader用の 簡易パラメータ管理用の内部クラスのコンストラクターです。 1577 * 1578 * 3つのパラメータ(クラス、エンコード、サフィックス)を管理します。 1579 * 1580 * @og.rev 6.2.5.0 (2015/06/05) 新規追加。AutoReader用の 簡易パラメータ管理用の内部クラス 1581 * 1582 * @param cls TableReader_**** クラス の ****部分を指定します。(Excel,Calc,Text,PIO など) 1583 * @param enc クラスが、Text の場合のエンコード(UnicodeLittle,Windows-31J,UTF-8,EUC-JP など) 1584 * @param sfx 処理対象の拡張子(xls,xlsx,xlsm,ods など) nullの場合は、すべてを対象とする。 1585 */ 1586 public AutoReaderParam( final String cls , final String enc , final String sfx ) { 1587 CLASS = cls ; 1588 ENCODE = enc ; 1589 SUFIX = sfx == null ? null : ',' + sfx + ',' ; // 判定用なので、 1590 } 1591 1592 /** 1593 * 引数のサフィックスが、対象かどうか、判定します。 1594 * 対象の場合は、true 、対象でない場合は、false を返します。 1595 * 1596 * @og.rev 6.2.5.0 (2015/06/05) 新規追加。AutoReader用の 簡易パラメータ管理用の内部クラス 1597 * 1598 * @param sufix 比較対象の拡張子(小文字のみ判定可能) 1599 * @return 対象かどうか[true:対象/false:対象外] 1600 */ 1601 public boolean useSufix( final String sufix ) { 1602 return SUFIX == null || SUFIX.contains( ',' + sufix + ',' ) ; 1603 } 1604 1605 /** 1606 * オブジェクトの文字列表現を返します。 1607 * 対象の場合は、true 、対象でない場合は、false を返します。 1608 * 1609 * @og.rev 6.2.5.0 (2015/06/05) 新規追加。AutoReader用の 簡易パラメータ管理用の内部クラス 1610 * 1611 * @return このオブジェクトの文字列表現 1612 */ 1613 @Override 1614 public String toString() { 1615 return "class=[" + CLASS + "] , encode=[" + ENCODE + "] , sufix=[" + SUFIX + "]" ; 1616 } 1617 } 1618 1619 /** 1620 * このオブジェクトの文字列表現を返します。 1621 * 基本的にデバッグ目的に使用します。 1622 * 1623 * @return このクラスの文字列表現 1624 * @og.rtnNotNull 1625 */ 1626 @Override 1627 public String toString() { 1628 return ToString.title( this.getClass().getName() ) 1629 .println( "VERSION" ,VERSION ) 1630 .println( "separator" ,separator ) 1631 .println( "fileURL" ,fileURL ) 1632 .println( "filename" ,filename ) 1633 .println( "encode" ,encode ) 1634 .println( "readerClass" ,readerClass ) 1635 .println( "maxRowCount" ,maxRowCount ) 1636 .println( "displayMsg" ,displayMsg ) 1637 .println( "executeCount" ,executeCount ) 1638 .println( "modifyType" ,modifyType ) 1639 .println( "command" ,command ) 1640 .println( "tableId" ,tableId ) 1641 .println( "sheetName" ,sheetName ) 1642 .println( "sheetNos" ,sheetNos ) // 5.5.7.2 (2012/10/09) 1643 .println( "columns" ,columns ) 1644 .println( "useNumber" ,useNumber ) 1645 .println( "Other..." ,getAttributes().getAttribute() ) 1646 .fixForm().toString() ; 1647 } 1648}