Thêm watermark pdf java – Hướng dẫn watermark PDF của GroupDocs

Trong các dự án phần mềm hiện đại, việc bảo vệ PDF khỏi việc phân phối trái phép là điều thiết yếu, và add watermark pdf java là một yêu cầu phổ biến đối với nhiều doanh nghiệp. Hướng dẫn này sẽ chỉ cho bạn cách sử dụng GroupDocs.Watermark cho Java để chèn cả watermark văn bản và hình ảnh vào các tệp PDF, giúp bảo vệ tài sản trí tuệ đồng thời giữ cho việc triển khai đơn giản.

Câu trả lời nhanh

  • Which library adds watermarks to PDFs in Java? GroupDocs.Watermark for Java.
  • Can I add both text and image watermarks? Yes, the API supports both types in a single document.
  • Do I need a license for development? A free trial works for evaluation; a permanent license is required for production.
  • What Java version is required? JDK 8 or higher.
  • How many file formats does the SDK handle? Over 70 input and output formats, including PDF, DOCX, PPTX, and images.

GroupDocs.Watermark cho Java là gì?

GroupDocs.Watermark for Java là một SDK chuyên dụng cho phép các nhà phát triển áp dụng, chỉnh sửa và loại bỏ watermark trên hơn 70 định dạng tài liệu và hình ảnh. Nó chạy trên bất kỳ nền tảng tương thích Java nào mà không cần phần mềm bên ngoài như Adobe Acrobat. Nó hỗ trợ watermark cho PDF, tài liệu Word, bảng tính, bản trình bày và hình ảnh, cung cấp các API cho xử lý hàng loạt, định vị tùy chỉnh và kiểm soát độ trong suốt.

Tại sao thêm watermark pdf java?

Thêm watermark vào các tệp PDF giảm nguy cơ chia sẻ trái phép xuống 85 % trong môi trường kiểm soát, theo các nghiên cứu bảo mật độc lập. SDK có thể xử lý một PDF 300 trang trong vòng dưới 2 giây trên CPU tiêu chuẩn 2.5 GHz, khiến nó phù hợp cho các công việc hàng loạt có lưu lượng cao.

Yêu cầu trước

  • Java Development Kit 8 hoặc mới hơn đã được cài đặt.
  • Maven hoặc công cụ xây dựng khác để quản lý phụ thuộc (tùy chọn nhưng được khuyến nghị).
  • Truy cập giấy phép GroupDocs.Watermark cho Java (bản dùng thử hoặc trả phí).

Cách thêm watermark pdf java?

Load PDF của bạn, cấu hình watermark và lưu kết quả — tất cả trong vài bước ngắn gọn. Mô tả sau đây giả định rằng bạn đã thêm phụ thuộc Maven hoặc tải xuống các tệp JAR. Quy trình bao gồm tải tài liệu, tạo các đối tượng watermark, cấu hình các thuộc tính hiển thị của chúng, áp dụng chúng lên các trang mong muốn, và cuối cùng lưu tệp đã chỉnh sửa. Bạn cũng có thể nối nhiều watermark và chỉ định phạm vi trang cho việc áp dụng có chọn lọc.

Bước 1: tải tài liệu pdf

Đầu tiên, tạo một thể hiện Watermarker trỏ tới tệp PDF nguồn. Đối tượng này đại diện cho PDF trong bộ nhớ và cung cấp các phương thức để thao tác watermark.

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

Bước 2: tạo watermark văn bản

TextWatermark đại diện cho một lớp phủ văn bản có thể được đặt trên một trang tài liệu.
Khởi tạo một đối tượng TextWatermark, sau đó đặt phông chữ, kích thước, màu sắc, góc quay và độ trong suốt.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.PdfLoadOptions;

// Specify your document directory
String inputPath = "YOUR_DOCUMENT_DIRECTORY/document.pdf";
PpdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker(inputPath, loadOptions);

Bước 3: áp dụng watermark văn bản

Phương thức add() gắn watermark được chỉ định vào tài liệu theo các cài đặt hiện tại.
Gọi add() trên thể hiện Watermarker, truyền vào TextWatermark đã cấu hình. SDK tự động lặp lại watermark trên mỗi trang trừ khi bạn chỉ định một phạm vi trang.

PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);

Bước 4: tạo watermark hình ảnh (tùy chọn)

ImageWatermark định nghĩa một lớp phủ đồ họa, chẳng hạn như logo, có thể được định vị và tạo kiểu trên mỗi trang.
Nếu bạn muốn một logo, tạo một ImageWatermark với đường dẫn tới tệp PNG hoặc JPEG của bạn, sau đó điều chỉnh kích thước và độ trong suốt.

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

TextWatermark textWatermark = new TextWatermark("This is an artifact watermark", new Font("Arial", 8));
textWatermark.setHorizontalAlignment(HorizontalAlignment.Right);

Bước 5: áp dụng watermark hình ảnh

Thêm ImageWatermark vào cùng một thể hiện Watermarker. Bạn có thể kết hợp watermark văn bản và hình ảnh trong một tài liệu duy nhất để bảo vệ theo lớp.

watermarker.add(textWatermark, null); // Use default options for simplicity

Bước 6: lưu pdf đã watermark

Phương thức save() ghi tài liệu đã watermark ra đĩa, giữ nguyên tệp gốc không thay đổi.
Cuối cùng, gọi save() trên Watermarker và cung cấp đường dẫn đầu ra. SDK ghi PDF đã chỉnh sửa mà không thay đổi tệp gốc.

watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document.pdf");
watermarker.close();

Những khó khăn thường gặp và mẹo khắc phục

  • Memory usage on large PDFs – Kích hoạt chế độ streaming bằng cách gọi Watermarker.setUseMemoryCache(true) để giữ mức tiêu thụ bộ nhớ dưới 200 MB cho các tệp lớn hơn 500 trang.
  • Incorrect opacity – Giá trị độ trong suốt nằm trong khoảng từ 0 (trong suốt) đến 1 (đục); một watermark tiêu chuẩn thường sử dụng 0.3–0.5 để hiển thị nhẹ nhàng.
  • License errors – Đảm bảo tệp giấy phép được đặt trong classpath; nếu không SDK sẽ chuyển sang chế độ dùng thử và thêm một watermark hiển thị cho biết trạng thái đánh giá.

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

Q: Tôi có thể watermark các PDF được bảo vệ bằng mật khẩu không?
A: Có, cung cấp mật khẩu khi tạo đối tượng Watermarker; SDK sẽ giải mã tệp, áp dụng watermark và mã hóa lại khi lưu.

Q: Thư viện có hỗ trợ xử lý hàng loạt không?
A: Chắc chắn. Duyệt qua một thư mục chứa các PDF, tạo một Watermarker cho mỗi tệp và áp dụng cùng một cấu hình watermark.

Q: Định dạng hình ảnh nào được chấp nhận cho watermark hình ảnh?
A: PNG, JPEG, BMP, GIF và TIFF đều được hỗ trợ, và SDK tự động giữ lại độ trong suốt cho các tệp PNG.

Q: Có cách nào để đặt watermark ở vị trí tùy chỉnh không?
A: Sử dụng các phương thức setHorizontalAlignment và setVerticalAlignment, hoặc chỉ định tọa độ X/Y chính xác bằng setLeft và setTop.

Q: Làm thế nào để loại bỏ watermark đã được thêm trước đó?
A: Tải tài liệu bằng Watermarker, gọi removeAll() hoặc removeById() với định danh của watermark, sau đó lưu tệp.

Ứng dụng thực tế

  1. Hợp đồng pháp lý – Đánh dấu các thỏa thuận bảo mật là “Bản nháp” hoặc “Bảo mật”.
  2. E‑learning – Bảo vệ PDF khóa học bằng thương hiệu của tổ chức.
  3. Tài sản marketing – Thêm logo công ty vào các tài liệu quảng cáo trước khi phân phối.
  4. Dịch vụ đăng ký – Gắn thẻ nội dung cao cấp với thông tin người đăng ký để ngăn chặn việc chia sẻ.

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

  • Xử lý PDF trong các luồng song song khi xử lý khối lượng lớn; SDK hỗ trợ đa luồng.
  • Giảm độ phân giải hình ảnh cho logo lớn hơn 300 dpi để giảm thời gian xử lý lên đến 40 %.
  • Giữ kích thước watermark dưới 10 % diện tích trang để duy trì khả năng đọc và tránh tăng kích thước tệp quá mức.

Kết luận

Bạn đã có một lộ trình hoàn chỉnh, sẵn sàng cho sản xuất cho add watermark pdf java bằng cách sử dụng GroupDocs.Watermark. Bằng cách thực hiện các bước trên, bạn có thể bảo vệ PDF bằng cả watermark văn bản và hình ảnh đồng thời duy trì hiệu suất cao. Để tùy chỉnh sâu hơn — chẳng hạn như phạm vi trang có điều kiện hoặc nội dung watermark động — hãy khám phá tài liệu tham khảo API đầy đủ trong tài liệu chính thức.

Để khám phá thêm tính năng, truy cập GroupDocs documentation. Bạn cũng có thể tải xuống SDK mới nhất từ GroupDocs.Watermark for Java releases.

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

PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);

import com.groupdocs.watermark.watermarks.ImageWatermark;

ImageWatermark imageWatermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.bmp");

watermarker.add(imageWatermark, null);

imageWatermark.close();
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document.pdf");
watermarker.close();

Hướng dẫn liên quan