نحوه افزودن واترمارک در Excel با Java - گام به گام

بارگذاری Workbook با ExcelLoadOptions

1. بارگذاری کتاب کار Excel: از Watermarker همراه با ExcelLoadOptions برای باز کردن فایل استفاده کنید.

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

کلاس Watermarker در API reference مستند شده است. بارگذاری با 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 درجه آن را به صورت قطری در سراسر صفحه قرار می‌دهد. می‌توانید این مقادیر را برای مطابقت با راهنمایی‌های برند یا الزامات انطباق تنظیم کنید.

اعمال واترمارک بر تمام برگه‌ها

3. افزودن واترمارک به کتاب کار: متد add آن را به تمام برگه‌ها در یک فراخوانی اعمال می‌کند.

watermarker.add(watermark);

اگر به کنترل بر پایه هر برگه نیاز دارید، می‌توانید برگه‌های جداگانه را از طریق watermarker.getWorksheets() دریافت کنید و برای هر یک به‌صورت جداگانه متد add را فراخوانی کنید.

ذخیرهٔ کتاب‌کار علامت‌دار شده

4. ذخیرهٔ کتاب‌کار علامت‌دار شده: ExcelSaveOptions را انتخاب کنید تا فرمت خروجی را کنترل کرده و متادیتای اصلی را حفظ کنید.

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

شیء ExcelSaveOptions به شما امکان می‌دهد تعیین کنید که آیا نسخهٔ اصلی فایل را نگه دارید یا به جدیدترین استاندارد XLSX ارتقا دهید.

آزاد کردن منابع برای جلوگیری از نشت حافظه

5. بستن Watermarker: منابع را آزاد کنید تا از نشت حافظه جلوگیری شود، به‌ویژه هنگام پردازش تعداد زیادی فایل به‌صورت دسته‌ای.

watermarker.close();

بستن Watermarker همچنین هر عملیات نوشتن معلقی را تخلیه می‌کند و اطمینان می‌دهد که فایل خروجی خراب نشود.

این مراحل نشان می‌دهند که چگونه می‌توانید در اکسل با استفاده از جاوا واترمارک اضافه کنید، در حالی که کنترل بر ظاهر و عملکرد را در اختیار دارید.

مثال کامل کد: درج واترمارک در اکسل با جاوا - واترمارک کامل جاوا

کد زیر کل فرآیند را از بارگذاری کتاب‌کار تا ذخیره‌سازی نتیجه نشان می‌دهد.

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 را برای افزودن واترمارک به اکسل مناسب می‌کند

پشتیبانی جامع از XLS/XLSX

این کتابخانه هم فرمت‌های قدیمی XLS و هم فرمت‌های مدرن XLSX را بدون نیاز به تبدیل مدیریت می‌کند و فرمول‌ها، نمودارها و ماکروها را حفظ می‌نماید.

حالت استریم کارآمد برای کتاب‌های کاری بزرگ

هنگام کار با کتاب‌های کاری که شامل هزاران ردیف هستند، با تنظیم loadOptions.setLoadAllWorksheets(false) استریم را فعال کنید. این کار مصرف حافظه را به طور چشمگیری کاهش می‌دهد.

گزینه‌های پیشرفته استایل‌گذاری واترمارک

می‌توانید خانوادهٔ قلم، اندازه، رنگ، شفافیت، زاویهٔ چرخش و تراز را کنترل کنید. جدول زیر مهم‌ترین ویژگی‌های معمولاً تنظیم‌شده را خلاصه می‌کند:

پوشش خودکار برگه‌ها

یک فراخوانی واحد به watermarker.add(watermark) نشان‌گر را به هر برگه منتقل می‌کند و از نوشتن حلقه‌های تکراری شما را نجات می‌دهد.

Simple Save Options

ExcelSaveOptions به شما امکان می‌دهد فرمت فایل اصلی را حفظ کنید یا به آخرین نسخه XLSX ارتقا دهید، و همچنین می‌توانید مشخص کنید آیا ماکروها حفظ شوند یا نه.

تمام این قابلیت‌ها به‌صورت جزئی در مستندات رسمی توضیح داده شده‌اند.

نتیجه‌گیری

در این آموزش یاد گرفتید که چگونه با استفاده از ویژگی‌های قدرتمند Conholdate.Total for Java در جاوا، واترمارک را در اکسل وارد کنید. با دنبال کردن راهنمای گام‌به‌گام، می‌توانید صفحات گسترده خود را با متن سفارشی محافظت کنید، ظاهر را کنترل کنید و فایل‌های بزرگ را به‌صورت کارآمد مدیریت کنید. برای استقرار در محیط تولید نیاز به نسخه دارای لایسنس دارید؛ قیمت‌ها را در صفحه قیمت‌گذاری بررسی کنید و برای ارزیابی SDK یک لایسنس موقت از صفحه لایسنس موقت دریافت کنید.

سوالات متداول

• چگونه به‌جای متن، یک واترمارک تصویر اضافه کنم؟
  از کلاس ImageWatermark استفاده کنید، شفافیت و تراز آن را تنظیم کنید و همانند مثال متن، آن را به نمونه Watermarker اضافه کنید. تصویر می‌تواند یک PNG، JPEG، یا BMP باشد و همچنین می‌توانید آن را برای متناسب شدن با کاربرگ مقیاس‌بندی کنید. برای جزئیات به API reference مراجعه کنید.

• آیا واترمارک پس از تبدیل کتاب کار به PDF قابل مشاهده خواهد بود؟
  بله. واترمارک در کتاب کار جاسازی شده است و در هر فرمتی که بعداً تبدیل کنید، مانند PDF، هنگام استفاده از Conholdate.Total for Java ظاهر خواهد شد. فرآیند تبدیل تمام عناصر بصری، از جمله واترمارک‌ها، را حفظ می‌کند.

• آیا می‌توانم واترمارک را به‌صورت برگه‑به‑برگه کنترل کنم؟
  SDK به‌طور پیش‌فرض واترمارک را بر تمام برگه‌ها اعمال می‌کند، اما می‌توانید برگه‌های جداگانه را با استفاده از watermarker.getWorksheets().get_Item(index) بارگذاری کنید و به‌صورت انتخابی add را بر هر یک فراخوانی کنید. این امکان کنترل دقیق‌تری را برای گزارش‌هایی که نیاز به برندینگ متفاوت برای هر برگه دارند، فراهم می‌کند.

• آیا برای توسعه و تست به مجوز نیاز دارم؟
  یک مجوز موقت برای ارزیابی در صفحه مجوز موقت موجود است. برای استفاده تجاری، یک مجوز کامل از طریق صفحه قیمت‌گذاری خریداری کنید. فایل مجوز باید همان‌طور که در بخش Setup نشان داده شده است، در زمان اجرا بارگذاری شود.

بیشتر بخوانید

• تبدیل اکسل به تصویر در جاوا
• تنظیم خودکار ردیف‌ها یا ستون‌ها در اکسل با استفاده از جاوا
• تبدیل تصویر به مقیاس خاکستری در جاوا