设置 GroupDocs License Java – 许可指南

在本综合教程中，您将了解 how to set groupdocs license java 用于生产级应用程序的方式。正确的许可可解锁 GroupDocs.Metadata 的完整功能套件——例如元数据提取、编辑和合规检查——同时确保您的部署符合法律要求。我们将逐步演示许可文件的放置、基于 InputStream 的加载以及计量许可选项，让您能够自信地将 GroupDocs.Metadata 集成到任何 Java 项目中。

快速答案

  • 需要哪种文件类型的 GroupDocs.Metadata 许可证？ 一个包含加密许可证密钥的普通 .lic XML 文件。
  • 我可以从流中加载许可证吗？ 是的——使用 License.setLicense(InputStream) 以避免硬编码文件路径。
  • 是否支持计量（按使用付费）许可证？ 当然；使用您的密钥调用 Metered.setMeteredKey(String)。
  • 我需要单独的运行时依赖吗？ 仅需核心的 GroupDocs.Metadata JAR；许可证功能已内置于同一库中。
  • 许可证能在所有 Java 版本上工作吗？ 它支持 Java 8 到 17，覆盖大多数企业环境。

什么是 “set groupdocs license java”？

“set groupdocs license java” 指在 Java 应用程序中应用有效的 GroupDocs.Metadata 许可证文件的过程，使 SDK 在没有评估限制的情况下运行。它涉及在运行时加载提供的 .lic XML 文件，从而去除试用水印、启用无限制的文档处理，并激活所有受支持格式的高级元数据操作功能。

为什么在 Java 中使用 GroupDocs.Metadata 许可？

GroupDocs.Metadata 支持 30+ 输入和输出格式——包括 PDF、DOCX、XLSX、PPTX 和图像文件，并且能够处理高达 2 GB 大小的文档，同时由于其流式架构，内存使用保持在 150 MB 以下。正确的许可可保证 100 % 功能可用性，并消除未授权评估时的 5 页限制。

前提条件

  • Java 8 或更高版本（推荐使用 Java 17）
  • Maven 或 Gradle 构建系统，用于添加 GroupDocs.Metadata 依赖
  • 有效的 .lic 文件或来自您 GroupDocs 账户的计量许可证密钥

如何设置 groupdocs license java？

使用 InputStream 从类路径或外部位置加载许可证文件。此方法适用于 Web 和桌面环境，并消除硬编码的文件路径。通过将许可证放置在 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，确认许可证已正确应用。

如何在 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 报告使用情况以进行计费。

常见问题及解决方案

  • License file not found – 确保文件位于类路径 (src/main/resources) 中，并使用前导斜杠引用（/GroupDocs.Metadata.lic）。
  • Invalid license error – 验证 .lic 文件与您使用的产品版本匹配；如有需要，请从 GroupDocs 门户重新生成。
  • Metered key rejected – 仔细检查密钥字符串是否有多余的空格或换行；密钥必须是一行连续的字符串。

可用教程

如何使用 InputStream 在 Java 中设置 GroupDocs.Metadata 许可证

了解如何在 Java 中使用 InputStream 配置 GroupDocs.Metadata 许可证。通过本分步指南解锁高级文档管理功能。

其他资源

常见问题

问：我可以在多个 Java 服务中使用相同的许可证文件吗？
答：可以，只要在相同的许可协议下，单个 .lic 文件即可在任意数量的 Java 应用程序之间共享。

问：许可证支持云部署（例如 AWS、Azure）吗？
答：当然；许可证与环境无关。只需确保文件对运行时容器可访问。

问：如何在不中断的情况下从试用版切换到正式许可证？
答：部署新的 .lic 文件并重启应用程序；SDK 在下次初始化时会加载新许可证。

问：如果计量密钥过期会怎样？
答：API 调用将返回许可异常。请从您的 GroupDocs 账户刷新密钥以恢复使用。

问：是否可以通过编程方式检查剩余使用配额？
答：可以，调用 Metered.getUsageInfo() 获取当前消耗和剩余额度。

最后更新： 2026-06-07
测试环境： GroupDocs.Metadata 23.12 for Java
作者： GroupDocs

相关教程