"What is the minimum Java version required?"

"Java 8 or later is recommended; the library is also compatible with Java 11, 17, and newer LTS releases."

"Can I render documents without tracked changes?"

"Yes, set `setRenderTrackedChanges(false)` in the `ViewOptions` to produce clean HTML without revision highlights."

"How do I handle large documents efficiently?"

"Break large files into sections, use pagination options, and keep the library updated—Version 25.2 processes 500‑page docs in under 5 seconds on standard hardware."

"What are the licensing options for GroupDocs.Viewer?"

"Start with a free trial, obtain a temporary evaluation license, or purchase a full commercial license that removes all limitations and provides priority support."

"Is support available if I encounter issues?"

"Yes, you can get help through the GroupDocs forum, official documentation, and direct support tickets for licensed customers."

docx에서 HTML을 생성하고 Java에서 추적된 변경 사항을 렌더링

이 가이드에서는 소스 Word 파일에 나타나는 모든 추적된 수정 사항을 보존하면서 docx에서 HTML을 생성하는 방법을 배웁니다. 계약 검토 포털, 법률 사건 관리 시스템, 또는 협업 편집 UI를 구축하든, 추적된 변경 사항을 HTML로 렌더링하면 사용자가 추가, 삭제, 주석된 내용을 정확히 확인할 수 있으며 Microsoft Word를 설치할 필요가 없습니다. 이 튜토리얼은 Maven 설정, 라이선스 및 깔끔하고 탐색 가능한 HTML 페이지를 출력하는 데 필요한 전체 Java 코드를 단계별로 안내합니다.

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

빠른 답변

“render word tracked changes”가 무엇을 의미하나요? 워드 파일의 수정 마크업을 삽입, 삭제 및 주석에 대한 하이라이트가 포함된 시각적 HTML 표현으로 변환합니다.
어떤 라이브러리가 이를 처리하나요? GroupDocs.Viewer for Java는 HTML, PDF 또는 이미지 렌더링과 추적된 변경 마크업 포함을 위한 단일 API를 제공합니다.
라이선스가 필요합니까? 무료 체험판으로 평가할 수 있으며, 정식 라이선스를 구매하면 모든 체험 제한이 해제되고 대량 렌더링이 가능해집니다.
필요한 Java 버전은 무엇인가요? Java 8 이상을 지원하며, 라이브러리는 Java 11, 17 및 이후 LTS 릴리스와 호환됩니다.
추적된 변경 사항 렌더링을 비활성화할 수 있나요? 예—뷰 옵션에서 setRenderTrackedChanges(false)를 설정하면 수정 하이라이트 없이 깨끗한 문서를 생성할 수 있습니다.

render word tracked changes란 무엇인가요?

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

왜 GroupDocs.Viewer를 사용하여 워드 문서 수정 사항을 보나요?

GroupDocs.Viewer for Java는 저수준 OpenXML 처리를 추상화하고 HTML, PDF 또는 이미지를 생성하기 위한 단일 API 호출을 제공합니다. 120개 이상의 형식을 지원하며 전체 파일을 메모리에 로드하지 않고도 최대 2 GB 문서를 렌더링할 수 있어 응답 시간이 개선되고 서버 부하가 감소합니다. 또한 라이브러리는 스타일, 임베디드 리소스 및 변경 추적 정보를 기본적으로 보존합니다.

전제 조건

GroupDocs.Viewer for Java 라이브러리 버전 25.2 이상.
의존성 관리를 위한 Maven.
Java 개발 환경 (IDE, JDK 8+).
평가용 또는 상용 라이선스 키 (무료 체험 가능).

GroupDocs.Viewer for Java 설정

Maven 구성

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

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

라이선스 획득

무료 체험으로 시작하거나 임시 평가 라이선스를 요청하세요. 프로덕션 준비가 되면 전체 라이선스를 구매하여 모든 기능을 활성화하고 체험 워터마크를 제거할 수 있습니다.

기본 초기화

Viewer 클래스는 문서를 로드하고 렌더링 기능을 제공합니다. ViewOptions 클래스는 문서가 어떻게 렌더링되는지, 추적된 변경 사항을 표시할지 여부 등을 사용자 정의할 수 있게 해줍니다.

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

Viewer 클래스로 DOCX 파일을 로드하고, ViewOptions를 구성하여 추적된 변경 렌더링을 활성화한 뒤 render를 호출하면 일련의 HTML 페이지가 생성됩니다. 전체 과정은 몇 줄의 코드만으로 가능하며 임베디드 이미지, 표, 복잡한 레이아웃을 자동으로 처리합니다.

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

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

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

Step 2: 각 페이지 저장 형식 지정

생성된 각 HTML 파일에 대한 이름 패턴을 설정합니다.

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

Step 3: 뷰 옵션 구성

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

ViewOptions를 사용하면 렌더링 파이프라인을 세밀하게 조정할 수 있습니다; 이 클래스는 setRenderTrackedChanges 및 setRenderEmbeddedResources와 같은 속성을 제공합니다. 기본적으로 임베디드 이미지는 HTML 파일과 함께 저장되어 완전한 웹 뷰를 보장합니다.

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

Step 4: 뷰어 인스턴스 생성 및 렌더링

Viewer 클래스는 문서를 로드하고 원하는 형식으로 렌더링하는 GroupDocs.Viewer의 핵심 구성 요소입니다.

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

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

필수 단계를 건너뛰면 출력에 수정 내용이 누락되거나 리소스를 로드하지 못할 수 있습니다. 가장 흔한 문제는 잘못된 파일 경로, 지원되지 않는 문서 형식, 라이선스 누락입니다. render를 호출하기 전에 존재하는 디렉터리를 지정하고, 지원되는 .docx/.doc 파일을 사용하며, 유효한 라이선스 키를 제공하십시오.

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

실용적인 적용 사례

문서 검토 시스템 – 검토자에게 추가되거나 삭제된 내용을 인라인 하이라이트와 함께 정확히 보여줍니다.
법률 사건 관리 – 계약서나 소송 서류의 수정 사항을 강조하여 감사 추적을 용이하게 합니다.
학술 협업 – 여러 저자의 기여를 하나의 검색 가능한 HTML 뷰에서 시각화합니다.

성능 고려 사항

동시에 처리하는 문서 수를 제한하여 메모리 사용량을 낮게 유지합니다.
효율적인 디렉터리 구조를 사용하여 I/O 오버헤드를 줄입니다.
라이브러리를 최신 상태로 유지하십시오; 최신 릴리스에는 성능 최적화가 포함되어 있어 일반 서버에서 500페이지 문서를 5초 미만에 렌더링할 수 있습니다.

결론

이제 GroupDocs.Viewer for Java를 사용하여 docx에서 HTML을 생성하고 워드 추적 변경 사항을 렌더링하는 완전하고 프로덕션 준비된 방법을 갖추었습니다. 이러한 단계를 애플리케이션에 통합하면 Microsoft Office 없이도 브라우저와 디바이스 전반에서 작동하는 강력하고 인터랙티브한 문서 검토 경험을 사용자에게 제공할 수 있습니다.

자주 묻는 질문

Q: 최소 Java 버전은 무엇인가요?
A: Java 8 이상을 권장하며, 라이브러리는 Java 11, 17 및 최신 LTS 릴리스와도 호환됩니다.

Q: 추적된 변경 사항 없이 문서를 렌더링할 수 있나요?
A: 예, ViewOptions에서 setRenderTrackedChanges(false)를 설정하면 수정 하이라이트 없이 깨끗한 HTML을 생성할 수 있습니다.

Q: 대용량 문서를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 큰 파일을 섹션으로 나누고, 페이지 매김 옵션을 사용하며, 라이브러리를 최신 상태로 유지하십시오—버전 25.2는 표준 하드웨어에서 500페이지 문서를 5초 미만에 처리합니다.

Q: GroupDocs.Viewer의 라이선스 옵션은 무엇인가요?
A: 무료 체험으로 시작하고, 임시 평가 라이선스를 얻거나, 모든 제한을 해제하고 우선 지원을 제공하는 정식 상용 라이선스를 구매할 수 있습니다.

Q: 문제가 발생하면 지원을 받을 수 있나요?
A: 예, GroupDocs 포럼, 공식 문서 및 라이선스 고객을 위한 직접 지원 티켓을 통해 도움을 받을 수 있습니다.

마지막 업데이트: 2026-09-25
테스트 환경: GroupDocs.Viewer for Java 25.2
작성자: GroupDocs