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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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であることを確認しますが、その際、そのインタフェースは、インタフェースAttributeまたはそのサブインタフェースであると仮定されます。
    static Attribute
    verifyAttributeValue(Object object, Class<?> interfaceName)
    指定されたオブジェクトが、指定されたインタフェースのインスタンスであることを判定します。このインタフェースはAttributeまたはそのサブインタフェースであると推定されます。
    static void
    verifyCategoryForValue(Class<?> category, Attribute attribute)
    指定された属性カテゴリのオブジェクトが、指定された属性値のオブジェクトのカテゴリと等しいかどうかを判定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • メソッドの詳細

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