Java PrintService 怎样查询打印属性的支持范围

Java PrintService查询打印属性时，应先区分类别、具体值和最终属性组合。用 isAttributeCategorySupported()询问类别，用 getSupportedAttributeValues()取得范围，用 isAttributeValueSupported()询问一个具体值；最终请求还可交给 getUnsupportedAttributes()识别不支持的属性。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/PrintService.html

把打印能力查询拆成三层

批量报表系统接入多台打印机时，最容易出现的误判是：界面发现“份数”类别，就允许用户输入任意份数；或者发现纸型、双面分别可用，就认为它们与当前文档格式组合后也一定可用。

一种更清楚的设计是把设备发现、选项展示与请求判断分开。先为选定服务显示候选项，在用户修改选项后按当前上下文重新询问。这里讨论架构取舍，不虚构某个企业的上线数据或性能提升。

先选择服务与文档格式

下面的完整示例只查询能力，不提交打印任务。使用Java Print Service API的运行环境需要提供java.desktop；可发现哪些服务取决于目标机器与打印服务提供者。本文未在本地连接打印机执行。

import javax.print.DocFlavor;
import javax.print.PrintService;
import javax.print.PrintServiceLookup;
import javax.print.attribute.Attribute;
import javax.print.attribute.AttributeSet;
import javax.print.attribute.HashPrintRequestAttributeSet;
import javax.print.attribute.standard.Copies;
import javax.print.attribute.standard.CopiesSupported;

public class PrintCapabilities {
    public static void main(String[] args) {
        // 示例限定为可打印对象格式；实际项目应选择自己的文档格式
        DocFlavor flavor = DocFlavor.SERVICE_FORMATTED.PRINTABLE;
        PrintService[] services =
                PrintServiceLookup.lookupPrintServices(flavor, null);
        if (services.length == 0) {
            System.out.println("没有发现支持该格式的打印服务");
            return;
        }

        // 示例选第一项；产品中应让用户确认目标服务
        PrintService service = services[0];
        System.out.println("服务：" + service.getName());
        if (!service.isDocFlavorSupported(flavor)) {
            System.out.println("当前服务不支持目标格式");
            return;
        }

        HashPrintRequestAttributeSet context =
                new HashPrintRequestAttributeSet();

        // 类别支持只说明可以询问份数，不能推出任意份数都可用
        boolean categoryOk =
                service.isAttributeCategorySupported(Copies.class);
        System.out.println("支持份数类别：" + categoryOk);
        if (categoryOk) {
            Object values = service.getSupportedAttributeValues(
                    Copies.class, flavor, context);
            // 不同类别返回形式不同，这里仅处理份数范围类型
            if (values instanceof CopiesSupported range) {
                System.out.println("份数范围：" + range);
            } else {
                System.out.println("范围对象：" + values);
            }
            boolean threeOk = service.isAttributeValueSupported(
                    new Copies(3), flavor, context);
            System.out.println("当前上下文支持三份：" + threeOk);
        }

        // 对实际准备提交的属性集合再做一次组合查询
        HashPrintRequestAttributeSet request =
                new HashPrintRequestAttributeSet();
        request.add(new Copies(3));
        AttributeSet unsupported =
                service.getUnsupportedAttributes(flavor, request);
        if (unsupported == null) {
            System.out.println("该请求组合没有报告不支持的属性");
        } else {
            for (Attribute attribute : unsupported.toArray()) {
                System.out.println("不可用属性："
                        + attribute.getCategory().getSimpleName()
                        + "=" + attribute);
            }
        }
    }
}

将代码保存为PrintCapabilities.java，再按项目通常的方式编译运行。不要为演示范围查询额外调用print；查询结果与设备真正完成任务是两个阶段。

查询类别、范围和具体值

示例里的Copies.class是类别，new Copies(3)是具体值，context是与查询一起提供的其他条件。getSupportedAttributeValues()返回Object，因此不能把所有类别的结果强制转换成同一种数组。枚举选项与整数范围应各自按属性类型处理。

在表单层，可以为“类别不可用”“当前上下文下无可选范围”“用户输入的值不可用”设计不同提示。这样比统一显示“打印机不支持”更容易定位问题。接口的上下文与返回形式定义见PrintService官方API。

对最终属性组合单独询问

用户确认选项后，再围绕实际request询问不支持项。返回null表示未报告不支持的属性，不应把null误写成查询失败；非空返回值则用于向用户解释哪些选项需要调整。

产品策略要明确哪些要求可以降级。例如用户选择三份时，不能在没有提示的情况下自动删除份数要求。示例只输出不可用项，把替代策略留给业务层，而不是悄悄改变请求。

为批量打印保留失败原因

面向多台设备时，我会为查询记录服务名、文档格式、请求属性与不支持项，并在设备或请求变化后重新取值。发现服务与读取能力可能有环境开销，避免让每次无关的界面重绘都触发全量发现。

能力数据若做缓存，应把服务与查询上下文纳入缓存设计，并保留重新查询入口；不能把某台打印机某次的范围当成所有设备通用配置。真正接入批量打印后，还需单独收集提交失败与任务反馈，不用能力查询代替运行记录。

支持Copies类别就一定支持三份吗？

不能这样推断。先问类别，再在当前格式与属性上下文里问具体值。

为什么范围结果不是统一的数组？

不同属性表达支持范围的方式不同，示例对份数使用CopiesSupported分支；扩展纸型等类别时应分别处理。

组合查询通过就表示纸张已经打印出来吗？

它回答请求规格的支持情况。任务提交、设备运行与完成反馈仍需分别处理。