JAVA使用Zip工具包压缩文件为zip格式（3）——文件、文件夹压缩

JAVA使用Zip工具包压缩文件为zip格式（3）——文件、文件夹压缩

一、使用场景概述

将文件压缩为zip格式的需求，避免踩坑，这篇文章教大家如何使用java.util.zip与java-io进行文件夹的压缩。
本章仅适用于单个、多个文件、文件夹等多个场景的压缩，点个关注，不迷路哦！
单个文件压缩，请参考：Java单文件zip压缩

二、准备工作

• 开发环境
  java 1.8
  springboot2.0版本
  maven
• 相关依赖
  jdk 1.8提供

三、具体实现

涉及的主要类：ZipOutputStream（压缩文件流处理类）
处理多个文件压缩，核心思想还是基于单个文件压缩，但对于文件夹的操作逻辑处理要相对复杂一些，本文采用递归方式，对文件夹进行压缩处理，其中非常有可能出现的几个问题，在文章中会做出详细讲解。

1. 实现代码

1.1 方法说明

• pathToZipFile（）：如果目标位置不存在的情况，该方法首先创建目标路径，然后调用toZipFile方法进行压缩文件
• toZipFile方法（）：对目标文件或者文件夹进行递归压缩

1.2 完整代码

import java.io.*;
import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;

/**
 * @author getao
 * @date 2022/7/1 16:31
 */
public class ZipUtils {
    
    /**
     * 压缩文件为ZIP格式---通用
     * @param sourcePath 源文件路径，可以使文件获文件夹
     * @param targetPath 压缩目标路径，如：C:/zip/target.zip
     */
    public static void pathToZipFile(String sourcePath, String targetPath) {
        File sourceFile = new File(sourcePath);
        File targetFile = new File(targetPath);
        // 如果目标压缩位置不存在，则创建
        if (!targetFile.getParentFile().exists()) {
            targetFile.getParentFile().mkdir();
        }
        // 进行压缩处理
        try {
            FileOutputStream outputStream = new FileOutputStream(targetFile);
            ZipOutputStream zipOutputStream = new ZipOutputStream(outputStream);
            /*
             *  调用压缩方法，这个方法关键在于判定当前操作的文件对象是File还是Directory
             *  如果是文件，直接写入Zip输出流，如果是文件夹，将当前文件夹写入压缩流中，在进
             *  行其中的文件流写入
             */
            toZipFile(sourceFile, sourceFile.getName(), zipOutputStream);
            zipOutputStream.close();
            outputStream.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 执行路径压缩
     * @param sourceFile
     * @param fileName 当前操作文件名称，建议以参数形式传入
     * @param zipOutputStream
     */
    public static void toZipFile(File sourceFile, String fileName, ZipOutputStream zipOutputStream) {
        try {
            // 如果是一个文件夹
            if (sourceFile.isDirectory()) {
                // 将文件夹路径写入压缩流中，否则文件将会在同一级目录中压缩
                if (fileName.endsWith("/")) {
                    zipOutputStream.putNextEntry(new ZipEntry(fileName));
                    zipOutputStream.closeEntry();
                } else {
                    zipOutputStream.putNextEntry(new ZipEntry(fileName+"/"));
                    zipOutputStream.closeEntry();
                }
                // 递归调用
                File[] files = sourceFile.listFiles();
                for (File file : files) {
                    toZipFile(file, fileName+"/"+file.getName(), zipOutputStream);
                }
                // 表示当前文件夹已经处理完成，直接结束本次递归
                return;
            }
            // 如果是一个文件，调用前一章中封装的方法进行压缩
            FileInputStream inputStream = null;
            ZipEntry zipEntry = new ZipEntry(fileName);
            zipOutputStream.putNextEntry(zipEntry);
            inputStream = new FileInputStream(sourceFile);
            byte[] buffer = new byte[1024];
            int len = 0;
            while ((len=inputStream.read(buffer)) >=0 ) {
                zipOutputStream.write(buffer, 0, len);
            }
            inputStream.close();
            zipOutputStream.closeEntry();
            zipOutputStream.flush();
            System.out.println("文件：" + sourceFile.getAbsolutePath() + "压缩成功啦！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

	// 可使用如下代码测试
	public static void main(String[] args) throws IOException, FileNotFoundException {
	        // 多文件、单文件、文件夹通用压缩
	        // 源文件路径
	        String sourcePath = "你的文件/文件夹路径";
	        // 压缩路径
	        String targetPath = "压缩位置路径";
	        // 调用压缩方法
	        pathToZipFile(sourcePath, targetPath);
	        System.out.println("文件夹压缩：" + sourcePath + "执行压缩成功!!!");
	    }
}

2. 测试结果

叮~亲测有效，到你的压缩位置看下，文件可以正常解压并浏览，大功告成！！！

文件：C:\Users\ge\Desktop\james\James阿萨德加福利卡 - 副本\java.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\James阿萨德加福利卡 - 副本\s3afn5yfm2222jj.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\James阿萨德加福利卡 - 副本\s3afn5yfmjj.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\James阿萨德加福利卡 - 副本\新建 XLS 工作表 (2).txt压缩成功啦！
文件：C:\Users\ge\Desktop\james\James阿萨德加福利卡 - 副本\新建文件夹\abc.txt压缩成功啦！
文件：C:\Users\ge\Desktop\james\James阿萨德加福利卡 - 副本\新建文件夹\新建 XLS 工作表.xls压缩成功啦！
文件：C:\Users\ge\Desktop\james\java.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\s3afn5yfm2222jj.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\s3afn5yfmjj.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\s3afn5yfm的沙发萨芬撒地方撒范德萨发撒方式jj.jpg压缩成功啦！
文件：C:\Users\ge\Desktop\james\t0189f3b317e2f04bcd.jpg压缩成功啦！
文件夹压缩：C:\Users\ge\Desktop\james执行压缩成功!!!

Process finished with exit code 0

3. 问题解析，避免踩坑

3.1 文件拒绝访问问题

java.io.FileNotFoundException: C:\Users\getao\Desktop\james\James阿萨德加福利卡 - 副本\新建文件夹 (拒绝访问。)

如果在处理文件过程中出现这个问题，是因为当前处理文件路径是一个文件夹，在FileInputStream处理过程中，是不能解析一个文件夹为输出流的，所以首先应该去排除处理过程中误把文件夹当做文件处理。

3.2 压缩文件打不开或提示不可预料的压缩文件末端问题

路径压缩过后，出现压缩文件打不开或提示不可预料的压缩文件末端情况，出现这种情况的原因，大多是因为文件流处理过程中，各种文件输入输出流，资源释放不正确所导致，可能是释放顺序不正确或者资源释放不完整导致，解决资源使用过后的释放问题，问题迎刃而解，这个每个人情况不同，大家根据自身需求处理即可。

如果有其他好的想法，欢迎评论区交流。