Excel을 PDF로 변환 – 시트당 한 페이지 (GroupDocs Java 사용)

오늘날 데이터 중심 환경에서 Excel 워크북을 PDF로 변환하면서 각 워크시트를 별도의 페이지—시트당 한 페이지—에 유지하는 것은 흔한 요구사항입니다. 스프레드시트 보고서에서 PDF를 생성하거나, 읽기 전용 버전을 공유하거나, 데이터를 보관할 때 레이아웃과 그리드 라인을 보존하는 것이 중요합니다. 이 튜토리얼에서는 GroupDocs.Conversion for Java를 사용하여 시트당 한 페이지 옵션으로 Excel 파일을 PDF로 변환하는 방법과 그리드 라인 표시 및 기타 유용한 설정 방법을 안내합니다.

빠른 답변

“시트당 한 페이지”가 의미하는 것은? 각 워크시트가 별도의 PDF 페이지로 렌더링됩니다.
PDF에 그리드 라인을 표시할 수 있나요? 예, 로드 옵션에서 setShowGridLines(true)를 활성화하면 됩니다.
어떤 라이브러리가 변환을 담당하나요? GroupDocs.Conversion for Java.
라이선스가 필요합니까? 테스트용 무료 체험판을 사용할 수 있으며, 프로덕션에서는 유료 라이선스가 필요합니다.
배치 변환이 가능한가요? 예, 동일한 API를 사용해 여러 파일을 반복 처리할 수 있습니다.

“시트당 한 페이지” 변환이란?

시트당 한 페이지 설정은 변환기가 Excel 워크북의 각 워크시트를 결과 PDF의 개별 페이지로 취급하도록 지시합니다. 이렇게 하면 원본 워크북 구조가 그대로 유지되어 독자가 탐색하기 쉬워집니다.

왜 GroupDocs.Conversion for Java를 사용해 스프레드시트에서 PDF를 생성하나요?

고품질 – 서식, 수식 및 스타일을 그대로 유지합니다.
성능 – 대용량 워크북 및 배치 처리에 최적화되었습니다.
유연성 – 그리드 라인 표시, 페이지 방향 설정 등 다양한 옵션을 지원합니다.
크로스‑플랫폼 – Java 호환 환경 어디서든 작동합니다.

사전 요구 사항

Java Development Kit (JDK) 8 이상.
GroupDocs.Conversion for Java 라이브러리 (Maven을 통해 추가합니다).
IntelliJ IDEA 또는 Eclipse와 같은 IDE.
Maven 의존성 관리에 대한 기본 지식(있으면 좋지만 필수는 아님).

GroupDocs.Conversion for Java 설정

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

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

라이선스

GroupDocs는 무료 체험판과 여러 라이선스 등급을 제공합니다. 평가용 임시 라이선스를 받거나 프로덕션 사용을 위한 정식 라이선스를 구매하세요.

초기화 및 설정

의존성을 추가한 후 라이브러리가 정상적으로 로드되는지 확인할 수 있습니다:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        System.out.println("GroupDocs Conversion for Java Initialized.");
    }
}

스프레드시트 문서 로드 옵션

“시트당 한 페이지”와 그리드 라인 표시 설정 방법

SpreadsheetLoadOptions 클래스를 사용하면 변환 전에 워크북 해석 방식을 세밀하게 조정할 수 있습니다.

import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class LoadSpreadsheetWithOptions {
    public static void run() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Show grid lines in the converted document
        loadOptions.setShowGridLines(true);
        
        // Ensure each sheet is on a separate page
        loadOptions.setOnePagePerSheet(true);
    }
}

setShowGridLines(true) – PDF에 그리드 라인 스타일을 유지합니다.
setOnePagePerSheet(true) – 기본 시트당 한 페이지 동작을 활성화합니다.

스프레드시트를 PDF로 변환

단계별 변환 코드

로드 옵션을 구성한 뒤 변환 과정은 매우 간단합니다:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertSpreadsheetToPdf {
    public static void run(String inputFilePath, String outputFilePath) {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setShowGridLines(true);
        loadOptions.setOnePagePerSheet(true);
        
        Converter converter = new Converter(inputFilePath, () -> loadOptions);
        PdfConvertOptions options = new PdfConvertOptions();
        
        converter.convert(outputFilePath, options);
    }
}

Converter 가 전체 변환 파이프라인을 처리합니다.
PdfConvertOptions 를 통해 PDF 전용 설정(압축, 이미지 품질 등)을 지정할 수 있습니다.

Excel PDF Java 배치 변환

여러 워크북을 처리하려면 파일 경로 컬렉션을 순회하면서 ConvertSpreadsheetToPdf.run()을 각 파일에 대해 호출하면 됩니다. 이 방식은 최소한의 코드 변경으로 배치 Excel PDF 변환 시나리오를 지원합니다.

실용적인 활용 사례

자동 보고서 생성 – 월간 재무 Excel 파일을 PDF로 변환해 배포합니다.
팀 협업 – 그리드 라인을 유지한 읽기 전용 PDF를 공유해 모든 사용자가 동일한 레이아웃을 확인하도록 합니다.
장기 보관 – 스프레드시트를 PDF로 저장해 실수로 인한 편집을 방지하고 시각적 충실도를 유지합니다.

성능 고려 사항

메모리 관리 – 대용량 워크북을 변환할 때 충분한 힙 공간을 할당합니다.
배치 처리 – GroupDocs.Conversion은 여러 파일을 병렬로 처리할 수 있으니 CPU 사용량을 모니터링하세요.
로드 옵션 튜닝 – 불필요한 기능(예: 수식) 비활성화는 처리 시간을 단축시킬 수 있습니다.

일반적인 문제와 해결책

문제	해결책
대용량 파일에서 Out‑OfMemoryError 발생	JVM 힙을 (`-Xmx2g` 이상) 늘리고 시트를 개별적으로 변환하는 방안을 고려합니다.
그리드 라인이 표시되지 않음	`loadOptions.setShowGridLines(true)`를 `Converter` 생성 전에 호출했는지 확인합니다.
모든 시트가 한 페이지에 합쳐짐	`loadOptions.setOnePagePerSheet(true)`가 설정되었는지 확인합니다; 오래된 라이브러리 버전에서는 다른 속성을 사용해야 할 수 있습니다.

자주 묻는 질문

Q: convert excel pdf java와 excel pdf conversion java의 차이는 무엇인가요?
A: 두 표현 모두 동일한 프로세스를 의미합니다—Java를 사용해 Excel 워크북을 PDF 파일로 변환하는 것. 표현만 다를 뿐 API 호출은 동일합니다.

Q: PDF 페이지 크기나 방향을 커스터마이즈할 수 있나요?
A: 예, PdfConvertOptions에서 setPageSize() 및 setPageOrientation() 같은 메서드를 사용해 출력물을 조정할 수 있습니다.

Q: 그리드 라인을 숨기면서도 시트당 한 페이지 레이아웃은 유지할 수 있나요?
A: 가능합니다. loadOptions.setShowGridLines(false)로 설정하고 setOnePagePerSheet(true)는 그대로 유지합니다.

Q: 비밀번호로 보호된 Excel 파일을 어떻게 처리하나요?
A: 자격 증명을 포함한 LoadOptions를 인수로 받는 Converter 생성자 오버로드를 사용해 비밀번호를 전달합니다.

Q: GroupDocs가 CSV, ODS 등 다른 스프레드시트 형식을 지원하나요?
A: 예, 라이브러리는 다양한 스프레드시트 형식을 로드하고 PDF로 변환할 수 있습니다.

리소스

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