Aplicando Chaves de Licença no IronPDF for Java
Aplicar uma chave de licença ao IronPDF for Java desbloqueia toda a capacidade de produção. Sem uma chave de licença válida, o IronPDF roda no modo de avaliação e carimba uma marca d'água em cada PDF gerado — aceitável para desenvolvimento e avaliação, mas não adequado para implantação ao vivo. Este guia aborda três maneiras de aplicar uma chave de licença: no código Java na inicialização, via um arquivo config.properties, e como verificar se a chave está ativa.
Aplicar uma chave de licença do IronPDF em quatro passos:
- Adicione o IronPDF ao seu
pom.xmlcomo uma dependência do Maven (ou faça o download do.jardiretamente). - Chame
License.setLicenseKey("YOUR-LICENSE-KEY")no início de sua aplicação — antes que qualquer classe IronPDF seja usada. - Alternativamente, defina
IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEYno seu arquivoconfig.properties. - Chame
License.isValidLicense("YOUR-LICENSE-KEY")para confirmar que a chave está ativa.
Como Obter uma Chave de Licença do IronPDF?
IronPDF for Java é gratuito para avaliação em desenvolvimento. Não modo de demonstração, cada PDF produzido carrega uma marca d'água do IronPDF. Para remover a marca d'água e implantar em produção, é necessária uma chave de licença paga ou de teste.
Duas opções estão disponíveis:
- Compre uma licença — visite a página de licenciamento do IronPDF Java para escolher um plano que atenda às suas necessidades de implantação.
- Inicie um teste gratuito de 30 dias — solicite uma chave de licença de teste para avaliar o IronPDF sem restrições em um ambiente ao vivo.
Uma vez que a chave chegue por e-mail, mantenha-a disponível para os passos seguintes. A mesma chave funciona para métodos de aplicação baseados em código e em arquivo.
Como Adicionar o IronPDF como uma Dependência Java?
Antes de aplicar uma chave de licença, o IronPDF deve estar no classpath. Há duas maneiras de conseguir isso: declará-la como uma dependência do Maven ou adicionar o arquivo .jar manualmente.
Opção 1: Maven (pom.xml)
Adicione as duas entradas seguintes ao bloco <dependencies> no seu pom.xml. O primeiro traz a biblioteca IronPDF; o segundo adiciona o registrador SLF4J que o IronPDF usa internamente.
//:path=pom.xml
<dependencies>
<!-- IronPDF for Java — use the latest release version -->
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
<!-- SLF4J simple logger required by IronPDF -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
<version>2.0.3</version>
</dependency>
</dependencies>Substitua 20xx.xx.xxxx pela última versão do IronPDF for Java. Depois de salvar pom.xml, execute mvn install (ou deixe o seu IDE sincronizar) para fazer o download da dependência.
Opção 2: JAR Manual
Se o Maven não for parte da cadeia de ferramentas de construção, baixe o arquivo .jar Java IronPDF e adicione-o ao classpath do projeto manualmente. Essa abordagem é adequada para construções baseadas no Ant ou projetos que gerenciam dependências sem um gerenciador de pacotes.
Como Aplicar uma Chave de Licença no Código Java?
O método mais direto é chamar License.setLicenseKey() logo no início da inicialização da aplicação — antes que qualquer operação PDF seja executada. Colocar a chamada no método main é a abordagem mais segura.
//:path=MyApplication.java
import com.ironsoftware.ironpdf.License;
public class MyApplication {
public static void main(String[] args) {
// Apply your license key before using any IronPDF feature
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
// IronPDF is now fully licensed — no watermarks on output PDFs
System.out.println("IronPDF license applied.");
}
}Esta abordagem funciona em todos os tipos de projetos Java: aplicativos autônomos, serviços Spring Boot, aplicativos Jakarta EE e projetos Android. A chave é armazenada em memória durante a vida do processo JVM; nenhuma gravação no sistema de arquivos ocorre.
Como Aplicar uma Chave de Licença Através de um Arquivo de Configuração?
Para projetos que separam configuração do código — como aplicações twelve-factor ou implantações que rotacionam chaves sem redeploy — o método de arquivo config.properties é preferível.
Adicione uma linha para config.properties:
//:path=config.properties
IRONPDF_LICENSE_KEY=IRONPDF-MYLICENSE-KEY-1EF01Coloque o arquivo no diretório de trabalho do aplicativo em execução ou na raiz do classpath. O IronPDF lê essa propriedade automaticamente na inicialização. Nenhuma alteração de código é necessária quando a chave muda — atualize o arquivo e reinicie o processo.
Como Verificar Se a Chave de Licença Está Ativa?
Depois de aplicar uma chave por qualquer método, License.isValidLicense() confirma se o IronPDF a reconhece como válida. Adicione esta verificação a uma rotina de inicialização ou um endpoint de verificação de integridade.
//:path=LicenseVerification.java
import com.ironsoftware.ironpdf.License;
public class LicenseVerification {
public static void main(String[] args) {
String licenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
// Returns true if the key is valid and the license is active
boolean isValid = License.isValidLicense(licenseKey);
if (isValid) {
System.out.println("License is valid — watermarks are disabled.");
} else {
System.out.println("License is invalid or expired. PDFs will include a trial watermark.");
}
}
}License.isValidLicense() retorna true quando o formato da chave está correto, a licença não expirou, e a chave corresponde ao produto. Ela retorna false para chaves malformadas, chaves de teste expiradas, ou chaves emitidas para um produto diferente da Iron Software. Após qualquer alteração na licença, limpe e reconstrua o projeto antes de executar esta verificação para evitar que dados de classe desatualizados afetem o resultado.
| Comportamento | Modo de Teste (sem chave) | Modo Licenciado |
|---|---|---|
| marca d'água PDF | Sim — em todas as páginas | Não |
| Implantação em produção | Não permitido | Permitido |
| Acesso às funcionalidades | API completa disponível | API completa disponível |
| License.isValidLicense() | Retorna false | Retorna true |
Quais são os próximos passos?
Com uma chave de licença válida aplicada, IronPDF for Java está pronto para uso em produção. Os seguintes recursos ajudam a passar da configuração para a implementação:
- Primeiros Passos com IronPDF for Java — o tutorial oficial de introdução abrangendo renderização de HTML para PDF, leitura de PDF e operações comuns de documentos.
- Exemplos de Código IronPDF Java — uma biblioteca de exemplos executáveis cobrindo criação de PDF, edição, carimbos, preenchimento de formulários e mais.
- Referência da API Java IronPDF — documentação completa de métodos e classes para o pacote
com.ironsoftware.ironpdf. - Adquirir ou atualizar uma licença — escalar de uma licença de desenvolvedor único para uma implementação Enterprise ou OEM conforme o projeto cresce. Inicie uma avaliação gratuita se a avaliação ainda estiver em andamento.
Para questões técnicas, a equipe de suporte IronPDF está disponível por chat ao vivo e e-mail.
Perguntas frequentes
O que acontece se eu usar o IronPDF for Java sem uma chave de licença?
Sem uma chave de licença válida, o IronPDF roda em modo de teste e carimba uma marca d'água em cada página de PDF que gera. Todos os recursos da API permanecem acessíveis, mas a saída com marca d'água não é adequada para implantação em produção.
Como obtenho uma chave de licença IronPDF for Java?
Compre uma licença na página de licenciamento IronPDF Java ou solicite uma chave de teste gratuita de 30 dias. Ambas as opções removem a marca d'água de teste e permitem uso em produção durante a duração da licença.
Como aplico uma chave de licença IronPDF em código Java?
Chame License.setLicenseKey("YOUR-LICENSE-KEY") logo no início do seu aplicativo, antes de qualquer outra classe ou método IronPDF ser usado. A chave se aplica durante toda a vida útil do processo JVM.
Como aplico uma chave de licença usando um arquivo config.properties?
Adicione a linha IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY ao seu arquivo config.properties e coloque o arquivo no diretório de trabalho do aplicativo ou raiz do classpath. O IronPDF o lê automaticamente na inicialização.
O que License.isValidLicense() retorna?
Retorna true quando a chave está formatada corretamente, não expirou e corresponde ao produto IronPDF. Retorna false para chaves mal formadas, chaves de teste expiradas ou chaves emitidas para um produto Iron Software diferente.
O método para chave de licença difere entre as versões Java e .NET do IronPDF?
Sim. No Java, a classe é com.ironsoftware.ironpdf.License e o método é License.setLicenseKey(). No .NET, o equivalente é IronPdf.License.LicenseKey definido como uma propriedade. O formato de chave é compartilhado entre plataformas para licenças multiplataforma.
Quais tipos de projeto Java suportam a aplicação de licença baseada em código?
A chamada License.setLicenseKey() funciona em aplicações Java independentes, serviços Spring Boot, aplicações Jakarta EE, projetos Android e qualquer outro tempo de execução baseado em JVM.
Preciso reconstruir meu projeto após mudar a chave de licença?
Ao usar o método baseado em código, sim — limpe e reconstrua para evitar classes compiladas antigas. Ao usar config.properties, um reinício do processo é suficiente sem uma reconstrução completa, o que facilita a rotação de chaves em produção.
Can I automate license key changes in a production environment?
Yes, by using a config.properties file, you can automate key changes without needing to modify the code and simply update the file as required.
How does the license key affect the behavior of IronPDF for Java?
A valid license key enables production deployment and removes PDF watermarks. In trial mode (without a key), watermarks are included, and production deployment is not permitted.
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.
