按页添加类型（非格式）生成PDF文件的技术方案咨询

一、存储页面类型的最佳PDF字段 #

PDF标准里有几个原生字段适合用来标记页面类型，优先用标准字段保证兼容性：

1. MediaClass（PDF 1.7+）：属于页面属性字典（/PA）的键，用来定义媒体分类，比如/Plain对应普通纸、/Stationery对应专用信纸，你可以自定义符合打印机配置的分类名称，比如/SignArchivePaper。
2. MediaName：同样在页面属性字典里，用来指定具体媒体名称，很多打印机支持通过这个字段映射到预设纸盘（比如打印机端配置的“归档专用纸盘”对应/ArchiveTray）。
3. 自定义字典条目：如果标准字段不够用，可以在页面的/Resources字典或单独的/PieceInfo里添加自定义键（比如/OfficePageType），值设为字符串（如"Normal"/"SignRequired"），但需要打印端的解析逻辑配合识别。

二、可用的Java库实现 #

1. Apache PDFBox #

PDFBox可直接操作PDF页面的属性字典，设置媒体类或自定义字段：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.common.PDPageAttributes;
import org.apache.pdfbox.pdmodel.graphics.PDMediaClass;
import org.apache.pdfbox.pdmodel.graphics.PDMediaName;

import java.io.File;
import java.io.IOException;

public class PageTypeMarker {
    public static void main(String[] args) throws IOException {
        try (PDDocument document = PDDocument.load(new File("multi-page.pdf"))) {
            // 标记第一页为普通纸
            PDPage normalPage = document.getPage(0);
            PDPageAttributes normalAttrs = normalPage.getAttributes();
            normalAttrs.setMediaClass(PDMediaClass.PLAIN);
            
            // 标记第二页为归档签署用纸
            PDPage signPage = document.getPage(1);
            PDPageAttributes signAttrs = signPage.getAttributes();
            signAttrs.setMediaName(new PDMediaName("SignArchivePaper"));
            
            document.save("marked-document.pdf");
        }
    }
}

2. iText 7 #

iText 7提供更灵活的PDF对象操作，直接修改页面字典的属性：

import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfName;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.kernel.pdf.PdfDictionary;

import java.io.IOException;

public class ITextPageTypeSetter {
    public static void main(String[] args) throws IOException {
        try (PdfDocument pdfDoc = new PdfDocument(new PdfReader("input.pdf"), new PdfWriter("output.pdf"))) {
            // 给第三页添加自定义页面类型标记
            PdfPage page = pdfDoc.getPage(2);
            PdfDictionary pageDict = page.getPdfObject();
            PdfDictionary pageAttrs = pageDict.getAsDictionary(PdfName.PA);
            if (pageAttrs == null) {
                pageAttrs = new PdfDictionary();
                pageDict.put(PdfName.PA, pageAttrs);
            }
            pageAttrs.put(new PdfName("OfficePageType"), new PdfName("SignRequired"));
        }
    }
}

三、其他可行解决方案 #

• 打印作业级配置：不修改PDF本身，通过Java的javax.print API构建打印作业，针对每页设置打印属性（比如Media属性指定纸盘）。这种方式不需要修改PDF，但需要提前知道每页的类型映射：

  // 示例：给指定页面设置纸盘
  PrintRequestAttributeSet attrs = new HashPrintRequestAttributeSet();
  attrs.add(new MediaPrintableArea(MediaSizeName.ISO_A4, 0, 0, 210, 297, MediaPrintableArea.MM));
  attrs.add(new Media(MediaName.MEDIA_NAME, "SignArchiveTray"));
  // 提交打印作业时指定每页的属性（需分页处理）
  

• 内容标记辅助：在页面的隐藏层或角落添加不可见的标记（比如特定字符串或二维码），打印前通过程序识别标记，再调用打印驱动设置对应参数。这种方式兼容性好，但需要额外的识别逻辑。
• 多文档合并打印：将不同类型的页面分别生成独立PDF，然后按顺序提交打印，每个PDF指定对应的打印配置。适合不需要单文档输出的场景。

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