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 */
016 package org.opengion.hayabusa.taglib;
017
018 import org.opengion.hayabusa.common.HybsSystem;
019 import org.opengion.hayabusa.common.HybsSystemException;
020 import org.opengion.hayabusa.db.DBTableModel;
021 import org.opengion.hayabusa.db.DBColumn;
022 import org.opengion.hayabusa.io.TableReader;
023 import org.opengion.fukurou.util.ErrorMessage;
024 import org.opengion.fukurou.util.FileUtil;
025 import org.opengion.fukurou.util.Closer ;
026 import org.opengion.fukurou.util.StringUtil ;
027 import static org.opengion.fukurou.util.StringUtil.nval ;
028
029 import java.io.File;
030 import java.io.BufferedReader;
031 import java.util.Locale ;
032 import java.io.ObjectOutputStream;
033 import java.io.ObjectInputStream;
034 import java.io.IOException;
035
036 /**
037 * æŒ?®šã?ファイルã‚?DBTableModelオブジェクトに読み取るファイル入力タグですã?
038 *
039 * ãƒ??タ(DBTableModel)と、コントローラ(ReadTableタグ)を与えて、外部からコントロールすることでã€?
040 * å�?¨®形式で ãƒ??タ(DBTableModel)を表示させることã�?できますã?
041 * ReadTableタグ に対して、コマンドを与えることにより、å?部のコントローラの実è£?�«対応しã�?
042 * 形式でãƒ??タを作æ?しますã?
043 * すべての読取ã?初期クラス名を リソースファイルの TABLE_READER_DEFAULT_CLASS でæŒ?®š可能ですã?
044 * そã?場合ã?AutoReader を指定すると、Excel と Default(ãƒ?‚スãƒ? をé?番に試しますã?
045 *
046 * 入力件数ã‚?DB.COUNT" キーでリクエストにセãƒ?ƒˆしてã�?�¾すã?
047 *
048 * @og.formSample
049 * ●形式ï¼?
050 * <og:readTable
051 * command = "NEW"
052 * fileURL = "{@USER.ID}" 読み取りå…?ƒ‡ィレクトリå�?
053 * filename = "{@filename}" 読み取りå…?ƒ•ァイルå�?
054 * encode = "UnicodeLittle" 読み取りå…?ƒ•ァイルエンコード名
055 * maxRowCount = "10000" 読取最大件数(0:[無制限])
056 * />
057 * ●body?šなã�?
058 *
059 * ●Tag定義??
060 * <og:readTable
061 * readerClass 【TAG】実際に読み出すクラス名ã?略称(TableReader_**** の ****)をセãƒ?ƒˆしまã�?{@og.doc03Link readerClass 初期値:Default})
062 * fileURL 【TAG】読み取りå…?ƒ‡ィレクトリ名をæŒ?®šしまã�?初期値:FILE_URL)
063 * filename 【TAG】ファイルを作æ?するときã?ファイル名をセãƒ?ƒˆしまã�?(初期値:FILE_FILENAME[=file.xls])
064 * encode 【TAG】ファイルを作æ?するときã?ファイルエンコーãƒ?‚£ング名をセãƒ?ƒˆしまã�?初期値:FILE_ENCODE)
065 * maxRowCount 【TAG】読取時のæœ?¤§取り込み件数をセãƒ?ƒˆしまã�?(初期値:DB_MAX_ROW_COUNT[=1000])(0:[無制限])
066 * separator 【TAG】可変長ファイルを作æ?するときã?é ?›®区åˆ?‚Šæ–?—をセãƒ?ƒˆしまã�?
067 * tableId 【TAGã€?通常使ã�?�¾せん)sessionからæ‰?¾—すã‚?DBTableModelオブジェクトã? ID
068 * command 【TAG】コマンãƒ?NEW,RENEW)をセãƒ?ƒˆしまã�?初期値:NEW)
069 * modifyType 【TAG】ファイル取り込み時ã? モãƒ?‚£ファイタイãƒ?A(追åŠ?,C(更新),D(削除))を指定しまã�?
070 * displayMsg 【TAG】query の結果を画面上に表示するメãƒ?‚»ージIDを指定しまã�?初期値:MSG0033[ã€?»¶検索しました])
071 * notfoundMsg 【TAG】検索結果がゼロ件の場合に表示するメãƒ?‚»ージリソースIDを指定しまã�?初期値:MSG0077[対象ãƒ??タはありませんでした])
072 * sheetName 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート名を設定しまã�?初期値:æŒ?®šなã�?
073 * sheetNos 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート番号をè¤?•°設定できまã�?初期値:0)
074 * sheetConstKeys 【TAG】EXCELファイルを読み込ã‚?�¨きã?固定å?となるカラãƒ?��(CSV形å¼?
075 * sheetConstAdrs 【TAG】EXCELファイルを読み込ã‚?�¨きã?固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
076 * nullBreakClm 【TAG】カラãƒ??に NULL が現れた時点で読み取りを中止しまã�?è¤?•°Sheetの場合ã?、次のSheetを読みまã�?ã€?
077 * columns 【TAG】読み取りå…?ƒ•ァイルのカラãƒ??をã?外部(タグ)よりæŒ?®šしまã�?
078 * useNumber 【TAG】行番号æƒ??をã?使用してã�?‚‹/してã�?�ªい[true/false]を指定しまã�?初期値:true)
079 * adjustColumns 【TAG】読み取りå…?ƒ•ァイルのãƒ??タ変換を行うカラãƒ??をカンマ指定しまã�?
080 * checkColumns 【TAG】読み取りå…?ƒ•ァイルの整合æ?チェãƒ?‚¯を行うカラãƒ??をカンマ指定しまã�?
081 * nullCheck 【TAG】NULL チェãƒ?‚¯すべきカラãƒ??をカンマ区åˆ?‚Š(CVS形å¼?でæŒ?®šしまã�?
082 * language 【TAG】タグå†?ƒ¨で使用するè¨?ªžコード[ja/en/zh/…]を指定しまã�?
083 * stopZero 【TAG】読込件数が0件のときå?ç�?‚’続行するかどã�?�‹[true/false]を指定しまã�?初期値:false[続行する])
084 * scope 【TAG】キャãƒ?‚·ュする場合ã?スコープ[request/page/session/applicaton]を指定しまã�?初期値:session)
085 * mainTrans 【TAGã€?通常使ã�?�¾せん)タグで処ç�?�•れる処ç�?�Œメインとなるトランザクション処ç�?�‹どã�?�‹を指定しまã�?初期値:false)
086 * skipRowCount 【TAGã€?通常は使ã�?�¾せん)ãƒ??タの読み飛ã?し件数を設定しまã�?
087 * useRenderer 【TAG】読取å?ç�?�§ラベルをコードリソースにé€?¤‰換を行うかどã�?�‹を指定しまã�?(初期値:USE_TABLE_READER_RENDERER[=false])
088 * caseKey 【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null) 5.7.7.2 (2014/06/20)
089 * caseVal 【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null) 5.7.7.2 (2014/06/20)
090 * caseNN 【TAG】指定ã?値がã?null/ゼロæ–?—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true) 5.7.7.2 (2014/06/20)
091 * caseNull 【TAG】指定ã?値がã?null/ゼロæ–?—å? の場合ã?、このタグは使用されまã�?初期値:true) 5.7.7.2 (2014/06/20)
092 * debug 【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
093 * />
094 *
095 * ●使用ä¾?
096 *
097 * <og:readTable
098 * command = "NEW"
099 * readerClass = "Fixed" 固定長ãƒ??タの読み取り
100 * modifyType = "{@modifyType}" 読取時のモãƒ?‚£ファイタイãƒ?A,Cç?
101 * fileURL = "{@USER.ID}" 読み取りå…?ƒ‡ィレクトリå�?
102 * filename = "{@filename}" 読み取りå…?ƒ•ァイルå�?
103 * encode = "Shift_JIS" 読み取りå…?ƒ•ァイルエンコード名
104 * maxRowCount = "10000" 読取最大件数(0:[無制限])
105 * columns = "OYA,KO,HJO,SU,DYSTR,DYEND" #NAME に対応するカラãƒ??
106 * useNumber = "false" 行番号の存在しなã�?ƒ‡ータを読み取りますã?
107 * adjustColumns = "OYA,KO,HJO,SU" ãƒ??タ変換するカラãƒ??("*" で全カラãƒ?
108 * checkColumns = "OYA,KO,HJO,SU" 整合æ?チェãƒ?‚¯するカラãƒ??("*" で全カラãƒ?
109 * nullCheck = "OYA,KO,SU" NULLチェãƒ?‚¯を実行しまã�?"*" で全カラãƒ?
110 * stopZero = "true" 取å¾?件の場合に以降ã?処ç�?‚’停止しまã�?
111 * skipRowCount = "4" ãƒ??タの読み飛ã?し件数(読み込み開始ã?、この数字+1行目から)
112 * />
113 *
114 * @og.group ファイル入åŠ?
115 *
116 * @version 4.0
117 * @author Kazuhiko Hasegawa
118 * @since JDK5.0,
119 */
120 public class ReadTableTag extends CommonTagSupport {
121 //* こã?プログラãƒ??VERSIONæ–?—å?を設定しますã? {@value} */
122 private static final String VERSION = "5.7.7.2 (2014/06/20)" ;
123
124 private static final long serialVersionUID = 577220140620L ;
125
126 private static final int ERROR_ROW_COUNT = 200 ; // 4.0.0 (2007/05/25)
127
128 /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 新規作æ? {@value} */
129 public static final String CMD_NEW = "NEW" ;
130 /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 再検索 {@value} */
131 public static final String CMD_RENEW = "RENEW" ;
132
133 private static final String[] COMMAND_LIST = new String[] { CMD_NEW , CMD_RENEW };
134
135 private String separator = TableReader.TAB_SEPARATOR; // é ?›®区åˆ?‚Šæ–??
136 private String fileURL = HybsSystem.sys( "FILE_URL" );
137 private String filename = HybsSystem.sys( "FILE_FILENAME" ); // ファイルå�?
138 private String encode = HybsSystem.sys( "FILE_ENCODE" ); // ファイルエンコーãƒ?‚£ング "JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
139 private String readerClass = HybsSystem.sys( "TABLE_READER_DEFAULT_CLASS" ); // 3.8.5.3 (2006/08/07)
140 private int maxRowCount = -1;
141 private String displayMsg = HybsSystem.sys( "VIEW_DISPLAY_MSG" );
142 private String notfoundMsg = "MSG0077"; // 対象ãƒ??タはありませんでしたã€?
143 private int executeCount = -1; // 検索/実行件数
144 private String modifyType = null;
145 private String adjustColumns = null; // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
146 private String checkColumns = null; // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
147 private String nullCheck = null; // 3.8.0.2 (2005/06/30) nullチェãƒ?‚¯確èª?
148
149 private transient DBTableModel table = null;
150 private String command = CMD_NEW;
151 private String tableId = HybsSystem.TBL_MDL_KEY ;
152 private String sheetName = null ; // 3.5.4.2 (2003/12/15)
153 private String sheetNos = null ; // 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるようにするã€?
154 private String sheetConstKeys = null ; // 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��(CSV形å¼?
155 private String sheetConstAdrs = null ; // 5.5.8.2 (2012/11/09) 固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
156 private String nullBreakClm = null; // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
157
158 // 3.5.4.5 (2004/01/23) 外部よりカラãƒ??(カンマ区åˆ?‚Š)を指定できるようにするã€?
159 private String columns = null;
160 private boolean useNumber = true; // 3.7.0.5 (2005/04/11)
161
162 private boolean stopZero = false; // 4.3.7.0 (2009/06/01) stopZero属æ?追åŠ?
163
164 // 5.1.8.0 (2010/07/01) AutoReaderのCalc対å¿?
165 private static final String[] AUTO_READER_CLASS = new String[] { "Excel","Calc","Default" ,"Default" };
166 private static final String[] AUTO_READER_ENCODE = new String[] { null ,null ,"UnicodeLittle","Windows-31J" };
167
168 private boolean isMainTrans = true; // 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??見直ã�?
169 private int skipRowCount = 0; // 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?
170
171 // 5.2.1.0 (2010/10/01) 読取å?ç�?�§コードリソースのラベル変換を行うかどã�?�‹
172 private boolean useRenderer = HybsSystem.sysBool( "USE_TABLE_READER_RENDERER" ); // 5.2.1.0 (2010/10/01)
173
174 /**
175 * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
176 *
177 * @og.rev 3.0.1.4 (2003/03/17) displayMsg ã�??�Byteの場合ã?、件数も表示しなã�?‚ˆã�?�«変更ã€?
178 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
179 * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader をã?InputStream に変更ã€?
180 * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream をã? BufferedReader に戻すã?
181 * @og.rev 3.5.6.5 (2004/08/09) 暫定的に、DBTableModelをå?行削除しますã?
182 * @og.rev 3.6.0.0 (2004/09/24) DBTableModel の先行削除は、scope="session" の場合ã?みã€?
183 * @og.rev 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯用に、checkColumns,adjustColumns 属æ?追åŠ?
184 * @og.rev 3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェãƒ?‚¯を行いますã?
185 * @og.rev 3.8.5.3 (2006/08/07) readerClassã�?"Excel"でエラーが発生したときã?もうä¸?º¦Defaultで再読取を行いますã?
186 * @og.rev 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行いますã?
187 * @og.rev 4.0.0.0 (2007/10/18) メãƒ?‚»ージリソース統å�? getResource().getMessage â‡?getResource().getLabel )
188 * @og.rev 4.3.1.1 (2008/10/08) columnsが指定されてã�?‚‹場合ã?、AutoReader禁止
189 * @og.rev 4.3.7.0 (2009/06/01) stopZero機è?,DB.COUNTリクエストキーへ読込件数セãƒ?ƒˆを追åŠ?
190 * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??、DBTableModelが新規作æ?されたå?ç�?�§のみ行うã€?
191 * @og.rev 5.1.8.0 (2010/07/01) AutoReaderのCalc対å¿?
192 * @og.rev 5.1.9.0 (2010/08/01) AutoReaderでのExceptionの判定をThrowableに変更
193 * @og.rev 5.7.1.2 (2013/12/20) tempMsg.toString() â‡?errMsg 変更
194 * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
195 *
196 * @return 後続å?ç�??æŒ?¤º
197 */
198 @Override
199 public int doEndTag() {
200 debugPrint(); // 4.0.0 (2005/02/28)
201 // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
202 if( !useTag() ) { return EVAL_PAGE ; }
203
204 if( check( command, COMMAND_LIST ) ) {
205 useMainTrans( isMainTrans ); // 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??見直ã�?
206 startQueryTransaction( tableId ); // 3.6.0.8 (2004/11/19)
207
208 // 3.5.6.5 (2004/08/09) 削除するのは、セãƒ?‚·ョンのオブジェクトでよいã€?
209 // 3.6.0.0 (2004/09/24) 削除するのは、scope="session" の場合ã?みã€?
210 if( "session".equals( getScope() ) ) {
211 removeSessionAttribute( tableId );
212 removeSessionAttribute( HybsSystem.VIEWFORM_KEY );
213 }
214
215 if( maxRowCount < 0 ) {
216 maxRowCount = sysInt( "DB_MAX_ROW_COUNT" );
217 }
218
219 // ファイル の読み込み?šAutoReader 処ç�?
220 BufferedReader pw = null;
221 final String[] READER_CLASS ;
222 final String[] READER_ENCODE ;
223 if( "AutoReader".equalsIgnoreCase( readerClass ) ) {
224 // 4.3.1.1 (2008/10/08)
225 if( columns != null && columns.length() > 0 ) {
226 String errMsg = "columnsが指定されてã�?‚‹場合ã?、readerClass=\"AutoReader\"は使えません";
227 throw new HybsSystemException( errMsg ); // 4.3.4.4 (2009/01/01)
228 }
229 READER_CLASS = AUTO_READER_CLASS ;
230 READER_ENCODE = AUTO_READER_ENCODE;
231 }
232 else {
233 READER_CLASS = new String[] { readerClass };
234 READER_ENCODE = new String[] { encode };
235 }
236
237 StringBuilder tempMsg = new StringBuilder();
238 for( int i=0; i<READER_CLASS.length; i++ ) {
239 readerClass = READER_CLASS[i];
240 encode = READER_ENCODE[i];
241
242 try {
243 // 5.1.8.0 (2010/07/01) AutoReaderのCalc対å¿?
244 if( "Excel".equalsIgnoreCase( readerClass ) || "Calc".equalsIgnoreCase( readerClass ) ) {
245 create( null );
246 }
247 else {
248 pw = getBufferedReader();
249 create( pw );
250 }
251 // 成功すれば、エラーメãƒ?‚»ージをクリアして、その場で抜けるã?
252 tempMsg = null;
253 break;
254 }
255 // 3.8.5.3 (2006/08/07) readerClassã�?"Excel"でエラーが発生したときã?もうä¸?º¦Defaultで再読取を行いますã?
256 // 5.1.9.0 (2010/08/01) RuntimeException系のExceptionがキャãƒ?ƒ�できなã�?�Ÿめã?Throwableで受けã‚?
257 catch( Throwable th ) {
258 tempMsg.append( "readerClass=[" ).append( readerClass )
259 .append( "],encode=[" ).append( encode )
260 .append( "] Error!" ).append( HybsSystem.CR )
261 .append( th.getMessage() ).append( HybsSystem.CR ) ;
262 }
263 finally {
264 Closer.ioClose( pw ); // 4.0.0 (2006/01/31) close 処ç�?™‚の IOException を無è¦?
265 }
266 }
267
268 if( tempMsg != null ) { // æœ?¾Œまでエラーがあれã?、例外å?ç�?‚’発行しますã?
269 String errMsg = tempMsg.toString();
270 System.err.print( errMsg );
271 throw new HybsSystemException( errMsg ); // 5.7.1.2 (2013/12/20) msg â‡?errMsg 変更
272 }
273
274 if( table != null ) {
275 // 3.6.0.2 (2004/10/04)
276 // 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行いますã?
277 executeCount = table.getRowCount();
278 if( modifyType != null ) {
279 for( int row=0; row<executeCount; row++ ) {
280 table.setModifyType( row,modifyType );
281 }
282 }
283
284 ErrorMessage errMsg = checkTableColumn( table );
285 if( errMsg != null && ! errMsg.isOK()) {
286 jspPrint( TaglibUtil.makeHTMLErrorTable( errMsg,getResource() ) );
287 return SKIP_PAGE ;
288 }
289
290 }
291 // 3.6.0.8 (2004/11/19) トランザクションチェãƒ?‚¯を行いますã?
292 if( ! commitTableObject( tableId, table ) ) {
293 jspPrint( "ReadTableTag Query処ç�?�Œ割り込まれましたã€?BTableModel は登録しませんã€? );
294 return SKIP_PAGE ;
295 }
296
297 StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_SMALL );
298
299 // 実行件数の表示 command="NEW" のときã?み、displayMsg を表示させますã?
300 // 4.0.0 (2005/11/30) 出力é?の変更。ä¸?•ªæœ??に出力しますã?
301 if( CMD_NEW.equals( command ) ) {
302 if( executeCount > 0 && displayMsg != null && displayMsg.length() > 0 ) {
303 buf.append( executeCount );
304 buf.append( getResource().getLabel( displayMsg ) );
305 buf.append( HybsSystem.BR );
306 }
307 else if( executeCount == 0 && notfoundMsg != null && notfoundMsg.length() > 0 ) {
308 buf.append( getResource().getLabel( notfoundMsg ) );
309 buf.append( HybsSystem.BR );
310 }
311 }
312
313 // 4.3.7.0 (2009/06/01) 読込件数をã?"DB.COUNT" キーでリクエストにセãƒ?ƒˆするã€?
314 setRequestAttribute( "DB.COUNT" , String.valueOf( executeCount ) );
315
316 jspPrint( buf.toString() );
317 }
318
319 // 4.3.7.0 (2009/06/01) stopZero機è?を追åŠ?
320 final int rtnCode ;
321 if( executeCount == 0 && stopZero ) {
322 rtnCode = SKIP_PAGE;
323 }
324 else {
325 rtnCode = EVAL_PAGE;
326 }
327
328 return rtnCode ;
329 }
330
331 /**
332 * タグリブオブジェクトをリリースしますã?
333 * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
334 *
335 * @og.rev 2.0.0.4 (2002/09/27) カスタãƒ?‚¿グの release() メソãƒ?ƒ‰をã?追åŠ?
336 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
337 * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得するã?
338 * @og.rev 3.1.4.0 (2003/04/18) command 属æ?に、å?期å?(NEW)を設定するã?
339 * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更ã€?
340 * @og.rev 3.5.4.5 (2004/01/23) 外部よりカラãƒ??(カンマ区åˆ?‚Š)を指定できるようにするã€?
341 * @og.rev 3.6.0.2 (2004/10/04) checkColumns,adjustColumns,allColumnCheck 属æ?追åŠ?
342 * @og.rev 3.7.0.5 (2005/04/11) useNumber 属æ?を追åŠ?�—ますã?
343 * @og.rev 3.8.0.2 (2005/06/30) nullCheck 属æ?追åŠ?
344 * @og.rev 3.8.5.3 (2006/08/07) readerClass 属æ?の初期値をシスãƒ?ƒ リソースより取得しますã?
345 * @og.rev 4.3.7.0 (2009/06/01) stopZero属æ?追åŠ?
346 * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??、DBTableModelが新規作æ?されたå?ç�?�§のみ行うã€?
347 * @og.rev 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?skipRowCount 属æ?追åŠ?
348 * @og.rev 5.2.1.0 (2010/10/01) 読取å?ç�?�§コードリソースのラベル変換を行うかどã�?�‹ useRenderer 属æ?追åŠ?
349 * @og.rev 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるように、sheetNos属æ?追åŠ?
350 * @og.rev 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��、アドレスのæŒ?®šã?ための、sheetConstKeys、sheetConstAdrs属æ?追åŠ?
351 * @og.rev 5.5.8.2 (2012/11/09) カラãƒ??に NULL が現れた時点で読み取りを中止する、nullBreakClm属æ?追åŠ?
352 */
353 @Override
354 protected void release2() {
355 super.release2();
356 separator = TableReader.TAB_SEPARATOR; // é ?›®区åˆ?‚Šæ–??
357 fileURL = HybsSystem.sys( "FILE_URL" );
358 filename = HybsSystem.sys( "FILE_FILENAME" ); // ファイルå�?
359 encode = HybsSystem.sys( "FILE_ENCODE" ); // ファイルエンコーãƒ?‚£ング "JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
360 readerClass = HybsSystem.sys( "TABLE_READER_DEFAULT_CLASS" ); // 3.8.5.3 (2006/08/07)
361 maxRowCount = -1;
362 displayMsg = HybsSystem.sys( "VIEW_DISPLAY_MSG" );
363 notfoundMsg = "MSG0077"; // 対象ãƒ??タはありませんでしたã€?
364 executeCount = -1; // 検索/実行件数
365 modifyType = null;
366 command = CMD_NEW;
367 table = null;
368 tableId = HybsSystem.TBL_MDL_KEY ;
369 sheetName = null; // 3.5.4.2 (2003/12/15)
370 sheetNos = null ; // 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるようにするã€?
371 sheetConstKeys = null ; // 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��(CSV形å¼?
372 sheetConstAdrs = null ; // 5.5.8.2 (2012/11/09) 固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
373 nullBreakClm = null; // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
374 columns = null; // 3.5.4.5 (2004/01/23)
375 useNumber = true; // 3.7.0.5 (2005/04/11)
376 adjustColumns = null; // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
377 checkColumns = null; // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
378 nullCheck = null; // 3.8.0.2 (2005/06/30)
379 stopZero = false; // 4.3.7.0 (2009/06/01) soptZero追åŠ?
380 isMainTrans = true; // 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??見直ã�?
381 skipRowCount = 0; // 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?
382 useRenderer = HybsSystem.sysBool( "USE_TABLE_READER_RENDERER" ); // 5.2.1.0 (2010/10/01)
383 }
384
385 /**
386 * TableReader の実オブジェクトを生æ?して?ŒBufferedReader に書き込みますã?
387 *
388 * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader をã?InputStream に変更ã€?
389 * @og.rev 3.5.4.2 (2003/12/15) TableReader のサブクラス名変更ã€?
390 * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更ã€?
391 * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream をã? BufferedReader に戻すã?
392 * @og.rev 3.5.4.5 (2004/01/23) TableReader に、encode を渡すよã�?�«変更ã€?
393 * @og.rev 3.5.6.0 (2004/06/18) å�?¨®プラグイン関連付け設定を、シスãƒ?ƒ パラメータ に記述しますã?
394 * @og.rev 3.7.0.5 (2005/04/11) useNumber 属æ?を追åŠ?�—ますã?
395 * @og.rev 4.0.0.0 (2005/01/31) キーのæŒ?®šを、TableReader. から、TableReader_ に変更しますã?
396 * @og.rev 4.0.0.0 (2005/01/31) lang â‡?ResourceManager へ変更
397 * @og.rev 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?skipRowCount 属æ?追åŠ?
398 * @og.rev 5.2.1.0 (2010/10/01) 読取å?ç�?�§コードリソースのラベル変換を行うかどã�?�‹設å®?useRenderer 属æ?追åŠ?
399 * @og.rev 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるように、sheetNos属æ?追åŠ?
400 * @og.rev 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��、アドレスのæŒ?®šã?ための、sheetConstKeys、sheetConstAdrs属æ?追åŠ?
401 * @og.rev 5.5.8.2 (2012/11/09) カラãƒ??に NULL が現れた時点で読み取りを中止する、nullBreakClm属æ?追åŠ?
402 *
403 * @param out 出力するBufferedReaderオブジェクãƒ?
404 */
405 protected void create( final BufferedReader out ) {
406
407 String className = HybsSystem.sys( "TableReader_" + readerClass ) ; // 4.0.0 (2005/01/31)
408 TableReader reader = (TableReader)HybsSystem.newInstance( className ); // 3.5.5.3 (2004/04/09)
409
410 reader.setResourceManager( getResource() ); // 4.0.0 (2005/01/31)
411 reader.setSeparator( separator );
412 reader.setEncode( encode ); // 3.5.4.5 (2004/01/23)
413 reader.setColumns( columns ); // 3.5.4.5 (2004/01/23)
414 reader.setUseNumber( useNumber ); // 3.7.0.5 (2005/04/11)
415 reader.setMaxRowCount( maxRowCount );
416 reader.setSkipRowCount( skipRowCount ); // 5.1.6.0 (2010/05/01)
417 reader.setUseRenderer( useRenderer ); // 5.2.1.0 (2010/10/01)
418 reader.setDebug( isDebug() ); // 5.5.7.2 (2012/10/09) ãƒ?ƒ�ãƒ?‚°æƒ??をå?力するかどã�?�‹を指å®?
419 if( reader.isExcel() ) { // 3.5.4.3 (2004/01/05)
420 reader.setFilename( HybsSystem.url2dir( StringUtil.urlAppend( fileURL,filename )));
421 reader.setSheetName( sheetName ); // 3.5.4.2 (2003/12/15)
422 reader.setSheetNos( sheetNos ); // 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるようにするã€?
423 reader.setSheetConstData( sheetConstKeys,sheetConstAdrs ) ; // 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��、アドレスのæŒ?®?
424 reader.setNullBreakClm( nullBreakClm ) ; // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
425 reader.readDBTable();
426 }
427 else {
428 reader.readDBTable( out );
429 }
430 table = reader.getDBTableModel();
431 }
432
433 /**
434 * BufferedReader を取得しますã?
435 *
436 * ここでは、ä¸?ˆ¬çš?�ªファイル出力をè€??した BufferedReader を作æ?しますã?
437 *
438 * @og.rev 2.2.0.0 (2002/12/17) 中国èª?国際化)対å¿?エンコードã?取得方法変更
439 * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得するã?
440 * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader をã?InputStream に変更ã€?
441 * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream をã? BufferedReader に戻すã?
442 * @og.rev 3.5.5.9 (2004/06/07) FileUtil.getBufferedReader を使用
443 *
444 * @return ファイル読取BufferedReaderオブジェクãƒ?
445 */
446 private BufferedReader getBufferedReader() {
447 if( filename == null ) {
448 String errMsg = "ファイル名がセãƒ?ƒˆされてã�?�¾せんã€?;
449 throw new HybsSystemException( errMsg );
450 }
451 String directory = HybsSystem.url2dir( fileURL );
452 File file = new File( StringUtil.urlAppend( directory,filename ) );
453
454 BufferedReader out = FileUtil.getBufferedReader( file,encode );
455
456 return out ;
457 }
458
459 /**
460 * カラãƒ?–‡字å?(CSV形å¼?から、カラãƒ?•ª号配å?を作æ?しますã?
461 * 簡易メソãƒ?ƒ‰ですã?
462 * 引数がã?"*" の場合ã?、å?カラãƒ?‚’æŒ?®šしたことになりますã?
463 * null の場合ã?、サイズã�???の配å?を返しますã?
464 *
465 * @og.rev 4.0.0.0 (2007/05/25) 新規作æ?
466 *
467 * @param clms カラãƒ?–‡字å?(CSV形å¼?
468 * @param table DBTableModelオブジェクãƒ?
469 *
470 * @return カラãƒ?•ª号配å?(無ã�??合ã?ã€?•·さ0ã?配å?)
471 */
472 private int[] makeClmNos( final String clms,final DBTableModel table ) {
473 final int[] clmNo;
474
475 if( clms == null ) {
476 clmNo = new int[0];
477 }
478 else if( "*".equals( clms ) ) {
479 int size = table.getColumnCount();
480 clmNo = new int[size];
481 for( int i=0; i<size; i++ ) {
482 clmNo[i] = i;
483 }
484 }
485 else {
486 String[] clmStr = StringUtil.csv2Array( clms );
487 int size = clmStr.length;
488 clmNo = new int[size];
489 for( int i=0; i<size; i++ ) {
490 clmNo[i] = table.getColumnNo( clmStr[i] );
491 }
492 }
493
494 return clmNo;
495 }
496
497 /**
498 * checkColumns にæŒ?®šされたカラãƒ?‚’チェãƒ?‚¯しますã?
499 * カラãƒ?‚ªブジェクトã?DBType属æ?に対応したチェãƒ?‚¯を行いますã?
500 * チェãƒ?‚¯結果で、エラーが発生したå?合ã?、ErrorMessage オブジェクトを
501 * 返しますã?
502 * DBColumn#valueCheck( String ) の結果のErrorMessageをすべて append
503 * してã�?��ますã?
504 * useAdjust==true で、かつ、エラーがなã�??合ã?、adjustColumns 処ç�?µ�果ã‚?
505 * DBTableModel に反映させますã?
506 * debug=true で、エラー時ã?詳細なãƒ??タをå?力しますã?
507 *
508 * @og.rev 3.6.0.2 (2004/10/04) 新規作æ?
509 * @og.rev 3.8.0.2 (2005/06/30) nullチェãƒ?‚¯確èª?
510 * @og.rev 4.0.0.0 (2007/05/25) 処ç�??序書き換ã�?
511 *
512 * @param table DBTableModelオブジェクãƒ?
513 *
514 * @return カラãƒ?‚ー ??値 のエラーメãƒ?‚»ージオブジェクãƒ?
515 */
516 private ErrorMessage checkTableColumn( final DBTableModel table ) {
517 ErrorMessage errMsg = new ErrorMessage( "Check Columns Error!" );
518
519 int rowCnt = table.getRowCount();
520 int[] adjClmNo = makeClmNos( adjustColumns,table );
521 int[] chkClmNo = makeClmNos( checkColumns,table );
522 int[] nllclmNo = makeClmNos( nullCheck,table );
523
524 boolean useAdjust = adjClmNo.length > 0 ;
525
526 for( int row=0; row<rowCnt; row++ ) {
527 String[] vals = table.getValues( row );
528 DBColumn[] dbClms = table.getDBColumns();
529 boolean isError = false; // 5.5.7.2 (2012/10/09) エラー時ã?フラグ。ループでクリアするã€?
530
531 // adjustColumns 処ç�?
532 for( int i=0; i<adjClmNo.length; i++ ) {
533 int no = adjClmNo[i];
534 vals[no] = dbClms[no].valueSet( vals[no] );
535 }
536
537 // checkColumns 処ç�?
538 for( int i=0; i<chkClmNo.length; i++ ) {
539 int no = chkClmNo[i];
540 ErrorMessage msg = dbClms[no].valueCheck( vals[no] );
541 if( msg.getKekka() > ErrorMessage.OK ) {
542 isError = true;
543 errMsg.append( row+1,dbClms[no].valueCheck( vals[no] ) );
544 }
545 }
546
547 // nullCheck 処ç�?
548 for( int i=0; i<nllclmNo.length; i++ ) {
549 int no = nllclmNo[i];
550 if( vals[no] == null || vals[no].length() == 0 ) {
551 isError = true;
552 String label = dbClms[no].getLabel();
553 // ERR0012 : æŒ?®šã?ãƒ??タがセãƒ?ƒˆされてã�?�¾せんã€?NULLエラー)。key={0}
554 errMsg.addMessage( row+1,ErrorMessage.NG,"ERR0012",label );
555 }
556 }
557
558 // 5.5.7.2 (2012/10/09) エラー時ã?ãƒ?ƒ�ãƒ?‚°出åŠ?
559 if( isDebug() && isError ) {
560 errMsg.addMessage( row+1,ErrorMessage.OK,"Debug Info",java.util.Arrays.toString(table.getValues(row) ) );
561 }
562
563 // adjustColumns 処ç�?µ�果を反æ˜?�•せますã?
564 if( useAdjust && !isError ) { table.setValues( vals,row ); }
565 if( errMsg.size() > ERROR_ROW_COUNT ) { break; }
566 }
567
568 return errMsg;
569 }
570
571 /**
572 * 【TAGã€?通常は使ã�?�¾せん)結果のDBTableModelをã?sessionに登録するときã?キーを指定しまã�?
573 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])ã€?
574 *
575 * @og.tag
576 * 検索結果より、DBTableModelオブジェクトを作æ?しますã?これをã?下流ã?viewタグ等に
577 * 渡すå?合にã€??常は、session を利用しますã?そã?場合ã?登録キーですã?
578 * query タグを同時に実行して、結果を求めるå?合ã?同ä¸?ƒ¡モリに配置される為ã€?
579 * こã? tableId 属æ?を利用して、メモリ空間をåˆ?�‘ますã?
580 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])ã€?
581 *
582 * @param id sessionに登録する時ã? ID
583 */
584 public void setTableId( final String id ) {
585 tableId = nval( getRequestParameter( id ), tableId );
586 }
587
588 /**
589 * 【TAG】可変長ファイルを作æ?するときã?é ?›®区åˆ?‚Šæ–?—をセãƒ?ƒˆしますã?
590 *
591 * @og.tag 可変長ファイルを作æ?するときã?é ?›®区åˆ?‚Šæ–?—をセãƒ?ƒˆしますã?
592 *
593 * @param separator é ?›®区åˆ?‚Šæ–??
594 */
595 public void setSeparator( final String separator ) {
596 this.separator = nval( getRequestParameter( separator ),this.separator );
597 }
598
599 /**
600 * 【TAG】読み取りå…?ƒ‡ィレクトリ名をæŒ?®šしまã�?
601 * (初期値:FILE_URL[={@og.value org.opengion.hayabusa.common.SystemData#FILE_URL}])ã€?
602 *
603 * @og.tag
604 * こã?属æ?でæŒ?®šされるãƒ?‚£レクトリより、ファイルを読み取りますã?
605 * æŒ?®š方法ã?ã€??常の fileURL 属æ?と同様に、å?頭がã?'/' (UNIX) またã?ã€?¼’文字目がã?
606 * ":" (Windows)の場合ã?、指定ã?URLそã?ままのãƒ?‚£レクトリに、そã�?�§なã�??合ã?ã€?
607 * fileURL = "{@USER.ID}" とæŒ?®šすると、FILE_URL 属æ?でæŒ?®šã?フォルãƒ??下にã€?
608 * さらに、各個人ID別のフォルãƒ?‚’作æ?して、そこを操作しますã?
609 * (初期値:シスãƒ?ƒ 定数のFILE_URL[={@og.value org.opengion.hayabusa.common.SystemData#FILE_URL}])ã€?
610 *
611 * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend メソãƒ?ƒ‰の利用
612 * @og.rev 4.0.0.0 (2007/11/20) æŒ?®šされたãƒ?‚£レクトリ名ã?æœ?¾Œが"\"or"/"で終わってã�?�ªã�??合にã€?/"を付加するã€?
613 *
614 * @param url 読み取りå…?ƒ‡ィレクトリå�?
615 * @see org.opengion.hayabusa.common.SystemData#FILE_URL
616 */
617 public void setFileURL( final String url ) {
618 String furl = nval( getRequestParameter( url ),null );
619 if( furl != null ) {
620 char ch = furl.charAt( furl.length()-1 );
621 if( ch != '/' && ch != '\\' ) { furl = furl + "/"; }
622 fileURL = StringUtil.urlAppend( fileURL,furl );
623 }
624 }
625
626 /**
627 * 【TAG】ファイルを作æ?するときã?ファイル名をセãƒ?ƒˆしまã�?
628 * (初期値:FILE_FILENAME[={@og.value org.opengion.hayabusa.common.SystemData#FILE_FILENAME}])ã€?
629 *
630 * @og.tag ファイルを作æ?するときã?ファイル名をセãƒ?ƒˆしますã?
631 * (初期値:シスãƒ?ƒ 定数のFILE_FILENAME[={@og.value org.opengion.hayabusa.common.SystemData#FILE_FILENAME}])ã€?
632 *
633 * @param filename ファイルå�?
634 * @see org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
635 */
636 public void setFilename( final String filename ) {
637 this.filename = nval( getRequestParameter( filename ),this.filename );
638 }
639
640 /**
641 * 【TAG】ファイルを作æ?するときã?ファイルエンコーãƒ?‚£ング名をセãƒ?ƒˆしまã�?
642 * (初期値:FILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])ã€?
643 *
644 * @og.tag
645 * Shift_JIS,MS932,Windows-31J,UTF-8,ISO-8859-1,UnicodeLittle
646 * (初期値:シスãƒ?ƒ 定数のFILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])ã€?
647 *
648 * @og.rev 2.2.0.0 (2002/12/17) 中国èª?国際化)対å¿?エンコードã?取得方法変更
649 * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得するã?
650 *
651 * @param enc ファイルエンコーãƒ?‚£ングå�?
652 * @see <a href="http://www.iana.org/assignments/character-sets">IANA Charset Registry</a>
653 * @see org.opengion.hayabusa.common.SystemData#FILE_ENCODE
654 */
655 public void setEncode( final String enc ) {
656 encode = nval( getRequestParameter( enc ),encode );
657 }
658
659 /**
660 * 【TAG】実際に読み出すクラス名ã?略称(TableReader_**** の ****)をセãƒ?ƒˆしまã�?{@og.doc03Link readerClass 初期値:Default})ã€?
661 *
662 * @og.tag
663 * 実際に読み出すクラスå�?の略称)をセãƒ?ƒˆしますã?
664 * これは、org.opengion.hayabusa.io 以下ã? TableReader_**** クラスの **** ã‚?
665 * 与えますã?これらã?、TableReader インターフェースを継承したサブクラスですã?
666 * 属æ?クラス定義の {@link org.opengion.hayabusa.io.TableReader TableReader} を参照願いますã?
667 * {@og.doc03Link readerClass TableReader_**** クラス}
668 *
669 * @param readerClass クラスå�?の略称)
670 * @see org.opengion.hayabusa.io.TableReader TableReaderのサブクラス
671 */
672 public void setReaderClass( final String readerClass ) {
673 this.readerClass = nval( getRequestParameter( readerClass ),this.readerClass );
674 }
675
676 /**
677 * 【TAG】読取時のæœ?¤§取り込み件数をセãƒ?ƒˆしまã�?
678 * (初期値:DB_MAX_ROW_COUNT[={@og.value org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT}])ã€?
679 *
680 * @og.tag
681 * DBTableModelのãƒ??タとして登録するæœ?¤§件数をこの値に設定しますã?
682 * サーバã?のメモリè³?º�と応答時間ã?確保ã?為ですã?
683 * 0 をセãƒ?ƒˆすると、無制é™?Integer.MAX_VALUE)になりますã?
684 * (初期値:ユーザー定数のDB_MAX_ROW_COUNT[={@og.value org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT}])ã€?
685 *
686 * @og.rev 5.5.8.5 (2012/11/27) 0を無制限として処ç�?�—ますã?
687 *
688 * @param count 読取時のæœ?¤§取り込み件数
689 * @see org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT
690 */
691 public void setMaxRowCount( final String count ) {
692 maxRowCount = nval( getRequestParameter( count ),maxRowCount );
693 if( maxRowCount == 0 ) { maxRowCount = Integer.MAX_VALUE ; } // 5.5.8.5 (2012/11/27)
694 }
695
696 /**
697 * 【TAG】コマンãƒ?NEW,RENEW)をセãƒ?ƒˆしまã�?初期値:NEW)ã€?
698 *
699 * @og.tag
700 * コマンドã?,HTMLから(get/post)æŒ?®šされますã?で,CMD_xxx で設定される
701 * フィールド定数値のã�?�¥れかをã?æŒ?®šできますã?
702 * 何も設定されなã�??またã?、null の場合ã?ã€?NEW" がå?期å?にセãƒ?ƒˆされますã?
703 *
704 * @param cmd コマンãƒ?public static final 宣è¨?�•れてã�?‚‹æ–?—å?)
705 * @see <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.ReadTableTag.CMD_NEW">コマンド定数</a>
706 */
707 public void setCommand( final String cmd ) {
708 String cmd2 = getRequestParameter( cmd );
709 if( cmd2 != null && cmd2.length() > 0 ) { command = cmd2.toUpperCase(Locale.JAPAN); }
710 }
711
712 /**
713 * 【TAG】query の結果を画面上に表示するメãƒ?‚»ージIDを指定しまã�?初期値:MSG0033[ã€?»¶検索しました])ã€?
714 *
715 * @og.tag
716 * ここでは、検索結果の件数ã‚?™»録された件数をまずå?力しã€?
717 * そã?次に、ここでæŒ?®šしたメãƒ?‚»ージをリソースから取得して
718 * 表示しますã?
719 * 表示させたくなã�??合ã?, displayMsg = "" をセãƒ?ƒˆしてくださいã€?
720 * 初期値は、検索件数を表示しますã?
721 *
722 * @param id ãƒ?‚£スプレイに表示させるメãƒ?‚»ージ ID
723 */
724 public void setDisplayMsg( final String id ) {
725 if( id != null ) { displayMsg = id; }
726 }
727
728 /**
729 * 【TAG】検索結果がゼロ件の場合に表示するメãƒ?‚»ージリソースIDを指定しまã�?初期値:MSG0077[対象ãƒ??タはありませんでした])ã€?
730 *
731 * @og.tag
732 * ここでは、検索結果がゼロ件の場合ã?み、特別なメãƒ?‚»ージを表示させますã?
733 * 従来は、displayMsg と兼用で、ã?0ã€?»¶検索しました』とã�?�†表示でしたがã?
734 * displayMsg の初期表示は、OFF になりましたので、ゼロ件の場合ã?み別に表示させますã?
735 * 表示させたくなã�??合ã?, notfoundMsg = "" をセãƒ?ƒˆしてくださいã€?
736 * 初期値は、MSG0077[対象ãƒ??タはありませんでした]ですã?
737 *
738 * @param id ãƒ?‚£スプレイに表示させるメãƒ?‚»ージ ID
739 */
740 public void setNotfoundMsg( final String id ) {
741 String ids = getRequestParameter( id );
742 if( ids != null ) { notfoundMsg = ids; }
743 }
744
745 /**
746 * 【TAG】ファイル取り込み時ã? モãƒ?‚£ファイタイãƒ?A(追åŠ?,C(更新),D(削除))を指定しますã?
747 *
748 * @og.tag
749 * ファイル読み込み時に、そのãƒ??タをA(追åŠ?、C(更新)、D(削除)の
750 * モãƒ?‚£ファイタイプをつけた状態にしますã?
751 * そã?状態で、そのまま、update する事が可能になりますã?
752 *
753 * @param type ファイル取り込み時ã? モãƒ?‚£ファイタイãƒ?A,C,D属æ?)
754 */
755 public void setModifyType( final String type ) {
756 modifyType = getRequestParameter( type );
757 }
758
759 /**
760 * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート名を設定しまã�?初期値:æŒ?®šなã�?ã€?
761 *
762 * @og.tag
763 * EXCELファイルを読み込ã‚?™‚に、シート名を指定しますã?これにより、è¤?•°の形式ã?
764 * 異なるデータをé?次読み込ã‚?�“とã‚??シートをæŒ?®šして読み取ることが可能になりますã?
765 * sheetNos と sheetName が同時にæŒ?®šされた場合ã?、sheetNos が優先されますã?エラーにはならなã�??でご注意くã�?�•ã�??
766 * 初期値は、指定なしですã?
767 *
768 * @og.rev 3.5.4.2 (2003/12/15) 新規追åŠ?
769 *
770 * @param sheet EXCELファイルのシート名
771 * @see #setSheetNos( String )
772 */
773 public void setSheetName( final String sheet ) {
774 sheetName = nval( getRequestParameter( sheet ),sheetName );
775 }
776
777 /**
778 * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート番号を指定しまã�?初期値:0)ã€?
779 *
780 * @og.tag
781 * EXCEL読み込み時にè¤?•°シートをマã?ジして取り込みますã?
782 * シート番号はã€? から始まる数字で表しますã?
783 * ヘッãƒ??は、最初ã?シートã?カラãƒ?½�置に合わせますã??ˆã?ãƒ?ƒ€ータイトルの自動認識ã?ありません。ï¼?
784 * よって、指定するシートã?、すべて同ä¸?ƒ¬イアウトでなã�?�¨取り込み時にカラãƒ??ずれが発生しますã?
785 *
786 * シート番号のæŒ?®šã?、カンマ区åˆ?‚Šで、è¤?•°æŒ?®šできますã?またã?N-M の様にハイフンで繋げることでã€?
787 * N 番から、M 番のシートç¯?›²をä¸?‹¬æŒ?®š可能ですã?またã?"*" による、å?シート指定が可能ですã?
788 * これらã?çµ?�¿合わせも可能ですã???0,1,3,5-8,10-* ??
789 * ただしã?"*" に関しては例外的に、ä¸?–‡字だけで、すべてのシートを表すか、N-* を最後にæŒ?®šするかの
790 * どちらかですã?途中にはã€?*" は、現れませんã€?
791 * シート番号はã€?‡�è¤?1,1,2,2)ã€??転(3,2,1) でのæŒ?®šが可能ですã?これは、そのæŒ?®šé?で、読み込まれますã?
792 * sheetNos と sheetName が同時にæŒ?®šされた場合ã?、sheetNos が優先されますã?エラーにはならなã�??でご注意くã�?�•ã�??
793 *
794 * 初期値はã€??ˆ第ä¸?‚·ートï¼?ですã?
795 *
796 * @og.rev 5.5.7.2 (2012/10/09) 新規追åŠ?
797 *
798 * @param sheet EXCELファイルのシート番号??から始まるï¼?
799 * @see #setSheetName( String )
800 */
801 public void setSheetNos( final String sheet ) {
802 sheetNos = nval( getRequestParameter( sheet ),sheetNos );
803 if( sheetNos != null && sheetNos.length() > 0 ) {
804 boolean errFlag = false;
805 for( int i=0; i<sheetNos.length(); i++ ) {
806 char ch = sheetNos.charAt(i);
807 if( ch == '-' || ch == ',' ) { continue; }
808 if( ch == '*' && ( i==0 || i==sheetNos.length()-1 ) ) { continue; }
809 if( ch < '0' || ch > '9' ) { errFlag = true; break; }
810 }
811 if( errFlag ) {
812 String errMsg = "sheetNos のæŒ?®šを見直してください。sheetNos=[" + sheetNos + "]";
813 throw new HybsSystemException( errMsg );
814 }
815 }
816 }
817
818 /**
819 * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート単位ã?固定å?を設定するためã?カラãƒ?��を指定しますã?
820 *
821 * @og.tag
822 * カラãƒ?��は、カンマ区åˆ?‚ŠでæŒ?®šしますã?
823 * これにより、シートã?ä¸?�‹æ‰?�«書かれてã�?‚‹æƒ??をã?DBTableModel のカラãƒ?�«固定å?として
824 * 設定することができますã?
825 * 例として、DB定義書で、テーブル名をシートã?全レコードに設定したい場合などに使ã�?�¾すã?
826 * こã?メソãƒ?ƒ‰は、isExcel() == true の場合ã?み利用されますã?
827 *
828 * @og.rev 5.5.8.2 (2012/11/09) 新規追åŠ?
829 *
830 * @param constKeys 固定å?となるカラãƒ?��(CSV形å¼?
831 * @see #setSheetConstAdrs( String )
832 */
833 public void setSheetConstKeys( final String constKeys ) {
834 sheetConstKeys = nval( getRequestParameter( constKeys ),null );
835 }
836
837 /**
838 * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート単位ã?固定å?を設定するためã?カラãƒ?��に対応するアドレスを指定しますã?
839 *
840 * @og.tag
841 * アドレスは、EXCEL上ã?è¡?列をカンマ区åˆ?‚ŠでæŒ?®šしますã?
842 * 行å?は、EXCELオブジェクトに準拠するためã€?¼�から始まる整数ですã?
843 * 0-0 â‡?A1 , 1-0 â‡?A2 , 0-1 â‡?B1 になりますã?
844 * これにより、シートã?ä¸?�‹æ‰?�«書かれてã�?‚‹æƒ??をã?DBTableModel のカラãƒ?�«固定å?として
845 * 設定することができますã?
846 * 例として、DB定義書で、テーブル名をシートã?全レコードに設定したい場合などに使ã�?�¾すã?
847 * こã?メソãƒ?ƒ‰は、isExcel() == true の場合ã?み利用されますã?
848 *
849 * 5.7.6.3 (2014/05/23) よりã€?
850 * â‘?XCEL表記に準拠した、A1,A2,B1 の記述もå?ç�?�§きるように対応しますã?
851 * なおã?A1,A2,B1 の記述は、å¿?�š、英å?æ–?—+数å?にしてくださいã€?A?žZまで)
852 * ②処ç�?¸のEXCELシート名をカラãƒ?�«割り当てるためにã€?SHEET" とã�?�†記号に対応しますã?
853 * 例えば、sheetConstKeys="CLM,LANG,NAME" としã?sheetConstAdrs="0-0,A2,SHEET" とするとã€?
854 * NAMEカラãƒ?�«は、シート名を読み込ã‚?�“とができますã?
855 * これは、å?部処ç�??簡ç´?Œ–のためですã?
856 *
857 * ちなみに、EXCELのセルに、シート名を表示させるå?合ã?関数は、下記ã?様になりますã?
858 * =RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1)))
859 *
860 * @og.rev 5.5.8.2 (2012/11/09) 新規追åŠ?
861 *
862 * @param constAdrs 固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
863 * @see #setSheetConstKeys( String )
864 */
865 public void setSheetConstAdrs( final String constAdrs ) {
866 sheetConstAdrs = nval( getRequestParameter( constAdrs ),null );
867 }
868
869 /**
870 * 【TAG】ここにæŒ?®šされたカラãƒ??に NULL が現れた時点で読み取りを中止しますã?
871 *
872 * @og.tag
873 * これは、指定ã?カラãƒ??å¿??とã�?�†事を条件に、そのレコードだけを読み取る処ç�?‚’行いますã?
874 * è¤?•°Sheetの場合ã?、次のSheetを読みますã?
875 * 現時点では、Excel の場合ã?み有効ですã?
876 *
877 * @og.rev 5.5.8.2 (2012/11/09) 新規追åŠ?
878 *
879 * @param clm カラãƒ??
880 */
881 public void setNullBreakClm( final String clm ) {
882 nullBreakClm = nval( getRequestParameter( clm ),null );
883 }
884
885 /**
886 * 【TAG】読み取りå…?ƒ•ァイルのカラãƒ??をã?外部(タグ)よりæŒ?®šしますã?
887 *
888 * @og.tag
889 * 読み取りå…?ƒ•ァイルのカラãƒ??をã?外部(タグ)よりæŒ?®šしますã?
890 * ファイルに記述されã�?#NAME より優先して使用されますã?
891 * これは、å?ファイルのカラãƒ?‚’é ?•ªにæŒ?®šã?カラãƒ?��に割り当てる機è?で
892 * ファイルの特定ã?カラãƒ??を抜きå?して取り込ã‚?©Ÿè?ではありませんã€?
893 *
894 * @og.rev 3.5.4.5 (2004/01/23) 新規作æ?
895 *
896 * @param clms 読み取りå…?ƒ•ァイルのカラãƒ??(カンマ区åˆ?‚Šæ–??
897 */
898 public void setColumns( final String clms ) {
899 columns = nval( getRequestParameter( clms ),columns );
900 }
901
902 /**
903 * 【TAG】読み取りå…?ƒ•ァイルの整合æ?チェãƒ?‚¯を行うカラãƒ??をカンマ指定しますã?
904 *
905 * @og.tag
906 * カラãƒ?‚ªブジェクトã?DBType属æ?に対応したチェãƒ?‚¯を行いますã?
907 * æŒ?®šã?カラãƒ?��をカンマ区åˆ?‚Š(CSV)でè¤?•°æŒ?®šできますã?
908 * 全てのカラãƒ??チェãƒ?‚¯を行う場合ã?、allColumnCheck = "true" ã‚?
909 * æŒ?®šして下さã�??
910 * åˆ?§£方法ã?ã€??常のパラメータ取得後に、CSVåˆ?§£しますã?
911 *
912 * @og.rev 3.6.0.2 (2004/10/04) 新規追åŠ?取り込み時チェãƒ?‚¯用
913 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSVåˆ?§£に戻しますã?
914 *
915 * @param clms 整合æ?チェãƒ?‚¯を行うカラãƒ??(カンマ区åˆ?‚Šæ–??
916 */
917 public void setCheckColumns( final String clms ) {
918 checkColumns = nval( getRequestParameter( clms ),checkColumns );
919 }
920
921 /**
922 * 【TAG】読み取りå…?ƒ•ァイルのãƒ??タ変換を行うカラãƒ??をカンマ指定しますã?
923 *
924 * @og.tag
925 * カラãƒ?‚ªブジェクトã?DBType属æ?に対応したデータ変換を行いますã?
926 * æŒ?®šã?カラãƒ?��をカンマ区åˆ?‚Š(CSV)でè¤?•°æŒ?®šできますã?
927 * åˆ?§£方法ã?ã€??常のパラメータ取得後に、CSVåˆ?§£しますã?
928 *
929 * @og.rev 3.6.0.2 (2004/10/04) 新規追åŠ?取り込み時データ変換
930 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSVåˆ?§£に戻しますã?
931 *
932 * @param clms ãƒ??タ変換を行うカラãƒ??(カンマ区åˆ?‚Šæ–??
933 */
934 public void setAdjustColumns( final String clms ) {
935 adjustColumns = nval( getRequestParameter( clms ),adjustColumns );
936 }
937
938 /**
939 * 【TAG】NULL チェãƒ?‚¯すべきカラãƒ??をカンマ区åˆ?‚Š(CVS形å¼?でæŒ?®šしますã?
940 *
941 * @og.tag nullCheck="AAA,BBB,CCC,DDD"
942 * åˆ?§£方法ã?ã€??常のパラメータ取得後に、CSVåˆ?§£しますã?
943 *
944 * @og.rev 3.8.0.2 (2005/06/30) 新規追åŠ?
945 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSVåˆ?§£に戻しますã?
946 *
947 * @param clms カラãƒ??(CVS形å¼?
948 */
949 public void setNullCheck( final String clms ) {
950 nullCheck = nval( getRequestParameter( clms ),nullCheck );
951 }
952
953 /**
954 * 【TAG】行番号æƒ??をã?使用してã�?‚‹/してã�?�ªい[true/false]を指定しまã�?初期値:true)ã€?
955 *
956 * @og.tag
957 * 通常のフォーマットでは、各行ã?先é?に行番号がå?力されてã�?�¾すã?
958 * 読み取り時にã€?NAME 属æ?を使用する場合ã?、この行番号を無視してã�?�¾すã?
959 * #NAME 属æ?を使用せず、columns 属æ?でカラãƒ?��を指定するå?å�?他シスãƒ?ƒ の
960 * 出力ファイルを読み取るケースç?では、行番号も存在しなã�?‚±ースがありã?
961 * そã?様な場合に、useNumber="false" を指定すれã?、データのæœ??から読み取り始めますã?
962 * こã?場合ã?出力データのカラãƒ??並びé ?�Œ変更されたå?合ã?columns 属æ?ã‚?
963 * æŒ?®šしなおすå¿?¦�がありますã?で、できるã�?�‘ã€?NAME 属æ?を使用するように
964 * してくださいã€?
965 * なおã?EXCEL 入力には、この設定ã?適用されませんã€?暫定対å¿?
966 * 初期値は、true(使用する) ですã?
967 *
968 * @og.rev 3.7.0.5 (2005/04/11) 新規追åŠ?
969 *
970 * @param useNo 行番号æƒ?? [true:使用する/false:使用しない]
971 */
972 public void setUseNumber( final String useNo ) {
973 useNumber = nval( getRequestParameter( useNo ),useNumber );
974 }
975
976 /**
977 * 【TAG】読込件数が0件のときå?ç�?‚’続行するかどã�?�‹[true/false]を指定しまã�?初期値:false[続行する])ã€?
978 *
979 * @og.tag
980 * 初期値は、false(続行すã‚?ですã?
981 *
982 * @og.rev 4.3.7.0 (2009/06/01) 新規追åŠ?
983 *
984 * @param cmd 読込件数が0件のときã?処ç�?‚’ [true:中止する/false:続行する]
985 */
986 public void setStopZero( final String cmd ) {
987 stopZero = nval( getRequestParameter( cmd ), stopZero );
988 }
989
990 /**
991 * 【TAGã€?通常使ã�?�¾せん)タグで処ç�?�•れる処ç�?�Œメインとなるトランザクション処ç�?�‹どã�?�‹を指定しまã�?初期値:false)ã€?
992 *
993 * @og.tag
994 * こã?値は、ファイルãƒ?‚¦ンロードå?ç�?�«影響しますã?こã?値がtrueにæŒ?®šされた時にcommitされたDBTableModelã�?
995 * ファイルãƒ?‚¦ンロードã?対象の表になりますã?
996 *
997 * こã?パラメーターはã€??常、各タグにより実è£?�•れã?ユーザーが指定するå¿?¦�ã?ありませんã€?
998 * ä½?�—ã€?つのJSPå†?�§DBTableModelがè¤?•°生æ?されるå?合に、前に処ç�?�—たDBTableModelにつã�?�¦ファイルãƒ?‚¦ンロードをさせたい
999 * 場合ã?、後ろでDBTableModelを生成するタグで、æ?示çš?�«こã?値をfalseにæŒ?®šすることで、ファイルãƒ?‚¦ンロードå?ç�??対象から
1000 * 除外することができますã?
1001 *
1002 * @og.rev 5.1.6.0 (2010/05/01) 新規作æ?
1003 *
1004 * @param flag メイントランザクションかどã�?�‹
1005 */
1006 public void setMainTrans( final String flag ) {
1007 isMainTrans = nval( getRequestParameter( flag ),isMainTrans );
1008 }
1009
1010 /**
1011 * 【TAGã€?通常は使ã�?�¾せん)ãƒ??タの読み飛ã?し件数を設定しますã?
1012 *
1013 * @og.tag
1014 * TAB区åˆ?‚Šãƒ?‚ストやEXCEL等ã?ãƒ??タの読み始めの初期値を指定しますã?
1015 * ファイルの先é?行がã€?¼�行としてカウントしますã?で、設定å?は、読み飛ã?ã�?
1016 * 件数になりますã?(?‘とæŒ?®šするとã€?¼‘件読み飛ã?しã??’行目から読み込みますã?)
1017 * 読み飛ã?しã?、コメント行などは、無視しますã?で、実際の行数åˆ?ªみ飛ã?しますã?
1018 * ?ƒNAME属æ?ã‚??columns 属æ?は、有効ですã?
1019 *
1020 * @og.rev 5.1.6.0 (2010/05/01) 新規作æ?
1021 *
1022 * @param count 読み始めの初期値
1023 */
1024 public void setSkipRowCount( final String count ) {
1025 skipRowCount = nval( getRequestParameter( count ),skipRowCount );
1026 }
1027
1028 /**
1029 * 【TAG】読取å?ç�?�§ラベルをコードリソースにé€?¤‰換を行うかどã�?�‹を指定しまã�?
1030 * (初期値:USE_TABLE_READER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER}])ã€?
1031 *
1032 * @og.tag
1033 * TableWriter_Renderer 系のクラスで出力したå?合ã?、コードリソースがラベルで出力されますã?
1034 * そã?ファイルを読み取ると、当然、エラーになりますã?
1035 * ここでは、コードリソースのカラãƒ?�«対して、ラベルからコードを求めるé?変換を行うことでã€?
1036 * Renderer 系で出力したファイルを取り込ã‚?�“とができるようにしますã?
1037 *
1038 * ここでは、TableWriter 系と同様に、TableReader_Renderer 系のクラスを作るのではなくã?
1039 * 属æ?値のフラグで、制御しますã?
1040 * å°?�¥çš?�«は、TableWriter 系もå»?¢して、同様ã?フラグで制御するように変更する予定ですã?
1041 * (初期値:シスãƒ?ƒ 定数のUSE_TABLE_READER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER}])ã€?
1042 *
1043 * @og.rev 5.2.1.0 (2010/10/01) 新規作æ?
1044 *
1045 * @param flag コードリソースのラベルé€?¤‰換を行うかどã�?�‹
1046 * @see org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER
1047 */
1048 public void setUseRenderer( final String flag ) {
1049 useRenderer = nval( getRequestParameter( flag ),useRenderer );
1050 }
1051
1052 /**
1053 * シリアライズ用のカスタãƒ?‚·リアライズ書き込みメソãƒ?ƒ‰
1054 *
1055 * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
1056 * @serialData ä¸?ƒ¨のオブジェクトã?、シリアライズされませんã€?
1057 *
1058 * @param strm ObjectOutputStreamオブジェクãƒ?
1059 * @throws IOException 入出力エラーが発生したå?å�?
1060 */
1061 private void writeObject( final ObjectOutputStream strm ) throws IOException {
1062 strm.defaultWriteObject();
1063 }
1064
1065 /**
1066 * シリアライズ用のカスタãƒ?‚·リアライズ読み込みメソãƒ?ƒ‰
1067 *
1068 * ここでは、transient 宣è¨?�•れたå†?ƒ¨変数のå†??初期化がå¿?¦�なフィールドã?み設定しますã?
1069 *
1070 * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
1071 * @serialData ä¸?ƒ¨のオブジェクトã?、シリアライズされませんã€?
1072 *
1073 * @param strm ObjectInputStreamオブジェクãƒ?
1074 * @see #release2()
1075 * @throws IOException シリアライズに関する入出力エラーが発生したå?å�?
1076 * @throws ClassNotFoundException クラスを見つけることができなかったå?å�?
1077 */
1078 private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
1079 strm.defaultReadObject();
1080 }
1081
1082 /**
1083 * こã?オブジェクトã?æ–?—å?表現を返しますã?
1084 * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
1085 *
1086 * @return こã?クラスのæ–?—å?表現
1087 */
1088 @Override
1089 public String toString() {
1090 return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
1091 .println( "VERSION" ,VERSION )
1092 .println( "separator" ,separator )
1093 .println( "fileURL" ,fileURL )
1094 .println( "filename" ,filename )
1095 .println( "encode" ,encode )
1096 .println( "readerClass" ,readerClass )
1097 .println( "maxRowCount" ,maxRowCount )
1098 .println( "displayMsg" ,displayMsg )
1099 .println( "executeCount" ,executeCount )
1100 .println( "modifyType" ,modifyType )
1101 .println( "checkColumns" ,checkColumns )
1102 .println( "adjustColumns" ,adjustColumns )
1103 .println( "nullCheck" ,nullCheck )
1104 .println( "command" ,command )
1105 .println( "tableId" ,tableId )
1106 .println( "sheetName" ,sheetName )
1107 .println( "sheetNos" ,sheetNos ) // 5.5.7.2 (2012/10/09)
1108 .println( "columns" ,columns )
1109 .println( "useNumber" ,useNumber )
1110 .println( "Other..." ,getAttributes().getAttribute() )
1111 .fixForm().toString() ;
1112 }
1113 }