如何在 Java 中打印 PDF 文件

何时应该使用基于对话框的打印？

基于对话框的打印让用户可以控制设置，如打印机选择、页面范围、份数和纸张方向。 这种方法适合桌面应用程序、文档管理系统或任何需要用户在作业发送之前查看和调整设置的场景。

需要使用 print() 的常见情况：

• 具有打印预览功能的桌面应用程序
• 用户选择特定页面范围的文档工作流系统
• 不同用途的办公室环境中使用不同的打印机
• 应用程序在打印敏感文档之前需要用户确认

对于需要在打印之前合并多个PDF的应用程序，请先合并文档，然后将统一的结果传递给打印对话框。 查看IronPDF的HTML到PDF教程以获取如何从网页内容生成可打印PDF的指导。

打印对话框暴露了哪些配置？

标准的Java打印对话框显示了操作系统级别打印属性的完整集，包括页面方向、介质尺寸、打印质量和拼订顺序。 IronPDF 依赖底层的 javax.print API 进行属性协商，因此可用的选项取决于各打印机报告的功能。 在Windows上，显示本机Win32打印对话框； 在Linux和macOS上，则使用GTK或Cocoa对话框。 您的Java应用程序无需编写自定义UI代码，因为操作系统会自动处理展示。

如何在没有用户提示的情况下打印 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模板中渲染每个发票，并立即将其派送到默认打印机。 因为没有对话框阻塞循环，整个批处理在不中断的情况下完成。

我该如何处理自动化工作流中的打印错误？

在没有对话框的情况下打印时，正确的错误处理是必不可少的。 打印机可用性问题、纸张卡住和连接问题都可能中断批处理。 将打印调用包装在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中打印PDF的下一步是什么？

本指南介绍了两种方法：针对需要用户控制的桌面应用程序，通过 print() 实现交互式PRINT；针对自动化批处理工作流，通过 printWithoutDialog() 实现静默PRINT。 两种方法均可与Java的标准打印基础设施集成，并适用于操作系统上安装的任何打印机。

要将IronPDF添加到您的项目中并开始打印，开始您的免费试用。 无需信用卡。 准备部署时，为您的团队或组织查看许可选项。

准备看看IronPDF还能做些什么吗？ 在这里查看完整的教程页面：Java打印PDF教程