Java 将图片转换为 pdf（使用 pdfbox、itext）

---

一、简介

pdfbox 是一种 Java pdf 库，提供了广泛的 pdf 操作功能，包括文本、表格、图像、水印、数字签名等。

itext 是一种流行的开源 java pdf 库，提供了丰富的 pdf 操作功能，包括文本、表格、图像、水印、数字签名等。

二、使用 pdfbox

1. pom 依赖

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>fontbox</artifactId>
    <version>2.0.12</version>
</dependency>
<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.12</version>
</dependency>

2. 转换方法

public static byte[] getPdfBytes(MultipartFile[] imagesFiles) throws IOException {
    PDDocument document = new PDDocument();
    for (MultipartFile datum : imagesFiles) {
        String filename = datum.getOriginalFilename();
        String fileSuffix = filename.substring(filename.lastIndexOf(".") + 1);
        Iterator readers = ImageIO.getImageReadersByFormatName(fileSuffix);
        ImageReader reader = (ImageReader) readers.next();
        ImageInputStream input = ImageIO.createImageInputStream(datum.getInputStream());
        reader.setInput(input, true);
        int width = reader.getWidth(0);
        int height = reader.getHeight(0);
        PDPage pdPage = new PDPage(new PDRectangle(width, height));
        document.addPage(pdPage);
        PDImageXObject pdImageXObject = PDImageXObject.createFromByteArray(document, datum.getBytes(), "构建图片错误");
        //如果没有文件的字节数组,也可以用下面这个
        //String imagePath = "/test";
        //PDImageXObject pdImageXObject = PDImageXObject.createFromFile(imagePath, document);
        //如果只有url，可以用hutool包的HttpUtil方法下载下来，得到的结果是字节数组，不过会耗时长
        PDPageContentStream contentStream = new PDPageContentStream(document, pdPage);
        //写入图片
        contentStream.drawImage(pdImageXObject, 0, 0);
        contentStream.close();
    }
    ByteArrayOutputStream output = new ByteArrayOutputStream();
    document.save(output);
    document.close();
    return output.toByteArray();
}

三、使用 itext

1. pom 依赖

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itextpdf</artifactId>
    <version>5.5.1</version>
</dependency>
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-asian</artifactId>
    <version>5.2.0</version>
</dependency>

2. 转换方法

/**
 * 将多个图片文件合并成一张长图
 *
 * @param imageFiles      图片文件列表
 * @param mergedImageFile 合并后的长图文件
 * @throws Exception
 */
public static void mergeImages(List<String> imageFiles, String mergedImageFile) throws Exception {
    BufferedImage mergedImage = null;
    int heightTotal = 0;
    int maxWidth = 0;
    for (String imageFile : imageFiles) {
        BufferedImage image = ImageIO.read(new File(imageFile));
        //图片大小不保持一致需要把这个判断注释掉，不然会出现黑框
//            if (image.getWidth() > maxWidth) {
        maxWidth = image.getWidth();
//            }
        heightTotal += image.getHeight();
    }
    mergedImage = new BufferedImage(maxWidth, heightTotal, BufferedImage.TYPE_INT_RGB);
    int offsetY = 0;
    for (String imageFile : imageFiles) {
        BufferedImage image = ImageIO.read(new File(imageFile));
        mergedImage.getGraphics().drawImage(image, 0, offsetY, null);
        offsetY += image.getHeight();
    }
    ImageIO.write(mergedImage, "jpg", new File(mergedImageFile));
}

/**
 * 将长图文件转换为PDF文件
 *
 * @param mergedImageFile 长图文件
 * @param pdfFile         PDF文件
 * @throws Exception
 */
public static void createPDF(String mergedImageFile, String pdfFile) throws Exception {
    //获取下图片的大小，图片的大小就是document的大小（建议图片就是A4纸的大小就行）
    Image image = Image.getInstance(mergedImageFile);
    com.itextpdf.text.Rectangle rectangle = new Rectangle(image.getWidth(), image.getHeight());

    Document document = new Document(rectangle, 0, 0, 0, 0);
    // 创建PdfWriter对象
    PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream(pdfFile));
    // 打开文档
    document.open();
    // 获取PdfContentByte对象
    PdfContentByte cb = writer.getDirectContent();
    image.scaleToFit(document.getPageSize().getWidth(), document.getPageSize().getHeight());
    // 设置图片位置
    image.setAbsolutePosition(0, 0);
    // 添加图片到PdfContentByte对象
    cb.addImage(image);
    // 关闭文档
    document.close();
}

使用方式：

public static void main(String[] args) throws Exception {
    List<String> imageFiles = new ArrayList<>();
    for (int i = 0; i < 9; i++) {
        imageFiles.add("E:/转换文件/" + i + ".png");
    }
    mergeImages(imageFiles, "E:/合并的图片.jpg");
    createPDF("E:/合并的图片.jpg", "E:/合并的pdf.pdf");
}