DOCX에서 HTML 생성 및 추적된 변경 사항 렌더링 (Java)

DOCX에서 HTML을 생성하면서 모든 추적된 수정 사항을 표시해야 한다면, 바로 올바른 곳에 오셨습니다. 이 튜토리얼에서는 워드 추적 변경 사항을 렌더링하고, 워드 문서를 깔끔하고 탐색 가능한 HTML로 변환하는 방법을 단계별로 안내하며, 문서 검토 포털, 법률 사건 관리 시스템, 혹은 워드 문서 수정 사항 보기가 필요한 모든 애플리케이션을 구축할 수 있는 도구를 제공합니다. Maven 설정부터 최종 HTML 파일까지 전체 흐름을 보여드리므로 몇 분 안에 Java 프로젝트에 적용할 수 있습니다.

GroupDocs.Viewer for Java를 사용한 워드 문서의 추적된 변경 사항 렌더링

빠른 답변

  • “워드 추적 변경 사항을 렌더링한다”는 무슨 의미인가요? 워드 파일의 수정 마크업을 시각적인 HTML 표현으로 변환합니다.
  • 어떤 라이브러리가 이를 처리하나요? GroupDocs.Viewer for Java.
  • 라이선스가 필요합니까? 무료 체험으로 평가할 수 있으며, 정식 라이선스를 구매하면 모든 제한이 해제됩니다.
  • 필요한 Java 버전은 무엇인가요? Java 8 이상.
  • 추적된 변경 사항 렌더링을 비활성화할 수 있나요? 예—뷰 옵션에서 setRenderTrackedChanges(false)를 설정하면 됩니다.

“워드 추적 변경 사항 렌더링”이란?

워드 추적 변경 사항을 렌더링한다는 것은 .docx 파일 내부에 저장된 수정 데이터(삽입, 삭제, 댓글 등)를 가져와 일반적으로 HTML 형태의 시각적으로 강조된 포맷으로 만드는 것을 의미합니다. 이를 통해 최종 사용자는 Microsoft Word를 열지 않고도 정확히 어떤 부분이 수정되었는지 확인할 수 있습니다.

워드 문서 수정 사항을 보기 위해 GroupDocs.Viewer를 사용하는 이유

GroupDocs.Viewer for Java는 저수준 OpenXML 처리를 추상화하고 HTML, PDF, 이미지 등으로 변환하는 단일 API 호출을 제공합니다. 또한 워드 문서 수정 사항 보기를 기본적으로 지원하여 스타일링, 임베드된 리소스 및 변경 추적을 그대로 유지합니다.

전제 조건

  • GroupDocs.Viewer for Java 라이브러리 버전 25.2 이상.
  • 의존성 관리를 위한 Maven.
  • 기본 Java 개발 환경(IDE, JDK 8 이상).

GroupDocs.Viewer for Java 설정

Maven 구성

pom.xml에 GroupDocs 저장소와 의존성을 추가합니다:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득

무료 체험으로 시작하거나 임시 평가 라이선스를 요청하세요. 프로덕션에 준비가 되면 전체 기능을 해제하는 정식 라이선스를 구매합니다.

기본 초기화

Java 코드에서 필요한 클래스를 임포트하고 입력 및 출력 파일 경로를 준비합니다.

DOCX에서 HTML을 생성하고 추적된 변경 사항을 렌더링하는 방법

아래는 필요한 정확한 코드를 그대로 반영한 단계별 가이드입니다. 코드 블록은 원본 튜토리얼과 동일하게 유지됩니다.

단계 1: 출력 디렉터리 경로 정의

렌더링된 HTML 페이지를 저장할 폴더를 생성합니다.

Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RenderTrackedChanges");

단계 2: 각 페이지 저장 형식 지정

생성되는 각 HTML 파일에 대한 명명 패턴을 설정합니다.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

단계 3: 보기 옵션 구성

임베드된 리소스를 활성화하고 추적된 변경 사항 렌더링을 켭니다.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true);

단계 4: Viewer 인스턴스 생성 및 렌더링

추적된 변경 사항이 포함된 워드 문서를 로드하고 HTML 출력을 생성합니다.

try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SAMPLE_DOCX_WITH_TRACKED_CHANGES"))) {
    viewer.view(viewOptions);
}

워드 문서에서 변경 사항을 렌더링하는 방법 – 일반적인 함정

  • 잘못된 파일 경로 – YOUR_OUTPUT_DIRECTORY와 YOUR_DOCUMENT_DIRECTORY가 실제 존재하는 폴더를 가리키는지 다시 확인하세요.
  • 지원되지 않는 문서 형식 – 파일이 GroupDocs.Viewer가 지원하는 .docx 또는 .doc인지 확인하세요.
  • 라이선스 누락 – 유효한 라이선스가 없으면 라이브러리가 렌더링 기능을 제한할 수 있습니다.

실용적인 적용 사례

  1. 문서 검토 시스템 – 검토자에게 추가되거나 삭제된 내용을 정확히 보여줍니다.
  2. 법률 사건 관리 – 계약서나 소송 서류의 수정 사항을 강조합니다.
  3. 학술 협업 – 여러 저자의 기여도를 시각화합니다.

성능 고려 사항

  • 메모리 사용량을 낮게 유지하려면 동시에 처리하는 문서 수를 제한하세요.
  • I/O 오버헤드를 줄이기 위해 효율적인 디렉터리 구조를 사용하세요.
  • 라이브러리를 최신 버전으로 유지하세요; 최신 릴리스에는 성능 최적화가 포함됩니다.

결론

이제 GroupDocs.Viewer for Java를 사용해 DOCX에서 HTML을 생성하고 워드 추적 변경 사항을 렌더링하는 완전한 프로덕션 준비 방법을 갖추었습니다. 이 단계를 애플리케이션에 통합하면 사용자는 강력하고 인터랙티브한 문서 검토 경험을 제공받게 됩니다.

자주 묻는 질문

Q: 최소 Java 버전은 무엇인가요?
A: 일반적으로 최신 라이브러리와 호환성을 위해 Java 8 이상을 권장합니다.

Q: 추적된 변경 사항 없이 문서를 렌더링할 수 있나요?
A: 예, 구성 옵션에서 setRenderTrackedChanges(true)를 비활성화하면 됩니다.

Q: 대용량 문서를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 큰 파일을 작은 섹션으로 나누거나 페이지네이션 기법을 사용해 리소스 사용을 효과적으로 관리하세요.

Q: GroupDocs.Viewer의 라이선스 옵션은 어떻게 되나요?
A: 무료 체험으로 시작하고, 임시 평가 라이선스를 선택하거나 프로젝트 요구에 맞춰 정식 라이선스를 구매할 수 있습니다.

Q: 문제가 발생했을 때 지원을 받을 수 있나요?
A: 예, GroupDocs 포럼 및 공식 문서 리소스를 통해 지원을 받을 수 있습니다.

Last Updated: 2026-03-29
Tested With: GroupDocs.Viewer for Java 25.2
Author: GroupDocs

리소스