JavaTM 2 Platform
Standard Ed. 5.0

javax.print.attribute
クラス AttributeSetUtilities

java.lang.Object
  上位を拡張 javax.print.attribute.AttributeSetUtilities

public final class AttributeSetUtilities
extends Object

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

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 - オブジェクトが実装しなければならないインタフェース
戻り値:
objectinterfaceName を実装する Class の場合、objectClass 型に返される。それ以外の場合は例外がスローされる
例外:
NullPointerException - 未確認の例外。object が null の場合、スローされる
ClassCastException - 未確認の例外。objectinterfaceName を実装する Class ではない場合、スローされる

verifyAttributeValue

public static Attribute verifyAttributeValue(Object object,
                                             Class<?> interfaceName)
指定されたオブジェクトが、指定されたインタフェースのインスタンスであることを判定します。このインタフェースは Attribute またはそのサブインタフェースであると推定されます。

パラメータ:
object - 判定されるオブジェクト
interfaceName - オブジェクトがインスタンスでなければならないインタフェース
戻り値:
objectinterfaceName のインスタンスの場合、objectAttribute 型に返される。それ以外の場合は例外がスローされる
例外:
NullPointerException - 未確認の例外。object が null の場合、スローされる
ClassCastException - 未確認の例外。objectinterfaceName のインスタンスではない場合、スローされる

verifyCategoryForValue

public static void verifyCategoryForValue(Class<?> category,
                                          Attribute attribute)
指定された属性カテゴリのオブジェクトが、指定された属性値のオブジェクトのカテゴリと等しいかどうかを判定します。等しい場合、このメソッドは何もせずに復帰します。等しくない場合、このメソッドは例外をスローします。

パラメータ:
category - 判定される属性カテゴリ
attribute - 判定される属性値
例外:
NullPointerException - 未確認の例外。category が null、または attribute が null の場合、スローされる
IllegalArgumentException - 未確認の例外。categoryattribute のカテゴリと等しくない場合、スローされる

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。