Combinar archivos PDF en Java

Aspose.PDF for Java admite varias estrategias de fusión dependiendo de cómo se debe ensamblar la salida.

Combinar dos documentos PDF

Utilice este enfoque cuando necesite el flujo de combinación más sencillo y quiera añadir un documento completo a otro.

  1. Abra ambos PDF de origen Document objetos.
  2. Agregue la colección Page del segundo documento al primer documento.
  3. Guarde el PDF actualizado Document.
public static void mergeTwoDocuments(Path inputFile1, Path inputFile2, Path outputFile) {
    try (Document document1 = new Document(inputFile1.toString());
         Document document2 = new Document(inputFile2.toString())) {
        document1.getPages().add(document2.getPages());
        document1.save(outputFile.toString());
    }
}

Copiar un rango de páginas seleccionado entre documentos

Este método auxiliar mantiene la lógica de fusión de rangos de página en un solo lugar para que otros ejemplos puedan reutilizar la misma rutina de copia validada.

  1. Abra o recibir el PDF de origen y destino Document objetos.
  2. Normalice el rango de páginas solicitado para que se mantenga dentro de la colección Page disponible.
  3. Agregue cada página del rango validado al documento de destino.
private static void appendPageRange(Document sourceDocument, Document destinationDocument, int startPage, int endPage) {
    int totalPages = sourceDocument.getPages().size();
    if (totalPages == 0) {
        return;
    }

    int start = Math.max(1, startPage);
    int end = Math.min(endPage, totalPages);
    if (start > end) {
        return;
    }

    for (int pageNumber = start; pageNumber <= end; pageNumber++) {
        destinationDocument.getPages().add(sourceDocument.getPages().get_Item(pageNumber));
    }
}

Combinar varios documentos PDF en un solo archivo

Utilice este patrón cuando necesite combinar una lista de archivos de entrada en un solo documento de salida en secuencia.

  1. Cree un PDF de salida vacío Document.
  2. Abra cada archivo de entrada uno a la vez y copie su totalidad Page rango en el documento de salida.
  3. Guarde el resultado combinado después de que se hayan procesado todos los archivos fuente.
public static void mergeMultipleDocuments(List<Path> inputFiles, Path outputFile) {
    try (Document outputDocument = new Document()) {
        for (Path inputFile : inputFiles) {
            try (Document sourceDocument = new Document(inputFile.toString())) {
                appendPageRange(sourceDocument, outputDocument, 1, sourceDocument.getPages().size());
            }
        }
        outputDocument.save(outputFile.toString());
    }
}

Combinar los rangos de páginas seleccionados de dos documentos

Este ejemplo crea un archivo de salida personalizado tomando solo rangos de página específicos de cada documento de origen.

  1. Abra ambos PDF de origen Document objetos y cree un nuevo documento de salida.
  2. Agregue solo lo necesario Page rango de cada documento fuente.
  3. Guarde el documento de salida ensamblado.
public static void mergeSelectedPageRanges(Path inputFile1, Path inputFile2, Path outputFile) {
    try (Document document1 = new Document(inputFile1.toString());
         Document document2 = new Document(inputFile2.toString());
         Document outputDocument = new Document()) {
        appendPageRange(document1, outputDocument, 1, 2);
        appendPageRange(document2, outputDocument, 2, 3);
        outputDocument.save(outputFile.toString());
    }
}

Insertar un documento PDF dentro de otro en una posición específica

Utiliza este enfoque cuando un documento debe aparecer dentro de otro en lugar de solo antes o después de él.

  1. Abra el PDF base y el PDF insertado Document objetos y cree un nuevo documento de salida.
  2. Copie la primera parte del documento base, luego añada el documento insertado completo y, finalmente, añada el resto del documento base. Page rango.
  3. Guarde el resultado reordenado en un nuevo archivo.
public static void mergeInsertDocumentAtPosition(Path inputFile1, Path inputFile2, int insertAfterPage, Path outputFile) {
    try (Document baseDocument = new Document(inputFile1.toString());
         Document insertDocument = new Document(inputFile2.toString());
         Document outputDocument = new Document()) {
        int baseTotalPages = baseDocument.getPages().size();
        int insertIndex = Math.max(0, Math.min(insertAfterPage, baseTotalPages));

        appendPageRange(baseDocument, outputDocument, 1, insertIndex);
        appendPageRange(insertDocument, outputDocument, 1, insertDocument.getPages().size());
        appendPageRange(baseDocument, outputDocument, insertIndex + 1, baseTotalPages);

        outputDocument.save(outputFile.toString());
    }
}

Combinar dos documentos PDF alternando páginas

Este ejemplo entrelaza páginas de dos documentos, lo cual es útil cuando ambos insumos deben contribuir página por página al resultado final.

  1. Abra ambos PDF de origen Document objetos y cree un nuevo documento de salida.
  2. Itere a través del recuento máximo de páginas disponible y agregue cada una disponible Page del primer y segundo documento por turno.
  3. Guarde el documento de salida entrelazado.
public static void mergeAlternatingPages(Path inputFile1, Path inputFile2, Path outputFile) {
    try (Document document1 = new Document(inputFile1.toString());
         Document document2 = new Document(inputFile2.toString());
         Document outputDocument = new Document()) {
        int document1Pages = document1.getPages().size();
        int document2Pages = document2.getPages().size();
        int maxPages = Math.max(document1Pages, document2Pages);

        for (int pageNumber = 1; pageNumber <= maxPages; pageNumber++) {
            if (pageNumber <= document1Pages) {
                outputDocument.getPages().add(document1.getPages().get_Item(pageNumber));
            }
            if (pageNumber <= document2Pages) {
                outputDocument.getPages().add(document2.getPages().get_Item(pageNumber));
            }
        }

        outputDocument.save(outputFile.toString());
    }
}

Combinar documentos con páginas separadoras y marcadores

Utilice este patrón cuando el archivo combinado deba seguir siendo fácil de navegar y mostrar claramente dónde comienza cada documento fuente.

  1. Cree un PDF de salida vacío Document y abra cada archivo fuente a su vez.
  2. Agregue un separador Page con un encabezado, luego crear un OutlineItemCollection marcador para esa sección.
  3. Agregue las páginas de origen, opcionalmente añada un marcador que apunte a la primera página de contenido, y guarde el documento final combinado.
public static void mergeWithSectionSeparatorsAndBookmarks(List<Path> inputFiles, Path outputFile) {
    try (Document outputDocument = new Document()) {
        int sectionIndex = 1;
        for (Path inputFile : inputFiles) {
            try (Document sourceDocument = new Document(inputFile.toString())) {
                int sourcePageCount = sourceDocument.getPages().size();

                Page separatorPage = outputDocument.getPages().add();
                separatorPage.getParagraphs().add(new TextFragment(
                        "Section " + sectionIndex + ": " + inputFile.getFileName()));

                OutlineItemCollection sectionBookmark = new OutlineItemCollection(outputDocument.getOutlines());
                sectionBookmark.setTitle("Section " + sectionIndex);
                sectionBookmark.setAction(new GoToAction(separatorPage));
                outputDocument.getOutlines().add(sectionBookmark);

                int firstContentPageNumber = outputDocument.getPages().size() + 1;
                appendPageRange(sourceDocument, outputDocument, 1, sourcePageCount);

                if (sourcePageCount > 0 && firstContentPageNumber <= outputDocument.getPages().size()) {
                    OutlineItemCollection contentBookmark = new OutlineItemCollection(outputDocument.getOutlines());
                    contentBookmark.setTitle("Section " + sectionIndex + " Content");
                    contentBookmark.setAction(new GoToAction(outputDocument.getPages().get_Item(firstContentPageNumber)));
                    sectionBookmark.add(contentBookmark);
                }
            }
            sectionIndex++;
        }

        outputDocument.save(outputFile.toString());
    }
}
Optimizar archivos PDF en Java Dividir archivos PDF en Java