モジュール java.desktop
パッケージ javax.print.attribute

クラスAttributeSetUtilities

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は、そのような場合の一般的で許容される実行時例外の例です。

  • メソッドの詳細

    • 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のカテゴリと等しくない場合