使用 GroupDocs Conversion Java 將 Excel 轉換為 PDF
您是否需要快速 convert Excel to PDF,同時保持輸出整潔且沒有空白列或欄?使用 GroupDocs Conversion Java,您只需幾行程式碼即可將任何試算表轉換為緊湊的 PDF。本教學將帶您完成庫的設定、配置載入選項以 skip empty rows and columns,以及處理大規模報告管線的批次轉換。完成後,您將能夠:
- 將 GroupDocs Conversion Java 依賴項加入 Maven 專案
- 使用
SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true)以移除空白 - 將工作簿轉換為 PDF,達到最佳效能
- 將解決方案擴展至自動化、批次式 Excel‑to‑PDF 工作流程
讓我們深入了解 groupdocs conversion java 如何輕鬆實現此功能。
快速解答
- 什麼函式庫負責轉換? GroupDocs Conversion Java
- 使用的主要功能?
SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true) - 最低 Java 版本? JDK 8 或更高
- 能處理大量檔案嗎? 是 – 可將此程式碼與批次邏輯結合以進行大量轉換
- 需要授權嗎? 生產環境需要臨時或試用授權
什麼是「convert excel to pdf」?
將 Excel 轉換為 PDF 意味著將試算表檔案(例如 .xlsx 或 .xls)轉換為固定版面的 PDF 文件。產生的 PDF 完全保留原始工作簿的外觀,包括字型、顏色和儲存格格式,因而在任何裝置或作業系統上皆顯示相同。此格式非常適合安全分享、高品質列印及長期保存。
什麼是 GroupDocs Conversion Java?
GroupDocs Conversion Java 是基於 Java 的 SDK,支援 50+ input and output formats,包括 Excel、Word、PowerPoint 及影像,且能在不將整個檔案載入記憶體的情況下處理數百頁的文件。它提供高階 API,抽象化格式特定的複雜性,使開發人員能專注於業務邏輯而非檔案處理。
為何在此任務中使用 GroupDocs Conversion Java?
GroupDocs Conversion Java 提供 quantified benefits:它支援超過 50 種格式,處理最高達 1 GB 的檔案且堆疊使用量低於 200 MB,並能在標準伺服器上於 0.8 秒內將典型的 200 列工作表轉換為 PDF。此函式庫亦提供:
- Smart loading options(例如 skip empty rows/columns)可將 PDF 大小縮減最高 30 %
- One‑page‑per‑sheet 轉換,產生精簡的 PDF
- Cross‑platform compatibility – 可在 Windows、Linux 與 macOS 上運作
- Batch processing support 用於大規模自動化
先決條件
在我們深入程式碼之前,請確保您已具備:
- Java Development Kit (JDK) 8+ – 從 Oracle’s website 下載
- Maven – 從 maven.apache.org 取得
- GroupDocs Conversion Java – 我們將其加入 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>
授權取得
- 從 GroupDocs’ Temporary License page 取得臨時授權。
- 欲取得免費試用,請從 GroupDocs Releases Page 下載函式庫。
如何使用 GroupDocs Conversion Java 將 Excel 轉換為 PDF?
要使用 GroupDocs Conversion Java 將 Excel 工作簿轉換為 PDF,首先使用適當的載入選項載入工作簿,啟用 setSkipEmptyRowsAndColumns(true) 旗標以移除空白儲存格,接著建立 Converter 實例並指定 PdfConvertOptions。最後,呼叫 convert 方法寫入 PDF 檔案。整個工作流程分為四個簡單步驟。
步驟 1:設定載入選項
SpreadsheetLoadOptions 定義試算表的解析方式。設定 setSkipEmptyRowsAndColumns(true) 會告訴引擎忽略所有未包含資料的列或欄,從而產生更緊湊的 PDF 版面。
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;
String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx"; // Input file path
// Configure load options to skip empty rows and columns and set one page per sheet.
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setSkipEmptyRowsAndColumns(true);
loadOptions.setOnePagePerSheet(true);
說明: SpreadsheetLoadOptions 控制試算表的讀取方式。啟用 setSkipEmptyRowsAndColumns(true) 會移除空白空間,產生更緊湊的 PDF。
步驟 2:初始化 Converter
Converter 是負責協調從來源到目標格式轉換的核心類別。透過傳遞提供先前定義的 loadOptions 的 lambda,您可確保每次轉換皆使用相同設定。
import com.groupdocs.conversion.Converter;
// Initialize the converter with the input file path and load options.
Converter converter = new Converter(inputFilePath, () -> loadOptions);
說明: 只要 converter 需要載入文件時,lambda 便會提供先前定義的 loadOptions。
步驟 3:準備 PDF 轉換選項
PdfConvertOptions 讓您微調 PDF 輸出,例如邊距、頁面大小與影像品質。預設值適用於大多數情況,但您可依品牌或合規需求進行調整。
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
// Create PdfConvertOptions (optional, as default options are used here).
PdfConvertOptions pdfConvertOptions = new PdfConvertOptions();
說明: PdfConvertOptions 讓您調整邊距、頁面大小以及其他 PDF 專屬設定。
步驟 4:執行轉換
呼叫 convert 會將 PDF 寫入指定路徑。由於啟用了 skip‑empty‑rows/columns 設定,產生的檔案僅包含有資料的儲存格,顯著減少檔案大小。
String outputFilePath = "YOUR_OUTPUT_DIRECTORY/converted.pdf"; // Output file path
// Perform the conversion from spreadsheet to PDF.
converter.convert(outputFilePath, pdfConvertOptions);
說明: 由於使用了 skip‑empty‑rows/columns 選項,convert 方法產生的 PDF 僅包含有資料的儲存格。
常見問題與故障排除
- Incorrect file path – 請再次確認輸入與輸出路徑。
- Permission errors – 確保 Java 程序對目錄具有讀寫權限。
- Large workbooks – 分配更多堆積記憶體 (
-Xmx2g) 以避免OutOfMemoryError。
實務使用案例
- Automated report generation – 將每日 Excel 報告轉換為精美 PDF,供利害關係人使用。
- Document archiving – 將財務報表以 PDF 形式保存,避免空白儲存格的雜訊。
- Batch excel pdf conversion – 迭代資料夾中的試算表,套用相同邏輯以進行大量處理。
效能技巧
- Memory management – 每次轉換後釋放
Converter物件 (converter.close())。 - Batch processing – 將檔案分批處理,以保持記憶體使用量可預測。
- Monitoring – 記錄轉換時間與記憶體消耗,以找出瓶頸。
結論
您現在擁有完整且可投入生產環境的 convert Excel to PDF 方法,使用 GroupDocs Conversion Java 並自動移除空白列與欄。將此模式整合至您的報告管線、文件管理系統,或任何需要乾淨 PDF 輸出的情境中。
常見問答
Q1: 我可以使用 GroupDocs Conversion Java 轉換其他文件類型嗎?
A1: 可以!此 SDK 支援 50+ 種格式,包括 Word、PowerPoint 與影像,提供單一解決方案以滿足多樣的轉換需求。
Q2: PDF 仍顯示空白列——我應該檢查什麼?
A2: 確認在建立 Converter 實例之前已呼叫 loadOptions.setSkipEmptyRowsAndColumns(true)。
Q3: 如何在轉換過程中處理例外情況?
A3: 將轉換程式碼包裹在 try‑catch 區塊中,記錄例外細節,並可選擇重新嘗試或跳過有問題的檔案。
Q4: 我可以自訂 PDF 版面(邊距、方向)嗎?
A4: 當然可以。使用 PdfConvertOptions 設定邊距、頁面大小、方向,甚至嵌入自訂字型。
Q5: GroupDocs Conversion 能在非 Maven 專案中使用嗎?
A5: 可以,您可直接從 GroupDocs Releases Page 下載 JAR 檔案。
最後更新: 2026-05-16
測試版本: GroupDocs Conversion 25.2
作者: GroupDocs