Definir Licença GroupDocs Java – Guia de Licenciamento

Neste tutorial abrangente você descobrirá como definir a licença groupdocs java para aplicações de nível de produção. O licenciamento adequado desbloqueia todo o conjunto de recursos do GroupDocs.Metadata — como extração de metadados, edição e verificações de conformidade — enquanto mantém sua implantação legalmente em conformidade. Vamos percorrer a colocação do arquivo de licença, o carregamento baseado em InputStream e as opções de licença medida, para que você possa integrar o GroupDocs.Metadata com confiança em qualquer projeto Java.

Respostas Rápidas

  • Qual tipo de arquivo é necessário para uma licença GroupDocs.Metadata? Um arquivo XML .lic simples contendo a chave de licença criptografada.
  • Posso carregar a licença a partir de um stream? Sim—use License.setLicense(InputStream) para evitar codificar caminhos de arquivo.
  • Uma licença medida (pay‑per‑use) é suportada? Absolutamente; chame Metered.setMeteredKey(String) com sua chave.
  • Preciso de uma dependência de tempo de execução separada? Apenas o JAR central do GroupDocs.Metadata; a licença está dentro da mesma biblioteca.
  • A licença funciona em todas as versões do Java? Ela suporta Java 8 até 17, cobrindo a maioria dos ambientes corporativos.

O que é “set groupdocs license java”?

“set groupdocs license java” refere‑se ao processo de aplicar um arquivo de licença válido do GroupDocs.Metadata dentro de uma aplicação Java para que o SDK opere sem restrições de avaliação. Isso envolve carregar o arquivo XML .lic fornecido em tempo de execução, o que remove marcas d’água de avaliação, permite processamento ilimitado de documentos e ativa recursos avançados de manipulação de metadados em todos os formatos suportados.

Por que usar licenciamento do GroupDocs.Metadata em Java?

GroupDocs.Metadata suporta mais de 30 formatos de entrada e saída—incluindo PDF, DOCX, XLSX, PPTX e arquivos de imagem—e pode processar documentos de até 2 GB de tamanho mantendo o uso de memória abaixo de 150 MB graças à sua arquitetura de streaming. O licenciamento adequado garante 100 % de disponibilidade de recursos e remove o limite de 5 páginas que se aplica a avaliações sem licença.

Pré-requisitos

  • Java 8 ou mais recente (Java 17 recomendado)
  • Sistema de build Maven ou Gradle para adicionar a dependência GroupDocs.Metadata
  • Um arquivo .lic válido ou uma chave de licença medida da sua conta GroupDocs

Como definir a licença groupdocs java?

Carregue o arquivo de licença a partir do classpath ou de um local externo usando um InputStream. Essa abordagem funciona tanto em ambientes web quanto desktop e elimina caminhos de arquivo codificados. Ao colocar a licença em src/main/resources e invocar a classe License na inicialização da aplicação, você garante que o SDK esteja totalmente desbloqueado antes de qualquer operação de metadados ser executada.

Etapa 1: Adicionar a dependência Maven

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata</artifactId>
    <version>23.12</version>
</dependency>

Etapa 2: Colocar o arquivo de licença

Copie GroupDocs.Metadata.lic para src/main/resources para que ele seja incluído no seu JAR.

Etapa 3: Carregar a licença na inicialização da aplicação

import com.groupdocs.metadata.License;
import java.io.InputStream;

public class LicenseLoader {
    public static void applyLicense() throws Exception {
        try (InputStream licStream = LicenseLoader.class.getResourceAsStream("/GroupDocs.Metadata.lic")) {
            License license = new License();
            license.setLicense(licStream);
        }
    }
}

A classe License é o ponto de entrada para aplicar uma licença GroupDocs.Metadata; ela lê o XML criptografado e ativa todos os recursos premium.

Etapa 4: Verificar se a licença está ativa

import com.groupdocs.metadata.Metadata;
import java.io.File;

public class Verify {
    public static void main(String[] args) throws Exception {
        LicenseLoader.applyLicense(); // ensure license is set first
        Metadata metadata = new Metadata(new File("sample.pdf"));
        System.out.println("License applied: " + metadata.getLicenseInfo().isValid());
    }
}

Executar a verificação imprime true, confirmando que a licença foi aplicada corretamente.

Como usar licenciamento medido (pay‑per‑use) em Java

O licenciamento medido permite que você pague com base no uso real em vez de um custo fixo antecipado. A classe Metered lida com a ativação online; cada chamada de API relata o uso de volta ao GroupDocs para faturamento, e você pode consultar os créditos restantes programaticamente. Substitua a chamada setLicense por Metered.setMeteredKey para mudar para este modelo:

import com.groupdocs.metadata.metered.Metered;

public class MeteredLicense {
    public static void applyMeteredKey() {
        Metered.setMeteredKey("YOUR-METERED-KEY-HERE");
    }
}

A classe Metered lida com a ativação online; cada chamada de API relata o uso de volta ao GroupDocs para faturamento.

Problemas Comuns e Soluções

  • Arquivo de licença não encontrado – Certifique‑se de que o arquivo está no classpath (src/main/resources) e referencie‑o com uma barra inicial (/GroupDocs.Metadata.lic).
  • Erro de licença inválida – Verifique se o arquivo .lic corresponde à versão do produto que você está usando; regenere‑o a partir do portal GroupDocs, se necessário.
  • Chave medida rejeitada – Verifique se a string da chave não contém espaços extras ou quebras de linha; a chave deve ser uma única linha contínua.

Tutoriais Disponíveis

Como Definir a Licença GroupDocs.Metadata em Java Usando InputStream

Aprenda a configurar uma licença GroupDocs.Metadata usando um InputStream em Java. Desbloqueie recursos avançados de gerenciamento de documentos com este guia passo a passo.

Recursos Adicionais

Perguntas Frequentes

Q: Posso usar o mesmo arquivo de licença em vários serviços Java?
A: Sim, um único arquivo .lic pode ser compartilhado entre qualquer número de aplicações Java, desde que elas operem sob o mesmo acordo de licença.

Q: A licença suporta implantações em nuvem (por exemplo, AWS, Azure)?
A: Absolutamente; a licença é independente do ambiente. Basta garantir que o arquivo esteja acessível ao contêiner de tempo de execução.

Q: Como mudar de uma licença de avaliação para uma licença completa sem tempo de inatividade?
A: Implante o novo arquivo .lic e reinicie a aplicação; o SDK detectará a nova licença na próxima inicialização.

Q: O que acontece se a chave medida expirar?
A: As chamadas de API começarão a retornar uma exceção de licenciamento. Atualize a chave a partir da sua conta GroupDocs para retomar o uso.

Q: Existe uma maneira de verificar programaticamente a cota de uso restante?
A: Sim, chame Metered.getUsageInfo() para obter o consumo atual e os créditos restantes.

Última Atualização: 2026-06-07
Testado com: GroupDocs.Metadata 23.12 para Java
Autor: GroupDocs

Tutoriais Relacionados