/**
 * 下載指定文件夾及其所有文件的內容，并將其打包為 ZIP 文件。
 *
 * @param folderId 需要下載的文件夾 ID
 * @param response HTTP 響應對象，用于發(fā)送 ZIP 文件
 * @throws IOException 在處理輸入輸出時可能拋出異常
 */
public void downloadFolder(Integer folderId, HttpServletResponse response) throws IOException {
    // 校驗權限，檢查用戶是否有權限下載該文件夾
    Boolean isAuth = checkAuthService.checkAuthDownload(folderId);
    if (!isAuth) {
        // 如果沒有權限，則拋出業(yè)務異常
        throw new BusinessException(TipsConstant.Tips_6002);
    }

    // 查詢指定文件夾下的所有文件列表
    List<FileOrg> fileOrgList = getFileBeansByFolderId(folderId);
    // 獲取文件夾信息，用于設置 ZIP 文件的名稱
    FolderOrg folderOrg = folderOrgMappr.selectById(folderId);

    // 準備壓縮文件的數(shù)據(jù)
    try (ZipOutputStream zipOutputStream = new ZipOutputStream(response.getOutputStream())) {
        // 設置響應頭，準備發(fā)送 ZIP 文件
        prepareResponse(response, folderOrg.getName());
        // 將文件添加到 ZIP 壓縮包中
        addFilesToZip(zipOutputStream, fileOrgList, folderOrg.getName());
    } catch (IOException e) {
        // 如果發(fā)生錯誤，返回 500 錯誤和錯誤信息
        response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "Failed to download folder: " + e.getMessage());
    }
}

    @Override
    public void recursiveDownload(Integer folderId, HttpServletResponse response) throws IOException {
         // 校驗權限，檢查用戶是否有權限下載該文件夾
    Boolean isAuth = checkAuthService.checkAuthDownload(folderId);
    if (!isAuth) {
        // 如果沒有權限，則拋出業(yè)務異常
        throw new BusinessException(TipsConstant.Tips_6002);
    }

        // 獲取文件夾信息，用于設置 ZIP 文件的名稱
	    FolderOrg folderOrg = folderOrgMappr.selectById(folderId);

        // 準備壓縮文件的數(shù)據(jù)
        try (ZipOutputStream zipOutputStream = new ZipOutputStream(response.getOutputStream())) {
	        // 設置響應頭，準備發(fā)送 ZIP 文件
            prepareResponse(response, folderOrg.getName());
            // 遞歸調用將子文件夾及其文件添加到 ZIP
            addFolderToZip(zipOutputStream, folderId, folderOrg.getName());
        } catch (IOException e) {
            response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "Failed to download folder: " + e.getMessage());
        }
    }

/**
 * 準備 HTTP 響應，設置響應頭以便下載 ZIP 文件。
 *
 * @param response  HTTP 響應對象
 * @param folderName 文件夾名稱，用于生成 ZIP 文件的名稱
 * @throws IOException 在設置響應頭時可能拋出異常
 */
private void prepareResponse(HttpServletResponse response, String folderName) throws IOException {
    // 設置字符編碼
    response.setCharacterEncoding("UTF-8");
    // 設置下載文件的名稱，使用 URL 編碼以兼容特殊字符
    response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(folderName + ".zip", "UTF-8"));
    // 設置內容類型為 ZIP 文件
    response.setContentType("application/zip");
}

    /**
     * 遞歸處理文件夾及其子文件夾
     * 1.首先獲取當前文件夾的文件列表，并調用 addFilesToZip 方法將文件添加到 ZIP 中。
     * 2.然后獲取當前文件夾的子文件夾，并遞歸調用 addFolderToZip 方法處理每個子文件夾
     * @param zipOutputStream ZipOutputStream
     * @param folderId 文件夾ID
     * @throws IOException IO異常
     */
    private void addFolderToZip(ZipOutputStream zipOutputStream, Integer folderId, String parentFolderName) throws IOException {
        // 獲取當前文件夾的文件列表
        List<FileOrg> fileOrgList = getFileBeansByFolderId(folderId);

        // 將當前文件夾的文件添加到 ZIP
        addFilesToZip(zipOutputStream, fileOrgList,parentFolderName);

        // 獲取當前文件夾的子文件夾
        List<FolderOrg> subFolders = getSubFoldersByFolderId(folderId);
        for (FolderOrg subFolder : subFolders) {
            // 遞歸調用將子文件夾及其文件列表添加到 ZIP
            addFolderToZip(zipOutputStream, subFolder.getId(),parentFolderName + "/" + subFolder.getName());
        }
    }

    /**
     * 獲取指定文件夾下的所有子文件夾。
     * @param folderId 文件夾ID
     * @return List<FolderOrg>
     */
    private List<FolderOrg> getSubFoldersByFolderId(Integer folderId) {
        QueryWrapper<FolderOrg> queryWrapper = new QueryWrapper<>();
        queryWrapper.eq("deleted",0).eq("parent_id", folderId);
        List<FolderOrg> folderOrgs = folderOrgMappr.selectList(queryWrapper);
        return folderOrgs;
    }

/**
 * 根據(jù)文件夾 ID 獲取該文件夾下的所有文件信息。
 *
 * @param folderId 文件夾 ID
 * @return 文件組織列表，包含該文件夾下的所有文件信息
 */
private List<FileOrg> getFileBeansByFolderId(Integer folderId) {
    // 創(chuàng)建查詢條件，查找該文件夾下的所有文件鏈接
    QueryWrapper<FileLinkOrg> queryWrapper1 = new QueryWrapper<>();
    queryWrapper1.eq("folder_id", folderId);
    List<FileLinkOrg> fileLinkOrgList = fileLinkOrgMapper.selectList(queryWrapper1);
    
    // 如果沒有文件，返回空列表
    if (fileLinkOrgList.isEmpty()) {
        return new ArrayList<FileOrg>(0);
    }

    // 創(chuàng)建文件 ID 和名稱的映射關系
    HashMap<String, String> fileNameMap = new HashMap<>();
    fileLinkOrgList.forEach(item -> fileNameMap.put(item.getFileId(), item.getFileName()));

    // 獲取文件夾下所有文件的 ID
    ArrayList<String> fileIdList = new ArrayList<>(fileLinkOrgList.size());
    fileLinkOrgList.forEach(item -> fileIdList.add(item.getFileId()));

    // 根據(jù)文件 ID 查詢文件存儲信息
    QueryWrapper<FileOrg> queryWrapper2 = new QueryWrapper<>();
    queryWrapper2.in("id", fileIdList);
    List<FileOrg> fileOrgList = fileOrgMapper.selectList(queryWrapper2);

    // 更新文件組織列表中的文件名稱
    fileOrgList.forEach(item -> item.setFileName(fileNameMap.get(item.getId())));

    return fileOrgList;
}

/**
 * 將指定文件列表中的文件添加到 ZIP 輸出流中。
 *
 * @param zipOutputStream ZIP 輸出流
 * @param fileOrgList 文件組織列表，包含待添加的文件信息
 * @throws IOException 在處理輸入輸出時可能拋出異常
 */
private void addFilesToZip(ZipOutputStream zipOutputStream, List<FileOrg> fileOrgList,String parentFolderName) throws IOException {
    // 遍歷文件列表，將每個文件添加到 ZIP
    for (FileOrg fileOrg : fileOrgList) {
        try (InputStream inputStream = minioUtils.getObject(fileOrg.getBucketName(), fileOrg.getFilePath())) {
         	// 設置 ZIP 條目的路徑，包括文件夾名稱
            String zipEntryName = parentFolderName + "/" + fileOrg.getFileName();
            // 創(chuàng)建 ZIP 條目，使用文件名稱
            zipOutputStream.putNextEntry(new ZipEntry(zipEntryName));
            byte[] buffer = new byte[2048];
            int length;
            // 讀取文件內容并寫入 ZIP 輸出流
            while ((length = inputStream.read(buffer)) > 0) {
                zipOutputStream.write(buffer, 0, length);
            }
            // 關閉當前 ZIP 條目
            zipOutputStream.closeEntry();
        } catch (Exception e) {
            // 記錄異常信息，繼續(xù)處理其他文件
            log.info("-------------------- 打包ZIP下載異常: {}--------------------", e.getMessage());
        }
    }
}