Module  java.desktop
软件包  javax.print.attribute.standard

Class Destination

  • All Implemented Interfaces:
    Serializable ， Cloneable ， Attribute ， PrintJobAttribute ， PrintRequestAttribute 

    public final class Destination
extends URISyntax
implements PrintJobAttribute, PrintRequestAttribute
    类目标是打印属性类（URI），用于指示假脱机打印机格式化数据的备用目标。 许多PrintServices不支持打印机设备以外的目的地的概念，因此不支持此属性。

    此属性的常见用途是将输出重定向到本地磁盘文件的应用程序：例如“file：out.prn”。 需要注意的是正确的建设“的文件：” URI方案的实例应该使用的执行toURI()类的方法File 。 有关详细信息，请参阅该类的文档。

    如果在PrintRequest中指定了目标URI，并且不能通过PrintService输出，那么将抛出PrintException。 PrintException可以实现URIException来提供更具体的原因。

    IPP兼容性：目标不是IPP属性。

    另请参见：
    Serialized Form

    • 构造方法详细信息

      • Destination

        public Destination​(URI uri)
        使用指定的URI构造新的目标属性。
        参数
        uri - URI。
        异常
        NullPointerException - （未经检查的异常）如果 uri为空，则抛出。

    • 方法详细信息

      • equals

        public boolean equals​(Object object)
        返回此目标属性是否等同于传入的对象。 要相等的，所有以下条件必须为真：
        1. object不为空。
        2. object是类Destination的实例。
        3. 此目标属性的URI和object的URI相等。
        重写：
        equals在 URISyntax
        参数
        object - 要比较的对象。
        结果
        如果 object等效于此目标属性， object true，否则为false。
        另请参见：
        Object.hashCode() ， HashMap

      • getCategory

        public final Class<? extends Attribute> getCategory​()
        获取要用作此打印属性值的“类别”的打印属性类。

        对于目的地类，该类别是目的地本身。

        Specified by:
        getCategory在接口 Attribute
        结果
        打印属性类（category），一个java.lang.Class类的实例。

      • getName

        public final String getName​()
        获取此属性值是一个实例的类别的名称。

        对于目的地类，类别名称为"spool-data-destination" 。

        Specified by:
        getName在接口 Attribute
        结果
        属性类别名称。