Cách thêm watermark văn bản vào PDF bằng GroupDocs.Watermark cho Java (hướng dẫn 2023)

Thêm watermark văn bản vào PDF là một trong những cách hiệu quả nhất để how to add watermark đồng thời củng cố nhận diện thương hiệu. Trong hướng dẫn này, bạn sẽ học cách sử dụng GroupDocs.Watermark for Java để nhúng một watermark văn bản có thể tùy chỉnh vào bất kỳ tài liệu PDF nào, giữ nguyên tính toàn vẹn của tệp.

Câu trả lời nhanh

  • Thư viện tôi cần là gì? GroupDocs.Watermark for Java (v24.11 hoặc sau).
  • Phiên bản Java yêu cầu là gì? JDK 8 hoặc cao hơn.
  • Tôi có cần giấy phép không? Bản dùng thử miễn phí đủ cho việc đánh giá; giấy phép thương mại cần thiết cho môi trường sản xuất.
  • Tôi có thể watermark các PDF lớn không? Có – API xử lý các tệp hàng trăm trang mà không cần tải toàn bộ tài liệu vào bộ nhớ.
  • Có hỗ trợ branding không? Chắc chắn – bạn có thể đặt phông chữ, màu sắc, độ trong suốt và góc quay để phù hợp với phong cách công ty.

“How to add watermark” là gì?

How to add watermark đề cập đến quá trình chèn một lớp văn bản hiển thị vào tệp PDF một cách lập trình để chỉ ra quyền sở hữu, tính bảo mật hoặc branding. GroupDocs.Watermark for Java cung cấp một API cấp cao xử lý các công việc nặng, vì vậy bạn chỉ cần một vài lời gọi phương thức.

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

GroupDocs.Watermark hỗ trợ 50+ định dạng đầu vào và đầu ra, có thể xử lý các PDF có kích thước lên tới 1 GB mà không cần tải toàn bộ vào bộ nhớ, và cung cấp các thao tác thread‑safe có thể mở rộng trong môi trường đa luồng. Những khả năng được định lượng này khiến nó trở thành lựa chọn đáng tin cậy cho bảo mật PDF cấp doanh nghiệp và branding.

Yêu cầu trước

  • Java Development Kit (JDK) 8 hoặc mới hơn.
  • Thư viện GroupDocs.Watermark v24.11 (hoặc sau).
  • Một IDE như IntelliJ IDEA hoặc Eclipse có hỗ trợ Maven.
  • Kiến thức cơ bản về Java và hiểu biết về cấu trúc PDF.

Cài đặt GroupDocs.Watermark cho Java

Đầu tiên, thêm thư viện vào dự án Maven của bạn:

Cài đặt Maven
Thêm 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>

Nếu bạn không muốn sử dụng Maven, bạn có thể tải JAR trực tiếp từ trang phát hành chính thức:

Các bước lấy giấy phép

  • Dùng thử miễn phí – tạo khóa giấy phép tạm thời để đánh giá.
  • Mua – cung cấp giấy phép vĩnh viễn mở khóa toàn bộ tính năng.

Khởi tạo và cài đặt cơ bản
Nhập các lớp cần thiết trước khi bắt đầu làm việc với PDF:

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

Hướng dẫn triển khai

Dưới đây là hướng dẫn chi tiết từng bước bao phủ mọi giai đoạn của quy trình watermark.

Cách thêm watermark văn bản vào PDF trong Java?

Tải PDF, tạo watermark văn bản, áp dụng nó vào mỗi trang, và sau đó lưu kết quả. Quy trình hoàn chỉnh có thể được diễn đạt trong bốn bước ngắn gọn mà bạn có thể sao chép vào dự án, cho phép bạn nhanh chóng tích hợp watermark với mã tối thiểu và đảm bảo giao diện nhất quán trên mọi trang.

Tải tài liệu PDF

Definition anchor – PdfLoadOptions cho phép bạn chỉ định các tham số tải như bảo vệ bằng mật khẩu hoặc sử dụng bộ nhớ.
Direct answer – Tạo một đối tượng PdfLoadOptions và một đối tượng Watermarker, sau đó gọi new Watermarker(inputStream, loadOptions) để mở PDF để chỉnh sửa. Bước này đảm bảo tài liệu sẵn sàng cho việc chèn watermark mà không cần tải toàn bộ vào RAM.

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

Tiêu đề: Cấu hình PdfLoadOptions cung cấp cho bạn kiểm soát chi tiết cách PDF được phân tích, điều này rất quan trọng đối với các tệp lớn hoặc được mã hoá.

Khởi tạo watermark văn bản

Definition anchor – TextWatermark đại diện cho lớp văn bản hiển thị sẽ được vẽ trên mỗi trang.
Direct answer – Tạo một thể hiện TextWatermark, đặt phông chữ, kích thước, màu sắc và góc quay, sau đó tùy chọn điều chỉnh độ trong suốt. Đối tượng này bao gồm tất cả cài đặt hiển thị, vì vậy bạn chỉ cần truyền nó một lần cho Watermarker.

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

   TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
   watermark.setHorizontalAlignment(HorizontalAlignment.Center);
   watermark.setVerticalAlignment(VerticalAlignment.Center);
   watermark.setRotateAngle(45);
   watermark.setSizingType(SizingType.ScaleToParentDimensions);
   watermark.setScaleFactor(1);

Tiêu đề: Định dạng đúng làm cho watermark dễ đọc nhưng không gây cản trở, bảo tồn trải nghiệm người dùng đồng thời khẳng định quyền sở hữu.

Truy cập nội dung và các trang PDF

Definition anchor – Watermarker.getPages() trả về một tập hợp cho phép bạn làm việc với các trang riêng lẻ.
Direct answer – Lặp qua watermarker.getPages() và gọi page.addWatermark(textWatermark) cho mỗi trang bạn muốn chỉnh sửa. Cách tiếp cận này cho phép bạn nhắm mục tiêu các trang cụ thể hoặc áp dụng watermark toàn bộ.

   import com.groupdocs.watermark.contents.PdfContent;
   import com.groupdocs.watermark.contents.PdfPage;

   PdfContent pdfContent = watermarker.getContent(PdfContent.class);
   for (PdfPage page : pdfContent.getPages()) {
       // Process each page as needed.
   }

Tiêu đề: Kiểm soát ở mức trang hữu ích khi bạn chỉ cần watermark một số phần, chẳng hạn như trang bìa hoặc các chương bảo mật.

Thêm watermark vào các image artifact

Definition anchor – Các đối tượng ImageArtifact đại diện cho các hình ảnh raster nhúng trong một trang PDF.
Direct answer – Duyệt qua page.getImageArtifacts() và gọi artifact.addWatermark(textWatermark) để nhúng cùng một watermark văn bản vào mỗi hình ảnh. Điều này bảo vệ các tài sản hình ảnh có thể bị trích xuất và tái sử dụng.

   import com.groupdocs.watermark.contents.PdfArtifact;

   for (PdfPage page : pdfContent.getPages()) {
       for (PdfArtifact artifact : page.getArtifacts()) {
           if (artifact.getImage() != null) {
               artifact.getImage().add(watermark);
           }
       }
   }

Tiêu đề: Watermark các hình ảnh ngăn việc tái sử dụng trái phép các đồ họa, biểu đồ hoặc ảnh chụp xuất hiện trong tài liệu.

Lưu và đóng tài liệu PDF đã watermark

Definition anchor – Watermarker.save(String path) ghi PDF đã chỉnh sửa vào hệ thống tệp.
Direct answer – Gọi watermarker.save("output.pdf") rồi watermarker.close() để xả bộ đệm và giải phóng các handle tệp. Bước cuối cùng này đảm bảo mọi thay đổi watermark được lưu lại và tài nguyên hệ thống được giải phóng.

   import java.io.File;

   String outputPath = "YOUR_OUTPUT_DIRECTORY/output.pdf";
   watermarker.save(outputPath);
   watermarker.close();

Tiêu đề: Quản lý tài nguyên đúng cách tránh khóa tệp và rò rỉ bộ nhớ, đặc biệt quan trọng trong môi trường máy chủ có lưu lượng cao.

Ứng dụng thực tiễn

GroupDocs.Watermark cho Java phù hợp một cách tự nhiên với nhiều kịch bản thực tế:

  • Bảo mật tài liệu – nhúng thông báo bảo mật vào hợp đồng, hoá đơn hoặc bản tóm tắt pháp lý.
  • Branding – hiển thị tên công ty hoặc khẩu hiệu của bạn trên tất cả các PDF được xuất.
  • Bảo vệ bản quyền – ngăn chặn việc phân phối trái phép bằng cách dán một tuyên bố hiển thị trên mỗi trang.

Các điểm tích hợp điển hình bao gồm các pipeline tự động tạo tài liệu, hệ thống quản lý nội dung và các engine quy trình công việc doanh nghiệp.

Các cân nhắc về hiệu năng

Khi làm việc với các PDF lớn, hãy nhớ những thực hành tốt sau:

  • Sử dụng PdfLoadOptions.setLoadMode(LoadMode.MemoryOptimized) để giảm thiểu việc sử dụng bộ nhớ.
  • Đóng đối tượng Watermarker ngay sau khi lưu.
  • Xử lý tài liệu theo lô bằng cách sử dụng thread pool để tối đa hoá việc sử dụng CPU mà không gây quá tải I/O.

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

Q: Tôi có thể watermark các tệp không phải PDF không?
A: Có, GroupDocs.Watermark hỗ trợ hơn 50 định dạng, bao gồm DOCX, PPTX và các tệp hình ảnh.

Q: Có thể tùy chỉnh màu văn bản và độ trong suốt không?
A: Chắc chắn – API TextWatermark cung cấp các phương thức setColor() và setOpacity() để tinh chỉnh kiểu dáng.

Q: Tôi nên xử lý các PDF lớn hơn 500 MB như thế nào?
A: Bật tải tối ưu bộ nhớ và cân nhắc xử lý tệp theo các đoạn phạm vi trang để tránh cạn kiệt bộ nhớ heap.

Q: Có cần giấy phép thương mại cho việc sử dụng trong môi trường sản xuất không?
A: Có, giấy phép đầy đủ loại bỏ các giới hạn của bản dùng thử và cung cấp quyền truy cập vào tất cả các tính năng cao cấp.

Q: Nếu tôi cần bố cục watermark phức tạp hơn thì sao?
A: Thư viện cung cấp các tính năng nâng cao như watermark đa dòng, đặt chéo và render có điều kiện — xem tài liệu tham khảo API để biết chi tiết.

Tài nguyên bổ sung

Bằng cách thực hiện các bước trên, bạn đã có nền tảng vững chắc để how to add watermark vào các tệp PDF trong Java. Áp dụng các mẫu này vào dịch vụ của bạn để bảo vệ nội dung nhạy cảm, củng cố branding và đáp ứng các yêu cầu tuân thủ.

Cập nhật lần cuối: 2026-08-14
Đã kiểm tra với: GroupDocs.Watermark 24.11 for Java
Tác giả: GroupDocs

Hướng dẫn liên quan