Java에서 GroupDocs.Viewer를 사용하여 DOCX를 HTML로 변환하는 방법

이 가이드에서는 GroupDocs.Viewer를 사용하여 Java에서 DOCX를 HTML로 변환하고, 필요한 페이지만 렌더링하는 데 중점을 둡니다. 계약 검토 포털, e‑learning 모듈, 또는 보고 대시보드를 구축하든, 아래 단계에서는 웹 UI에 바로 삽입할 수 있는 가볍고 자체 포함된 HTML을 만드는 방법을 보여줍니다.

빠른 답변

  • “render pages”는 무엇을 의미합니까? 선택한 문서 페이지를 HTML과 같은 보기 가능한 형식으로 변환하는 것입니다.
  • 생성되는 형식은 무엇입니까? 이미지, CSS, 폰트가 포함된 HTML.
  • 라이선스가 필요합니까? 평가용으로는 체험판으로 충분하지만, 프로덕션에서는 정식 라이선스가 필요합니다.
  • 연속되지 않은 페이지를 선택할 수 있나요? 예 – 필요한 페이지 번호를 지정하면 됩니다.
  • 캐싱이 권장되나요? 물론입니다. 렌더링된 HTML을 캐시하면 자주 접근하는 페이지의 로드 시간이 감소합니다.

GroupDocs.Viewer for Java를 사용하여 문서의 선택된 페이지 렌더링

GroupDocs.Viewer for Java를 사용하여 문서의 선택된 페이지 렌더링

배울 내용

  • Java 환경에 GroupDocs.Viewer 설정하기
  • Viewer API를 사용하여 특정 문서 페이지 렌더링
  • 최적의 표시를 위한 HTML 보기 옵션 구성
  • 실용적인 사용 사례 및 통합 시나리오

선택된 페이지 렌더링이란?

선택된 페이지 렌더링은 원본 문서에서 지정한 페이지만 추출하여 각각 자체 포함된 HTML 파일로 변환합니다. 이를 통해 관련 섹션만 제공하게 되어 대역폭과 로드 시간이 감소하고 레이아웃, 이미지, 폰트를 그대로 유지합니다.

왜 Java에서 DOCX를 HTML로 변환하나요?

Java에서 DOCX를 HTML로 변환하면 외부 플러그인 없이도 작동하는 가볍고 브라우저 친화적인 표현을 만들 수 있어 웹 포털, e‑learning, 보고 대시보드에 이상적입니다. 포함된 리소스는 모든 브라우저에서 페이지가 올바르게 표시되도록 보장하며, 현재의 교차 출처 문제를 제거합니다.

사전 요구 사항

개발 환경이 다음 요구 사항을 충족하는지 확인하십시오:

  1. 필수 라이브러리 – 프로젝트에 GroupDocs.Viewer for Java (버전 25.2 이상)를 포함합니다.
  2. 환경 – JDK 8 이상; IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  3. 지식 – 기본 Java 프로그래밍 및 Maven 의존성 관리.

Java용 GroupDocs.Viewer 설정

GroupDocs.Viewer for Java는 DOCX, PDF, PPT 등을 포함한 90개 이상의 문서 형식을 HTML, PDF 또는 이미지로 렌더링하는 서버 측 라이브러리입니다.

Maven을 통한 설치

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>

라이선스 획득

  • 무료 체험 – 비용 없이 모든 기능을 탐색할 수 있습니다.
  • 임시 라이선스 – 체험 기간 이후에도 테스트를 연장할 수 있습니다.
  • 정식 구매 – 프로덕션 배포에 필요합니다.

기본 초기화 및 설정

import com.groupdocs.viewer.Viewer;

public class DocumentViewer {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
            // Your rendering logic here
        }
    }
}

선택된 페이지로 Java에서 DOCX를 HTML로 변환하는 방법

HtmlViewOptions는 리소스 포함 및 페이지 레이아웃을 포함한 Viewer의 HTML 출력 방식을 구성합니다.
view()는 지정된 옵션에 따라 문서를 렌더링하고 생성된 파일을 반환합니다.

GroupDocs.Viewer를 사용하여 DOCX를 로드하고, 포함된 리소스를 위해 HtmlViewOptions를 구성한 뒤 페이지 번호 목록을 view() 메서드에 전달합니다. 이렇게 하면 해당 페이지만 개별 HTML 파일로 렌더링되며, 각 파일에는 포함된 이미지와 CSS가 포함되어 즉시 빠르게 표시됩니다.

단계 1: 출력 경로 구성

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
  • 설명: outputDirectory는 생성된 HTML 파일이 저장되는 위치입니다.
  • 명명: page_{0}.html은 각 렌더링된 페이지마다 별도 파일을 생성합니다.

단계 2: HTML 보기 옵션 설정

HtmlViewOptions는 Viewer가 HTML을 출력하는 방식을 정의하며, 리소스 포함, 페이지 크기 설정, CSS 생성 제어 등을 할 수 있습니다.

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
  • 설명: forEmbeddedResources()는 이미지, CSS, 폰트를 각 HTML 파일에 직접 포함시켜 외부 종속성을 제거합니다.

단계 3: 원하는 페이지 렌더링

try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    viewer.view(viewOptions, 1, 3);
}
  • 설명: view() 메서드는 HtmlViewOptions와 페이지 번호 목록을 받습니다. 이 예제에서는 첫 번째와 세 번째 페이지만 렌더링됩니다.

실용적인 적용 사례

선택된 페이지 렌더링은 다양한 시나리오에서 유용합니다:

  1. 법률 문서 – 계약서의 관련 조항만 표시합니다.
  2. 교육 플랫폼 – 전체 교과서를 다운로드하지 않고 특정 챕터를 미리 볼 수 있게 합니다.
  3. 비즈니스 보고서 – 주요 보고서 섹션을 표시하여 이해관계자에게 간결한 요약을 제공합니다.

성능 고려 사항

  • 메모리 관리 – (예시와 같이) try‑with‑resources를 사용하여 Viewer 리소스를 즉시 해제합니다.
  • 캐싱 – 자주 접근하는 페이지에 대해 렌더링된 HTML을 캐시(예: Redis 또는 메모리) 에 저장합니다.
  • 리소스 최소화 – 포함된 리소스로 파일 크기가 약간 증가하므로 대역폭이 문제라면 HTML 출력을 압축하는 것을 고려하십시오.
  • 확장성 – GroupDocs.Viewer는 스트리밍 아키텍처 덕분에 전체 파일을 메메에 로드하지 않고도 최대 500페이지 문서를 처리할 수 있습니다.

일반적인 문제 및 해결책

문제해결책
파일을 찾을 수 없음절대/상대 경로를 다시 확인하고 파일이 존재하는지 확인하십시오.
대용량 문서의 메모리 부족필요한 페이지만 렌더링하거나 JVM 힙 크기(-Xmx)를 늘리십시오.
HTML에서 이미지 누락forEmbeddedResources가 사용되었는지 확인하십시오; 그렇지 않으면 이미지가 별도로 저장됩니다.
라이선스 오류유효한 GroupDocs.Viewer.lic 파일을 애플리케이션 루트에 두거나 프로그래밍 방식으로 경로를 지정하십시오.

자주 묻는 질문

Q: GroupDocs.Viewer for Java란 무엇인가요?
A: GroupDocs.Viewer for Java는 Java 애플리케이션 내에서 90개 이상의 문서 형식(PDF, DOCX, PPT 등)을 직접 렌더링할 수 있게 해주는 라이브러리입니다.

Q: 이 방법으로 PDF 페이지를 렌더링할 수 있나요?
A: 예 – Viewer API는 PDF를 포함한 다양한 형식을 지원합니다.

Q: 대용량 문서를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 필요한 페이지만 렌더링하고 캐싱을 활용하여 반복 처리를 방지합니다.

Q: HTML 파일에 리소스를 포함시키는 장점은 무엇인가요?
A: 페이지당 하나의 자체 포함 파일을 만들어 배포가 간단해지고 외부 자산 로딩이 필요 없게 됩니다.

Q: GroupDocs.Viewer for Java에 대한 추가 정보를 어디서 찾을 수 있나요?

리소스

마지막 업데이트: 2026-10-05
테스트 대상: GroupDocs.Viewer 25.2
작성자: GroupDocs

관련 튜토리얼