AttributeSetUtilities (Java Platform SE 8)

java.lang.Object
- 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は、このような場合の典型的で許容できる実行時の例外の事例です。

メソッドのサマリー

すべてのメソッド staticメソッド具象メソッド
修飾子と型	メソッド	説明
`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)`	指定された属性カテゴリのオブジェクトが、指定された属性値のオブジェクトのカテゴリと等しいかどうかを判定します。

クラス 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 - オブジェクトが実装しなければならないインタフェース。
    
    戻り値:
    
    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のカテゴリと等しくない場合、スローされる。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスAttributeSetUtilities

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

メソッドの詳細

unmodifiableView

unmodifiableView

unmodifiableView

unmodifiableView

unmodifiableView

synchronizedView

synchronizedView

synchronizedView

synchronizedView

synchronizedView

verifyAttributeCategory

verifyAttributeValue

verifyCategoryForValue