배치로 특정 PDF 페이지 추출하기 - GroupDocs.Merger for Java

대용량 문서나 PDF 컬렉션에서 특정 PDF 페이지를 추출해야 한다면, 여기가 바로 정답입니다. 이 가이드에서는 페이지를 배치로 추출하고, 해당 페이지들로 새로운 PDF를 생성하며, 대용량 파일 상황을 효율적으로 처리하는 방법을 보여드립니다—모두 GroupDocs.Merger for Java를 사용한 몇 줄의 Java 코드만으로 가능합니다. 또한 이 라이브러리가 속도, 포맷 지원, 메모리 사용량 측면에서 많은 대안보다 뛰어난 이유도 확인할 수 있습니다.

빠른 답변

  • “batch extract PDF pages”가 무엇을 의미하나요? 하나 또는 여러 PDF에서 선택한 여러 페이지를 한 번에 추출하여 새 파일에 기록하는 것을 의미합니다.
  • 페이지 번호로 추출하는 메서드는 무엇인가요? ExtractOptions와 Merger.extractPages를 함께 사용합니다.
  • 라이선스가 필요합니까? 개발에는 무료 체험판으로 충분하며, 운영 환경에서는 유료 라이선스가 필요합니다.
  • 비연속 페이지도 추출할 수 있나요? 예—ExtractOptions 배열에 필요한 페이지 번호를 나열하면 됩니다.
  • 대용량 파일에도 적합한가요? 적절한 JVM 힙 설정을 사용하면 GroupDocs.Merger가 전체 문서를 메모리에 로드하지 않고도 기가바이트 규모의 PDF를 처리합니다.

배치 PDF 페이지 추출이란?

Batch extracting PDF pages는 연속이든 비연속이든 개별 페이지 집합을 선택하여 해당 페이지만 포함하는 새로운 PDF를 생성하는 것을 의미합니다. 이 기술은 전체 원본 문서를 공유하지 않고 맞춤 보고서, 법률 발췌본, 학습 가이드를 만들기에 이상적입니다.

Java용 GroupDocs.Merger를 사용하는 이유

GroupDocs.Merger는 50개 이상의 입력 및 출력 포맷(PDF, DOCX, PPTX, XLSX 및 일반 이미지 형식 포함)을 처리하며, 500페이지 파일의 경우 200 MB 미만의 힙 메모리만 사용하면서 수백 페이지 PDF도 다룰 수 있습니다. 고성능 API 덕분에 저수준 파일 처리 대신 비즈니스 로직에 집중할 수 있으며, 데스크톱, 서버, 클라우드 등 Java 호환 플랫폼 어디서든 실행됩니다.

사전 요구 사항

  • Java에 대한 기본 지식과 IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 의존성 관리를 위한 Maven 또는 Gradle.
  • GroupDocs.Merger 라이선스(무료 체험판 또는 임시 라이선스로 테스트 가능).

Java용 GroupDocs.Merger 설정

설치 안내

선호하는 빌드 도구를 사용하여 프로젝트에 라이브러리를 추가합니다.

Maven

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle

implementation 'com.groupdocs:groupdocs-merger:latest-version'

Direct Download
수동으로 진행하려면 최신 릴리스를 GroupDocs.Merger for Java releases에서 다운로드하십시오.

라이선스 획득

무료 체험판으로 시작하여 기능을 살펴보세요. 라이브러리가 요구에 맞다면 라이선스를 구매하거나 평가 기간 연장을 위해 임시 라이선스를 요청하십시오.

Merger는 문서를 로드하고 조작하는 데 사용되는 주요 클래스입니다.
의존성을 추가하고 라이선스를 획득한 후, 소스 문서를 가리키는 Merger 인스턴스를 생성합니다:

String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Merger merger = new Merger(filePath);

구현 가이드

페이지 번호별 추출 기능

extract pages by number 기능을 사용하면 소스 파일에서 정확히 어떤 페이지를 추출할지 지정할 수 있습니다.

Merger 초기화

Merger 클래스는 GroupDocs.Merger에서 모든 문서 수준 작업의 진입점입니다. 소스 파일을 가벼운 객체에 로드하여 필요 시 페이지를 스트리밍하므로 전체를 메모리에 로드하지 않습니다.

String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Merger merger = new Merger(filePath);

추출할 페이지 번호 정의

ExtractOptions는 추출 구성을 보관합니다. 원하는 1부터 시작하는 페이지 번호를 int[] 형태로 제공하면 API가 내부적으로 올바른 페이지 스트림에 매핑합니다.

ExtractOptions extractOptions = new ExtractOptions(new int[] { 1, 4 });

추출 수행

준비된 옵션으로 extractPages를 호출하면 요청된 페이지만 포함하는 새로운 Document 객체가 반환됩니다.
Document는 추출 후 결과 PDF 문서를 나타냅니다.

merger.extractPages(extractOptions);

추출된 페이지 저장

결과 문서는 지원되는 모든 형식으로 저장할 수 있습니다. 대부분 PDF로 저장하지만 필요에 따라 DOCX나 PNG로 출력할 수도 있습니다.

String filePathOut = "YOUR_OUTPUT_DIRECTORY/ExtractPagesByNumbers-output.pdf";
merger.save(filePathOut);

이것이 중요한 이유

선택된 페이지만으로 PDF를 생성하면 전체 문서를 전송할 필요가 없어 일반적인 사용 사례에서 다운로드 크기를 최대 90 %까지 줄일 수 있습니다. ExtractOptions를 사용하면 소스 파일을 반복적으로 로드하는 것을 방지해 수동 페이지별 처리에 비해 CPU 사용량을 약 30 % 감소시킵니다. 대용량 PDF 추출 상황에서는 JVM 힙(-Xmx2g 이상)을 늘려도 1 GB PDF에 대해 메모리 사용량을 300 MB 이하로 유지할 수 있습니다.

일반적인 함정 및 문제 해결

  • 잘못된 파일 경로 – 입력 및 출력 디렉터리가 존재하고 쓰기 권한이 있는지 확인하십시오.
  • 잘못된 페이지 번호 – 페이지 인덱스는 1부터 시작합니다; 문서 길이를 초과하는 페이지를 요청하면 PageNotFoundException이 발생합니다.
  • Out‑of‑Memory 오류 – 2 GB를 초과하는 PDF의 경우 힙을 더 할당(-Xmx4g)하거나 추출을 더 작은 배치로 나누십시오.

실용적인 적용 사례

  1. 문서 관리 시스템 – 대용량 PDF에서 필요한 섹션만 추출하여 맞춤 보고서를 생성합니다.
  2. 법률 및 금융 서비스 – 전체 파일을 공개하지 않고 특정 계약 조항이나 재무 보고서를 공유합니다.
  3. 교육 플랫폼 – 학생에게 챕터별 PDF만 제공하여 대역폭 및 저장소 요구량을 줄입니다.

성능 고려 사항

  • 메모리 관리: VisualVM과 같은 도구로 힙 사용량을 모니터링하고 파일 크기에 따라 -Xmx를 조정합니다.
  • 배치 처리: 수십 개 문서에서 페이지를 추출할 때는 10–20개씩 그룹화하여 CPU와 I/O를 균형 있게 유지합니다.
  • 효율적인 I/O: 특히 SSD 저장소에서 읽기/쓰기 속도를 높이기 위해 Java NIO 버퍼드 스트림을 사용합니다.

결론

이제 GroupDocs.Merger for Java를 사용하여 특정 PDF 페이지 추출 및 페이지로 PDF 생성을 위한 프로덕션 수준의 접근 방식을 갖추었습니다. 이 방법은 선택적 문서 공유, 맞춤 보고서 생성, 대용량 PDF 효율적 처리와 같은 워크플로를 간소화합니다. 문서 병합, 페이지 회전, 워터마크 적용 등 추가 기능을 탐색하여 애플리케이션의 문서 처리 능력을 더욱 확장해 보세요.

자주 묻는 질문

Q: GroupDocs.Merger가 지원하는 포맷은 무엇인가요?
A: PDF, DOCX, PPTX, XLSX, HTML 및 일반 이미지 형식을 포함한 50개 이상의 입력 및 출력 포맷을 처리하여 문서군 간 원활한 변환 및 추출을 가능하게 합니다.

Q: 비연속 페이지도 추출할 수 있나요?
A: 예—ExtractOptions 배열에 필요한 페이지 번호를 나열하면 라이브러리가 지정한 순서대로 가져옵니다.

Q: 추출할 수 있는 페이지 수에 제한이 있나요?
A: 명확한 제한은 없지만, 수천 페이지를 다중 기가바이트 PDF에서 추출하려면 추가 힙 메모리와 배치 처리가 필요할 수 있습니다.

Q: 추출 중 예외를 어떻게 처리해야 하나요?
A: 추출 로직을 try‑catch 블록으로 감싸고 예외 메시지를 로그에 기록하며, OutOfMemoryError가 발생하면 더 작은 배치 크기로 재시도할 수 있습니다.

Q: GroupDocs.Merger를 클라우드 네이티브 Java 애플리케이션에서 사용할 수 있나요?
A: 물론입니다—경량 API가 온프레미스 서버, Docker 컨테이너, AWS, Azure, Google Cloud와 같은 클라우드 플랫폼에서 네이티브 종속성 없이 동작합니다.

마지막 업데이트: 2026-06-21
테스트 대상: GroupDocs.Merger 23.11 (작성 시 최신)
작성자: GroupDocs

리소스

관련 튜토리얼