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