Извлечение вложений из PDF

Aspose.PDF for Java поддерживает несколько вариантов извлечения в зависимости от того, как вложения хранятся в документе.

Извлечение отдельного вложения по имени

Используйте этот пример, когда необходимо сохранить один конкретный встроенный файл из PDF.

1. Откройте исходный PDF в объекте Document.
2. Переберите коллекцию встроенных файлов, пока не будет найдено требуемое имя вложения.
3. Скопируйте поток вложения в выходной файл и прекратите выполнение после извлечения.

public static void extractSingleAttachment(Path inputFile, String attachmentName, Path outputFile) throws Exception {
    try (Document document = new Document(inputFile.toString())) {
        System.out.println("Extracting attachment: " + attachmentName);

        boolean attachmentFound = false;
        for (FileSpecification fileSpecification : document.getEmbeddedFiles()) {
            if (attachmentName.equals(fileSpecification.getName())) {
                try (InputStream inputStream = fileSpecification.getContents();
                     OutputStream outputStream = Files.newOutputStream(outputFile)) {
                    inputStream.transferTo(outputStream);
                }
                System.out.println("Attachment extracted successfully");
                attachmentFound = true;
                break;
            }
        }

        if (!attachmentFound) {
            throw new IllegalArgumentException("Attachment '" + attachmentName + "' not found in PDF");
        }
    }
}

Вывод параметров встроенного файла

Этот вспомогательный метод выводит метаданные, хранящиеся в объекте FileParams.

1. Проверьте, существует ли объект параметров файла.
2. Прочитайте доступные значения контрольной суммы, даты создания, даты изменения и размера.
3. Выведите значения в консоль.

public static void printFileParams(FileParams params) {
    if (params != null) {
        try {
            System.out.println("CheckSum: " + params.getCheckSum());
        } catch (Exception ex) {
            System.out.println("CheckSum: null");
        }
        System.out.println("Creation Date: " + params.getCreationDate());
        System.out.println("Modification Date: " + params.getModDate());
        System.out.println("Size: " + params.getSize());
    }
}

Извлечение всех вложений

Используйте этот пример, когда каждый вложенный файл в PDF должен быть записан в выходной каталог.

1. Откройте исходный PDF в объекте Document.
2. Пройдите по коллекции вложенных файлов и определите безопасное имя выходного файла для каждого элемента.
3. Выведите метаданные, сохраните каждый поток вложения и продолжайте, пока не будут экспортированы все файлы.

public static void extractAttachments(Path inputFile, Path outputDir) throws Exception {
    try (Document document = new Document(inputFile.toString())) {
        System.out.println("Total files: " + document.getEmbeddedFiles().size());

        int fileIndex = 1;
        for (FileSpecification fileSpecification : document.getEmbeddedFiles()) {
            String fileName = fileSpecification.getName();
            if (fileName == null || fileName.isBlank()) {
                fileName = fileSpecification.getUnicodeName();
            }
            if (fileName == null || fileName.isBlank()) {
                fileName = "attachment_" + fileIndex + ".bin";
            }

            System.out.println("Name: " + fileName);
            System.out.println("Description: " + fileSpecification.getDescription());
            System.out.println("Mime Type: " + fileSpecification.getMIMEType());
            printFileParams(fileSpecification.getParams());

            Path outputPath = outputDir.resolve(fileName);
            try (InputStream inputStream = fileSpecification.getContents();
                 OutputStream outputStream = Files.newOutputStream(outputPath)) {
                inputStream.transferTo(outputStream);
            }
            fileIndex++;
        }
    }
}

Извлечение аннотации вложения файла

Используйте этот пример, когда файл прикреплен через аннотацию страницы, а не только через коллекцию вложенных файлов.

1. Откройте исходный PDF в объекте Document.
2. Найдите первую аннотацию FileAttachmentAnnotation на странице.
3. Прочитайте её спецификацию файла, экспортируйте содержимое и выведите путь назначения.

public static void extractFileAttachmentAnnotation(Path inputFile, Path outputDir) throws Exception {
    try (Document document = new Document(inputFile.toString())) {
        FileAttachmentAnnotation fileAttachment = null;
        for (Annotation annotation : document.getPages().get_Item(1).getAnnotations()) {
            if (annotation.getAnnotationType() == AnnotationType.FileAttachment) {
                fileAttachment = (FileAttachmentAnnotation) annotation;
                break;
            }
        }

        if (fileAttachment == null) {
            System.out.println("File attachment annotation not found.");
            return;
        }

        FileSpecification fileSpecification = fileAttachment.getFile();
        System.out.println("File name: " + fileSpecification.getName());

        Path outputPath = outputDir.resolve("extracted-" + fileSpecification.getName());
        try (InputStream inputStream = fileSpecification.getContents();
             OutputStream outputStream = Files.newOutputStream(outputPath)) {
            inputStream.transferTo(outputStream);
        }

        System.out.println("Extracted to: " + outputPath);
    }
}