    001/*
    002 * Copyright (c) 2009 The openGion Project.
    003 *
    004 * Licensed under the Apache License, Version 2.0 (the "License");
    005 * you may not use this file except in compliance with the License.
    006 * You may obtain a copy of the License at
    007 *
    008 *     http://www.apache.org/licenses/LICENSE-2.0
    009 *
    010 * Unless required by applicable law or agreed to in writing, software
    011 * distributed under the License is distributed on an "AS IS" BASIS,
    012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
    013 * either express or implied. See the License for the specific language
    014 * governing permissions and limitations under the License.
    015 */
    016package org.opengion.fukurou.util;
    017
    018import org.opengion.fukurou.system.OgRuntimeException ;                 // 6.4.2.0 (2016/01/29)
    019import java.io.BufferedInputStream;
    020import java.io.BufferedOutputStream;
    021import java.io.BufferedReader;
    022import java.io.BufferedWriter;
    023import java.io.File;
    024import java.io.FileFilter;                                                                              // 7.0.1.4 (2018/11/26)
    025import java.io.InputStream;
    026import java.io.FileInputStream;
    027import java.io.InputStreamReader;                                                               // 5.10.9.0 (2019/03/01)
    028import java.io.FileNotFoundException;
    029import java.io.FileOutputStream;
    030import java.io.IOException;
    031import java.io.OutputStream;
    032import java.io.OutputStreamWriter;
    033import java.io.PrintWriter;
    034import java.io.UnsupportedEncodingException;
    035import java.io.Writer;
    036import java.util.Collections;
    037import java.util.List;
    038
    039import java.nio.channels.FileChannel;
    040import java.nio.file.Files;                                                                             // 6.2.0.0 (2015/02/27)
    041import java.nio.charset.Charset;                                                                // 6.2.0.0 (2015/02/27)
    042import java.nio.file.StandardCopyOption;                                                // 5.10.9.0 (2019/03/01)
    043
    044import org.opengion.fukurou.system.HybsConst;                                   // 6.4.5.2 (2016/05/06)
    045import static org.opengion.fukurou.system.HybsConst.CR;                 // 6.1.0.0 (2014/12/26) refactoring
    046import org.opengion.fukurou.system.Closer;                                              // 6.4.2.0 (2016/01/29) package変更 fukurou.util → fukurou.system
    047import org.opengion.fukurou.system.LogWriter;                                   // 6.4.2.0 (2016/01/29) package変更 fukurou.util → fukurou.system
    048import org.opengion.fukurou.system.ThrowUtil;                                   // 6.4.2.0 (2016/01/29) package変更 fukurou.util → fukurou.system
    049import org.opengion.fukurou.model.FileOperation;                                // 5.10.9.0 (2019/03/01)
    050import org.opengion.fukurou.model.FileOperationFactory;                 // 5.10.9.0 (2019/03/01)
    051
    052/**
    053 * FileUtil.java は、共通的に使用される File関連メソッドを集約した、クラスです。
    054 *
    055 * 全変数は、public static final 宣言されており、全メソッドは、public static synchronized 宣言されています。
    056 *
    057 * @og.rev 5.9.10.0 (2019/03/01) クラウドストレージ対応を追加
    058 *
    059 * @og.group ユーティリティ
    060 *
    061 * @version  4.0
    062 * @author       Kazuhiko Hasegawa
    063 * @since    JDK5.0,
    064 */
    065public final class FileUtil {
    066        private static final NonClosePrintWriter OUT_WRITER = new NonClosePrintWriter( System.out );            // 6.4.1.1 (2016/01/16) outWriter → OUT_WRITER refactoring
    067        private static final NonClosePrintWriter ERR_WRITER = new NonClosePrintWriter( System.err );            // 6.4.1.1 (2016/01/16) errWriter → ERR_WRITER refactoring
    068
    069        /** 5.6.1.2 (2013/02/22) UNIX系のファイル名を表すセパレータ文字  */
    070
    071        /** 5.6.1.2 (2013/02/22) Windwos系のファイル名を表すセパレータ文字       */
    072
    073        /** 5.6.1.2 (2013/02/22) ファイルの拡張子の区切りを表す文字      */
    074        public static final char EXTENSION_SEPARATOR = '.';
    075
    076        private static final byte B_CR = (byte)0x0d ;   // '\r'
    077        private static final byte B_LF = (byte)0x0a ;   // '\n'
    078        private static final int  BUFSIZE = 8192 ;              // 5.1.6.0 (2010/05/01)
    079
    080        /**
    081         * すべてが staticメソッドなので、コンストラクタを呼び出さなくしておきます。
    082         *
    083         */
    084        private FileUtil() {}
    085
    086        /**
    087         * Fileオブジェクトとエンコードより PrintWriterオブジェクトを作成します。
    088         *
    089         * @param       file    出力するファイルオブジェクト
    090         * @param       encode  ファイルのエンコード
    091         *
    092         * @return      PrintWriterオブジェクト
    093         * @throws RuntimeException 何らかのエラーが発生した場合
    094         * @og.rtnNotNull
    095         */
    096        public static PrintWriter getPrintWriter( final File file,final String encode ) {
    097                return getPrintWriter( file,encode,false );
    098        }
    099
    100        /**
    101         * Fileオブジェクトとエンコードより PrintWriterオブジェクトを作成します。
    102         *
    103         * @param       file    出力するファイルオブジェクト
    104         * @param       encode  ファイルのエンコード
    105         * @param       append  ファイルを追加モード(true)にするかどうか
    106         *
    107         * @return      PrintWriterオブジェクト
    108         * @throws RuntimeException 何らかのエラーが発生した場合
    109         * @og.rtnNotNull
    110         */
    111        public static PrintWriter getPrintWriter( final File file,final String encode,final boolean append ) {
    112                final PrintWriter writer ;
    113
    114                try {
    115                        writer = new PrintWriter(new BufferedWriter(new OutputStreamWriter(
    116                                                        new FileOutputStream(file,append) ,encode )));
    117                }
    118                catch( final UnsupportedEncodingException ex ) {
    119                        final String errMsg = "指定されたエンコーディングがサポートされていません。" + CR
    120                                                        + ex.getMessage() + CR
    121                                                        + "File=[" + file + " , encode=[" + encode + "]" ;
    122                        throw new OgRuntimeException( errMsg,ex );
    123                }
    124                catch( final FileNotFoundException ex ) {               // 3.6.1.0 (2005/01/05)
    125                        final String errMsg = "ファイル名がオープン出来ませんでした。" + CR
    126                                                        + ex.getMessage() + CR
    127                                                        + "File=[" + file + " , encode=[" + encode + "]" ;
    128                        throw new OgRuntimeException( errMsg,ex );
    129                }
    130
    131                return writer ;
    132        }
    133
    134        /**
    135         * ファイル名より、PrintWriterオブジェクトを作成する簡易メソッドです。
    136         *
    137         * これは、ファイル名は、フルパスで、追加モードで、UTF-8 エンコードの
    138         * ログファイルを出力する場合に使用します。
    139         * また、ファイル名に、"System.out" と、"System.err" を指定できます。
    140         * その場合は、標準出力、または、標準エラー出力に出力されます。
    141         * "System.out" と、"System.err" を指定した場合は、NonClosePrintWriter
    142         * オブジェクトが返されます。これは、close() 処理が呼ばれても、何もしない
    143         * クラスです。また、常に内部キャッシュの同じオブジェクトが返されます。
    144         *
    145         * @param       file    出力するファイル名
    146         *
    147         * @return      PrintWriterオブジェクト
    148         * @throws RuntimeException 何らかのエラーが発生した場合
    149         * @throws IllegalArgumentException ファイル名が null の場合
    150         */
    151        public static PrintWriter getLogWriter( final String file ) {
    152                if( file == null ) {
    153                        final String errMsg = "ファイル名に、null は指定できません。";
    154                        throw new IllegalArgumentException( errMsg );
    155                }
    156
    157                final PrintWriter writer ;
    158                if( "System.out".equalsIgnoreCase( file ) ) {
    159                        writer = OUT_WRITER ;
    160                }
    161                else if( "System.err".equalsIgnoreCase( file ) ) {
    162                        writer = ERR_WRITER ;
    163                }
    164                else {
    165                        writer = getPrintWriter( new File( file ),"UTF-8",true );
    166                }
    167
    168                return writer ;
    169        }
    170
    171        /**
    172         * OutputStreamとエンコードより PrintWriterオブジェクトを作成します。
    173         *
    174         * @og.rev 5.5.2.0 (2012/05/01) 新規追加
    175         *
    176         * @param       os              利用するOutputStream
    177         * @param       encode  ファイルのエンコード
    178         *
    179         * @return      PrintWriterオブジェクト
    180         * @throws RuntimeException 何らかのエラーが発生した場合
    181         */
    182        public static PrintWriter getPrintWriter( final OutputStream os,final String encode ) {
    183                final PrintWriter writer ;
    184
    185                try {
    186                        writer = new PrintWriter(new BufferedWriter(new OutputStreamWriter( os ,encode )));
    187                }
    188                catch( final UnsupportedEncodingException ex ) {
    189                        final String errMsg = "指定されたエンコーディングがサポートされていません。" + CR
    190                                                        + ex.getMessage() + CR
    191                                                        + "encode=[" + encode + "]" ;
    192                        throw new OgRuntimeException( errMsg,ex );
    193                }
    194                return writer ;
    195        }
    196
    197        /**
    198         * PrintWriter を継承した、JspWriterなどの Writer 用のクラスを定義します。
    199         *
    200         * 例えば、JspWriterなどの JSP/Servlet等のフレームワークで使用される
    201         * Writer では、flush や close 処理は、フレームワーク内で行われます。
    202         * その場合、通常のファイルと同じ用に、flush や close をアプリケーション側で
    203         * 行うと、内部処理的に不整合が発生したり、最悪の場合エラーになります。
    204         * このクラスは、NonFlushPrintWriter クラスのオブジェクトを返します。
    205         * これは、通常の、new PrintWriter( Writer ) で、求めるのと、ほとんど同様の
    206         * 処理を行いますが、close() と flush() メソッドが呼ばれても、何もしません。
    207         *
    208         * @param       writer  出力するWriteオブジェクト(NonFlushPrintWriterクラス)
    209         *
    210         * @return      PrintWriterオブジェクト
    211         * @og.rtnNotNull
    212         */
    213        public static PrintWriter getNonFlushPrintWriter( final Writer writer ) {
    214                return new NonFlushPrintWriter( writer );
    215        }
    216
    217        /**
    218         * Fileオブジェクトとエンコードより BufferedReaderオブジェクトを作成します。
    219         *
    220         * これは、java 1.7 以降でしか使えませんが、FilesとPaths を使用した BufferedReader
    221         * オブジェクトを返します。
    222         * encode は、java.nio.charset.Charset になる為、従来のコードと異なるかも知れませんが、
    223         * 日本語関係の判定をより正確に行う事が可能になります。(Windows-31J と UTF-8の判別など)
    224         *
    225         * @og.rev 6.2.0.0 (2015/02/27) java.nio.file.Files と、Paths を使用するように変更
    226         * @og.rev 5.10.9.0 (2019/3/1) FileOperationの処理を追加(クラウドストレージ対応)
    227         *
    228         * @param       file    入力するファイルオブジェクト
    229         * @param       encode  ファイルのエンコード(java.nio.charset.Charset)
    230         *
    231         * @return      BufferedReaderオブジェクト
    232         * @throws RuntimeException 何らかのエラーが発生した場合
    233         * @og.rtnNotNull
    234         */
    235        public static BufferedReader getBufferedReader( final File file,final String encode ) {
    236                final BufferedReader reader ;
    237
    238                try {
    239                        if( file instanceof FileOperation ) {
    240                                final FileOperation fileOperation = (FileOperation)file;
    241                                reader = new BufferedReader(new InputStreamReader(fileOperation.read(), encode));
    242                        }else {
    243                                reader = Files.newBufferedReader( file.toPath() , Charset.forName( encode ) );
    244                        }
    245
    246//                      reader = Files.newBufferedReader( file.toPath() , Charset.forName( encode ) );
    247                }
    248                catch( final IOException ex ) {
    249                        final String errMsg = "ファイルのオープン中に入出力エラーが発生しました。" + CR
    250                                                        + ex.getMessage() + CR
    251                                                        + "File=[" + file + "] , encode=[" + encode + "]" ;
    252                        throw new OgRuntimeException( errMsg,ex );
    253                }
    254                catch( final RuntimeException ex ) {
    255                        final String errMsg = "指定された文字セットが不正か、現在のJava仮想マシンでは利用できません。" + CR
    256                                                        + ex.getMessage() + CR
    257                                                        + "File=[" + file + "] , encode=[" + encode + "]" ;
    258                        throw new OgRuntimeException( errMsg,ex );
    259                }
    260
    261                return reader ;
    262        }
    263
    264        /**
    265         * 指定のファイル名が、実際に存在しているかどうかをチェックします。
    266         * 存在しない場合は、２秒毎に、３回確認します。
    267         * それでも存在しない場合は、エラーを返します。
    268         * return されるFileオブジェクトは、正規の形式(CanonicalFile)です。
    269         *
    270         * @param       dir                     フォルダ名
    271         * @param       filename        ファイル名
    272         *
    273         * @return      存在チェック(なければ null/あれば、CanonicalFile)
    274         */
    275        public static File checkFile( final String dir, final String filename ) {
    276                return checkFile( dir,filename,3 );
    277        }
    278
    279        /**
    280         * 指定のファイル名が、実際に存在しているかどうかをチェックします。
    281         * 存在しない場合は、２秒毎に、指定の回数分確認します。
    282         * それでも存在しない場合は、エラーを返します。
    283         * return されるFileオブジェクトは、正規の形式(CanonicalFile)です。
    284         *
    285         * @param       dir                     フォルダ名
    286         * @param       filename        ファイル名
    287         * @param       count           回数指定
    288         *
    289         * @return      存在チェック(なければ null/あれば、CanonicalFile)
    290         */
    291        public static File checkFile( final String dir, final String filename,final int count ) {
    292                File file = null;
    293
    294                int cnt = count;
    295                while( cnt > 0 ) {
    296                        file = new File( dir,filename );
    297                        if( file.exists() ) { break; }
    298                        else {
    299                                if( cnt == 1 ) { return null; }         // 残り１回の場合は、２秒待機せずに即抜ける。
    300                                try { Thread.sleep( 2000 );     }       // ２秒待機
    301                                catch( final InterruptedException ex ) {
    302                                        System.out.println( "InterruptedException" );
    303                                }
    304                                System.out.println();
    305                                System.out.print( "CHECK File Error! CNT=" + cnt );
    306                                System.out.print( " File=" + file.getAbsolutePath() );
    307                        }
    308                        cnt--;
    309                }
    310
    311                // ファイルの正式パス名の取得
    312                try {
    313                        return file.getCanonicalFile() ;
    314                }
    315                catch( final IOException ex ) {
    316                        final String errMsg = "ファイルの正式パス名が取得できません。[" + file.getAbsolutePath() + "]";
    317                        throw new OgRuntimeException( errMsg,ex );
    318                }
    319        }
    320
    321        /**
    322         * ファイルのバイナリコピーを行います。
    323         *
    324         * copy( File,File,false ) を呼び出します。
    325         *
    326         * @og.rev 5.1.6.0 (2010/05/01) 戻り値に、true/false 指定します。
    327         *
    328         * @param       fromFile        コピー元ファイル名
    329         * @param       toFile          コピー先ファイル名
    330         *
    331         * @return      バイナリコピーが正常に終了したかどうか[true:成功/false:失敗]
    332         * @see         #copy( File,File,boolean )
    333         */
    334        public static boolean copy( final String fromFile,final String toFile ) {
    335                return copy( new File( fromFile ), new File( toFile ), false );
    336        }
    337
    338        /**
    339         * ファイルのバイナリコピーを行います。
    340         *
    341         * copy( File,File,boolean ) を呼び出します。
    342         * 第３引数の、keepTimeStamp=true で、コピー元のファイルのタイムスタンプを、
    343         * コピー先にもセットします。
    344         *
    345         * @og.rev 5.1.6.0 (2010/05/01) 戻り値に、true/false 指定します。
    346         *
    347         * @param       fromFile        コピー元ファイル名
    348         * @param       toFile          コピー先ファイル名
    349         * @param       keepTimeStamp   タイムスタンプ維持[true/false]
    350         *
    351         * @return      バイナリコピーが正常に終了したかどうか[true:成功/false:失敗]
    352         * @see         #copy( File,File,boolean )
    353         */
    354        public static boolean copy( final String fromFile,final String toFile,final boolean keepTimeStamp ) {
    355                return copy( new File( fromFile ), new File( toFile ), keepTimeStamp );
    356        }
    357
    358        /**
    359         * ファイルのバイナリコピーを行います。
    360         *
    361         * copy( File,File,false ) を呼び出します。
    362         *
    363         * @og.rev 5.1.6.0 (2010/05/01) 戻り値に、true/false 指定します。
    364         *
    365         * @param       fromFile        コピー元ファイル
    366         * @param       toFile          コピー先ファイル
    367         *
    368         * @return      バイナリコピーが正常に終了したかどうか[true:成功/false:失敗]
    369         * @see         #copy( File,File,boolean )
    370         */
    371        public static boolean copy( final File fromFile,final File toFile ) {
    372                return copy( fromFile, toFile, false );
    373        }
    374
    375        /**
    376         * ファイルのバイナリコピーを行います。
    377         *
    378         * 第３引数の、keepTimeStamp=true で、コピー元のファイルのタイムスタンプを、
    379         * コピー先にもセットします。
    380         * toFile が、ディレクトリの場合は、fromFile のファイル名をそのままコピーします。
    381         * fromFile がディレクトリの場合は、copyDirectry( File,Fileboolean )を call します。
    382         *
    383         * @og.rev 5.1.6.0 (2010/05/01) 新規追加
    384         * @og.rev 5.6.5.2 (2013/06/21) ByteBufferを利用した方式から、transferTo を使用する方式に変更
    385         * @og.rev 5.7.1.2 (2013/12/20) copy先(toFile)のフォルダが存在しなければ、作成します。
    386         * @og.rev 6.3.6.1 (2015/08/28) copy元(fromFile)がフォルダがディレクトリの場合は、#copyDirectry( File,File,boolean ) を呼ぶ。
    387         * @og.rev 6.3.6.1 (2015/08/28) Exception発生時に return ではなく、StringUtil.ogErrMsg に変更。
    388         * @og.rev 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    389         * @og.rev 6.4.2.0 (2016/01/29) StringUtil#ogErrMsgPrint(String,Throwable) を、ThrowUtilt#ogThrowMsg(String,Throwable) に変更。
    390         * @og.rev 5.10.9.0 (2019/3/1) FileがFileOperationを生成している場合、指定の処理を行います。(クラウドストレージ対応)
    391         * @og.rev 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    392         * @og.rev 8.4.1.2 (2023/03/03) toFile ではなく、tempToFile を使う必要がある。
    393         *
    394         * @param       fromFile        コピー元ファイル
    395         * @param       toFile          コピー先ファイル
    396         * @param       keepTimeStamp タイムスタンプ維持[true/false]
    397         *
    398         * @return      バイナリコピーが正常に終了したかどうか[true:成功/false:失敗]
    399         * @see         #copyDirectry( File,File,boolean )
    400         */
    401        public static boolean copy( final File fromFile,final File toFile,final boolean keepTimeStamp ) {
    402                FileInputStream         inFile  = null;
    403                FileOutputStream        outFile = null;
    404                FileChannel                     fin             = null;
    405                FileChannel                     fout    = null;
    406                InputStream                     is              = null;         // 5.10.9.0 (2019/3/1) ADD
    407
    408                File tempToFile = toFile ;
    409                try {
    410                        // fromFileが、ディレクトリの場合は、copyDirectryで処理する。
    411                        if( fromFile.isDirectory() ) {
    412                                // 6.3.6.1 (2015/08/28)
    413                                return copyDirectry( fromFile,toFile,keepTimeStamp );
    414                        }
    415                        // toFileが、ディレクトリの場合は、そのパスでファイル名をfromFileから取り出す。
    416                        if( toFile.isDirectory() ) {
    417//                              tempToFile = new File( toFile,fromFile.getName() );
    418                                // 5.10.9.0 (2019/3/1) MODIFY FileOperationの場合は、FileOperationFactoryを利用します。
    419                                if( toFile instanceof FileOperation ) {
    420                                        // 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    421//                                      tempToFile = FileOperationFactory.newStorageOperation( toFile, toFile.getAbsolutePath(), fromFile.getName() );
    422                                        tempToFile = FileOperationFactory.resolveFile( toFile, toFile.getAbsolutePath(), fromFile.getName() );
    423                                }else {
    424                                        tempToFile = new File( toFile,fromFile.getName() );
    425                                }
    426                        }
    427
    428                        // 5.7.1.2 (2013/12/20) copy先(toFile)のフォルダが存在しなければ、作成します。
    429                        final File parent = tempToFile.getParentFile();
    430                        if( !parent.exists() && !parent.mkdirs() ) {
    431                                // ディレクトリを作成する
    432                                System.err.println( parent + " の ディレクトリ作成に失敗しました。" );
    433                                return false;
    434                        }
    435
    436                        // 5.10.9.0 (2019/3/1) MODIFY toFile,fromFileがFileOperationの場合は、FileOperation用のコピー処理を行います。
    437                        if(toFile instanceof FileOperation) {
    438                                if(fromFile instanceof FileOperation) {
    439                                        // 両方がFileOperationの場合
    440                                        is = ((FileOperation)fromFile).read();
    441                                }else {
    442                                        // toFileのみがFileOperationの場合
    443                                        is = new FileInputStream(fromFile);
    444                                }
    445//                              ((FileOperation) toFile).write(is);
    446                                ((FileOperation) tempToFile).write(is);         // 8.4.1.2 (2023/03/03) toFile ではなく、tempToFile を使う必要がある。
    447                        }else if(fromFile instanceof FileOperation) {
    448                                // fromFileのみがFileOperationの場合
    449                                is = ((FileOperation)fromFile).read();
    450//                              Files.copy(is, toFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
    451                                Files.copy(is, tempToFile.toPath(), StandardCopyOption.REPLACE_EXISTING);       // 8.4.1.2 (2023/03/03) toFile ではなく、tempToFile を使う必要がある。
    452                        }else {
    453                                inFile  = new FileInputStream( fromFile );
    454                                outFile = new FileOutputStream( tempToFile );
    455
    456                                fin  = inFile.getChannel();
    457                                fout = outFile.getChannel();
    458
    459                                // 5.6.5.2 (2013/06/21) ByteBufferを利用した方式から、transferTo を使用する方式に変更
    460                                fin.transferTo(0, fin.size(), fout );
    461                        }
    462                }
    463                catch( final IOException ex ) {
    464                        // 6.3.6.1 (2015/08/28) Exception発生時に return ではなく、StringUtil.ogErrMsg に変更。
    465                        final String errMsg = "バイナリコピーで、エラーが発生しました。" + CR
    466                                                        + "fromFile=[" + fromFile + "]" + CR
    467                                                        + "toFile  =[" + toFile   + "]" + CR ;
    468                        // 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    469                        System.out.println( ThrowUtil.ogThrowMsg( errMsg , ex ) );                      // 6.4.2.0 (2016/01/29)
    470                        return false;
    471                }
    472                finally {
    473                        Closer.ioClose( inFile  ) ;
    474                        Closer.ioClose( outFile );
    475                        Closer.ioClose( fin  ) ;
    476                        Closer.ioClose( fout );
    477                        Closer.ioClose( is );           // 5.10.9.0 (2019/3/1)
    478                }
    479
    480                if( keepTimeStamp ) {
    481                        return tempToFile.setLastModified( fromFile.lastModified() );
    482                }
    483
    484                return true;
    485        }
    486
    487        /**
    488         * ファイルのバイナリコピーを行います。
    489         *
    490         * このファイルコピーは、バイナリファイルの 改行コードを
    491         * CR+LF に統一します。また、UTF-8 の BOM(0xef,0xbb,0xbf) があれば、
    492         * 取り除きます。
    493         *
    494         * @og.rev 5.1.6.0 (2010/05/01) 新規追加
    495         * @og.rev 6.3.6.1 (2015/08/28) Exception発生時に return ではなく、StringUtil.ogErrMsg に変更。
    496         * @og.rev 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    497         * @og.rev 6.4.2.0 (2016/01/29) StringUtil#ogErrMsgPrint(String,Throwable) を、ThrowUtilt#ogThrowMsg(String,Throwable) に変更。
    498         *
    499         * @param       fromFile        コピー元ファイル
    500         * @param       toFile          コピー先ファイル
    501         *
    502         * @return      バイナリコピーが正常に終了したかどうか[true:成功/false:失敗]
    503         */
    504        public static boolean changeCrLfcopy( final File fromFile,final File toFile ) {
    505                BufferedInputStream     fromStream = null;
    506                BufferedOutputStream    toStream   = null;
    507                File tempToFile = toFile ;
    508                try {
    509                        // ディレクトリの場合は、そのパスでファイル名をfromFileから取り出す。
    510                        if( toFile.isDirectory() ) {
    511                                tempToFile = new File( toFile,fromFile.getName() );
    512                        }
    513                        fromStream = new BufferedInputStream( new FileInputStream( fromFile ) );
    514                        toStream   = new BufferedOutputStream( new FileOutputStream( tempToFile ) );
    515
    516                        final byte[] buf = new byte[BUFSIZE];
    517                        int len ;
    518                        // 4.2.3.0 (2008/05/26) changeCrLf 属性対応
    519
    520                        boolean bomCheck = true;        // 最初の一回だけ、ＢＯＭチェックを行う。
    521                        byte    bt = (byte)0x00;        // バッファの最後と最初の比較時に使用
    522                        while( (len = fromStream.read(buf,0,BUFSIZE)) != -1 ) {
    523                                int st = 0;
    524                                if( bomCheck && len >= 3 &&
    525                                        buf[0] == (byte)0xef &&
    526                                        buf[1] == (byte)0xbb &&
    527                                        buf[2] == (byte)0xbf  ) {
    528                                                st = 3;
    529                                }
    530                                else {
    531                                        // バッファの最後が CR で、先頭が LF の場合、LF をパスします。
    532                                        if( bt == B_CR && buf[0] == B_LF ) {
    533                                                st = 1 ;
    534                                        }
    535                                }
    536                                bomCheck = false;
    537
    538                                for( int i=st;i<len;i++ ) {
    539                                        bt = buf[i] ;
    540                                        if( bt == B_CR || bt == B_LF ) {
    541                                                toStream.write( (int)B_CR );            // CR
    542                                                toStream.write( (int)B_LF );            // LF
    543                                                // CR+LF の場合
    544                                                if( bt == B_CR && i+1 < len && buf[i+1] == B_LF ) {
    545                                                        i++;
    546                                                        bt = buf[i] ;
    547                                                }
    548                                        }
    549                                        else {
    550                                                toStream.write( (int)bt );
    551                                        }
    552                                }
    553                        }
    554                        // 最後が改行コードでなければ、改行コードを追加します。
    555                        // テキストコピーとの互換性のため
    556                        if( bt != B_CR && bt != B_LF ) {
    557                                toStream.write( (int)B_CR );            // CR
    558                                toStream.write( (int)B_LF );            // LF
    559                        }
    560                }
    561                catch( final IOException ex ) {
    562                        // 6.3.6.1 (2015/08/28) Exception発生時に return ではなく、StringUtil.ogErrMsg に変更。
    563                        final String errMsg = "バイナリコピー(CrLf)で、エラーが発生しました。" + CR
    564                                                        + "fromFile=[" + fromFile + "]" + CR
    565                                                        + "toFile  =[" + toFile   + "]" + CR ;
    566                        // 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    567                        System.out.println( ThrowUtil.ogThrowMsg( errMsg , ex ) );                      // 6.4.2.0 (2016/01/29)
    568                        return false;
    569                }
    570                finally {
    571                        Closer.ioClose( fromStream ) ;
    572                        Closer.ioClose( toStream ) ;
    573                }
    574
    575                return true;
    576        }
    577
    578        /**
    579         * ファイルのバイナリコピーを行います。
    580         *
    581         * コピー元のファイルは、InputStream で指定します。
    582         * 元は、jsp/common 以下を圧縮、jar化したため、物理ファイルの取得が
    583         * できなくなったため、ServletContext#getServletContext() で、ローカルリソースを
    584         * 取得するのが目的です。汎用的に、入力は、InputStream にしました。
    585         * URLConnection 等で、取得する場合は、BASIC認証も考慮する必要がありますので、
    586         * ご注意ください。
    587         * タイムスタンプのコピーは行いません。
    588         *
    589         * @og.rev 6.3.6.1 (2015/08/28) InputStreamで指定されたファイルのコピー
    590         * @og.rev 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    591         * @og.rev 6.4.2.0 (2016/01/29) StringUtil#ogErrMsgPrint(String,Throwable) を、ThrowUtilt#ogThrowMsg(String,Throwable) に変更。
    592         *
    593         * @param       inStrm          コピー元のInputStream(この中でcloseします)
    594         * @param       toFile          コピー先ファイル
    595         *
    596         * @return      バイナリコピーが正常に終了したかどうか[true:成功/false:失敗]
    597         * @see         #copy( File,File )
    598         */
    599        public static boolean copy( final InputStream inStrm,final File toFile ) {
    600                FileOutputStream foStrm = null;
    601                try {
    602                        // copy先(toFile)のフォルダが存在しなければ、作成します。
    603                        final File parent = toFile.getParentFile();
    604                        if( !parent.exists() && !parent.mkdirs() ) {
    605                                // ディレクトリを作成する
    606                                System.err.println( parent + " の ディレクトリ作成に失敗しました。" );
    607                                return false;
    608                        }
    609
    610                        foStrm = new FileOutputStream( toFile, false );
    611                        return copy( inStrm , foStrm );
    612                }
    613                catch( final IOException ex ) {
    614                        // 6.3.6.1 (2015/08/28) Exception発生時に return ではなく、StringUtil.ogErrMsg に変更。
    615                        final String errMsg = "入力ストリームのコピーでエラーが発生しました。" + CR
    616                                                        + "toFile  =[" + toFile   + "]" + CR ;
    617                        // 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    618                        System.out.println( ThrowUtil.ogThrowMsg( errMsg , ex ) );                      // 6.4.2.0 (2016/01/29)
    619                }
    620                finally {
    621                        Closer.ioClose( inStrm );
    622                        Closer.ioClose( foStrm );
    623                }
    624
    625                return false ;
    626        }
    627
    628        /**
    629         * 入出力ストリーム間でデータの転送を行います。
    630         *
    631         * ここでは、すでに作成されたストリームに基づき、データの入出力を行います。
    632         * よって、先にフォルダ作成や、存在チェック、ファイルの削除などの必要な処理は
    633         * 済まして置いてください。
    634         * また、このメソッド内で、ストリームのクロース処理は行っていません。
    635         *
    636         * @og.rev 5.1.6.0 (2010/05/01) 新規追加
    637         * @og.rev 6.3.6.1 (2015/08/28) エラー時のメッセージ情報を増やします。
    638         * @og.rev 6.3.8.5 (2015/10/16) StringUtil#ogErrMsgPrint 使用。
    639         * @og.rev 6.4.2.0 (2016/01/29) StringUtil#ogErrMsgPrint(String,Throwable) を、ThrowUtilt#ogThrowMsg(String,Throwable) に変更。
    640         *
    641         * @param       input   入力ストリーム
    642         * @param       output  出力ストリーム
    643         *
    644         * @return      データ転送が正常に終了したかどうか[true:成功/false:失敗]
    645         */
    646        public static boolean copy( final InputStream input,final OutputStream output ) {
    647                if( input == null ) {
    648                        final String errMsg = "入力ストリームが 作成されていません。" ;
    649                        // 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    650                        System.out.println( ThrowUtil.ogThrowMsg( errMsg ) );                   // 6.4.2.0 (2016/01/29)
    651                        return false;
    652                }
    653
    654                if( output == null ) {
    655                        final String errMsg = "出力ストリームが 作成されていません。" ;
    656                        // 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    657                        System.out.println( ThrowUtil.ogThrowMsg( errMsg ) );                   // 6.4.2.0 (2016/01/29)
    658                        return false;
    659                }
    660
    661                try {
    662                        final byte[] buf = new byte[BUFSIZE];
    663                        int len;
    664                        while((len = input.read(buf)) != -1) {
    665                                output.write(buf, 0, len);
    666                        }
    667                }
    668                catch( final IOException ex ) {
    669                        final String errMsg = "ストリームデータの入出力処理に失敗しました。";
    670                        // 6.3.8.5 (2015/10/16) StringUtil.ogErrMsgPrint 使用。
    671                        System.out.println( ThrowUtil.ogThrowMsg( errMsg,ex ) );                        // 6.4.2.0 (2016/01/29)
    672                        return false;
    673                }
    674        //      finally {
    675        //              Closer.ioClose( input );
    676        //              Closer.ioClose( output );
    677        //      }
    678                return true ;
    679        }
    680
    681        /**
    682         * 再帰処理でディレクトリのコピーを行います。
    683         *
    684         * 指定されたコピー元ディレクトリがディレクトリでなかったり存在しないときは falseを返します。
    685         *
    686         * @og.rev 4.3.0.0 (2008/07/24) 追加
    687         * @og.rev 5.1.6.0 (2010/05/01) 戻り値に、true/false 指定します。
    688         *
    689         * @param       fromDir コピー元ディレクトリ名
    690         * @param       toDir   コピー先ディレクトリ名
    691         *
    692         * @return      ディレクトリのコピーが正常に終了したかどうか[true:成功/false:失敗]
    693         */
    694        public static boolean copyDirectry( final String fromDir, final String toDir ) {
    695                return copyDirectry( new File( fromDir ), new File( toDir ),false );
    696        }
    697
    698        /**
    699         * 再帰処理でディレクトリをコピーします。
    700         *
    701         * 指定されたコピー元ディレクトリがディレクトリでなかったり存在しないときは falseを返します。
    702         *
    703         * @og.rev 4.3.0.0 (2008/07/24) 追加
    704         * @og.rev 5.1.6.0 (2010/05/01) 内部処理を若干変更します。
    705         *
    706         * @param       fromDir   コピー元ディレクトリ
    707         * @param       toDir     コピー先ディレクトリ
    708         *
    709         * @return      ディレクトリのコピーが正常に終了したかどうか[true:成功/false:失敗]
    710         */
    711        public static boolean copyDirectry( final File fromDir, final File toDir ) {
    712                return copyDirectry( fromDir, toDir, false );
    713        }
    714
    715        /**
    716         * 再帰処理でディレクトリをコピーします。
    717         *
    718         * 指定されたコピー元ディレクトリがディレクトリでなかったり存在しないときは falseを返します。
    719         *
    720         * @og.rev 4.3.0.0 (2008/07/24) 追加
    721         * @og.rev 5.1.6.0 (2010/05/01) 内部処理を若干変更します。
    722         * @og.rev 5.3.7.0 (2011/07/01) フォルダにアクセスできない場合は、エラーを返します。
    723         *
    724         * @param       fromDir コピー元ディレクトリ
    725         * @param       toDir   コピー先ディレクトリ
    726         * @param       keepTimeStamp タイムスタンプ維持[true/false]
    727         *
    728         * @return      ディレクトリのコピーが正常に終了したかどうか[true:成功/false:失敗]
    729         */
    730        public static boolean copyDirectry( final File fromDir, final File toDir, final boolean keepTimeStamp ) {
    731                // コピー元がディレクトリでない場合はfalseを返す
    732                // 4.3.4.4 (2009/01/01)
    733                if( !fromDir.exists() || !fromDir.isDirectory() ) {
    734                        System.err.println( fromDir + " が ディレクトリでないか、存在しません。" );
    735                        return false;
    736                }
    737
    738                // 4.3.4.4 (2009/01/01) ディレクトリを作成する
    739                // 6.0.0.1 (2014/04/25) These nested if statements could be combined
    740                if( !toDir.exists() && !toDir.mkdirs() ) {
    741                        System.err.println( toDir + " の ディレクトリ作成に失敗しました。" );
    742                        return false;
    743                }
    744
    745                // ディレクトリ内のファイルをすべて取得する
    746                final File[] files = fromDir.listFiles();
    747
    748                // 5.3.7.0 (2011/07/01) フォルダにアクセスできない場合は、エラー
    749                if( files == null ) {
    750                        System.err.println( fromDir + " はアクセスできません。" );
    751                        return false;
    752                }
    753
    754                // ディレクトリ内のファイルに対しコピー処理を行う
    755                boolean flag = true;
    756                for( int i=0; files.length>i; i++ ){
    757                        if( files[i].isDirectory() ){ // ディレクトリだった場合は再帰呼び出しを行う
    758                                flag = copyDirectry( files[i], new File( toDir, files[i].getName()),keepTimeStamp );
    759                        }
    760                        else{ // ファイルだった場合はファイルコピー処理を行う
    761                                flag = copy( files[i], new File( toDir, files[i].getName()),keepTimeStamp );
    762                        }
    763                        if( !flag ) { return false; }
    764                }
    765                return true;
    766        }
    767
    768        /**
    769         * 指定されたファイル及びディレクトを削除します。
    770         * ディレクトリの場合はサブフォルダ及びファイルも削除します。
    771         * １つでもファイルの削除に失敗した場合、その時点で処理を中断しfalseを返します。
    772         *
    773         * @og.rev 5.3.7.0 (2011/07/01) フォルダにアクセスできない場合は、エラーを返します。
    774         *
    775         * @param       file 削除ファイル/ディレクトリ
    776         *
    777         * @return      ファイル/ディレクトリの削除に終了したかどうか[true:成功/false:失敗]
    778         */
    779        public static boolean deleteFiles( final File file ) {
    780                if( file.exists() ) {
    781                        if( file.isDirectory() ) {
    782                                final File[] list = file.listFiles();
    783
    784                                // 5.3.7.0 (2011/07/01) フォルダにアクセスできない場合は、エラー
    785                                if( list == null ) {
    786                                        System.err.println( file + " はアクセスできません。" );
    787                                        return false;
    788                                }
    789
    790                                for( int i=0; i<list.length; i++ ) {
    791                                        deleteFiles( list[i] );
    792                                }
    793                        }
    794                        if( !file.delete() ) { return false; }
    795                }
    796                return true;
    797        }
    798
    799        /**
    800         * 指定されたディレクトリを基点としたファイル名(パスを含む)の一覧を返します。
    801         * 互換性のため、コピー中ファイルも含みます。
    802         *
    803         * @og.rev 5.4.3.2 (2012/01/06) コピー中対応のため引数４つを作成する
    804         *
    805         * @param dir 基点となるディレクトリ
    806         * @param sort ファイル名でソートするか
    807         * @param list ファイル名一覧を格納するList
    808         */
    809        public static void getFileList( final File dir, final boolean sort, final List<String> list ) {
    810//              getFileList( dir, sort, list, true );
    811                getFileList( dir, null, sort, list, true );                     // 7.0.1.4 (2018/11/26) FileFilter を利用
    812        }
    813
    814        /**
    815         * 指定されたディレクトリを基点としたファイル名(パスを含む)の一覧を返します。
    816         *
    817         * @og.rev 4.3.6.6 (2009/05/15) 新規作成
    818         * @og.rev 5.4.3.2 (2012/01/06) 引数isCopy追加
    819         * @og.rev 6.3.9.0 (2015/11/06) null になっている可能性があるメソッドの戻り値のnullチェックを追加。
    820         *
    821         * @param dir 基点となるディレクトリ
    822         * @param sort ファイル名でソートするか
    823         * @param list ファイル名一覧を格納するList
    824         * @param isCopy コピー中ファイルを除外するか [true:含む/false:除外]
    825         */
    826        public static void getFileList( final File dir, final boolean sort, final List<String> list, final boolean isCopy ) {
    827                getFileList( dir, null, sort, list, true );                     // 7.0.1.4 (2018/11/26) FileFilter を利用
    828
    829//              if( list == null ) { return; }
    830//              if( dir.isFile() ) {
    831//                      // コピー中判定はrenameで行う
    832//                      // 6.1.0.0 (2014/12/26) refactoring : Avoid if(x != y) ..; else ..;
    833//                      if( isCopy || dir.renameTo( dir ) ) {
    834//                              list.add( dir.getAbsolutePath() );
    835//                      }
    836//                      else{
    837//                              return;
    838//                      }
    839//              }
    840//              else if( dir.isDirectory() ) {
    841//                      final File[] files = dir.listFiles();
    842//                      // 6.3.9.0 (2015/11/06) null になっている可能性があるメソッドの戻り値のnullチェックを追加。
    843//                      if( files != null ) {
    844//                              for( int i=0; i<files.length; i++ ) {
    845//                                      getFileList( files[i], sort, list, isCopy );
    846//                              }
    847//                      }
    848//              }
    849//              if( sort ) {
    850//                      Collections.sort( list );
    851//              }
    852        }
    853
    854        /**
    855         * 指定されたディレクトリを基点としたファイル名(パスを含む)の一覧を返します。
    856         *
    857         * @og.rev 4.3.6.6 (2009/05/15) 新規作成
    858         * @og.rev 5.4.3.2 (2012/01/06) 引数isCopy追加
    859         * @og.rev 6.3.9.0 (2015/11/06) null になっている可能性があるメソッドの戻り値のnullチェックを追加。
    860         * @og.rev 7.0.1.4 (2018/11/26) FileFilter を利用して、フォルダの絞り込みを行う。
    861         *
    862         * @param dir 基点となるディレクトリ
    863         * @param filter ディレクトリやファイルを絞り込むフィルター(nullの場合は、すべてOK)
    864         * @param sort ファイル名でソートするか
    865         * @param list ファイル名一覧を格納するList
    866         * @param isCopy コピー中ファイルを除外するか [true:含む/false:除外]
    867         */
    868        public static void getFileList( final File dir, final FileFilter filter, final boolean sort, final List<String> list, final boolean isCopy ) {
    869                if( list == null ) { return; }
    870                if( dir.isFile() ) {
    871                        // コピー中判定はrenameで行う
    872                        // 6.1.0.0 (2014/12/26) refactoring : Avoid if(x != y) ..; else ..;
    873                        if( isCopy || dir.renameTo( dir ) ) {
    874                                list.add( dir.getAbsolutePath() );
    875                        }
    876                        else{
    877                                return;
    878                        }
    879                }
    880                else if( dir.isDirectory() ) {
    881//                      final File[] files = dir.listFiles();
    882                        final File[] files = dir.listFiles( filter );
    883                        // 6.3.9.0 (2015/11/06) null になっている可能性があるメソッドの戻り値のnullチェックを追加。
    884                        if( files != null ) {
    885                                for( int i=0; i<files.length; i++ ) {
    886//                                      getFileList( files[i], sort, list, isCopy );
    887                                        getFileList( files[i], filter, sort, list, isCopy );    // 8.5.0.0 (2023/04/21) Modify
    888                                }
    889                        }
    890                }
    891                if( sort ) {
    892                        Collections.sort( list );
    893                }
    894        }
    895
    896        /**
    897         * ファイルをリネームを行います。
    898         * 引数のuseBackup属性を true にすると、toFile が存在した場合、toFile の直下に "_backup" フォルダを
    899         * 作成して、toFile ＋ "_" ＋ (現在時刻のLONG値) ＋ "." ＋ (toFileの拡張子) に名前変更します。
    900         * useBackup属性を rename にすると、toFile が存在した場合、toFile に、"_001" からなる
    901         * 連番を付与し、重複しなくなるまで、名前を変更します。
    902         * useBackup属性を false(またはnull) にすると、toFile が存在した場合、toFile を削除します。
    903         *
    904         * 戻り値は、変更後のファイルオブジェクトです。
    905         *
    906         * @og.rev 5.7.1.2 (2013/12/20) 新規追加
    907         * @og.rev 6.0.2.4 (2014/10/17) useBackup の機能追加
    908         * @og.rev 6.2.0.0 (2015/02/27) FileInfoクラスを使用。 (#getFileSplit(File)の結果配列は廃止)
    909         * @og.rev 5.9.10.0 (2019/03/01) FileOperation対応
    910         * @og.rev 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    911         *
    912         * @param       fromFile        名前変更する元のファイル
    913         * @param       toFile          名前変更後のファイル
    914         * @param       useBackup       置き換えファイルの処理方法(true:backupフォルダ/false:しない/rename:重複しない連番)
    915         * @return      名前変更後のファイル
    916         * @throws      RuntimeException        名称変更処理ができなかった場合。
    917         */
    918        public static File renameTo( final File fromFile , final File toFile , final String useBackup ) {
    919                if( fromFile == null || toFile == null ) {
    920                        final String errMsg = "入力ファイルが null です。from=[" + fromFile + "] , to=[" + toFile + "]" ;
    921                        throw new OgRuntimeException( errMsg );
    922                }
    923
    924                final File parent = toFile.getParentFile();                     // 6.0.2.4 (2014/10/17) toFile のフォルダがなければ作成
    925                if( !parent.exists() && !parent.mkdirs() ) {
    926                        final String errMsg = "toファイルのフォルダが作成できません。from=[" + fromFile + "] , to=[" + toFile + "]" ;
    927                        throw new OgRuntimeException( errMsg );
    928                }
    929
    930                // 変更先のファイルが存在した場合の処理。
    931                File newFile = toFile;                  // useBackup = "rename" の時のみ書き換えたいので。
    932                if( toFile.exists() ) {
    933                        final FileInfo info = new FileInfo( toFile );                           // 6.2.0.0 (2015/02/27)
    934                        // バックアップ作成する場合
    935                        // 6.0.2.4 (2014/10/17) useBackup は、文字列で、true/false,(null)/rename がある。
    936                        if( "true".equalsIgnoreCase( useBackup ) ) {
    937//                              final File backup = new File( parent , "_backup" );     // その直下に、"_backup" フォルダを作成
    938                                // 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    939//                              final File backup = FileOperationFactory.newStorageOperation(toFile, parent.getPath(), "_backup"); // 5.10.9.0 (2019/03/01)
    940                                final File backup = FileOperationFactory.resolveFile(toFile, parent.getPath(), "_backup"); // 5.10.9.0 (2019/03/01)
    941                                if( !backup.exists() && !backup.mkdirs() ) {
    942                                        final String errMsg = "バックアップ処理でbackupフォルダの作成に失敗しました。[" + backup + "]";
    943                                        throw new OgRuntimeException( errMsg );
    944                                }
    945                                // バックアップファイル名は、元のファイル名(拡張子含む) ＋ "_" + 現在時刻のlong値 + "." + 元のファイルの拡張子
    946                                final String toName = toFile.getName();
    947//                              final File toFile2  = new File( parent,toName );                // オリジナルの toFile をrename するとまずいので、同名のFileオブジェクトを作成
    948                                // 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    949//                              final File toFile2 = FileOperationFactory.newStorageOperation(toFile, parent.getPath(), toName); // 5.10.9.0 (2019/03/01)
    950                                final File toFile2 = FileOperationFactory.resolveFile(toFile, parent.getPath(), toName); // 5.10.9.0 (2019/03/01)
    951
    952                                final String bkupName = info.NAME + "_" + System.currentTimeMillis() + "."  + info.SUFIX ;              // 6.2.0.0 (2015/02/27)
    953//                              final File bkupFile = new File( backup,bkupName );
    954                                // 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    955//                              final File bkupFile = FileOperationFactory.newStorageOperation(backup, backup.getParent(), bkupName); // 5.10.9.0 (2019/03/01)
    956                                final File bkupFile = FileOperationFactory.resolveFile(backup, backup.getParent(), bkupName); // 5.10.9.0 (2019/03/01)
    957
    958                                if( !toFile2.renameTo( bkupFile ) ) {
    959                                        final String errMsg = "バックアップ処理でバックアップファイルをリネームできませんでした。" +CR
    960                                                                                 + "  [" + toFile + "] ⇒ [" + bkupFile + "]" ;
    961                                        throw new OgRuntimeException( errMsg );
    962                                }
    963                        }
    964                        // 他と違い、toFile を変更する必要がある。
    965                        else if( "rename".equalsIgnoreCase( useBackup ) ) {
    966                                for( int i=1000; i<2000; i++ ) {                        // 000 の３桁を取得したいため。
    967                                        final String no = String.valueOf( i ).substring(1);
    968                                        // 6.2.0.0 (2015/02/27) 配列ではなく、FileInfoクラスを使用
    969//                                      final File toFile2 = new File( info.DIR , info.NAME + "_" + no + "." + info.SUFIX );
    970                                        // 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ修正
    971//                                      final File toFile2 = FileOperationFactory.newStorageOperation(toFile, info.DIR, info.NAME + "_" + no + "." + info.SUFIX); // 5.10.9.0 (2019/03/01)
    972                                        final File toFile2 = FileOperationFactory.resolveFile(toFile, info.DIR, info.NAME + "_" + no + "." + info.SUFIX); // 5.10.9.0 (2019/03/01)
    973                                        if( !toFile2.exists() ) {
    974                                                newFile = toFile2;
    975                                                break;
    976                                        }
    977                                }
    978                        }
    979                        // バックアップ作成しない場合は、削除します。
    980                        else if( !toFile.delete() ) {
    981                                final String errMsg = "既存のファイル[" + toFile + "]が削除できませんでした。";
    982                                throw new OgRuntimeException( errMsg );
    983                        }
    984                }
    985
    986                if( !fromFile.renameTo( newFile ) ) {
    987                        final String errMsg = "所定のファイルをリネームできませんでした。" + CR
    988                                                                + "  [" + fromFile + "] ⇒ [" + newFile + "]" ;
    989                        throw new OgRuntimeException( errMsg );
    990                }
    991                return newFile;
    992        }
    993
    994        /**
    995         * ファイルを読み取って、文字列を作成します。
    996         *
    997         * データの読取が完全に出来なかったときには、途中までのデータを返します。
    998         * 指定のエンコードが存在しない場合や、ファイルが存在しない場合は、
    999         * OgRuntimeException を throw します。
    1000         * encode が null の場合は、UTF-8 で読み込みます。
    1001         *
    1002         * @og.rev 6.4.2.0 (2016/01/29) fukurou.util.StringUtil → fukurou.system.HybsConst に変更
    1003         * @og.rev 6.4.5.1 (2016/04/28) encode は初期化しているため、null はセットされません。
    1004         * @og.rev 6.4.5.2 (2016/05/06) fukurou.util.FileString から、fukurou.util.FileUtil に移動。
    1005         *
    1006         * @param  filename ファイル名
    1007         * @param  encode エンコード名
    1008         * @return  ファイルを読み取った文字列
    1009         * @throws RuntimeException 指定のエンコードが存在しなかったとき。
    1010         */
    1011        public static String getValue( final String filename , final String encode ) {
    1012                if( filename == null ) {
    1013                        final String errMsg = "ファイル名が指定されていません。" ;
    1014                        throw new OgRuntimeException( errMsg );
    1015                }
    1016
    1017                final String enc = encode == null ? HybsConst.UTF_8 : encode ;
    1018
    1019                try {
    1020                        return new String( Files.readAllBytes( new File( filename ).toPath() ),enc );
    1021                }
    1022                catch( final IOException ex ) {
    1023                        final String errMsg = "ファイル名がオープン出来ませんでした。[" + filename + "]" ;
    1024                        throw new OgRuntimeException( errMsg,ex );
    1025                }
    1026        }
    1027
    1028        /**
    1029         * 改行コードで分割して、Listオブジェクトを返します。
    1030         *
    1031         * encode が null の場合は、UTF-8 で読み込みます。
    1032         *
    1033         * @og.rev 6.4.5.2 (2016/05/06) fukurou.util.FileString から、fukurou.util.FileUtil に移動。
    1034         *
    1035         * @param  filename ファイル名
    1036         * @param  encode エンコード名
    1037         * @return  ファイルを読み取った文字列を分割したList
    1038         */
    1039        public static List<String> getLineList( final String filename , final String encode ) {
    1040                try {
    1041                        final String enc = encode == null ? HybsConst.UTF_8 : encode ;
    1042
    1043                        return Files.readAllLines( new File( filename ).toPath() , Charset.forName( enc ) );
    1044                }
    1045                catch( final IOException ex ) {
    1046                        final String errMsg = "ファイル名がオープン出来ませんでした。[" + filename + "]" ;
    1047                        throw new OgRuntimeException( errMsg,ex );
    1048                }
    1049        }
    1050
    1051        /**
    1052         * Fileオブジェクトのサイズを返します。
    1053         *
    1054         * オブジェクトが通常のファイルの場合は、そのファイルサイズを返します。
    1055         * フォルダの場合は、再帰的に、ファイルサイズを加算した結果を返します。
    1056         *
    1057         * @og.rev 6.7.4.1 (2017/02/17) Fileオブジェクトのサイズを返します。
    1058         *
    1059         * @param  file Fileオブジェクト
    1060         * @return  ファイルまたはフォルダののサイズ
    1061         */
    1062        public static long length( final File file ) {
    1063                if( file.isDirectory() ) {
    1064                        final File[] children = file.listFiles();
    1065
    1066                        long sum = 0;
    1067                        if( children != null ) {
    1068                                for( final File child : children ) {
    1069                                        sum += length( child );
    1070                                }
    1071                        }
    1072                        return sum;
    1073                }
    1074                return file.length();
    1075        }
    1076
    1077        /**
    1078         * PrintWriter を継承した、System.out/System.err 用のクラスを定義します。
    1079         *
    1080         * 通常の、new PrintWriter( OutputStream ) で、求めるのと、ほとんど同様の
    1081         * 処理を行います。
    1082         * ただ、close() メソッドが呼ばれても、何もしません。
    1083         *
    1084         */
    1085        private static final class NonClosePrintWriter extends PrintWriter {
    1086                /**
    1087                 * コンストラクター
    1088                 *
    1089                 * new PrintWriter( OutputStream ) を行います。
    1090                 *
    1091                 * @param out OutputStreamオブジェクト
    1092                 */
    1093                public NonClosePrintWriter( final OutputStream out ) {
    1094                        super( out );
    1095                }
    1096
    1097                /**
    1098                 * close() メソッドをオーバーライドします。
    1099                 *
    1100                 * 何もしません。
    1101                 */
    1102                @Override
    1103                public void close() {
    1104                        // ここでは処理を行いません。
    1105                }
    1106        }
    1107
    1108        /**
    1109         * PrintWriter を継承した、JspWriterなどの Writer 用のクラスを定義します。
    1110         *
    1111         * 例えば、JspWriterなどの JSP/Servlet等のフレームワークで使用される
    1112         * Writer では、flush や close 処理は、フレームワーク内で行われます。
    1113         * その場合、通常のファイルと同じ用に、flush や close をアプリケーション側で
    1114         * 行うと、内部処理的に不整合が発生したり、最悪の場合エラーになります。
    1115         * このクラスは、単に、通常の、new PrintWriter( Writer ) で、求めるのと、
    1116         * ほとんど同様の処理を行います。
    1117         * ただ、close() と flush() メソッドが呼ばれても、何もしません。
    1118         *
    1119         */
    1120        private static final class NonFlushPrintWriter extends PrintWriter {
    1121                /**
    1122                 * コンストラクター
    1123                 *
    1124                 * new PrintWriter( Writer ) を行います。
    1125                 *
    1126                 * @param writer Writerオブジェクト
    1127                 */
    1128                public NonFlushPrintWriter( final Writer writer ) {
    1129                        super( writer );
    1130                }
    1131
    1132                /**
    1133                 * close() メソッドをオーバーライドします。
    1134                 *
    1135                 * 何もしません。
    1136                 */
    1137                @Override
    1138                public void close() {
    1139                        // ここでは処理を行いません。
    1140                }
    1141
    1142                /**
    1143                 * flush() メソッドをオーバーライドします。
    1144                 *
    1145                 * 何もしません。
    1146                 */
    1147                @Override
    1148                public void flush() {
    1149                        // ここでは処理を行いません。
    1150                }
    1151        }
    1152
    1153        /**
    1154         * ファイルのエンコードを変換するコピーを行います。
    1155         *
    1156         * copy( File,File,false ) を呼び出します。
    1157         *
    1158         * @og.rev 5.1.6.0 (2010/05/01) 戻り値に、true/false 指定します。
    1159         *
    1160         * @param       file1   コピー元ファイル名
    1161         * @param       file2   コピー先ファイル名
    1162         * @param       encode1 コピー元ファイルのエンコード
    1163         * @param       encode2 コピー先ファイルのエンコード
    1164         *
    1165         * @see         #copy( File,File,boolean )
    1166         */
    1167        public static void copy( final File file1,final File file2,final String encode1,final String encode2 ) {
    1168        //      final File tempFile = new File( file2.getName() + "_backup" );
    1169
    1170        //      FileUtil.copy( file2,tempFile );
    1171
    1172                final BufferedReader reader = FileUtil.getBufferedReader( file1 ,encode1 );
    1173                final PrintWriter    writer = FileUtil.getPrintWriter(    file2 ,encode2 );
    1174
    1175                try {
    1176                        String line1;
    1177                        while((line1 = reader.readLine()) != null) {
    1178                                writer.println( line1 );
    1179                        }
    1180                }
    1181                catch( final Throwable th ) {
    1182                        th.printStackTrace();
    1183                }
    1184                finally {
    1185                        Closer.ioClose( reader ) ;
    1186                        Closer.ioClose( writer ) ;
    1187                }
    1188
    1189                // 6.9.8.0 (2018/05/28) FindBugs:例外的戻り値を無視しているメソッド
    1190//              file2.setLastModified( file1.lastModified() );
    1191                if( !file2.setLastModified( file1.lastModified() ) ) {
    1192                        final String errMsg = "FileUtil.copy において、タイムスタンプの更新が出来ませんでした。" + CR
    1193                                                                        + " file2= [" + file2 + "]" + CR ;
    1194                        System.err.println( errMsg );
    1195                }
    1196        }
    1197
    1198        /**
    1199         * ファイルをコピーします。
    1200         *
    1201         * 引数に &lt;file1&gt; &lt;file2&gt; [&lt;encode1&gt; &lt;encode2&gt;] を指定します。
    1202         * file1 を読み込み、file2 にコピーします。コピー前に、file2 は、file2_backup にコピーします。
    1203         * file1 が、ディレクトリの場合は、ディレクトリごとコピーします。
    1204         * encode1、encode2 を指定すると、エンコード変換しながらコピーになります。
    1205         * この場合は、ファイル同士のコピーのみになります。
    1206         *
    1207         * @og.rev 4.0.0.0 (2007/11/28) メソッドの戻り値をチェックします。
    1208         * @og.rev 5.1.6.0 (2010/05/01) 引数の並び順、処理を変更します。
    1209         *
    1210         * @param       args 引数配列  file1 file2 [encode1 encode2]
    1211         * @throws Throwable なんらかのエラーが発生した場合。
    1212         */
    1213        public static void main( final String[] args ) throws Throwable {
    1214                if( args.length != 2 && args.length != 4 ) {
    1215                        LogWriter.log("Usage: java org.opengion.fukurou.util.FileUtil <file1> <file2> [<encode1> <encode2>]" );
    1216                        return ;
    1217                }
    1218
    1219                final File file1 = new File( args[0] );
    1220                final File file2 = new File( args[1] );
    1221
    1222                if( args.length < 3 ) {
    1223                        if( file1.isDirectory() ) {
    1224                                FileUtil.copyDirectry( file1, file2, true );
    1225                        }
    1226                        else {
    1227                                final File tempFile = new File( args[1] + "_backup" );
    1228                                FileUtil.copy( file2,tempFile );
    1229                                FileUtil.copy( file1,file2, true );
    1230                        }
    1231                }
    1232                else {
    1233                        final String encode1 = args[2];
    1234                        final String encode2 = args[3];
    1235
    1236                        if( file1.isDirectory() ) {
    1237                                final File[] children = file1.listFiles();
    1238
    1239                                if( children != null ) {
    1240                                        for( final File child : children ) {
    1241                                                copy( child , new File( file2 , child.getName() ),encode1,encode2 );
    1242                                        }
    1243                                }
    1244                        }
    1245                        else {
    1246                                copy( file1,file2,encode1,encode2 );
    1247                        }
    1248                }
    1249        }
    1250}