ZipHelper 教程

本教程提供了 ZipHelper 类的概述，该类是 lightweight-component/aj-util 库的一部分。ZipHelper 类为 ZIP 压缩和解压缩操作提供了实用工具方法。

简介

ZipHelper 类包含用于处理 ZIP 文件的静态方法，包括压缩、解压缩和文件类型检测。

主要特性

• 防护 Zip Slip、符号链接、条目数量、解压大小和压缩比的安全解压
• 文件和目录压缩（支持 STORED 或 DEFLATED 选项）
• 递归目录压缩
• ZIP 文件检测（魔数检查）
• STORED 条目的缓冲 CRC32 计算
• 自动目录创建

方法

1. 解压缩

1. unzip(String save, String zipFile) - 将 ZIP 文件解压缩到目标目录
2. unzip(String save, String zipFile, ExtractionLimits limits) - 使用自定义资源限制解压
3. unzipWithChineseFilename(...) - 读取旧式 GBK 条目名称

2. 压缩

1. zipFile(File[] fileContent, String saveZip, boolean useStore) - 将文件压缩为 ZIP
2. zipDirectory(String sourceDir, String saveZip, boolean useStore) - 将目录压缩为 ZIP
3. zipSingleFile(String sourceFile, String saveZip, boolean useStore) - 压缩单个文件

3. 实用方法

1. initFolder(File file) - 确保文件的父目录存在
2. initFolder(String file) - initFolder 的字符串版本
3. isZipFile(String filePath) - 检查文件是否为有效的 ZIP 文件

使用示例

解压缩

ZipHelper.unzip("C:/extracted", "C:/archive.zip");

默认解压使用保守的安全限制。可信 ZIP 确实需要更大配额时，可使用带 ExtractionLimits 的重载。

文件压缩

File[] files = {new File("file1.txt"), new File("file2.txt")};
ZipHelper.zipFile(files, "archive.zip", false); // 使用 DEFLATED 压缩

目录压缩

ZipHelper.zipDirectory("C:/data", "backup.zip", true); // 使用 STORED（无压缩）

目录压缩不会跟随符号链接，目标 ZIP 也不能位于源目录内部。

ZIP 文件检测

boolean isZip = ZipHelper.isZipFile("unknown.zip");

检测通过打开并校验 ZIP 结构完成，因此也支持合法的空 ZIP。文件不存在、路径是目录或压缩包损坏时 返回 false。

目录创建

ZipHelper.initFolder("C:/new/path/file.txt"); // 如果需要则创建 C:/new/path

压缩方法

该类支持两种压缩方法：

1. DEFLATED（默认） - 标准 ZIP 压缩
2. STORED - 无压缩，文件按原样存储

错误处理

IO 失败会抛出 UncheckedIOException，参数错误会抛出 IllegalArgumentException。压缩先写入临时文件，完整成功后才发布目标。

结论

ZipHelper 类提供了全面的实用方法，用于处理 ZIP 文件，使 Java 应用程序中的压缩和解压缩操作更加方便。