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.
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>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 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
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-windows-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>Para Windows x86
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-windows-x86</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>Para Linux x64
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-linux-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>Para macOS x64 (Intel)
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-macos-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>Para macOS Arm (Apple Silicon)
<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:
// 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:
// 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
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:
com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");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);Para especificar o caminho de log IronPdfEngine, adicione:
com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));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 .
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.
