كيفية تعيين الترخيص لـ GroupDocs Watermark في Java

Protecting intellectual property is a top priority for modern applications, and watermarks are a proven way to deter unauthorized distribution. If you’re using GroupDocs.Watermark for Java, you’ll need a license that can track usage and scale with demand. This tutorial explains how to set license for GroupDocs.Watermark in Java, from installing the SDK to configuring a metered key that reports consumption back to the service.

إجابات سريعة

  • ما هو الترخيص القائم على الاستخدام؟ إنه ترخيص يعتمد على الاستخدام يسجل كل استدعاء API، مما يتيح لك الدفع فقط مقابل ما تستهلكه.
  • هل أحتاج إلى تجربة أولاً؟ نعم، يمكنك طلب ترخيص مؤقت من موقع GroupDocs لتقييم المنتج.
  • ما نسخة Java المطلوبة؟ Java 8 أو أحدث؛ تم تجميع SDK لـ JDK 8+.
  • هل يمكنني التحويل إلى ترخيص دائم لاحقًا؟ بالتأكيد – فقط استبدل مفاتيح الترخيص القائم على الاستخدام بملف ترخيص دائم.
  • هل الإعداد متوافق مع Maven؟ نعم، تم توفير إحداثيات Maven لإدارة الاعتمادات بسلاسة.

ما هو الترخيص القائم على الاستخدام لـ GroupDocs Watermark؟

الترخيص القائم على الاستخدام هو امتياز مدعوم بالسحابة توفره GroupDocs يسجل كل عملية وضع علامة مائية يتم تنفيذها بواسطة SDK. يتم تسجيل كل استدعاء API على خادم ترخيص GroupDocs، مما يتيح الفوترة بنظام الدفع حسب الاستخدام بناءً على الاستخدام الفعلي. يمنح هذا النموذج المطورين رؤية فورية لاستهلاك الموارد ويساعد في التحكم في التكاليف مع ضمان الوصول الكامل إلى جميع الميزات.

لماذا استخدام ترخيص قائم على الاستخدام مع GroupDocs Watermark؟

يدعم GroupDocs.Watermark أكثر من خمسين تنسيقًا للإدخال والإخراج — بما في ذلك PDF و DOCX و PPTX وأنواع الصور المختلفة — ويمكنه معالجة ملفات تصل إلى 1 GB دون تحميل المستند بالكامل في الذاكرة، مما يحافظ على الأداء. باستخدام ترخيص قائم على الاستخدام تدفع فقط مقابل العمليات التي تنفذها فعليًا، مما يسمح للحل بالتوسع بتكلفة فعّالة مع الحفاظ على الوصول الكامل إلى جميع الميزات.

المتطلبات المسبقة

  • GroupDocs.Watermark for Java الإصدار 24.11 أو أحدث.
  • مجموعة تطوير Java (JDK) 8 أو أحدث مثبتة ومُكوَّنة.
  • إلمام أساسي بـ Maven أو إدارة ملفات JAR يدويًا.
  • مفتاح ترخيص مؤقت أو دائم من بوابة GroupDocs.

كيفية تعيين ترخيص قائم على الاستخدام لـ GroupDocs Watermark في Java؟

حمّل مفاتيحك العامة والخاصة، أنشئ كائن Metered، وطبق الترخيص — كل ذلك في ثلاث خطوات مختصرة. يضمن هذا النهج أن يتم احتساب كل طلب وضع علامة مائية ضد حسابك، مما يمنحك رؤية كاملة لاستهلاك الموارد.

الخطوة 1: تعريف المفاتيح العامة والخاصة

Enter the keys you received after registering for a temporary license.

Metered هو فئة GroupDocs.Watermark التي تتعامل مع الترخيص القائم على الاستخدام وتتبع الاستخدام.
ضع مفاتيحك في موقع آمن (متغيرات البيئة، تكوين مشفر، إلخ) قبل استخدامها في الشيفرة.

الخطوة 2: إنشاء مثال من فئة Metered

Instantiate the Metered object with your keys. This object will be passed to the watermark engine during initialization.

Metered metered = new Metered(System.getenv("GROUPDOCS_PUBLIC_KEY"),
                               System.getenv("GROUPDOCS_PRIVATE_KEY"));

الخطوة 3: تعيين الترخيص القائم على الاستخدام باستخدام المفاتيح المقدمة

Call the setLicense method (or the equivalent API call) with your public and private keys. Once set, all subsequent watermark operations will be billed according to your usage.

WatermarkEngine engine = new WatermarkEngine();
engine.setMeteredLicense(metered);

نصيحة احترافية: احفظ المفاتيح خارج التحكم في المصدر. استخدم مدير أسرار أو ملف خصائص مشفر لتجنب الكشف غير المقصود.

إعداد GroupDocs.Watermark لـ Java

معلومات التثبيت

Integrate GroupDocs.Watermark into your project using Maven or by downloading the JAR directly.

إعداد Maven:
Add the following configuration in your pom.xml file:

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

تحميل مباشر:
Download the latest version from GroupDocs.Watermark for Java releases.

الحصول على الترخيص

To unlock full functionality, obtain a free trial or temporary license:

  • سجّل في موقع GroupDocs للبدء.
  • بعد الحصول على مفاتيحك، دمجها في مشروعك كما هو موضح في دليل التنفيذ.

التهيئة الأساسية والإعداد

Once the SDK is added to your project, import the necessary namespaces and create the watermark engine instance as demonstrated in the code snippets above.

نصائح استكشاف الأخطاء وإصلاحها

  • مفاتيح غير صالحة: تحقق مرة أخرى من تطابق المفاتيح العامة والخاصة تمامًا؛ أي خطأ إملائي واحد سيمنع التفعيل.
  • أخطاء مسار ملف الترخيص: إذا كنت تفضّل ترخيصًا قائمًا على ملف، تأكد من أن مسار الملف مطلق أو يتم حله بشكل صحيح بالنسبة إلى دليل العمل.
  • مشكلات الشبكة: يتطلب الترخيص القائم على الاستخدام استدعاءات HTTPS صادرة؛ تحقق من أن جدار الحماية يسمح بالاتصال بـ api.groupdocs.com.

تطبيقات عملية

  1. أمان المستندات: أضف علامات مائية مرئية أو غير مرئية إلى ملفات PDF ومستندات Word والصور لحماية البيانات الحساسة للشركة.
  2. تتبع الاستخدام: أنشئ تقارير عن عدد المستندات التي تم وضع علامة مائية عليها يوميًا، مفيدة للميزانية والامتثال.
  3. تكامل CMS: أتمتة إدراج العلامة المائية أثناء سير عمل نشر المحتوى، مع تطبيق الترخيص تلقائيًا.

اعتبارات الأداء

تحسين الأداء:

  • ضع العلامات المائية فقط عند الضرورة؛ تخطى معالجة الملفات التي تم حمايتها بالفعل.
  • بالنسبة للدفعات الكبيرة، أعد استخدام نفس مثال WatermarkEngine لتجنب عبء التهيئة المتكرر.

أفضل الممارسات:

  • راقب استخدام ذاكرة JVM heap عند معالجة ملفات PDF التي تحتوي على مئات الصفحات؛ فكر في استخدام واجهات برمجة التطبيقات المتدفقة إذا أصبحت الذاكرة عنق زجاجة.
  • فعّل التسجيل على مستوى INFO لالتقاط استدعاءات الترخيص دون إغراق وحدة التحكم.

الخلاصة

في هذا الدليل غطينا كيفية تعيين الترخيص لـ GroupDocs.Watermark في Java، من تثبيت Maven إلى تكوين المفتاح القائم على الاستخدام. باتباع الخطوات، ستحصل على تتبع دقيق للاستخدام، وفوترة مرنة، وحماية مستندات قوية — كل ذلك دون التضحية بالأداء.

الخطوات التالية:

  • جرّب أنماط علامات مائية مختلفة (نص، صورة، مائل).
  • استكشف الميزات المتقدمة مثل العلامات المائية الشرطية بناءً على أدوار المستخدم.
  • راجع لوحة تحكم تحليلات GroupDocs لمراقبة اتجاهات الاستهلاك.

هل أنت مستعد لحماية مستنداتك؟ نفّذ الحل اليوم وتمتع براحة البال مع العلم أن أصولك محمية وتكاليف الترخيص واضحة.

الأسئلة المتكررة

س: ما الفرق بين الترخيص المؤقت والترخيص الدائم؟
الترخيص المؤقت محدود بالوقت ومثالي للتقييم، بينما يوفر الترخيص الدائم استخدامًا غير محدود دون رسوم متكررة.

س: هل يمكنني التحويل من ترخيص قائم على الاستخدام إلى ترخيص دائم دون تغييرات في الشيفرة؟
نعم — استبدل تهيئة المفتاح القائم على الاستخدام بنداء إلى engine.setLicense("path/to/license/file").

س: ماذا يحدث إذا كان خدمة الترخيص القائم على الاستخدام غير متاحة؟
يتحول SDK إلى وضع غير متصل؛ تستمر عملية وضع العلامة المائية لكن لن يتم الإبلاغ عن الاستخدام حتى يتم استعادة الاتصال.

س: هل هناك حدود لحجم الملفات للعلامة المائية؟
يمكن لـ SDK معالجة ملفات تصل إلى 1 GB؛ يجب تقسيم الملفات الأكبر أو معالجتها في وضع التدفق.

س: هل يعمل الترخيص القائم على الاستخدام على جميع أنظمة التشغيل؟
يعمل على أي منصة تدعم Java 8+، بما في ذلك Windows و Linux و macOS.

Last Updated: 2026-07-30
Tested With: GroupDocs.Watermark 24.11 for Java
Author: GroupDocs

الموارد

<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>

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

// 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

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

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

دروس ذات صلة