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が同じである。

オーバーライド:

equals、クラス: URISyntax

パラメータ:

object - 比較対象のオブジェクト。

戻り値:

objectがこの出力先属性と等しい場合はtrue、そうでない場合はfalse。

関連項目:

Object.hashCode()、HashMap

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

Destinationクラスの場合、カテゴリはDestinationクラス自体です。

定義:

getCategory、インタフェース: Attribute

戻り値:

印刷属性クラス(カテゴリ)、java.lang.Classクラスのインスタンス。

getName

public final String getName()

属性値がインスタンスとなるカテゴリの名前を返します。

Destinationクラスの場合、カテゴリ名は"spool-data-destination"です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前