如何在Linux/CUPS环境下用Java结合IPP限制打印页数？

问题原因分析 #

在Linux环境下，Java Print Service（JPS）通过DocFlavor.INPUT_STREAM.AUTOSENSE处理PDF时，可能无法正确解析文档结构并传递PageRanges属性到打印机驱动——即便打印机本身支持该属性。这种情况多因JVM依赖系统打印过滤处理自动识别的文档类型，导致页面范围设置被忽略。

可行解决方案 #

1. 明确指定PDF文档类型 #

将DocFlavor从AUTOSENSE改为BYTE_ARRAY.PDF，让JPS明确识别文档类型，修复属性传递逻辑：

public class Main {
    public static void main(String[] args) throws FileNotFoundException, PrintException, IOException {
        JFileChooser fileChooser = new JFileChooser();
        int result = fileChooser.showOpenDialog(null);

        if (result == JFileChooser.APPROVE_OPTION) {
            File file = fileChooser.getSelectedFile();
            byte[] pdfBytes = Files.readAllBytes(file.toPath());
            
            // 明确指定PDF文档类型
            DocFlavor flavor = DocFlavor.BYTE_ARRAY.PDF;
            Doc doc = new SimpleDoc(pdfBytes, flavor, null);
            
            PrintService ps = PrintServiceLookup.lookupDefaultPrintService();
            DocPrintJob printJob = ps.createPrintJob();

            PrintRequestAttributeSet attributeSet = new HashPrintRequestAttributeSet();
            attributeSet.add(new PageRanges(1));
            printJob.print(doc, attributeSet);
        }
    }
}

2. 使用PDF处理库提取指定页面后打印 #

若上述方法无效，可借助Apache PDFBox先提取目标页面生成新PDF，再进行打印，从根源确保只传递需要的页面：
先添加PDFBox Maven依赖：

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.32</version>
</dependency>

然后使用以下代码：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import javax.print.*;
import javax.print.attribute.HashPrintRequestAttributeSet;
import javax.swing.JFileChooser;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException, PrintException {
        JFileChooser fileChooser = new JFileChooser();
        int result = fileChooser.showOpenDialog(null);

        if (result == JFileChooser.APPROVE_OPTION) {
            File file = fileChooser.getSelectedFile();
            try (PDDocument originalDoc = PDDocument.load(file)) {
                try (PDDocument targetDoc = new PDDocument()) {
                    // PDFBox页码从0开始，这里提取第1页
                    PDPage page = originalDoc.getPage(0);
                    targetDoc.addPage(page);
                    
                    ByteArrayOutputStream baos = new ByteArrayOutputStream();
                    targetDoc.save(baos);
                    byte[] targetBytes = baos.toByteArray();
                    
                    DocFlavor flavor = DocFlavor.BYTE_ARRAY.PDF;
                    Doc doc = new SimpleDoc(targetBytes, flavor, null);
                    
                    PrintService ps = PrintServiceLookup.lookupDefaultPrintService();
                    DocPrintJob printJob = ps.createPrintJob();
                    
                    // 已提取目标页面，可省略PageRanges设置
                    PrintRequestAttributeSet attributeSet = new HashPrintRequestAttributeSet();
                    printJob.print(doc, attributeSet);
                }
            }
        }
    }
}

3. 直接使用IPP协议发送请求 #

若JPS始终无法正确传递属性，可使用IPP客户端库（如ipp-client-kotlin）或手动构造IPP请求，直接向打印机发送包含page-ranges属性的指令，绕过JPS中间处理层。

官方文档说明翻译 #

IPP兼容性：PageRanges属性的规范数组形式为IPP"page-ranges"属性中每个要包含的页面范围提供上下边界。有关规范数组形式的说明，请参阅SetOfIntegerSyntax类。getName()返回的类别名称即为IPP属性名称。

内容的提问来源于stack exchange，提问作者Thiago Sayão