Java에서 GroupDocs Viewer를 사용하여 Excel을 PDF로 변환

현대 데이터 기반 애플리케이션에서 Java에서 Excel을 PDF로 변환하는 능력은 생산성을 크게 높여줍니다. GroupDocs.Viewer를 사용하면 복잡한 스프레드시트를 정교한 PDF로 변환할 수 있으며—페이지 나눔, 그리드 라인, 열 머리글을 보존—서버에 Microsoft Office를 설치할 필요가 없습니다. 이 튜토리얼은 환경 설정부터 렌더링 옵션 미세 조정까지 전체 과정을 안내하여 일관된 인쇄 준비 문서를 모든 클라이언트에 제공할 수 있도록 합니다.

소개

오늘날 데이터 기반 세계에서 효율적인 문서 관리는 업무를 간소화하려는 기업에 필수적입니다. 스프레드시트는 종종 다양한 플랫폼에서 일관된 읽기 전용 형식으로 공유되어야 하는 주요 데이터 소스 역할을 합니다. 페이지 나눔이 포함된 스프레드시트를 PDF로 렌더링하면 각 논리적 섹션이 새 페이지에서 시작되어 레이아웃 디자이너가 기대하는 배치를 유지합니다. 이 가이드는 GroupDocs.Viewer for Java를 사용하여 이를 달성하는 방법을 보여줍니다, 무거운 작업을 대신 처리해 주는 다재다능한 라이브러리입니다.

GroupDocs.Viewer for Java를 사용한 스프레드시트의 페이지 나눔

배우게 될 내용

  • 스프레드시트를 페이지별로 렌더링하여 Java에서 Excel을 PDF로 변환하는 방법.
  • 그리드 라인 및 머리글과 같은 스프레드시트 렌더링 옵션 구성.
  • GroupDocs.Viewer용 개발 환경 설정.
  • 페이지 나눔을 인식하는 PDF가 시간 절약과 오류 감소에 도움이 되는 실제 시나리오.

빠른 답변

  • 주요 라이브러리는 무엇입니까? GroupDocs.Viewer for Java.
  • 페이지 나눔으로 렌더링하는 메서드는? SpreadsheetOptions.forRenderingByPageBreaks().
  • PDF에 그리드 라인을 추가할 수 있나요? Yes—call setRenderGridLines(true).
  • 열 머리글을 포함하려면 어떻게 해야 하나요? Enable setRenderHeadings(true).
  • 프로덕션에 라이선스가 필요합니까? Yes, a valid GroupDocs license is required.

메서드 정의: SpreadsheetOptions.forRenderingByPageBreaks()는 스프레드시트 페이지 나눔을 존중하도록 렌더링을 구성합니다. setRenderGridLines(true)는 PDF에 그리드 라인을 활성화합니다. setRenderHeadings(true)는 각 페이지에 열 머리글을 포함합니다.

Java에서 Excel을 PDF로 변환이란 무엇인가요?

Excel 워크북(.xlsx)을 Java 코드에서 직접 PDF 문서로 변환하면 데이터를 안전하게 공유하고 정확한 서식을 보존하며 Microsoft Office에 의존하지 않고도 크로스 플랫폼 호환성을 보장할 수 있습니다. 변환은 서버에서 완전히 수행되어 원본 스프레드시트 레이아웃을 그대로 반영한 읽기 전용 PDF를 생성하며, 수동으로 삽입된 페이지 나눔도 포함됩니다.

왜 Java용 GroupDocs.Viewer를 사용하나요?

GroupDocs.Viewer는 70개 이상의 문서 형식을 지원합니다—Excel, Word, PowerPoint 및 50가지 이상의 이미지 형식 포함—고품질 PDF 렌더링을 제공합니다. 전체 파일을 메모리에 로드하지 않고 수백 페이지 워크북을 처리하여, 순진한 로딩 방식에 비해 피크 RAM 사용량을 최대 **80 %**까지 감소시킵니다. 이러한 기능은 맞춤 렌더링 로직의 필요성을 없애고 개발 주기를 크게 가속화합니다.

전제 조건

성공적으로 Java에서 Excel을 PDF로 변환을 구현하려면 다음을 확인하십시오:

필요한 라이브러리 및 종속성

GroupDocs.Viewer for Java Maven 아티팩트를 pom.xml에 추가하십시오:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-viewer</artifactId>
    <version>25.2</version>
</dependency>

<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 Development Kit (JDK) 8 또는 그 이상.
  • IntelliJ IDEA, Eclipse 또는 NetBeans와 같은 IDE.

지식 전제 조건

기본 Java 프로그래밍 및 Maven 프로젝트에 대한 친숙함이 도움이 됩니다. 이전 PDF 생성 경험은 선택 사항입니다.

Java용 GroupDocs.Viewer 설정

기본 초기화 및 설정

Viewer는 문서를 로드하고 다양한 출력 형식으로 렌더링하기 위해 준비합니다.
첫 번째로, Viewer 인스턴스를 생성하고 Excel 파일을 지정합니다. 다음 스니펫은 시작에 필요한 최소 코드를 보여줍니다:

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer("path/to/your/file.xlsx")) {
    // Your rendering logic will be implemented here.
}

정의 앵커: Viewer는 문서를 로드하고 다양한 출력 형식으로 렌더링하기 위해 준비하는 GroupDocs.Viewer의 핵심 클래스입니다.

라이선스 획득

기능 제한 없이 제품을 테스트하려면 GroupDocs에서 무료 체험 또는 임시 라이선스를 얻을 수 있습니다. 라이선스 키 획득에 대한 자세한 내용은 GroupDocs Free Trial 페이지를 방문하십시오.

GroupDocs.Viewer를 사용하여 Java에서 Excel을 PDF로 변환하는 방법

Excel 워크북을 로드하고 렌더링 옵션을 구성한 뒤, 세 단계만으로 출력 PDF를 작성합니다. 이 직접 답변 단락은 질문 형식 헤딩 요구 사항을 충족합니다: Viewer를 인스턴스화하고, 페이지 나눔 렌더링을 위해 구성된 SpreadsheetOptions와 함께 PdfViewOptions를 설정한 뒤 viewer.view()를 호출합니다.

PdfViewOptions는 PDF 출력 설정을 지정합니다. SpreadsheetOptions는 페이지 나눔, 그리드 라인 및 머리글을 포함한 스프레드시트 렌더링 방식을 구성합니다.

페이지 나눔에 따른 스프레드시트 렌더링

단계별 구현

  1. Viewer 및 옵션 초기화 – 입력 파일로 뷰어를 설정하고 출력 PDF 경로를 정의합니다:
Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path outputFilePath = outputDirectory.resolve("output.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/Page_Breaks.xlsx")) {
    PdfViewOptions viewOptions = new PdfViewOptions(outputFilePath);
  1. 스프레드시트 옵션 구성 – 페이지 나눔, 그리드 라인 및 머리글 렌더링을 활성화합니다:
    // Set SpreadsheetOptions for rendering by page breaks.
    viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingByPageBreaks());
    
    // Enable additional configurations like grid lines and headings.
    viewOptions.getSpreadsheetOptions().setRenderGridLines(true);
    viewOptions.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(viewOptions);
} catch (Exception e) {
    e.printStackTrace();
}
  1. 핵심 매개변수 설명
    • forRenderingByPageBreaks(): 각 PDF 페이지를 스프레드시트 페이지 나눔에 맞춥니다.
    • setRenderGridLines(true): 표 가독성을 높이기 위해 그리드 라인을 추가합니다.
    • setRenderHeadings(true): 인쇄된 모든 페이지에 열 레이블을 표시합니다.

문제 해결 팁

  • 워크북에 실제로 페이지 나눔이 포함되어 있는지 확인하십시오 (인쇄 레이아웃 → 페이지 나눔 미리 보기).
  • 입력 및 출력 파일 경로가 Java 프로세스에서 접근 가능하도록 하십시오.

스프레드시트 렌더링 옵션 구성

그리드 라인 및 머리글 사용자 정의

페이지 나눔을 넘어 PDF 외관을 세밀하게 조정할 수 있습니다. SpreadsheetOptions 객체는 시각 요소에 대한 세부 제어를 제공합니다.

import com.groupdocs.viewer.options.SpreadsheetOptions;

SpreadsheetOptions spreadsheetOptions = new SpreadsheetOptions();

// Enable grid lines and headings.
spreadsheetOptions.setRenderGridLines(true);
spreadsheetOptions.setRenderHeadings(true);
  • 그리드 라인: 특히 재무 데이터에 유용한 표의 시각적 구조를 유지합니다.
  • 머리글: 각 페이지에서 열 컨텍스트를 강화하여 수동 주석 필요성을 줄입니다.

일반적인 문제

그리드 라인이나 머리글이 누락된 경우, viewer.view()를 호출하기 전에 SpreadsheetOptions 인스턴스가 PdfViewOptions에 연결되어 있는지 다시 확인하십시오.

실제 적용 사례

다음은 Java에서 Excel을 PDF로 변환이 뛰어난 실제 시나리오입니다:

  1. 재무 보고 – 페이지 나눔을 존중하는 월간 Excel 보고서를 PDF로 변환하여 각 보고서가 새 페이지에서 시작하도록 합니다.
  2. 학술 출판 – 저널 제출을 위해 그리드 라인 및 머리글이 포함된 연구 데이터 테이블을 렌더링합니다.
  3. 재고 관리 – 원본 레이아웃을 유지하는 인쇄 가능한 재고 시트를 생성하여 현장 스캔을 용이하게 합니다.

성능 고려 사항

  • 리소스 사용 최적화: 200 MB보다 큰 워크북의 경우, JVM 힙(-Xms2g -Xmx4g)을 설정하여 메모리 부족 오류를 방지합니다.
  • 배치 처리 팁: 여러 파일에 대해 단일 Viewer 인스턴스를 재사용하면 초기화 오버헤드를 최대 **30 %**까지 줄일 수 있습니다.

자주 묻는 질문

Q: PDF에 그리드 라인을 추가하는 가장 쉬운 방법은 무엇인가요?
A: 렌더링 전에 viewOptions.getSpreadsheetOptions().setRenderGridLines(true)를 호출하십시오.

Q: 특정 워크시트만 렌더링할 수 있나요?
A: 예—특정 시트를 대상으로 하려면 SpreadsheetOptions.setWorksheetIndex(int index)를 사용하십시오.
setWorksheetIndex(int index)는 지정된 0 기반 인덱스의 워크시트를 렌더링하도록 선택합니다.

Q: GroupDocs.Viewer가 비밀번호로 보호된 Excel 파일을 지원하나요?
A: 물론입니다. Viewer 인스턴스를 생성할 때 비밀번호를 전달하십시오.

Q: PDF에 머리글이 표시되도록 하려면 어떻게 해야 하나요?
A: SpreadsheetOptions에서 setRenderHeadings(true)를 활성화하십시오.

Q: 프로덕션 사용에 라이선스가 필요합니까?
A: 예, 상업적 배포를 위해서는 유효한 GroupDocs 라이선스가 필요합니다.

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

관련 튜토리얼