如何使用 GroupDocs.Metadata 提取 TAR 元資料（Java）

在本教學中，您將學習 如何使用 Java 提取 TAR 元資料，透過 GroupDocs.Metadata 函式庫。完成本指南後，您將能夠讀取 .tar 壓縮檔，列舉每個項目，並提取檔案層級的資訊，如名稱、大小和時間戳記——只需幾行 Java 程式碼。

快速解答

• 什麼函式庫可在 Java 中處理 TAR 元資料？ GroupDocs.Metadata for Java
• 基本實作需要多長時間？ 約 10–15 分鐘
• 我需要授權嗎？ 免費試用或臨時授權可用於評估；正式環境需購買授權
• 我可以處理大型 TAR 檔案嗎？ 可以，但請釋放 Metadata 物件以釋放資源
• 這與讀取 .tar.gz 相同嗎？ 您需要先解壓縮 .gz，然後使用相同的方法

如何使用 GroupDocs.Metadata for Java 提取 TAR 元資料（Java）？

Metadata 類別提供高階 API 以讀取壓縮檔資訊。使用 Metadata 實例載入 TAR 檔案，存取根套件，遍歷每個項目，並讀取所需屬性。此簡潔流程讓您在不自行編寫低階解析邏輯的情況下，提取所有元資料。

直接答案： 建立指向 .tar 檔案的 Metadata 物件，呼叫 getRootPackage() 取得壓縮檔的套件，然後遍歷 getEntries() 讀取每個項目的名稱、大小與時間戳記。最後，呼叫 metadata.dispose() 釋放原生資源。整個流程通常不超過十行程式碼。

為何選擇 GroupDocs.Metadata？

GroupDocs.Metadata 支援 超過 30 種壓縮檔與文件格式，包括 TAR、ZIP、RAR 與 7z，且可在 多達 10,000 個項目 的壓縮檔中處理，而不將整個檔案載入記憶體。其跨平台 Java 執行環境可在 Windows、Linux 與 macOS 上運行，提供內建錯誤處理與資源管理，簡化 如何大規模讀取 tar 檔案的流程。

前置條件

• Java Development Kit (JDK) 8 或更新版本
• 用於相依管理的 Maven
• GroupDocs.Metadata for Java 24.12 或更新版本 – 可從官方發行頁面下載最新版本

設定 GroupDocs.Metadata for Java

將儲存庫與相依項目加入您的 pom.xml：

Metadata 類別是讀取壓縮檔資訊的入口點。

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/metadata/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-metadata</artifactId>
      <version>24.12</version>
   </dependency>
</dependencies>

直接下載： 或者，從 GroupDocs.Metadata for Java releases 下載最新版本。

取得授權步驟

先使用免費試用或向 GroupDocs 網站申請臨時授權。這讓您在開發期間無限制地探索所有功能。

基本初始化與設定

當函式庫可用後，您可以建立指向 TAR 檔案的 Metadata 實例：

建構子 new Metadata("path/to/archive.tar") 會將壓縮檔的元資料載入記憶體。

import com.groupdocs.metadata.Metadata;
import com.groupdocs.metadata.core.TarFile;
import com.groupdocs.metadata.core.TarRootPackage;

public class TarMetadataExample {
    public static void main(String[] args) {
        Metadata metadata = new Metadata("path/to/your/input.tar");
        
        try {
            // Perform operations with metadata
        } finally {
            if (metadata != null) {
                metadata.dispose();
            }
        }
    }
}

實作指南

從 TAR 壓縮檔讀取元資料

初始化 metadata 物件

使用您的 .tar 檔案路徑建立 Metadata 實例。

Metadata 物件抽象化低階 TAR 解析邏輯，提供高階 API 供您使用。

Metadata metadata = new Metadata("YOUR_DOCUMENT_DIRECTORY/input.tar");

為什麼： 此步驟會準備好物件，使您能存取壓縮檔的內部結構，這是 如何讀取 tar 檔案的基礎。

存取根套件

取得根套件以操作 TAR 壓縮檔的內容：

根套件代表壓縮檔的頂層容器，並提供列舉其項目的方法。

TarRootPackage root = metadata.getRootPackageGeneric();

此呼叫對於導覽壓縮檔的層級結構至關重要。

取得總項目數

確定壓縮檔包含多少項目（檔案/資料夾）：

rootPackage.getEntries().size() 會回傳精確的計數，讓您能預先配置資源或顯示進度。

int totalEntries = root.getTarPackage().getTotalEntries();
System.out.println("Total Entries: " + totalEntries);

說明： 瞭解項目數量有助於規劃迴圈並驗證壓縮檔的完整性。

逐一遍歷每個檔案項目

TarFile 類別代表 TAR 壓縮檔內的單一檔案項目。
每個 TarFile 物件會公開如 getFileName()、getSize() 與 getModifiedTime() 等屬性。

for (TarFile file : root.getTarPackage().getFiles()) {
    String fileName = file.getName();
    long fileSize = file.getSize();
    System.out.println("File Name: " + fileName);
    System.out.println("File Size: " + fileSize);
}

為什麼： 個別處理每個檔案可取得細緻的元資料，這通常在報告、遷移或備份驗證時需要。

疑難排解技巧

• 常見問題： 抽取失敗 – 請再次確認檔案路徑，並確保 Java 程序能讀取該 TAR 檔案。
• 效能提示： 完成後務必呼叫 metadata.dispose() 釋放原生資源，特別是在處理大型壓縮檔時。

實務應用

1. 資料遷移： 在系統間搬移資料前驗證檔案數量與大小。
2. 備份解決方案： 產生清單報告，以確認備份壓縮檔中的每個檔案皆已列入。
3. 內容管理系統（CMS）： 為儲存的資產加入 TAR 級別的元資料，以提升搜尋與組織效能。

效能考量

處理大型壓縮檔時：

• 及時釋放物件以避免記憶體洩漏。
• 若需在不將整個列表載入記憶體的情況下處理項目，可利用 Java 的串流 API。

結論

您現在已掌握使用 GroupDocs.Metadata for Java 提取 tar 元資料（Java） 的完整端對端方法。此功能可整合至遷移工具、備份工具，或任何需要了解壓縮檔內容的 Java 系統中。

下一步： 探索 GroupDocs.Metadata API 中的其他類別，例如 TarFile 的時間戳記或權限屬性，以進一步豐富您的元資料抽取工作流程。

常見問答

Q: 從 TAR 檔案抽取元資料的主要使用情境是什麼？
A: 元資料抽取有助於檔案管理工作，如驗證、備份與遷移。

Q: 我能從壓縮的 .tar.gz 檔案抽取元資料嗎？
A: GroupDocs.Metadata 支援多種壓縮格式；您需要先解壓縮 .gz 層。

Q: 單一 TAR 壓縮檔可處理的檔案數量有上限嗎？
A: 此函式庫能有效處理大型壓縮檔，但整體效能仍取決於系統資源。

Q: 我該如何正確釋放 metadata 物件？
A: 在操作完成後呼叫 metadata.dispose() 以釋放原生資源。

Q: 我可以在哪裡取得更多關於 GroupDocs.Metadata 的資訊或支援？
A: 前往 GroupDocs Metadata Java Docs 並加入其社群論壇以獲得支援。

其他問答

Q: GroupDocs.Metadata 是否同時支援 Windows 與 Linux 環境？
A: 是的，Java 函式庫與平台無關，只要安裝相容的 JDK 即可執行。

Q: 我能從 TAR 項目取得檔案時間戳記（建立/修改）嗎？
A: TarFile 類別提供對標準 TAR 標頭欄位的存取，包括時間戳記。

Q: 我該如何處理受密碼保護的壓縮檔？
A: 對於加密壓縮檔，於建構 Metadata 物件時提供密碼（請參考 API 文件取得正確的重載方式）。

資源

• 文件說明： GroupDocs Metadata Java Docs
• API 參考： GroupDocs API Reference
• 下載： GroupDocs Releases
• GitHub： GroupDocs Metadata on GitHub
• 免費支援： GroupDocs Forum
• 臨時授權： Get a Temporary License

最後更新： 2026-09-06
測試版本： GroupDocs.Metadata for Java 24.12
作者： GroupDocs

相關教學

• 如何使用 GroupDocs.Metadata 提取 zip 註解（Java） – 指南
• 更新 Zip 壓縮檔註解 Groupdocs Metadata Java
• 如何使用 GroupDocs.Metadata for Java 抽取元資料 – 教學與範例