Como mesclar dois arquivos PDF usando Java

Renderizando Seções HTML Antes de Mesclar

O exemplo abaixo renderiza duas strings HTML separadas na memória e as combina em um único documento. Este padrão funciona bem para geradores de relatórios, criadores de faturas e qualquer sistema onde o conteúdo é montado programaticamente a partir de modelos ou linhas de banco de dados.

```java {title="Mesclar PDFs Gerados Dinamicamente"} //:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-html-pdfs.java import IronPDF; import java.io.IOException; importação java.nio.file.Paths;

public class Main { public static void main(String[] args) throws IOException { // Conteúdo HTML para cada seção do documento String htmlA = "

Primeira parte do relatório.

Segunda parte do relatório.

// Renderizar cada string HTML como um PDF na memória -- sem necessidade de gravações no disco PdfDocument pdfA = PdfDocument.renderHtmlAsPdf(htmlA); PdfDocument pdfB = PdfDocument.renderHtmlAsPdf(htmlB);

// Mesclar ambos os documentos em um único PDF combinado PdfDocument merged = PdfDocument.merge(pdfA, pdfB);

// Salvar o resultado mesclado merged.saveAs(Paths.get("assets/merged.pdf")); } }

A saída mesclada concatena páginas na ordem dos argumentos: as páginas `pdfA` aparecem antes das páginas `pdfB`. Para um guia completo do mecanismo de renderização HTML, veja o [tutorial de IronPDF HTML para PDF for Java](https://ironpdf.com/java/tutorials/html-to-pdf/).

![Visualizador de PDF mostrando documentos mesclados com sucesso - primeiro PDF à esquerda, segundo PDF à direita com controles de navegação](/static-assets/ironpdf-java/howto/how-to-merge-two-pdf-files-java-tutorial/how-to-merge-two-pdf-files-java-tutorial-5.webp)

ImportanteA chamada `renderHtmlAsPdf()` usa um mecanismo de renderização baseado em Chromium. CSS completo, fontes da web e imagens inline são todos suportados -- a saída corresponde ao que um navegador exibiria.

## Como Mesclar Arquivos PDF Existentes?

Carregar PDFs do disco e mesclá-los segue o mesmo padrão, usando `PdfDocument.fromFile()` para ler cada arquivo na memória antes de passar os objetos para `merge()`.

Esta abordagem se adapta a qualquer fluxo de trabalho onde os documentos de origem já existam -- faturas digitalizadas, relatórios exportados ou arquivos recebidos de um sistema externo. O IronPDF lê a estrutura do PDF e mescla páginas sem alterar os arquivos de origem originais.

### Carregando e Combinando Arquivos do Disco

```java {title="Mesclar Arquivos PDF Existentes do Disco"}
//:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-existing-files.java
import IronPDF;
import java.io.IOException;
importação java.nio.file.Paths;

public class Main {
    public static void main(String[] args) throws IOException {
// Carregar dois arquivos PDF existentes do disco
PdfDocument pdfA = PdfDocument.fromFile(Paths.get("assets/invoice-january.pdf"));
PdfDocument pdfB = PdfDocument.fromFile(Paths.get("assets/invoice-february.pdf"));

// Combinar em um documento
PdfDocument merged = PdfDocument.merge(pdfA, pdfB);

// Escrever a saída mesclada -- originais não são alterados
merged.saveAs(Paths.get("assets/invoices-q1.pdf"));
    }
}

A chamada merge() produz um novo objeto PdfDocument; nem pdfA nem pdfB é modificado. Para reverter a operação -- extraindo páginas novamente -- consulte o exemplo de divisão de PDFs for Java.

Quais Formatos de Arquivo o fromFile() Aceita?

PdfDocument.fromFile() aceita arquivos padrão .pdf. Para documentos que precisam ser convertidos antes da mesclagem -- como arquivos HTML, arquivos de imagem ou outros formatos -- use o método de renderização apropriado (renderHtmlAsPdf(), renderUrlAsPdf()) primeiro para produzir um PdfDocument, em seguida, passe esse objeto para merge().

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Padrões Baseados em Varargs e Lista

Os dois padrões abaixo produzem resultados idênticos. Escolha a chamada direta de varargs quando a contagem de arquivos estiver fixada, e o padrão lista-para-array quando você estiver construindo a coleção programaticamente:

```java {title="Mesclar Quatro PDFs -- Abordagens com Varargs e Lista"} //:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-multiple-files.java import IronPDF; import java.io.IOException; importação java.nio.file.Paths; import java.util.ArrayList; import java.util.List;

public class Main { public static void main(String[] args) throws IOException { // Carregar quatro arquivos PDF existentes 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"));

// Padrão 1: chamada direta de varargs -- funciona bem para um número fixo de arquivos PdfDocument merged = PdfDocument.merge(pdfA, pdfB, pdfC, pdfD); merged.saveAs(Paths.get("assets/full-document.pdf"));

// Padrão 2: construir uma lista primeiro -- preferido quando a contagem de arquivos é dinâmica List pdfList = new ArrayList<>(); 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("assets/full-document-v2.pdf")); } }

ImportanteA ordem das páginas na saída corresponde exatamente à ordem dos argumentos. Se a sequência do documento for importante -- por exemplo, capítulos de um livro ou seções de formulário ordenadas -- classifique sua lista antes de chamar `merge()`.

### Como Posso Escanear um Diretório e Mesclar Todos os PDFs?

Quando o conjunto de arquivos de entrada não é conhecido no momento da compilação, ler caminhos de arquivos de um diretório é uma extensão natural do padrão de lista. O trecho abaixo coleta todos os arquivos `.pdf` de uma pasta, classifica-os pelo nome do arquivo e os mescla em ordem.

```java {title="Scanear um Diretório e Mesclar Todos os Arquivos PDF"}
//:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-directory-pdfs.java
import IronPDF;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
importação 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");

// Coletar todos os arquivos PDF do diretório, classificados por nome de arquivo
List<Path> pdfPaths = Files.list(inputDir)
.filter(p -> p.toString().endsWith(".pdf"))
.sorted(Comparator.comparing(Path::getFileName))
.collect(Collectors.toList());

// Carregar cada arquivo em um PdfDocument
List<PdfDocument> documents = new ArrayList<>();
for (Path path : pdfPaths) {
documents.add(PdfDocument.fromFile(path));
        }

// Mesclar todos os documentos e salvar o resultado
PdfDocument combined = PdfDocument.merge(
documents.toArray(new PdfDocument[0])
);
combined.saveAs(Paths.get("assets/annual-report.pdf"));
    }
}

Este padrão lida com qualquer tamanho de pasta. Para grandes lotes (50+ arquivos), considere carregar e mesclar em fatias para limitar o uso máximo de memória em vez de carregar todos os arquivos simultaneamente.

Após a mesclagem, você pode querer refinar o documento combinado ainda mais. IronPDF for Java suporta adicionar cabeçalhos e rodapés personalizados, aplicar marcas d'água e comprimir a saída final para reduzir o tamanho do arquivo antes da entrega.