JavaTM Platform
Standard Ed. 6

javax.print.attribute.standard
类 Destination

java.lang.Object
  继承者 javax.print.attribute.URISyntax
      继承者 javax.print.attribute.standard.Destination
所有已实现的接口:
Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute

public final class Destination
extends URISyntax
implements PrintJobAttribute, PrintRequestAttribute

Destination 类是打印属性类,它是一个 URI,用于指示进入缓冲池的打印机格式的数据的可选目标。许多 PrintServices 不支持除打印机设备之外的目标概念,因此将不支持此属性。

此属性的常见用法是希望将输出重定向到某个本地磁盘文件的应用程序:例如 "file:out.prn"。注意 "file:" 的正确构造应使用 File 类的 toURI() 方法来执行 URI 机制的实例。有关更多信息,请参阅该类的文档。

如果目标 URI 是在 PrintRequest 中指定的,并且输出不能通过 PrintService 访问它,则将抛出 PrintException。PrintException 可以实现 URIException 以提供更具体的原因。

IPP Compatibility: Destination 不是 IPP 属性。

另请参见:
序列化表格

构造方法摘要
Destination(URI uri)
          构造具有给定 URI 的新目标属性。
 
方法摘要
 boolean equals(Object object)
          返回此目标属性是否等效于传入的对象。
 Class<? extends Attribute> getCategory()
          获取将被用作此打印属性值的“类别”的打印属性类。
 String getName()
          获取类别名称,这里此属性值是该类别的实例。
 
从类 javax.print.attribute.URISyntax 继承的方法
getURI, hashCode, toString
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

Destination

public Destination(URI uri)
构造具有给定 URI 的新目标属性。

参数:
uri - URI。
抛出:
NullPointerException - (未经检查的异常) 如果 uri 为 null,则抛出该异常。
方法详细信息

equals

public boolean equals(Object object)
返回此目标属性是否等效于传入的对象。若要等效,以下所有条件都必须为 true:
  1. object 不为 null。
  2. object 为 Destination 类的实例。
  3. 此目标属性的 URI 与 object 的 URI 相同。

覆盖:
URISyntax 中的 equals
参数:
object - 要比较的 Object。
返回:
如果 object 等效于此目标属性,则返回 true,否则返回 false。
另请参见:
Object.hashCode(), Hashtable

getCategory

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

对于 Destination 类,类别为 Destination 类本身。

指定者:
接口 Attribute 中的 getCategory
返回:
打印属性类(类别),它是 java.lang.Class 类的实例。

getName

public final String getName()
获取类别名称,这里此属性值是该类别的实例。

对于 Destination 类,类别名称为 "spool-data-destination"

指定者:
接口 Attribute 中的 getName
返回:
属性类别名称。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策