java rest api on Document Processing REST APIs | GroupDocs Cloud

Thêm lớp phủ văn bản vào GIF bằng REST trong Java

Wed, 23 Sep 2026 13:04:19 +0000

Thêm phụ đề động, tiêu đề phụ hoặc thông điệp quảng cáo vào các tệp GIF động là một nhu cầu phổ biến cho các ứng dụng web và di động hiện đại. GroupDocs.Watermark Cloud SDK for Java cung cấp một thư viện mạnh mẽ dựa trên REST giúp công việc này trở nên đơn giản. Trong hướng dẫn này, bạn sẽ học cách thêm lớp phủ văn bản vào GIF bằng REST trong Java, xem một triển khai Java đầy đủ, khám phá các lệnh cURL tương đương và hiểu các bước thiết lập cần thiết.

Thêm Lớp Văn Bản lên GIF bằng REST trong Java - Mã mẫu

Ví dụ này minh họa cách cấu hình một watermark dạng văn bản và áp dụng nó cho mỗi khung của tệp GIF.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.client.Configuration;
import com.groupdocs.watermark.cloud.model.AddWatermarkRequest;
import com.groupdocs.watermark.cloud.model.AddWatermarkResponse;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.OutputFileInfo;
import com.groupdocs.watermark.cloud.model.TextWatermarkOptions;
import com.groupdocs.watermark.cloud.model.HorizontalAlignment;
import com.groupdocs.watermark.cloud.model.VerticalAlignment;

public class AddTextOverlayToGif {
    public static void main(String[] args) {
        // Initialize API configuration (replace with your actual clientId and clientSecret)
        Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(config);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.gif");          // Path to the source GIF in the storage
        inputFile.setStorageName("MyStorage");       // Optional: name of the storage

// Prepare output file information
        OutputFileInfo outputFile = new OutputFileInfo();
        outputFile.setFilePath("output.gif");        // Desired path for the watermarked GIF
        outputFile.setStorageName("MyStorage");      // Optional: name of the storage

// Configure text watermark options
        TextWatermarkOptions textOptions = new TextWatermarkOptions();
        textOptions.setText("Sample Watermark");
        textOptions.setFontFamily("Arial");
        textOptions.setFontSize(24.0);
        textOptions.setColor("#FF0000");             // Red color in HEX
        textOptions.setOpacity(0.5);                 // 50% opacity
        textOptions.setRotationAngle(0.0);
        textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
        textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
        textOptions.setPageRange("1-");               // Apply to all frames/pages

// Build the request
        AddWatermarkRequest request = new AddWatermarkRequest();
        request.setFileInfo(inputFile);
        request.setOutputFileInfo(outputFile);
        request.setOptions(textOptions);

try {
            // Execute the request
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (ApiException e) {
            System.err.println("Error while adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

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.

Chồng Văn Bản lên GIF bằng REST API sử dụng cURL

Dưới đây là các lệnh cURL thực hiện cùng một thao tác từ terminal. Chúng minh họa quy trình REST đầy đủ: xác thực, tải lên, thêm watermark và tải xuống.

# 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"}'

Thay thế YOUR_ACCESS_TOKEN trong các lời gọi sau bằng token đã trả về ở trên.

# 2. Upload the source GIF to storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @path/to/local/input.gif

# 3. Add text overlay to the GIF
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.gif", "storageName": "MyStorage" },
           "outputFileInfo": { "filePath": "output.gif", "storageName": "MyStorage" },
           "options": {
               "text": "Sample Watermark",
               "fontFamily": "Arial",
               "fontSize": 24,
               "color": "#FF0000",
               "opacity": 0.5,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Middle",
               "pageRange": "1-"
           }
         }'

# 4. Download the watermarked GIF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o path/to/local/output.gif

Để biết thêm chi tiết về nội dung yêu cầu và định dạng phản hồi, xem tài liệu API chính thức.

Phân tích Thêm Văn bản Overlay vào GIF bằng REST trong Java - Cách hoạt động

Khởi tạo client API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") tạo một đối tượng cấu hình chứa thông tin xác thực của bạn. WatermarkApi sử dụng cấu hình này để ký mỗi yêu cầu.

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(config);

Chỉ định tệp nguồn và tệp đích - FileInfo và OutputFileInfo cho dịch vụ biết nơi đọc GIF gốc và nơi ghi kết quả. Cả hai có thể tham chiếu tới một tên lưu trữ tùy chỉnh.
```
FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.gif");
inputFile.setStorageName("MyStorage");
```
Cấu hình dấu nước văn bản - TextWatermarkOptions chứa tất cả các thuộc tính hiển thị: văn bản, phông chữ, kích thước, màu sắc, độ trong suốt, góc quay và căn chỉnh. Đặt pageRange thành "1-" đảm bảo mỗi khung của GIF hoạt hình đều nhận được lớp phủ.

TextWatermarkOptions textOptions = new TextWatermarkOptions();
textOptions.setText("Sample Watermark");
textOptions.setFontFamily("Arial");
textOptions.setFontSize(24.0);
textOptions.setColor("#FF0000");
textOptions.setOpacity(0.5);
textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
textOptions.setPageRange("1-");

Xây dựng và gửi yêu cầu - AddWatermarkRequest gói thông tin tệp và các tùy chọn. Gọi watermarkApi.addWatermark(request) thực hiện thao tác trên máy chủ và trả về đường dẫn của tệp đã xử lý.

AddWatermarkRequest request = new AddWatermarkRequest();
request.setFileInfo(inputFile);
request.setOutputFileInfo(outputFile);
request.setOptions(textOptions);
AddWatermarkResponse response = watermarkApi.addWatermark(request);

Xử lý phản hồi - Phản hồi chứa đường dẫn tệp đầu ra. Trong một ứng dụng thực tế, bạn thường sẽ tải xuống tệp hoặc truyền đường dẫn cho một dịch vụ khác.

Để xem danh sách đầy đủ các lớp và thuộc tính, tham khảo API reference.

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 mục nhập Gradle tương đương). Điều này sẽ kéo về phiên bản 23.8 của SDK.


    com.groupdocs
    groupdocs-watermark-cloud
    23.8

Yêu cầu

Java 8 hoặc cao hơn
Một tài khoản GroupDocs Cloud đang hoạt động
Client ID và Client Secret (có sẵn trong bảng điều khiển GroupDocs Cloud)

Ví dụ cấu hình

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Tải xuống các tệp JAR mới nhất từ trang tải xuống. Đối với việc sử dụng trong môi trường sản xuất, hãy áp dụng giấy phép hợp lệ được lấy từ trang giấy phép tạm thời.

Kết luận

Thêm lớp phủ văn bản lên GIF bằng REST trong Java trở thành một thao tác lặp lại, chạy phía máy chủ nhờ sự hỗ trợ của GroupDocs.Watermark Cloud SDK for Java. SDK trừu tượng hóa các phức tạp khi xử lý các khung ảnh động, cho phép bạn tập trung vào nội dung của phụ đề hoặc thông điệp quảng cáo. Sau khi tích hợp mã mẫu hoặc quy trình cURL, bạn có thể tinh chỉnh kiểu chữ, màu sắc và độ trong suốt để phù hợp với thương hiệu của mình. Hãy nhớ mua giấy phép sản xuất; thông tin giá cả có sẵn trên trang sản phẩm, và bạn có thể nhận giấy phép tạm thời để thử nghiệm qua trang giấy phép tạm thời. Chúc lập trình vui vẻ!

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

Làm thế nào để thêm lớp phủ văn bản lên GIF bằng REST trong Java khi văn bản thay đổi theo người dùng?
Tạo đối tượng TextWatermarkOptions tại thời gian chạy với chuỗi cụ thể cho người dùng, sau đó gọi lại phương thức addWatermark giống như trước. API xử lý mỗi yêu cầu một cách độc lập, vì vậy nội dung động được hỗ trợ hoàn toàn.
Tôi có thể thêm phụ đề vào GIF hoạt hình mà không ảnh hưởng đến tốc độ hoạt hình không?
Có. Đánh dấu nước được áp dụng cho mỗi khung hình trong khi vẫn giữ nguyên độ trễ khung gốc. Chỉ cần đặt pageRange thành "1-" để mỗi khung nhận cùng một lớp phủ.
Các định dạng nào được hỗ trợ cho màu văn bản overlay?
SDK chấp nhận mã màu HEX (ví dụ, #FF0000) và các tên màu chuẩn HTML. Xem tài liệu tham chiếu API để có danh sách đầy đủ.
Tôi có cần giấy phép cho việc phát triển và kiểm thử không?
Giấy phép tạm thời là đủ cho việc đánh giá và kiểm thử. Đối với triển khai sản xuất, mua giấy phép đầy đủ từ trang sản phẩm và áp dụng nó bằng API cấp phép của SDK.

Đọc Thêm

Bảo mật Excel bằng mật khẩu qua REST trong Java

Fri, 04 Sep 2026 12:18:34 +0000

Việc ẩn dữ liệu nhạy cảm trong các sổ làm việc Excel là một yêu cầu phổ biến cho các doanh nghiệp chia sẻ báo cáo nội bộ hoặc với đối tác. GroupDocs.Merger Cloud SDK for Java cho phép các nhà phát triển thêm bảo vệ bằng mật khẩu cho các tệp XLSX thông qua một REST API đơn giản. Trong hướng dẫn này, bạn sẽ học cách thực hiện password Protect Excel via REST in Java, xem một ví dụ Java đầy đủ, và chạy các lệnh cURL tương đương cho việc tích hợp đám mây.

Các yêu cầu 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:

Java 8 hoặc cao hơn đã được cài đặt.
Maven hoặc Gradle để quản lý phụ thuộc.
Một tài khoản GroupDocs Cloud với client ID và client secret.
Truy cập vào bộ nhớ đám mây nơi các tệp Excel sẽ được lưu trữ.

Thêm phụ thuộc Maven vào tệp pom.xml của bạn (hoặc đoạn mã Gradle tương đương):


    com.groupdocs
    groupdocs-merger-cloud
    25.11

Bạn có thể tải xuống các JAR mới nhất từ trang tải xuống. Sau khi thêm phụ thuộc, tạo một đối tượng cấu hình với thông tin xác thực của bạn:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Khi client đã sẵn sàng, bạn có thể chuyển sang quy trình bảo vệ mật khẩu thực tế.

Bảo mật Excel bằng mật khẩu qua REST trong Java: Hướng dẫn chi tiết

Bước 1: Tải tài liệu nguồn

Xác định vị trí của tệp XLSX nguồn trong bộ nhớ đám mây của bạn.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Bước 2: Đặt đường dẫn đích

Xác định vị trí lưu workbook được bảo vệ.

String outputPath = "output_protected.xlsx"; // destination file

Bước 3: Cấu hình các tùy chọn bảo vệ bằng mật khẩu

Tạo một đối tượng ProtectOptions, đính kèm thông tin tệp, đường dẫn đầu ra và mật khẩu mong muốn.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Bước 4: Tạo yêu cầu bảo vệ tài liệu

Đóng gói các tùy chọn trong một ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Bước 5: Thực hiện yêu cầu và xử lý phản hồi

Gọi phương thức API và xử lý bất kỳ lỗi nào.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Để biết thêm chi tiết về mỗi lớp, hãy tham khảo API reference.

Ví dụ Hoạt động đầy đủ cho Bảo vệ Excel bằng mật khẩu qua REST trong Java

Đoạn mã sau đây trình bày quy trình hoàn chỉnh từ đầu đến cuối.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

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 các đường dẫn tệp (input.xlsx, output_protected.xlsx) để 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 của bạ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.

Bảo vệ sổ làm việc Excel qua REST API bằng cURL

Dưới đây là một tập hợp các lệnh cURL thực hiện cùng một thao tác bảo vệ bằng mật khẩu trực tiếp trên các endpoint REST.

1. Xác thực và nhận 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 mà bạn sẽ sử dụng trong các cuộc gọi tiếp theo.

2. Tải lên tệp XLSX nguồn

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Yêu cầu bảo vệ bằng mật khẩu

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Tải xuống workbook được bảo vệ

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Các lệnh này cho phép bạn tích hợp quy trình bảo vệ vào các script hoặc pipeline CI. Để biết thêm chi tiết, xem tài liệu API chính thức.

Kết luận

Triển khai bảo mật Excel bằng mật khẩu qua REST trong Java rất đơn giản với GroupDocs.Merger Cloud SDK for Java. Bằng cách thực hiện các bước ở trên, bạn có thể bảo vệ các sổ làm việc Excel, tự động hoá quy trình trong các ứng dụng phía máy chủ và giữ an toàn cho dữ liệu nhạy cảm. Hãy nhớ mua giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; thông tin về giá cả có sẵn trên trang sản phẩm và bạn có thể bắt đầu với một giấy phép tạm thời để đánh giá thư viện. Chúc lập trình vui vẻ!

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

Bảo mật bằng mật khẩu cho Excel qua REST trong Java khác như thế nào so với mã hóa cục bộ?
API đám mây thực hiện việc mã hóa trên máy chủ, vì vậy bạn không cần quản lý các thư viện mật mã cục bộ. SDK xử lý việc xây dựng yêu cầu và phân tích phản hồi, giúp đơn giản hoá quá trình tích hợp.
Có thể thiết lập các tùy chọn bảo vệ bổ sung, chẳng hạn như chế độ chỉ đọc không?
Lớp ProtectOptions hiện tại tập trung vào bảo vệ bằng mật khẩu. Đối với các tính năng bảo mật nâng cao hơn, hãy tham khảo tài liệu API để biết các tham số mới hơn.
Các định dạng tệp nào được hỗ trợ cho việc bảo vệ bằng mật khẩu?
API Merger hiện đang hỗ trợ XLSX, DOCX, PPTX, và PDF để mã hóa. Tham khảo tài liệu chính thức để biết danh sách đầy đủ.
Tôi có cần giấy phép để chạy ví dụ trong môi trường phát triển không?
Việc phát triển và kiểm thử có thể được thực hiện với giấy phép tạm thời. Việc triển khai trong môi trường sản xuất yêu cầu giấy phép trả phí, bạn có thể mua qua trang sản phẩm.

java rest api on Document Processing REST APIs | GroupDocs Cloud

Thêm lớp phủ văn bản vào GIF bằng REST trong Java

Thêm Lớp Văn Bản lên GIF bằng REST trong Java - Mã mẫu

Chồng Văn Bản lên GIF bằng REST API sử dụng cURL

Phân tích Thêm Văn bản Overlay vào GIF bằng REST trong Java - Cách hoạt động

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

Kết luận

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

Đọc Thêm

Bảo mật Excel bằng mật khẩu qua REST trong Java

Các yêu cầu và cài đặt

Bảo mật Excel bằng mật khẩu qua REST trong Java: Hướng dẫn chi tiết

Bước 1: Tải tài liệu nguồn

Bước 2: Đặt đường dẫn đích

Bước 3: Cấu hình các tùy chọn bảo vệ bằng mật khẩu

Bước 4: Tạo yêu cầu bảo vệ tài liệu

Bước 5: Thực hiện yêu cầu và xử lý phản hồi

Ví dụ Hoạt động đầy đủ cho Bảo vệ Excel bằng mật khẩu qua REST trong Java

Bảo vệ sổ làm việc Excel qua REST API bằng cURL

Kết luận

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

Đọc thêm