- java.lang.Object
-
- javax.print.attribute.AttributeSetUtilities
-
public final class AttributeSetUtilities extends Object
クラスAttributeSetUtilities
は、AttributeSets
を操作する静的メソッドを提供します。- 属性セットの修正不可能な同期ビューを作成するメソッド
AttributeSet
インタフェースの実装を構築するために役立つ操作
AttributeSet
Sの「変更不可能なビュー」 Uは、クライアントにSへの"read-only"アクセスを提供します。 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)
static Attribute
verifyAttributeValue(Object object, Class<?> interfaceName)
指定されたオブジェクトが、指定されたインタフェースのインスタンスであることを判定します。このインタフェースはAttribute
またはそのサブインタフェースであると推定されます。static void
verifyCategoryForValue(Class<?> category, Attribute attribute)
指定された属性カテゴリのオブジェクトが、指定された属性値のオブジェクトのカテゴリと等しいかどうかを判定します。
-
-
-
メソッドの詳細
-
unmodifiableView
public static AttributeSet unmodifiableView(AttributeSet attributeSet)
指定された属性セットの変更不可能なビューを作成します。- パラメータ:
attributeSet
- 基になる属性セット- 戻り値:
attributeSet
の変更不可能なビュー- 例外:
NullPointerException
-attributeSet
がnull
の場合
-
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
の同期ビュー- 例外:
NullPointerException
-attributeSet
がnull
の場合
-
verifyAttributeCategory
public static Class<?> verifyAttributeCategory(Object object, Class<?> interfaceName)
指定されたオブジェクトが指定されたインタフェースを実装したClass
であることを確認しますが、その際、そのインタフェースは、インタフェースAttribute
またはそのサブインタフェースであると仮定されます。- パラメータ:
object
- テストする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
- テストする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
またはattribute
がnull
IllegalArgumentException
-category
がattribute
のカテゴリと等しくない場合
-
-