Установка лицензии GroupDocs License Java – Руководство по лицензированию

В этом всестороннем руководстве вы узнаете как установить groupdocs license java для приложений производственного уровня. Правильное лицензирование открывает полный набор функций GroupDocs.Metadata — таких как извлечение, редактирование и проверка соответствия метаданных — и обеспечивает законность вашего развертывания. Мы пройдёмся по размещению файла лицензии, загрузке через InputStream и вариантам лицензий с оплатой за использование, чтобы вы могли уверенно интегрировать GroupDocs.Metadata в любой Java‑проект.

Быстрые ответы

  • Какой тип файла требуется для лицензии GroupDocs.Metadata? Обычный .lic XML‑файл, содержащий зашифрованный лицензионный ключ.
  • Можно ли загрузить лицензию из потока? Да — используйте License.setLicense(InputStream), чтобы избежать жёстко прописанных путей к файлам.
  • Поддерживается ли лицензия с оплатой за использование (metered)? Абсолютно; вызовите Metered.setMeteredKey(String) с вашим ключом.
  • Нужна ли отдельная зависимость во время выполнения? Только основной JAR GroupDocs.Metadata; лицензия находится внутри той же библиотеки.
  • Будет ли лицензия работать на всех версиях Java? Поддерживает Java 8 по 17, охватывая большинство корпоративных сред.

Что такое «set groupdocs license java»?

«set groupdocs license java» относится к процессу применения действующего файла лицензии GroupDocs.Metadata в Java‑приложении, чтобы SDK работал без ограничений оценки. Это включает загрузку предоставленного .lic XML‑файла во время выполнения, что удаляет водяные знаки пробной версии, позволяет обрабатывать неограниченное количество документов и активирует расширенные функции работы с метаданными для всех поддерживаемых форматов.

Почему использовать лицензирование GroupDocs.Metadata в Java?

GroupDocs.Metadata поддерживает более 30 форматов ввода и вывода — включая PDF, DOCX, XLSX, PPTX и файлы изображений — и может обрабатывать документы размером до 2 ГБ, при этом потребление памяти не превышает 150 МБ благодаря потоковой архитектуре. Правильное лицензирование гарантирует 100 % доступность функций и снимает ограничение в 5 страниц, применяемое к нелицензированным оценочным версиям.

Предварительные требования

  • Java 8 или новее (рекомендовано Java 17)
  • Система сборки Maven или Gradle для добавления зависимости GroupDocs.Metadata
  • Действительный файл .lic или ключ лицензии с оплатой за использование из вашего аккаунта GroupDocs

Как установить лицензию groupdocs в Java?

Загрузите файл лицензии из classpath или внешнего расположения, используя InputStream. Такой подход работает как в веб‑, так и в настольных средах и устраняет жёстко прописанные пути к файлам. Поместив лицензию в src/main/resources и вызвав класс License при запуске приложения, вы гарантируете полную разблокировку SDK до выполнения любых операций с метаданными.

Шаг 1: Добавьте зависимость Maven

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

Шаг 2: Поместите файл лицензии

Скопируйте GroupDocs.Metadata.lic в src/main/resources, чтобы он был включён в ваш JAR.

Шаг 3: Загрузите лицензию при запуске приложения

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

Класс License является точкой входа для применения лицензии GroupDocs.Metadata; он читает зашифрованный XML и активирует все премиум‑возможности.

Шаг 4: Проверьте, что лицензия активна

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

Запуск проверки выводит true, подтверждая, что лицензия применена корректно.

Как использовать лицензирование с оплатой за использование (metered) в Java

Лицензирование с оплатой за использование позволяет платить в зависимости от фактического использования, а не фиксированной предварительной стоимости. Класс Metered обрабатывает онлайн‑активацию; каждый вызов API сообщает о потреблении обратно в GroupDocs для выставления счёта, и вы можете программно запрашивать оставшиеся кредиты. Замените вызов setLicense на Metered.setMeteredKey, чтобы перейти к этой модели:

import com.groupdocs.metadata.metered.Metered;

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

Класс Metered обрабатывает онлайн‑активацию; каждый вызов API сообщает о потреблении обратно в GroupDocs для выставления счёта.

Распространённые проблемы и решения

  • Файл лицензии не найден — Убедитесь, что файл находится в classpath (src/main/resources) и указывайте его с начальным слешем (/GroupDocs.Metadata.lic).
  • Ошибка недействительной лицензии — Проверьте, что файл .lic соответствует версии продукта, которую вы используете; при необходимости сгенерируйте его заново в портале GroupDocs.
  • Ключ metered отклонён — Тщательно проверьте строку ключа на наличие лишних пробелов или переносов строк; ключ должен быть одной непрерывной строкой.

Доступные руководства

Как установить лицензию GroupDocs.Metadata в Java с использованием InputStream

Узнайте, как настроить лицензию GroupDocs.Metadata с помощью InputStream в Java. Разблокируйте расширенные функции управления документами с этим пошаговым руководством.

Дополнительные ресурсы

Часто задаваемые вопросы

В: Можно ли использовать один и тот же файл лицензии для нескольких Java‑сервисов?
О: Да, один файл .lic может быть использован в любом количестве Java‑приложений, при условии, что они работают по одному лицензионному соглашению.

В: Поддерживает ли лицензия облачные развертывания (например, AWS, Azure)?
О: Абсолютно; лицензия не зависит от среды. Просто убедитесь, что файл доступен контейнеру выполнения.

В: Как переключиться с пробной версии на полную лицензию без простоя?
О: Разместите новый файл .lic и перезапустите приложение; SDK подхватит новую лицензию при следующей инициализации.

В: Что происходит, если срок действия ключа metered истекает?
О: Вызовы API начнут возвращать исключение лицензирования. Обновите ключ в вашем аккаунте GroupDocs, чтобы возобновить использование.

В: Есть ли способ программно проверить оставшуюся квоту использования?
О: Да, вызовите Metered.getUsageInfo(), чтобы получить текущие потребления и оставшиеся кредиты.

Последнее обновление: 2026-06-07
Тестировано с: GroupDocs.Metadata 23.12 для Java
Автор: GroupDocs

Связанные руководства