HTML para PDF em Java

Opção 1: Instalar o IronPDF como uma dependência do Maven

Para instalar o IronPDF em um projeto Java usando o Maven, adicione os seguintes artefatos à seção de dependências do arquivo pom.xml do projeto Java.

<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>

<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>

O primeiro artefato faz referência à versão mais recente da biblioteca IronPDF . O segundo artefato faz referência a uma implementação do SLF4J. Essa dependência é necessária para permitir que o mecanismo de renderização do IronPDF gere mensagens de registro durante a execução. Os engenheiros de software podem substituir essa dependência por outros provedores de registro (como Logback e Log4J); ou omitir completamente o registro de dados, caso não precisem ou não desejem esse tipo de registro.

Execute o comando mvn install em um terminal no diretório raiz do projeto Java para baixar as bibliotecas mencionadas anteriormente.

Opção 2: Instalar o arquivo JAR do IronPDF manualmente

Os desenvolvedores que preferirem não usar o Maven ou qualquer outro sistema de gerenciamento de dependências precisarão baixar o arquivo JAR da biblioteca IronPDF (e a implementação opcional do SLF4J) e adicioná-lo manualmente ao classpath do projeto.

Baixe o arquivo JAR do IronPDF diretamente do site de downloads do IronPDF (ou do repositório Maven).

2.1 Importar o pacote IronPDF

Todos os componentes de conversão e processamento do IronPDF estão contidos no pacote com.ironsoftware.ironpdf.

Inclua a seguinte declaração de importação no início dos arquivos de origem Java (onde o IronPDF será usado) para tornar esses componentes acessíveis ao código-fonte do aplicativo.

// Import statement for IronPDF for Java
import com.ironsoftware.ironpdf.*;

// Import statement for IronPDF for Java
import com.ironsoftware.ironpdf.*;

2.2. Defina a chave de licença (opcional)

O IronPDF for Java é gratuito. No entanto, para usuários da versão gratuita, os documentos PDF serão marcados com uma marca d'água de fundo em mosaico (como mostrado na imagem abaixo).

Para usar o IronPDF para gerar PDFs sem marcas d'água, a biblioteca precisa usar uma chave de licença válida. A linha de código abaixo configura a biblioteca com uma chave de licença.

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

A chave de licença deve ser definida antes de gerar arquivos PDF ou personalizar o conteúdo dos arquivos. Recomendamos que você chame o método setLicenseKey antes de todas as outras linhas de código.

Adquira uma chave de licença na página de licenciamento do IronPDF ou entre em contato conosco para obter uma chave de licença de avaliação gratuita.

2.3 Defina o local do arquivo de log (opcional)

Por padrão (e assumindo que haja um provedor SLF4J instalado), o IronPDF gera mensagens de log em um arquivo de texto chamado IronPdfEngine.log localizado no diretório raiz do aplicativo Java.

Para especificar um nome e local diferentes para o arquivo de log, use o método Settings.setLogPath:

// Set a log path
Settings.setLogPath(Paths.get("IronPdfEngine.log"));

// Set a log path
Settings.setLogPath(Paths.get("IronPdfEngine.log"));

Settings.setLogPath deve ser chamado antes de usar quaisquer métodos de conversão e manipulação de PDF.

2.4. Criando um PDF a partir de uma string HTML

PdfDocument.renderHtmlAsPdf converte uma sequência de conteúdo HTML em um documento PDF.

O exemplo de código a seguir utiliza um único elemento de cabeçalho para gerar um novo arquivo.

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");

O método renderHtmlAsPdf pode obter imagens, folhas de estilo e scripts localizados em pastas em um computador ou em uma unidade de rede. O exemplo a seguir gera um documento PDF a partir de HTML que referencia um arquivo CSS e uma imagem localizados em uma pasta assets:

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");

Um segundo argumento (opcional) para renderHtmlAsPdf permite que os desenvolvedores especifiquem um caminho base a partir do qual referenciar os recursos da web. Esse caminho pode ser para um diretório no sistema de arquivos local ou até mesmo um caminho de URL.

Saiba mais sobre o método renderHtmlAsPdf neste exemplo de código sobre como usar HTML para criar um PDF ou leia sobre ele na página de referência da API para a classe PdfDocument para obter ainda mais controle sobre o HTML renderizado em PDF.

2.5. Criando um PDF a partir de uma URL

Os desenvolvedores podem converter páginas da web online em documentos PDF usando o método PdfDocument.renderUrlAsPdf do IronPDF.

O próximo exemplo converte o artigo da Wikipédia em conteúdo PDF.

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");

Saiba mais sobre como converter páginas da web em conteúdo PDF neste exemplo de código sobre como converter uma URL em PDF.

2.6. Criando um PDF a partir de um arquivo HTML

O IronPDF também pode converter um documento HTML armazenado em um sistema de arquivos local diretamente para o formato PDF equivalente.

O próximo exemplo de código usa essa fatura como uma demonstração prática de quão bem o IronPDF consegue converter arquivos HTML.

Para sua conveniência, reproduzimos aqui o código HTML da fatura:

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>

Suponha que o arquivo HTML tenha sido salvo em uma pasta chamada "faturas", juntamente com seus arquivos CSS e JavaScript . Podemos usar o IronPDF para converter o arquivo HTML da seguinte forma:

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");

Assim como nos exemplos de conversão de string HTML para PDF, o IronPDF resolve corretamente quaisquer URLs relativas em um documento HTML para seus caminhos corretos no sistema de arquivos. Como resultado, o arquivo PDF gerado por este exemplo consegue capturar perfeitamente as influências visuais que quaisquer folhas de estilo e scripts referenciados normalmente teriam em uma página da web.