javax.print.attribute

クラス AttributeSetUtilities

java.lang.Object

javax.print.attribute.AttributeSetUtilities

public final class AttributeSetUtilities
extends Object

AttributeSetUtilities クラスは、AttributeSets を操作する次の static メソッドを提供します。

• 属性セットの修正不可能な同期ビューを作成するメソッド
• AttributeSet インタフェースの実装を構築するために役立つ操作

AttributeSet S の修正不可能なビュー U は、クライアントに S への「読み込み専用」アクセスを提供します。U のクエリー操作は S を直接読み込みます。このため、S の変更は U に反映されます。ただし、U を変更しようとすると UnmodifiableSetException が表示されます。属性セットオブジェクト S が直列化可能の場合、修正不可能なビューオブジェクト U は直列化可能です。

属性セット S の同期ビュー V により、クライアントは S への複数のスレッドセーフな同期アクセスができるようになります。V の各操作は、V 自体をロックオブジェクトとして使って同期化され、S の対応する操作を単に呼び出します。相互に排他的なアクセスを保証するためには、S に対するすべてのアクセスが V を介して実行されることが重要です。属性セットオブジェクト S が直列化可能の場合、同期ビューオブジェクト V は直列化可能です。

javax.print のパッケージの説明で述べたように、意味のある解釈を持つものとしてメソッドに明示的にドキュメント化されていない場合、メソッドに対する null 参照パラメータは不正です。これに反する使用は無効なコーディングであり、すぐにまたはあとで実行時の例外が生ずる結果になります。IllegalArgumentException および NullPointerException は、このような場合の典型的で許容できる実行時の例外の事例です。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
static AttributeSet	synchronizedView(AttributeSet attributeSet) 指定された属性セットの同期ビューを作成します。
static DocAttributeSet	synchronizedView(DocAttributeSet attributeSet) 指定されたドキュメントの属性セットの同期ビューを作成します。
static PrintJobAttributeSet	synchronizedView(PrintJobAttributeSet attributeSet) 指定された印刷ジョブの属性セットの同期ビューを作成します。
static PrintRequestAttributeSet	synchronizedView(PrintRequestAttributeSet attributeSet) 指定された印刷要求の属性セットの同期ビューを作成します。
static PrintServiceAttributeSet	synchronizedView(PrintServiceAttributeSet attributeSet) 指定された印刷サービスの属性セットの同期ビューを作成します。
static AttributeSet	unmodifiableView(AttributeSet attributeSet) 指定された属性セットの変更不可能なビューを作成します。
static DocAttributeSet	unmodifiableView(DocAttributeSet attributeSet) 指定されたドキュメントの属性セットの変更不可能なビューを作成します。
static PrintJobAttributeSet	unmodifiableView(PrintJobAttributeSet attributeSet) 指定された印刷ジョブの属性セットの変更不可能なビューを作成します。
static PrintRequestAttributeSet	unmodifiableView(PrintRequestAttributeSet attributeSet) 指定された印刷要求の属性セットの変更不可能なビューを作成します。
static PrintServiceAttributeSet	unmodifiableView(PrintServiceAttributeSet attributeSet) 指定された印刷サービスの属性セットの変更不可能なビューを作成します。
static Class<?>	verifyAttributeCategory(Object object, Class<?> interfaceName) 指定されたオブジェクトが指定されたインタフェースを実装した Class であることを確認しますが、その際、そのインタフェースは、インタフェース Attribute またはそのサブインタフェースであると仮定されます。
static Attribute	verifyAttributeValue(Object object, Class<?> interfaceName) 指定されたオブジェクトが、指定されたインタフェースのインスタンスであることを判定します。このインタフェースは Attribute またはそのサブインタフェースであると推定されます。
static void	verifyCategoryForValue(Class<?> category, Attribute attribute) 指定された属性カテゴリのオブジェクトが、指定された属性値のオブジェクトのカテゴリと等しいかどうかを判定します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

unmodifiableView

public static AttributeSet unmodifiableView(AttributeSet attributeSet)

指定された属性セットの変更不可能なビューを作成します。

パラメータ:

attributeSet - 基になる属性セット。

戻り値:

attributeSet の変更不可能なビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。null は a にならない

unmodifiableView

public static DocAttributeSet unmodifiableView(DocAttributeSet attributeSet)

指定されたドキュメントの属性セットの変更不可能なビューを作成します。

パラメータ:

attributeSet - 基になるドキュメントの属性セット。

戻り値:

attributeSet の変更不可能なビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

unmodifiableView

public static PrintRequestAttributeSet unmodifiableView(PrintRequestAttributeSet attributeSet)

指定された印刷要求の属性セットの変更不可能なビューを作成します。

パラメータ:

attributeSet - 基になる印刷要求の属性セット。

戻り値:

attributeSet の変更不可能なビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

unmodifiableView

public static PrintJobAttributeSet unmodifiableView(PrintJobAttributeSet attributeSet)

指定された印刷ジョブの属性セットの変更不可能なビューを作成します。

パラメータ:

attributeSet - 基になる印刷ジョブの属性セット。

戻り値:

attributeSet の変更不可能なビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

unmodifiableView

public static PrintServiceAttributeSet unmodifiableView(PrintServiceAttributeSet attributeSet)

指定された印刷サービスの属性セットの変更不可能なビューを作成します。

パラメータ:

attributeSet - 基になる印刷サービスの属性セット。

戻り値:

attributeSet の変更不可能なビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

synchronizedView

public static AttributeSet synchronizedView(AttributeSet attributeSet)

指定された属性セットの同期ビューを作成します。

パラメータ:

attributeSet - 基になる属性セット。

戻り値:

attributeSet の同期ビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

synchronizedView

public static DocAttributeSet synchronizedView(DocAttributeSet attributeSet)

指定されたドキュメントの属性セットの同期ビューを作成します。

パラメータ:

attributeSet - 基になるドキュメントの属性セット。

戻り値:

attributeSet の同期ビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

synchronizedView

public static PrintRequestAttributeSet synchronizedView(PrintRequestAttributeSet attributeSet)

指定された印刷要求の属性セットの同期ビューを作成します。

パラメータ:

attributeSet - 基になる印刷要求の属性セット。

戻り値:

attributeSet の同期ビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

synchronizedView

public static PrintJobAttributeSet synchronizedView(PrintJobAttributeSet attributeSet)

指定された印刷ジョブの属性セットの同期ビューを作成します。

パラメータ:

attributeSet - 基になる印刷ジョブの属性セット。

戻り値:

attributeSet の同期ビュー。

例外:

NullPointerException - attributeSet が null の場合にスローされる。

synchronizedView

public static PrintServiceAttributeSet synchronizedView(PrintServiceAttributeSet attributeSet)

指定された印刷サービスの属性セットの同期ビューを作成します。

パラメータ:

attributeSet - 基になる印刷サービスの属性セット。

戻り値:

attributeSet の同期ビュー。

verifyAttributeCategory

public static Class<?> verifyAttributeCategory(Object object,
                               Class<?> interfaceName)

指定されたオブジェクトが指定されたインタフェースを実装した Class であることを確認しますが、その際、そのインタフェースは、インタフェース Attribute またはそのサブインタフェースであると仮定されます。

パラメータ:

object - 判定されるオブジェクト。

interfaceName - オブジェクトが実装しなければならないインタフェース。

戻り値:

object が interfaceName を実装する Class の場合、object は Class 型に返される。それ以外の場合は例外がスローされる。

例外:

NullPointerException - 非チェック例外。object が null の場合にスローされる。

ClassCastException - 非チェック例外。object が interfaceName を実装する Class でない場合にスローされる。

verifyAttributeValue

public static Attribute verifyAttributeValue(Object object,
                             Class<?> interfaceName)

指定されたオブジェクトが、指定されたインタフェースのインスタンスであることを判定します。このインタフェースは Attribute またはそのサブインタフェースであると推定されます。

パラメータ:

object - 判定されるオブジェクト。

interfaceName - オブジェクトがインスタンスでなければならないインタフェース。

戻り値:

object が interfaceName のインスタンスの場合、object は Attribute 型に返される。それ以外の場合は例外がスローされる。

例外:

NullPointerException - 非チェック例外。object が null の場合にスローされる。

ClassCastException - 非チェック例外。object が interfaceName のインスタンスでない場合にスローされる。

verifyCategoryForValue

public static void verifyCategoryForValue(Class<?> category,
                          Attribute attribute)

指定された属性カテゴリのオブジェクトが、指定された属性値のオブジェクトのカテゴリと等しいかどうかを判定します。等しい場合、このメソッドは何もせずに復帰します。等しくない場合、このメソッドは例外をスローします。

パラメータ:

category - 判定される属性カテゴリ。

attribute - 判定される属性値。

例外:

NullPointerException - 非チェック例外。category が null の場合、または attribute が null の場合、スローされる。

IllegalArgumentException - 非チェック例外。category が attribute のカテゴリと等しくない場合、スローされる。