GroupDocs.Merger for Java를 사용하여 Word에 PDF 삽입하는 방법

PDF를 Word 문서에 직접 삽입하면 파일 간 전환이 필요 없어 협업이 크게 향상됩니다. 이 가이드에서는 GroupDocs.Merger for Java를 사용하여 Word에 PDF를 삽입하는 방법을 알아보고 PDF를 Word에 추가하는 워크플로우에 대한 실용적인 팁을 확인합니다. 라이브러리 설정부터 OLE 객체의 크기와 위치를 맞춤 설정하는 방법까지 모두 안내하므로 문서 생성을 자신 있게 자동화할 수 있습니다.

빠른 답변

  • 필요한 라이브러리는 무엇인가요? GroupDocs.Merger for Java (최신 버전)
  • 모든 파일 유형을 삽입할 수 있나요? 예 – PDF, 이미지, 스프레드시트 등 OLE 객체로 삽입 가능
  • 라이선스가 필요합니까? 개발용 무료 체험으로 시작할 수 있으며, 운영 환경에서는 상용 라이선스가 필요합니다
  • 어떤 Java IDE가 가장 적합한가요? IntelliJ IDEA, Eclipse 또는 Maven/Gradle을 지원하는 모든 IDE
  • 구현에 얼마나 걸리나요? 기본 삽입은 대략 10‑15분 정도 소요됩니다

Word에 PDF를 삽입한다는 것은 무엇인가요?

PDF를 삽입하면 Word 파일 내부에 OLE(Object Linking and Embedding) 객체가 생성되어 문서에서 직접 PDF를 열 수 있습니다. 삽입된 파일은 원본 서식과 인터랙티브 기능을 유지하면서 Word 문서는 하나의 자체 포함 패키지로 남습니다. 이 방식은 배포를 간소화하고 버전 일관성을 보장하며, 독자가 Word 환경을 떠나지 않고 보조 자료에 즉시 접근할 수 있게 합니다.

GroupDocs.Merger를 사용하여 Word에 PDF를 추가하는 이유

GroupDocs.Merger를 이용해 PDF를 삽입하면 수동 편집 없이 프로그래밍적으로 문서를 결합할 수 있는 반복 가능한 방법을 제공합니다. 라이브러리는 OLE 삽입, 크기 조정, 위치 지정 등을 자동으로 처리해 시간 절약과 인적 오류 감소에 기여합니다. 또한 배치 처리를 지원하므로 여러 Word 파일에 수십 개의 PDF를 한 번에 삽입할 수 있어 대규모 문서, 계약서, 마케팅 키트 등에 이상적입니다.

사전 요구 사항

  • 라이브러리 및 종속성: Maven 또는 Gradle을 통해 GroupDocs.Merger 라이브러리를 포함합니다.
  • 개발 환경: IntelliJ IDEA, Eclipse 또는 기타 Java IDE.
  • 기본 지식: Java 및 문서 조작 개념에 대한 기본 이해.

GroupDocs.Merger for Java를 설정하는 방법

먼저 빌드 도구를 사용해 프로젝트에 GroupDocs.Merger 라이브러리를 추가합니다. 이 라이브러리는 Merger, OleWordProcessingOptions 등 OLE 처리를 위한 모든 클래스를 제공합니다. 종속성이 해결되면 Merger 인스턴스를 생성하고 프로그래밍 방식으로 Word 문서를 다룰 수 있습니다.

Maven

Add this dependency to your pom.xml file:

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

Gradle

Include this in your build.gradle file:

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

Direct Download

Alternatively, download the latest version from the GroupDocs.Merger for Java 릴리스 페이지.

라이선스 획득: 무료 체험으로 시작하거나 기능을 평가하기 위해 임시 라이선스를 얻을 수 있습니다. 자세한 내용은 GroupDocs 구매 페이지를 방문하세요.

기본 초기화는 어떻게 작동하나요?

Merger 클래스는 GroupDocs.Merger for Java에서 모든 문서 처리 작업의 진입점입니다. Merger 인스턴스를 만든 후 importDocument와 같은 메서드를 호출해 OLE 객체를 삽입할 수 있습니다. OLE 객체를 다루기 위해 필요한 클래스를 임포트합니다:

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

PDF를 Word 문서에 삽입하는 단계별 방법

PDF를 삽입하려면 원본 Word 파일을 로드하고, PDF 경로를 지정하고, 시각 옵션을 구성한 뒤 importDocument 메서드를 호출해 OLE 객체를 삽입합니다. importDocument는 원본 문서, 삽입할 파일, 그리고 크기·정렬·표시 모드를 정의하는 OleWordProcessingOptions 인스턴스를 인수로 받습니다. 이 순서를 따르면 PDF가 원하는 위치와 모양으로 정확히 표시됩니다.

단계 1: 파일 경로 및 대상 페이지 정의

Set the source Word document, the PDF you want to embed, and where the OLE object should appear.

String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx"; // Source Word document path
String embeddedFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf"; // File to be embedded as an OLE object
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY",
    "ImportDocumentToWordProcessing-" + Paths.get(sourceFilePath).getFileName().toString()).getPath();
int pageNumber = 2; // Page number where the OLE object will be inserted
  • sourceFilePath – 기존 Word 파일의 경로.
  • embeddedFilePath – Word에 PDF를 추가하려는 PDF 파일 경로.
  • outputFilePath – 새 문서가 저장될 경로.
  • pageNumber – OLE 객체가 삽입될 페이지 번호.

단계 2: OleWordProcessingOptions 구성

OleWordProcessingOptions 클래스는 Word 문서 내부에서 OLE 객체가 어떻게 보일지를 정의합니다. 너비, 높이, 정렬 및 캡션까지 설정할 수 있습니다.

OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Set width of the embedded object (in points)
oleWordsOptions.setHeight(300); // Set height of the embedded object (in points)
  • setWidth() / setHeight() – Word 문서 안에서 PDF 아이콘이 표시되는 크기를 제어합니다.

단계 3: Merger 초기화 및 OLE 객체 가져오기

원본 문서에 대한 Merger 인스턴스를 생성하고 OLE 객체를 가져온 뒤 결과를 저장합니다.

Merger merger = new Merger(sourceFilePath);
{
    merger.importDocument(oleWordsOptions); // Embed the OLE object into the Word document
    merger.save(outputFilePath); // Save changes to a new output file
}
  • importDocument() – OleWordProcessingOptions를 받아 PDF를 OLE 객체로 삽입합니다.
  • save() – 수정된 문서를 outputFilePath에 기록합니다.

단계 4: (선택) 추가 객체에 대한 구성 재적용

더 많은 PDF를 삽입해야 할 경우 새로운 파일 경로와 페이지 번호로 단계 1‑3을 반복합니다. 동일한 OleWordProcessingOptions 클래스를 사용해 각 객체를 개별적으로 제어할 수 있습니다.

고급 시나리오를 위한 OleWordProcessingOptions 구성 방법

OleWordProcessingOptions는 OLE 삽입을 위한 설정 허브입니다. 객체를 왼쪽, 가운데, 오른쪽에 정렬하고, 아래에 캡션을 추가하며, 아이콘으로 표시할지 미리보기로 표시할지 지정할 수 있습니다. 아래 코드 스니펫은 기본 구성을 다시 보여줍니다:

OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Width of the embedded object
oleWordsOptions.setHeight(300); // Height of the embedded object

Word에 PDF를 삽입하는 실용적인 활용 사례

PDF 삽입은 다양한 전문 분야에서 가치가 있습니다. 예를 들어, 기술 매뉴얼에 상세 도면을 포함하고, 재무 보고서에 감사 보고서를 첨부하며, 법률 계약에 부록을 삽입하고, 마케팅 브로셔에 제품 사양서를 포함시킬 수 있습니다—모두 별도 다운로드나 외부 링크 없이 하나의 문서에 통합됩니다.

대용량 문서에서 성능 고려 사항은 어떻게 영향을 미치나요?

대형 Word 파일이나 다수의 OLE 객체를 처리할 때는 메모리와 I/O를 효율적으로 관리해야 합니다. 불필요한 콘텐츠를 제거하고, 필요한 페이지만 삽입하며, -Xmx 플래그를 사용해 충분한 JVM 힙 공간을 할당하세요. 또한 GroupDocs.Merger 라이브러리를 최신 버전으로 유지하면 많은 삽입 PDF가 포함된 문서의 처리 시간과 메모리 사용량을 줄이는 성능 개선을 누릴 수 있습니다.

흔히 발생하는 문제와 해결 방법

일반적인 문제로는 잘못된 파일 경로, 메모리 부족 오류, 손상된 원본 PDF, OLE 아이콘 누락 등이 있습니다. Word와 PDF 경로가 절대 경로나 프로젝트 루트에 대해 올바르게 설정되었는지 확인하고, 대량 배치의 경우 JVM 힙 크기를 늘리며, 각 PDF가 정상적으로 열리는지 사전에 검증하고, 대상 Word 템플릿이 OLE 삽입을 허용하는지 확인하세요. 이러한 요소를 조정하면 대부분의 삽입 실패를 해결할 수 있습니다.

자주 묻는 질문

Q: OLE 삽입이란 무엇인가요?
A: 삽입을 통해 PDF와 같은 객체를 Word 문서에 링크 형태로 넣어 원본 기능을 유지하면서 문서 내에서 직접 열 수 있게 합니다.

Q: 하나의 문서에 여러 OLE 객체를 삽입할 수 있나요?
A: 예, 각 객체마다 별도의 OleWordProcessingOptions를 사용해 페이지와 크기를 다르게 설정할 수 있습니다.

Q: 삽입 파일 크기에 제한이 있나요?
A: 제한은 주로 Word 자체의 제약에 따르지만, GroupDocs.Merger는 큰 파일도 효율적으로 처리합니다.

Q: 삽입 오류를 어떻게 해결하나요?
A: 파일 경로가 정확한지 확인하고 JVM에 충분한 메모리를 할당하세요. 또한 원본 PDF가 손상되지 않았는지 검증합니다.

Q: 삽입 후에 객체를 수정할 수 있나요?
A: Microsoft Word에서 문서를 열어 OLE 객체를 편집하거나, 업데이트된 옵션으로 Merger 코드를 다시 실행해 변경할 수 있습니다.

추가 자료

Last Updated: 2026-06-21
Tested With: GroupDocs.Merger for Java latest version
Author: GroupDocs

관련 튜토리얼