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:」方式の URI インスタンスの適切な構築は、File クラスの toURI() メソッドを使用して行う必要があることに注意してください。詳細は、このクラスのドキュメントを参照してください。

出力先 URI が PrintRequest で指定され、PrintService による出力にアクセスできない場合、PrintException がスローされます。PrintException は URIException を実装して、より具体的な原因を提供します。

IPP 互換性: 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 が出力先属性と等しい場合は 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

戻り値:

属性カテゴリの名前