IRONSOFTWAREHOME
USANDO O IRONPDF FOR JAVA

IronPDF - Biblioteca Java para PDF

Curtis Chau
Curtis Chau
Updated: 21 de abril de 2026

IronPDF é uma biblioteca Java para gerar, ler e editar documentos PDF. Permite aos usuários trabalhar com documentos PDF com facilidade e precisão. O IronPDF for Java foi desenvolvido com base no sucesso do IronPDF for .NET e oferece eficiência em diferentes plataformas. IronPDF for Java usa IronPdfEngine, que é rápido e otimizado para desempenho.

O IronPDF ajuda a extrair texto e imagens de PDFs , bem como outros objetos de arquivos PDF. Ele ajuda a criar PDFs a partir de strings HTML , URLs e imagens. Permite também a conversão entre diferentes formatos de arquivo. Você pode facilmente adicionar novo conteúdo e assinaturas digitais a PDFs, além de metadados a documentos PDF existentes. Ele foi projetado especialmente para Java 8+, Scala e Kotlin, em qualquer plataforma Windows, Linux e em nuvem.

Passos para criar um carimbo PDF usando o IronPDF em uma aplicação Java.

Pré-requisitos

Para criar um carimbo em PDF, você precisará dos seguintes pré-requisitos:

1. IDE Java

Você pode usar qualquer IDE compatível com Java. Existem diversas IDEs disponíveis para desenvolvimento em Java. Esta demonstração utilizará o IntelliJ IDE . Você pode usar o NetBeans, o Eclipse, etc.

2. Projeto Maven

O Maven é um gerenciador de dependências que permite o controle sobre o projeto Java. O Maven for Java pode ser baixado do site oficial do Maven . O IntelliJ IDE for Java inclui suporte ao Maven.

3. IronPDF

Você pode baixar e instalar o IronPDF for Java de diversas maneiras.

  • Adicionando a dependência IronPDF no arquivo pom.xml no projeto Maven.
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>LATEST_VERSION</version> <!-- Make sure to replace LATEST_VERSION with the actual version number -->
</dependency>
XML

4. Slf4j

Essa dependência também é necessária para inserir conteúdo em um documento PDF existente. Ele pode ser adicionado usando o gerenciador de dependências Maven no IntelliJ ou baixado diretamente do site Maven. Adicione a seguinte dependência ao arquivo pom.xml:

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

Adicionando as importações necessárias

Após a instalação de todos os pré-requisitos, o próximo passo é importar os pacotes IronPDF necessários para trabalhar com documentos PDF. Adicione o seguinte código no início do arquivo Main.java:

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.metadata.MetadataManager;
import com.ironsoftware.ironpdf.security.PdfPrintSecurity;
import com.ironsoftware.ironpdf.security.SecurityManager;
import com.ironsoftware.ironpdf.security.SecurityOptions;
import com.ironsoftware.ironpdf.stamp.*;

import java.io.IOException;
import java.nio.file.Paths;
import java.util.Date;
Java

Chave de licença

Alguns métodos disponíveis no IronPDF exigem uma licença para serem utilizados. Você pode adquirir uma licença ou experimentar o IronPDF gratuitamente com uma licença de avaliação . Você pode definir a chave da seguinte forma:

// Set the IronPDF license key
License.setLicenseKey("YOUR-KEY");
Java

Abrir um documento PDF existente

Para importar um documento existente para adicionar novos conteúdos, é usada a classe PdfDocument. Seu método estático [fromFile](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#fromFile(java.nio.file.Path) é usado para carregar um arquivo de um caminho específico com o nome real do arquivo. O código é o seguinte:

// Load an existing PDF document
PdfDocument pd = PdfDocument.fromFile(Paths.get("sample.pdf"));
Java

Documento original carregado:

Java PDF Stamper (Tutorial para Iniciantes), Figura 1: O documento de exemplo O documento de exemplo

Adicionar novo conteúdo HTML

A IronPDF oferece um pacote de carimbos. It allows a bunch of useful stamping options like BarcodeStamper, HtmlStamper, ImageStamper, TextStamper, and others for content alignment. Para adicionar novo conteúdo HTML a este documento PDF, a classe HtmlStamper será usada. Vamos usar o arquivo da seção anterior e adicionar algum conteúdo a ele. O código a seguir ajuda a realizar essa tarefa:

// Create an HtmlStamper and set its content
HtmlStamper htmlStamper = new HtmlStamper();
htmlStamper.setHtml("New content added!");
Java

Um objeto HtmlStamper é criado e em seguida, utilizado seu método setHtml para anexar novo código HTML. O próximo passo é aplicá-lo ao documento PDF existente para criar uma nova versão em PDF.

Adicionando todos os elementos interativos ao documento PDF

Usando o objeto PdfDocument criado anteriormente para adicionar o código HTML ao documento existente. Ele fornece [applyStamp](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#applyStamp(com.ironsoftware.ironpdf.stamp.Stamper) com duas sobrecargas, uma que aceita somente o conteúdo como um objeto Stamper e a outra também com a seleção de página.

// Apply the stamper to the PDF document
pd.applyStamp(htmlStamper);
Java

Isso adicionará a descrição em formato de texto ao documento existente.

Salvando as alterações no PDF

Para salvar o arquivo, use o método [saveAs](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#saveAs(java.lang.String) do objeto PdfDocument.

// Save the modified PDF document
pd.saveAs("stamped.pdf");
Java

Java PDF Stamper (Tutorial para Iniciantes), Figura 2: O arquivo PDF carimbado O arquivo PDF carimbado

A sequência HTML é adicionada a todas as páginas do documento PDF e no meio de cada página.

Carimbar em páginas específicas

Você pode usar outra sobrecarga do método applyStamp para adicionar o conteúdo a uma página específica.

// Stamp content to a specific page
pd.applyStamp(htmlStamper, PageSelection.singlePage(1));
Java

PageSelection classe fornece diferentes métodos para controlar o número da página. firstPage, lastPage, allPages, e pageRange são alguns métodos disponíveis para adicionar o conteúdo adequadamente.

Alinhando o Conteúdo

You can use [setVerticalAlignment](/java/object-reference/api/com/ironsoftware/ironpdf/stamp/Stamper.html#setVerticalAlignment(com.ironsoftware.ironpdf.stamp.VerticalAlignment), [setHorizontalAlignment](/java/object-reference/api/com/ironsoftware/ironpdf/stamp/Stamper.html#setHorizontalAlignment(com.ironsoftware.ironpdf.stamp.HorizontalAlignment), setWidth, setHeight methods in each Stamper class to adjust the position of the content added to the existing PDF document. O código de exemplo a seguir ajudará a posicionar o texto no canto inferior esquerdo da página:

// Set the alignment of the stamper
htmlStamper.setHorizontalAlignment(HorizontalAlignment.LEFT);
htmlStamper.setVerticalAlignment(VerticalAlignment.BOTTOM);
Java

Java PDF Stamper (Tutorial para Iniciantes), Figura 3: O arquivo PDF de saída com alinhamento do carimbador O arquivo PDF de saída com alinhamento do carimbo

Você pode usar setVerticalOffset, setHorizontalOffset método para ajustar ainda mais o posicionamento do conteúdo.

Para obter mais informações sobre como trabalhar com arquivos PDF usando o IronPDF, visite este exemplo de código para conversão de HTML para PDF em Java .

Carimbar metadados, assinatura e opções de segurança em documentos existentes.

IronPDF for Java é uma biblioteca versátil que oferece a possibilidade de adicionar descrições de arquivos na forma de metadados, permissões de usuário, senha de usuário, adicionar assinatura digital e criar documentos assinados para salvar a versão do documento PDF.

Metadados

// Edit file metadata
MetadataManager metadata = pd.getMetadata();
metadata.setAuthor("Satoshi Nakamoto");
metadata.setKeywords("SEO, Friendly");
metadata.setModifiedDate(new Date().toString());
Java

Opções de segurança

Você também pode controlar as opções de segurança do seu arquivo PDF para que os dados sejam protegidos contra uso não autorizado. It provides options to set setAllowUserPrinting, [setAllowUserEdits](/java/object-reference/api/com/ironsoftware/ironpdf/security/SecurityOptions.html#setAllowUserEdits(com.ironsoftware.ironpdf.security.PdfEditSecurity), [setAllowUserCopyPasteContent](/java/object-reference/api/com/ironsoftware/ironpdf/security/SecurityOptions.html#setAllowUserCopyPasteContent(java.lang.Boolean), [setAllowUserAnnotations](/java/object-reference/api/com/ironsoftware/ironpdf/security/SecurityOptions.html#setAllowUserAnnotations(java.lang.Boolean), [setUserPassword](/java/object-reference/api/com/ironsoftware/ironpdf/security/SecurityOptions.html#setUserPassword(java.lang.String), [setAllowUserFormData](/java/object-reference/api/com/ironsoftware/ironpdf/security/SecurityOptions.html#setAllowUserFormData(java.lang.Boolean) parameters to true or false. O código de exemplo a seguir ajudará a definir todas as propriedades dos objetos mencionadas acima.

// Edit file security settings
SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setAllowUserCopyPasteContent(false);
securityOptions.setAllowUserAnnotations(false);
securityOptions.setAllowUserPrinting(PdfPrintSecurity.FULL_PRINT_RIGHTS);
securityOptions.setAllowUserFormData(false);
securityOptions.setOwnerPassword("top-secret");
securityOptions.setUserPassword("sharable");
Java

Senha do usuário

// Change or set the document encryption password
SecurityManager securityManager = pd.getSecurity();
securityManager.removePasswordsAndEncryption();
securityManager.makePdfDocumentReadOnly("secret-key");

securityManager.setSecurityOptions(securityOptions);
pd.saveAs(Paths.get("assets/secured.pdf"));
Java

Para inserir assinaturas digitais no arquivo, você pode consultar este exemplo de código detalhado para assinaturas em PDF .

Resumo

Este artigo discutiu como inserir conteúdo em um documento PDF existente usando Java. Existe um pacote de carimbos com várias classes de carimbo úteis, que podem ser usadas para adicionar conteúdo em vários formatos a um PDF em qualquer local desejado no documento original.

IronPDF é uma biblioteca versátil, como pode ser visto nos exemplos de código acima. É uma ferramenta bastante simples, mas ao mesmo tempo muito poderosa para geração e manipulação de PDFs. Isso ajuda os desenvolvedores a integrar facilmente todas as funcionalidades de PDF em um único programa de aplicação Java.

O IronPDF é gratuito para desenvolvimento individual e oferece uma licença de avaliação gratuita sem marca d'água para testar todas as suas funcionalidades. No entanto, para uso comercial, deve ser licenciado com o IronPDF .

Por fim, a IronPDF oferece uma promoção especial para a compra dos pacotes Iron Software , na qual os desenvolvedores podem adquirir todos os cinco produtos Iron Software pelo preço de duas licenças.

Curtis Chau
Redator Técnico

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.

...
Leia mais

Artigos relacionados

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.