如何用iText与Java流式编辑PDF并打包Zip后下载？

嘿，刚好帮你把iText的PDF文本添加步骤整合到现有的流式压缩下载流程里！既然文件只有20-50KB，完全不用纠结内存问题，直接在内存里处理就行。下面是具体的实现思路和代码示例：

在你把原始PDF喂给Zip压缩流程之前，先通过iText加载PDF并添加文本，然后把编辑后的PDF内容（不管是字节数组还是直接流式输出）传给压缩逻辑，最后打包成Zip给客户端下载。

如果你用Maven，记得在pom.xml里加（版本可以用最新稳定版）：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>kernel</artifactId>
    <version>8.0.2</version>
</dependency>
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>layout</artifactId>
    <version>8.0.2</version>
</dependency>

这个方法负责接收原始PDF的字节数组，添加指定文本后返回编辑后的输入流（或者直接写入Zip流）：

import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.properties.TextAlignment;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;

public class PdfEditorHelper {
    public static ByteArrayInputStream addCustomTextToPdf(byte[] originalPdf, String text) throws IOException {
        ByteArrayOutputStream editedOut = new ByteArrayOutputStream();
        
        // 初始化iText的PDF文档对象，用try-with-resources自动关闭资源
        try (PdfReader reader = new PdfReader(new ByteArrayInputStream(originalPdf));
             PdfWriter writer = new PdfWriter(editedOut);
             PdfDocument pdfDoc = new PdfDocument(reader, writer);
             Document document = new Document(pdfDoc)) {
            
            // 自定义文本样式和位置：这里设置在左下角，靠右对齐，字体12号
            Paragraph textPara = new Paragraph(text)
                    .setFontSize(12)
                    .setTextAlignment(TextAlignment.RIGHT)
                    .setFixedPosition(20, 20, 250); // x=20, y=20（PDF原点在左下角），宽度250
            
            document.add(textPara);
        }
        
        return new ByteArrayInputStream(editedOut.toByteArray());
    }
}

假设你原来的代码是先拿到原始PDF字节数组，再压缩成Zip。现在只需要插入编辑步骤：

// 1. 获取原始PDF字节数组（你的原有逻辑）
byte[] originalPdfBytes = getOriginalPdfFromSource(); // 比如从数据库/文件系统获取

// 2. 编辑PDF：添加文本
byte[] editedPdfBytes = null;
try (ByteArrayInputStream editedStream = PdfEditorHelper.addCustomTextToPdf(originalPdfBytes, "用户自定义的水印/文本")) {
    editedPdfBytes = editedStream.readAllBytes();
} catch (IOException e) {
    e.printStackTrace();
    // 这里可以给客户端返回错误信息，比如"PDF编辑失败"
    return;
}

// 3. 执行你原来的流式压缩下载逻辑（用editedPdfBytes替换原来的originalPdfBytes）
streamZipToClient(editedPdfBytes, "edited_pdf.pdf");

如果想避免中间字节数组，直接把编辑后的PDF写入Zip流，性能更好（虽然小文件差别不大，但代码更优雅）：

// 直接在Zip流中处理PDF编辑和压缩
try (ByteArrayOutputStream zipOutput = new ByteArrayOutputStream();
     ZipOutputStream zipStream = new ZipOutputStream(zipOutput)) {
    
    // 创建Zip条目
    ZipEntry pdfEntry = new ZipEntry("edited_document.pdf");
    zipStream.putNextEntry(pdfEntry);
    
    // 加载原始PDF并编辑，直接写入Zip流
    try (PdfReader reader = new PdfReader(new ByteArrayInputStream(originalPdfBytes));
         PdfWriter writer = new PdfWriter(zipStream); // 直接输出到Zip流
         PdfDocument pdfDoc = new PdfDocument(reader, writer);
         Document document = new Document(pdfDoc)) {
        
        // 添加自定义文本
        document.add(new Paragraph("这是添加的文本")
                .setFontSize(14)
                .setTextAlignment(TextAlignment.CENTER)
                .setFixedPosition(100, 500, 400));
    }
    
    zipStream.closeEntry();
    
    // 把Zip文件输出给客户端
    response.setContentType("application/zip");
    response.setHeader("Content-Disposition", "attachment; filename=edited_pdf.zip");
    response.getOutputStream().write(zipOutput.toByteArray());
} catch (IOException e) {
    // 异常处理逻辑
}

• PDF的坐标系统：原点在左下角，x向右递增，y向上递增，所以设置位置时要注意
• 资源关闭：用try-with-resources自动关闭iText的各种文档对象，避免内存泄漏
• 文本样式：可以自定义字体、颜色、大小、对齐方式，根据你的业务需求调整

内容的提问来源于stack exchange，提问作者jsPlayer