Como imprimir arquivos PDF em Java

Quando Você Deve Usar Impressão Baseada em Diálogo?

A impressão baseada em diálogo dá aos usuários controle sobre configurações como seleção de impressora, intervalo de páginas, número de cópias e orientação do papel. Essa abordagem se adapta a aplicativos de desktop, sistemas de gerenciamento de documentos ou qualquer cenário em que os usuários precisem revisar e ajustar configurações antes que o trabalho seja enviado.

Situações comuns que exigem print():

• Aplicativos de desktop com funcionalidade de visualização de impressão
• Sistemas de fluxo de trabalho de documentos onde os usuários selecionam intervalos de páginas específicos
• Ambientes de escritório onde diferentes impressoras servem a diferentes propósitos
• Aplicações que exigem confirmação do usuário antes de imprimir documentos confidenciais

Para aplicativos que precisam mesclar vários PDFs antes de imprimir, combine documentos primeiro e, em seguida, passe o resultado unificado para o diálogo de impressão. Revise o tutorial HTML para PDF do IronPDF for Java para orientação sobre como gerar PDFs prontos para impressão a partir de conteúdo da web.

Que Configuração o Diálogo de Impressão Expõe?

O diálogo padrão de impressão Java exibe o conjunto completo de atributos de impressão em nível de SO, incluindo orientação de página, tamanho de mídia, qualidade de impressão e ordem de colagem. O IronPDF utiliza a API subjacente javax.print para negociação de atributos, portanto, as opções disponíveis dependem das capacidades relatadas por cada impressora. No Windows, aparece o diálogo de impressão nativo do Win32; no Linux e macOS, o diálogo GTK ou Cocoa é usado em vez disso. Seu aplicativo Java não requer código de interface do usuário personalizado, pois o SO cuida automaticamente da apresentação.

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

O método printWithoutDialog() ignora a caixa de 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.

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 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 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 as 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 abordou duas abordagens: impressão interativa via print() para aplicações de desktop onde os usuários precisam de controle, e impressão silenciosa via printWithoutDialog() para fluxos de trabalho em 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