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 であることを判定します。
static Attribute	verifyAttributeValue(Object object, Class<?> interfaceName) 指定されたオブジェクトが、指定されたインタフェースのインスタンスであることを判定します。
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 のカテゴリと等しくない場合、スローされる