zip4j -- Java处理zip压缩文件的开源项目

jopen 10年前

zip4j的功能是非常强大的,完全可以利用其写个类似于好压的zip文件管理软件。zip4j默认采用UTF-8编码,所以它支持中文,同时也支持密码,而且支持多种压缩算法,可以说功能强大,但使用起来却非常简单。

Key features(主要特性):

  • Create, Add, Extract, Update, Remove files from a Zip file
    针对ZIP压缩文件创建、添加、抽出、更新和移除文件
  • Read/Write password protected Zip files
    (读写有密码保护的Zip文件)
  • Supports AES 128/256 Encryption
    (支持AES 128/256算法加密)
  • Supports Standard Zip Encryption
    (支持标准Zip算法加密)
  • Supports Zip64 format
    (支持zip64格式)
  • Supports Store (No Compression) and Deflate compression method
    (支持Store(非压缩)和Deflate压缩方法---不太明白)
  • Create or extract files from Split Zip files (Ex: z01, z02,...zip)
    (针对分块zip文件创建和抽出文件)
  • Supports Unicode file names
    (支持Unicode编码文件名)
  • Progress Monitor
    (进度监控)
import java.io.File;    import java.util.ArrayList;    import java.util.Collections;    import java.util.List;        import org.apache.commons.lang3.StringUtils;        import net.lingala.zip4j.core.ZipFile;    import net.lingala.zip4j.exception.ZipException;    import net.lingala.zip4j.model.FileHeader;    import net.lingala.zip4j.model.ZipParameters;    import net.lingala.zip4j.util.Zip4jConstants;        /**    * ZIP压缩文件操作工具类    * 支持密码    * 依赖zip4j开源项目(http://www.lingala.net/zip4j/)    * 版本1.3.1    * @author ninemax    */    public class CompressUtil {                /**        * 使用给定密码解压指定的ZIP压缩文件到指定目录        * <p>        * 如果指定目录不存在,可以自动创建,不合法的路径将导致异常被抛出        * @param zip 指定的ZIP压缩文件        * @param dest 解压目录        * @param passwd ZIP文件的密码        * @return 解压后文件数组        * @throws ZipException 压缩文件有损坏或者解压缩失败抛出        */        public static File [] unzip(String zip, String dest, String passwd) throws ZipException {            File zipFile = new File(zip);            return unzip(zipFile, dest, passwd);        }                /**        * 使用给定密码解压指定的ZIP压缩文件到当前目录        * @param zip 指定的ZIP压缩文件        * @param passwd ZIP文件的密码        * @return  解压后文件数组        * @throws ZipException 压缩文件有损坏或者解压缩失败抛出        */        public static File [] unzip(String zip, String passwd) throws ZipException {            File zipFile = new File(zip);            File parentDir = zipFile.getParentFile();            return unzip(zipFile, parentDir.getAbsolutePath(), passwd);        }                /**        * 使用给定密码解压指定的ZIP压缩文件到指定目录        * <p>        * 如果指定目录不存在,可以自动创建,不合法的路径将导致异常被抛出        * @param zip 指定的ZIP压缩文件        * @param dest 解压目录        * @param passwd ZIP文件的密码        * @return  解压后文件数组        * @throws ZipException 压缩文件有损坏或者解压缩失败抛出        */        public static File [] unzip(File zipFile, String dest, String passwd) throws ZipException {            ZipFile zFile = new ZipFile(zipFile);            zFile.setFileNameCharset("GBK");            if (!zFile.isValidZipFile()) {                throw new ZipException("压缩文件不合法,可能被损坏.");            }            File destDir = new File(dest);            if (destDir.isDirectory() && !destDir.exists()) {                destDir.mkdir();            }            if (zFile.isEncrypted()) {                zFile.setPassword(passwd.toCharArray());            }            zFile.extractAll(dest);                        List<FileHeader> headerList = zFile.getFileHeaders();            List<File> extractedFileList = new ArrayList<File>();            for(FileHeader fileHeader : headerList) {                if (!fileHeader.isDirectory()) {                    extractedFileList.add(new File(destDir,fileHeader.getFileName()));                }            }            File [] extractedFiles = new File[extractedFileList.size()];            extractedFileList.toArray(extractedFiles);            return extractedFiles;        }                /**        * 压缩指定文件到当前文件夹        * @param src 要压缩的指定文件        * @return 最终的压缩文件存放的绝对路径,如果为null则说明压缩失败.        */        public static String zip(String src) {            return zip(src,null);        }                /**        * 使用给定密码压缩指定文件或文件夹到当前目录        * @param src 要压缩的文件        * @param passwd 压缩使用的密码        * @return 最终的压缩文件存放的绝对路径,如果为null则说明压缩失败.        */        public static String zip(String src, String passwd) {            return zip(src, null, passwd);        }                /**        * 使用给定密码压缩指定文件或文件夹到当前目录        * @param src 要压缩的文件        * @param dest 压缩文件存放路径        * @param passwd 压缩使用的密码        * @return 最终的压缩文件存放的绝对路径,如果为null则说明压缩失败.        */        public static String zip(String src, String dest, String passwd) {            return zip(src, dest, true, passwd);        }                /**        * 使用给定密码压缩指定文件或文件夹到指定位置.        * <p>        * dest可传最终压缩文件存放的绝对路径,也可以传存放目录,也可以传null或者"".<br />        * 如果传null或者""则将压缩文件存放在当前目录,即跟源文件同目录,压缩文件名取源文件名,以.zip为后缀;<br />        * 如果以路径分隔符(File.separator)结尾,则视为目录,压缩文件名取源文件名,以.zip为后缀,否则视为文件名.        * @param src 要压缩的文件或文件夹路径        * @param dest 压缩文件存放路径        * @param isCreateDir 是否在压缩文件里创建目录,仅在压缩文件为目录时有效.<br />        * 如果为false,将直接压缩目录下文件到压缩文件.        * @param passwd 压缩使用的密码        * @return 最终的压缩文件存放的绝对路径,如果为null则说明压缩失败.        */        public static String zip(String src, String dest, boolean isCreateDir, String passwd) {            File srcFile = new File(src);            dest = buildDestinationZipFilePath(srcFile, dest);            ZipParameters parameters = new ZipParameters();            parameters.setCompressionMethod(Zip4jConstants.COMP_DEFLATE);           // 压缩方式            parameters.setCompressionLevel(Zip4jConstants.DEFLATE_LEVEL_NORMAL);    // 压缩级别            if (!StringUtils.isEmpty(passwd)) {                parameters.setEncryptFiles(true);                parameters.setEncryptionMethod(Zip4jConstants.ENC_METHOD_STANDARD); // 加密方式                parameters.setPassword(passwd.toCharArray());            }            try {                ZipFile zipFile = new ZipFile(dest);                if (srcFile.isDirectory()) {                    // 如果不创建目录的话,将直接把给定目录下的文件压缩到压缩文件,即没有目录结构                    if (!isCreateDir) {                        File [] subFiles = srcFile.listFiles();                        ArrayList<File> temp = new ArrayList<File>();                        Collections.addAll(temp, subFiles);                        zipFile.addFiles(temp, parameters);                        return dest;                    }                    zipFile.addFolder(srcFile, parameters);                } else {                    zipFile.addFile(srcFile, parameters);                }                return dest;            } catch (ZipException e) {                e.printStackTrace();            }            return null;        }                /**        * 构建压缩文件存放路径,如果不存在将会创建        * 传入的可能是文件名或者目录,也可能不传,此方法用以转换最终压缩文件的存放路径        * @param srcFile 源文件        * @param destParam 压缩目标路径        * @return 正确的压缩文件存放路径        */        private static String buildDestinationZipFilePath(File srcFile,String destParam) {            if (StringUtils.isEmpty(destParam)) {                if (srcFile.isDirectory()) {                    destParam = srcFile.getParent() + File.separator + srcFile.getName() + ".zip";                } else {                    String fileName = srcFile.getName().substring(0, srcFile.getName().lastIndexOf("."));                    destParam = srcFile.getParent() + File.separator + fileName + ".zip";                }            } else {                createDestDirectoryIfNecessary(destParam);  // 在指定路径不存在的情况下将其创建出来                if (destParam.endsWith(File.separator)) {                    String fileName = "";                    if (srcFile.isDirectory()) {                        fileName = srcFile.getName();                    } else {                        fileName = srcFile.getName().substring(0, srcFile.getName().lastIndexOf("."));                    }                    destParam += fileName + ".zip";                }            }            return destParam;        }                /**        * 在必要的情况下创建压缩文件存放目录,比如指定的存放路径并没有被创建        * @param destParam 指定的存放路径,有可能该路径并没有被创建        */        private static void createDestDirectoryIfNecessary(String destParam) {            File destDir = null;            if (destParam.endsWith(File.separator)) {                destDir = new File(destParam);            } else {                destDir = new File(destParam.substring(0, destParam.lastIndexOf(File.separator)));            }            if (!destDir.exists()) {                destDir.mkdirs();            }        }            public static void main(String[] args) {            zip("d:\\test\\cc", "d:\\test\\cc.zip", "11");    //      try {    //          File[] files = unzip("d:\\test\\汉字.zip", "aa");    //          for (int i = 0; i < files.length; i++) {    //              System.out.println(files[i]);    //          }    //      } catch (ZipException e) {    //          e.printStackTrace();    //      }        }    }  

项目主页:http://www.open-open.com/lib/view/home/1409559898197