Thêm watermark vào excel bằng GroupDocs.Watermark Java

Việc thêm watermark vào các tệp Excel của bạn có thể là một bước đột phá—cho dù bạn cần bảo vệ dữ liệu nhạy cảm, gắn thương hiệu cho báo cáo, hoặc chỉ đơn giản là tạo nét chuyên nghiệp. Trong hướng dẫn này, bạn sẽ học cách thêm watermark vào excel cho các bảng tính bằng GroupDocs.Watermark cho Java, với các giải thích rõ ràng, các trường hợp thực tế, và các mẹo để tránh những lỗi thường gặp.

Câu trả lời nhanh

  • Thư viện tôi cần là gì? GroupDocs.Watermark for Java (phiên bản mới nhất).
  • Các định dạng Excel nào được hỗ trợ? .xlsx và .xls (không được mã hoá).
  • Tôi có thể thêm watermark hình ảnh không? Có – SDK hỗ trợ cả watermark văn bản và hình ảnh.
  • Tôi có cần giấy phép cho môi trường sản xuất không? Cần giấy phép thương mại cho các triển khai không dùng bản thử nghiệm.
  • Thời gian triển khai mất bao lâu? Khoảng 10‑15 phút cho một watermark văn bản cơ bản.

add watermark to excel là gì?

Thêm watermark vào một workbook Excel có nghĩa là dán một văn bản (hoặc hình ảnh) có thể nhìn thấy (hoặc bán trong suốt) lên mọi worksheet hoặc tài liệu nhúng. Điều này giúp bạn khẳng định quyền sở hữu, chỉ ra tính bảo mật, hoặc tăng cường thương hiệu trên toàn bộ tệp.

Tại sao nên sử dụng GroupDocs.Watermark cho Java?

GroupDocs.Watermark offers a high‑level API that abstracts the complexity of dealing with Office Open XML structures. It lets you:

  • Áp dụng watermark cho nhiều worksheet trong một lần gọi.
  • Xử lý các tệp đính kèm nhúng (ví dụ: PDF nhúng) một cách tự động.
  • Bảo tồn định dạng và công thức gốc.
  • Làm việc với cả watermark văn bản và hình ảnh (ví dụ: add image watermark java).

Yêu cầu trước

  • Môi trường phát triển Java – Java 8 hoặc cao hơn (JDK).
  • GroupDocs.Watermark cho Java SDK – tải phiên bản mới nhất từ here.
  • IDE – IntelliJ IDEA, Eclipse, hoặc bất kỳ trình chỉnh sửa nào hỗ trợ Java.
  • Bảng tính mẫu – một tệp .xlsx bạn muốn bảo vệ.

Bạn có thể thêm SDK vào dự án của mình qua Maven, Gradle, hoặc bằng cách đặt các tệp JAR vào classpath thủ công.

Nhập các gói

Các import này cung cấp cho bạn quyền truy cập vào các lớp watermark cốt lõi, xử lý bảng tính và tiện ích phông chữ.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.examples.Constants;
import com.groupdocs.watermark.domain.DocumentInfo;
import com.groupdocs.watermark.domain.FileType;
import com.groupdocs.watermark.domain.content.SpreadsheetContent;
import com.groupdocs.watermark.domain.content.SpreadsheetWorksheet;
import com.groupdocs.watermark.domain.content.SpreadsheetAttachment;
import com.groupdocs.watermark.domain.document.IDocumentInfo;
import com.groupdocs.watermark.domain.loadoptions.SpreadsheetLoadOptions;
import com.groupdocs.watermark.domain.wrappers.TextWatermark;
import java.awt.Font;

Cách watermark spreadsheet – Hướng dẫn từng bước

Dưới đây là hướng dẫn thực tế, có đánh số, cho thấy chính xác cách watermark spreadsheet các tệp bằng Java. Mỗi bước bao gồm một giải thích ngắn gọn và sau đó là khối mã gốc (không thay đổi).

Bước 1: Thiết lập Đối tượng Watermark của bạn

Tại sao? Đối tượng này xác định giao diện hình ảnh của dấu mà bạn sẽ áp dụng.

TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 19));

Bước 2: Tải Bảng tính

Tại sao? Mở workbook cung cấp cho SDK một đối tượng để chỉnh sửa.

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("your-file-path.xlsx", loadOptions);

Bước 3: Truy cập Nội dung Bảng tính và Các Worksheet

Tại sao? Các tệp Excel có thể chứa nhiều sheet; bạn cần lặp qua từng sheet.

SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {
    // Process each worksheet
}

Bước 4: Lặp qua Các Tệp Đính Kèm trong Mỗi Worksheet

Tại sao? Một số worksheet nhúng các tài liệu khác (ví dụ: PDF). Xử lý chúng đảm bảo watermark đồng nhất trên toàn bộ tệp.

for (SpreadsheetAttachment attachment : worksheet.getAttachments()) {
    IDocumentInfo info = attachment.getDocumentInfo();
    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
        // Process the supported attachment
    }
}

Bước 5: Thêm watermark cho Mỗi Tài liệu Đính kèm

Tại sao? Bạn muốn có cùng dấu “Confidential” trên mọi tệp được nhúng.

Watermarker attachedWatermarker = attachment.createWatermarker();
attachedWatermarker.add(watermark);
attachment.updateContent(attachedWatermarker);
attachedWatermarker.close();

Bước 6: Lưu Tất cả Thay đổi

Tại sao? Lưu các thay đổi vào một workbook mới.

watermarker.save("your-output-file.xlsx");

Bước 7: Đóng Tài nguyên

Tại sao? Giải phóng tài nguyên ngăn ngừa rò rỉ bộ nhớ, đặc biệt khi xử lý các workbook lớn.

watermarker.close();

Kết hợp Tất cả: Ví dụ Hoàn chỉnh

Lớp sau kết hợp mọi bước thành một chương trình có thể chạy được. Không chỉnh sửa khối mã – nó giống hệt ví dụ gốc.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.domain.DocumentInfo;
import com.groupdocs.watermark.domain.FileType;
import com.groupdocs.watermark.domain.content.SpreadsheetContent;
import com.groupdocs.watermark.domain.content.SpreadsheetWorksheet;
import com.groupdocs.watermark.domain.content.SpreadsheetAttachment;
import com.groupdocs.watermark.domain.loadoptions.SpreadsheetLoadOptions;
import com.groupdocs.watermark.domain.wrappers.TextWatermark;
import java.awt.Font;

public class WatermarkSpreadsheet {
    public static void main(String[] args) {
        try {
            // Step 1: Create watermark
            TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 19));
            
            // Step 2: Load spreadsheet
            SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
            Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx", loadOptions);
            
            // Step 3: Access content and worksheets
            SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
            for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {
                
                // Step 4: Loop attachments
                for (SpreadsheetAttachment attachment : worksheet.getAttachments()) {
                    DocumentInfo info = attachment.getDocumentInfo();
                    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
                        
                        // Step 5: Watermark attached documents
                        Watermarker attachedWatermarker = attachment.createWatermarker();
                        attachedWatermarker.add(watermark);
                        attachment.updateContent(attachedWatermarker);
                        attachedWatermarker.close(); // Clean up
                    }
                }
            }
            // Step 6: Save modifications
            watermarker.save("path/to/output/spreadsheet_watermarked.xlsx");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // Step 7: Close resources
            // (Ensure resources are closed)
        }
    }
}

Các vấn đề thường gặp và Giải pháp

Vấn đềNguyên nhânCách khắc phục
Workbook được mã hoá bị bỏ quaSDK không thể đọc các tệp được mã hoá nếu không có mật khẩu.Giải mã tệp trước hoặc cung cấp mật khẩu qua SpreadsheetLoadOptions.setPassword("pwd").
Watermark không hiển thị trên một số sheetSheet có thể có chế độ xem tùy chỉnh hoặc bảo vệ khiến các đối tượng vẽ bị ẩn.Tắt bảo vệ sheet trước khi thêm watermark, sau đó bật lại nếu cần.
Hiệu năng chậm trên tệp lớnViệc tải toàn bộ workbook vào bộ nhớ có thể tốn kém.Xử lý các worksheet theo lô hoặc tăng kích thước heap JVM (-Xmx2g).
Watermark hình ảnh bị biến dạngCài đặt tỉ lệ không đúng.Sử dụng ImageWatermark với các tham số width/height rõ ràng để duy trì tỷ lệ khung hình.

Câu hỏi thường gặp

Q: Tôi có thể thêm watermark hình ảnh thay vì văn bản không?
A: Có. Sử dụng ImageWatermark từ SDK và truyền một đối tượng java.awt.Image. Điều này đáp ứng trường hợp add image watermark java.

Q: Làm sao tôi kiểm soát vị trí của watermark?
A: Lớp TextWatermark (hoặc ImageWatermark) cung cấp các thuộc tính như setHorizontalAlignment, setVerticalAlignment, và setOpacity để tinh chỉnh vị trí và độ trong suốt.

Q: Có thể watermark nhiều tệp Excel trong một lần chạy không?
A: Chắc chắn. Đặt toàn bộ quy trình trong một vòng lặp for duyệt qua thư mục các tệp, và tái sử dụng cùng một đối tượng TextWatermark.

Q: Điều gì sẽ xảy ra nếu bảng tính chứa biểu đồ?
A: Biểu đồ được coi là các đối tượng vẽ riêng; watermark được áp dụng trên canvas của worksheet, vì vậy biểu đồ không bị ảnh hưởng nhưng vẫn được phủ bởi dấu mờ trong suốt.

Q: Tôi có thể xóa watermark đã thêm trước đó không?
A: SDK có các phương thức watermarker.remove(watermark), nhưng bạn cần giữ một tham chiếu tới đối tượng watermark gốc hoặc tìm kiếm theo văn bản/nội dung để xác định nó.

Cập nhật lần cuối: 2026-03-27
Kiểm tra với: GroupDocs.Watermark 23.12 (Java)
Tác giả: GroupDocs