GroupDocs.Merger for Java를 사용한 워드 문서 페이지 분할
이 튜토리얼에서는 GroupDocs.Merger for Java를 사용하여 워드 문서 페이지를 분할하고 PDF 및 PPTX와 같은 다른 형식도 다루는 방법을 배웁니다. 단일 계약 조항을 추출하거나 프레젠테이션에서 핸드아웃을 생성하거나 방대한 보고서를 관리 가능한 청크로 나누는 등, API를 사용하면 정확한 페이지 범위, 홀수/짝수 필터 또는 단일 페이지 출력 등을 몇 줄의 코드만으로 지정할 수 있습니다.
빠른 답변
- “extract specific pages”가 무엇을 의미하나요? 선택한 페이지만 포함하는 새 문서를 원본 파일에서 생성하는 것을 의미합니다.
- 지원되는 형식은 무엇인가요? PDF, DOCX, PPTX 및 기타 많은 인기 형식.
- 홀수 또는 짝수 페이지로 필터링할 수 있나요? 예,
RangeMode옵션을 사용합니다 (예:OddPages). - 라이선스가 필요합니까? 평가용으로는 무료 체험이 가능하며, 프로덕션에서는 영구 라이선스가 필요합니다.
- 대용량 문서에 적합한가요? 예—메모리 사용량을 낮게 유지하기 위해 큰 문서 섹션을 분할합니다.
특정 페이지 추출이란 무엇인가요?
특정 페이지를 추출한다는 것은 원본 문서에서 선택된 페이지 집합을 가져와 해당 페이지만 포함하는 새 독립 파일을 만드는 것을 의미합니다. 이 기술은 집중된 보고서를 생성하거나 개별 계약 조항을 공유하거나 전체 원본 문서를 노출하지 않고 특정 프레젠테이션 슬라이드를 배포하는 데 유용합니다.
PDF와 워드 문서를 분할하기 위해 GroupDocs.Merger for Java를 사용하는 이유는?
필요한 페이지만 로드하고 무거운 작업은 GroupDocs.Merger에 맡기세요. 이 라이브러리는 50개 이상의 입력 및 출력 형식을 지원하며, 전체 문서를 메모리에 로드하지 않고 2 GB까지 파일을 처리할 수 있고, PDF, DOCX, PPTX 등에서 일관된 API를 제공하므로 여러 도구를 번갈아 사용할 필요가 없습니다.
전제 조건
- GroupDocs.Merger for Java (최신 버전)
- JDK 8+
- IntelliJ IDEA 또는 Eclipse와 같은 IDE
- Maven 또는 Gradle을 사용한 의존성 관리
GroupDocs.Merger for Java 설정
선호하는 빌드 도구를 사용하여 프로젝트에 라이브러리를 추가합니다.
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를 방문하세요.
라이선스 획득
라이선스를 다음 방법으로 획득할 수 있습니다:
- Free Trial – 제한 없이 전체 기능을 테스트합니다.
- Temporary License – 평가 기간을 연장합니다.
- Purchase – 영구 프로덕션 라이선스.
기본 초기화 및 설정Merger 클래스는 모든 분할 작업의 진입점입니다. 메모리 내에서 문서를 나타내며 페이지를 조작하는 메서드를 제공합니다. GroupDocs.Merger를 초기화하려면 문서 경로와 함께 Merger 인스턴스를 생성합니다:
import com.groupdocs.merger.Merger;
String filePath = "YOUR_DOCUMENT_DIRECTORY/Sample_Docx_10_Pages.docx";
Merger merger = new Merger(filePath);
GroupDocs.Merger for Java를 사용하여 특정 페이지를 추출하는 방법
특정 페이지를 추출하려면 Merger 인스턴스로 소스 문서를 로드하고, 원하는 시작 및 종료 페이지를 지정한 SplitOptions 객체를 구성한 뒤 선택적으로 RangeMode(예: OddPages 또는 EvenPages)를 설정합니다. 그런 다음 merger.split(options)를 호출하면 선택된 페이지만 포함하는 새 파일이 생성됩니다.
직접 답변
Merger 인스턴스를 생성하고 RangeMode.OddPages와 원하는 시작/종료 페이지를 설정한 SplitOptions 객체를 구성한 뒤 merger.split(options)를 호출합니다. 이 한 단계 흐름은 지정된 범위 내에서 홀수 페이지만 추출하여 제공한 출력 패턴에 기록합니다.
단계 1: 입력 및 출력 경로 정의
소스 파일과 분할 파일의 대상 패턴을 설정합니다:
String filePath = "YOUR_DOCUMENT_DIRECTORY/Sample_Docx_10_Pages.docx";
String filePathOut = "YOUR_OUTPUT_DIRECTORY/SplitToSinglePagesByRangeWithFilter-Output.docx";
단계 2: 분할 옵션 구성 (범위 및 필터)
SplitOptions 클래스는 라이브러리에 어떤 페이지를 추출하고 어떤 필터를 적용할지 알려줍니다. RangeMode는 홀수, 짝수 또는 모든 페이지와 같이 포함할 페이지를 지정하는 열거형입니다. filePathOut 속성은 파일명 패턴을 정의하고, startPage와 endPage는 포함 범위를 설정합니다. RangeMode.OddPages는 해당 범위 내에서 홀수 페이지만 유지하여 효과적으로 특정 페이지를 추출합니다.
import com.groupdocs.merger.domain.options.SplitOptions;
import com.groupdocs.merger.domain.options.RangeMode;
SplitOptions splitOptions = new SplitOptions(filePathOut, 3, 7, RangeMode.OddPages);
단계 3: 분할 작업 수행
구성된 옵션을 사용하여 분할을 실행합니다:
Merger merger = new Merger(filePath);
merger.split(splitOptions);
문제 해결 팁
- 파일 경로가 정확하고 접근 가능한지 확인하십시오.
- 페이지 번호가 문서의 전체 페이지 수 범위 내에 있는지 확인하십시오; 그렇지 않으면 예외가 발생합니다.
PDF를 단일 페이지로 분할하기 (split pdf single pages)
PDF를 개별 페이지로 분할하려면 Merger 인스턴스로 파일을 열고 SplitOptions 객체에서 RangeMode.AllPages를 설정합니다. 출력 파일명 패턴을 지정한 뒤 merger.split(options)를 호출합니다. 라이브러리는 각 페이지마다 별도의 PDF 파일을 생성하며 원본 내용과 형식을 유지합니다.
대용량 문서를 효율적으로 분할하는 방법 (split large document)
매우 큰 문서를 처리할 때는 메모리 사용량을 줄이기 위해 작은 페이지 범위(예: 1‑100, 101‑200)로 분할합니다. 각 범위에 대해 별도의 SplitOptions를 만들고 merger.split(options)를 순차적으로 실행한 뒤 각 배치가 끝난 후 Merger 인스턴스를 닫습니다. 이 방법은 CPU와 I/O 사용량을 관리 가능한 수준으로 유지합니다.
PDF 홀수 페이지만 분할하는 방법 (split pdf odd pages)
PDF에서 홀수 번호 페이지만 추출하려면 RangeMode.OddPages가 설정된 SplitOptions 객체를 구성합니다. 원하는 출력 패턴을 지정하고 전체 문서가 필요하지 않은 경우 페이지 범위를 선택적으로 정의합니다. merger.split(options)를 호출하면 라이브러리는 홀수 페이지만 포함된 파일을 생성합니다.
실용적인 적용 사례
- Document Segmentation – 계약을 조항 수준의 PDF로 분할하여 검토를 용이하게 합니다.
- Report Management – 긴 연례 보고서에서 특정 장이나 부록을 추출합니다.
- Presentation Preparation – 목표 회의를 위해 개별 슬라이드를 분리합니다.
이 로직을 데이터베이스나 콘텐츠 관리 시스템과 통합하여 워크플로 파이프라인을 자동화할 수도 있습니다.
성능 고려 사항
- Memory Management – 처리 후
merger.close()를 호출하거나 (try‑with‑resources 사용) 파일 핸들을 해제합니다. - Selective Ranges – 실제로 필요한 페이지만 요청하면 I/O와 CPU 사용량을 최소화할 수 있습니다.
결론
이제 GroupDocs.Merger for Java를 사용하여 워드 문서 페이지를 분할(및 기타 지원 형식)하는 명확한 단계별 방법을 알게 되었습니다. 이 기능은 문서 워크플로를 간소화하고 사용자에게 정확히 필요한 콘텐츠를 제공할 수 있게 합니다.
다음 단계
- 다양한
RangeMode값(e.g.,EvenPages,AllPages)을 실험해 보세요. - merge 기능과 결합하여 추출된 페이지를 재정렬하거나 연결합니다.
- 암호 보호 문서, 워터마크 등 전체 API를 탐색하십시오.
자주 묻는 질문
Q: GroupDocs.Merger for Java란 무엇인가요?
A: GroupDocs.Merger for Java는 PDF, DOCX, PPTX 등을 포함한 다양한 문서 형식에서 페이지를 병합, 분할 및 재정렬할 수 있는 강력한 라이브러리입니다.
Q: GroupDocs.Merger를 다른 프로그래밍 언어와 함께 사용할 수 있나요?
A: 예, .NET 및 C++용에도 유사한 기능이 제공됩니다.
Q: 문서 처리 중 예외를 어떻게 처리하나요?
A: 처리 오류가 발생하면 GroupDocs.Merger에서 MergerException 예외가 발생합니다. 호출을 try‑catch 블록으로 감싸고 MergerException을 검사하여 자세한 오류 정보를 확인하십시오.
Q: 홀수/짝수 페이지 필터링 없이 문서를 분할할 수 있나요?
A: 물론입니다—RangeMode.AllPages를 설정하거나 필터 매개변수를 생략하면 정확한 페이지 번호로 분할할 수 있습니다.
Q: GroupDocs.Merger 사용을 위한 시스템 요구 사항은 무엇인가요?
A: Java 8 이상 및 호환 가능한 IDE가 필요합니다; 추가 네이티브 종속성은 필요하지 않습니다.
리소스
마지막 업데이트: 2026-07-25
테스트 환경: GroupDocs.Merger 최신 버전 (Java)
작성자: GroupDocs