Java에서 GroupDocs.Merger를 사용하여 페이지 추출 및 병합하는 방법

이 포괄적인 튜토리얼에서는 GroupDocs.Merger for Java를 사용하여 PDF, DOCX 파일, 스프레드시트 및 기타 다양한 문서 유형에서 페이지를 추출하고 병합하는 방법을 알아봅니다. 맞춤 브로셔를 제작하거나 여러 책에서 챕터를 추출하거나 분산된 소스 파일에서 간결한 보고서를 생성해야 할 경우, 이 가이드는 명확한 설명과 실제 예시를 통해 전체 과정을 단계별로 안내합니다.

빠른 답변

  • 주요 사용 사례는 무엇인가요? PDF, DOCX, XLSX, PPTX 및 기타 지원되는 형식에서 선택한 페이지를 하나의 출력 파일로 결합합니다.
  • 어떤 라이브러리가 이를 처리하나요? GroupDocs.Merger for Java.
  • 라이선스가 필요합니까? 평가를 위해 무료 체험을 사용할 수 있으며, 실제 운영을 위해서는 유료 라이선스가 필요합니다.
  • 필요한 Java 버전은? Java 8 이상.
  • 두 개 이상의 파일을 병합할 수 있나요? 예—추가 소스 문서마다 join을 반복 호출합니다.

추출 및 병합 페이지란 무엇인가요?

extract and merge pages는 하나 이상의 소스 문서에서 특정 페이지 번호 또는 범위를 선택하여 새로운 파일로 연결하는 과정입니다. 이는 수동 복사‑붙여넣기를 없애고 결과 문서가 원본의 서식, 글꼴 및 이미지를 유지하도록 보장합니다.

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

GroupDocs.Merger for Java는 개발자가 문서를 프로그래밍 방식으로 조작할 수 있게 해주는 다목적 라이브러리로, 50개 이상의 형식을 지원하고 고속 처리와 낮은 메모리 사용량을 제공하여 엔터프라이즈 환경에서 서버‑사이드 문서 워크플로우 및 대규모 배치 작업에 이상적입니다.

  • 형식 유연성: PDF, DOCX, PPTX, XLSX 및 이미지 파일을 포함한 50개 이상의 입력 및 출력 형식을 지원하므로 사실상 모든 오피스 문서를 다룰 수 있습니다.
  • 성능 중심: 요청한 페이지만 처리하므로 메모리 사용량을 줄입니다.
  • 쉬운 통합: Maven 또는 Gradle을 통해 사용할 수 있으며, 명확한 API 문서와 외부 종속성이 없습니다.

사전 요구 사항

  • 기본 Java 프로그래밍 지식.
  • 의존성 관리를 위한 Maven 또는 Gradle.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE.

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'

또는 GroupDocs.Merger for Java releases에서 최신 버전을 직접 다운로드하십시오.

라이선스 획득

모든 기능을 사용하려면 라이선스가 필요합니다. 무료 체험으로 시작하거나 구매 페이지에서 정식 라이선스를 구매할 수 있습니다. 단기 평가를 위한 임시 라이선스도 제공됩니다.

Java에서 페이지를 추출하고 병합하려면 어떻게 하나요?

Merger 클래스는 문서 병합 작업을 생성하고 관리하는 주요 API 구성 요소입니다. Merger 생성자를 사용해 각 소스 문서를 로드하고, 필요한 정확한 페이지 번호를 지정한 뒤 join을 호출하여 결합합니다. 마지막으로 병합된 결과를 원하는 형식으로 저장합니다. 이 전체 흐름은 네 번의 메서드 호출만 필요하며, 지원되는 모든 파일 유형에서 일관되게 작동합니다.

특정 페이지를 추출하고 병합하는 단계별 가이드

단계 1: 기본 문서로 Merger 초기화

import com.groupdocs.merger.Merger;
import com.groupdocs.merger.domain.options.PageJoinOptions;

String filePath = YOUR_DOCUMENT_DIRECTORY + "/sample.pdf"; // Source PDF document path
Merger merger = new Merger(filePath);

단계 2: 결합할 페이지 정의

// Specify the page numbers you wish to join (e.g., pages 1 and 2)
PageJoinOptions joinOptions = new PageJoinOptions(1, 2);

단계 3: 두 번째 문서에서 선택한 페이지 결합

// Path to your DOCX file\ String docxFilePath = YOUR_DOCUMENT_DIRECTORY + "/sample.docx";
merger.join(docxFilePath, joinOptions);

단계 4: 결과 저장 및 리소스 해제

String outputFilePath = YOUR_OUTPUT_DIRECTORY + "/CrossJoinPagesFromVariousDocuments-output.pdf";
merger.save(outputFilePath);

try {
    merger.close();
} catch (Exception e) {
    // Handle exceptions appropriately
}

단계 5 (옵션): 상수로 파일 경로 중앙화

import java.nio.file.Paths;
import java.io.File;

public class PathConstants {
    public static final String DOCUMENT_BASE_PATH = YOUR_DOCUMENT_DIRECTORY;
    public static final String OUTPUT_BASE_PATH = YOUR_OUTPUT_DIRECTORY;

    public static String getDocumentPath(String fileName) {
        return DOCUMENT_BASE_PATH + "/" + fileName;
    }

    public static String getOutputFilePath() {
        File outputFile = new File(OUTPUT_BASE_PATH, "CrossJoinPagesFromVariousDocuments-output.pdf");
        return outputFile.getPath();
    }
}

상수를 사용하면 코드가 깔끔해지고 향후 경로 변경이 간편해집니다.

실용적인 적용 사례

extract and merge pages가 빛을 발하는 몇 가지 실제 시나리오를 소개합니다:

  1. 문서 통합: 여러 교과서에서 선택한 챕터를 하나의 PDF로 추출하여 빠르게 검토할 수 있습니다.
  2. 보고서 생성: 재무 PDF와 Excel에서 파생된 PDF의 주요 섹션을 하나의 요약 보고서로 결합합니다.
  3. 연구 편집: 여러 학술 논문(PDF, DOCX)의 발췌 부분을 하나의 참고 문서로 병합합니다.

성능 고려 사항

  • Merger 닫기: 작업이 끝난 후 Merger를 닫아 네이티브 리소스를 해제합니다.
  • 필요한 페이지만 선택: 전체 파일을 병합하는 대신 필요한 페이지만 선택하면 처리 시간이 크게 단축됩니다.
  • 예외 처리: 소스 파일이 없거나 손상된 경우에도 충돌을 방지하도록 예외를 적절히 처리합니다.

일반적인 문제 및 해결책

문제해결책
대용량 파일에서 OutOfMemoryError페이지를 더 작은 배치로 처리하고 각 배치 후 Merger를 닫습니다.
지원되지 않는 파일 형식형식이 GroupDocs.Merger 지원 형식 목록(PDF, DOCX, XLSX, PPTX 등)에 포함되어 있는지 확인합니다.
라이선스가 적용되지 않음License license = new License(); license.setLicense("path/to/license.lic");와 같이 라이선스 파일을 애플리케이션 루트 디렉터리에 배치하거나 설정했는지 확인합니다.

자주 묻는 질문

Q: 두 개 이상의 문서를 병합할 수 있나요?
A: 예, 추가 소스 파일마다 merger.join()을 반복 호출하면 됩니다.

Q: GroupDocs.Merger가 지원하는 파일 유형은 무엇인가요?
A: PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS 등 50개가 넘는 일반적인 오피스 형식을 지원합니다.

Q: 문서를 병합하지 않고 페이지를 추출하려면 어떻게 하나요?
A: extract 메서드와 PageExtractOptions를 사용해 선택한 페이지를 새 파일로 저장합니다. 이는 extract pages java 사용 사례에서 다룹니다.

Q: 결합할 수 있는 페이지 수에 제한이 있나요?
A: 라이브러리는 명시적인 제한을 두지 않으며, 실제 제한은 시스템 메모리와 CPU에 따라 달라집니다.

Q: 동적 출력 파일 이름을 생성할 수 있나요?
A: 물론입니다—PathConstants.getOutputFilePath() 또는 사용자 정의 로직을 사용해 파일 이름에 타임스탬프나 UUID를 연결하면 됩니다.

리소스

이 링크들을 살펴보며 전문성을 높이고 발생할 수 있는 문제를 해결하세요.

마지막 업데이트: 2026-10-16
테스트 환경: GroupDocs.Merger for Java latest-version
작성자: GroupDocs

관련 튜토리얼