إدراج علامة مائية في Excel باستخدام Java

إدراج علامة مائية في جدول بيانات يساعد على حماية البيانات الحساسة ويشير إلى ملكية المستند. Conholdate.Total for Java توفر واجهة برمجة تطبيقات بسيطة تتيح لك إدراج علامة مائية في Excel باستخدام Java ببضع أسطر من الشيفرة فقط. يشرح هذا الدليل الإعداد المطلوب، والتنفيذ الكامل، وخيارات التكوين الرئيسية حتى تتمكن من تأمين دفاتر عمل Excel الخاصة بك بفعالية.

كيفية إدراج علامة مائية في Excel باستخدام Java - خطوة بخطوة

تحميل المصنف باستخدام ExcelLoadOptions

1. تحميل مصنف Excel: استخدم Watermarker مع ExcelLoadOptions لفتح الملف.

Watermarker watermarker = new Watermarker(inputPath, new ExcelLoadOptions());

تم توثيق فئة Watermarker في مرجع API. يتيح لك التحميل باستخدام ExcelLoadOptions التحكم في استخدام الذاكرة، وهو أمر أساسي للمصنفات الكبيرة.

إنشاء علامة مائية نصية مع تنسيق

2. إنشاء علامة مائية نصية: تحديد الخط، اللون، الشفافية، الدوران، والمحاذاة.

Font font = new Font("Arial", 36);
TextWatermark watermark = new TextWatermark("CONFIDENTIAL", font);
watermark.setColor(Color.RED);
watermark.setOpacity(0.3);
watermark.setRotationAngle(45);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);

ضبط opacity إلى 0.3 يجعل العلامة المائية شبه شفافة، بينما يضع الدوران بزاوية 45 درجة العلامة مائلةً عبر الورقة. يمكنك تعديل هذه القيم لتلبية إرشادات العلامة التجارية أو متطلبات الامتثال.

Apply the Watermark to All Worksheets

3. Add the watermark to the workbook: The add method applies it to every worksheet in a single call.

watermarker.add(watermark);

If you need per‑worksheet control, you can retrieve individual worksheets via watermarker.getWorksheets() and call add on each one separately.

حفظ المصنف المائي

4. حفظ المصنف المائي: اختر ExcelSaveOptions للتحكم في تنسيق الإخراج والحفاظ على البيانات الوصفية الأصلية.

watermarker.save(outputPath, new ExcelSaveOptions());

ExcelSaveOptions يتيح لك تحديد ما إذا كنت تريد الاحتفاظ بإصدار الملف الأصلي أو الترقية إلى أحدث معيار XLSX.

تحرير الموارد لتجنب تسرب الذاكرة

5. إغلاق Watermarker: تحرير الموارد لتجنب تسرب الذاكرة، خاصةً عند معالجة العديد من الملفات في دفعة.

watermarker.close();

إغلاق Watermarker يقوم أيضًا بتفريغ أي عمليات كتابة معلقة، مما يضمن عدم تلف ملف الإخراج.

توضح هذه الخطوات كيفية إدراج علامة مائية في Excel باستخدام Java مع منحك التحكم في المظهر والأداء.

مثال كامل للكود: إدراج علامة مائية في Excel باستخدام Java - علامة مائية كاملة في Java

الكود التالي يوضح العملية الكاملة من تحميل دفتر العمل إلى حفظ النتيجة.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.TextWatermark;
import com.groupdocs.watermark.common.Font;
import com.groupdocs.watermark.common.Color;
import com.groupdocs.watermark.contents.HorizontalAlignment;
import com.groupdocs.watermark.contents.VerticalAlignment;
import com.groupdocs.watermark.options.load.ExcelLoadOptions;
import com.groupdocs.watermark.options.save.ExcelSaveOptions;

public class ExcelWatermarkExample {
    public static void main(String[] args) {
        String inputPath = "input.xlsx";
        String outputPath = "output_watermarked.xlsx";

Watermarker watermarker = null;
        try {
            // Load the Excel workbook (works for both XLS and XLSX)
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            // For very large workbooks you can enable streaming mode:
            // loadOptions.setLoadAllWorksheets(false);
            watermarker = new Watermarker(inputPath, loadOptions);

// Create a text watermark with desired appearance
            Font font = new Font("Arial", 36);
            TextWatermark watermark = new TextWatermark("CONFIDENTIAL", font);
            watermark.setColor(Color.RED);
            watermark.setOpacity(0.3);               // 30% opacity
            watermark.setRotationAngle(45);          // diagonal
            watermark.setHorizontalAlignment(HorizontalAlignment.Center);
            watermark.setVerticalAlignment(VerticalAlignment.Center);

// Apply the watermark to all worksheets
            watermarker.add(watermark);

// Save the watermarked workbook
            ExcelSaveOptions saveOptions = new ExcelSaveOptions();
            watermarker.save(outputPath, saveOptions);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (watermarker != null) {
                watermarker.close();
            }
        }
    }
}

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input.xlsx, output_watermarked.xlsx) لتطابق مواقع ملفاتك الفعلية، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

إعداد البيئة

إضافة مستودع Maven والاعتماد

أضف مستودع Maven الخاص بـ Conholdate واعتماد SDK إلى ملف pom.xml الخاص بك:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

يمكنك أيضًا تنزيل أحدث ملفات JAR مباشرةً من صفحة التحميل. يتطلب SDK Java 8 أو أعلى، وسيجعل IDE متوافق مثل IntelliJ IDEA أو Eclipse عملية التصحيح أسهل.

تكوين الترخيص (استخدام الإنتاج)

قبل تشغيل كود العلامة المائية في بيئة الإنتاج، قم بتطبيق ملف الترخيص الخاص بك:

import com.groupdocs.watermark.License;

License license = new License();
license.setLicense("path/to/Conholdate.Total.Java.lic");

يتوفر ترخيص مؤقت للتقييم على صفحة ترخيص مؤقت. للمشاريع طويلة الأمد، راجع صفحة التسعير لاختيار الخطة المناسبة.

ما الذي يجعل Conholdate.Total for Java مناسبًا لإضافة العلامات المائية في Excel

دعم شامل لملفات XLS/XLSX

المكتبة تتعامل مع كل من صيغ XLS القديمة وXLSX الحديثة دون الحاجة إلى التحويل، مع الحفاظ على الصيغ والرسوم البيانية والماكروهات.

وضع البث الفعال لدفاتر العمل الكبيرة

عند العمل مع دفاتر العمل التي تحتوي على آلاف الصفوف، قم بتمكين البث عن طريق ضبط loadOptions.setLoadAllWorksheets(false). هذا يقلل من استهلاك الذاكرة بشكل كبير.

خيارات تنسيق العلامة المائية المتقدمة

يمكنك التحكم في عائلة الخط، الحجم، اللون، الشفافية، زاوية الدوران، والمحاذاة. يوضح الجدول أدناه الخصائص التي يتم تعديلها بشكل شائع:

تغطية ورقة العمل تلقائيًا

استدعاء واحد لـ watermarker.add(watermark) ينشر العلامة المائية إلى كل ورقة، مما يوفر عليك كتابة حلقات متكررة.

خيارات الحفظ البسيطة

ExcelSaveOptions تتيح لك الاحتفاظ بتنسيق الملف الأصلي أو الترقية إلى أحدث إصدار XLSX، ويمكنك أيضًا تحديد ما إذا كنت تريد الحفاظ على وحدات الماكرو.

جميع هذه القدرات موصوفة بالتفصيل في الوثائق الرسمية.

الخلاصة

في هذا البرنامج التعليمي تعلمت كيفية إدراج علامة مائية في Excel باستخدام Java باستخدام الميزات القوية لـ Conholdate.Total for Java. باتباع الدليل خطوة بخطوة، يمكنك حماية جداول البيانات الخاصة بك بنص مخصص، والتحكم في المظهر، ومعالجة الملفات الكبيرة بكفاءة. بالنسبة للنشر في بيئة الإنتاج ستحتاج إلى نسخة مرخصة؛ استكشف الأسعار على صفحة الأسعار واحصل على ترخيص مؤقت من صفحة الترخيص المؤقت لتقييم مجموعة تطوير البرمجيات.

الأسئلة الشائعة

• كيف يمكنني إضافة علامة مائية صورة بدلاً من النص؟
  استخدم الفئة ImageWatermark، عيّن شفافيّتها ومحاذاتها، وأضفها إلى كائن Watermarker كما في مثال النص. يمكن أن تكون الصورة بصيغة PNG، JPEG، أو BMP، ويمكنك أيضًا تغيير حجمها لتناسب ورقة العمل. راجع مرجع API للحصول على التفاصيل.

• هل سيكون العلامة المائية مرئية بعد تحويل دفتر العمل إلى PDF?
  نعم. يتم تضمين العلامة المائية في دفتر العمل وستظهر في أي تنسيق تقوم بتحويله لاحقًا، مثل PDF، عند استخدام Conholdate.Total for Java. تحتفظ عملية التحويل بجميع العناصر البصرية، بما في ذلك العلامات المائية.

• هل يمكنني التحكم في العلامة المائية على أساس كل ورقة عمل؟
  يطبق SDK العلامة المائية على جميع أوراق العمل بشكل افتراضي، ولكن يمكنك تحميل أوراق عمل فردية باستخدام watermarker.getWorksheets().get_Item(index) واستدعاء add على كل واحدة بشكل انتقائي. هذا يمنحك تحكمًا دقيقًا للتقارير التي تتطلب علامة تجارية مختلفة لكل ورقة.

• هل أحتاج إلى ترخيص للتطوير والاختبار؟
  يتوفر ترخيص مؤقت للتقييم في صفحة الترخيص المؤقت. للاستخدام التجاري، اشترِ ترخيصًا كاملاً عبر صفحة التسعير. يجب تحميل ملف الترخيص أثناء التشغيل كما هو موضح في قسم الإعداد.

اقرأ المزيد

• تحويل Excel إلى صورة في Java
• ضبط تلقائي للصفوف أو الأعمدة في Excel باستخدام Java
• تحويل الصورة إلى تدرج رمادي في Java