Java를 사용하여 두 개의 PDF 파일을 병합하는 방법

병합 전 HTML 섹션 렌더링

아래 예제는 두 개의 별도 HTML 문자열을 메모리에 렌더링한 후 이를 하나의 문서로 결합합니다. 이 패턴은 보고서 생성기, 청구서 Builder, 그리고 템플릿이나 데이터베이스 행에서 프로그래밍 방식으로 콘텐츠를 조합하는 모든 시스템에 적합합니다.

```Java {title="동적으로 생성된 PDF 병합"} //:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-html-pdfs.java import com.ironsoftware.IronPdf.PdfDocument; import java.io.IOException; import java.nio.file.Paths;

public class Main { public static void main(String[] args) throws IOException { // 각 문서 섹션의 HTML 콘텐츠 String htmlA = "

First part of the report.

Second part of the report.

    // 각 HTML 문자열을 메모리 내 PDF로 렌더링 — 디스크 쓰기 불필요
    PdfDocument pdfA = PdfDocument.renderHtmlAsPdf(htmlA);
    PdfDocument pdfB = PdfDocument.renderHtmlAsPdf(htmlB);

    // 두 문서를 하나의 통합 PDF로 병합
    PdfDocument merged = PdfDocument.merge(pdfA, pdfB);

    // 병합된 결과 저장
    merged.saveAs(Paths.get("assets/merged.pdf"));
}

}

병합된 출력은 인자 순서대로 페이지를 연결합니다. 즉, `pdfA` 페이지가 `pdfB` 페이지보다 먼저 표시됩니다. HTML 렌더링 엔진에 대한 전체 안내는 [IronPDF for Java HTML to PDF 튜토리얼](https://ironpdf.com/java/tutorials/html-to-pdf/)을 참조하십시오.

![성공적으로 병합된 문서를 보여주는 PDF 뷰어 - 왼쪽에 첫 번째 PDF, 오른쪽에 탐색 컨트롤이 있는 두 번째 PDF](/static-assets/ironpdf-java/howto/how-to-merge-two-pdf-files-java-tutorial/how-to-merge-two-pdf-files-java-tutorial-5.webp)

`renderHtmlAsPdf()` 호출은 Chromium 기반 렌더링 엔진을 사용합니다. 전체 CSS, 웹 폰트 및 인라인 이미지가 모두 지원되며, 출력은 브라우저에서 표시되는 것과 동일합니다.

## 기존 PDF 파일을 병합하려면 어떻게 해야 하나요?

디스크에서 PDF를 불러와 병합하는 과정도 동일한 패턴을 따르며, `PdfDocument.fromFile()`을 사용하여 각 파일을 메모리에 읽어온 후 객체를 `merge()`로 전달합니다.

이 접근 방식은 스캔된 청구서, 내보낸 보고서, 외부 시스템에서 수신한 파일 등 원본 문서가 이미 존재하는 모든 워크플로에 적합합니다. IronPDF는 원본 파일을 변경하지 않고 PDF 구조를 분석하여 페이지를 병합합니다.

### 디스크에서 파일 불러오기 및 병합

```Java {title="디스크에 있는 기존 PDF 파일 병합"}
//:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-existing-files.java
import com.ironsoftware.IronPdf.PdfDocument;
import java.io.IOException;
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) throws IOException {
        // 디스크에서 기존 PDF 파일 두 개를 불러옵니다
        PdfDocument pdfA = PdfDocument.fromFile(Paths.get("assets/invoice-january.pdf"));
        PdfDocument pdfB = PdfDocument.fromFile(Paths.get("assets/invoice-february.pdf"));

        // 하나의 문서로 통합
        PdfDocument merged = PdfDocument.merge(pdfA, pdfB);

        // 병합된 출력 작성 -- 원본은 수정되지 않음
        merged.saveAs(Paths.get("assets/invoices-q1.pdf"));
    }
}

merge() 호출은 새로운 PdfDocument 객체를 생성합니다; pdfA 및 pdfB은 수정되지 않습니다. 이 작업을 역으로 수행하여(즉, 페이지를 다시 추출하려면) Java용 PDF 분할 예제를 참조하십시오.

fromFile()은 어떤 파일 형식을 지원합니까?

PdfDocument.fromFile()는 표준 .pdf 파일을 지원합니다. HTML 파일, 이미지 파일 또는 기타 형식과 같이 병합 전에 변환이 필요한 문서의 경우, 적절한 렌더링 메서드(renderHtmlAsPdf(), renderUrlAsPdf())을 사용하여 PdfDocument를 생성한 다음, 해당 객체를 merge()로 전달하십시오.

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

가변 인수(Varargs) 및 리스트 기반 패턴

아래 두 패턴은 동일한 결과를 생성합니다. 파일 수가 고정된 경우에는 직접 varargs 호출을 선택하고, 프로그래밍 방식으로 컬렉션을 구축하는 경우에는 list-to-array 패턴을 선택하십시오:

```Java {title="PDF 4개 병합 -- 가변 인수 및 리스트 방식"} //:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-multiple-files.java import com.ironsoftware.IronPdf.PdfDocument; import java.io.IOException; import java.nio.file.Paths; import java.util.ArrayList; import java.util.List;

public class Main { public static void main(String[] args) throws IOException { // 기존 PDF 파일 4개 불러오기 PdfDocument pdfA = PdfDocument.fromFile(Paths.get("assets/chapter-1.pdf")); PdfDocument pdfB = PdfDocument.fromFile(Paths.get("assets/chapter-2.pdf")); PdfDocument pdfC = PdfDocument.fromFile(Paths.get("assets/chapter-3.pdf")); PdfDocument pdfD = PdfDocument.fromFile(Paths.get("assets/chapter-4.pdf"));

    // 패턴 1: 직접 가변 인수 호출 -- 파일 수가 고정된 경우에 적합
    PdfDocument merged = PdfDocument.merge(pdfA, pdfB, pdfC, pdfD);
    merged.saveAs(Paths.get("assets/full-document.PDF"));

    // 패턴 2: 먼저 목록 생성 — 파일 수가 동적인 경우 권장
    List<pdfdocument> pdfList = new ArrayList&lt;&gt;();</pdfdocument>
    pdfList.add(pdfA);
    pdfList.add(pdfB);
    pdfList.add(pdfC);
    pdfList.add(pdfD);

    PdfDocument mergedFromList = PdfDocument.merge(
        pdfList.toArray(new PdfDocument[0])
    );
    mergedFromList.saveAs(Paths.get(&quot;assets/full-document-v2.PDF&quot;));
}

}

중요한출력 시 페이지 순서는 인자 순서와 정확히 일치합니다. 문서의 순서가 중요한 경우(예: 책의 챕터나 정렬된 양식 섹션 등)에는 `merge()`.
을 호출하기 전에 목록을 정렬하십시오.)}]

### 디렉터리를 스캔하여 모든 PDF 파일을 병합하려면 어떻게 해야 하나요?

컴파일 시점에 입력 파일 집합이 알려지지 않은 경우, 디렉터리에서 파일 경로를 읽어오는 것은 리스트 패턴의 자연스러운 확장입니다. 아래 코드 조각은 폴더 내의 모든 `.pdf` 파일을 수집하여 파일 이름 순으로 정렬한 후, 순서대로 병합합니다.

```Java {title="디렉터리 스캔 및 모든 PDF 파일 병합"}
//:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-directory-pdfs.java
import com.ironsoftware.IronPdf.PdfDocument;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.stream.Collectors;

public class Main {
    public static void main(String[] args) throws IOException {
        Path inputDir = Paths.get("assets/monthly-reports");

        // 디렉터리에서 모든 PDF 파일을 파일 이름 순으로 수집합니다
        List<path> pdfPaths = Files.list(inputDir)</path>
            .filter(p -&gt; p.toString().endsWith(&quot;.pdf&quot;))
            .sorted(Comparator.comparing(Path::getFileName))
            .collect(Collectors.toList());

        // 각 파일을 PdfDocument에 로드합니다
        List<pdfdocument> documents = new ArrayList&lt;&gt;();</pdfdocument>
        for (Path path : pdfPaths) {
            documents.add(PdfDocument.fromFile(path));
        }

        // 모든 문서를 병합하고 결과를 저장합니다
        PdfDocument combined = PdfDocument.merge(
            documents.toArray(new PdfDocument[0])
        );
        combined.saveAs(Paths.get(&quot;assets/annual-report.pdf&quot;));
    }
}

이 패턴은 모든 폴더 크기를 처리할 수 있습니다. 대용량 배치(50개 이상의 파일)의 경우, 모든 파일을 동시에 불러오는 대신, 메모리 사용량의 급증을 제한하기 위해 파일을 여러 번에 걸쳐 불러와 병합하는 방식을 고려하십시오.

병합 후에는 통합된 문서를 추가로 다듬을 수 있습니다. IronPDF for Java는 사용자 지정 머리글 및 바닥글 추가, 워터마크 적용, 그리고 전달 전 파일 크기를 줄이기 위한 최종 출력물 압축 기능을 지원합니다.