Configurar licencia de GroupDocs Java – Guía de licenciamiento

En este tutorial completo descubrirás cómo establecer la licencia de groupdocs java para aplicaciones de nivel de producción. Una licencia adecuada desbloquea todo el conjunto de funciones de GroupDocs.Metadata —como extracción de metadatos, edición y verificaciones de cumplimiento— mientras mantiene tu despliegue legalmente conforme. Recorreremos la ubicación del archivo de licencia, la carga basada en InputStream y las opciones de licencia medida, para que puedas integrar con confianza GroupDocs.Metadata en cualquier proyecto Java.

Respuestas rápidas

  • ¿Qué tipo de archivo se requiere para una licencia de GroupDocs.Metadata? Un archivo XML .lic sencillo que contiene la clave de licencia cifrada.
  • ¿Puedo cargar la licencia desde un stream? Sí—usa License.setLicense(InputStream) para evitar codificar rutas de archivo.
  • ¿Se admite una licencia medida (pago por uso)? Absolutamente; llama a Metered.setMeteredKey(String) con tu clave.
  • ¿Necesito una dependencia de tiempo de ejecución separada? Sólo el JAR central de GroupDocs.Metadata; la licencia está dentro de la misma biblioteca.
  • ¿Funcionará la licencia en todas las versiones de Java? Soporta Java 8 hasta 17, cubriendo la mayoría de entornos empresariales.

Qué es “set groupdocs license java”

“set groupdocs license java” se refiere al proceso de aplicar un archivo de licencia válido de GroupDocs.Metadata dentro de una aplicación Java para que el SDK funcione sin restricciones de evaluación. Implica cargar el archivo XML .lic proporcionado en tiempo de ejecución, lo que elimina las marcas de agua de prueba, permite el procesamiento ilimitado de documentos y activa funciones avanzadas de manipulación de metadatos en todos los formatos compatibles.

Por qué usar la licencia de GroupDocs.Metadata en Java

GroupDocs.Metadata soporta más de 30 formatos de entrada y salida—incluidos PDF, DOCX, XLSX, PPTX y archivos de imagen—y puede procesar documentos de hasta 2 GB de tamaño manteniendo el uso de memoria por debajo de 150 MB gracias a su arquitectura de streaming. Una licencia adecuada garantiza el 100 % de disponibilidad de funciones y elimina el límite de 5 páginas que se aplica a las evaluaciones sin licencia.

Requisitos previos

  • Java 8 o superior (se recomienda Java 17)
  • Sistema de compilación Maven o Gradle para añadir la dependencia de GroupDocs.Metadata
  • Un archivo .lic válido o una clave de licencia medida de tu cuenta de GroupDocs

¿Cómo configurar la licencia de GroupDocs en Java?

Carga el archivo de licencia desde el classpath o una ubicación externa usando un InputStream. Este enfoque funciona tanto en entornos web como de escritorio y elimina rutas de archivo codificadas. Al colocar la licencia en src/main/resources y llamar a la clase License al iniciar la aplicación, garantizas que el SDK esté completamente desbloqueado antes de que se realicen operaciones de metadatos.

Paso 1: Añadir la dependencia Maven

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

Paso 2: Colocar el archivo de licencia

Copia GroupDocs.Metadata.lic a src/main/resources para que se incluya en tu JAR.

Paso 3: Cargar la licencia al iniciar la aplicación

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);
        }
    }
}

La clase License es el punto de entrada para aplicar una licencia de GroupDocs.Metadata; lee el XML cifrado y activa todas las capacidades premium.

Paso 4: Verificar que la licencia está activa

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());
    }
}

Ejecutar la verificación imprime true, confirmando que la licencia se ha aplicado correctamente.

Cómo usar la licencia medida (pago por uso) en Java

La licencia medida te permite pagar según el uso real en lugar de un costo fijo inicial. La clase Metered gestiona la activación en línea; cada llamada a la API informa el uso a GroupDocs para facturación, y puedes consultar los créditos restantes programáticamente. Reemplaza la llamada setLicense con Metered.setMeteredKey para cambiar a este modelo:

import com.groupdocs.metadata.metered.Metered;

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

La clase Metered gestiona la activación en línea; cada llamada a la API informa el uso a GroupDocs para facturación.

Problemas comunes y soluciones

  • Archivo de licencia no encontrado – Asegúrate de que el archivo esté en el classpath (src/main/resources) y haz referencia a él con una barra inicial (/GroupDocs.Metadata.lic).
  • Error de licencia inválida – Verifica que el archivo .lic coincida con la versión del producto que estás usando; regénalo desde el portal de GroupDocs si es necesario.
  • Clave medida rechazada – Verifica que la cadena de la clave no tenga espacios extra o saltos de línea; la clave debe ser una sola línea continua.

Tutoriales disponibles

Cómo establecer la licencia de GroupDocs.Metadata en Java usando InputStream

Aprende a configurar una licencia de GroupDocs.Metadata usando un InputStream en Java. Desbloquea funciones avanzadas de gestión de documentos con esta guía paso a paso.

Recursos adicionales

Preguntas frecuentes

P: ¿Puedo usar el mismo archivo de licencia para varios servicios Java?
R: Sí, un único archivo .lic puede compartirse entre cualquier número de aplicaciones Java siempre que se ejecuten bajo el mismo acuerdo de licencia.

P: ¿La licencia admite implementaciones en la nube (p. ej., AWS, Azure)?
R: Absolutamente; la licencia es independiente del entorno. Sólo asegúrate de que el archivo sea accesible para el contenedor de ejecución.

P: ¿Cómo cambio de una prueba a una licencia completa sin tiempo de inactividad?
R: Despliega el nuevo archivo .lic y reinicia la aplicación; el SDK detectará la nueva licencia en la siguiente inicialización.

P: ¿Qué ocurre si la clave medida expira?
R: Las llamadas a la API comenzarán a devolver una excepción de licencia. Actualiza la clave desde tu cuenta de GroupDocs para reanudar el uso.

P: ¿Existe una forma de comprobar programáticamente la cuota de uso restante?
R: Sí, llama a Metered.getUsageInfo() para obtener el consumo actual y los créditos restantes.

Última actualización: 2026-06-07
Probado con: GroupDocs.Metadata 23.12 para Java
Autor: GroupDocs

Tutoriales relacionados