当前位置：首页 > 文章列表 > 文章 > java教程 > Java PrintService 怎样查询打印属性的支持范围

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

来源：17golang原创 2026-10-30 17:26:58 0浏览收藏

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

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

把打印能力查询拆成三层

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

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

层次	问题	接口示例
类别	能否指定份数	isAttributeCategorySupported
范围与单值	允许哪些份数、三份是否可用	getSupportedAttributeValues / isAttributeValueSupported
最终组合	本次完整请求有哪些属性不可用	getUnsupportedAttributes

先选择服务与文档格式

下面的完整示例只查询能力，不提交打印任务。使用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；查询结果与设备真正完成任务是两个阶段。