18042六、文件工具類

import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.RandomAccessFile;
import java.util.Enumeration;
import java.util.List;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.tools.zip.ZipEntry;
import org.apache.tools.zip.ZipFile;
import org.apache.tools.zip.ZipOutputStream;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.google.common.collect.Lists;

/**
 * 文件操做工具類
 * 實現文件的建立、刪除、複製、壓縮、解壓以及目錄的建立、刪除、複製、壓縮解壓等功能
 * @author Rick
 * @version 2018-04-26
 */
public class FileUtils extends org.apache.commons.io.FileUtils {
    
    private static Logger logger = LoggerFactory.getLogger(FileUtils.class);

    /**
     * 複製單個文件，若是目標文件存在，則不覆蓋
     * @param srcFileName 待複製的文件名
     * @param descFileName 目標文件名
     * @return 若是複製成功，則返回true，不然返回false
     */
    public static boolean copyFile(String srcFileName, String descFileName) {
        return FileUtils.copyFileCover(srcFileName, descFileName, false);
    }

    /**
     * 複製單個文件
     * @param srcFileName 待複製的文件名
     * @param descFileName 目標文件名
     * @param coverlay 若是目標文件已存在，是否覆蓋
     * @return 若是複製成功，則返回true，不然返回false
     */
    public static boolean copyFileCover(String srcFileName,
            String descFileName, boolean coverlay) {
        File srcFile = new File(srcFileName);
        // 判斷源文件是否存在
        if (!srcFile.exists()) {
            logger.debug("複製文件失敗，源文件 " + srcFileName + " 不存在!");
            return false;
        }
        // 判斷源文件是不是合法的文件
        else if (!srcFile.isFile()) {
            logger.debug("複製文件失敗，" + srcFileName + " 不是一個文件!");
            return false;
        }
        File descFile = new File(descFileName);
        // 判斷目標文件是否存在
        if (descFile.exists()) {
            // 若是目標文件存在，而且容許覆蓋
            if (coverlay) {
                logger.debug("目標文件已存在，準備刪除!");
                if (!FileUtils.delFile(descFileName)) {
                    logger.debug("刪除目標文件 " + descFileName + " 失敗!");
                    return false;
                }
            } else {
                logger.debug("複製文件失敗，目標文件 " + descFileName + " 已存在!");
                return false;
            }
        } else {
            if (!descFile.getParentFile().exists()) {
                // 若是目標文件所在的目錄不存在，則建立目錄
                logger.debug("目標文件所在的目錄不存在，建立目錄!");
                // 建立目標文件所在的目錄
                if (!descFile.getParentFile().mkdirs()) {
                    logger.debug("建立目標文件所在的目錄失敗!");
                    return false;
                }
            }
        }

        // 準備複製文件
        // 讀取的位數
        int readByte = 0;
        InputStream ins = null;
        OutputStream outs = null;
        try {
            // 打開源文件
            ins = new FileInputStream(srcFile);
            // 打開目標文件的輸出流
            outs = new FileOutputStream(descFile);
            byte[] buf = new byte[1024];
            // 一次讀取1024個字節，當readByte爲-1時表示文件已經讀取完畢
            while ((readByte = ins.read(buf)) != -1) {
                // 將讀取的字節流寫入到輸出流
                outs.write(buf, 0, readByte);
            }
            logger.debug("複製單個文件 " + srcFileName + " 到" + descFileName
                    + "成功!");
            return true;
        } catch (Exception e) {
            logger.debug("複製文件失敗：" + e.getMessage());
            return false;
        } finally {
            // 關閉輸入輸出流，首先關閉輸出流，而後再關閉輸入流
            if (outs != null) {
                try {
                    outs.close();
                } catch (IOException oute) {
                    oute.printStackTrace();
                }
            }
            if (ins != null) {
                try {
                    ins.close();
                } catch (IOException ine) {
                    ine.printStackTrace();
                }
            }
        }
    }

    /**
     * 複製整個目錄的內容，若是目標目錄存在，則不覆蓋
     * @param srcDirName 源目錄名
     * @param descDirName 目標目錄名
     * @return 若是複製成功返回true，不然返回false
     */
    public static boolean copyDirectory(String srcDirName, String descDirName) {
        return FileUtils.copyDirectoryCover(srcDirName, descDirName,
                false);
    }

    /**
     * 複製整個目錄的內容 
     * @param srcDirName 源目錄名
     * @param descDirName 目標目錄名
     * @param coverlay 若是目標目錄存在，是否覆蓋
     * @return 若是複製成功返回true，不然返回false
     */
    public static boolean copyDirectoryCover(String srcDirName,
            String descDirName, boolean coverlay) {
        File srcDir = new File(srcDirName);
        // 判斷源目錄是否存在
        if (!srcDir.exists()) {
            logger.debug("複製目錄失敗，源目錄 " + srcDirName + " 不存在!");
            return false;
        }
        // 判斷源目錄是不是目錄
        else if (!srcDir.isDirectory()) {
            logger.debug("複製目錄失敗，" + srcDirName + " 不是一個目錄!");
            return false;
        }
        // 若是目標文件夾名不以文件分隔符結尾，自動添加文件分隔符
        String descDirNames = descDirName;
        if (!descDirNames.endsWith(File.separator)) {
            descDirNames = descDirNames + File.separator;
        }
        File descDir = new File(descDirNames);
        // 若是目標文件夾存在
        if (descDir.exists()) {
            if (coverlay) {
                // 容許覆蓋目標目錄
                logger.debug("目標目錄已存在，準備刪除!");
                if (!FileUtils.delFile(descDirNames)) {
                    logger.debug("刪除目錄 " + descDirNames + " 失敗!");
                    return false;
                }
            } else {
                logger.debug("目標目錄複製失敗，目標目錄 " + descDirNames + " 已存在!");
                return false;
            }
        } else {
            // 建立目標目錄
            logger.debug("目標目錄不存在，準備建立!");
            if (!descDir.mkdirs()) {
                logger.debug("建立目標目錄失敗!");
                return false;
            }

        }

        boolean flag = true;
        // 列出源目錄下的全部文件名和子目錄名
        File[] files = srcDir.listFiles();
        for (int i = 0; i < files.length; i++) {
            // 若是是一個單個文件，則直接複製
            if (files[i].isFile()) {
                flag = FileUtils.copyFile(files[i].getAbsolutePath(),
                        descDirName + files[i].getName());
                // 若是拷貝文件失敗，則退出循環
                if (!flag) {
                    break;
                }
            }
            // 若是是子目錄，則繼續複製目錄
            if (files[i].isDirectory()) {
                flag = FileUtils.copyDirectory(files[i]
                        .getAbsolutePath(), descDirName + files[i].getName());
                // 若是拷貝目錄失敗，則退出循環
                if (!flag) {
                    break;
                }
            }
        }

        if (!flag) {
            logger.debug("複製目錄 " + srcDirName + " 到 " + descDirName + " 失敗!");
            return false;
        }
        logger.debug("複製目錄 " + srcDirName + " 到 " + descDirName + " 成功!");
        return true;

    }

    /**
     * 
     * 刪除文件，能夠刪除單個文件或文件夾
     * 
     * @param fileName 被刪除的文件名
     * @return 若是刪除成功，則返回true，否是返回false
     */
    public static boolean delFile(String fileName) {
         File file = new File(fileName);
        if (!file.exists()) {
            logger.debug(fileName + " 文件不存在!");
            return true;
        } else {
            if (file.isFile()) {
                return FileUtils.deleteFile(fileName);
            } else {
                return FileUtils.deleteDirectory(fileName);
            }
        }
    }

    /**
     * 
     * 刪除單個文件
     * 
     * @param fileName 被刪除的文件名
     * @return 若是刪除成功，則返回true，不然返回false
     */
    public static boolean deleteFile(String fileName) {
        File file = new File(fileName);
        if (file.exists() && file.isFile()) {
            if (file.delete()) {
                logger.debug("刪除文件 " + fileName + " 成功!");
                return true;
            } else {
                logger.debug("刪除文件 " + fileName + " 失敗!");
                return false;
            }
        } else {
            logger.debug(fileName + " 文件不存在!");
            return true;
        }
    }

    /**
     * 
     * 刪除目錄及目錄下的文件
     * 
     * @param dirName 被刪除的目錄所在的文件路徑
     * @return 若是目錄刪除成功，則返回true，不然返回false
     */
    public static boolean deleteDirectory(String dirName) {
        String dirNames = dirName;
        if (!dirNames.endsWith(File.separator)) {
            dirNames = dirNames + File.separator;
        }
        File dirFile = new File(dirNames);
        if (!dirFile.exists() || !dirFile.isDirectory()) {
            logger.debug(dirNames + " 目錄不存在!");
            return true;
        }
        boolean flag = true;
        // 列出所有文件及子目錄
        File[] files = dirFile.listFiles();
        for (int i = 0; i < files.length; i++) {
            // 刪除子文件
            if (files[i].isFile()) {
                flag = FileUtils.deleteFile(files[i].getAbsolutePath());
                // 若是刪除文件失敗，則退出循環
                if (!flag) {
                    break;
                }
            }
            // 刪除子目錄
            else if (files[i].isDirectory()) {
                flag = FileUtils.deleteDirectory(files[i]
                        .getAbsolutePath());
                // 若是刪除子目錄失敗，則退出循環
                if (!flag) {
                    break;
                }
            }
        }

        if (!flag) {
            logger.debug("刪除目錄失敗!");
            return false;
        }
        // 刪除當前目錄
        if (dirFile.delete()) {
            logger.debug("刪除目錄 " + dirName + " 成功!");
            return true;
        } else {
            logger.debug("刪除目錄 " + dirName + " 失敗!");
            return false;
        }

    }

    /**
     * 建立單個文件
     * @param descFileName 文件名，包含路徑
     * @return 若是建立成功，則返回true，不然返回false
     */
    public static boolean createFile(String descFileName) {
        File file = new File(descFileName);
        if (file.exists()) {
            logger.debug("文件 " + descFileName + " 已存在!");
            return false;
        }
        if (descFileName.endsWith(File.separator)) {
            logger.debug(descFileName + " 爲目錄，不能建立目錄!");
            return false;
        }
        if (!file.getParentFile().exists()) {
            // 若是文件所在的目錄不存在，則建立目錄
            if (!file.getParentFile().mkdirs()) {
                logger.debug("建立文件所在的目錄失敗!");
                return false;
            }
        }

        // 建立文件
        try {
            if (file.createNewFile()) {
                logger.debug(descFileName + " 文件建立成功!");
                return true;
            } else {
                logger.debug(descFileName + " 文件建立失敗!");
                return false;
            }
        } catch (Exception e) {
            e.printStackTrace();
            logger.debug(descFileName + " 文件建立失敗!");
            return false;
        }

    }

    /**
     * 建立目錄
     * @param descDirName 目錄名,包含路徑
     * @return 若是建立成功，則返回true，不然返回false
     */
    public static boolean createDirectory(String descDirName) {
        String descDirNames = descDirName;
        if (!descDirNames.endsWith(File.separator)) {
            descDirNames = descDirNames + File.separator;
        }
        File descDir = new File(descDirNames);
        if (descDir.exists()) {
            logger.debug("目錄 " + descDirNames + " 已存在!");
            return false;
        }
        // 建立目錄
        if (descDir.mkdirs()) {
            logger.debug("目錄 " + descDirNames + " 建立成功!");
            return true;
        } else {
            logger.debug("目錄 " + descDirNames + " 建立失敗!");
            return false;
        }

    }

    /**
     * 寫入文件
     * @param file 要寫入的文件
     */
    public static void writeToFile(String fileName, String content, boolean append) {
        try {
            FileUtils.write(new File(fileName), content, "utf-8", append);
            logger.debug("文件 " + fileName + " 寫入成功!");
        } catch (IOException e) {
            logger.debug("文件 " + fileName + " 寫入失敗! " + e.getMessage());
        }
    }

    /**
     * 寫入文件
     * @param file 要寫入的文件
     */
    public static void writeToFile(String fileName, String content, String encoding, boolean append) {
        try {
            FileUtils.write(new File(fileName), content, encoding, append);
            logger.debug("文件 " + fileName + " 寫入成功!");
        } catch (IOException e) {
            logger.debug("文件 " + fileName + " 寫入失敗! " + e.getMessage());
        }
    }
    
    /**
     * 壓縮文件或目錄
     * @param srcDirName 壓縮的根目錄
     * @param fileName 根目錄下的待壓縮的文件名或文件夾名，其中*或""表示跟目錄下的所有文件
     * @param descFileName 目標zip文件
     */
    public static void zipFiles(String srcDirName, String fileName,
            String descFileName) {
        // 判斷目錄是否存在
        if (srcDirName == null) {
            logger.debug("文件壓縮失敗，目錄 " + srcDirName + " 不存在!");
            return;
        }
        File fileDir = new File(srcDirName);
        if (!fileDir.exists() || !fileDir.isDirectory()) {
            logger.debug("文件壓縮失敗，目錄 " + srcDirName + " 不存在!");
            return;
        }
        String dirPath = fileDir.getAbsolutePath();
        File descFile = new File(descFileName);
        try {
            ZipOutputStream zouts = new ZipOutputStream(new FileOutputStream(
                    descFile));
            if ("*".equals(fileName) || "".equals(fileName)) {
                FileUtils.zipDirectoryToZipFile(dirPath, fileDir, zouts);
            } else {
                File file = new File(fileDir, fileName);
                if (file.isFile()) {
                    FileUtils.zipFilesToZipFile(dirPath, file, zouts);
                } else {
                    FileUtils
                            .zipDirectoryToZipFile(dirPath, file, zouts);
                }
            }
            zouts.close();
            logger.debug(descFileName + " 文件壓縮成功!");
        } catch (Exception e) {
            logger.debug("文件壓縮失敗：" + e.getMessage());
            e.printStackTrace();
        }

    }

    /**
     * 解壓縮ZIP文件，將ZIP文件裏的內容解壓到descFileName目錄下
     * @param zipFileName 須要解壓的ZIP文件
     * @param descFileName 目標文件
     */
    public static boolean unZipFiles(String zipFileName, String descFileName) {
        String descFileNames = descFileName;
        if (!descFileNames.endsWith(File.separator)) {
            descFileNames = descFileNames + File.separator;
        }        
        try {
            // 根據ZIP文件建立ZipFile對象
            ZipFile zipFile = new ZipFile(zipFileName);
            ZipEntry entry = null;
            String entryName = null;
            String descFileDir = null;
            byte[] buf = new byte[4096];
            int readByte = 0;
            // 獲取ZIP文件裏全部的entry
            @SuppressWarnings("rawtypes")
            Enumeration enums = zipFile.getEntries();
            // 遍歷全部entry
            while (enums.hasMoreElements()) {
                entry = (ZipEntry) enums.nextElement();
                // 得到entry的名字
                entryName = entry.getName();
                descFileDir = descFileNames + entryName;
                if (entry.isDirectory()) {
                    // 若是entry是一個目錄，則建立目錄
                    new File(descFileDir).mkdirs();
                    continue;
                } else {
                    // 若是entry是一個文件，則建立父目錄
                    new File(descFileDir).getParentFile().mkdirs();
                }
                File file = new File(descFileDir);
                // 打開文件輸出流
                OutputStream os = new FileOutputStream(file);
                // 從ZipFile對象中打開entry的輸入流
                InputStream is = zipFile.getInputStream(entry);
                while ((readByte = is.read(buf)) != -1) {
                    os.write(buf, 0, readByte);
                }
                os.close();
                is.close();
            }
            zipFile.close();
            logger.debug("文件解壓成功!");
            return true;
        } catch (Exception e) {
            logger.debug("文件解壓失敗：" + e.getMessage());
            return false;
        }
    }

    /**
     * 將目錄壓縮到ZIP輸出流
     * @param dirPath 目錄路徑
     * @param fileDir 文件信息
     * @param zouts 輸出流
     */
    public static void zipDirectoryToZipFile(String dirPath, File fileDir, ZipOutputStream zouts) {
        if (fileDir.isDirectory()) {
            File[] files = fileDir.listFiles();
            // 空的文件夾
            if (files.length == 0) {
                // 目錄信息
                ZipEntry entry = new ZipEntry(getEntryName(dirPath, fileDir));
                try {
                    zouts.putNextEntry(entry);
                    zouts.closeEntry();
                } catch (Exception e) {
                    e.printStackTrace();
                }
                return;
            }

            for (int i = 0; i < files.length; i++) {
                if (files[i].isFile()) {
                    // 若是是文件，則調用文件壓縮方法
                    FileUtils
                            .zipFilesToZipFile(dirPath, files[i], zouts);
                } else {
                    // 若是是目錄，則遞歸調用
                    FileUtils.zipDirectoryToZipFile(dirPath, files[i],
                            zouts);
                }
            }
        }
    }

    /**
     * 將文件壓縮到ZIP輸出流
     * @param dirPath 目錄路徑
     * @param file 文件
     * @param zouts 輸出流
     */
    public static void zipFilesToZipFile(String dirPath, File file, ZipOutputStream zouts) {
        FileInputStream fin = null;
        ZipEntry entry = null;
        // 建立複製緩衝區
        byte[] buf = new byte[4096];
        int readByte = 0;
        if (file.isFile()) {
            try {
                // 建立一個文件輸入流
                fin = new FileInputStream(file);
                // 建立一個ZipEntry
                entry = new ZipEntry(getEntryName(dirPath, file));
                // 存儲信息到壓縮文件
                zouts.putNextEntry(entry);
                // 複製字節到壓縮文件
                while ((readByte = fin.read(buf)) != -1) {
                    zouts.write(buf, 0, readByte);
                }
                zouts.closeEntry();
                fin.close();
                System.out
                        .println("添加文件 " + file.getAbsolutePath() + " 到zip文件中!");
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

    /**
     * 獲取待壓縮文件在ZIP文件中entry的名字，即相對於跟目錄的相對路徑名
     * @param dirPat 目錄名
     * @param file entry文件名
     * @return
     */
    private static String getEntryName(String dirPath, File file) {
        String dirPaths = dirPath;
        if (!dirPaths.endsWith(File.separator)) {
            dirPaths = dirPaths + File.separator;
        }
        String filePath = file.getAbsolutePath();
        // 對於目錄，必須在entry名字後面加上"/"，表示它將以目錄項存儲
        if (file.isDirectory()) {
            filePath += "/";
        }
        int index = filePath.indexOf(dirPaths);

        return filePath.substring(index + dirPaths.length());
    }

    /**
     * 根據「文件名的後綴」獲取文件內容類型（而非根據File.getContentType()讀取的文件類型）
     * @param returnFileName 帶驗證的文件名
     * @return 返回文件類型
     */
    public static String getContentType(String returnFileName) {
        String contentType = "application/octet-stream";
        if (returnFileName.lastIndexOf(".") < 0)
            return contentType;
        returnFileName = returnFileName.toLowerCase();
        returnFileName = returnFileName.substring(returnFileName.lastIndexOf(".") + 1);
        if (returnFileName.equals("html") || returnFileName.equals("htm") || returnFileName.equals("shtml")) {
            contentType = "text/html";
        } else if (returnFileName.equals("apk")) {
            contentType = "application/vnd.android.package-archive";
        } else if (returnFileName.equals("sis")) {
            contentType = "application/vnd.symbian.install";
        } else if (returnFileName.equals("sisx")) {
            contentType = "application/vnd.symbian.install";
        } else if (returnFileName.equals("exe")) {
            contentType = "application/x-msdownload";
        } else if (returnFileName.equals("msi")) {
            contentType = "application/x-msdownload";
        } else if (returnFileName.equals("css")) {
            contentType = "text/css";
        } else if (returnFileName.equals("xml")) {
            contentType = "text/xml";
        } else if (returnFileName.equals("gif")) {
            contentType = "image/gif";
        } else if (returnFileName.equals("jpeg") || returnFileName.equals("jpg")) {
            contentType = "image/jpeg";
        } else if (returnFileName.equals("js")) {
            contentType = "application/x-javascript";
        } else if (returnFileName.equals("atom")) {
            contentType = "application/atom+xml";
        } else if (returnFileName.equals("rss")) {
            contentType = "application/rss+xml";
        } else if (returnFileName.equals("mml")) {
            contentType = "text/mathml";
        } else if (returnFileName.equals("txt")) {
            contentType = "text/plain";
        } else if (returnFileName.equals("jad")) {
            contentType = "text/vnd.sun.j2me.app-descriptor";
        } else if (returnFileName.equals("wml")) {
            contentType = "text/vnd.wap.wml";
        } else if (returnFileName.equals("htc")) {
            contentType = "text/x-component";
        } else if (returnFileName.equals("png")) {
            contentType = "image/png";
        } else if (returnFileName.equals("tif") || returnFileName.equals("tiff")) {
            contentType = "image/tiff";
        } else if (returnFileName.equals("wbmp")) {
            contentType = "image/vnd.wap.wbmp";
        } else if (returnFileName.equals("ico")) {
            contentType = "image/x-icon";
        } else if (returnFileName.equals("jng")) {
            contentType = "image/x-jng";
        } else if (returnFileName.equals("bmp")) {
            contentType = "image/x-ms-bmp";
        } else if (returnFileName.equals("svg")) {
            contentType = "image/svg+xml";
        } else if (returnFileName.equals("jar") || returnFileName.equals("var") 
                || returnFileName.equals("ear")) {
            contentType = "application/java-archive";
        } else if (returnFileName.equals("doc")) {
            contentType = "application/msword";
        } else if (returnFileName.equals("pdf")) {
            contentType = "application/pdf";
        } else if (returnFileName.equals("rtf")) {
            contentType = "application/rtf";
        } else if (returnFileName.equals("xls")) {
            contentType = "application/vnd.ms-excel";
        } else if (returnFileName.equals("ppt")) {
            contentType = "application/vnd.ms-powerpoint";
        } else if (returnFileName.equals("7z")) {
            contentType = "application/x-7z-compressed";
        } else if (returnFileName.equals("rar")) {
            contentType = "application/x-rar-compressed";
        } else if (returnFileName.equals("swf")) {
            contentType = "application/x-shockwave-flash";
        } else if (returnFileName.equals("rpm")) {
            contentType = "application/x-redhat-package-manager";
        } else if (returnFileName.equals("der") || returnFileName.equals("pem")
                || returnFileName.equals("crt")) {
            contentType = "application/x-x509-ca-cert";
        } else if (returnFileName.equals("xhtml")) {
            contentType = "application/xhtml+xml";
        } else if (returnFileName.equals("zip")) {
            contentType = "application/zip";
        } else if (returnFileName.equals("mid") || returnFileName.equals("midi") 
                || returnFileName.equals("kar")) {
            contentType = "audio/midi";
        } else if (returnFileName.equals("mp3")) {
            contentType = "audio/mpeg";
        } else if (returnFileName.equals("ogg")) {
            contentType = "audio/ogg";
        } else if (returnFileName.equals("m4a")) {
            contentType = "audio/x-m4a";
        } else if (returnFileName.equals("ra")) {
            contentType = "audio/x-realaudio";
        } else if (returnFileName.equals("3gpp")
                || returnFileName.equals("3gp")) {
            contentType = "video/3gpp";
        } else if (returnFileName.equals("mp4")) {
            contentType = "video/mp4";
        } else if (returnFileName.equals("mpeg")
                || returnFileName.equals("mpg")) {
            contentType = "video/mpeg";
        } else if (returnFileName.equals("mov")) {
            contentType = "video/quicktime";
        } else if (returnFileName.equals("flv")) {
            contentType = "video/x-flv";
        } else if (returnFileName.equals("m4v")) {
            contentType = "video/x-m4v";
        } else if (returnFileName.equals("mng")) {
            contentType = "video/x-mng";
        } else if (returnFileName.equals("asx") || returnFileName.equals("asf")) {
            contentType = "video/x-ms-asf";
        } else if (returnFileName.equals("wmv")) {
            contentType = "video/x-ms-wmv";
        } else if (returnFileName.equals("avi")) {
            contentType = "video/x-msvideo";
        }
        return contentType;
    }
    
    /**
     * 向瀏覽器發送文件下載，支持斷點續傳
     * @param file 要下載的文件
     * @param request 請求對象
     * @param response 響應對象
     * @return 返回錯誤信息，無錯誤信息返回null
     */
    public static String downFile(File file, HttpServletRequest request, HttpServletResponse response){
         return downFile(file, request, response, null);
    }
    
    /**
     * 向瀏覽器發送文件下載，支持斷點續傳
     * @param file 要下載的文件
     * @param request 請求對象
     * @param response 響應對象
     * @param fileName 指定下載的文件名
     * @return 返回錯誤信息，無錯誤信息返回null
     */
    public static String downFile(File file, HttpServletRequest request, HttpServletResponse response, String fileName){
        String error  = null;
        if (file != null && file.exists()) {
            if (file.isFile()) {
                if (file.length() <= 0) {
                    error = "該文件是一個空文件。";
                }
                if (!file.canRead()) {
                    error = "該文件沒有讀取權限。";
                }
            } else {
                error = "該文件是一個文件夾。";
            }
        } else {
            error = "文件已丟失或不存在！";
        }
        if (error != null){
            logger.debug("---------------" + file + " " + error);
            return error;
        }

        long fileLength = file.length(); // 記錄文件大小
        long pastLength = 0;     // 記錄已下載文件大小
        int rangeSwitch = 0;     // 0：從頭開始的全文下載；1：從某字節開始的下載（bytes=27000-）；2：從某字節開始到某字節結束的下載（bytes=27000-39000）
        long toLength = 0;         // 記錄客戶端須要下載的字節段的最後一個字節偏移量（好比bytes=27000-39000，則這個值是爲39000）
        long contentLength = 0; // 客戶端請求的字節總量
        String rangeBytes = ""; // 記錄客戶端傳來的形如「bytes=27000-」或者「bytes=27000-39000」的內容
        RandomAccessFile raf = null; // 負責讀取數據
        OutputStream os = null;     // 寫出數據
        OutputStream out = null;     // 緩衝
        byte b[] = new byte[1024];     // 暫存容器

        if (request.getHeader("Range") != null) { // 客戶端請求的下載的文件塊的開始字節
            response.setStatus(javax.servlet.http.HttpServletResponse.SC_PARTIAL_CONTENT);
            logger.debug("request.getHeader(\"Range\") = " + request.getHeader("Range"));
            rangeBytes = request.getHeader("Range").replaceAll("bytes=", "");
            if (rangeBytes.indexOf('-') == rangeBytes.length() - 1) {// bytes=969998336-
                rangeSwitch = 1;
                rangeBytes = rangeBytes.substring(0, rangeBytes.indexOf('-'));
                pastLength = Long.parseLong(rangeBytes.trim());
                contentLength = fileLength - pastLength; // 客戶端請求的是 969998336  以後的字節
            } else { // bytes=1275856879-1275877358
                rangeSwitch = 2;
                String temp0 = rangeBytes.substring(0, rangeBytes.indexOf('-'));
                String temp2 = rangeBytes.substring(rangeBytes.indexOf('-') + 1, rangeBytes.length());
                pastLength = Long.parseLong(temp0.trim()); // bytes=1275856879-1275877358，從第 1275856879 個字節開始下載
                toLength = Long.parseLong(temp2); // bytes=1275856879-1275877358，到第 1275877358 個字節結束
                contentLength = toLength - pastLength; // 客戶端請求的是 1275856879-1275877358 之間的字節
            }
        } else { // 從開始進行下載
            contentLength = fileLength; // 客戶端要求全文下載
        }

        // 若是設設置了Content-Length，則客戶端會自動進行多線程下載。若是不但願支持多線程，則不要設置這個參數。 響應的格式是:
        // Content-Length: [文件的總大小] - [客戶端請求的下載的文件塊的開始字節]
        // ServletActionContext.getResponse().setHeader("Content- Length", new Long(file.length() - p).toString());
        response.reset(); // 告訴客戶端容許斷點續傳多線程鏈接下載,響應的格式是:Accept-Ranges: bytes
        if (pastLength != 0) {
            response.setHeader("Accept-Ranges", "bytes");// 若是是第一次下,尚未斷點續傳,狀態是默認的 200,無需顯式設置;響應的格式是:HTTP/1.1 200 OK
            // 不是從最開始下載, 響應的格式是: Content-Range: bytes [文件塊的開始字節]-[文件的總大小 - 1]/[文件的總大小]
            logger.debug("---------------不是從開始進行下載！服務器即將開始斷點續傳...");
            switch (rangeSwitch) {
                case 1: { // 針對 bytes=27000- 的請求
                    String contentRange = new StringBuffer("bytes ").append(new Long(pastLength).toString()).append("-")
                            .append(new Long(fileLength - 1).toString()).append("/").append(new Long(fileLength).toString()).toString();
                    response.setHeader("Content-Range", contentRange);
                    break;
                }
                case 2: { // 針對 bytes=27000-39000 的請求
                    String contentRange = rangeBytes + "/" + new Long(fileLength).toString();
                    response.setHeader("Content-Range", contentRange);
                    break;
                }
                default: {
                    break;
                }
            }
        } else {
            // 是從開始下載
            logger.debug("---------------是從開始進行下載！");
        }

        try {
            response.addHeader("Content-Disposition", "attachment; filename=\"" + 
                    Encodes.urlEncode(StringUtils.isBlank(fileName) ? file.getName() : fileName) + "\"");
            response.setContentType(getContentType(file.getName())); // set the MIME type.
            response.addHeader("Content-Length", String.valueOf(contentLength));
            os = response.getOutputStream();
            out = new BufferedOutputStream(os);
            raf = new RandomAccessFile(file, "r");
            try {
                switch (rangeSwitch) {
                    case 0: { // 普通下載，或者從頭開始的下載 同1
                    }
                    case 1: { // 針對 bytes=27000- 的請求
                        raf.seek(pastLength); // 形如 bytes=969998336- 的客戶端請求，跳過 969998336 個字節
                        int n = 0;
                        while ((n = raf.read(b, 0, 1024)) != -1) {
                            out.write(b, 0, n);
                        }
                        break;
                    }
                    case 2: { // 針對 bytes=27000-39000 的請求
                        raf.seek(pastLength); // 形如 bytes=1275856879-1275877358 的客戶端請求，找到第 1275856879 個字節
                        int n = 0;
                        long readLength = 0; // 記錄已讀字節數
                        while (readLength <= contentLength - 1024) {// 大部分字節在這裏讀取
                            n = raf.read(b, 0, 1024);
                            readLength += 1024;
                            out.write(b, 0, n);
                        }
                        if (readLength <= contentLength) { // 餘下的不足 1024 個字節在這裏讀取
                            n = raf.read(b, 0, (int) (contentLength - readLength));
                            out.write(b, 0, n);
                        }
                        break;
                    }
                    default: {
                        break;
                    }
                }
                out.flush();
                logger.debug("---------------下載完成！");
            } catch (IOException ie) {
                /**
                 * 在寫數據的時候， 對於 ClientAbortException 之類的異常，
                 * 是由於客戶端取消了下載，而服務器端繼續向瀏覽器寫入數據時， 拋出這個異常，這個是正常的。
                 * 尤爲是對於迅雷這種吸血的客戶端軟件， 明明已經有一個線程在讀取 bytes=1275856879-1275877358，
                 * 若是短期內沒有讀取完畢，迅雷會再啓第二個、第三個。。。線程來讀取相同的字節段， 直到有一個線程讀取完畢，迅雷會 KILL
                 * 掉其餘正在下載同一字節段的線程， 強行停止字節讀出，形成服務器拋 ClientAbortException。
                 * 因此，咱們忽略這種異常
                 */
                logger.debug("提醒：向客戶端傳輸時出現IO異常，但此異常是容許的，有可能客戶端取消了下載，致使此異常，不用關心！");
            }
        } catch (Exception e) {
            logger.error(e.getMessage(), e);
        } finally {
            if (out != null) {
                try {
                    out.close();
                } catch (IOException e) {
                    logger.error(e.getMessage(), e);
                }
            }
            if (raf != null) {
                try {
                    raf.close();
                } catch (IOException e) {
                    logger.error(e.getMessage(), e);
                }
            }
        }
        return null;
    }

    /**
     * 修正路徑，將 \\ 或 / 等替換爲 File.separator
     * @param path 待修正的路徑
     * @return 修正後的路徑
     */
    public static String path(String path){
        String p = StringUtils.replace(path, "\\", "/");
        p = StringUtils.join(StringUtils.split(p, "/"), "/");
        if (!StringUtils.startsWithAny(p, "/") && StringUtils.startsWithAny(path, "\\", "/")){
            p += "/";
        }
        if (!StringUtils.endsWithAny(p, "/") && StringUtils.endsWithAny(path, "\\", "/")){
            p = p + "/";
        }
        if (path != null && path.startsWith("/")){
            p = "/" + p; // linux下路徑
        }
        return p;
    }
    
    /**
     * 獲目錄下的文件列表
     * @param dir 搜索目錄
     * @param searchDirs 是不是搜索目錄
     * @return 文件列表
     */
    public static List<String> findChildrenList(File dir, boolean searchDirs) {
        List<String> files = Lists.newArrayList();
        for (String subFiles : dir.list()) {
            File file = new File(dir + "/" + subFiles);
            if (((searchDirs) && (file.isDirectory())) || ((!searchDirs) && (!file.isDirectory()))) {
                files.add(file.getName());
            }
        }
        return files;
    }

    /**
     * 獲取文件擴展名(返回小寫)
     * @param fileName 文件名
     * @return 例如：test.jpg  返回：  jpg
     */
    public static String getFileExtension(String fileName) {
        if ((fileName == null) || (fileName.lastIndexOf(".") == -1) || (fileName.lastIndexOf(".") == fileName.length() - 1)) {
            return null;
        }
        return StringUtils.lowerCase(fileName.substring(fileName.lastIndexOf(".") + 1));
    }

    /**
     * 獲取文件名，不包含擴展名
     * @param fileName 文件名
     * @return 例如：d:\files\test.jpg  返回：d:\files\test
     */
    public static String getFileNameWithoutExtension(String fileName) {
        if ((fileName == null) || (fileName.lastIndexOf(".") == -1)) {
            return null;
        }
        return fileName.substring(0, fileName.lastIndexOf("."));
    }
}