Полный рабочий пример объединения нескольких документов Word в Java

Этот пример демонстрирует, как объединить несколько документов Word в Java с помощью 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());
        }
    }
}

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что вы обновили все пути к файлам и значения конфигурации, чтобы они соответствовали вашей реальной среде, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Объединение файлов Word через REST API с использованием cURL

Если вы предпочитаете чистый REST‑подход, ту же операцию объединения можно выполнить с помощью вызовов cURL. Ниже приведены шаги, показывающие, как получить токен доступа, загрузить исходные файлы, запросить объединение и скачать результат.

Аутентифицируйтесь и получите токен доступа:

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

Загрузите каждый файл DOCX в ваше облачное хранилище (замените YOUR_ACCESS_TOKEN токеном из предыдущего шага):

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

Повторите команду загрузки для input2.docx и input3.docx.

Создайте запрос на слияние:

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

Скачать объединённый документ:

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

Для получения более подробной информации о параметрах запроса см. официальную документацию API.

Понимание процесса объединения документов Word в Java

Ниже приведён пошаговый разбор кода, показанного ранее.

1. Создать ApiClient – new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") устанавливает соединение с облачным сервисом GroupDocs.

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

2. Создать экземпляр MergerApi – new MergerApi(apiClient) дает доступ к эндпоинтам, связанным с объединением.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Подготовить список исходных файлов – Каждый объект FileInfo указывает на DOCX‑файл, хранящийся в облаке. Список передаётся в MergeOptions.

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

4. Настроить MergeOptions – Установите желаемый путь вывода и прикрепите список исходных файлов.

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

5. Выполнить объединение – mergerApi.merge(mergeOptions) отправляет запрос и возвращает FileInfo для объединённого документа.

   FileInfo result = mergerApi.merge(mergeOptions);
   

Для полного списка доступных свойств обратитесь к Справке API.

Требования и настройка для GroupDocs.Merger Cloud SDK

Прежде чем запускать код, добавьте зависимость Maven в ваш проект и убедитесь, что у вас есть действующая учетная запись GroupDocs.

Добавьте SDK в ваш pom.xml:

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

Скачайте последние JAR‑файлы и исходный код со страницы загрузки.
Вам также понадобится Java 8 или новее и доступ в интернет для облачных вызовов.
Создайте учетную запись GroupDocs, получите ваш Client ID и Client Secret и храните их в безопасности.

Заключение

Объединение файлов DOCX программно теперь просто с помощью GroupDocs.Merger Cloud SDK for Java. Пример кода и фрагменты cURL демонстрируют два гибких способа объединения нескольких документов Word в Java, независимо от того, предпочитаете ли вы нативную библиотеку или прямые вызовы REST. Не забудьте настроить свои учетные данные, при необходимости обрабатывать большие файлы с помощью потоковой передачи и протестировать операцию объединения на репрезентативных документах. Для развертывания в продакшн вам понадобится платная лицензия; детали ценообразования доступны на странице продукта, а также вы можете запросить временную лицензию для оценки на странице временной лицензии.

FAQs

• Как объединить несколько документов Word в Java без написания собственного кода для работы с файлами?
  Используйте GroupDocs.Merger Cloud SDK for Java. SDK абстрагирует все низкоуровневые операции и позволяет объединять файлы DOCX с помощью нескольких вызовов API.

• Можно ли объединять документы, хранящиеся в разных облачных папках?
  Да. Укажите полные пути к файлам в облаке в объектах FileInfo, и операция слияния получит каждый файл из его местоположения перед объединением.

• Что делать, если слияние завершилось неудачей с ApiException?
  Проверьте сообщение исключения для получения деталей, таких как отсутствие файлов или проблемы с разрешениями. Убедитесь, что пути к файлам правильные и что ваша учетная запись имеет права чтения/записи к хранилищу. Обратитесь к официальной документации для получения кодов ошибок.

• Нужна ли отдельная лицензия для каждой среды (development, staging, production)?
  Одна лицензия покрывает все среды, но вы должны соблюдать ограничения использования, определённые в вашем лицензионном соглашении. Для тестирования вы можете использовать временную лицензию, указанную выше.

Читать дальше

• Защита ZIP‑файла паролем с помощью программного обеспечения для защиты паролем
• Защита Excel паролем с помощью сервиса защиты паролем
• Объединение документов Word на C#

Объединение нескольких документов Word в Node.JS — полный пример кода

Этот пример демонстрирует, как объединить три файла DOCX в один документ, используя 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);
    }
})();

Примечание: Этот пример кода демонстрирует основную функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили пути к файлам (input1.docx, combined_output.docx, и т.д.), чтобы они соответствовали фактическим расположениям, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут какие‑либо проблемы, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Объединение Word-документов через REST API с помощью cURL

Если вы предпочитаете чистый REST‑подход, ту же операцию слияния можно выполнить с помощью команд cURL. Ниже представлен краткий рабочий процесс, который аутентифицирует, загружает исходные файлы, выполняет слияние и скачивает результат.

1. Аутентификация и получение токена доступа

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

Ответ содержит access_token, используемый в последующих вызовах.

2. Загрузка исходных файлов

Повторите этот шаг для каждого файла DOCX, который вы хотите объединить.

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. Выполнение операции слияния

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 возвращает путь к объединённому файлу.

4. Скачивание объединённого документа

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

Для получения более подробной информации о полезных нагрузках запросов и параметрах см. официальную документацию API.

Как работает объединение нескольких документов Word в Node.JS

SDK абстрагирует процесс слияния в несколько логических шагов:

1. Создание конфигурации - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) создает контекст аутентификации. См. справочник класса в Справочник API.

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

2. Экземпляр API - new GroupDocsMergerCloud.MergeApi(config) предоставляет доступ к операциям слияния.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Document Entries - Каждый исходный файл оборачивается в DocumentEntry, который содержит FileInfo с путем к файлу.

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

4. Merge Request - MergeDocumentsRequest объединяет записи и желаемый путь вывода.

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

5. Выполнение - mergeApi.mergeDocuments(mergeRequest) отправляет запрос в облачный сервис. Промис разрешается объектом результата, содержащим путь к выходному файлу.

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

Эти шаги вместе позволяют эффективно объединять несколько документов Word без работы с потоками низкого уровня.

Подготовка среды для GroupDocs.Merger

1. Установите SDK

npm install groupdocs-merger-cloud

Пакет доступен на официальной странице загрузки.

2. Node.js Version - Убедитесь, что вы используете Node.js 12 или новее.

3. Настройка учетных данных - Замените YOUR_CLIENT_ID и YOUR_CLIENT_SECRET в коде значениями из вашей учетной записи GroupDocs Cloud.

4. Создать папку проекта - Поместите исходные файлы DOCX в подпапку documents/, как показано в примере.

После выполнения этих шагов вы готовы запустить скрипт слияния или вызвать REST‑конечные точки.

Заключение

Объединение нескольких документов Word в Node.JS становится простым с помощью GroupDocs.Merger Cloud SDK for Node.js. SDK обрабатывает загрузку файлов, логику объединения и генерацию вывода, позволяя сосредоточиться на бизнес‑логике, а не на низкоуровневой работе с файлами. Не забудьте обеспечить наличие правильной лицензии для использования в продакшене; вы можете начать с временной лицензии и перейти на полную подписку по мере роста ваших потребностей. Начните объединять документы уже сегодня и оптимизируйте свои рабочие процессы с документами.

Часто задаваемые вопросы

• Как объединить несколько документов Word в Node.JS с помощью SDK?
  Используйте класс MergeApi для создания MergeDocumentsRequest, в котором перечисляются каждый DOCX файл как DocumentEntry. SDK объединяет их в указанном порядке и сохраняет результат по заданному пути вывода.

• Можно ли объединять PDF-файлы с помощью того же SDK?
  Да, Merger SDK поддерживает PDF, DOCX, ODT, и несколько других форматов. Просто измените расширения файлов в массиве inputFiles, и SDK выполнит конвертацию автоматически. Смотрите официальную документацию для получения подробностей о форматах.

• Каковы ограничения на количество документов, которые я могу объединить в одном запросе?
  Облачный сервис накладывает ограничение по размеру, а не по количеству. Пока суммарный размер находится в пределах квоты вашего аккаунта, вы можете объединять десятки файлов. Для очень больших пакетов рекомендуется сначала загрузить файлы в хранилище GroupDocs и ссылаться на них по ID.

• Нужно ли беспокоиться о лицензировании для разработки и продакшна?
  Для разработки и тестирования можно использовать временную лицензию, полученную со страницы страница временной лицензии. Для развертывания в продакшн необходимо приобрести полную лицензию, чтобы разблокировать неограниченное количество слияний и приоритетную поддержку.

Read More

• Защита ZIP‑файла паролем с помощью программного обеспечения для защиты паролем
• Защита Excel паролем с помощью сервиса защиты паролем
• Объединение Word‑документов на C#