設定 GroupDocs License Java – 授權指南

在本完整教學中，您將了解 how to set groupdocs license java 於生產等級的應用程式。正確的授權可解鎖 GroupDocs.Metadata 的完整功能套件——如元資料擷取、編輯與合規檢查，同時確保部署符合法律規範。我們將說明授權檔案的放置位置、基於 InputStream 的載入方式，以及計量式授權選項，讓您能自信地將 GroupDocs.Metadata 整合至任何 Java 專案。

快速解答

  • 需要什麼檔案類型的 GroupDocs.Metadata 授權？ A plain .lic XML file containing the encrypted license key.
  • 我可以從串流載入授權嗎？ Yes—use License.setLicense(InputStream) to avoid hard‑coding file paths.
  • 是否支援計量式（按使用付費）授權？ Absolutely; call Metered.setMeteredKey(String) with your key.
  • 我需要額外的執行時相依性嗎？ Only the core GroupDocs.Metadata JAR; licensing lives inside the same library.
  • 授權能在所有 Java 版本上運作嗎？ It supports Java 8 through 17, covering the majority of enterprise environments.

「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 – Ensure the file is in the classpath (src/main/resources) and reference it with a leading slash (/GroupDocs.Metadata.lic).
  • Invalid license error – Verify that the .lic file matches the product version you’re using; regenerate it from the GroupDocs portal if needed.
  • Metered key rejected – Double‑check the key string for extra spaces or line breaks; the key must be a single uninterrupted line.

可用教學

如何使用 InputStream 在 Java 中設定 GroupDocs.Metadata 授權

了解如何在 Java 中使用 InputStream 配置 GroupDocs.Metadata 授權。透過本步驟指南解鎖進階文件管理功能。

其他資源

常見問答

Q: 我可以將同一個授權檔案用於多個 Java 服務嗎？
A: 可以，單一 .lic 檔案可在任意數量的 Java 應用程式間共享，只要它們遵守相同的授權協議。

Q: 授權是否支援雲端部署（例如 AWS、Azure）？
A: 完全支援；授權與環境無關。只需確保檔案對執行容器可存取。

Q: 如何在不中斷服務的情況下從試用版切換至正式授權？
A: 部署新的 .lic 檔案並重新啟動應用程式；SDK 會在下次初始化時自動載入新授權。

Q: 若計量式金鑰過期會發生什麼情況？
A: API 呼叫將拋出授權例外。請從您的 GroupDocs 帳戶重新取得金鑰以恢復使用。

Q: 有辦法以程式方式檢查剩餘使用額度嗎？
A: 有，呼叫 Metered.getUsageInfo() 即可取得目前消耗量與剩餘點數。

最後更新： 2026-06-07
測試環境： GroupDocs.Metadata 23.12 for Java
作者： GroupDocs

相關教學