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 descreve três maneiras de aplicar uma chave de licença: no código Java na inicialização, por meio de um arquivo config.properties e como verificar se a chave está ativa.

Início Rápido: Aplicar uma Chave de Licença do IronPDF no Java

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:

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. Existem duas maneiras de fazer isso: declará-lo 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> em seu pom.xml. O primeiro traz a biblioteca IronPDF; o segundo adiciona o registrador SLF4J que o IronPDF usa internamente.

//:path=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>
//:path=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>
XML

Substitua 20xx.xx.xxxx pela versão mais recente do IronPDF for Java . Após salvar pom.xml, execute mvn install (ou deixe seu IDE sincronizar) para baixar a dependência.

Opção 2: JAR Manual

Se o Maven não fizer parte do conjunto de ferramentas de compilação, baixe o arquivo IronPDF Java .jar e adicione-o manualmente ao classpath do projeto. 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 do aplicativo — antes de qualquer operação com PDF ser executada. Fazer a chamada pelo 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.");
    }
}
//: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.");
    }
}
JAVA

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 a configuração do código — como aplicações de doze fatores ou implantações que rotacionam chaves sem uma nova implantação — o método de arquivo config.properties é preferível.

Adicione uma linha a config.properties:

//:path=config.properties
IRONPDF_LICENSE_KEY=IRONPDF-MYLICENSE-KEY-1EF01

Coloque 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?

Após aplicar uma chave por qualquer um dos métodos, Licença.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.");
        }
    }
}
//: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.");
        }
    }
}
JAVA

Licença.isValidLicense() retorna true quando o formato da chave está correto, a licença não expirou e a chave corresponde ao produto. Retorna false para chaves malformadas, chaves de avaliação expiradas ou chaves emitidas para um produto Iron Software diferente. 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.

IronPDF for Java — Comportamento de Teste vs. Licenciado
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
Licença.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:

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.

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 ...

Leia mais
Pronto para começar?
Versão: 2026.5 just released
Still Scrolling Icon

Ainda está rolando a tela?

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