วิธีตั้งค่าไลเซนส์สำหรับ GroupDocs Watermark (Metered) ใน Java

การปกป้องทรัพย์สินทางปัญญาเป็นสิ่งสำคัญอันดับแรกสำหรับธุรกิจสมัยใหม่ และลายน้ำเป็นวิธีที่พิสูจน์แล้วว่ามีประสิทธิภาพ ในบทแนะนำนี้คุณจะได้เรียนรู้ วิธีตั้งค่าไลเซนส์ สำหรับ GroupDocs.Watermark ด้วยวิธีการแบบ metered เพื่อให้คุณสามารถ ใส่ลายน้ำ PDF ไฟล์ได้พร้อมควบคุมการใช้งานอย่างเต็มที่ เราจะอธิบายทุกอย่างตั้งแต่ข้อกำหนดเบื้องต้นจนถึงสถานการณ์การใช้งานจริง และแสดงให้คุณเห็นว่า ใช้ public private keys เพื่อเปิดใช้งานไลเซนส์ได้ที่ไหน

Quick Answers

  • What is a metered license? โมเดลไลเซนส์แบบใช้ตามการใช้งานที่ติดตามแต่ละการเรียก API
  • Do I need a license file? ไม่ – คุณเปิดใช้งานด้วย public และ private keys
  • Which Java version is required? Java 8 หรือสูงกว่า
  • Can I add watermark pdf documents? ได้, API รองรับ PDF, DOCX, PPTX, และรูปภาพ
  • Is this method secure? ใช่, คีย์จะถูกส่งผ่าน HTTPS และไม่ถูกเก็บเป็นข้อความธรรมดา

What is a Metered License and Why Use It?

ไลเซนส์แบบ metered ทำให้คุณจ่ายเฉพาะสิ่งที่ใช้จริง ทำให้เหมาะกับสถาปัตยกรรม SaaS หรือ micro‑service คุณลักษณะ document security watermark สามารถใช้งานได้โดยไม่ต้องจัดการไฟล์ไลเซนส์แบบดั้งเดิม และคุณสามารถขยายการใช้งานขึ้นหรือลงได้ทันที

Prerequisites

Before you begin, make sure you have:

  1. GroupDocs.Watermark for Java ≥ 24.11 (the latest release).
  2. JDK 8+ installed and JAVA_HOME configured.
  3. Public and private keys obtained from your GroupDocs account (you’ll use them in the code).

Setting Up GroupDocs.Watermark for Java

Installation Information

Integrate GroupDocs.Watermark into your Maven project:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Tip: URL ของ repository เดียวกันนี้ยังใช้สำหรับตัวเลือกดาวน์โหลดโดยตรงด้านล่าง.

Direct Download

Grab the latest JAR from the official release page: รุ่นปล่อยของ GroupDocs.Watermark สำหรับ Java.

License Acquisition

เพื่อเปิดใช้งานฟีเจอร์ระดับพรีเมียม คุณต้องมีไลเซนส์ชั่วคราวหรือทดลอง สมัครที่ เว็บไซต์ GroupDocs และคัดลอก public/private keys ที่พวกเขาให้มา

Basic Initialization

Once the library is on your classpath, you can initialize it:

import com.groupdocs.watermark.License;

public class InitializeWatermark {
    public static void main(String[] args) throws Exception {
        License license = new License();
        // Apply the license using your path to the license file
        license.setLicense("path/to/your/license/file.lic");
    }
}

Why this matters: แม้คุณจะใช้ไลเซนส์แบบ metered การเริ่มต้นอ็อบเจกต์ License จะทำให้ SDK พร้อมรับการเปิดใช้งานด้วยคีย์ในขั้นตอนต่อไปของ workflow

Implementation Guide

Setting a Metered License

Step 1: Define the Public and Private Keys

// Step 1: Define the public and private keys for the metered license.
String publicKey = "*****"; // Replace with your actual public key
String privateKey = "*****"; // Replace with your actual private key

คีย์เหล่านี้ ใช้ public private keys เพื่อระบุตัวตนของบัญชีของคุณอย่างปลอดภัย

Step 2: Create an Instance of the Metered Class

// Step 2: Create an instance of Metered class.
Metered metered = new Metered();

คลาส Metered จะจัดการการติดตามการใช้งานทั้งหมดเบื้องหลัง

Step 3: Set the Metered License Using Provided Keys

// Step 3: Set the metered license using the provided keys.
metered.setMeteredKey(publicKey, privateKey);

หลังจากเรียกนี้ SDK จะได้รับไลเซนส์เต็มรูปแบบและคุณสามารถเริ่ม เพิ่มลายน้ำ PDF ไฟล์หรือ สร้างเอกสารที่มีลายน้ำ

Why Use Public/Private Keys Instead of a License File?

  • Security: คีย์จะไม่ถูกเขียนลงดิสก์ในรูปแบบข้อความธรรมดา
  • Flexibility: สลับสภาพแวดล้อม (dev, test, prod) ได้โดยไม่ต้องคัดลอกไฟล์
  • Scalability: เหมาะอย่างยิ่งสำหรับการปรับใช้แบบ cloud‑native ที่คอนเทนเนอร์เป็น immutable

Practical Applications

  1. Document Security: ฝังลายน้ำที่มองเห็นหรือซ่อนใน PDF เพื่อป้องกันการแจกจ่ายโดยไม่ได้รับอนุญาต
  2. Usage Tracking: ตรวจสอบจำนวนเอกสารที่ประมวลผลแต่ละเดือน ช่วยให้คุณอยู่ในโควต้าที่กำหนดไว้
  3. CMS Integration: อัตโนมัติ ใส่ลายน้ำ PDF ให้กับไฟล์ที่อัปโหลดทุกไฟล์ในระบบจัดการเนื้อหา

Performance Considerations

  • Apply watermark only when needed – avoid processing large batches unnecessarily.
  • Reuse the Metered instance across requests to reduce object creation overhead.
  • Monitor memory when handling high‑resolution images; the SDK provides streaming APIs to keep the footprint low.

Common Issues and Solutions

ปัญหาวิธีแก้
Keys are rejectedตรวจสอบให้แน่ใจว่าไม่มีช่องว่างหรือการขึ้นบรรทัดใหม่เกินในสตริง
License not activatedตรวจสอบว่าคุณได้เรียก metered.setMeteredKey(...) ก่อน การทำงานใด ๆ ของลายน้ำ
Out‑of‑memory errors on big PDFsใช้ WatermarkOptions.setUseMemoryCache(true) เพื่อย้ายการประมวลผลไปยังดิสก์

Frequently Asked Questions

Q: What is a metered license, and why should I use it?
A: ไลเซนส์แบบ metered ติดตามการเรียก API แต่ละครั้ง ทำให้คุณจ่ายเฉพาะการใช้งานจริงและขยายแอปพลิเคชันได้ง่าย

Q: Can I switch between a trial license file and a metered key?
A: ได้ เพียงเรียก license.setLicense("path/to/file.lic") สำหรับการทดลอง แล้วเปลี่ยนเป็น metered.setMeteredKey(...) ภายหลัง

Q: What happens if my public or private key is entered incorrectly?
A: SDK จะโยนข้อยกเว้นการตรวจสอบสิทธิ์และบล็อกการเข้าถึงฟีเจอร์ระดับพรีเมียม

Q: Are there limits on how many watermarks I can add per month?
A: ขีดจำกัดขึ้นอยู่กับข้อตกลงกับ GroupDocs; ตรวจสอบแดชบอร์ดของคุณเพื่อดูโควต้าอย่างละเอียด

Q: Does this work with image files as well as PDFs?
A: แน่นอน API เดียวกันรองรับ JPEG, PNG, BMP และรูปแบบภาพทั่วไปอื่น ๆ

Resources

อัปเดตล่าสุด: 2026-01-21
ทดสอบด้วย: GroupDocs.Watermark 24.11 for Java
ผู้เขียน: GroupDocs