如何在 Groovy 中创建 ZIP 文件并安全删除原始文件-java教程-PHP中文网

如何在 Groovy 中创建 ZIP 文件并安全删除原始文件

本文介绍使用 groovy 高效、安全地将单个文件压缩为 zip 并自动删除源文件的最佳实践，涵盖资源自动关闭、内存友好流式复制、异常安全性及路径处理等关键要点。

本文介绍使用 groovy 高效、安全地将单个文件压缩为 zip 并自动删除源文件的最佳实践，涵盖资源自动关闭、内存友好流式复制、异常安全性及路径处理等关键要点。

在 Groovy 中实现“压缩后删除原文件”看似简单，但需兼顾健壮性、内存效率与资源管理。原始代码存在几个典型问题：手动管理 ZipOutputStream 生命周期易引发资源泄漏；一次性读入全部字节到内存限制了可处理文件大小；delete() 调用未置于成功压缩后的安全位置；且未对非文件类型（如目录或不存在路径）做前置校验。

以下是优化后的专业实现，充分利用 Groovy 语言特性提升可读性与可靠性：

import java.util.zip.*

class ZipUtility {

    /**
     * 将指定文件压缩为同目录下的 ZIP 文件，并可选删除原文件
     * @param fileToZip 待压缩的 File 对象（必须是普通文件）
     * @param cleanUp 是否在压缩成功后删除原文件
     * @return 成功时返回生成的 ZIP 文件对象；失败或输入非法时返回 null
     */
    File createZipFile(File fileToZip, boolean cleanUp = false) {
        if (!fileToZip?.isFile()) {
            println "[WARN] Skipping: '${fileToZip?.absolutePath}' is not a valid file"
            return null
        }

        // 构建 ZIP 文件路径：与原文件同目录，名称追加 ".zip"
        File zipFile = new File(fileToZip.parentFile, "${fileToZip.name}.zip")

        try {
            // 使用 withCloseable 确保 ZipOutputStream 在任何情况下（含异常）均被关闭
            new ZipOutputStream(new FileOutputStream(zipFile)).withCloseable { zipStream ->
                zipStream.putNextEntry(new ZipEntry(fileToZip.name))

                // 利用 Groovy 的 
                    zipStream  0) {
                if (!fileToZip.delete()) {
                    throw new IOException("Failed to delete original file: ${fileToZip.absolutePath}")
                }
                println "[INFO] Original file deleted: ${fileToZip.name}"
            }

            return zipFile

        } catch (IOException e) {
            // 清理残留 ZIP 文件（避免部分写入的损坏文件残留）
            if (zipFile.exists()) zipFile.delete()
            throw new RuntimeException("Failed to create ZIP for ${fileToZip.name}", e)
        }
    }
}

关键改进说明：

✅ 资源安全：withCloseable 替代手动 close()，彻底规避因异常导致的流未关闭问题；
✅ 内存高效：
✅ 路径健壮：显式使用 fileToZip.parentFile 构建 ZIP 路径，确保 ZIP 严格生成于源文件所在目录，避免相对路径歧义；
✅ 删除时机精准：delete() 仅在 withCloseable 正常退出后执行，且增加 ZIP 文件存在性与非空校验，防止误删；
✅ 错误防御：捕获 IOException 后主动清理临时 ZIP 文件，并抛出带上下文的运行时异常，便于调试；
✅ 语义清晰：方法签名明确参数类型（File），默认参数 cleanUp = false 提升 API 可预测性。

使用示例：

def util = new ZipUtility()
def source = new File("/tmp/data.txt")

// 仅压缩（不删除）
def zip1 = util.createZipFile(source)

// 压缩并删除原文件
def zip2 = util.createZipFile(source, true)
println "ZIP created: ${zip2.absolutePath}"