如何在 Java 中列印 PDF 檔案

何時應使用對話框式列印？

透過對話框進行列印，可讓使用者控制列印設定，例如印表機選擇、頁碼範圍、份數及紙張方向。 此方法適用於桌面應用程式、文件管理系統，或任何需要使用者在任務發送前檢視並調整設定的場景。

常見需使用 print() 的情況：

• 具備列印預覽功能的桌面應用程式
• 文件工作流程系統，使用者可在其中選取特定的頁碼範圍
• 辦公室環境中，不同印表機用於不同用途
• 需要使用者在列印敏感文件前進行確認的應用程式

對於需要先合併多個 PDF 檔案再進行列印的應用情境，請先將文件合併，然後將合併後的結果傳遞至 PRINT 對話方塊。 請參閱 IronPDF for Java 的 HTML 轉 PDF 教學指南，了解如何從網頁內容生成可直接列印的 PDF 檔案。

"PRINT對話方塊"提供了哪些設定選項？

標準的 Java 列印對話方塊會顯示完整的作業系統層級列印屬性，包括頁面方向、紙張尺寸、列印品質及排序方式。 IronPDF 會交由底層的 javax.print API 進行屬性協商，因此可用的選項取決於各印表機所回報的功能。 在 Windows 系統上，會顯示原生的 Win32 列印對話方塊； 在 Linux 和 macOS 上，則改用 GTK 或 Cocoa 對話方塊。 您的 Java 應用程式無需編寫自訂 UI 程式碼，因為作業系統會自動處理介面呈現。

如何在不提示使用者介入的情況下 PRINT PDF 檔案？

printWithoutDialog() 方法會繞過列印對話方塊，將文件直接傳送至預設印表機。 流程中的任何階段均無需使用者互動。 這使其成為伺服器端應用程式、批次處理系統及排程工作流的理想選擇，尤其當目標在於產生一致且無需人工干預的輸出時。

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/print-pdf/automated-printing.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;
import java.nio.file.Paths;
import java.time.LocalDateTime;

public class AutomatedPrinting {
    public static void main(String[] args) {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        try {
            // Create a batch of invoices
            for (int i = 1; i <= 10; i++) {
                String html = String.format(
                    "<h1>Invoice #%d</h1>" +
                    "<p>Date: %s</p>" +
                    "<p>Amount: $%.2f</p>",
                    i, LocalDateTime.now(), i * 100.0
                );

                // Render HTML to PDF
                PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

                // Print directly without showing dialog
                pdf.printWithoutDialog();

                System.out.println("Printed invoice #" + i);

                // Save a copy for records
                pdf.saveAs(Paths.get("invoices/invoice_" + i + ".pdf"));
            }

        } catch (IOException e) {
            System.err.println("Printing error: " + e.getMessage());
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/print-pdf/automated-printing.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;
import java.nio.file.Paths;
import java.time.LocalDateTime;

public class AutomatedPrinting {
    public static void main(String[] args) {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        try {
            // Create a batch of invoices
            for (int i = 1; i <= 10; i++) {
                String html = String.format(
                    "<h1>Invoice #%d</h1>" +
                    "<p>Date: %s</p>" +
                    "<p>Amount: $%.2f</p>",
                    i, LocalDateTime.now(), i * 100.0
                );

                // Render HTML to PDF
                PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

                // Print directly without showing dialog
                pdf.printWithoutDialog();

                System.out.println("Printed invoice #" + i);

                // Save a copy for records
                pdf.saveAs(Paths.get("invoices/invoice_" + i + ".pdf"));
            }

        } catch (IOException e) {
            System.err.println("Printing error: " + e.getMessage());
        }
    }
}

上述迴圈會將每張發票從 HTML 範本渲染出來，並立即傳送至預設印表機。 由於沒有對話框阻礙迴圈執行，整個批次將不中斷地完成。

如何處理自動化工作流程中的列印錯誤？

在不使用對話方塊進行列印時，妥善的錯誤處理至關重要。 印表機可用性問題、卡紙及連線問題都可能中斷批次作業。 將 PRINT 呼叫封裝在 try-catch 區塊中並實作重試策略，可確保在發生暫時性錯誤時，工作流程仍能持續運作。

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/print-pdf/retry-print-handler.java
import com.ironsoftware.IronPDF.*;
import java.io.IOException;
import java.util.logging.*;

public class RobustPrintHandler {
    private static final Logger logger = Logger.getLogger(RobustPrintHandler.class.getName());

    public static void safePrint(PdfDocument pdf, int maxRetries) {
        int attempts = 0;
        boolean success = false;

        while (attempts < maxRetries && !success) {
            try {
                attempts++;
                pdf.printWithoutDialog();
                success = true;
                logger.info("Print successful on attempt " + attempts);

            } catch (Exception e) {
                logger.warning("Print attempt " + attempts + " failed: " + e.getMessage());

                if (attempts < maxRetries) {
                    try {
                        // Wait before retrying
                        Thread.sleep(2000);
                    } catch (InterruptedException ie) {
                        Thread.currentThread().interrupt();
                    }
                } else {
                    // Max retries reached
                    logger.severe("Print failed after " + maxRetries + " attempts");
                }
            }
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/print-pdf/retry-print-handler.java
import com.ironsoftware.IronPDF.*;
import java.io.IOException;
import java.util.logging.*;

public class RobustPrintHandler {
    private static final Logger logger = Logger.getLogger(RobustPrintHandler.class.getName());

    public static void safePrint(PdfDocument pdf, int maxRetries) {
        int attempts = 0;
        boolean success = false;

        while (attempts < maxRetries && !success) {
            try {
                attempts++;
                pdf.printWithoutDialog();
                success = true;
                logger.info("Print successful on attempt " + attempts);

            } catch (Exception e) {
                logger.warning("Print attempt " + attempts + " failed: " + e.getMessage());

                if (attempts < maxRetries) {
                    try {
                        // Wait before retrying
                        Thread.sleep(2000);
                    } catch (InterruptedException ie) {
                        Thread.currentThread().interrupt();
                    }
                } else {
                    // Max retries reached
                    logger.severe("Print failed after " + maxRetries + " attempts");
                }
            }
        }
    }
}

safePrint 方法最多會重試 maxRetries 次，每次嘗試之間會間隔兩秒。每次嘗試都會被記錄，以便您能追溯失敗原因至特定工作。 一旦達到重試次數上限，該方法將記錄一條嚴重級別的錯誤訊息。 接著，您的應用程式可以將文件儲存至磁碟、排入佇列以供日後處理，或通知管理員。

在 Java 中 PRINT PDF 的下一步該怎麼做？

本指南涵蓋兩種方法：透過 print() 進行互動式列印，適用於需要使用者控制的桌面應用程式；以及透過 printWithoutDialog() 進行靜默列印，適用於自動化批次工作流程。 這兩種方法皆與 Java 的標準列印基礎架構整合，並可與作業系統上安裝的任何印表機配合使用。

若要將 IronPDF 加入您的專案並開始列印，請立即開始免費試用。 無需信用卡。 當您準備部署時，請查看適用於您的團隊或組織的授權選項。

準備好探索 IronPDF 的更多功能了嗎？ 點此查看完整教學頁面：Java PRINT PDF 教學