시트당 한 페이지: Excel 숨김 시트를 PDF로 변환 (Java)

Excel 워크북을 PDF로 변환하면서 모든 시트(숨겨진 시트 포함)를 보존하는 것은 어려울 수 있습니다. 이 튜토리얼에서는 GroupDocs.Conversion for Java를 사용한 시트당 한 페이지 변환 방법을 배워 데이터가 누락되지 않도록 합니다. 설정, 구성, 필요한 정확한 코드와 이 접근 방식이 빛을 발하는 실제 시나리오를 단계별로 안내합니다.

빠른 답변

숨김 시트를 포함할 수 있나요? 예—setShowHiddenSheets(true) 설정.
몇 개의 PDF 페이지가 생성되나요? setOnePagePerSheet(true)를 사용하면 시트당 한 페이지가 생성됩니다.
필요한 Java 버전은? JDK 8 이상.
라이선스가 필요합니까? 테스트용 무료 체험이 가능하며, 운영 환경에서는 상용 라이선스가 필요합니다.
Maven이 유일한 빌드 도구인가요? 예제는 Maven을 사용하지만 Gradle도 동일하게 사용할 수 있습니다.

“시트당 한 페이지”란 무엇인가요?

시트당 한 페이지 옵션은 변환기가 Excel 파일의 각 워크시트를 별개의 PDF 페이지에 렌더링하도록 지시합니다. 이 레이아웃은 보고서, 감사 및 원본 워크북을 페이지별로 명확히 확인해야 하는 모든 상황에 이상적입니다.

왜 GroupDocs.Conversion for Java를 사용하나요?

전체 제어: 숨김 콘텐츠, 페이지 레이아웃 및 출력 형식에 대한 완전한 제어.
크로스‑플랫폼: Windows, Linux, macOS와 호환.
외부 Office 설치 불필요: 순수 Java 라이브러리.
강력한 라이선스 옵션: 체험, 임시 또는 영구 사용 가능.

전제 조건

Java Development Kit (JDK) 8+
Maven (의존성 관리용)
GroupDocs.Conversion for Java (버전 25.2 이상)
Java 및 Maven에 대한 기본 지식

GroupDocs.Conversion for Java 설정

pom.xml에 GroupDocs 저장소와 의존성을 추가합니다. 이 단계는 Maven이 필요한 라이브러리를 다운로드할 수 있게 합니다.

<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>

라이선스 획득

API를 평가하려면 무료 체험으로 시작하세요. 운영 환경에서는 라이선스가 필요합니다—공식 스토어에서 구입하세요:

GroupDocs 구매

구현 가이드

아래는 숨김 시트를 포함한 Excel 파일을 각 시트가 별도 페이지에 표시되는 PDF로 변환하는 완전하고 실행 가능한 Java 코드입니다.

단계 1: 소스 문서 경로 정의

숨김 워크시트가 포함된 Excel 워크북을 변환기에 지정합니다.

String sourceDocumentPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_HIDDEN_SHEET";

단계 2: 로드 옵션 구성

숨김 시트 처리와 시트당 한 페이지 레이아웃을 활성화합니다.

SpreadsheetsLoadOptions loadOptions = new SpreadsheetsLoadOptions();
loadOptions.setShowHiddenSheets(true); // Include hidden sheets
loadOptions.setOnePagePerSheet(true);   // One page per sheet in PDF output

단계 3: 변환기 초기화

소스 경로와 로드 옵션을 사용해 Converter 인스턴스를 생성합니다.

Converter converter = new Converter(sourceDocumentPath, () -> loadOptions);

단계 4: 변환 옵션 설정

PDF 변환 구성을 준비합니다.

PdfConvertOptions convertOptions = new PdfConvertOptions();

단계 5: 변환 수행

변환을 실행하고 PDF를 원하는 위치에 기록합니다.

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/ConvertSpreadsheetWithHiddenSheetsIncluded.pdf";
converter.convert(outputFilePath, convertOptions);

주요 구성 요약

setShowHiddenSheets(true): 숨김 워크시트를 변환기에 표시합니다.
setOnePagePerSheet(true): 각 워크시트마다 별도의 PDF 페이지를 보장합니다.

문제 해결 팁

파일을 찾을 수 없음 오류: 제공한 절대 경로나 상대 경로를 다시 확인하세요.
의존성 충돌: Maven 좌표가 설치한 버전과 일치하는지 확인하세요.
대용량 워크북 메모리 문제: OutOfMemoryError가 발생하면 JVM 힙 크기(-Xmx)를 늘리세요.

실용적인 적용 사례

재무 보고: 숨김 계산 시트를 포함한 전체 워크북을 PDF로 내보내 감사 기록을 남깁니다.
데이터 감사: 스프레드시트를 보관할 때 모든 숨김 데이터 세트를 보존합니다.
프로젝트 문서화: 이해관계자 검토를 위해 원본 Excel 레이아웃을 그대로 반영한 깔끔한 페이지별 PDF를 생성합니다.

성능 고려 사항

대용량 워크북: 병목을 피하려면 시트를 배치로 처리하거나 힙 메모리를 늘리세요.
스트리밍 출력: 웹 서비스에서 실시간 생성을 위해 converter.convert(OutputStream, convertOptions)를 사용합니다.
리소스 정리: 변환 후 converter.close()를 호출해 네이티브 리소스를 해제합니다.

결론

이제 GroupDocs.Conversion for Java를 사용해 숨김 시트를 포함한 Excel 워크북을 시트당 한 페이지로 변환하는 방법을 마스터했습니다. 이 기술은 모든 데이터가 최종 PDF에 포함되도록 보장하여 보고서, 감사 및 문서화에 대한 신뢰를 제공합니다.

다음 단계

추가 PdfConvertOptions(예: 이미지 압축, PDF/A 준수) 실험하기.
이 변환 흐름을 더 큰 Java 서비스나 Spring Boot 애플리케이션에 통합하기.
유사한 숨김 콘텐츠 처리와 함께 다른 형식(Word, PowerPoint) 탐색하기.

FAQ 섹션

숨김 시트를 변환하는 이점은 무엇인가요?
- 중요한 세부 정보를 놓치지 않고 포괄적인 문서를 보장합니다.
GroupDocs.Conversion으로 다른 파일 형식을 변환할 수 있나요?
- 예, Excel 및 PDF 외에도 다양한 형식을 지원합니다.
변환 오류를 어떻게 해결하나요?
- 파일 경로를 확인하고 Maven 의존성 버전을 확인한 뒤, 오류 코드에 대한 공식 문서를 참고하세요.
변환 가능한 시트 수에 제한이 있나요?
- 일반적으로 제한은 없지만, 매우 큰 워크북은 더 많은 메모리가 필요할 수 있습니다.
GroupDocs.Conversion은 대용량 Excel 파일을 어떻게 처리하나요?
- 효율적인 스트리밍 및 메모리 관리 기법을 사용하며, JVM 설정을 추가로 조정할 수 있습니다.

리소스

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