Ví dụ Hoạt động đầy đủ để Xóa các Đối tượng Ghi chú khỏi PDF bằng REST trong Node.JS

Ví dụ này minh họa cách tải lên một tệp PDF, xóa tất cả các chú thích của nó và tải xuống tệp đã được làm sạch bằng GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Xóa chú thích PDF qua REST API bằng cURL

Dưới đây là các lệnh cURL thực hiện cùng quy trình xóa chú thích thông qua các endpoint REST của GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Để xem danh sách đầy đủ các endpoint và tham số, hãy xem tài liệu API chính thức.

Cách Xóa Đối Tượng Ghi Chú trong PDF bằng REST trong Node.JS Hoạt Động

1. Cấu hình xác thực - Lớp Configuration được khởi tạo với clientId và clientSecret của bạn, tạo ra một ngữ cảnh đã xác thực cho tất cả các cuộc gọi API tiếp theo.

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);

2. Tải lên tệp - UploadFileRequest gửi các byte PDF cục bộ tới lưu trữ GroupDocs Cloud. Phương thức storageApi.uploadFile xử lý việc truyền tải.

const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

3. Lấy chú thích - GetAnnotationsRequest tạo một đối tượng yêu cầu với tham chiếu FileInfo. Lệnh annotationsApi.getAnnotations trả về một bộ sưu tập các đối tượng chú thích, từ đó trích xuất các ID.

const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

4. Xóa chú thích - Nếu có bất kỳ ID nào, DeleteAnnotationsRequest được điền và truyền cho annotationsApi.deleteAnnotations, lệnh này sẽ xóa vĩnh viễn các chú thích khỏi PDF đã lưu.

const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

5. Tải xuống PDF sạch - Cuối cùng, DownloadFileRequest lấy tệp đã cập nhật, và fs.writeFileSync ghi nó vào hệ thống tệp cục bộ.

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

Để xem chi tiết các định nghĩa lớp và phương thức, hãy tham khảo Tham khảo API.

Cài đặt và cấu hình GroupDocs.Annotation Cloud SDK for Node.js

SDK được phân phối dưới dạng gói npm. Cài đặt nó bằng lệnh dưới đây và sau đó yêu cầu nó trong dự án của bạn.

npm install groupdocs-annotation-cloud

Bạn cũng có thể tải xuống gói mới nhất trực tiếp từ trang phát hành trên GitHub hoặc từ URL tải xuống chính thức.

Sau khi cài đặt, nhập thư viện và tạo một đối tượng cấu hình như được hiển thị trong ví dụ mã sau:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Đảm bảo môi trường chạy của bạn đáp ứng các yêu cầu về phiên bản Node.js và bạn có tài khoản GroupDocs hợp lệ để lấy thông tin xác thực client.

Tùy chọn và Cài đặt Loại bỏ chú thích

SDK cung cấp một số tham số mà bạn có thể điều chỉnh:

• clientId / clientSecret - Thông tin xác thực cho OAuth. Đặt chúng trong hàm khởi tạo Configuration.
• fileInfo.filePath - Đường dẫn tới tệp PDF trong lưu trữ GroupDocs Cloud. Điều chỉnh nếu bạn lưu tệp trong thư mục khác.
• annotationIds - Một mảng các ID được trả về bởi GetAnnotations. Cung cấp một phần con cho phép xóa có chọn lọc.

Các cài đặt bổ sung như thời gian chờ yêu cầu và cấu hình proxy có sẵn trong tài liệu SDK; xem tài liệu chính thức để biết danh sách đầy đủ.

Các thực tiễn tốt nhất cho việc xóa chú thích PDF qua REST

• Xác thực ID chú thích - Luôn kiểm tra xem các ID bạn dự định xóa có tồn tại hay không; việc cố gắng xóa các ID không tồn tại có thể gây ra lỗi 404.
• Sử dụng HTTPS - Tất cả các cuộc gọi API phải được thực hiện qua HTTPS để bảo vệ thông tin đăng nhập và dữ liệu tài liệu của bạn.
• Xử lý tệp lớn với tải lên dạng khối - Đối với các tệp PDF lớn hơn 100 MB, nên sử dụng endpoint tải lên đa phần để tránh thời gian chờ.
• Ghi lại phản hồi API - Lưu trữ ID yêu cầu và phản hồi để tạo nhật ký kiểm toán và dễ dàng khắc phục sự cố.
• Tái sử dụng token truy cập - Lưu token OAuth trong bộ nhớ đệm cho đến khi hết hạn để giảm tải xác thực.

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

• How do I authenticate with GroupDocs.Annotation Cloud API?
  Lấy client ID và secret từ tài khoản GroupDocs của bạn, sau đó yêu cầu một access token thông qua endpoint OAuth. Xem tài liệu chính thức để biết chi tiết.

• Tôi có thể xóa các chú thích cụ thể thay vì tất cả không?
  Có, hãy cung cấp các ID của các chú thích bạn muốn xóa trong DeleteAnnotationsRequest. SDK trả về danh sách các ID chú thích sau một cuộc gọi GetAnnotations.

• Làm thế nào để tôi xóa các đối tượng Annotation khỏi PDF bằng REST trong Node.JS?
  Sử dụng GroupDocs.Annotation Cloud SDK for Node.js để gọi endpoint DeleteAnnotations sau khi lấy các ID của annotation. Quy trình đầy đủ được trình bày trong ví dụ mã và phần cURL của hướng dẫn này.

• Cần giấy phép gì cho việc sử dụng trong môi trường sản xuất?
  Cần một giấy phép trả phí cho môi trường sản xuất. Bạn có thể nhận giấy phép tạm thời từ trang giấy phép tạm thời trong quá trình đánh giá.

Đọc thêm

• Trích xuất hoặc Xóa chú thích khỏi PDF bằng REST API trong Node.js
• Gạch ngang văn bản trong PDF với Node.js và REST API
• Xóa chú thích khỏi PDF bằng REST API trong Python

Trước Khi Bắt Đầu: Các Yêu Cầu Trước và Cài Đặt

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

• Node.js 14 hoặc mới hơn được cài đặt trên máy phát triển của bạn.
• Một tài khoản GroupDocs Cloud đang hoạt động với client ID và client secret.
• Truy cập vào các tệp PDF mà bạn muốn kết hợp, được lưu trữ trong bộ nhớ GroupDocs Cloud.

Cài đặt SDK qua npm và tải gói mới nhất:

npm install groupdocs-merger-cloud

Bạn cũng có thể tải SDK từ trang phát hành chính thức: Download SDK. Sau khi cài đặt, bạn đã sẵn sàng để bắt đầu viết mã.

Hướng dẫn từng bước để hợp nhất PDF trong Node.JS

Bước 1: Cài đặt SDK và Nhập các lớp cần thiết

Đầu tiên, nhập các lớp mà bạn sẽ cần để hợp nhất các tệp PDF.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Lệnh import này cung cấp cho bạn quyền truy cập vào API lõi, các đối tượng cấu hình và các mô tả tệp.

Bước 2: Cấu hình Thông tin xác thực GroupDocs của bạn

Tạo một đối tượng cấu hình với thông tin xác thực client của bạn.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Cung cấp thông tin xác thực đúng sẽ cho phép thư viện xác thực các yêu cầu của bạn.

Bước 3: Xác định các tệp PDF cần hợp nhất

Liệt kê các tài liệu PDF mà bạn muốn kết hợp. Bước này chuẩn bị cho bạn việc hợp nhất PDF trong Node.JS một cách hiệu quả.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Mỗi FileInfo chỉ tới một tệp được lưu trữ trong bộ nhớ đám mây GroupDocs của bạn.

Bước 4: Đặt tùy chọn hợp nhất

Cấu hình vị trí đầu ra và đính kèm danh sách tệp vào yêu cầu hợp nhất.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Các cài đặt này kiểm soát cách bạn hợp nhất PDF trong Node.JS và nơi kết quả sẽ được lưu.

Bước 5: Thực hiện thao tác hợp nhất

Tạo một thể hiện API, gọi phương thức merge và xử lý phản hồi.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

Lời gọi async trả về đường dẫn của tài liệu đã hợp nhất nếu thao tác thành công.

Ví dụ triển khai đầy đủ cho việc hợp nhất PDF trong Node.JS

Đoạn mã sau đây trình bày quy trình làm việc đầy đủ từ cấu hình đến xử lý kết quả.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Gộp PDF qua REST API bằng cURL

Nếu bạn thích một cách tiếp cận REST thuần túy, cùng một thao tác có thể được thực hiện bằng các lệnh cURL.

Đầu tiên, lấy token truy cập:

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET","grant_type":"client_credentials"}'

Tải lên các PDF nguồn vào kho lưu trữ của bạn (thay thế YOUR_ACCESS_TOKEN bằng token từ bước trước):

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

Lặp lại việc tải lên cho input2.pdf. Sau đó yêu cầu thao tác hợp nhất:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Cuối cùng, tải xuống tệp đã hợp nhất:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

Để có danh sách đầy đủ các điểm cuối và tham số, xem tài liệu tham khảo API.

Cấu hình các tùy chọn hợp nhất

SDK cung cấp một số tùy chọn cho phép bạn tinh chỉnh quá trình hợp nhất:

• outputPath - Đường dẫn đích cho PDF đã hợp nhất. Điều chỉnh điều này để kiểm soát nơi kết quả được lưu trữ.
• fileInfos - Một mảng các đối tượng FileInfo xác định các PDF nguồn và thứ tự của chúng.

Bạn cũng có thể đặt các thuộc tính bổ sung như pages để hợp nhất các phạm vi trang cụ thể, hoặc password cho các PDF được mã hóa. Tham khảo tài liệu chính thức để biết danh sách đầy đủ các trường có thể cấu hình.

Các cân nhắc về hiệu năng khi hợp nhất PDF

Khi hợp nhất nhiều tệp PDF lớn hoặc số lượng lớn, hãy nhớ những mẹo sau:

• Sử dụng async/await để tránh chặn vòng lặp sự kiện, đặc biệt đối với các tài liệu lớn.
• Tải lên hàng loạt: tải các PDF nguồn song song trước khi gọi hàm merge để giảm độ trễ tổng thể.
• Xử lý dạng stream: đối với các PDF cực lớn, cân nhắc lưu trữ kết quả trung gian trong lưu trữ đám mây và hợp nhất chúng thành các phần nhỏ hơn.
• PDF được mã hoá: cung cấp mật khẩu trong các đối tượng FileInfo; xử lý các tệp được mã hoá gây tốn tài nguyên, vì vậy hãy hợp nhất chúng sau khi giải mã nếu có thể.

Áp dụng các thực hành này giúp bạn hợp nhất PDF trong Node.JS một cách hiệu quả trong khi giảm thiểu việc tiêu thụ bộ nhớ.

Câu hỏi bạn có thể có

• Làm thế nào để hợp nhất các tệp PDF trong Node.JS bằng GroupDocs?
  Sử dụng GroupDocs.Merger Cloud SDK for Node.js để tạo một thể hiện MergeApi, cấu hình MergeOptions với các PDF nguồn của bạn và gọi mergeDocuments. Ví dụ mã đầy đủ trong hướng dẫn này minh họa quy trình.

• Tôi có thể hợp nhất các tệp PDF được mã hóa trong Node.JS không?
  Có, SDK hỗ trợ hợp nhất các PDF được mã hóa. Cung cấp mật khẩu đúng trong các đối tượng FileInfo trước khi gọi mergeDocuments. Xem tài liệu chính thức để biết chi tiết.

• Các tùy chọn cấp phép cho GroupDocs.Merger là gì?
  GroupDocs cung cấp các gói giá linh hoạt. Để thử nghiệm, bạn có thể yêu cầu một giấy phép tạm thời để đánh giá thư viện trước khi mua gói đăng ký đầy đủ.

• Tôi có thể tìm thêm ví dụ và hỗ trợ ở đâu?
  Các mẫu bổ sung có sẵn trên kho GitHub. Để được trợ giúp, hãy truy cập diễn đàn hỗ trợ.

Đọc thêm

• Chia PDF thành nhiều PDF trong Node.JS
• Khóa tài liệu PDF bằng mật khẩu sử dụng REST API trong Node.js
• Cách hợp nhất các tệp PDF trong C# sử dụng REST API

Thêm Đánh Dấu Hình Ảnh vào Tài Liệu PDF trong Java trong 5 Bước

1. Khởi tạo client API: Tạo một thể hiện ApiClient với ID client và secret của bạn.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

Bước này kết nối mã Java của bạn với dịch vụ GroupDocs.Watermark Cloud. Xem tài liệu API để biết thêm chi tiết.

2. Chỉ định tệp PDF nguồn: Tạo một đối tượng FileInfo trỏ tới tệp PDF mà bạn muốn thêm watermark.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

Tệp phải được tải lên bộ nhớ GroupDocs của bạn trước khi gửi yêu cầu.

3. Cấu hình watermark hình ảnh: Xác định đường dẫn hình ảnh, độ trong suốt, hệ số tỷ lệ, góc xoay và căn chỉnh.

ImageWatermark imageWatermark = new ImageWatermark();
imageWatermark.setImagePath("watermark.png");
imageWatermark.setOpacity(0.5);
imageWatermark.setScaleFactor(0.3);
imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
imageWatermark.setMargin(new Margin(10, 10, 10, 10));

Điều chỉnh các giá trị này để đạt được giao diện mong muốn; độ trong suốt kiểm soát tính trong suốt, trong khi scaleFactor xác định kích thước tương đối so với trang.

4. Đặt tùy chọn watermark và đường dẫn đầu ra: Kết hợp thông tin tệp và watermark vào một đối tượng WatermarkOptions.

   WatermarkOptions options = new WatermarkOptions();
   options.setFileInfo(fileInfo);
   options.setImageWatermark(imageWatermark);
   options.setOutputPath("output.pdf");
   

   outputPath cho biết dịch vụ sẽ lưu PDF kết quả ở đâu.

5. Thực hiện yêu cầu: Xây dựng một AddWatermarkRequest và gọi API. Xử lý phản hồi thành công hoặc lỗi.

AddWatermarkRequest request = new AddWatermarkRequest(options);
try {
    AddWatermarkResponse response = watermarkApi.addWatermark(request);
    System.out.println("Watermark added successfully. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error adding watermark: " + e.getMessage());
}

Sau khi thực thi, tệp PDF đã được chèn watermark sẽ có sẵn tại vị trí bạn đã chỉ định.

Ví dụ mã hoàn chỉnh: Thêm hình mờ ảnh vào tài liệu PDF trong Java

Ví dụ sau đây trình bày việc triển khai đầy đủ từ khởi tạo client đến lưu PDF có watermark.

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Lưu ý: Ví dụ mã này trình bày chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (input.pdf, watermark.png, output.pdf) để phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Áp dụng Đánh dấu Hình ảnh cho Tài liệu PDF qua cURL và REST API

Dưới đây là các lệnh REST bạn có thể sử dụng với cURL để đạt được kết quả tương tự mà không cần viết mã Java.

1. Lấy token truy cập

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Phản hồi chứa một access_token được sử dụng trong các cuộc gọi tiếp theo.

2. Tải lên PDF nguồn

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/input.pdf"

3. Tải lên hình watermark

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/watermark.png"

4. Thêm watermark hình ảnh

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

Yêu cầu này phản ánh logic mã Java, áp dụng cùng các thiết lập độ trong suốt, tỷ lệ và căn chỉnh.

5. Tải xuống PDF có dấu watermark

   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.pdf
   

Để biết thêm chi tiết về các phần thân yêu cầu và các tham số được hỗ trợ, xem tài liệu API chính thức.

Cài đặt và cấu hình GroupDocs.Watermark Cloud SDK for Java

Thêm phụ thuộc Maven vào pom.xml của bạn (hoặc đoạn mã Gradle tương đương). Thư viện được lưu trữ trên Maven Central.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Bạn cũng cần một tài khoản GroupDocs Cloud hợp lệ. Lấy Client ID và Client Secret của bạn từ cổng GroupDocs. Không cần cài đặt runtime bổ sung vì SDK giao tiếp với dịch vụ đám mây.

Tinh chỉnh các tùy chọn dấu ảnh mờ cho tài liệu PDF

SDK cung cấp một số thuộc tính cho phép bạn kiểm soát giao diện trực quan của watermark.

Điều chỉnh độ trong suốt

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

Các giá trị độ trong suốt nằm trong khoảng từ 0.0 (hoàn toàn trong suốt) đến 1.0 (hoàn toàn mờ).

Thay đổi hệ số tỷ lệ

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

Hệ số tỷ lệ xác định kích thước watermark so với kích thước trang.

Đặt căn chỉnh và lề

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

Các cài đặt này đặt watermark ở góc dưới‑phải với lề 20 điểm.

Để xem danh sách đầy đủ các thuộc tính có thể cấu hình, hãy tham khảo tài liệu API.

Kết luận

Thêm một watermark hình ảnh vào tài liệu PDF trong Java là một nhiệm vụ đơn giản khi bạn sử dụng GroupDocs.Watermark Cloud SDK for Java. SDK xử lý tất cả các thao tác PDF cấp thấp, cho phép bạn tập trung vào các khía cạnh hình ảnh như độ trong suốt, tỷ lệ và vị trí. Cho dù bạn ưu tiên triển khai Java gốc hay quy trình làm việc dựa trên cloud bằng cURL, kết quả chất lượng cao vẫn có thể đạt được mà không làm giảm hiệu năng. Hãy nhớ lấy giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; chi tiết giá cả có sẵn trên trang sản phẩm và một trang giấy phép tạm thời có thể được sử dụng để đánh giá.

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

• Làm thế nào để thêm watermark hình ảnh vào PDF trong Java mà không làm mất chất lượng?
  Sử dụng thuộc tính scaleFactor để điều chỉnh kích thước watermark so với trang và giữ DPI gốc của PDF nguồn. SDK giữ nguyên độ phân giải của PDF, vì vậy watermark sẽ hiển thị sắc nét ở bất kỳ mức phóng đại nào.

• Tôi có thể thêm nhiều watermark vào cùng một PDF không?
  Có. Tạo các đối tượng ImageWatermark riêng biệt với các cấu hình khác nhau và thêm chúng tuần tự bằng cách gọi addWatermark nhiều lần hoặc bằng cách thêm chúng vào một danh sách trong yêu cầu.

• Các định dạng hình ảnh được hỗ trợ cho watermark là gì?
  API chấp nhận các loại hình ảnh phổ biến như PNG, JPG, BMP, GIF và TIFF. PNG được khuyến nghị vì chất lượng không mất dữ liệu và hỗ trợ trong suốt.

• Có cách nào để xem trước watermark trước khi áp dụng không?
  Bạn có thể sử dụng GroupDocs.Watermark Cloud SDK for Java để tạo một PDF tạm thời có watermark và tải xuống để xem xét. Điều này sử dụng cùng một lời gọi addWatermark với đường dẫn đầu ra chỉ tới vị trí tạm thời.

Đọc thêm

• Thêm watermark vào hình ảnh bằng Java
• Thêm watermark vào Word bằng Java - Watermark Creator
• Thêm watermark hình ảnh vào PDF | Cách thêm watermark vào tài liệu PDF bằng .NET