# IronPDF for Java - Crie, edite e leia PDFs em aplicativos Java.
## 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.
O `IronPDF for Java` baseia-se no sucesso e 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.](/java/#page-home-section-columns-of-features)
## 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 dependência, adicione o seguinte ao seu `pom.xml`:
```xml
<dependencies>
<!-- Adds IronPDF Java. Use the latest version in the version tag. -->
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
<!-- Adds the slf4j logger which IronPDF Java uses. -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
<version>2.0.3</version>
</dependency>
</dependencies>
```
#### Baixar arquivo jar
Opcionalmente, [faça o download manual do arquivo JAR do IronPDF](download-modal) 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 IronPDF pela primeira vez, e será interrompido quando seu aplicativo for fechado ou quando entrar em um estágio 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
```xml
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-windows-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
```
#### Para Windows x86
```xml
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-windows-x86</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
```
#### Para Linux x64
```xml
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-linux-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
```
#### Para macOS x64 (Intel)
```xml
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-macos-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
```
#### Para macOS Arm (Apple Silicon)
```xml
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-macos-arm64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
```
### Comece a escrever código Java
Uma vez que a dependência esteja definida, você pode começar adicionando a declaração `import com.ironsoftware.ironpdf.*` no topo de seu código Java. Aqui está um exemplo simples de HTML para PDF para você começar:
```java
// 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"));
```
Este é outro exemplo simples que demonstra a conversão de URL para PDF:
```java
// 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"));
```
### Exemplo completo de Main.java
```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"));
}
}
```
### 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:
```java
com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");
```
#### Registro
O IronPDF Java utiliza o [logger slf4j](https://www.slf4j.org/) para fins de registro de logs. Para ativar o registro de logs, use:
```java
com.ironsoftware.ironpdf.Settings.setDebug(true);
```
Para especificar o caminho de log `IronPdfEngine`, adicione:
```java
com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));
```
## Licenciamento e suporte disponíveis
[Adquira uma licença do IronPDF](/java/licensing/) 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](trial-license) .
Para obter nossa lista completa de exemplos de código, tutoriais, informações sobre licenciamento e documentação, visite: [Recursos do IronPDF for Java](/java/) .
Para obter mais suporte e esclarecer dúvidas, [entre em contato com nossa equipe de suporte](/java/#live-chat-support) .
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.
O IronPDF for Java baseia-se no sucesso e 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 dependência, adicione o seguinte ao seu pom.xml:
<dependencies> <!-- Adds IronPDF Java. Use the latest version in the version tag. --> <dependency> <groupId>com.ironsoftware</groupId> <artifactId>ironpdf</artifactId> <version>20xx.xx.xxxx</version> </dependency> <!-- Adds the slf4j logger which IronPDF Java uses. --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> <version>2.0.3</version> </dependency></dependencies>
<dependencies>
<!-- Adds IronPDF Java. Use the latest version in the version tag. -->
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
<!-- Adds the slf4j logger which IronPDF Java uses. -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
<version>2.0.3</version>
</dependency>
</dependencies>
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 IronPDF pela primeira vez, e será interrompido quando seu aplicativo for fechado ou quando entrar em um estágio 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 :
Uma vez que a dependência esteja definida, você pode começar adicionando a declaração import com.ironsoftware.ironpdf.* no topo de seu código Java. Aqui está um exemplo simples de HTML para PDF para você começar:
// Import statement for IronPDF Javaimport com.ironsoftware.ironpdf.*;// Apply your license keyLicense.setLicenseKey("YOUR-LICENSE-KEY");// Set a log pathSettings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));// Render the HTML as a PDF. Stored in myPdf as type PdfDocumentPdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");// Save the PdfDocument to a filemyPdf.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 Javaimport com.ironsoftware.ironpdf.*;// Apply your license keyLicense.setLicenseKey("YOUR-LICENSE-KEY");// Set a log pathSettings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));// Render the URL as a PDF. Stored in myPdf as type PdfDocumentPdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");// Save the PdfDocument to a filemyPdf.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 Javaimport 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 keyLicense.setLicenseKey("YOUR-LICENSE-KEY"); // Set a log pathSettings.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:
Para obter nossa lista completa de exemplos de código, tutoriais, informações sobre licenciamento e documentação, visite: Recursos do IronPDF for Java .
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
