1. IronPDF
  2. Documentos
  3. Começando

IronPDF for Java - Crie, edite e leia PDFs em aplicativos Java.

Darrius Serrant
Darrius Serrant
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Sobre o IronPDF for Java

IronPDF for Java é uma biblioteca desenvolvida e mantida pela Iron Software que auxilia engenheiros de software a criar, editar e extrair conteúdo de PDFs em projetos Java 8+, Kotlin e Scala.

IronPDF for Java baseia-se no sucesso e na popularidade do IronPDF for .NET .

IronPDF for Java usa gRPC para se comunicar com o IronPdfEngine.

O IronPDF se destaca em

  • Geração de PDFs a partir de: HTML, URL, JavaScript, CSS e diversos formatos de imagem.
  • Adição de cabeçalhos/rodapés, assinaturas, anexos, senhas e segurança.
  • Otimização de desempenho: suporte completo a multithreading e assíncrono. E muito mais! Visite nosso site para ver todos os nossos exemplos de código e uma lista completa de nossos mais de 50 recursos.

Usando o IronPDF for Java

Defina o IronPDF como uma dependência do Java.

Dependência do arquivo pom.xml

Para definir o IronPDF como uma dependência, adicione o seguinte ao seu pom.xml:

<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>

</dependencies>
<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>

</dependencies>
XML

Baixar arquivo jar

Opcionalmente, faça o download manual do arquivo JAR do IronPDF para uso independente.

Primeira compilação e execução

Os binários IronPdfEngine serão baixados automaticamente ao executar o projeto pela primeira vez. O processo IronPdfEngine será iniciado quando você chamar qualquer função do IronPDF pela primeira vez e será interrompido quando o aplicativo for fechado ou entrar em um estado ocioso.

Instale o IronPDF Engine como uma dependência do Maven.

Ao adicionar o IronPdfEngine como uma dependência do Maven, os binários serão baixados durante o carregamento das dependências:

  • Essa abordagem evitará um longo processo de inicialização, pois os binários do IronPdfEngine já estarão baixados. Além disso, será benéfico para configurações de implantação que não permitem o download de fontes externas.

Se você estiver desenvolvendo um aplicativo multiplataforma, basta adicionar um ou mais dos seguintes trechos de código ao seu arquivo pom.xml :

Para Windows x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para Windows x86

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para Linux x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para macOS x64 (Intel)

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para macOS Arm (Apple Silicon)

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Comece a escrever código Java

Uma vez definida a dependência, você pode começar adicionando a declaração import com.ironsoftware.ironpdf.* ao início do seu código Java. Aqui está um exemplo simples de HTML para PDF para você começar:

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

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

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

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));
// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

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

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

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));
JAVA

Este é outro exemplo simples que demonstra a conversão de URL para PDF:

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

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

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

// Render the URL as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url_saved.pdf"));
// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

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

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

// Render the URL as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url_saved.pdf"));
JAVA

Exemplo completo de Main.java

package org.example;

// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;
import java.io.IOException;
import java.nio.file.Paths;

public class Main {

    public static void main(String[] args) throws IOException {
        // Apply your license key
        License.setLicenseKey("YOUR-LICENSE-KEY");

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

        // Render the HTML as a PDF. Stored in myPdf as type PdfDocument
        PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

        // Save the PdfDocument to a file
        myPdf.saveAs(Paths.get("html_saved.pdf"));

    }

}
package org.example;

// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;
import java.io.IOException;
import java.nio.file.Paths;

public class Main {

    public static void main(String[] args) throws IOException {
        // Apply your license key
        License.setLicenseKey("YOUR-LICENSE-KEY");

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

        // Render the HTML as a PDF. Stored in myPdf as type PdfDocument
        PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

        // Save the PdfDocument to a file
        myPdf.saveAs(Paths.get("html_saved.pdf"));

    }

}
JAVA

Informações adicionais sobre as configurações

Observação: Observe que todas as configurações, registros e operações de licenciamento devem ser executados antes que qualquer método do IronPDF seja chamado.

Aplicando a chave de licença

Para aplicar sua chave de licença, adicione o seguinte ao início do seu método:

com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");
com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");
JAVA

Registro

O IronPDF Java utiliza o logger slf4j para fins de registro de logs. Para ativar o registro de logs, use:

com.ironsoftware.ironpdf.Settings.setDebug(true);
com.ironsoftware.ironpdf.Settings.setDebug(true);
JAVA

Para especificar o caminho do log IronPdfEngine, adicione:

com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));
com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));
JAVA

Licenciamento e suporte disponíveis

Adquira uma licença do IronPDF para usar em projetos reais. Licenças de avaliação de 30 dias também estão disponíveis para usuários em período de teste .

Para obter nossa lista completa de exemplos de código, tutoriais, informações sobre licenciamento e documentação, visite: Recursos do IronPDF for Java .

Para obter mais suporte e esclarecer dúvidas, entre em contato com nossa equipe de suporte .

Darrius Serrant
Darrius Serrant
  Converse agora mesmo com a equipe de engenharia.
Engenheiro de Software Full Stack (WebOps)

Darrius Serrant é bacharel em Ciência da Computação pela Universidade de Miami e trabalha como Engenheiro de Marketing WebOps Full Stack na Iron Software. Atraído por programação desde jovem, ele via a computação como algo misterioso e acessível ao mesmo tempo, tornando-a o meio ...

Leia mais
Pronto para começar?
Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seu HTML se transformar em um PDF.