如何列出格式並取得 GroupDocs.Conversion for Java 的所有可能轉換

在許多文件處理專案中，第一步是了解 如何列出格式，即轉換引擎支援的格式。本教學將逐步示範如何查詢 GroupDocs.Conversion for Java，取得每個來源至目標的配對，並將此知識應用於雲端儲存檔案轉換流程。完成後，您將擁有一個可重用的方法，返回完整的轉換矩陣，並提供效能與錯誤處理的實用技巧。

快速解答

  • 「列出格式」是什麼意思？ 它會返回庫能處理的每個來源至目標的轉換配對。
  • 我需要授權嗎？ 免費試用可用於測試；正式環境需購買授權。
  • 這能協助雲端儲存檔案轉換嗎？ 是的——了解支援的格式可讓您在雲端儲存流程中自動化轉換。
  • 需要哪個 Java 版本？ JDK 8 或更新版本。
  • 此功能是執行緒安全的嗎？ Converter 實例可在多執行緒間重複使用，但使用後需釋放資源。

在 GroupDocs.Conversion 中「如何列出格式」是什麼？

列出格式 操作會返回一個集合，描述每個來源格式以及它可轉換的目標格式。此矩陣由庫內部的轉換規則生成，對於構建能在執行時依實際能力調整的動態工作流程至關重要。

為什麼要使用 GroupDocs.Conversion for Java？

GroupDocs.Conversion for Java 支援 200 多種輸入格式 與 200 多種輸出格式，涵蓋從 DOCX、PPTX 到 PDF/A 以及各類影像。它完全在伺服器上執行，無需 Microsoft Office 或 Adobe 產品。API 為執行緒安全，可在不將整個檔案載入記憶體的情況下處理數百頁的文件，並能無縫整合 AWS S3、Azure Blob 與 Google Cloud Storage 等雲端儲存服務。

前置條件

  • Java Development Kit (JDK)： 8 版或更新版本。
  • Maven： 在您的 IDE（IntelliJ IDEA、Eclipse、NetBeans 等）中正確設定。
  • GroupDocs.Conversion for Java： 已作為 Maven 依賴加入（見下文）。

設定 GroupDocs.Conversion for Java

Add the GroupDocs repository and dependency to your pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

取得授權

先使用免費試用版探索 API。對於正式環境，請購買授權或申請臨時評估授權。

基本初始化與設定

import com.groupdocs.conversion.Converter;

public class ConversionSetup {
    public static void main(String[] args) {
        // Initialize the Converter object
        Converter converter = new Converter();
        
        System.out.println("GroupDocs.Conversion for Java has been initialized successfully.");
    }
}

如何使用 GroupDocs.Conversion for Java 列出格式

Converter 是執行轉換並提供格式資訊的核心類別。getAllPossibleConversions() 會返回所有支援的來源至目標轉換配對列表。ConversionInfo 代表來源與目標格式之間的單一轉換映射。

載入 Converter 引擎，呼叫 getAllPossibleConversions()，即可取得描述每個允許的來源至目標配對的 ConversionInfo 物件清單。只需一次呼叫，即可建立匯出選項下拉式選單、驗證上傳檔案，或設計批次遷移腳本。

初始化並取得轉換清單

The Converter class is the core engine that provides conversion capabilities and exposes the getAllPossibleConversions() method.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;

public class GetAllPossibleConversionsFeature {
    public static void run() {
        // Initialize the Converter object
        Converter converter = new Converter();

迭代可能的轉換

// Retrieve all possible conversions supported by the library
for (PossibleConversions conversions : converter.getAllPossibleConversions()) {
    // Print source format description
    System.out.print(String.format("Source format: %s \n", conversions.getSource().getDescription()));

判斷轉換類型

// Iterate through each target conversion available for the source format
for (TargetConversion conversion : conversions.getAll()) {
    // Determine if it's a primary or secondary conversion and print details
    System.out.print(String.format("\t...can be converted to %s format as %s conversion.\n",
            conversion.getFormat(),
            conversion.isPrimary() ? "primary" : "secondary"));
}

完整函式

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;
import com.groupdocs.conversion.contracts.TargetConversion;

public class GetAllPossibleConversionsFeature {
    public static void run() {
        // Initialize the Converter object
        Converter converter = new Converter();

        // Retrieve all possible conversions supported by the library
        for (PossibleConversions conversions : converter.getAllPossibleConversions()) {
            // Print source format description
            System.out.print(String.format("Source format: %s \n", conversions.getSource().getDescription()));

            // Iterate through each target conversion available for the source format
            for (TargetConversion conversion : conversions.getAll()) {
                // Determine if it's a primary or secondary conversion and print details
                System.out.print(String.format("\t...can be converted to %s format as %s conversion.\n",
                        conversion.getFormat(),
                        conversion.isPrimary() ? "primary" : "secondary"));
            }
        }
    }
}

雲端儲存檔案轉換使用案例

了解完整的轉換矩陣在構建 雲端儲存檔案轉換 服務時尤其有價值：

  1. 動態格式偵測： 當檔案進入雲端儲存時，您可以立即查詢所需的目標格式是否受支援。
  2. 批次遷移： 透過遍歷支援的來源類型，將大型文件庫移轉為統一格式（例如 PDF/A）。
  3. 使用者導向匯出： 提供最終使用者僅能匯出其當前文件的格式下拉選單，減少錯誤並提升使用者體驗。

效能考量

  • 資源管理： 釋放 Converter 實例，或在建立大量短暫的轉換器時使用 try‑with‑resources。
  • 批次處理： 將多個檔案合併為單一作業以減少開銷。
  • 快取： 若頻繁查詢 getAllPossibleConversions()，可將其結果快取；轉換矩陣在執行時很少變動。

常見問題與解決方案

症狀可能原因解決方式
未出現輸出Converter 未正確初始化確保庫的 JAR 已在 classpath 中，且已載入授權。
TargetConversion 列表為空使用過時的庫版本升級至最新的 GroupDocs.Conversion 版本。
大型文件記憶體激增未釋放轉換器資源呼叫 converter.close() 或使用 try‑with‑resources。

常見問答

Q: GroupDocs.Conversion for Java 是什麼？
A: 它是一個伺服器端的函式庫，支援 200 多種輸入與 200 多種輸出格式，提供快速、免授權的文件轉換，無需外部軟體。

Q: 如何開始使用 GroupDocs.Conversion？
A: 設定您的 Maven 專案，加入前述的依賴，載入授權檔，並依初始化章節示範建立 Converter 類別實例。

Q: 我可以使用 GroupDocs.Conversion 轉換自訂檔案類型嗎？
A: 可以——透過 API 的擴充點，您可以註冊自訂轉換器或外掛第三方處理器，以支援專有格式。

Q: 實作轉換時常見的陷阱是什麼？
A: 忘記關閉 Converter、使用舊版 JAR，或忽視大型 PDF 的記憶體使用。請遵循上述資源管理建議。

Q: 我可以在哪裡取得更多協助？
A: 請造訪官方 documentation 或在 GroupDocs 社群論壇提問。

最後更新： 2026-07-29
測試環境： GroupDocs.Conversion 25.2 for Java
作者： GroupDocs

相關教學