モジュール java.desktop
パッケージ 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は、このような場合の典型的で許容できる実行時の例外の事例です。

    • メソッドの詳細

      • 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のカテゴリと等しくない場合、スローされる。