Java와 GroupDocs.Editor를 사용하여 DOCX를 DOCM으로 변환

오늘날 빠르게 변화하는 비즈니스 환경에서 Java 코드에서 직접 convert docx to docm 할 수 있으면 수작업을 크게 줄이고 호환성 문제를 없앨 수 있습니다. 분기 보고서를 업데이트하거나 계약 템플릿을 맞춤화하거나 개인화된 편지를 생성해야 할 때, 프로그래밍 방식 편집은 클릭 기반 도구가 종종 제공하지 못하는 속도와 신뢰성을 제공합니다. 이 가이드는 DOCX 파일을 로드하고, 프로그래밍 방식으로 내용을 수정한 뒤, GroupDocs.Editor for Java를 사용해 DOCM을 포함한 여러 인기 포맷으로 저장하는 과정을 단계별로 안내합니다.

빠른 답변

Java에서 Word 문서를 편집할 수 있는 라이브러리는? GroupDocs.Editor for Java.
텍스트를 자동으로 교체할 수 있나요? 예 – HTML 마크업 API를 사용해 문자열을 검색하고 교체합니다.
어떤 포맷으로 내보낼 수 있나요? DOCM, RTF, plain‑text 등.
개발에 라이선스가 필요합니까? 테스트용으로는 무료 체험판으로 충분하지만, 운영 환경에서는 상용 라이선스가 필요합니다.
Maven 프로젝트와 호환되나요? 물론입니다 – 저장소와 의존성을 추가하기만 하면 됩니다.

“edit word document java”란 무엇인가요?

Java에서 Word 문서를 편집한다는 것은 .docx 파일을 메모리로 로드하고, API를 통해 텍스트, 이미지, 표 등 내용을 조작한 뒤, 업데이트된 파일을 디스크나 스트림에 다시 쓰는 것을 의미합니다. GroupDocs.Editor는 복잡한 Office Open XML 포맷을 추상화하여 간단한 HTML 기반 편집 모델을 제공합니다.

Java에서 Word 문서를 편집하기 위해 GroupDocs.Editor를 사용하는 이유

Microsoft Office 의존성 없음 – 모든 서버나 컨테이너에서 작동합니다.
고품질 보존 – 원본 레이아웃, 스타일 및 삽입된 객체를 유지합니다.
다양한 출력 포맷 – 한 번의 호출로 DOCX, DOCM, RTF, TXT 사이를 전환할 수 있습니다.
확장성 – 대량 문서 세트의 배치 처리에 적합합니다.

사전 요구 사항

Java 8 이상 및 빌드 도구(Maven 또는 Gradle).
GroupDocs.Editor for Java 라이브러리(버전 25.3 이상) 접근 권한.
Java와 Maven 의존성 관리에 대한 기본 지식.

GroupDocs.Editor for 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 인스턴스를 생성하여 소스 DOCX 파일을 지정합니다:

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());

이제 문서를 로드하고, 편집하고, 저장할 준비가 되었습니다.

GroupDocs.Editor를 사용하여 docx를 docm으로 변환하는 방법

변환 과정은 간단합니다: DOCX를 로드하고, 필요하면 HTML을 편집한 뒤, Docm 포맷으로 저장합니다. 아래 단계에서는 이미 소개된 코드 블록을 재사용하므로 추가 코드를 작성할 필요가 없습니다.

Step 1: 문서 로드

개요: 로드하면 조작할 수 있는 EditableDocument 객체를 얻을 수 있습니다.

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();

Step 2: (선택) 내용 편집

플레이스홀더를 교체하거나 템플릿을 맞춤화해야 할 경우, 삽입된 HTML을 수정하십시오.

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

Step 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
}

팁: 사용이 끝난 EditableDocument와 Editor 객체는 즉시 해제하여 네이티브 리소스를 해제하십시오.

문서를 RTF로 저장

개요: 편집 후 Rich Text Format(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);

실용적인 적용 사례

보고서 자동 생성 – 데이터베이스에서 데이터를 가져와 플레이스홀더를 교체하고, 정교한 DOCX, DOCM 또는 RTF 보고서를 출력합니다.
Word 템플릿 맞춤화 – 사용자 입력에 따라 마케팅 또는 법률 템플릿을 동적으로 채웁니다.
Word를 txt로 내보내기 – 검색 색인, 분석 또는 추가 처리용으로 원시 텍스트를 추출합니다.
docx java 텍스트 교체 – HTML 마크업 API를 사용해 다수의 문서에서 대량 찾기·바꾸기 작업을 수행합니다.

성능 고려 사항

사용이 끝난 EditableDocument와 Editor 객체는 즉시 해제하여 네이티브 리소스를 해제합니다.
매우 큰 파일의 경우 섹션을 청크 단위로 처리하거나 스트리밍 API를 사용해 메모리 사용량을 낮게 유지합니다.
대량 텍스트 교체 시 StringBuilder 또는 효율적인 정규식을 사용하는 것이 좋습니다.

일반적인 문제와 해결책

문제	해결책
파일을 찾을 수 없음 / 접근 거부	절대 경로를 확인하고 Java 프로세스에 읽기/쓰기 권한이 있는지 확인하십시오.
대용량 문서에서 메모리 부족 오류	JVM 힙(`-Xmx`)을 늘리거나 편집 전에 문서를 더 작은 부분으로 나누십시오.
교체 후 서식 손실	HTML 마크업 API를 신중히 사용하고, 마크업 태그 자체를 교체하지 않도록 주의하십시오.
라이선스가 적용되지 않음	`License license = new License(); license.setLicense("path/to/license.file");` 를 `Editor` 생성 전에 호출하십시오.

자주 묻는 질문

Q: 비밀번호로 보호된 Word 파일을 편집할 수 있나요?
A: 예. 비밀번호를 포함한 WordProcessingLoadOptions로 문서를 로드한 후 일반적으로 진행하면 됩니다.

Q: GroupDocs.Editor가 DOCM 파일의 매크로를 지원하나요?
A: 라이브러리는 매크로를 보존하지만 실행하지는 않습니다. 기존 매크로가 포함된 DOCM 파일을 그대로 저장할 수 있습니다.

Q: 문서에 삽입된 이미지를 어떻게 처리하나요?
A: 이미지는 HTML 마크업의 일부로 유지됩니다. 표준 HTML을 사용해 <img> 태그를 교체하거나 새 태그를 추가할 수 있습니다.

Q: 직접 PDF로 변환할 수 있나요?
A: GroupDocs.Editor는 편집에 중점을 두며, PDF 변환은 편집된 DOCX를 저장한 후 GroupDocs.Conversion과 결합하여 수행합니다.

Q: 지원되는 Java 버전은 무엇인가요?
A: Java 8 이상을 완전하게 지원합니다.

결론

이제 GroupDocs.Editor를 사용하여 convert docx to docm 하는 완전한 엔드‑투‑엔드 워크플로우를 갖추었습니다. DOCX를 로드하고, 프로그래밍 방식으로 HTML을 수정한 뒤, RTF, DOCM 또는 일반 텍스트와 같은 포맷으로 내보내면 Java 애플리케이션에서 수많은 문서 중심 작업을 자동화할 수 있습니다. 맞춤법 검사, 변경 추적, GroupDocs.Conversion과의 통합 등 추가 기능을 탐색하여 솔루션을 더욱 확장해 보세요.

마지막 업데이트: 2026-03-20
테스트 환경: GroupDocs.Editor 25.3 for Java
작성자: GroupDocs