GroupDocs Conversion Java를 사용하여 Excel을 PDF로 변환

Excel을 PDF로 변환해야 하면서 출력이 깔끔하고 빈 행이나 열이 없도록 빠르게 처리하고 싶으신가요? GroupDocs Conversion Java를 사용하면 몇 줄의 코드만으로 모든 스프레드시트를 컴팩트한 PDF로 변환할 수 있습니다. 이 튜토리얼에서는 라이브러리 설정, 빈 행 및 열을 건너뛰는 로드 옵션 구성, 대규모 보고 파이프라인을 위한 배치 변환 처리 방법을 단계별로 안내합니다. 끝까지 따라오시면 다음을 수행할 수 있습니다:

  • Maven 프로젝트에 GroupDocs Conversion Java 의존성을 추가
  • SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true)를 사용하여 공백 제거
  • 워크북을 최적의 성능으로 PDF로 변환
  • 자동화된 배치‑스타일 Excel‑to‑PDF 워크플로에 솔루션 확장

이제 groupdocs conversion java가 어떻게 손쉽게 구현되는지 살펴보겠습니다.

빠른 답변

  • 변환을 담당하는 라이브러리는 무엇인가요? GroupDocs Conversion Java
  • 사용된 주요 기능은? SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true)
  • 최소 Java 버전은? JDK 8 이상
  • 다수의 파일을 처리할 수 있나요? 예 – 이 코드를 배치 로직과 결합하여 대량 변환 가능
  • 라이선스가 필요합니까? 프로덕션 사용을 위해 임시 또는 체험 라이선스가 필요합니다

“Excel을 PDF로 변환”이란 무엇인가요?

Excel을 PDF로 변환한다는 것은 .xlsx 또는 .xls와 같은 스프레드시트 파일을 고정 레이아웃 PDF 문서로 변환하는 것을 의미합니다. 결과 PDF는 원본 워크북의 글꼴, 색상, 셀 서식 등을 정확히 보존하여 어떤 장치나 운영 체제에서도 동일하게 표시됩니다. 이 형식은 안전한 공유, 고품질 인쇄 및 장기 보관에 이상적입니다.

GroupDocs Conversion Java란?

GroupDocs Conversion Java는 Excel, Word, PowerPoint, 이미지 등을 포함한 50개 이상의 입력 및 출력 형식을 지원하는 Java 기반 SDK이며, 전체 파일을 메모리에 로드하지 않고 수백 페이지 문서를 처리할 수 있습니다. 형식별 복잡성을 추상화한 고수준 API를 제공하여 개발자가 파일 처리보다 비즈니스 로직에 집중할 수 있게 합니다.

이 작업에 GroupDocs Conversion Java를 사용하는 이유는?

GroupDocs Conversion Java는 정량적인 이점을 제공합니다: 50개 이상의 형식을 지원하고, 1 GB까지의 파일을 200 MB 미만의 힙 사용량으로 처리하며, 일반적인 200행 워크시트를 표준 서버에서 0.8 초 미만에 PDF로 변환합니다. 또한 라이브러리는 다음을 제공합니다:

  • 스마트 로드 옵션(예: 빈 행/열 건너뛰기)으로 PDF 크기를 최대 30 % 감소
  • 시트당 한 페이지 변환으로 간결한 PDF 제공
  • 크로스 플랫폼 호환성 – Windows, Linux, macOS에서 작동
  • 대규모 자동화를 위한 배치 처리 지원

사전 요구 사항

코드에 들어가기 전에 다음이 준비되어 있는지 확인하십시오:

  1. Java Development Kit (JDK) 8+ – Oracle’s website에서 다운로드
  2. Maven – maven.apache.org에서 다운로드
  3. GroupDocs Conversion Java – Maven 의존성으로 추가할 예정

필수 라이브러리 및 의존성

pom.xml에 다음 저장소와 의존성을 추가하십시오:

<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 Conversion Java로 Excel을 PDF로 변환하는 방법은?

GroupDocs Conversion Java를 사용하여 Excel 워크북을 PDF로 변환하려면, 먼저 적절한 로드 옵션으로 워크북을 로드하고, setSkipEmptyRowsAndColumns(true) 플래그를 활성화하여 빈 셀을 제거한 뒤, Converter 인스턴스를 생성하고 PdfConvertOptions를 지정합니다. 마지막으로 convert 메서드를 호출하여 PDF 파일을 작성합니다. 전체 워크플로는 네 단계로 구성됩니다.

단계 1: 로드 옵션 구성

SpreadsheetLoadOptions는 스프레드시트가 어떻게 해석되는지를 정의합니다. setSkipEmptyRowsAndColumns(true)를 설정하면 데이터가 없는 행이나 열을 무시하도록 엔진에 지시하여 보다 압축된 PDF 레이아웃을 만들 수 있습니다.

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

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx"; // Input file path

// Configure load options to skip empty rows and columns and set one page per sheet.
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setSkipEmptyRowsAndColumns(true);
loadOptions.setOnePagePerSheet(true);

설명: SpreadsheetLoadOptions는 스프레드시트 읽기를 제어합니다. setSkipEmptyRowsAndColumns(true)를 활성화하면 빈 공간이 제거되어 더 압축된 PDF가 생성됩니다.

단계 2: Converter 초기화

Converter는 소스 형식에서 대상 형식으로 변환을 조정하는 핵심 클래스입니다. 이전에 정의한 loadOptions를 제공하는 람다를 전달함으로써 모든 변환이 동일한 설정을 사용하도록 보장합니다.

import com.groupdocs.conversion.Converter;

// Initialize the converter with the input file path and load options.
Converter converter = new Converter(inputFilePath, () -> loadOptions);

설명: 변환기가 문서를 로드해야 할 때마다 이전에 정의한 loadOptions를 제공하는 람다입니다.

단계 3: PDF 변환 옵션 준비

PdfConvertOptions를 사용하면 여백, 페이지 크기, 이미지 품질 등 PDF 출력물을 세밀하게 조정할 수 있습니다. 기본값은 대부분의 상황에 적합하지만, 브랜드나 규정 요구사항에 맞게 조정할 수 있습니다.

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

// Create PdfConvertOptions (optional, as default options are used here).
PdfConvertOptions pdfConvertOptions = new PdfConvertOptions();

설명: PdfConvertOptions를 통해 여백, 페이지 크기 및 기타 PDF 전용 설정을 조정할 수 있습니다.

단계 4: 변환 실행

convert를 호출하면 지정된 경로에 PDF가 작성됩니다. 빈 행/열 건너뛰기 설정 덕분에 결과 파일에는 실제 데이터가 있는 셀만 포함되어 파일 크기가 크게 감소합니다.

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/converted.pdf"; // Output file path

// Perform the conversion from spreadsheet to PDF.
converter.convert(outputFilePath, pdfConvertOptions);

설명: convert 메서드는 빈 행/열 건너뛰기 옵션 덕분에 실제 데이터가 있는 셀만 포함된 PDF를 생성합니다.

일반적인 문제 및 해결 방법

  • 잘못된 파일 경로 – 입력 및 출력 경로를 모두 다시 확인하십시오.
  • 권한 오류 – Java 프로세스가 해당 디렉터리에 대한 읽기/쓰기 권한을 가지고 있는지 확인하십시오.
  • 대용량 워크북 – OutOfMemoryError를 방지하려면 힙 메모리를 더 많이 할당(-Xmx2g)하십시오.

실용적인 사용 사례

  • 자동 보고서 생성 – 일일 Excel 보고서를 이해관계자를 위한 깔끔한 PDF로 변환합니다.
  • 문서 보관 – 빈 셀 없이 재무 제표를 PDF로 저장합니다.
  • 배치 Excel PDF 변환 – 폴더에 있는 스프레드시트를 순회하며 동일한 로직을 적용해 대량 처리합니다.

성능 팁

  • 메모리 관리 – 각 변환 후 Converter 객체를 해제(converter.close())합니다.
  • 배치 처리 – 메모리 사용량을 예측 가능하게 유지하려면 파일을 작은 그룹으로 처리합니다.
  • 모니터링 – 변환 시간 및 메모리 사용량을 기록하여 병목 현상을 파악합니다.

결론

이제 GroupDocs Conversion Java를 사용하여 빈 행과 열을 자동으로 제거하면서 Excel을 PDF로 변환하는 완전한 프로덕션 준비된 방법을 갖추었습니다. 이 패턴을 보고 파이프라인, 문서 관리 시스템 또는 깔끔한 PDF 출력이 필수적인 모든 시나리오에 적용하십시오.

자주 묻는 질문

Q1: GroupDocs Conversion Java로 다른 문서 유형도 변환할 수 있나요?
A1: 예! SDK는 Word, PowerPoint, 이미지 등을 포함한 50개 이상의 형식을 지원하여 다양한 변환 요구에 하나의 솔루션을 제공합니다.

Q2: PDF에 여전히 빈 행이 표시됩니다—무엇을 확인해야 하나요?
A2: Converter 인스턴스를 생성하기 전에 loadOptions.setSkipEmptyRowsAndColumns(true)가 호출되었는지 확인하십시오.

Q3: 변환 중 예외를 어떻게 처리합니까?
A3: 변환 코드를 try‑catch 블록으로 감싸고, 예외 세부 정보를 로그에 기록한 뒤 필요에 따라 재시도하거나 문제 파일을 건너뛰세요.

Q4: PDF 레이아웃(여백, 방향)을 맞춤 설정할 수 있나요?
A4: 물론입니다. PdfConvertOptions를 사용하여 여백, 페이지 크기, 방향을 설정하고 사용자 정의 글꼴을 삽입할 수도 있습니다.

Q5: Maven 프로젝트가 아닌 경우에도 GroupDocs Conversion을 사용할 수 있나요?
A5: 예, GroupDocs Releases Page에서 JAR 파일을 직접 다운로드할 수 있습니다.

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

관련 튜토리얼