개요

PDF 파일 병합은 문서 처리 작업을 수행하는 개발자에게 일반적인 요구 사항입니다. 이 블로그 포스트에서는 GroupDocs.Merger for Node.js via Java를 사용하여 여러 PDF 파일을 단일 문서로 병합하는 방법을 살펴봅니다. 이 라이브러리를 사용하면 제3자 소프트웨어 없이 프로그래밍 방식으로 PDF 파일을 결합할 수 있어 작업 흐름을 간소화하고 생산성을 향상시킬 수 있습니다.

단계별 가이드를 통해 다음을 배우게 됩니다:

  • 소스 PDF 파일로 병합 클래스 초기화하기
  • 병합에 추가 PDF 파일 추가하기
  • 결합된 PDF 파일 저장하기

Node.js에서 PDF 파일 병합하는 방법

Node.js에서 PDF 파일을 병합하려면 먼저 소스 PDF 파일의 경로로 Merger 클래스를 인스턴스화해야 합니다. 그 후, 병합할 다른 PDF 파일을 추가하고 최종적으로 결과 PDF 파일을 저장할 수 있습니다.

PDF 파일을 병합하는 단계:

  1. 소스 PDF 파일 로드하기 - 첫 번째 PDF의 경로를 사용하여 Merger 클래스의 인스턴스를 생성합니다.
  2. 다른 PDF 파일 추가하기 - join 메서드를 사용하여 병합에 추가 PDF 파일을 포함합니다.
  3. 결과 PDF 파일 저장하기 - save 메서드를 호출하여 최종 병합 문서를 원하는 위치에 출력합니다.

다음은 이러한 단계를 보여주는 예제 코드 스니펫입니다:

// GroupDocs.Merger for Node.js 라이브러리 가져오기
const GroupDocs = require("groupdocs-merger");

// PDF 파일 병합 함수
async function mergePdf(groupdocs, inputFilePath) {
    // 소스 PDF 파일로 새로운 Merger 인스턴스 생성
    const merger = new groupdocs.merger.Merger(inputFilePath);
    
    // 병합된 PDF의 출력 파일 경로 정의
    const outputPath = `${groupdocs.outputFolder}/MergePdf.pdf`;
    
    console.log(`병합 완료: ${outputPath}`);
    
    // 병합할 다른 PDF 파일 추가
    merger.join("path/to/your/secondPDF.pdf");
    
    // 지정된 출력 경로에 병합된 PDF 저장
    await merger.save(outputPath);
}

// 사용 예
mergePdf(GroupDocs, "path/to/your/firstPDF.pdf");

PDF 병합 코드 예제

위에 제공된 코드 예제에서는 다음과 같은 주요 단계를 수행합니다:

  • 필요한 라이브러리 가져오기: 이 단계는 GroupDocs.Merger가 애플리케이션에서 사용 가능하도록 합니다.
  • Merger 클래스 인스턴스화: 첫 번째 PDF 파일의 경로가 Merger 생성자에 전달되어 병합 프로세스가 초기화됩니다.
  • 추가 PDF 결합하기: 각 추가 PDF 파일은 join 메서드를 사용하여 결합됩니다. 이 메서드는 여러 PDF 문서를 단일 파일로 결합할 수 있게 해줍니다.
  • 최종 문서 저장하기: save 메서드를 호출하여 새로운 병합된 PDF를 디스크에 기록합니다.

PDF 병합 시 북마크 사용하기

병합된 PDF에서 북마크를 유지하고자 하는 경우 특정 옵션을 사용하여 병합 프로세스를 구성할 수 있습니다.

아래 예제는 북마크를 유지하면서 PDF 파일을 병합하는 방법을 보여줍니다:

// GroupDocs.Merger for Node.js 라이브러리 가져오기
const GroupDocs = require("groupdocs-merger");

// 북마크와 함께 PDF를 병합하는 함수
async function mergePdfWithBookmarks(groupdocs, inputFilePath) {
    // 새로운 Merger 인스턴스 생성
    const merger = new groupdocs.merger.Merger(inputFilePath);
    
    // 출력 파일 경로 정의
    const outputPath = `${groupdocs.outputFolder}/MergePdfWithBookmarks.pdf`;
    
    // 북마크 사용 옵션 생성
    const pdfJoinOptions = {
        useBookmarks: true // 북마크 사용
    };

    console.log(`병합 완료: ${outputPath}`);
    
    // 북마크가 있는 두 번째 PDF 추가
    merger.join("path/to/your/secondPDF.pdf", pdfJoinOptions);
    
    // 지정된 출력 경로에 병합된 PDF 저장
    await merger.save(outputPath);
}

// 사용 예
mergePdfWithBookmarks(GroupDocs, "path/to/your/firstPDF.pdf");

이 업데이트된 예제에서는 PDF를 병합할 때 북마크를 유지하기 위한 옵션을 지정합니다. useBookmarks: true를 추가함으로써 원본 파일의 북마크가 병합된 문서에 유지됩니다.

결론

GroupDocs.Merger for Node.js via Java를 사용하여 Node.js에서 PDF 파일을 병합하는 것은 수행하기 간단한 과정으로, 문서 관리 작업을 크게 간소화할 수 있습니다. 보고서를 위한 다양한 문서를 결합하거나 여러 파일을 하나의 첨부 파일로 보내야 하는 경우, 이 라이브러리는 이러한 작업을 프로그래밍 방식으로 수행하는 데 필요한 도구를 제공합니다. 제3자 소프트웨어에 의존하지 않습니다.

추가 자료

releases.groupdocs.com에서 무료 평가판을 다운로드할 수 있으며, 여기에서 임시 라이센스를 획득할 수 있습니다. 임시 라이센스를 통해 제한 없이 라이브러리를 사용해 볼 수 있습니다.

예제

GroupDocs.Merger for Node.js via Java를 사용하여 PDF 파일을 병합하는 방법을 이해하는 데 도움이 되는 몇 가지 실제 예제를 소개합니다.

기본 PDF 병합 예제

이 예제에서는 두 개의 간단한 PDF 파일을 하나로 병합합니다.

// GroupDocs.Merger for Node.js 라이브러리 가져오기
const GroupDocs = require("groupdocs-merger");

// 두 개의 PDF 파일을 병합하는 함수
async function mergeTwoPdfFiles(groupdocs) {
    // 소스 PDF 파일의 경로 정의
    const firstPdfPath = "path/to/your/firstPDF.pdf";
    const secondPdfPath = "path/to/your/secondPDF.pdf";
    
    // 첫 번째 PDF를 위한 새로운 Merger 인스턴스 생성
    const merger = new groupdocs.merger.Merger(firstPdfPath);
    
    // 두 번째 PDF를 첫 번째 PDF에 병합
    merger.join(secondPdfPath);
    
    // 병합된 PDF의 출력 경로 정의
    const outputPath = `${groupdocs.outputFolder}/MergedTwoPdfFiles.pdf`;
    
    // 지정된 출력 경로에 결과 저장
    await merger.save(outputPath);
    console.log(`병합된 파일 저장 완료: ${outputPath}`);
}

// 사용 예
mergeTwoPdfFiles(GroupDocs);

여러 파일 병합 예제

이 시나리오에서는 세 개의 PDF 파일을 하나의 문서로 병합합니다.

// GroupDocs.Merger for Node.js 라이브러리 가져오기
const GroupDocs = require("groupdocs-merger");

// 여러 PDF 파일을 병합하는 함수
async function mergeMultiplePdfFiles(groupdocs) {
    // 소스 PDF 파일의 경로 정의
    const pdfPaths = [
        "path/to/your/firstPDF.pdf",
        "path/to/your/secondPDF.pdf",
        "path/to/your/thirdPDF.pdf"
    ];
    
    // 첫 번째 PDF를 사용하여 새로운 Merger 인스턴스 생성
    const merger = new groupdocs.merger.Merger(pdfPaths[0]);
    
    // 모든 추가 PDF 파일을 병합
    for (let i = 1; i < pdfPaths.length; i++) {
        await merger.join(pdfPaths[i]);
    }
    
    // 병합된 PDF의 출력 경로 정의
    const outputPath = `${groupdocs.outputFolder}/MergedMultiplePdfFiles.pdf`;
    
    // 지정된 출력 경로에 결과 저장
    await merger.save(outputPath);
    console.log(`여러 파일 병합 완료: ${outputPath}`);
}

// 사용 예
mergeMultiplePdfFiles(GroupDocs);

이 예제들은 GroupDocs.Merger for Node.js via Java를 사용하여 하나 이상의 PDF 문서를 효율적으로 병합하는 방법을 보여줍니다. 라이브러리의 유연성 덕분에 개발자는 특정 요구 사항에 맞게 병합 프로세스를 사용자 지정할 수 있습니다.

추가 자료

무료 평가판 다운로드 및 임시 라이센스 정보

GroupDocs.Merger for Node.js via Java를 시작하려면 releases.groupdocs.com에서 무료 평가판을 다운로드하십시오. 무료 평가판은 라이브러리의 기능을 제한 없이 탐색할 수 있도록 합니다.

제한 없이 라이브러리를 테스트하고 싶다면 이 링크를 방문하여 임시 라이센스를 획득할 수 있습니다. 임시 라이센스를 통해 평가 기간 동안 라이브러리를 완전히 활용할 수 있습니다.