시트당 한 페이지: Java에서 GroupDocs.Conversion을 사용한 스프레드시트 PDF 변환 자동화

소개

스프레드시트를 수동으로 PDF로 변환하는 것이 지겹다면, 여기가 바로 맞는 곳입니다. 이 튜토리얼에서는 GroupDocs.Conversion for Java가 스프레드시트 변환을 자동화하고 세밀한 제어—예를 들어 필요한 행만 로드하고 시트당 한 페이지 PDF 출력을 생성하는 방법을 보여드립니다. 끝까지 읽으면 다음을 이해하게 됩니다:

  • 워크북을 로드할 때 셀 범위 지정하기
  • 변환기를 구성하여 각 시트를 단일 PDF 페이지로 만들기
  • 최신 GroupDocs.Conversion 라이브러리로 Java 프로젝트 설정하기

코드에 들어가기 전에 환경을 준비해 봅시다.

빠른 답변

  • “시트당 한 페이지”가 의미하는 바는? 원본 Excel 파일의 각 워크시트가 결과 PDF에서 단일 페이지로 렌더링됩니다.
  • 변환을 담당하는 라이브러리는? Java용 GroupDocs.Conversion (버전 25.2).
  • 라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있으며, 프로덕션에서는 임시 또는 구매한 라이선스가 필요합니다.
  • 대용량 스프레드시트를 효율적으로 변환할 수 있나요? 네—필요한 범위만 로드하면 메모리 사용량을 줄이고 처리 속도를 높일 수 있습니다.
  • 필요한 Java 버전은? JDK 8 이상.

“시트당 한 페이지”란?

Excel 워크북을 변환할 때 기본 동작은 각 워크시트마다 여러 PDF 페이지(인쇄 영역당 하나)를 생성할 수 있습니다. 시트당 한 페이지 옵션을 활성화하면 변환기가 전체 시트를 단일 PDF 페이지에 압축하도록 강제하며, 이는 보고서, 프레젠테이션 또는 페이지 수를 예측해야 할 때 이상적입니다.

Java용 GroupDocs.Conversion을 사용하는 이유

  • 견고한 포맷 지원 – XLS, XLSX, CSV 및 기타 많은 스프레드시트 형식을 지원합니다.
  • 고성능 – 로드 옵션을 사용하면 필요한 데이터만 대상으로 할 수 있어 대용량 파일에 적합합니다.
  • 간단한 API – 몇 줄의 Java 코드만으로 프로덕션 수준의 PDF를 만들 수 있습니다.
  • 크로스 플랫폼 – Java가 실행되는 어디서든 동작하며, 데스크톱 앱부터 클라우드 서비스까지 활용할 수 있습니다.

전제 조건

  • Java Development Kit (JDK) 8+ 설치
  • Maven – 의존성 관리용
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE
  • 기본 Java 지식 및 Maven 프로젝트 구조에 대한 이해

Java용 GroupDocs.Conversion 설정

Maven 구성

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

<repositories>
   <repository>
      <id>repository.groupdocs.com</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 웹사이트에서 라이선스를 구입합니다.

의존성을 추가한 후, API 사용을 시작할 수 있습니다:

import com.groupdocs.conversion.Converter;
// Basic initialization code here...

특정 범위로 스프레드시트 로드

범위를 로드하는 이유

필요한 행만 로드하면(예: 10‑30행) 변환 속도가 빨라지고 메모리 사용량이 감소합니다—특히 대용량 스프레드시트 PDF 파일을 변환할 때 유용합니다.

구현

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

public class FeatureLoadSpreadsheetWithRange {
    public static void run() {
        // Create load options for specifying a range of cells
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Specify the cell range (e.g., "10:30" means rows 10 to 30)
        loadOptions.setConvertRange("10:30");
    }
}

setConvertRange 메서드는 변환기에게 정의된 행 외의 모든 내용을 무시하도록 알려주어 java convert excel pdf 작업을 더 빠르고 가볍게 만듭니다.

시트당 한 페이지로 스프레드시트를 PDF로 변환

옵션 작동 방식

setOnePagePerSheet(true)를 설정하면 엔진이 원래 인쇄 영역과 관계없이 각 워크시트를 단일 PDF 페이지에 렌더링하도록 지시합니다. 이것이 시트당 한 페이지 요구사항의 핵심입니다.

구현

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

public class FeatureConvertToPdfWithOnePagePerSheet {
    public static void run() {
        // Initialize load options with one-page-per-sheet setting
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setOnePagePerSheet(true);
        
        // Initialize the Converter object with your document path and load options
        Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/sample.xlsx", () -> loadOptions);
        
        // Configure PDF conversion to produce one page per sheet
        PdfConvertOptions pdfOptions = new PdfConvertOptions();
        
        // Execute the conversion process
        converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertedSpreadsheet.pdf", pdfOptions);
    }
}

이제 sample.xlsx의 모든 워크시트가 ConvertedSpreadsheet.pdf에서 단일 페이지가 됩니다.

실용적인 적용 사례

시나리오기능이 도움이 되는 방식
재무 보고분기별 숫자가 포함된 행만 로드하고 부서별로 깔끔한 시트당 한 페이지 PDF를 생성합니다.
학술 출판연구 데이터 시트를 변환하고 관련 범위에 집중하여 각 시트가 자체 페이지에 인쇄되도록 하여 인용이 용이하도록 합니다.
비즈니스 프레젠테이션시트당 한 페이지 설정 덕분에 각 슬라이드가 워크시트에 대응하는 프레젠테이션용 PDF를 생성합니다.

성능 고려 사항

  • 변환 범위 좁히기 – setConvertRange를 사용하여 행/열을 제한합니다.
  • 리소스 해제 – 스트림을 닫고 변환 후 Converter가 범위 밖으로 벗어나도록 합니다.
  • 병렬 처리 – 배치 작업의 경우 별도 스레드에서 변환을 실행하여 UI 응답성을 유지합니다.

자주 묻는 질문

Q: GroupDocs.Conversion에 필요한 최소 Java 버전은 무엇인가요?
A: 호환성을 보장하기 위해 JDK 8 이상을 권장합니다.

Q: 여러 스프레드시트 형식을 한 번에 변환할 수 있나요?
A: 네, GroupDocs.Conversion은 Excel, CSV 및 기타 많은 형식을 지원합니다.

Q: 전체 기능 접근을 위한 임시 라이선스는 어떻게 얻나요?
A: GroupDocs 웹사이트를 통해 요청합니다.

Q: 스프레드시트가 메모리에서 변환하기에 너무 큰 경우는 어떻게 해야 하나요?
A: setConvertRange로 필요한 범위만 로드하고 변환 중에 파일을 디스크로 스트리밍하는 것을 고려합니다.

Q: GroupDocs.Conversion을 클라우드 스토리지 서비스와 통합할 수 있나요?
A: 네, 표준 Java I/O 스트림을 사용하여 AWS S3, Azure Blob Storage, Google Cloud Storage 등과 읽고 쓸 수 있습니다.

리소스

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