Java 單文件複製高效實現：流操作、異常處理與性能優化

Java 單文件複製高效實現：流操作、異常處理與性能優化

文件複製是 I/O 操作基礎場景。本文提供生產級代碼模板，涵蓋流管理、緩衝策略、異常安全、大文件支持及 NIO.2 現代化替代方案。

經典 BIO 實現（兼容 JDK 1.4+）

/**
 * 複製單個文件（BIO 版）
 * @param srcPath 源文件絕對路徑
 * @param destPath 目標文件絕對路徑
 * @throws IOException I/O 錯誤時拋出
 */
public void copyFile(String srcPath, String destPath) throws IOException {
    File srcFile = new File(srcPath);
    if (!srcFile.exists() || !srcFile.isFile()) {
        throw new FileNotFoundException("源文件不存在或非文件: " + srcPath);
    }
    
    // 目標目錄不存在則創建
    File destFile = new File(destPath);
    File destDir = destFile.getParentFile();
    if (destDir != null && !destDir.exists()) {
        destDir.mkdirs();
    }
    
    // try-with-resources 自動關閉流（JDK 7+）
    try (FileInputStream fis = new FileInputStream(srcFile);
         FileOutputStream fos = new FileOutputStream(destFile)) {
        
        byte[] buffer = new byte[8192]; // 8KB 緩衝區，平衡內存與系統調用開銷
        int bytesRead;
        long totalBytes = 0;
        
        while ((bytesRead = fis.read(buffer)) != -1) {
            fos.write(buffer, 0, bytesRead);
            totalBytes += bytesRead;
            // 可選：進度回調、大文件分段校驗
        }
        
        System.out.println("複製完成: " + srcPath + " -> " + destPath + " (" + totalBytes + " bytes)");
    }
    // 流自動關閉，即使發生異常
}

關鍵點解析

現代化 NIO.2 實現（JDK 7+ 推薦）

import java.nio.file.*;
import static java.nio.file.StandardCopyOption.*;

public void copyFileNIO(Path src, Path dest) throws IOException {
    // 原子複製、保留屬性、覆蓋存在文件
    Files.copy(src, dest, REPLACE_EXISTING, COPY_ATTRIBUTES, ATOMIC_MOVE);
    // 或簡單版：Files.copy(src, dest, REPLACE_EXISTING);
}

優勢：

• 底層調用 OS 零拷貝（sendfile/CopyFileEx），性能極高
• 原子性選項保證複製要么全成要么全敗，無損壞文件
• 保留文件屬性（權限、時間戳、擴展屬性）
• 代碼極簡潔，語義清晰

大文件/網絡流複製進階模式

// 可中斷、進度回調、限速複製
public void copyWithProgress(InputStream in, OutputStream out, 
                             ProgressListener listener, long rateLimitBytesPerSec) throws IOException {
    byte[] buffer = new byte[16384];
    int bytesRead;
    long total = 0;
    long startTime = System.currentTimeMillis();
    
    while ((bytesRead = in.read(buffer)) != -1) {
        out.write(buffer, 0, bytesRead);
        total += bytesRead;
        
        // 限速邏輯
        if (rateLimitBytesPerSec > 0) {
            long elapsed = System.currentTimeMillis() - startTime;
            long expectedTime = (total * 1000) / rateLimitBytesPerSec;
            if (expectedTime > elapsed) {
                Thread.sleep(expectedTime - elapsed);
            }
        }
        
        // 進度回調
        if (listener != null) {
            listener.onProgress(total);
        }
    }
}

@FunctionalInterface
interface ProgressListener {
    void onProgress(long bytesCopied);
}

性能對比與選型建議

最佳實踐清單

• ✅ 優先使用 Files.copy()（JDK 7+）
• ✅ 必須使用 try-with-resources 管理流
• ✅ 緩衝區設 8KB-32KB
• ✅ 異常向上拋出，不吞噬
• ✅ 大文件考慮進度、校驗、限速、斷點續傳
• ✅ 複製前檢查源存在性、目標目錄可寫性
• ✅ 生產環境記錄複製日志（耗時、大小、源/目標路徑）