使用 GroupDocs.Conversion 在 Java 中將 Excel 轉換為 PDF 並進行字體替換

介紹

將 Excel 電子表格轉換為 PDF 時，保持一致的排版可能相當具有挑戰性。本指南示範如何使用 GroupDocs.Conversion for Java 可無縫將 Excel 檔案轉換為 PDF，並包含字體替換功能。非常適合專注於文件管理解決方案或自動化報告產生的開發人員和業務專業人員。

您將學到什麼：

  • 設定並使用 Java 的 GroupDocs.Conversion。
  • 在 Excel 到 PDF 的轉換過程中取代字體。
  • 配置設定以優化轉換。
  • 解決常見問題。

讓我們繼續討論開始之前所需的先決條件。

先決條件

在實現程式碼之前，請確保您已具備以下條件：

所需的庫和依賴項

確保您擁有 GroupDocs.Conversion 庫版本 25.2 或更高版本，可以使用 Maven 進行管理。

環境設定要求

  • 您的機器上安裝了 Java 開發工具包 (JDK)。
  • 用於編寫和運行 Java 程式碼的 IDE，例如 IntelliJ IDEA 或 Eclipse。

知識前提

了解 Java 程式設計、透過 Maven 管理函式庫以及檔案轉換概念將大有裨益，但並非絕對必要。現在，讓我們繼續在專案中設定 GroupDocs.Conversion。

為 Java 設定 GroupDocs.Conversion

使用 GroupDocs.轉換 若要將 Excel 轉換為 PDF，請依照下列步驟操作：

Maven配置

首先，將必要的儲存庫和依賴項資訊新增至您的 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>

許可證獲取

取得臨時執照 群組文檔 以便在評估期間可以完全存取功能。

基本初始化和設定

配置 Maven 後，在 Java 應用程式中初始化 GroupDocs.Conversion：

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertExcelToPDF {
    public static void main(String[] args) {
        String inputDocument = "sample.xlsx";
        String convertedFile = "output.pdf";

        // 使用文件路徑初始化 Converter 對象
        Converter converter = new Converter(inputDocument);

        PdfConvertOptions options = new PdfConvertOptions();
        
        // 執行轉換
        converter.convert(convertedFile, options);
    }
}

實施指南

本節介紹如何將 Excel 檔案轉換為 PDF 並取代字體。當原始字體不可用時，這可以確保視覺一致性。

字型替換功能概述

GroupDocs.Conversion 允許在轉換期間定義特定的字體替換，從而保持不同系統間的外觀。

步驟 1：定義輸入和輸出路徑

確定輸入的 Excel 檔案路徑和所需的輸出 PDF 路徑：

String inputDocument = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx";
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertSpreadsheetBySpecifyingFontsubstitution.pdf";

步驟 2：設定字型替換的載入選項

創建一個 SpreadsheetLoadOptions 物件來配置轉換設置，指定字體替換：

import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;
import com.groupdocs.conversion.contracts.FontSubstitute;

List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // 用 Arial 取代 Tahoma
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // 用 Arial 取代 Times New Roman

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setFontSubstitutes(fontSubstitutes);

步驟3：配置預設字體和單頁轉換

設定預設字體作為後備，確保每張紙都轉換為 PDF 頁面：

loadOptions.setDefaultFont("resources/fonts/Helvetica.ttf");
loadOptions.setOnePagePerSheet(true);

步驟 4：使用載入選項初始化轉換器

將加載選項傳遞給您的 Converter 目的：

Converter converter = new Converter(inputDocument, () -> loadOptions);

步驟 5：定義 PDF 轉換選項並轉換

指定轉換格式並執行流程：

PdfConvertOptions options = new PdfConvertOptions();
converter.convert(convertedFile, options);

故障排除提示

  • 缺少字體：確保您的系統上安裝了替代字體。
  • 路徑不正確：驗證輸入和輸出文件的文件路徑。

實際應用

轉換過程中的字體替換有幾種實際用途：

  1. 商業報告：跨平台一致的財務報告呈現。
  2. 法律文件：保持共享 PDF 的外觀。
  3. 學術出版：標準化論文和簡報的字體。
  4. 行銷資料：統一的行銷手冊或通訊。
  5. 協作工具：簡化文件管理系統。

性能考慮

為了優化性能：

  • 使用高效的文件處理來最大限度地減少記憶體使用。
  • 配置 JVM 設定以實現更好的資源分配。
  • 處理大型文件時應用 Java 記憶體管理最佳實務。

結論

本教學向您展示如何使用 GroupDocs.Conversion for Java 將 Excel 文件轉換為 PDF 並進行字體替換，從而確保整個文件工作流程中的字體排版一致。探索 GroupDocs.Conversion 的更多功能，並根據需要將其應用於其他格式。

後續步驟

  • 嘗試不同的轉換選項。
  • 與 Aspose.Cells 等系統整合以擴展功能。

準備好在下一個專案中實施此解決方案了嗎？

常見問題部分

1. GroupDocs.Conversion for Java 用於什麼？

  • 用於轉換各種文件格式（包括 Excel 和 PDF）的庫，具有字體替換等可自訂的設定。

2. 我可以不購買授權就使用 GroupDocs.Conversion 嗎？

  • 是的，您可以透過免費試用或臨時許可證在購買前探索其功能。

3. 如何處理轉換過程中遺失的字體？

  • 使用以下方式定義替代品 FontSubstitute 載入選項內的物件以實現一致的排版。

4. 使用 GroupDocs.Conversion 優化 Java 效能的一些最佳實踐是什麼？

  • 高效率的記憶體管理和JVM配置可以顯著提高效能。