Como imprimir arquivos PDF em Java

Como imprimir PDFs com interação do usuário?

Carregue o documento PDF que você deseja imprimir, em seguida, chame pdf.print(). O método abre o diálogo padrão de impressão, permitindo que os usuários selecionem a impressora, intervalo de páginas e outras opções antes que o trabalho seja enviado. Isso se integra à funcionalidade nativa de impressão do sistema operacional, de modo que cada impressora instalada na máquina (incluindo impressoras de rede e virtuais) aparece no diálogo automaticamente.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/print-pdf/interactive-printing.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;

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

        try {
            // Option 1: Create a new PDF from HTML
            PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Monthly Report</h1><p>Sales data...</p>");

            // Option 2: Load an existing PDF file
            // PdfDocument pdf = PdfDocument.fromFile(Paths.get("report.pdf"));

            // Print the PDF with a print dialog for user interaction
            pdf.print();

            System.out.println("Print job sent to selected printer");

        } catch (IOException e) {
            System.err.println("Error printing PDF: " + e.getMessage());
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/print-pdf/interactive-printing.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;

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

        try {
            // Option 1: Create a new PDF from HTML
            PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Monthly Report</h1><p>Sales data...</p>");

            // Option 2: Load an existing PDF file
            // PdfDocument pdf = PdfDocument.fromFile(Paths.get("report.pdf"));

            // Print the PDF with a print dialog for user interaction
            pdf.print();

            System.out.println("Print job sent to selected printer");

        } catch (IOException e) {
            System.err.println("Error printing PDF: " + e.getMessage());
        }
    }
}

O diálogo de impressão aceita as configurações selecionadas pelo usuário antes de enviar o trabalho para a impressora.

Como posso imprimir PDFs sem que o usuário precise solicitar informações?

O método printWithoutDialog() ignora o diálogo de impressão e envia o documento diretamente para a impressora padrão. Nenhuma interação do usuário é necessária em qualquer ponto do fluxo. Isso o torna a escolha certa para aplicativos no lado do servidor, sistemas de processamento em lote e fluxos de trabalho agendados onde o objetivo é saída consistente e sem supervisão.

//: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());
        }
    }
}

O loop acima renderiza cada fatura a partir de um template HTML e a despacha imediatamente para a impressora padrão. Como nenhum diálogo bloqueia o loop, todo o lote é concluído sem interrupção.

Quando a impressão direta é mais eficaz?

Use printWithoutDialog() para fluxos de trabalho de documentos automatizados, trabalhos de impressão agendados ou serviços de backend onde a impressão deve ocorrer sem intervenção manual. Os casos de uso comuns incluem:

• Sistemas de Ponto de Venda: Imprima recibos automaticamente após transações
• Geração de Relatórios: Agende e imprima relatórios diários ou semanais
• Impressão de Etiquetas: Imprima etiquetas de envio em sistemas de gestão de armazém
• Processamento de Documentos: Imprima contratos ou documentos legais em lote

Para aplicativos que precisam adicionar marcas d'água em Java ou estampar conteúdo antes de imprimir, processe os PDFs primeiro, depois envie-os diretamente para a impressora.

---

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como Lidar com Erros de Impressão em Fluxos de Trabalho Automatizados?

Ao imprimir sem diálogos, o tratamento adequado de erros é essencial. Problemas de disponibilidade da impressora, atolamentos de papel e problemas de conexão podem interromper um lote. Envolver chamadas de impressão em blocos try-catch e implementar uma estratégia de re-tentativa mantém os fluxos de trabalho em execução quando ocorrem erros transitórios.

//: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");
                }
            }
        }
    }
}

O método safePrint tenta novamente até maxRetries vezes com uma pausa de dois segundos entre as tentativas. Cada tentativa é registrada para que você possa rastrear falhas até trabalhos específicos. Depois de atingido o limite de re-tentativas, o método registra uma mensagem grave. A partir daí, seu aplicativo pode salvar o documento em disco, enfileirá-lo para mais tarde ou notificar um administrador.

Quais São os Próximos Passos para a Impressão de PDFs em Java?

Este guia cobriu duas abordagens: impressão interativa via print() para aplicações desktop onde os usuários precisam de controle e impressão silenciosa via printWithoutDialog() para fluxos de trabalho de lote automatizados. Ambos os métodos se integram à infraestrutura de impressão padrão do Java e funcionam com qualquer impressora instalada no sistema operacional.

Para adicionar o IronPDF ao seu projeto e começar a imprimir, inicie seu teste gratuito. Não é necessário cartão de crédito. Quando estiver pronto para implantar, veja as opções de licenciamento para sua equipe ou organização.

Pronto para ver o que mais o IronPDF pode fazer? Confira a página completa do tutorial aqui: Java Print PDF Tutorial