C++解壓庫接口設計

設計一個C++解壓庫接口需要考慮以下幾個方面：

1. 庫的基本結構：定義頭文件和源文件。
2. 解壓算法接口：提供常見的解壓算法接口。
3. 錯誤處理：定義錯誤碼和錯誤處理函數。
4. 配置選項：提供一些可配置的參數。
5. 測試和示例：提供一些測試用例和示例代碼。

下面是一個簡單的示例，展示了如何設計一個基本的C++解壓庫接口。

1. 庫的基本結構

頭文件 (unzip.h)

#ifndef UNZIP_H
#define UNZIP_H

#include <string>
#include <vector>
#include <stdexcept>

class Unzip {
public:
    enum class ErrorCode {
        SUCCESS,
        FILE_NOT_FOUND,
        INVALID_FORMAT,
        DECODING_ERROR,
        // 其他錯誤碼...
    };

    Unzip();
    ~Unzip();

    ErrorCode extract(const std::string& zipFilePath, const std::string& destDirectory);

private:
    struct Impl;
    Impl* pimpl;
};

#endif // UNZIP_H

源文件 (unzip.cpp)

#include "unzip.h"
#include <iostream>
#include <fstream>
#include <sstream>
#include <vector>
#include <zip.h> // 使用libzip庫

struct Unzip::Impl {
    zip_t* zipFile;
};

Unzip::Unzip() : pimpl(new Impl) {
    zipFile = zip_open(nullptr, 0, nullptr);
    if (!zipFile) {
        throw std::runtime_error("Failed to open zip file");
    }
}

Unzip::~Unzip() {
    if (zipFile) {
        zip_close(zipFile);
    }
    delete pimpl;
}

Unzip::ErrorCode extract(const std::string& zipFilePath, const std::string& destDirectory) {
    if (zip_file_exists(zipFile, zipFilePath.c_str()) != 0) {
        return ErrorCode::FILE_NOT_FOUND;
    }

    int ret = zip_open_file_full(zipFile, zipFilePath.c_str(), 0, nullptr);
    if (ret < 0) {
        return ErrorCode::INVALID_FORMAT;
    }

    zip_file* zf = zip_fopen_index(zipFile, 0);
    if (!zf) {
        zip_close(zipFile);
        return ErrorCode::DECODING_ERROR;
    }

    std::string destPath = destDirectory;
    if (!destPath.empty() && !destPath.back().is_directory()) {
        destPath += "/";
    }

    while (*zf) {
        zip_uint64_t len;
        const char* filename = zip_get_name(zf, &len);
        if (!filename) {
            zip_fclose(zf);
            zip_close(zipFile);
            return ErrorCode::DECODING_ERROR;
        }

        std::string fullPath = destPath + filename;
        if (zip_file_exists(zipFile, fullPath.c_str())) {
            zip_delete(zipFile, filename);
            continue;
        }

        std::ofstream outFile(fullPath, std::ios::binary);
        if (!outFile) {
            zip_fclose(zf);
            zip_close(zipFile);
            return ErrorCode::DECODING_ERROR;
        }

        char buffer[1024];
        zip_int64_t read = zip_fread(zf, buffer, sizeof(buffer));
        while (read > 0) {
            outFile.write(buffer, read);
            read = zip_fread(zf, buffer, sizeof(buffer));
        }

        if (read < 0) {
            zip_fclose(zf);
            zip_close(zipFile);
            return ErrorCode::DECODING_ERROR;
        }

        zip_fclose(zf);
    }

    zip_close(zipFile);
    return ErrorCode::SUCCESS;
}

2. 使用示例

主程序 (main.cpp)

#include <iostream>
#include "unzip.h"

int main() {
    try {
        Unzip unzip;
        Unzip::ErrorCode result = unzip.extract("example.zip", "extracted_files");

        if (result == Unzip::ErrorCode::SUCCESS) {
            std::cout << "Extraction successful!" << std::endl;
        } else {
            std::cerr << "Extraction failed with error code: " << static_cast<int>(result) << std::endl;
        }
    } catch (const std::exception& e) {
        std::cerr << "Exception: " << e.what() << std::endl;
    }

    return 0;
}

3. 編譯和鏈接

確保你已經安裝了libzip庫，并使用以下命令編譯和鏈接：

g++ -o main main.cpp -lzip

4. 注意事項

• 錯誤處理：在實際應用中，可能需要更詳細的錯誤處理和日志記錄。
• 內存管理：確保在析構函數中正確關閉所有打開的資源。
• 擴展性：可以添加更多的解壓算法和配置選項。

這個示例提供了一個基本的解壓庫接口，你可以根據需要進一步擴展和優化。