Module  java.desktop

Class Destination

  • All Implemented Interfaces:
    SerializableCloneableAttributePrintJobAttributePrintRequestAttribute


    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相等。
        重写:
        equalsURISyntax
        参数
        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
        结果
        属性类别名称。