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.fukurou.util.ErrorMessage;
022    import org.opengion.fukurou.util.FileUtil;
023    
024    import org.opengion.fukurou.util.StringUtil ;
025    import static org.opengion.fukurou.util.StringUtil.nval ;
026    
027    import java.util.Locale ;
028    import java.util.Set ;
029    import java.util.TreeSet ;
030    import java.util.Comparator ;
031    import java.io.File ;
032    import java.io.ObjectOutputStream;
033    import java.io.ObjectInputStream;
034    import java.io.IOException;
035    import java.io.Serializable;
036    
037    /**
038     * ファイル検索リストを?、action に基づ?処?行うタグです?
039     * command="ENTRY" 時?み処?行います?
040     *
041     * fileQuery などで検索したファイル?のDBTableModel を?に、ファイルの
042     * コピ?(COPY)、移?MOVE,MODIFY)、削除(DELETE)などの処?行います?
043     * 処?行うオリジナルファイルは、PARENT,NAME と?カラ?なければなりません?
044     * こ?カラ?は、fileQuery の検索時には、?作?されるカラ?す?
045     * また??クションに対応するターゲ?ファイルは、TO_PARENT,TO_NAME と?
046     * カラ??するか、targetDir 属?を利用してフォル??します?
047     * TO_PARENT(先フォル?と、TO_NAME(先ファイル?は、??応じて、?なカラ?
048     * あれば、?動的に処?ます?
049     * つまり?TO_PARENT のみの場合?、ファイル名?オリジナルのまま、フォル??み変更します?
050     * ?、TO_NAME の場合?、フォル??そ?ままで、ファイル名?み?します?
051     * 両方同時に?することも可能です?
052     * targetDir 属?で?する?合?、TO_PARENT のみに同じ値を設定した?合と同じになります?
053     * こ?属?を指定すると、TO_PARENT は無視されます?(TO_NAME は有効です?)
054     * COPY、MOVE(,MODIFY) の場合?、指定?フォル??処?能です?
055     * COPY、MOVE(,MODIFY) などの処?、ターゲ?フォル?存在しな?きに、作?するか?エラーにするか?
056     * createDir属? で?できます?初期値は?true:作?する) です?
057     * これは、COPY先やMOVE(,MODIFY)先が存在して?前提のシス?で、不要な?に間違ってフォル?
058     * 自動作?されると困る?合に?false:作?しな? とすれば?違いに気づく確?上がります?
059     *
060     * ※ こ?タグは、Transaction タグの対象ではありません?
061     *
062     * @og.formSample
063     * ●body?な?
064     * ●形式?
065     *      ・<og:fileUpdate
066     *          action      = "COPY|MOVE|MODIFY|DELETE" アクション属?(??)
067     *          command     = "[ENTRY]"                 ENTRY 時?み実行しま?初期値:ENTRY)
068     *          targetDir   = "[?フォル?"          ターゲ?となるフォル?
069     *          createDir   = "[true/false]"            ターゲ?となるフォル?なければ作?する(true)かど?(初期値:true)
070     *          tableId     = [HybsSystem.TBL_MDL_KEY]  DBTableModel を取り?すキー
071     *          outMessage  = "[true/false]"            検索結果のメ?ージを表示する(true)かど?を指?初期値:true)
072     *          displayMsg  = "MSG0040";                処?果を表示しま?初期値:??登録しました。」)
073     *          selectedAll = "[false/true]"            ??タを?件選択済みとして処??true)かど???初期値:false)
074     *          keepTimeStamp = "[false/true]"          COPY,親違いMOVE(,MODIFY)の時にオリジナルのタイ?タンプを使用するかど?(初期値:false)
075     *      />
076     *
077     *    [action属?(??)]
078     *      COPY   オリジナルファイルを?ターゲ?にコピ?します?
079     *      MOVE   オリジナルファイルを?ターゲ?に移?COPY+DELETE)/名称変更(RENAME)します?
080     *      MODIFY (MOVE と同じ。エンジンの command を利用するための簡易action)
081     *      DELETE オリジナルファイルを?削除します?(フォル??ファイルに関わら?
082     *
083     * ●Tag定義??
084     *   <og:fileUpdate
085     *       action           ○?TAG】アクション(SAVE,LOAD,DELETE)をセ?します?(??)
086     *       command            【TAG】コマン?ENTRY)をセ?しま?
087     *       targetDir          【TAG】ターゲ?となるフォル??しま?
088     *       createDir          【TAG】ターゲ?となるフォル?なければ、作?するかど?を指定しま?初期値:true)
089     *       tableId            【TAG?通常は使?せん)結果のDBTableModelを?sessionに登録するとき?キーを指定しま?
090     *       outMessage         【TAG】検索結果のメ?ージを表示する/しない[true/false]を指定しま?初期値:true)
091     *       displayMsg         【TAG】??果を画面上に表示するメ?ージリソースIDを指定しま?初期値:MSG0040[?登録しました])
092     *       selectedAll        【TAG】データを?件選択済みとして処?るかど?[true/false]を指定しま?初期値:false)
093     *       keepTimeStamp      【TAG】オリジナルのタイ?タンプを利用するかど?を指定しま?初期値:false)
094     *       scope              【TAG】キャ?ュする場合?スコープ[request/page/session/applicaton]を指定しま?初期値:session)
095     *       debug              【TAG】デバッグ??を?力するかど?[true/false]を指定しま?初期値:false)
096     *   />
097     *
098     * ●使用?
099     *       ・<og:fileUpdate command="{@command}" action="COPY" />
100     *             TO_PARENT また??TO_NAME(両方?も可)による行単?COPY 処?
101     *             fileQuery の useUpdateClm="true" を設定し、検索結果に、TO_PARENT?TO_NAMEカラ?追?ます?
102     *             TO_PARENT また??TO_NAME は、columnSet などで値をセ?しておきます?
103     *
104     *       ・<og:fileUpdate command="{@command}" action="MODIFY" targetDir="AAA_DIR"  />
105     *             fileQuery の検索結果を?AAA_DIR フォル?移動します?
106     *             ファイル名?、そのままオリジナルの値が使用されます?
107     *
108     * @og.rev 5.3.4.0 (2011/04/01) 新規追?
109     * @og.group ファイル出?
110     *
111     * @version  4.0
112     * @author       Kazuhiko Hasegawa
113     * @since    JDK5.0,
114     */
115    public class FileUpdateTag extends CommonTagSupport {
116            //* こ?プログラ??VERSION??を設定します?       {@value} */
117            private static final String VERSION = "5.6.5.2 (2013/06/21)" ;
118    
119            private static final long serialVersionUID = 565220130621L ;
120    
121            /** command 引数に渡す事?出来?コマン? 登録{@value} */
122            public static final String CMD_ENTRY  = "ENTRY" ;
123            /** command 引数に渡す事?出来?コマン?リス? */
124            private static  final String COMMAND_LIST = CMD_ENTRY;
125    
126            /** エラーメ?ージID {@value} */
127            private static final String errMsgId     = HybsSystem.ERR_MSG_KEY;
128    
129            /** action 引数に渡す事?出来?アクションコマン? COPY {@value} */
130            public static final String ACT_COPY             = "COPY" ;
131            /** action 引数に渡す事?出来?アクションコマン? MOVE {@value} */
132            public static final String ACT_MOVE             = "MOVE" ;
133            /** action 引数に渡す事?出来?アクションコマン? MODIFY {@value} */
134            public static final String ACT_MODIFY           = "MODIFY" ;
135            /** action 引数に渡す事?出来?アクションコマン? DELETE {@value} */
136            public static final String ACT_DELETE   = "DELETE" ;
137    
138            private static final String[] ACTION_LIST = new String[] { ACT_COPY , ACT_MOVE , ACT_MODIFY , ACT_DELETE };
139    
140            private String  action          = null;
141            private String  targetDir       = null;         // ターゲ?となるフォル?
142            private boolean createDir       = true;         // ターゲ?となるフォル?なければ、作?するかど?(true:作?する)
143    
144            private String  tableId         = HybsSystem.TBL_MDL_KEY;
145            private String  command         = CMD_ENTRY;
146            private boolean outMessage      = true;
147            private String  displayMsg      = "MSG0040";    // ?登録しました?
148            private boolean selectedAll = false;
149            private boolean keepTimeStamp = false;          // オリジナルのタイ?タンプを利用する場合?true
150    
151            private transient DBTableModel  table           = null;
152            private transient ErrorMessage  errMessage      = null;
153            private int             executeCount    = -1;                   // 処?数
154            private int             errCode                 = ErrorMessage.OK;
155            private long    dyStart                 = 0;
156    
157            /**
158             * Taglibの終?グが見つかったときに処??doEndTag() ?オーバ?ライドします?
159             *
160             * @return      後続????
161             */
162            @Override
163            public int doEndTag() {
164                    debugPrint();
165                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属?対?
166                    if( !useTag() ) { return(EVAL_PAGE); }
167    
168                    dyStart = System.currentTimeMillis();
169    
170                    table = (DBTableModel)getObject( tableId );
171    
172                    String label  = "";                             // 4.0.0 (2005/11/30) 検索しなかった?合?
173                    if( table != null && table.getRowCount() > 0 && check( command, COMMAND_LIST ) ) {
174                            startQueryTransaction( tableId );
175    
176                            execute();      // 実際の処?実行します?
177    
178                            StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_SMALL );
179    
180                            setRequestAttribute( "DB.COUNT"   , String.valueOf( executeCount ) );
181                            setRequestAttribute( "DB.ERR_CODE", String.valueOf( errCode ) );
182    
183                            String err = TaglibUtil.makeHTMLErrorTable( errMessage,getResource() );
184                            if( err != null && err.length() > 0 ) {
185                                    buf.append( err );
186                                    setSessionAttribute( errMsgId,errMessage );
187                            }
188                            label = buf.toString();
189    
190                            if( table != null && ! commitTableObject( tableId, table ) ) {
191                                    jspPrint( "FileUpdateTag Query処?割り込まれました?BTableModel は登録しません? );
192                                    return (SKIP_PAGE);
193                            }
194                    }
195    
196                    jspPrint( label );
197    
198                    // 実行件数の表示
199                    // 4.0.0 (2005/11/30) 出力?の変更。???に出力します?
200                    if( displayMsg != null && displayMsg.length() > 0 ) {
201                            String status = executeCount + getResource().getLabel( displayMsg ) ;
202                            jspPrint( status + HybsSystem.BR );
203                    }
204    
205                    // 3.5.4.7 (2004/02/06)
206                    long dyTime = System.currentTimeMillis()-dyStart;
207                    jspPrint( "<div id=\"queryTime\" value=\"" + (dyTime) + "\"></div>" );      // 3.5.6.3 (2004/07/12)
208    
209                    return( EVAL_PAGE );
210            }
211    
212            /**
213             * タグリブオブジェクトをリリースします?
214             * キャ?ュされて再利用される?で、フィールド?初期設定を行います?
215             *
216             */
217            @Override
218            protected void release2() {
219                    super.release2();
220                    tableId         = HybsSystem.TBL_MDL_KEY;
221                    command         = CMD_ENTRY;
222                    action          = null;
223                    targetDir       = null;         // ターゲ?となるフォル?
224                    createDir       = true;         // ターゲ?となるフォル?なければ、作?するかど?(true:作?する)
225                    outMessage      = true;
226                    displayMsg      = "MSG0040";    // ?登録しました?
227                    selectedAll = false;
228                    keepTimeStamp = false;          // オリジナルのタイ?タンプを利用する場合?true
229                    table           = null;
230                    errMessage      = null;
231                    executeCount= -1;               // 処?数
232                    errCode         = ErrorMessage.OK;
233                    dyStart         = 0;            // 処??
234            }
235    
236            /**
237             * 処?実行します?
238             *
239             */
240            private void execute() {
241                    int[] rowNo = getParameterRows();
242                    if( rowNo.length > 0 ) {
243    
244                            FromToFiles fromToFiles = new FromToFiles( table , targetDir , createDir );
245    
246                            if( ACT_COPY.equalsIgnoreCase( action ) ) {
247                                    actionCOPY( rowNo,fromToFiles );
248                            }
249                            // ACT_MODIFY は、エンジンの command で使?め?便利
250                            else if( ACT_MOVE.equalsIgnoreCase( action ) || ACT_MODIFY.equalsIgnoreCase( action ) ) {
251                                    actionMOVE( rowNo,fromToFiles );
252                            }
253                            else if( ACT_DELETE.equalsIgnoreCase( action ) ) {
254                                    actionDELETE( rowNo,fromToFiles );
255                            }
256                    }
257            }
258    
259            /**
260             * COPY アクションを実行します?
261             *
262             * @og.rev 5.6.5.2 (2013/06/21) From側がファイルの場合?み処?ます?
263             *
264             * @param       rowNo           処?実施する行番号
265             * @param       fromToFiles     FromFile,ToFile をまとめた補助クラス
266             * @throws      HybsSystemException     処?に何らか?エラーが発生した??
267             */
268            private void actionCOPY( final int[] rowNo , final FromToFiles fromToFiles ) {
269                    File fromFile = null ;
270                    File toFile   = null ;
271    
272                    executeCount = 0 ;      // 開始前に初期化しておく?
273                    int rowCount = rowNo.length ;
274                    for( int i=0; i<rowCount; i++ ) {
275                            File[] files = fromToFiles.makeFromToFile( rowNo[i] );  // FromFile,ToFile
276                            fromFile = files[0];
277                            toFile   = files[1];
278    
279                            // 5.6.5.2 (2013/06/21) From側がファイルの場合?み処?ます?
280    //                      if( !FileUtil.copy( fromFile,toFile,keepTimeStamp ) ) {
281                            if( fromFile.isFile() && !FileUtil.copy( fromFile,toFile,keepTimeStamp ) ) {
282                                    String errMsg = "アクション=[" + action + "]中にエラーが発生しました? + HybsSystem.CR
283                                                                            + "From=[" + fromFile + "],To=[" + toFile + "]" + HybsSystem.CR;
284                                    throw new HybsSystemException( errMsg );
285                            }
286                            executeCount++ ;
287                    }
288            }
289    
290            /**
291             * MOVE アクションを実行します?
292             *
293             * @og.rev 5.5.2.4 (2012/05/16) メソ?の戻り?の設?
294             * @og.rev 5.6.5.2 (2013/06/21) From側がファイルの場合?み処?ます?
295             *
296             * @param       rowNo           処?実施する行番号
297             * @param       fromToFiles     FromFile,ToFile をまとめた補助クラス
298             * @throws      HybsSystemException     処?に何らか?エラーが発生した??
299             */
300            private void actionMOVE( final int[] rowNo , final FromToFiles fromToFiles ) {
301                    File fromFile = null ;
302                    File toFile   = null ;
303    
304                    executeCount = 0 ;      // 開始前に初期化しておく?
305                    int rowCount = rowNo.length ;
306                    for( int i=0; i<rowCount; i++ ) {
307                            File[] files = fromToFiles.makeFromToFile( rowNo[i] );  // FromFile,ToFile
308                            fromFile = files[0];
309                            toFile   = files[1];
310    
311                            if( fromToFiles.lastParentEquals() ) {  // FromDirとToDirが同じなので、RENAMEできる?
312                                    if( !fromFile.renameTo( toFile ) ) {
313                                            String errMsg = "アクション=[" + action + "]中にエラーが発生しました? + HybsSystem.CR
314                                                                                    + "同?フォル??ため、RENAME処?行って?す?" + HybsSystem.CR
315                                                                                    + "From=[" + fromFile + "],To=[" + toFile + "]" + HybsSystem.CR;
316                                            throw new HybsSystemException( errMsg );
317                                    }
318                            }
319                            // 5.6.5.2 (2013/06/21) From側がファイルの場合?み処?ます?
320    //                      else {                  // FromDirとToDirが異なる?で、COPY ??DELETE する?
321                            else if( fromFile.isFile() ) {                  // FromDirとToDirが異なる?で、COPY ??DELETE する?
322                                    if( !FileUtil.copy( fromFile,toFile,keepTimeStamp ) ) {
323                                            String errMsg = "アクション=[" + action + "]中にエラーが発生しました? + HybsSystem.CR
324                                                                                    + "移動前のCOPY処?行って?した? + HybsSystem.CR
325                                                                                    + "From=[" + fromFile + "],To=[" + toFile + "]" + HybsSystem.CR;
326                                            throw new HybsSystemException( errMsg );
327                                    }
328    
329                                    if( !fromFile.delete() ) {
330    //                                      toFile.delete();        // 移動?際? COPY は正常なので、まず?、そのファイルを削除しておく?
331                                            String errMsg = "アクション=[" + action + "]中にエラーが発生しました? + HybsSystem.CR
332                                                                                    + "移動後?オリジナルファイルの削除処?行って?した? + HybsSystem.CR
333                                                                                    + "From=[" + fromFile + "],To=[" + toFile + "]" + HybsSystem.CR;
334                                            // 5.5.2.4 (2012/05/16) メソ?の戻り?の設?
335                                            if(! toFile.delete() ) {
336                                                    errMsg = errMsg + "toFile も削除に失敗しました? + HybsSystem.CR;
337                                            }
338    
339                                            throw new HybsSystemException( errMsg );
340                                    }
341                            }
342                            executeCount++ ;
343                    }
344            }
345    
346            /**
347             * DELETE アクションを実行します?
348             *
349             * こ?処?は、リストにフォル?含まれて?場合も削除します?
350             * 通常、フォル??削除は、その要??部?にファイル等が存在しな??合?み
351             * 行いますが、検索リストから削除する?によっては、フォル?ファイル?
352             * 削除対象になる?合があります?そこで、まず?ファイル?削除し?フォル???
353             * あとで削除するように処?行います?
354             *
355             * @og.rev 5.6.5.2 (2013/06/21) フォル?削除対象にします?
356             *
357             * @param       rowNo           処?実施する行番号
358             * @param       fromToFiles     FromFile,ToFile をまとめた補助クラス
359             * @throws      HybsSystemException     処?に何らか?エラーが発生した??
360             */
361            private void actionDELETE( final int[] rowNo , final FromToFiles fromToFiles ) {
362                    File fromFile = null;
363    
364                    // 5.6.5.2 (2013/06/21) フォル?削除する為の??避
365                    Set<File> dirSet = new TreeSet<File>( new FileNameLengthComparator() );             // ファイルの?数?並べたSet
366    
367                    executeCount = 0 ;      // 開始前に初期化しておく?
368                    int rowCount = rowNo.length ;
369                    for( int i=0; i<rowCount; i++ ) {
370                            fromFile = fromToFiles.makeFromOnly( rowNo[i] );        // FromFile
371    
372                            // 5.6.5.2 (2013/06/21) まず?ファイルを削除します?
373    //                      if( !fromFile.delete() ) {
374                            if( fromFile.isFile() ) {
375                                    if( !fromFile.delete() ) {
376                                            String errMsg = "アクション=[" + action + "]中にエラーが発生しました? + HybsSystem.CR
377                                                                                    + "From=[" + fromFile + "]" + HybsSystem.CR;
378                                            throw new HybsSystemException( errMsg );
379                                    }
380                            }
381                            else {
382                                    // 5.6.5.2 (2013/06/21) フォル??場合?、アドレスの桁数をキーにソートしておきます?
383                                    int len = fromFile.getAbsolutePath().length();
384                                    dirSet.add( fromFile );
385                            }
386                            executeCount++ ;
387                    }
388    
389                    // 5.6.5.2 (2013/06/21) フォル??削除は、アドレスの桁数の大きい?階層の深???に削除します?
390                    for( File file : dirSet ) {
391                            if( !file.delete() ) {
392                                    String errMsg = "アクション=[" + action + "]中にエラーが発生しました? + HybsSystem.CR
393                                                                            + "From(Dir)=[" + file + "]" + HybsSystem.CR;
394                                    throw new HybsSystemException( errMsg );
395                            }
396                    }
397            }
398    
399            /**
400             * ファイルの名称の長さ??長???に比?る?Comparator インターフェースの実?ラス
401             *
402             * ここでの大小比??、ファイル名??数が?大きい方が?小さ?みなされます?
403             * つまり階層が深??で、?に処?る?があると?事を意味します?
404             * 処?しては、f1 != null && f2 != null で、len1 = f1.getAbsolutePath().length() と len2 = f2.getAbsolutePath().length() を比?
405             * len1 > len2 ??, len1 < len2 ?正 , len1 == len2 ?0 を返します?
406             * 具体的には、return ( len2 - len1 ); です?
407             * 
408             * 注: こ?コンパレータは equals と?性のな??序付けを課します?
409             * 
410             * @og.rev 5.6.5.2 (2013/06/21) 新規追?
411             * 
412             */
413            private static final class FileNameLengthComparator implements Comparator<File> , Serializable {
414                    private static final long serialVersionUID = 5652 ;             // 5.6.5.2 (2013/06/21)
415                    /**
416                     * ?付けのために 2 つの引数を比?ます?
417                     *
418                     * ここでの大小比??、ファイル名??数が?大きい方が?小さ?みなされます?
419                     * 具体的には、return ( len2 - len1 ); です?
420                     * 
421                     * @param       比?象の??のオブジェク?
422                     * @param       比?象の 2 番目のオブジェク?
423                     * @return      ??の引数?2 番目の引数より小さ??合???整数、両方が等し??合? 0、最初?引数?2 番目の引数より大きい場合?正の整数
424                     */
425                    public int compare( final File f1 , final File f2 ) {
426                            if( f1 == null || f2 == null ) {
427                                    String errMsg = "引数のFileにnullが含まれて?す?file1=[" + f1 + "] , file2=[" + f2 + "]" ;
428                                    throw new IllegalArgumentException( errMsg );
429                            }
430    
431                            int len1 = f1.getAbsolutePath().length();
432                            int len2 = f2.getAbsolutePath().length();
433    
434                            return ( len2 - len1 );
435                    }
436            }
437    
438            /**
439             * 表示??タの HybsSystem.ROW_SEL_KEY を?に?ばれた 行を処??対象とします?
440             *
441             * @return      選択行?配?
442             */
443            @Override
444            protected int[] getParameterRows() {
445                    final int[] rowNo ;
446                    if( selectedAll ) {
447                            int rowCnt = table.getRowCount();
448                            rowNo = new int[ rowCnt ];
449                            for( int i=0; i<rowCnt; i++ ) {
450                                    rowNo[i] = i;
451                            }
452                    } else {
453                            rowNo = super.getParameterRows();
454                    }
455                    return rowNo ;
456            }
457    
458            /**
459             * 【TAG】アクション(SAVE,LOAD,DELETE)をセ?します?
460             *
461             * @og.tag
462             * アクションは,HTMLから(get/post)?されます?で,ACT_xxx で設定される
463             * フィールド定数値の?れかを??できます?
464             * 無??場合?、なにもしません?
465             *
466             * <table border="1" frame="box" rules="all" >
467             * <th><td>action   </td><td>名称</td><td>機?</td></th>
468             * <tr><td>SAVE             </td><td>登録</td><td>?? keys のキーに vals の値をセ?します?</td></tr>
469             * <tr><td>LOAD             </td><td>取?/td><td>?? keys のク?ー?リクエスト中に)取得します?</td></tr>
470             * <tr><td>DELETE   </td><td>削除</td><td>?? keys のク?ーを削除します?</td></tr>
471             * </table>
472             *
473             * @param       act アクション(public static final 宣?れて???)
474             * @see         <a href="{&#064;docRoot}/constant-values.html#org.opengion.hayabusa.taglib.CookieTag.ACT_DELETE">アクション定数</a>
475             */
476            public void setAction( final String act ) {
477                    action = nval( getRequestParameter( act ),action );
478    
479                    if( action != null && !check( action, ACTION_LIST ) ) {
480                            String errMsg = "??アクションは実行できません。アクションエラー" + HybsSystem.CR
481                                                            + "action=[" + action + "] "                                            + HybsSystem.CR
482                                                            + StringUtil.array2csv( ACTION_LIST ) ;
483                            throw new HybsSystemException( errMsg );
484                    }
485            }
486    
487            /**
488             * 【TAG】ターゲ?となるフォル??します?
489             *
490             * @og.tag
491             * targetDir 属?を利用する場合?、引数のファイル、また?フォル??されたことに
492             * なります?COPY、MOVE(,MODIFY) の場合?、targetDir 属?にフォル??することで?処?能です?
493             * ??のフォル?存在しな??合?、createDir属?の値により処?異なります?
494             * createDir="true"(初期値)で、ターゲ?フォル?存在しな??合?、?動作?します?
495             *
496             * @param  dir ターゲ?となるフォル?
497             * @see         #setCreateDir( String )
498             */
499            public void setTargetDir( final String dir ) {
500                    targetDir = nval( getRequestParameter( dir ),targetDir );
501            }
502    
503            /**
504             * 【TAG】ターゲ?となるフォル?なければ、作?するかど?を指定しま?初期値:true)?
505             *
506             * @og.tag
507             * COPY,MOVE(,MODIFY) などの処?、ターゲ?フォル?存在しな?きに、作?するか?エラーにするかを
508             * createDir属? で?できます?
509             * これは、COPY先やMOVE(,MODIFY)先が存在して?前提のシス?で、不要な?に間違ってフォル?
510             * 自動作?されると困る?合に、false:作?しな?とすれば?違いに気づく確?上がります?
511             * 初期値は true:作?する です?
512             *
513             * @param  flag ターゲ?となるフォル?自動作?する(true)か?しな?false) 初期値は、true:作?する
514             */
515            public void setCreateDir( final String flag ) {
516                    createDir = nval( getRequestParameter( flag ),createDir );
517            }
518    
519            /**
520             * 【TAG?通常は使?せん)結果のDBTableModelを?sessionに登録するとき?キーを指定します?
521             *
522             * @og.tag
523             * 検索結果より、DBTableModelオブジェクトを作?します?これを?以下?view 等?タグに
524             * 渡す?合に??常は、session を利用します?そ?場合?登録キーです?
525             * query タグを同時に実行して、結果を求める?合?同?モリに配置される為?
526             * こ? tableId 属?を利用して、メモリ空間を?ます?
527             * 初期値は、HybsSystem.TBL_MDL_KEY です?
528             *
529             * @param       id sessionに登録する時? ID
530             */
531            public void setTableId( final String id ) {
532                    tableId = nval( getRequestParameter( id ),tableId );
533            }
534    
535            /**
536             * 【TAG】コマン?ENTRY)をセ?します?
537             *
538             * @og.tag
539             * こ?タグは、command="ENTRY" でのみ実行されます?
540             * コマンド?,HTMLから(get/post)?されます?で,CMD_xxx で設定される
541             * フィールド定数値の?れかを??できます?
542             * 初期値は、ENTRY なので、何も?しなければ、実行されます?
543             *
544             * @param       cmd コマン?public static final 宣?れて???)
545             * @see         <a href="{&#064;docRoot}/constant-values.html#org.opengion.hayabusa.taglib.FileUpdateTag.CMD_ENTRY">コマンド定数</a>
546             */
547            public void setCommand( final String cmd ) {
548                    String cmd2 = getRequestParameter( cmd );
549                    if( cmd2 != null && cmd2.length() >= 0 ) { command = cmd2.toUpperCase(Locale.JAPAN); }
550            }
551    
552            /**
553             * 【TAG】検索結果のメ?ージを表示する/しない[true/false]を指定しま?初期値:true)?
554             *
555             * @og.tag
556             * 初期値は、表示する?true です?
557             *
558             * @param       flag  [true:表示する/それ以?含めない]
559             */
560            public void setOutMessage( final String flag ) {
561                    outMessage = nval( getRequestParameter( flag ),outMessage );
562            }
563    
564            /**
565             * 【TAG】??果を画面上に表示するメ?ージリソースIDを指定しま?初期値:MSG0040[?登録しました])?
566             *
567             * @og.tag
568             * ここでは、検索結果の件数?録された件数をまず?力し?
569             * そ?次に、ここで?したメ?ージをリソースから取得して表示します?
570             * 表示させたくな??合?, displayMsg = "" をセ?してください?
571             * displayMsg の初期値は、MSG0040[?登録しました]です?
572             *
573             * @param       id ?スプレイに表示させるメ?ージ ID
574             */
575            public void setDisplayMsg( final String id ) {
576                    String ids = getRequestParameter( id );
577                    if( ids != null ) { displayMsg = ids; }
578            }
579    
580            /**
581             * 【TAG】データを?件選択済みとして処?るかど?[true/false]を指定しま?初期値:false)?
582             *
583             * @og.tag
584             * 全ての??タを選択済み??タとして扱って処?ます?
585             * 全件処?る?合に?true/false)を指定します?
586             * 初期値は false です?
587             *
588             * @param  all ??タを?件選択済み [true:全件選択済み/false:通常]
589             */
590            public void setSelectedAll( final String all ) {
591                    selectedAll = nval( getRequestParameter( all ),selectedAll );
592            }
593    
594            /**
595             * 【TAG】オリジナルのタイ?タンプを利用するかど?を指定しま?初期値:false)?
596             *
597             * @og.tag
598             * COPY?違いMOVE(,MODIFY)の時に、オリジナルのタイ?タンプをそ?ままコピ?先?ファイルに?
599             * 適用するかど?を指定します?
600             * タイ?タンプを初期化されたくな??合に、true に設定します?
601             * 初期値は 利用しな?false です?
602             *
603             * @param  flag タイ?タンプを利用するかど?初期値:利用しな??
604             */
605            public void setKeepTimeStamp( final String flag ) {
606                    keepTimeStamp = nval( getRequestParameter( flag ),keepTimeStamp );
607            }
608    
609            /**
610             * DBTableModel から、FromFile,ToFile を作?するための処?まとめた補助クラスです?
611             *
612             * ここでは、オリジナルファイル?ーゲ?ファイルを作?するための処??みを集めて?す?
613             * メソ?にすると、ローカル変数を多く管?るか、多数の引数渡しを繰り返すことになるため?
614             * こ?ローカルクラスに処?、?を?納します?
615             *
616             */
617            private static final class FromToFiles {
618    //              private static final String[] CLMS_LIST   = new String[] { "PARENT","NAME","TO_PARENT","TO_NAME" };
619    
620                    private final DBTableModel      table ;
621    
622                    private final int PARENT        ;
623                    private final int NAME          ;
624                    private final int TO_PARENT     ;
625                    private final int TO_NAME       ;
626    
627                    private final File    toDir     ;
628                    private final boolean createDir;        // ターゲ?となるフォル?なければ、作?するかど?(true:作?する)
629    
630                    private boolean equalParent = false;    // ?に実行された処?、親フォル?同??場合?、true
631    
632                    /**
633                     *  引数??コンストラクター
634                     *
635                     * ?なパラメータを渡して、オブジェクトを構築します?
636                     *
637                     * @param       table     DBTableModel  ?が?納されて?DBTableModel
638                     * @param       targetDir       ターゲ?となるフォル?
639                     * @param       createDir       ターゲ?となるフォル?なければ、作?するかど?(true:作?する)
640                     */
641                    public FromToFiles( final DBTableModel table , final String targetDir , final boolean createDir ) {
642                            this.table              = table;
643                            this.createDir  = createDir ;
644                            toDir = mkDirs( targetDir,createDir );  // targetDir が指定されて???合?、null
645    
646                            // "PARENT","NAME","TO_PARENT","TO_NAME" のカラ?のDBTableModelのカラ?号。存在しな??合??1
647                            PARENT          = table.getColumnNo( "PARENT"   , false );
648                            NAME            = table.getColumnNo( "NAME"             , false );
649                            TO_PARENT       = table.getColumnNo( "TO_PARENT", false );
650                            TO_NAME         = table.getColumnNo( "TO_NAME"  , false );
651                    }
652    
653                    /**
654                     * 行番号より、対応するオリジナルファイル(FromFile)を返します?
655                     *
656                     * ここでは、TO_PARENT ?TO_NAME は、判定する?がな?め?makeFromToFile( int ) の
657                     * ?のみで処?終?きます?
658                     * ?.FromDir は、PARENT 列?値から作?する?
659                     * ?.FromFileは、FromDir ??NAME列?値から作?する?
660                     *
661                     * 配?返しの関係で、メソ?(および?処?を?けて?す?
662                     *
663                     * @param       rowNo   カラ?o
664                     * @return      File オリジナルファイル(FromFile)
665                     * @see         #makeFromToFile( int )
666                     */
667                    public File makeFromOnly( final int rowNo ) {
668                            String[] value = table.getValues( rowNo );
669                            File fromDir  = mkDirs( value[PARENT],createDir );
670    
671                            return new File( fromDir, value[NAME] ) ;
672                    }
673    
674                    /**
675                     * 行番号より、対応するオリジナルファイル(FromFile)とターゲ?ファイル(ToFile)を?列に格納して返します?
676                     *
677                     * ここでは、TO_PARENT ?TO_NAME は、存在するかど?不?なので、以下?手?で作?します?
678                     * ?.FromDir は、PARENT 列?値から作?する?
679                     * ?.FromFileは、FromDir ??NAME列?値から作?する?
680                     * ?.toDir は?
681                     *       ??targetDir が有れ?、それを使??
682                     *       ??なければ、TO_PARENT 列?値から作?する?
683                     *       ??TO_PARENT 列がな?、?が未設定?場合?、FromDir をそのまま使??
684                     * ?.toFile は?
685                     *       ??toDir ??TO_NAME 列?値から作?する?
686                     *       ??TO_NAME 列がな?、?が未設定?場合?、toDir ??NAME列?値から作?する?
687                     * 返り値は、new File[] { formFile , toFile }; とする?
688                     *
689                     * @param       rowNo   カラ?o
690                     * @return      File[] ファイル配?(0:オリジナルファイル 1:ターゲ?ファイル)
691                     */
692                    public File[] makeFromToFile( final int rowNo ) {
693    
694                            String[] value = table.getValues( rowNo );
695                            File fromDir  = mkDirs( value[PARENT],createDir );
696                            File formFile = new File( fromDir, value[NAME] );
697                            File tempToDir = toDir;
698    
699                            equalParent = false;    // ?に実行された処?、親フォル?同?ど?のフラグをリセ?する?
700                            if( tempToDir == null ) {
701                                    if( TO_PARENT >= 0 && nval(value[TO_PARENT],null) != null ) {
702                                            tempToDir = mkDirs( value[TO_PARENT],createDir );
703                                    }
704                                    else  {
705                                            tempToDir = fromDir;
706                                            equalParent = true;             // ?に実行された処?、親フォル?同??場合?、true
707                                    }
708                            }
709    
710                            File toFile = null;
711                            if( TO_NAME >= 0 && nval(value[TO_NAME],null) != null  ) {
712                                    toFile = new File( tempToDir, value[TO_NAME] );
713                            }
714                            else {
715                                    toFile = new File( tempToDir, value[NAME] );
716                            }
717    
718                            return new File[] { formFile , toFile };
719                    }
720    
721                    /**
722                     * ?に実行された処?、親フォル?同?ど?を返しま?同??場合?、true)?
723                     *
724                     * makeFromToFile( int ) が??れたとき?、FromDir と toDir が同?あれば、true を?
725                     * 異なる?合?、false を返します?
726                     * ここでの結果は、厳?同?定ではなく?処?に、同?ど?を判定して?す?
727                     * つまり?toDir に FromDir をセ?する(?.Cのケース)場合に、true を?部変数にセ?します?
728                     * こ?判定?は、ファイルの移動??、異なる親フォル??場合?、COPY ??DELETE しなければ
729                     * なりませんが?同?フォル??場合?、RENAME で済? と?処??の軽減が目?す?
730                     * よって、結果?、PARENT と TO_PARENT が同じとか?PARENT と targetDir が同じで?
731                     * ここでのフラグは、false が返されます?
732                     *
733                     * @return      ?に実行された処?、親フォル?同??場合?、true
734                     * @see         #makeFromToFile( int )
735                     */
736                    public boolean lastParentEquals() {
737                            return equalParent ;
738                    }
739    
740                    /**
741                     *  カラ?配?(String[])より、対応するカラ?o配?(int[])を作?します?
742                     *
743                     * ここでは、TO_PARENT ?TO_NAME は、存在するかど?不?なので?
744                     * EXCEPTION にせず??列番号に?1 を返すようにして?す?
745                     *
746                     * @param       table     DBTableModel  ?が?納されて?DBTableModel
747                     * @param       nameArray       カラ?配?
748                     * @return      カラ?o配?(カラ?が存在しな??合??1)
749                     */
750            //      private int[] getTableColumnNo( final DBTableModel table ,final String[] nameArray ) {
751            //              int[] clmNo = new int[ nameArray.length ];
752            //              for( int i=0; i<clmNo.length; i++ ) {
753            //                      clmNo[i] = table.getColumnNo( nameArray[i] , false );   // カラ?が存在しな??合??1 を返す?
754            //              }
755            //              return clmNo;
756            //      }
757    
758                    /**
759                     * フォル?作?します?
760                     *
761                     * フォル?存在しな??合???中階層をすべて作?します?
762                     *
763                     * @param       fname   フォル?
764                     * @param       createDir       ターゲ?となるフォル?なければ、作?するかど?(true:作?する)
765                     * @return File フォル?表すファイルオブジェクト?引数?null の場合?、null を返します?
766                     * @throws      HybsSystemException             ファイルか?存在しな??合に、createDir=false か?mkdirs() ?false の場?
767                     */
768                    private File mkDirs( final String fname , final boolean createDir ) {
769                            File target = null;
770                            if( fname != null ) {
771                                    target = new File( fname );
772                                    if( target.exists() ) {                 // 存在する
773                                            if( target.isFile() ) {
774                                                    String errMsg = "ターゲ?に、ファイル名??できません? + HybsSystem.CR
775                                                                                            + "ターゲ?=[" + fname + "]"  + HybsSystem.CR;
776                                                    throw new HybsSystemException( errMsg );
777                                            }
778                                    }
779                                    else {                                                  // 存在しな?
780                                            // 存在しな??に、作?しな?
781                                            if( !createDir ) {
782                                                    String errMsg = "ターゲ?が存在しません?" + HybsSystem.CR
783                                                                                            + "ターゲ?=[" + fname + "]"  + HybsSystem.CR;
784                                                    throw new HybsSystemException( errMsg );
785                                            }
786                                            // 作?できな?
787                                            if( !target.mkdirs() ) {
788                                                    String errMsg = "ターゲ?を?動作?使用としましたが?作?できませんでした? + HybsSystem.CR
789                                                                                            + "ターゲ?=[" + fname + "]"  + HybsSystem.CR;
790                                                    throw new HybsSystemException( errMsg );
791                                            }
792                                    }
793                            }
794                            return target;
795                    }
796            }
797    
798            /**
799             * シリアライズ用のカスタ?リアライズ書き込みメソ?
800             *
801             * @og.rev 4.0.0.0 (2006/09/31) 新規追?
802             * @serialData
803             *
804             * @param       strm    ObjectOutputStreamオブジェク?
805             */
806            private void writeObject( final ObjectOutputStream strm ) throws IOException {
807                    strm.defaultWriteObject();
808            }
809    
810            /**
811             * シリアライズ用のカスタ?リアライズ読み込みメソ?
812             *
813             * ここでは、transient 宣?れた?変数の??初期化が?なフィールド?み設定します?
814             *
815             * @og.rev 4.0.0.0 (2006/09/31) 新規追?
816             * @serialData
817             *
818             * @param       strm    ObjectInputStreamオブジェク?
819             * @see #release2()
820             */
821            private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
822                    strm.defaultReadObject();
823            }
824    
825            /**
826             * こ?オブジェクト???表現を返します?
827             * 基本???目?使用します?
828             *
829             * @return こ?クラスの??表現
830             */
831            @Override
832            public String toString() {
833                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
834                                    .println( "VERSION"                     ,VERSION                )
835                                    .println( "action"                      ,action                 )
836                                    .println( "command"                     ,command                )
837                                    .println( "targetDir"           ,targetDir              )
838                                    .println( "createDir"           ,createDir              )
839                                    .println( "tableId"                     ,tableId                )
840                                    .println( "outMessage"          ,outMessage     )
841                                    .println( "displayMsg"          ,displayMsg     )
842                                    .println( "selectedAll"         ,selectedAll    )
843                                    .println( "keepTimeStamp"       ,keepTimeStamp  )
844                                    .fixForm().toString() ;
845            }
846    }