Java에서 특정 페이지 추출 - GroupDocs.Merger for Java

이 튜토리얼에서는 GroupDocs.Merger for Java를 사용하여 지원되는 모든 문서 유형—Word, PDF, PowerPoint, Excel 등—에서 특정 페이지를 추출 (java) 하는 방법을 배웁니다. 범위 기반 추출이 왜 중요한지, 짝수 페이지를 어떻게 선택하는지, 그리고 이 솔루션을 표준 Java 프로젝트에 어떻게 통합하는지 확인할 수 있습니다.

빠른 답변

  • “특정 페이지 추출”이란 무엇인가요? 큰 문서에서 필요한 페이지만 선택하여 새 파일로 저장하는 것을 의미합니다.
  • 지원되는 형식은 무엇인가요? Word, PDF, PowerPoint, Excel, HTML, 이미지 및 30개 이상의 기타 형식.
  • 짝수 페이지만 추출할 수 있나요? 예—추출 옵션에서 RangeMode.EvenPages를 설정하면 됩니다.
  • 라이선스가 필요합니까? 무료 체험으로 테스트할 수 있으며, 실제 사용을 위해서는 정식 라이선스가 필요합니다.
  • 코드 라인은 몇 줄인가요? 사용자 정의 범위를 추출하는 데 20줄 미만이면 충분합니다.

Java에서 특정 페이지 추출이란?

Java에서 특정 페이지 추출은 소스 문서에서 페이지의 일부를 프로그래밍 방식으로 추출하여 새롭고 독립적인 파일을 만드는 작업을 의미합니다. 이 기술은 계약 조항, 단일 장, 또는 여러 청구서와 같이 필요한 부분만 필요할 때 전체 문서를 전송하는 부담을 줄이는 데 필수적입니다.

왜 범위별로 특정 페이지를 추출해야 할까요?

범위별로 특정 페이지를 추출하면 파일 크기가 감소하고 민감한 섹션을 보호하며 전자 서명, 자동 보고, 배치 인덱싱 등 하위 프로세스의 속도를 높일 수 있습니다. GroupDocs.Merger를 사용하면 단일 API 호출로 페이지 1‑5, 모든 짝수 페이지 또는 임의의 페이지 목록을 요청할 수 있어 수동 편집을 없애고 개발 시간을 절약합니다.

사전 요구 사항

  • GroupDocs.Merger for Java를 Maven 또는 Gradle 의존성으로 추가합니다.
  • JDK 8 이상이 개발 머신에 설치되고 구성되어 있어야 합니다.
  • Java 파일 I/O 및 예외 처리에 대한 기본적인 이해가 필요합니다.

GroupDocs.Merger for Java 설정

Maven 설정

pom.xml에 다음 의존성을 추가합니다:

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

Gradle 설정

build.gradle 파일에 다음 라인을 추가합니다:

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

직접 다운로드

또한 최신 바이너리를 GroupDocs.Merger for Java releases에서 다운로드할 수 있습니다.

라이선스 획득 단계

  1. 무료 체험 – API를 체험하기 위해 트라이얼을 다운로드합니다.
  2. 임시 라이선스 – 장기 테스트를 위해 임시 키를 요청합니다.
  3. 구매 – 실제 사용을 위한 정식 라이선스를 구매합니다.

기본 초기화 및 설정

다음은 Merger 인스턴스를 생성하기 위해 필요한 최소 코드입니다. Merger 클래스는 문서를 로드하고 추출 작업을 제공하는 핵심 API 객체입니다.

import com.groupdocs.merger.Merger;

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

범위별 특정 페이지 추출 방법

소스 문서를 로드하고, 추출 옵션을 구성한 뒤 결과를 저장합니다—세 단계만으로 간단히 수행합니다.

단계 1: 입력 및 출력 경로 정의

소스 문서와 대상 파일의 전체 파일 시스템 경로를 지정합니다.

String filePath = "YOUR_DOCUMENT_DIRECTORY/YourDocument.docx";
String filePathOut = "YOUR_OUTPUT_DIRECTORY/ExtractedPages.docx";

단계 2: 추출 옵션 구성

ExtractOptions를 사용하면 시작 페이지, 종료 페이지 및 RangeMode(짝수, 홀수 또는 사용자 정의)를 설정할 수 있습니다. 아래 예제는 1 ~ 3 페이지 중 짝수 페이지만 추출하므로 페이지 2가 저장됩니다.

import com.groupdocs.merger.domain.options.ExtractOptions;
import com.groupdocs.merger.domain.options.RangeMode;

// Extract options configured for even pages from page 1 to 3
ExtractOptions extractOptions = new ExtractOptions(1, 3, RangeMode.EvenPages);

단계 3: 추출 수행 및 결과 저장

Merger 인스턴스에서 extract 메서드를 호출하고 새 문서를 디스크에 기록합니다.

// Initialize Merger with input document path
Merger merger = new Merger(filePath);

// Perform extraction based on defined options
merger.extractPages(extractOptions);

// Save the extracted pages to a new file
merger.save(filePathOut);

프로 팁: 추출 로직을 try‑catch 블록으로 감싸 IOException 또는 형식별 예외를 우아하게 처리하세요.

실용적인 적용 사례

시나리오추출이 도움이 되는 방법
법률 검토필요한 조항만 추출하여 빠르게 분석하고, 기밀 섹션은 숨깁니다.
학술 연구교과서에서 장이나 섹션을 분리하여 인용하거나 오프라인으로 읽을 수 있습니다.
재무 보고다중 페이지 보고서에서 표나 명세서를 추출하여 이메일 배포 시 파일 크기를 줄입니다.

성능 고려 사항

  • 메모리 관리 – 대용량 PDF는 힙 메모리를 많이 차지할 수 있습니다. OutOfMemoryError가 발생하면 JVM 힙(-Xmx2g)을 늘리세요.
  • 파일 I/O – 대용량 파일을 읽고 쓸 때는 버퍼드 스트림을 사용하여 디스크 지연을 줄이세요.
  • 배치 처리 – 다수의 문서에서 범위를 추출할 때는 순차적으로 처리하거나, 제한된 동시성을 가진 스레드 풀을 사용해 시스템 자원 고갈을 방지하세요.

일반적인 문제와 해결책

문제해결책
잘못된 파일 경로전체 경로를 확인하고 애플리케이션에 읽기/쓰기 권한이 있는지 확인하세요.
지원되지 않는 형식문서 유형(DOCX, PDF 등)이 지원되는 형식 목록에 포함되어 있는지 확인하세요.
메모리 부족 오류대용량 파일을 작은 청크로 처리하거나 JVM 힙 크기(-Xmx)를 늘리세요.
RangeMode가 예상대로 동작하지 않음시작/종료 값을 다시 확인하고 문서 페이지 수 범위 내에 있는지 확인하세요.

자주 묻는 질문

Q: 홀수 페이지를 추출하려면 어떻게 해야 하나요?
A: ExtractOptions를 생성할 때 RangeMode.OddPages를 사용합니다.

Q: PDF에서도 사용할 수 있나요?
A: 예—GroupDocs.Merger는 PDF, DOCX, PPTX, XLSX 등 다양한 형식을 지원합니다.

Q: 문서 경로가 잘못된 경우 어떻게 되나요?
A: API가 IOException을 발생시킵니다. 경로를 확인하고 파일 권한을 점검하세요.

Q: 추출 중 예외를 어떻게 처리해야 하나요?
A: 추출 코드를 try‑catch 블록으로 감싸고, 문제 해결을 위해 예외 세부 정보를 로그에 기록하세요.

Q: 추출할 수 있는 페이지 수에 제한이 있나요?
A: 명확한 제한은 없지만, 매우 큰 범위를 추출할 경우 추가 힙 메모리가 필요할 수 있습니다.

리소스

이 가이드를 따라 하면 GroupDocs.Merger for Java를 사용하여 지원되는 모든 문서에서 특정 페이지를 추출 (java) 할 수 있는 신뢰할 수 있는 방법을 얻게 됩니다. 코딩을 즐기세요!

마지막 업데이트: 2026-08-15
테스트 환경: GroupDocs.Merger 최신 버전 (Java)
작성자: GroupDocs

관련 튜토리얼