Java와 GroupDocs.Viewer를 사용하여 Excel에서 HTML 생성 방법

워크북에서 중요한 부분만 표시하면서 Excel에서 HTML 생성을 빠르게 해야 한다면, 정의된 인쇄 영역 섹션을 렌더링하는 것이 최선입니다. 이 튜토리얼에서는 Excel 파일에서 인쇄 영역만 추출하고 GroupDocs.Viewer for Java를 사용하여 깔끔하고 독립적인 HTML 페이지를 출력하는 Java 미리보기 솔루션을 만드는 방법을 단계별로 안내합니다. 이 접근 방식이 로딩 속도를 높이고 대역폭을 줄이며 UI를 깔끔하게 유지하는 이유를 확인할 수 있습니다—포털, 대시보드 및 모든 웹 기반 문서 뷰어에 이상적입니다.

Spreadsheet Print Areas Rendering with GroupDocs.Viewer for Java

빠른 답변

  • “Excel에서 HTML 생성”이 의미하는 바는? 이는 프로그래밍 방식으로 Excel 워크북을 브라우저가 Excel 없이도 표시할 수 있는 웹 준비된 HTML 페이지로 변환한다는 의미입니다.
  • 왜 Excel 인쇄 영역만 렌더링하나요? 가장 관련성 높은 데이터를 분리하여 렌더링 시간과 대역폭을 줄입니다.
  • 이것을 시도하려면 라이선스가 필요합니까? 무료 체험 또는 임시 라이선스를 사용할 수 있으며, 프로덕션 환경에서는 정식 라이선스가 필요합니다.
  • 지원되는 Java 버전은? Java 8 이상 (Java 11 권장).
  • 미리보기를 웹 페이지에 삽입할 수 있나요? 예—embedded‑resources 옵션을 사용하여 독립형 HTML 페이지를 생성합니다.

“Excel에서 HTML 생성”이란?

Generate HTML from Excel은 XLSX 워크북의 시각적 레이아웃을 브라우저가 기본적으로 렌더링할 수 있는 표준 HTML 마크업으로 변환하는 것을 의미합니다. 이 기술을 사용하면 클라이언트 측에 Microsoft Office가 없어도 웹 애플리케이션에서 스프레드시트 데이터를 즉시 미리볼 수 있습니다.

왜 Excel 인쇄 영역만 렌더링하나요?

인쇄 영역만 렌더링하면 HTML 페이로드가 작아져 일반 보고서의 로딩 속도가 최대 60 % 빨라집니다. 또한 민감한 수식이 포함될 수 있는 내부 워크시트를 숨겨 보안을 강화합니다. 사용자가 정의한 인쇄 영역에 집중함으로써 작성자의 의도에 맞는 더 깔끔하고 목적이 뚜렷한 뷰를 제공할 수 있습니다.

필수 조건

  • GroupDocs.Viewer for Java v25.2 이상 (70개 이상의 문서 형식을 지원하고 전체 파일을 메모리에 로드하지 않고 최대 10,000행의 스프레드시트를 처리할 수 있음).
  • 개발 머신에 Maven이 설치되어 있어야 합니다.
  • JDK 8 이상 (Java 11 권장).
  • IDE (IntelliJ IDEA, Eclipse, VS Code 중 하나).

GroupDocs.Viewer for Java 설정

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>

라이선스 획득

무료 체험으로 시작하거나 평가용 임시 라이선스를 요청하십시오. 프로덕션 준비가 되면 전체 기능을 활성화하고 체험 제한을 해제하기 위해 정식 라이선스를 구매하십시오.

기본 초기화

Viewer는 문서를 로드하고 렌더링 파이프라인을 구동하는 핵심 클래스입니다. 다음은 GroupDocs.Viewer로 스프레드시트를 열기 위해 필요한 최소 코드입니다:

import com.groupdocs.viewer.Viewer;

// Initialize Viewer object with the path to your spreadsheet
try (Viewer viewer = new Viewer("path/to/your/spreadsheet.xlsx")) {
    // Further configurations will be discussed in upcoming sections.
}

GroupDocs.Viewer를 사용하여 XLSX를 HTML로 변환하는 방법

이 섹션에서는 GroupDocs.Viewer를 사용하여 XLSX 워크북을 정의된 인쇄 영역 섹션만 표시하는 독립형 HTML 파일로 변환하는 방법을 보여줍니다. 뷰 옵션을 구성하고 뷰어를 호출함으로써 웹 페이지나 포털에 삽입하기 적합한 가벼운 미리보기를 생성할 수 있습니다.

다음은 Excel 인쇄 영역만 렌더링하여 독립형 HTML 파일을 생성하는 단계별 안내입니다.

단계 1: 출력 디렉터리 및 파일 경로 형식 정의

먼저, 뷰어에 생성된 HTML 페이지를 쓸 위치를 지정합니다.

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

// Set the output directory path
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

// Define a file path format for the rendered pages
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

설명: outputDirectory는 모든 미리보기 파일을 보관할 폴더입니다. pageFilePathFormat는 뷰어가 페이지 번호로 교체하는 자리 표시자({0})를 사용합니다.

단계 2: 인쇄 영역 렌더링을 위한 HTML 뷰 옵션 구성

HtmlViewOptions는 HTML 생성 방식을 제어합니다. forEmbeddedResources는 페이지당 하나의 HTML 파일을 생성하며, 모든 CSS/JS를 인라인으로 포함시켜 배포를 간소화합니다. forRenderingPrintArea()는 엔진에 Excel 인쇄 영역만 렌더링하도록 지시합니다.

import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

// Configure HTML view options with embedded resources and print area rendering
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingPrintArea());

설명: HtmlViewOptions.forEmbeddedResources는 페이지당 하나의 HTML 파일을 생성하며, 모든 CSS/JS를 인라인으로 포함시켜 배포를 간소화합니다. forRenderingPrintArea()는 엔진에 Excel 인쇄 영역만 렌더링하도록 지시합니다.

단계 3: 스프레드시트를 로드하고 렌더링

마지막으로, 뷰어가 워크북을 가리키도록 하고 렌더링 프로세스를 호출합니다.

// Replace with your actual document path
Path documentPath = Paths.get("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_PRINT_AREAS.xlsx");

try (Viewer viewer = new Viewer(documentPath.toString())) {
    // Render to HTML using the configured view options
    viewer.view(viewOptions);
}

설명: view() 메서드는 설정한 옵션에 따라 워크북을 처리하고, 인쇄 영역 섹션만 표시하는 HTML 파일을 출력합니다.

일반적인 문제 및 해결책

  • 파일 경로 오류: 경로가 절대 경로이거나 프로젝트 작업 디렉터리에 대해 올바르게 상대 경로인지 다시 확인하십시오.
  • 권한 문제: Java 프로세스가 소스 파일에 대한 읽기 권한과 출력 폴더에 대한 쓰기 권한을 가지고 있는지 확인하십시오.
  • 인쇄 영역 누락: 스프레드시트에 실제로 인쇄 영역이 정의되어 있는지 확인하십시오 (Excel의 페이지 레이아웃 → 인쇄 영역).

실제 적용 사례

  1. 문서 관리 시스템: 전체 워크북을 로드하지 않고도 보고서의 깔끔한 미리보기를 최종 사용자에게 보여줍니다.
  2. 재무 대시보드: 인쇄 영역으로 표시된 주요 재무 테이블의 HTML 스냅샷을 자동으로 생성합니다.
  3. 학습 플랫폼: 학생들에게 과제 데이터의 집중된 뷰를 제공합니다.
  4. CRM 포털: 내부 워크시트를 숨기면서 고객 지표를 강조합니다.
  5. 데이터 과학 노트북: 문서에 간결한 스프레드시트 미리보기를 삽입합니다.

성능 팁

  • 메모리 튜닝: 매우 큰 워크북의 경우 JVM 힙(-Xmx2g 이상)을 늘리십시오.
  • 지연 로딩: 첫 몇 페이지만 필요하면 필요한 페이지 수 이후에 렌더링을 중지하십시오.
  • 병렬 처리: 별도의 Viewer 인스턴스(각각 자체 스레드)를 사용하여 여러 워크북을 동시에 렌더링합니다.

인쇄 영역 없이 스프레드시트 미리보기 방법

SpreadsheetOptions는 스프레드시트 렌더링 동작을 구성하며, 정의된 인쇄 영역으로 출력 제한 여부를 포함합니다. 나중에 전체 워크북을 표시하려면 SpreadsheetOptions.forRenderingPrintArea() 호출을 생략하고 기본 SpreadsheetOptions를 사용하면 됩니다. 이렇게 하면 모든 워크시트와 셀을 렌더링하여 원본 파일에 포함된 모든 데이터, 수식 및 서식을 포함하는 완전한 convert XLSX to HTML 미리보기를 제공합니다.

결론

이제 Java에서 Excel에서 HTML 생성을 수행하면서 스프레드시트의 정의된 인쇄 영역만 렌더링하는 방법을 배웠습니다. 이 기술은 미리보기를 더 빠르고, 깔끔하며, 안전하게 만들어 현대 웹 및 엔터프라이즈 애플리케이션에 적합합니다.

다음 단계

  • PdfViewOptions 또는 PngViewOptions를 사용하여 다른 뷰 형식(PDF, PNG)을 실험해 보세요.
  • 민감한 데이터를 보호하기 위해 인증과 미리보기 생성을 결합하십시오.
  • 맞춤 페이지 크기, 그리드라인 등 다양한 기능을 위해 전체 SpreadsheetOptions API를 살펴보세요.

자주 묻는 질문

Q: Excel 인쇄 영역만 렌더링하는 주요 이점은 무엇인가요?
A: 불필요한 요소를 줄이고 렌더링 속도를 높여 가장 중요한 데이터를 강조하는 집중된 미리보기를 제공합니다.

Q: 인쇄 불가능한 워크시트도 렌더링할 수 있나요?
A: 예—SpreadsheetOptions.forRenderingPrintArea()를 생략하고 기본 옵션을 사용하면 전체 워크북을 렌더링합니다.

Q: GroupDocs.Viewer가 다른 스프레드시트 형식을 지원하나요?
A: XLS, XLSX, CSV, ODS 등 여러 형식을 처리합니다. 전체 목록은 공식 문서를 확인하십시오.

Q: 매우 큰 파일의 렌더링 속도를 어떻게 개선할 수 있나요?
A: JVM 힙 크기를 늘리고, 필요한 페이지만 렌더링하며, 멀티스레드 처리를 고려하십시오.

Q: 인쇄 영역이 표시되지 않아요—무엇을 확인해야 하나요?
A: 소스 파일에 인쇄 영역이 정의되어 있는지(Excel → 페이지 레이아웃 → 인쇄 영역)와 최신 GroupDocs.Viewer 버전을 사용하고 있는지 확인하십시오.

리소스

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

관련 튜토리얼