Преобразование docx в docm в Java с GroupDocs.Editor

В современных корпоративных рабочих процессах convert docx to docm программно, чтобы вы могли автоматизировать создание отчетов, персонализацию контрактов и коммуникации, основанные на шаблонах. Используя GroupDocs.Editor для Java, вы избегаете необходимости в Microsoft Office на сервере, сохраняете точность макета и получаете возможность заменять текст в docx, экспортировать Word в txt или преобразовывать Word в rtf — всё из одного легковесного API. Это руководство проведет вас через загрузку файла DOCX, при необходимости редактирование его HTML и сохранение результата как DOCM или в других популярных форматах.

Быстрые ответы

• Какая библиотека позволяет редактировать документы Word в Java? GroupDocs.Editor for Java.
• Могу ли я автоматически заменять текст? Yes – the HTML markup API lets you search and replace strings across the document.
• В какие форматы я могу экспортировать? DOCM, RTF, plain‑text (TXT), and more.
• Нужна ли лицензия для разработки? A free trial works for testing; a commercial license is required for production.
• Совместим ли он с проектами Maven? Absolutely – just add the repository and dependency.

Что такое «edit word document java»?

Загрузка файла .docx в память, изменение его содержимого (текст, изображения, таблицы, макросы) через API и запись обновленного файла обратно на диск или в поток — это то, что означает «edit word document java». GroupDocs.Editor абстрагирует формат Office Open XML и представляет простую модель редактирования на основе HTML, позволяя обращаться с документом как с веб-страницей.

Почему стоит использовать GroupDocs.Editor для редактирования word document java?

GroupDocs.Editor позволяет вам convert docx to docm и выполнять массовые операции без установки Microsoft Office. Он поддерживает 30+ input and output formats, обрабатывает файлы в несколько сотен страниц, используя менее 200 МБ памяти кучи, и может выполнять batch process word docs со скоростью 150 документов в минуту на типичном 8‑ядерном сервере. Библиотека также сохраняет макросы в файлах DOCM, поддерживает оригинальное форматирование и работает на любой платформе, совместимой с Java.

Требования

• Java 8 или новее и инструмент сборки (Maven или Gradle).
• Доступ к библиотеке GroupDocs.Editor for Java (версия 25.3 или новее).
• Базовое знакомство с Java и управлением зависимостями Maven.

Настройка GroupDocs.Editor для Java

Установка через Maven

Add the GroupDocs repository and dependency to your pom.xml:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/editor/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-editor</artifactId>
        <version>25.3</version>
    </dependency>
</dependencies>

Прямое скачивание

В качестве альтернативы загрузите последний JAR со страницы GroupDocs.Editor for Java releases page.

Приобретение лицензии

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

Базовая инициализация и настройка

Editor is the core class that provides loading, editing, and saving capabilities for Word documents. Create an Editor instance that points to your source DOCX file:

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.options.WordProcessingLoadOptions;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());

Теперь вы готовы загружать, редактировать и сохранять документы.

Как преобразовать docx в docm с помощью GroupDocs.Editor

Загрузите DOCX, при необходимости измените его HTML, а затем сохраните результат как файл DOCM. Конвертация требует всего три вызова API: создать экземпляр Editor, загрузить документ в EditableDocument и вызвать save с параметрами Docm. После сохранения вы можете дальше обрабатывать DOCM, например, загружать его в систему управления документами или прикреплять к письму, не теряя встроенные макросы или форматирование.

Шаг 1: загрузить документ

EditableDocument представляет файл Word, который можно редактировать как HTML. Загрузка возвращает этот объект, которым вы затем можете управлять.

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());
EditableDocument defaultWordProcessingDoc = editor.edit();

Шаг 2: (опционально) редактировать содержимое

Если необходимо заменить заполнители, обновите встроенный HTML, используя стандартные методы замены строк или регулярные выражения.

String allEmbeddedInsideString = defaultWordProcessingDoc.getEmbeddedHtml();
String modifiedContent = allEmbeddedInsideString.replace("Subtitle", "Edited subtitle");

Шаг 3: сохранить как DOCM

Настройте параметры сохранения для формата DOCM и запишите результат в файл или поток.

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import com.groupdocs.editor.formats.WordProcessingFormats;

WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);

import java.io.ByteArrayOutputStream;
import java.io.OutputStream;

String outputDocmPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.docm";
try (OutputStream outputStream = new ByteArrayOutputStream()) {
    // Create a new EditableDocument from the (possibly) modified HTML
    EditableDocument editedDocDocm = EditableDocument.fromMarkup(modifiedContent, null);
    editor.save(editedDocDocm, outputStream, docmSaveOptions);
    // If you need a physical file, write the stream to disk here
}

Совет: Dispose of EditableDocument and Editor objects as soon as you’re done to free native resources and keep memory usage low.

Сохранить документ как RTF

Экспорт в формат Rich Text полезен, когда downstream системы понимают только RTF. Тот же EditableDocument можно сохранить с параметрами RTF.

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import com.groupdocs.editor.formats.WordProcessingFormats;

String outputRtfPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.rtf";
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);

EditableDocument editedDocRtf = EditableDocument.fromMarkup(modifiedContent, null);
editor.save(editedDocRtf, outputRtfPath, rtfSaveOptions);
editedDocRtf.dispose();
editor.dispose();

Сохранить документ как обычный текст

Вывод в виде обычного текста идеален для индексации, аналитики или передачи содержимого в поисковые системы.

import com.groupdocs.editor.options.TextSaveOptions;
import java.nio.charset.StandardCharsets;

TextSaveOptions textSaveOptions = new TextSaveOptions();
textSaveOptions.setEncoding(StandardCharsets.UTF_8);
textSaveOptions.setPreserveTableLayout(true);

String outputTxtPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.txt";
editor.save(editedDocTxt, outputTxtPath, textSaveOptions);

Практические применения

1. Автоматизация создания отчетов – Pull data from databases, replace placeholders, and output a polished DOCX, DOCM, or RTF report.
2. Настройка шаблона Word – Dynamically fill marketing or legal templates based on user input.
3. Экспорт Word в txt – Extract raw text for search indexing, analytics, or further processing.
4. Замена текста в docx – Use the HTML markup API to perform bulk find‑and‑replace across many documents in a single batch job.

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

• Своевременно освобождайте объекты EditableDocument и Editor, чтобы освободить нативные ресурсы.
• Для очень больших файлов обрабатывайте секции порциями или используйте потоковые API, чтобы держать использование памяти ниже 250 MB.
• Предпочитайте StringBuilder или скомпилированные регулярные выражения при массовой замене текста, чтобы минимизировать нагрузку на CPU.

Распространённые проблемы и решения

Класс License применяет ваш файл лицензии GroupDocs.Editor, чтобы включить полную функциональность.

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

Q: Can I edit password‑protected Word files?
A: Да. Load the document with WordProcessingLoadOptions that include the password, then proceed as usual.

Q: Does GroupDocs.Editor support macros in DOCM files?
A: Библиотека сохраняет макросы, но не выполняет их. Вы можете сохранить файл DOCM с существующими макросами без изменений.

Q: How do I handle images embedded in the document?
A: Изображения сохраняются как часть HTML‑разметки. Заменяйте теги <img> или добавляйте новые, используя стандартный HTML.

Q: Is it possible to convert directly to PDF?
A: GroupDocs.Editor ориентирован на редактирование; для конвертации в PDF комбинируйте его с GroupDocs.Conversion после сохранения отредактированного DOCX.

Q: What versions of Java are supported?
A: Java 8 и новее полностью поддерживаются.

Заключение

Теперь у вас есть полный сквозной процесс для convert docx to docm с использованием GroupDocs.Editor. Загружая DOCX, при необходимости редактируя его HTML и экспортируя в DOCM, RTF или обычный текст, вы можете автоматизировать бесчисленные задачи, связанные с документами, в Java‑приложениях. Исследуйте дополнительные возможности, такие как проверка орфографии, отслеживание изменений или интеграция с GroupDocs.Conversion, чтобы ещё больше расширить ваше решение.

Последнее обновление: 2026-09-16
Тестировано с: GroupDocs.Editor 25.3 for Java
Автор: GroupDocs

Связанные руководства

• Преобразование docx в PDF Java: пакетное редактирование файлов Word с GroupDocs.Editor – пошаговое руководство
• Как преобразовать Docx в HTML и редактировать документы Word в Java
• Как преобразовать HTML в DOCX с помощью GroupDocs.Editor для Java