Ví dụ Hoạt động Đầy đủ để Kết hợp Nhiều Tài liệu Word trong Java

Ví dụ này trình bày cách kết hợp nhiều tài liệu Word trong Java bằng cách sử dụng Merger API.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + 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 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.

Hợp nhất các tệp Word qua REST API bằng cURL

Nếu bạn muốn sử dụng phương pháp REST thuần túy, cùng một thao tác hợp nhất có thể được thực hiện bằng các lệnh cURL. Các bước dưới đây cho thấy cách lấy token truy cập, tải lên các tệp nguồn, yêu cầu hợp nhất và tải xuống kết quả.

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

Tải lên mỗi tệp DOCX lên bộ nhớ đám mây của bạn (thay thế YOUR_ACCESS_TOKEN bằng token từ bước trước):

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

Lặp lại lệnh tải lên cho input2.docx và input3.docx.

Tạo yêu cầu 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 '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

Tải xuống tài liệu đã hợp nhất:

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

Để biết thêm chi tiết về các tham số yêu cầu, xem tài liệu API chính thức.

Hiểu quy trình kết hợp tài liệu Word trong Java

Dưới đây là phân tích từng bước của mã đã được trình bày ở trên.

1. Create an ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") thiết lập kết nối tới dịch vụ đám mây GroupDocs.

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

2. Instantiate MergerApi - new MergerApi(apiClient) cung cấp quyền truy cập vào các endpoint liên quan đến hợp nhất.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Prepare source file list - Mỗi đối tượng FileInfo chỉ tới một tệp DOCX được lưu trữ trên đám mây. Danh sách này được truyền vào MergeOptions.

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. Configure MergeOptions - Đặt đường dẫn đầu ra mong muốn và gắn danh sách các tệp nguồn.

   MergeOptions mergeOptions = new MergeOptions();
   mergeOptions.setOutputPath("merged_output.docx");
   mergeOptions.setFileInfos(sourceFiles);
   

5. Execute merge - mergerApi.merge(mergeOptions) gửi yêu cầu và trả về một FileInfo cho tài liệu đã hợp nhất.

   FileInfo result = mergerApi.merge(mergeOptions);
   

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

Các yêu cầu trước và thiết lập cho GroupDocs.Merger Cloud SDK

Trước khi bạn có thể chạy mã, hãy thêm phụ thuộc Maven vào dự án của bạn và đảm bảo bạn có một tài khoản GroupDocs hợp lệ.

Thêm SDK vào pom.xml của bạn:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Tải xuống các tệp JAR và mã nguồn mới nhất từ trang tải xuống.
Bạn cũng sẽ cần Java 8 hoặc cao hơn và kết nối internet để thực hiện các cuộc gọi đám mây.
Tạo một tài khoản GroupDocs, lấy Client ID và Client Secret của bạn, và giữ chúng an toàn.

Kết luận

Việc hợp nhất các tệp DOCX một cách lập trình hiện đã trở nên đơn giản với GroupDocs.Merger Cloud SDK for Java. Mã mẫu và các đoạn cURL minh họa hai cách linh hoạt để kết hợp nhiều tài liệu Word trong Java, cho dù bạn thích sử dụng thư viện gốc hay gọi trực tiếp REST. Hãy nhớ cấu hình thông tin xác thực của bạn, xử lý các tệp lớn bằng cách streaming nếu cần, và kiểm tra hoạt động hợp nhất với các tài liệu đại diện. Đối với triển khai trong môi trường sản xuất, bạn sẽ cần một giấy phép trả phí; chi tiết giá cả có sẵn trên trang sản phẩm và bạn có thể yêu cầu giấy phép tạm thời để đánh giá từ trang giấy phép tạm thời.

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

• Làm thế nào để kết hợp nhiều tài liệu Word trong Java mà không cần viết mã xử lý tệp tùy chỉnh?
  Sử dụng GroupDocs.Merger Cloud SDK for Java. SDK trừu tượng hoá tất cả các thao tác cấp thấp và cho phép bạn hợp nhất các tệp DOCX chỉ với một vài lời gọi API.

• Có thể hợp nhất các tài liệu được lưu trong các thư mục đám mây khác nhau không?
  Có. Cung cấp đường dẫn tệp đầy đủ trên đám mây trong các đối tượng FileInfo, và thao tác hợp nhất sẽ lấy mỗi tệp từ vị trí của chúng trước khi kết hợp lại.

• Tôi nên làm gì nếu quá trình hợp nhất thất bại với ApiException?
  Kiểm tra thông báo ngoại lệ để biết chi tiết như thiếu tệp hoặc vấn đề quyền truy cập. Đảm bảo các đường dẫn tệp đúng và tài khoản của bạn có quyền đọc/ghi đối với bộ nhớ. Tham khảo tài liệu chính thức để biết mã lỗi.

• Tôi có cần giấy phép riêng cho mỗi môi trường (phát triển, thử nghiệm, sản xuất) không?
  Một giấy phép duy nhất bao phủ tất cả các môi trường, nhưng bạn phải tuân thủ các giới hạn sử dụng được định nghĩa trong thỏa thuận giấy phép của mình. Đối với việc thử nghiệm, bạn có thể sử dụng giấy phép tạm thời được liên kết ở trên.

Đọc thêm

• Bảo vệ tệp ZIP bằng mật khẩu sử dụng phần mềm bảo vệ mật khẩu
• Bảo vệ Excel bằng mật khẩu sử dụng dịch vụ bảo vệ mật khẩu
• Kết hợp tài liệu Word trong C#

Kết hợp nhiều tài liệu Word trong Node.JS - Ví dụ mã hoàn chỉnh

Ví dụ này minh họa cách hợp nhất ba tệp DOCX thành một tài liệu duy nhất bằng cách sử dụng GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

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 đảm bảo cập nhật các đường dẫn tệp (input1.docx, combined_output.docx, v.v.) cho 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.

Kết hợp tài liệu Word qua REST API bằng cURL

Nếu bạn ưu tiên cách tiếp cận REST thuần túy, cùng một thao tác hợp nhất có thể được thực hiện bằng các lệnh cURL. Dưới đây là quy trình ngắn gọn xác thực, tải lên các tệp nguồn, thực hiện hợp nhất và tải xuống kết quả.

1. Xác thực và Lấy Mã Truy cập

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/authenticate" \
-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 các tệp nguồn

Lặp lại bước này cho mỗi tệp DOCX mà bạn muốn hợp nhất.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. Thực hiện 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 '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

API trả về đường dẫn của tệp đã hợp nhất.

4. Tải xuống tài liệu đã hợp nhất

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

Để biết thêm chi tiết về payload yêu cầu và các tùy chọn, xem tài liệu API chính thức.

Cách hoạt động của việc hợp nhất nhiều tài liệu Word trong Node.JS

SDK trừu tượng hóa quá trình hợp nhất thành một vài bước logic:

1. Tạo cấu hình - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) tạo ngữ cảnh xác thực. Xem tham chiếu lớp trong API Reference.

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

2. API Instance - new GroupDocsMergerCloud.MergeApi(config) cung cấp quyền truy cập vào các thao tác hợp nhất.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Các mục tài liệu - Mỗi tệp nguồn được bao bọc trong một DocumentEntry chứa một FileInfo với đường dẫn tệp.

   const documentEntries = inputFiles.map(path => {
       return new GroupDocsMergerCloud.Models.DocumentEntry({
           fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
       });
   });
   

4. Yêu cầu hợp nhất - MergeDocumentsRequest gói các mục và đường dẫn đầu ra mong muốn.

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. Thực thi - mergeApi.mergeDocuments(mergeRequest) gửi yêu cầu tới dịch vụ đám mây. Promise trả về một đối tượng kết quả chứa đường dẫn tệp đầu ra.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

Các bước này cùng nhau cho phép bạn kết hợp nhiều tài liệu Word một cách hiệu quả mà không cần xử lý các luồng tệp cấp thấp.

Chuẩn bị môi trường cho GroupDocs.Merger

1. Cài đặt SDK

npm install groupdocs-merger-cloud

Gói có sẵn từ trang tải xuống chính thức.

2. Node.js Version - Đảm bảo bạn đang chạy Node.js 12 hoặc mới hơn.

3. Cấu hình thông tin xác thực - Thay thế YOUR_CLIENT_ID và YOUR_CLIENT_SECRET trong mã bằng các giá trị từ tài khoản GroupDocs Cloud của bạn.

4. Tạo Thư Mục Dự Án - Đặt các tệp DOCX nguồn vào thư mục con documents/ như được minh họa trong ví dụ.

Với các bước này đã hoàn thành, bạn đã sẵn sàng để chạy script hợp nhất hoặc gọi các endpoint REST.

Kết luận

Kết hợp nhiều tài liệu Word trong Node.JS trở nên đơn giản với GroupDocs.Merger Cloud SDK for Node.js. SDK xử lý việc tải lên tệp, logic hợp nhất và tạo đầu ra, cho phép bạn tập trung vào logic nghiệp vụ thay vì thao tác tệp cấp thấp. Hãy nhớ đảm bảo có giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; bạn có thể bắt đầu với một giấy phép tạm thời và nâng cấp lên đăng ký đầy đủ khi nhu cầu của bạn tăng lên. Bắt đầu hợp nhất ngay hôm nay và tối ưu hoá quy trình công việc tài liệu của bạn.

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

• Làm thế nào để kết hợp nhiều tài liệu Word trong Node.JS bằng SDK?
  Sử dụng lớp MergeApi để tạo một MergeDocumentsRequest liệt kê mỗi tệp DOCX dưới dạng DocumentEntry. SDK sẽ hợp nhất chúng theo thứ tự đã cung cấp và lưu kết quả vào đường dẫn đầu ra đã chỉ định.

• Liệu có thể hợp nhất các tệp PDF lại với cùng một SDK không?
  Có, Merger SDK hỗ trợ PDF, DOCX, ODT, và một số định dạng khác. Chỉ cần thay đổi phần mở rộng tệp trong mảng inputFiles và SDK sẽ tự động xử lý việc chuyển đổi. Xem tài liệu chính thức để biết chi tiết về các định dạng.

• Giới hạn về số lượng tài liệu tôi có thể hợp nhất trong một yêu cầu là bao nhiêu?
  Dịch vụ đám mây áp dụng giới hạn kích thước thay vì số lượng cố định. Miễn là tổng kích thước vẫn nằm trong hạn mức tài khoản của bạn, bạn có thể hợp nhất hàng chục tệp. Đối với các lô rất lớn, hãy cân nhắc tải các tệp lên lưu trữ GroupDocs trước và tham chiếu chúng bằng ID.

• Tôi có cần lo lắng về giấy phép cho phát triển so với sản xuất không?
  Phát triển và kiểm thử có thể sử dụng giấy phép tạm thời được lấy từ trang giấy phép tạm thời. Đối với triển khai sản xuất, mua giấy phép đầy đủ để mở khóa số lần hợp nhất không giới hạn và hỗ trợ ưu tiên.

Đọc thêm

• Bảo vệ tệp ZIP bằng phần mềm bảo vệ mật khẩu
• Bảo vệ Excel bằng dịch vụ bảo vệ mật khẩu
• Kết hợp tài liệu Word trong C#