javax.print.attribute.standard

クラス PrinterStateReasons

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<PrinterStateReason,Severity>

javax.print.attribute.standard.PrinterStateReasons

すべての実装されたインタフェース:

Serializable, Cloneable, Map<PrinterStateReason,Severity>, Attribute, PrintServiceAttribute

public final class PrinterStateReasons
extends HashMap<PrinterStateReason,Severity>
implements PrintServiceAttribute

PrinterStateReasons はプリンタの現在の状態についての追加情報、つまりプリンタの PrinterState 属性をよりわかりやすくする情報を列挙値のセットとして提供する印刷属性クラスです。

PrinterStateReason のインスタンスは印刷サービスの属性セットでは直接使用されず、PrinterStateReasons 属性が使用されます。PrinterStateReasons 属性には、印刷サービスのステータスに関連する PrinterStateReason オブジェクトがまったく含まれない場合もあり、1 つ以上含まれる場合もあります。PrinterStateReason オブジェクトは、REPORT (重要度低)、WARNING、または ERROR (重要度高) の Severity レベルにそれぞれ関連付けられます。プリンタは対応する条件が true になったときに PrinterStateReason オブジェクトを印刷サービスの PrinterStateReasons 属性に追加し、false になったときに PrinterStateReason オブジェクトを削除します。印刷サービス全体の PrinterState の変更とは無関係にこの処理が行われます。

PrinterStateReasons クラスは java.util.HashMap クラスから実装を継承します。マップの各エントリは、Severity オブジェクト (値) にマッピングされた PrinterStateReason オブジェクト (キー) で構成されます。

一度構築されてしまうと変更されないことが多い通常の印刷属性とは異なり、PrinterStateReasons クラスは変更可能に設計されています。PrinterStateReason オブジェクトを既存の PrinterStateReasons オブジェクトに追加したり、再度削除したりすることができます。ただし、java.util.HashMap クラスと同じく、PrinterStateReasons クラスもマルチスレッドに対して安全ではありません。PrinterStateReasons オブジェクトがマルチスレッドで使用される場合、確実に操作を同期させてください。たとえば java.util.Collections クラスから取得された同期化マップビューを使って同期させることができます。

IPP 互換性: 各 PrinterStateReason オブジェクトおよび関連付けられた Severity オブジェクトの toString() メソッドで返される文字列値をハイフン ("-") でつないだものが、IPP キーワード値を示します。getName() によって返されるカテゴリ名は IPP 属性の名前を示します。

関連項目:

直列化された形式

ネストされたクラスのサマリー

クラス java.util.AbstractMap から継承されたネストされたクラス/インタフェース

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
PrinterStateReasons() 空のプリンタ状態理由属性を新しく構築します。基本となるハッシュマップは既定の初期容量と負荷係数を持ちます。
PrinterStateReasons(int initialCapacity) 空のプリンタ状態理由属性を新しく構築します。基本となるハッシュマップは指定された初期容量と既定の負荷係数を持ちます。
PrinterStateReasons(int initialCapacity, float loadFactor) 空のプリンタ状態理由属性を新しく構築します。基本となるハッシュマップは指定された初期容量と負荷係数を持ちます。
PrinterStateReasons(Map<PrinterStateReason,Severity> map) 指定されたマップと同じ PrinterStateReason から Severity へのマッピングを持つプリンタ状態理由属性を新しく構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Class<? extends Attribute>	getCategory() この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
String	getName() 属性値がインスタンスとなるカテゴリの名前を返します。
Set<PrinterStateReason>	printerStateReasonSet(Severity severity) この PrinterStateReasons 属性の指定された重要度レベルの各プリンタ状態理由属性から、変更不可能なセットビューを返します。
Severity	put(PrinterStateReason reason, Severity severity) 指定されたプリンタ状態理由をこのプリンタ状態理由属性に追加し、同時に指定された重要度レベルに関連付けます。

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

clear, clone, containsKey, containsValue, entrySet, get, isEmpty, keySet, putAll, remove, size, values

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

equals, hashCode, toString

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

finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース java.util.Map から継承されたメソッド

equals, hashCode

コンストラクタの詳細

PrinterStateReasons

public PrinterStateReasons()

空のプリンタ状態理由属性を新しく構築します。基本となるハッシュマップは既定の初期容量と負荷係数を持ちます。

PrinterStateReasons

public PrinterStateReasons(int initialCapacity)

空のプリンタ状態理由属性を新しく構築します。基本となるハッシュマップは指定された初期容量と既定の負荷係数を持ちます。

パラメータ:

initialCapacity - 初期容量。

例外:

IllegalArgumentException - 初期容量が 0 よりも小さい場合。

PrinterStateReasons

public PrinterStateReasons(int initialCapacity,
                   float loadFactor)

空のプリンタ状態理由属性を新しく構築します。基本となるハッシュマップは指定された初期容量と負荷係数を持ちます。

パラメータ:

initialCapacity - 初期容量。

loadFactor - 負荷係数。

例外:

IllegalArgumentException - 初期容量が 0 よりも小さい場合。

PrinterStateReasons

public PrinterStateReasons(Map<PrinterStateReason,Severity> map)

指定されたマップと同じ PrinterStateReason から Severity へのマッピングを持つプリンタ状態理由属性を新しく構築します。基本となるハッシュマップの初期容量と負荷係数はスーパークラスのコンストラクタ HashMap(Map) で指定されます。

パラメータ:

map - コピー元のマップ。

例外:

NullPointerException - 非チェック例外。map が null の場合、または map のいずれかのキーまたは値が null の場合にスローされる。

ClassCastException - (非チェック例外) map のいずれかのキーが PrinterStateReason クラスのインスタンスではない場合、または map のいずれかの値が Severity クラスのインスタンスではない場合にスローされる。

メソッドの詳細

put

public Severity put(PrinterStateReason reason,
           Severity severity)

指定されたプリンタ状態理由をこのプリンタ状態理由属性に追加し、同時に指定された重要度レベルに関連付けます。このプリンタ状態理由属性に、指定されたプリンタ状態理由のマッピングが登録済の場合、その値が変更されます。

定義:

put、インタフェース: Map<PrinterStateReason,Severity>

オーバーライド:

put、クラス: HashMap<PrinterStateReason,Severity>

パラメータ:

reason - プリンタ状態理由。これは、PrinterStateReason クラスのインスタンスである必要があります。

severity - プリンタ状態理由の重要度。これは、Severity クラスのインスタンスである必要があります。

戻り値:

指定されたプリンタ状態理由にこれまで関連付けられていた重要度。指定されたプリンタ状態理由が登録されていなかった場合は null。

例外:

NullPointerException - 非チェック例外。reason が null の場合、または severity が null の場合にスローされる。

ClassCastException - (非チェック例外) reason が PrinterStateReason クラスのインスタンスではない場合、または severity が Severity クラスのインスタンスではない場合にスローされる。

導入されたバージョン:

1.5

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

PrinterStateReasons クラスの場合、カテゴリは PrinterStateReasons クラス自身です。

定義:

getCategory、インタフェース: Attribute

戻り値:

印刷属性クラス (カテゴリ)、java.lang.Class クラスのインスタンス。

getName

public final String getName()

属性値がインスタンスとなるカテゴリの名前を返します。

PrinterStateReasons クラスの場合、カテゴリ名は "printer-state-reasons" です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前

printerStateReasonSet

public Set<PrinterStateReason> printerStateReasonSet(Severity severity)

この PrinterStateReasons 属性の指定された重要度レベルの各プリンタ状態理由属性から、変更不可能なセットビューを返します。セットビューの各要素は PrinterStateReason オブジェクトです。セットビューに含まれる要素は、指定された重要度の値にマッピングされた PrinterStateReason オブジェクトのみです。セットビューはこの PrinterStateReasons 属性に連動しており、この PrinterStateReasons 属性に対する変更がセットビューに反映されています。セットビューは要素の追加または削除をサポートしません。セットビューのイテレータは要素の削除をサポートしません。

パラメータ:

severity - 重要度レベル。

戻り値:

指定された Severity レベルの各 PrinterStateReason 属性のセットビュー。

例外:

NullPointerException - 非チェック例外。severity が null の場合にスローされる。