تعيين ترخيص GroupDocs Java – دليل الترخيص

في هذا الدرس الشامل ستكتشف كيفية تعيين ترخيص groupdocs java لتطبيقات الإنتاج. يفتح الترخيص الصحيح كامل مجموعة ميزات GroupDocs.Metadata—مثل استخراج البيانات الوصفية، التحرير، وفحوصات الامتثال—مع الحفاظ على توافق نشرك قانونيًا. سنستعرض وضع ملف الترخيص، التحميل عبر InputStream، وخيارات الترخيص المدفوع حسب الاستخدام، حتى تتمكن من دمج GroupDocs.Metadata بثقة في أي مشروع Java.

إجابات سريعة

  • ما نوع الملف المطلوب لترخيص GroupDocs.Metadata؟ ملف XML بسيط بامتداد .lic يحتوي على مفتاح الترخيص المشفر.
  • هل يمكنني تحميل الترخيص من تدفق؟ نعم—استخدم 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 بدون قيود التقييم. يتضمن ذلك تحميل ملف XML .lic المقدم أثناء التشغيل، مما يزيل علامات التجربة، ويتيح معالجة غير محدودة للمستندات، ويفعل ميزات متقدمة لمعالجة البيانات الوصفية عبر جميع الصيغ المدعومة.

لماذا تستخدم ترخيص GroupDocs.Metadata في Java؟

GroupDocs.Metadata يدعم أكثر من 30 صيغة إدخال وإخراج—بما في ذلك PDF و DOCX و XLSX و PPTX وملفات الصور—ويمكنه معالجة المستندات حتى 2 GB من الحجم مع الحفاظ على استهلاك الذاكرة أقل من 150 MB بفضل بنية البث. الترخيص الصحيح يضمن توفر 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، مما يؤكد أن الترخيص تم تطبيقه بشكل صحيح.

كيفية استخدام الترخيص المدفوع حسب الاستخدام (pay‑per‑use) في 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 للفوترة.

المشكلات الشائعة والحلول

  • ملف الترخيص غير موجود – تأكد من وجود الملف في مسار الفئة (src/main/resources) وأشر إليه بشرطة مائلة أولية (/GroupDocs.Metadata.lic).
  • خطأ ترخيص غير صالح – تحقق من أن ملف .lic يتطابق مع نسخة المنتج التي تستخدمها؛ أعد إنشائه من بوابة GroupDocs إذا لزم الأمر.
  • تم رفض مفتاح الترخيص المدفوع حسب الاستخدام – تحقق مرة أخرى من سلسلة المفتاح لتأكد من عدم وجود مسافات إضافية أو فواصل أسطر؛ يجب أن يكون المفتاح سطرًا واحدًا مستمرًا.

الدروس المتاحة

كيفية تعيين ترخيص GroupDocs.Metadata في Java باستخدام InputStream

تعلم كيفية تكوين ترخيص GroupDocs.Metadata باستخدام InputStream في Java. افتح ميزات إدارة المستندات المتقدمة من خلال هذا الدليل خطوة بخطوة.

موارد إضافية

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

س: هل يمكنني استخدام نفس ملف الترخيص لعدة خدمات Java؟
ج: نعم، يمكن مشاركة ملف .lic واحد عبر أي عدد من تطبيقات Java طالما أنها تعمل وفق نفس اتفاقية الترخيص.

س: هل يدعم الترخيص النشر السحابي (مثل AWS، Azure)؟
ج: بالتأكيد؛ الترخيص غير مرتبط ببيئة معينة. فقط تأكد من أن الملف متاح لحاوية وقت التشغيل.

س: كيف أتحول من نسخة تجريبية إلى ترخيص كامل دون توقف؟
ج: انشر ملف .lic الجديد وأعد تشغيل التطبيق؛ سيقوم SDK بقراءة الترخيص الجديد عند التهيئة التالية.

س: ماذا يحدث إذا انتهى صلاحية مفتاح الترخيص المدفوع حسب الاستخدام؟
ج: ستبدأ استدعاءات API بإرجاع استثناء ترخيص. قم بتحديث المفتاح من حساب GroupDocs الخاص بك لاستئناف الاستخدام.

س: هل هناك طريقة للتحقق برمجيًا من رصيد الاستخدام المتبقي؟
ج: نعم، استدعِ Metered.getUsageInfo() للحصول على الاستهلاك الحالي والرصيد المتبقي.

آخر تحديث: 2026-06-07
تم الاختبار مع: GroupDocs.Metadata 23.12 for Java
المؤلف: GroupDocs

دروس ذات صلة