Cách thêm watermark vào tệp đính kèm Excel bằng GroupDocs.Watermark cho Java

Giới thiệu

Nếu bạn cần thêm watermark vào excel workbook—đặc biệt là những workbook chứa các tệp PDF, hình ảnh hoặc các tệp hỗ trợ khác—hướng dẫn này dành cho bạn. Hãy tưởng tượng bạn vừa hoàn thành việc chuẩn bị một báo cáo kinh doanh toàn diện trong Excel, kèm theo nhiều tệp đính kèm cung cấp thêm thông tin dữ liệu. Bằng cách thêm watermark dạng văn bản vào mỗi tệp đính kèm, bạn bảo vệ thương hiệu và biểu thị tính bảo mật trong một bước liền mạch. Trong tutorial này, chúng ta sẽ đi qua toàn bộ quy trình thêm watermark vào các tệp đính kèm Excel bằng GroupDocs.Watermark cho Java.

Câu trả lời nhanh

Thư viện tôi cần là gì? GroupDocs.Watermark for Java (Maven hoặc tải trực tiếp).
Nhiệm vụ chính mà tutorial này đề cập là gì? Thêm watermark dạng văn bản vào tất cả các tệp đính kèm trong một workbook Excel.
Tôi có cần giấy phép không? Bản dùng thử đủ cho việc đánh giá; cần giấy phép đầy đủ cho môi trường sản xuất.
Tôi có thể xử lý nhiều tệp đính kèm cùng lúc không? Có—code sẽ lặp qua mọi tệp đính kèm một cách tự động.
Java 8 có đủ không? Có, Java 8 hoặc cao hơn được hỗ trợ.

Những gì bạn sẽ học

Cách thiết lập GroupDocs.Watermark trong một dự án Java.
Mã từng bước để java add text watermark vào mỗi tệp được nhúng.
Các kịch bản thực tế như add confidential watermark excel cho báo cáo nội bộ.

Hãy đi vào các yêu cầu trước khi chúng ta bắt đầu viết mã.

Yêu cầu trước

Trước khi bắt đầu, hãy chắc chắn bạn có những thứ sau:

Thư viện và phụ thuộc cần thiết

Bạn sẽ cần GroupDocs.Watermark cho Java. Để tích hợp nó vào dự án, sử dụng Maven hoặc phương pháp tải trực tiếp.

Yêu cầu cài đặt môi trường

Phiên bản JDK tương thích (Java 8 hoặc cao hơn).
Một IDE như IntelliJ IDEA hoặc Eclipse.

Kiến thức nền tảng

Hiểu biết về lập trình Java là cần thiết. Kiến thức cơ bản về xử lý tệp và cấu hình XML Maven cũng sẽ hữu ích.

Cài đặt GroupDocs.Watermark cho Java

Để bắt đầu, cài đặt thư viện GroupDocs.Watermark.

Cài đặt Maven

Thêm kho và phụ thuộc sau vào tệp pom.xml của bạn:

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

Tải trực tiếp

Hoặc, tải phiên bản mới nhất từ GroupDocs.Watermark for Java releases.

Nhận giấy phép

Để sử dụng GroupDocs.Watermark:

Bắt đầu với bản dùng thử miễn phí bằng cách tải thư viện.
Nhận giấy phép tạm thời để truy cập đầy đủ các tính năng.
Mua giấy phép cho việc sử dụng lâu dài.

Khởi tạo và cài đặt cơ bản

Khởi tạo dự án của bạn bằng cách tạo một thể hiện của Watermarker:

import com.groupdocs.watermark.Watermarker;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(inputFilePath, new SpreadsheetLoadOptions());

Hướng dẫn triển khai

Bây giờ bạn đã sẵn sàng, hãy đi qua java process excel attachments từng bước.

Thêm watermark dạng văn bản vào tệp đính kèm Excel

Tính năng này cho phép bạn apply watermark to spreadsheet các tệp đính kèm trong một lần duy nhất.

1. Tạo đối tượng TextWatermark

Đầu tiên, định nghĩa watermark của bạn bằng TextWatermark:

import com.groupdocs.watermark.watermarks.TextWatermark;
import com.groupdocs.watermark.common.Font;

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

2. Tải tài liệu Spreadsheet

Mở spreadsheet bằng SpreadsheetLoadOptions:

import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(inputFilePath, new SpreadsheetLoadOptions());

3. Truy cập và xử lý các tệp đính kèm

Lặp qua các tệp đính kèm của tài liệu để áp dụng watermark:

import com.groupdocs.watermark.contents.SpreadsheetContent;
import com.groupdocs.watermark.common.FileType;
import com.groupdocs.watermark.common.IDocumentInfo;
import com.groupdocs.watermark.contents.SpreadsheetAttachment;

var content = watermarker.getContent(SpreadsheetContent.class);
for (SpreadsheetAttachment attachment : content.getWorksheets().stream()
    .flatMap(worksheet -> worksheet.getAttachments().stream())
    .toList()) {
    
    IDocumentInfo info = attachment.getDocumentInfo();
    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
        Watermarker attachedWatermarker = attachment.createWatermarker();

        // Add the watermark to the attachment
        attachedWatermarker.add(watermark);

        // Save changes in the attached file
        attachment.updateContent(attachedWatermarker);
        
        attachedWatermarker.close();
    }
}

4. Lưu tài liệu đã thêm watermark

Sau khi tất cả các tệp đính kèm được xử lý, lưu tài liệu của bạn:

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/spreadsheet_with_watermarks.xlsx";
watermarker.save(outputFilePath);

watermarker.close();

Mẹo khắc phục sự cố

Xác minh rằng các đường dẫn tệp đúng và các tệp tồn tại.
Đảm bảo phiên bản thư viện GroupDocs.Watermark khớp với phiên bản khai báo trong pom.xml của bạn.
Nếu một tệp đính kèm được mã hóa, code sẽ bỏ qua nó—cân nhắc giải mã trước nếu cần.

Ứng dụng thực tiễn

Dưới đây là một số kịch bản thực tế mà add watermark to excel trở nên cần thiết:

Corporate Branding – Chèn logo hoặc tên công ty của bạn vào mỗi tệp đính kèm.
Confidentiality Marks – Gắn nhãn báo cáo là “Confidential” để ngăn chặn việc chia sẻ trái phép.
Document Authentication – Nhúng các định danh duy nhất chứng minh nguồn gốc của tài liệu.

Bạn cũng có thể kết hợp cách tiếp cận này với Hệ thống Quản lý Tài liệu (DMS) để xử lý hàng trăm spreadsheet một cách tự động.

Các cân nhắc về hiệu suất

Tối ưu hoá hiệu suất

Sử dụng API streaming và tránh tải toàn bộ các tệp đính kèm lớn vào bộ nhớ cùng một lúc.
Đối với xử lý hàng loạt, cân nhắc sử dụng parallel streams của Java để xử lý đồng thời nhiều worksheet.

Hướng dẫn sử dụng tài nguyên

Giám sát việc sử dụng heap, đặc biệt khi làm việc với các tệp Excel lớn chứa nhiều hình ảnh độ phân giải cao.

Thực hành tốt cho quản lý bộ nhớ

Luôn đóng các thể hiện Watermarker (như trong mã).
Ưu tiên sử dụng try‑with‑resources hoặc khối finally để đảm bảo dọn dẹp.

Kết luận

Bây giờ bạn đã biết cách add watermark to excel các tệp đính kèm bằng GroupDocs.Watermark cho Java. Kỹ thuật này tăng cường thương hiệu, thêm lớp bảo mật và tích hợp mượt mà vào quy trình Java hiện có.

Các bước tiếp theo

Khám phá watermark hình ảnh hoặc dán dấu lên các loại tệp khác.
Tự động hoá quy trình bằng một công việc định kỳ để xử lý các báo cáo đến.

Hãy thử ngay hôm nay và xem nó giúp tối ưu hoá quy trình bảo mật tài liệu của bạn như thế nào!

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

Q1: Tôi có thể áp dụng watermark cho các tệp đính kèm không phải văn bản không?
Có, bạn có thể thêm watermark dạng văn bản vào hình ảnh và PDF trong các tệp đính kèm Excel bằng cùng một quy trình.

Q2: Làm sao để đảm bảo watermark của tôi hiển thị trên mọi trang của tài liệu?
Điều chỉnh kích thước phông chữ, màu sắc và độ trong suốt trong hàm khởi tạo TextWatermark để phù hợp với các bố cục trang khác nhau.

Q3: GroupDocs.Watermark hỗ trợ những định dạng tệp nào?
GroupDocs.Watermark hỗ trợ Word, PDF, Excel, PowerPoint và các định dạng hình ảnh phổ biến như PNG và JPG.

Q4: Có bất kỳ giới hạn nào về số lượng tệp đính kèm tôi có thể xử lý không?
Không có giới hạn cứng, nhưng thời gian xử lý tăng theo số lượng tệp đính kèm—sử dụng xử lý song song cho các lô lớn.

Q5: Watermark có thể bị xóa hoặc chỉnh sửa sau khi đã thêm không?
Watermark được nhúng; để thay đổi chúng, bạn cần xử lý lại tài liệu với watermark mới.

Tài nguyên

Tài liệu: GroupDocs.Watermark Java Documentation
Tham chiếu API: API Reference for GroupDocs.Watermark
Tải xuống Thư viện: GroupDocs.Watermark Releases
Kho GitHub: GroupDocs Watermark GitHub
Diễn đàn Hỗ trợ Miễn phí: GroupDocs Forum

Cập nhật lần cuối: 2026-03-25
Kiểm thử với: GroupDocs.Watermark 24.11 for Java
Tác giả: GroupDocs