GroupDocs.Merger for Java를 사용하여 XPS 파일 병합하는 방법

오늘날 빠르게 진행되는 개발 사이클에서 XPS 파일을 병합하는 방법을 프로그래밍 방식으로 알면 수시간의 수작업을 절약할 수 있습니다. 보고서를 통합하거나 로그를 보관하거나 배포용 단일 패키지를 준비하든, GroupDocs.Merger for Java는 타사 뷰어가 필요 없는 신뢰할 수 있는 서버 측 솔루션을 제공합니다. 이 가이드는 설치부터 최종 저장까지 필요한 모든 것을 안내하므로 XPS 문서를 자신 있게 병합할 수 있습니다.

빠른 답변

  • XPS 병합을 처리하는 라이브러리는 무엇입니까? GroupDocs.Merger for Java.
  • 최소 Java 버전? JDK 8 or higher.
  • 개발에 라이선스가 필요합니까? 무료 체험은 평가에 사용할 수 있으며, 프로덕션에는 유료 라이선스가 필요합니다.
  • 10개 이상의 파일을 병합할 수 있습니까? 예—메모리가 허용하는 한 파일을 병합할 수 있으며, 라이브러리는 사용량을 낮게 유지하도록 데이터를 스트리밍합니다.
  • API가 스레드 안전합니까? 예, Merger 클래스는 적절히 인스턴스화된 후 동시에 사용할 수 있습니다.

GroupDocs.Merger for Java란?

GroupDocs.Merger for Java는 XPS를 포함한 50개 이상의 문서 형식에 대한 프로그래밍 방식의 병합, 분할 및 조작을 가능하게 하는 서버 측 API입니다. Microsoft Office나 타사 뷰어를 설치할 필요가 없으며, 스트리밍을 통해 메모리 사용량을 100 MB 이하로 유지하면서 수백 페이지 파일을 처리합니다. 자세한 사용법은 공식 Documentation 및 API Reference를 참조하십시오.

XPS 병합에 GroupDocs.Merger를 사용하는 이유

  • 광범위한 형식 지원: 50+ 입력 및 출력 형식 (XPS, PDF, DOCX, PPTX, HTML, 이미지 등).
  • 높은 성능: 일반적인 2 CPU, 8 GB VM에서 300‑페이지 XPS 문서를 2 초 미만에 병합합니다.
  • 외부 종속성 없음: 순수 Java, 네이티브 라이브러리나 OS‑특정 구성 요소가 필요 없습니다.
  • 확장 가능한 라이선스: 최대 5 문서까지 무료 체험, 무제한 사용을 위한 유료 플랜 제공.

전제 조건

시작하기 전에 다음 항목을 확인하십시오:

  • **JDK 8+**가 설치되고 PATH에 설정되어 있는지 확인하십시오.
  • IntelliJ IDEA, Eclipse, NetBeans와 같은 IDE.
  • 의존성 관리를 위한 Maven 또는 Gradle에 접근할 수 있어야 합니다.
  • GroupDocs 체험판 또는 구매한 라이선스 파일.

GroupDocs.Merger for Java 설정

Maven

다음 Maven Repository에서 의존성을 추가하십시오:

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

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

Gradle

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

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

Direct Download

수동 설정을 선호하는 경우, 최신 버전을 GroupDocs.Merger for Java releases 페이지에서 다운로드하거나 Download Library 링크를 사용하십시오.

라이선스 획득 단계

  1. 무료 체험: 기본 기능을 탐색하려면 Free Trial으로 시작하십시오.
  2. 임시 라이선스: 평가 기간 동안 전체 기능에 접근하려면 Temporary License를 획득하십시오.
  3. 구매: 지속적인 사용을 위해 GroupDocs Purchase 페이지에서 라이선스를 구매하거나 직접 Purchase License 링크를 이용하십시오.

기본 초기화 및 설정

라이브러리를 프로젝트에 추가한 후, 라이선스 키로 API를 초기화하십시오:

com.groupdocs.merger.Merger merger = new com.groupdocs.merger.Merger("path/to/license/file.lic");

import com.groupdocs.merger.Merger;

public class MergeXPSFiles {
    public static void main(String[] args) {
        Merger merger = new Merger("path/to/your/document.xps");
        // This initializes a Merger object with your source XPS file.
    }
}

GroupDocs.Merger for Java를 사용하여 XPS 파일을 병합하는 방법?

기본 XPS 문서를 로드하고 추가 XPS 파일을 이어 붙인 뒤 결합된 결과를 저장합니다—세 단계만으로 가능합니다. 먼저 기본 파일을 가리키는 Merger 인스턴스를 생성하고, 각 추가 파일에 대해 join을 호출한 뒤, 원하는 출력 경로와 함께 save를 호출합니다. 이 패턴은 파일 수에 관계없이 레이아웃, 글꼴 및 이미지를 자동으로 보존합니다.

1단계: Merger 객체 초기화

Merger 클래스는 GroupDocs.Merger에서 모든 문서 결합 작업의 진입점입니다.

Merger merger = new Merger("path/to/firstFile.xps");

import com.groupdocs.merger.Merger;

// Load the initial XPS file for merging
Merger merger = new Merger("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XPS");

설명: 생성자는 첫 번째 XPS 파일의 경로를 받아 추가 작업을 위한 내부 스트림을 준비합니다.

2단계: 병합할 다른 XPS 파일 추가

join 메서드를 사용하여 추가 XPS 문서를 병합 대기열에 넣습니다.

merger.join("path/to/secondFile.xps");

// Add another file to merge
merger.join("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XPS_2");

설명: join 호출마다 전체 문서를 메모리에 로드하지 않고 지정된 파일을 내부 병합 큐에 추가합니다.

3단계: 병합된 출력 파일 저장

모든 파일이 대기열에 들어가면 save를 호출하여 결합된 XPS를 디스크에 씁니다.

merger.save("path/to/outputFile.xps");

String outputFile = "YOUR_OUTPUT_DIRECTORY/merged.xps";
merger.save(outputFile);
// This saves the combined output to the defined path.

설명: save 메서드는 병합을 완료하고 지정한 위치에 출력 파일을 생성합니다.

일반적인 문제 및 해결책

  • Invalid File Path: 모든 경로가 절대 경로이거나 작업 디렉터리에 대해 올바르게 상대 경로인지 다시 확인하십시오.
  • Insufficient Permissions: 소스 및 대상 폴더에 대한 읽기/쓰기 권한을 가지고 JVM을 실행하십시오.
  • Memory Overrun on Large Files: RAM 사용량을 낮게 유지하려면 스트리밍 모드(setUseMemoryCache(true))를 활성화하십시오.

실제 적용 사례

  1. Document Consolidation: 전자책의 개별 챕터를 하나의 XPS 파일로 결합하여 배포합니다.
  2. Archiving: 일일 로그 XPS 파일을 월별 아카이브로 병합해 저장 및 검색을 간소화합니다.
  3. Collaborative Workflows: 팀 구성원이 개별 XPS 보고서를 제출하면 프로그램이 이를 마스터 문서로 자동 병합합니다.

성능 고려 사항

  • Efficient Memory Use: 라이브러리는 데이터를 스트리밍하여 500‑페이지 병합 시에도 피크 메모리를 100 MB 이하로 유지합니다.
  • Batch Processing: I/O 오버헤드와 CPU 활용을 균형 있게 맞추기 위해 10–20개씩 그룹으로 파일을 처리합니다.
  • Best Practices: 라이브러리를 최신 상태로 유지하고 최신 가비지 컬렉션 알고리즘을 지원하는 JVM 버전에서 실행하십시오.

자주 묻는 질문

Q: XPS 파일이란 무엇입니까?
A: XPS(XML Paper Specification)는 Microsoft의 고정 레이아웃 문서 형식으로, 폰트, 이미지 및 레이아웃을 플랫폼 간에 보존합니다.

Q: 동일한 API로 PDF 파일도 병합할 수 있습니까?
A: 예, GroupDocs.Merger는 XPS 외에도 PDF, DOCX, PPTX 등 다양한 형식을 지원합니다.

Q: GroupDocs.Merger의 시스템 요구 사항은 무엇입니까?
A: JDK 8+ 및 최신 IDE이면 충분합니다; 추가적인 OS‑레벨 종속성은 필요하지 않습니다.

Q: 병합 중 예외를 어떻게 처리해야 합니까?
A: 병합 호출을 try‑catch 블록으로 감싸고 IOException 및 MergerException을 처리하여 파일 접근 또는 형식 관련 오류를 포착하십시오.

Q: 병합할 수 있는 파일 수에 제한이 있습니까?
A: 기술적으로는 제한이 없지만 실제 제한은 사용 가능한 메모리와 디스크 I/O에 따라 달라집니다. 스트리밍을 올바르게 사용하면 수천 개 파일도 최적화됩니다.

지원

추가 도움이 필요하면 커뮤니티 지원 및 공식 지원을 위해 Support Forum을 방문하십시오.

결론

이제 GroupDocs.Merger for Java를 사용하여 XPS 파일을 병합하는 방법에 대한 완전하고 단계별 로드맵을 갖추었습니다. 설치 단계, Merger 객체 초기화, join 및 save 호출을 따라 하면 Java 기반 백엔드에서 문서 통합을 자동화할 수 있습니다. 형식 변환, 페이지 추출, 워터마킹 등 추가 기능을 탐색하여 문서 워크플로를 더욱 확장해 보십시오.

최종 업데이트: 2026-06-16
테스트 환경: GroupDocs.Merger 5.13 for Java (latest as of June 2026)
작성자: GroupDocs

관련 튜토리얼