Редактировать документы Word на Java

Mon, 28 Sep 2026 16:09:16 +0000

Редактирование файлов Microsoft Word удалённо — распространённая задача при создании совместных Java‑приложений. GroupDocs.Editor Cloud SDK for Java предоставляет мощную библиотеку на основе REST, позволяющую редактировать документы Word в Java без необходимости самостоятельно разбирать файлы. В этом руководстве вы узнаете, как выполнить аутентификацию, заменить текст, вызвать конечную точку редактирования и загрузить обновлённый DOCX, всё это с понятными примерами кода и советами по производительности.

Как редактировать документы Word в Java - пошагово

Настройте клиент API с вашими учетными данными: Создайте объект Configuration, задайте clientId, clientSecret и базовый URL, затем создайте экземпляры ApiClient и необходимых API.

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
config.setBaseUrl("https://api.groupdocs.cloud");

ApiClient apiClient = new ApiClient(config);
EditorApi editorApi = new EditorApi(apiClient);
FilesApi filesApi = new FilesApi(apiClient);

Подготовьте FileInfo для исходного DOCX: Укажите путь к входному файлу, хранящемуся в хранилище GroupDocs Cloud.

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

Определите операцию ReplaceText: Создайте экземпляр ReplaceText с текстом, который нужно заменить, и добавьте его в список.

ReplaceText replace = new ReplaceText();
replace.setOldValue("Hello");
replace.setNewValue("Hi");
List<ReplaceText> replaceList = new ArrayList<>();
replaceList.add(replace);

Создайте EditDocumentOptions и вызовите editDocument: Объедините информацию о файле, параметры редактирования и настройки вывода, затем вызовите метод editDocument. Это основной шаг, где вы действительно редактируете документы Word в Java.

EditOptions editOptions = new EditOptions();
editOptions.setReplaceText(replaceList);

EditDocumentOptions options = new EditDocumentOptions();
options.setFileInfo(fileInfo);
options.setOutputPath("output.docx");
options.setFormat("docx");
options.setEditOptions(editOptions);

EditDocumentRequest editRequest = new EditDocumentRequest(options);
EditDocumentResult editResult = editorApi.editDocument(editRequest);
System.out.println("Document edited. Document ID: " + editResult.getDocumentId());

Скачать отредактированный файл DOCX: Используйте FilesApi для получения отредактированного файла из облачного хранилища.

DownloadFileRequest downloadRequest = new DownloadFileRequest("output.docx");
InputStream inputStream = filesApi.downloadFile(downloadRequest);
try (FileOutputStream outputStream = new FileOutputStream("downloaded_output.docx")) {
    byte[] buffer = new byte[8192];
    int bytesRead;
    while ((bytesRead = inputStream.read(buffer)) != -1) {
        outputStream.write(buffer, 0, bytesRead);
    }
    System.out.println("Edited document downloaded as downloaded_output.docx");
}

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

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

Следующий пример демонстрирует, как отредактировать файл DOCX, заменяя текст с помощью GroupDocs.Editor Cloud SDK for Java.

import com.groupdocs.editor.cloud.api.EditorApi;
import com.groupdocs.editor.cloud.api.FilesApi;
import com.groupdocs.editor.cloud.client.ApiClient;
import com.groupdocs.editor.cloud.client.ApiException;
import com.groupdocs.editor.cloud.client.Configuration;
import com.groupdocs.editor.cloud.model.EditDocumentOptions;
import com.groupdocs.editor.cloud.model.EditDocumentResult;
import com.groupdocs.editor.cloud.model.EditOptions;
import com.groupdocs.editor.cloud.model.FileInfo;
import com.groupdocs.editor.cloud.model.ReplaceText;
import com.groupdocs.editor.cloud.model.requests.EditDocumentRequest;
import com.groupdocs.editor.cloud.model.requests.DownloadFileRequest;

import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

public class GroupDocsEditorExample {
    public static void main(String[] args) {
        // Configuration – replace with your actual credentials
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        config.setBaseUrl("https://api.groupdocs.cloud");

ApiClient apiClient = new ApiClient(config);
        EditorApi editorApi = new EditorApi(apiClient);
        FilesApi filesApi = new FilesApi(apiClient);

// Input and output file paths in the cloud storage
        String inputPath = "input.docx";
        String outputPath = "output.docx";

try {
            // Prepare file information
            FileInfo fileInfo = new FileInfo();
            fileInfo.setFilePath(inputPath);

// Define replace text operation
            ReplaceText replace = new ReplaceText();
            replace.setOldValue("Hello");
            replace.setNewValue("Hi");
            List<ReplaceText> replaceList = new ArrayList<>();
            replaceList.add(replace);

// Set edit options
            EditOptions editOptions = new EditOptions();
            editOptions.setReplaceText(replaceList);

// Build edit document options
            EditDocumentOptions options = new EditDocumentOptions();
            options.setFileInfo(fileInfo);
            options.setOutputPath(outputPath);
            options.setFormat("docx");
            options.setEditOptions(editOptions);

// Execute edit operation
            EditDocumentRequest editRequest = new EditDocumentRequest(options);
            EditDocumentResult editResult = editorApi.editDocument(editRequest);
            System.out.println("Document edited. Document ID: " + editResult.getDocumentId());

// Download the edited document
            DownloadFileRequest downloadRequest = new DownloadFileRequest(outputPath);
            InputStream inputStream = filesApi.downloadFile(downloadRequest);
            try (FileOutputStream outputStream = new FileOutputStream("downloaded_output.docx")) {
                byte[] buffer = new byte[8192];
                int bytesRead;
                while ((bytesRead = inputStream.read(buffer)) != -1) {
                    outputStream.write(buffer, 0, bytesRead);
                }
                System.out.println("Edited document downloaded as downloaded_output.docx");
            } finally {
                if (inputStream != null) {
                    inputStream.close();
                }
            }
        } catch (ApiException apiEx) {
            System.err.println("API error: " + apiEx.getMessage());
        } catch (IOException ioEx) {
            System.err.println("IO error: " + ioEx.getMessage());
        }
    }
}

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

Изменение Word-документов через REST на Java с использованием cURL

Ниже приведён cURL‑workflow, который выполняет ту же операцию замены текста без написания кода на Java. Он полезен для быстрой проверки или интеграции с другими сервисами.

Получить токен доступа (замените заполнители вашими учетными данными).

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Загрузите исходный DOCX в ваше облачное хранилище.

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.docx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/local/input.docx"

Вызовите endpoint editDocument с JSON payload, определяющим операцию замены.

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit/document" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "fileInfo": { "filePath": "input.docx" },
        "outputPath": "output.docx",
        "format": "docx",
        "editOptions": {
            "replaceText": [
                { "oldValue": "Hello", "newValue": "Hi" }
            ]
        }
      }'

Скачайте отредактированный файл после успешного завершения операции.

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

Для полной спецификации REST см. справку API.

Установка и настройка GroupDocs.Editor Cloud SDK for Java

Добавьте SDK в ваш Maven‑проект, используя предоставленный фрагмент зависимости.


    com.groupdocs
    groupdocs-editor-cloud
    25.7

Скачайте последние JAR‑файлы со страницы загрузки.
Убедитесь, что ваша среда выполнения Java версии 8 или выше, и что у вас есть действующая учетная запись GroupDocs Cloud с идентификатором клиента и секретом.

Ключевые возможности GroupDocs.Editor Cloud SDK for Java

Полное редактирование Word – Замена текста, изображений и таблиц в форматах DOCX, DOC, и ODT .
Интеграция с облачным хранилищем – Работает напрямую с GroupDocs Cloud storage, исключая обработку файлов локально.
Работает на основе REST API – Все операции выполняются через защищённые HTTP‑вызовы, что идеально подходит для микросервисных архитектур.
Потоковая загрузка – Большие документы передаются потоково, чтобы избежать высокого потребления памяти.
Расширяемые параметры – Тонкая настройка поведения редактирования через EditOptions (например, замена текста, удаление комментариев).

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

Настройка параметров редактирования документа

Объект EditOptions позволяет указать, какие изменения применить. В примере мы использовали replaceText, но вы также можете настроить другие действия, такие как удаление комментариев или обновление полей.

EditOptions editOptions = new EditOptions();
editOptions.setReplaceText(replaceList); // replaceList defined earlier

Дополнительные параметры, такие как removeComments или updateFields, задокументированы в справке API.

Соображения по производительности при редактировании Word через REST

Использовать потоковую передачу: SDK передаёт содержимое файлов потоково, что уменьшает использование кучи для больших файлов DOCX.
Пакетные замены: Объединяйте несколько объектов ReplaceText в один запрос, чтобы избежать повторных сетевых вызовов.
Хранить файлы в облаке: Выполнение операций редактирования непосредственно над файлами, хранящимися в облаке, избавляет от накладных расходов на загрузку и скачивание больших бинарных файлов несколько раз.
Повторное использование ApiClient: Создайте ApiClient один раз и повторно используйте его для нескольких операций редактирования, чтобы воспользоваться пулом соединений.

Заключение

Редактирование Word‑документов в Java становится простым с помощью GroupDocs.Editor Cloud SDK for Java. Следуя шагам, примеру кода и cURL‑рабочему процессу, представленным здесь, вы можете интегрировать мощные возможности редактирования документов в любой Java‑бэкенд сервис. Не забудьте защитить учетные данные клиента, протестировать с временной лицензией со страницы временной лицензии, и перейти на производственную лицензию, когда перейдёте в рабочую среду. Приятного кодинга!

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

Как я могу редактировать документы Word в Java, используя REST API?
Используйте endpoint editDocument SDK GroupDocs.Editor Cloud SDK for Java. Отправьте JSON‑payload, определяющий операции замены, и сервис вернёт отредактированный DOCX.
Какой лучший способ аутентифицировать вызовы к Editor API?
Создайте объект Configuration с вашим client ID и client secret, затем позвольте SDK автоматически получить токен OAuth. См. официальную документацию для получения дополнительной информации.
Могу ли я заменить несколько заполнителей в одном запросе?
Да. Добавьте несколько записей ReplaceText в список replaceText внутри EditOptions. SDK обрабатывает все замены в одном вызове редактирования.
Есть ли ограничение на размер файла Word, который я могу редактировать?
Облачный сервис обрабатывает файлы размером до нескольких сотен мегабайт, но для оптимальной производительности рекомендуется держать файлы менее 100 МБ и использовать потоковую загрузку, чтобы избежать скачков памяти.

rest document editing on Document Processing REST APIs | GroupDocs Cloud

Редактировать документы Word на Java

Как редактировать документы Word в Java - пошагово

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

Изменение Word-документов через REST на Java с использованием cURL

Установка и настройка GroupDocs.Editor Cloud SDK for Java

Ключевые возможности GroupDocs.Editor Cloud SDK for Java

Настройка параметров редактирования документа

Соображения по производительности при редактировании Word через REST

Заключение

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

Читать далее

rest document editing on Document Processing REST APIs | GroupDocs Cloud

Редактировать документы Word на Java

Как редактировать документы Word в Java - пошагово

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

Изменение Word-документов через REST на Java с использованием cURL

Установка и настройка GroupDocs.Editor Cloud SDK for Java

Ключевые возможности GroupDocs.Editor Cloud SDK for Java

Настройка параметров редактирования документа

Соображения по производительности при редактировании Word через REST

Заключение

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

Читать далее

Как редактировать документы Word в Java - пошагово