クラスPrinterStateReasons

java.lang.Object
java.util.AbstractMap<PrinterStateReason, Severity>
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属性には、印刷サービスのステータスに関連する0、1または複数のPrinterStateReasonオブジェクトが含まれ、各PrinterStateReasonオブジェクトは、REPORT (最も厳しい)、WARNINGまたはERROR (最も厳しい)のSeverityレベルに関連付けられます。 プリンタは、対応する条件がプリンタのtrueになるとPrinterStateReasonオブジェクトを印刷サービスのPrinterStateReasons属性に追加し、印刷サービスの全体的なPrinterStateも変更されているかどうかに関係なく、対応する条件がfalseになると、プリンタはPrinterStateReasonオブジェクトを再度削除します。

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

一度構築された不変であるほとんどの印刷属性とは異なり、クラスPrinterStateReasonsは変更可能に設計されています。PrinterStateReasonオブジェクトを既存のPrinterStateReasonsオブジェクトに追加して、それらを再度削除することができます。 ただし、クラスjava.util.HashMapと同様に、クラスPrinterStateReasonsは複数のスレッド・セーフではありません。 PrinterStateReasonsオブジェクトが複数のスレッドによって使用される場合は、その操作(たとえば、クラスjava.util.Collectionsから取得した同期マップ・ビューを使用して)を必ず同期させてください。

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

関連項目:

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

    クラスAbstractMapで宣言されたネストされたクラス/インタフェース

    AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
    修飾子と型
    クラス
    説明
    static class 
    AbstractMap.SimpleEntry<K,V>
    キーと値を保持するエントリ。
    static class 
    AbstractMap.SimpleImmutableEntry<K,V>
    キーと値を保守する変更不可のエントリ。

    インタフェースMapで宣言されたネストされたクラス/インタフェース

    Map.Entry<K,V>
    修飾子と型
    インタフェース
    説明
    static interface 
    Map.Entry<K,V>
    マップのエントリ(キーと値のペア)です。

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

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

  • メソッドのサマリー

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

    クラスで宣言されたメソッド HashMap

    clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, get, isEmpty, keySet, merge, newHashMap, putAll, remove, size, values
    修飾子と型
    メソッド
    説明
    void
    clear()
    すべてのマッピングをマップから削除します。
    Object
    clone()
    このHashMapインスタンスのシャロー・コピーを返します: キーと値自体はクローンされません。
    Severity
    compute(PrinterStateReason key, BiFunction<? super PrinterStateReason, ? super Severity, ? extends Severity> remappingFunction)
    指定されたキーとその現在のマップされた値のマッピングをコンピュートしようとします。現在のマッピング(オプションの操作)がない場合はnullです。
    Severity
    computeIfAbsent(PrinterStateReason key, Function<? super PrinterStateReason, ? extends Severity> mappingFunction)
    指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、指定されたマッピング関数を使用してその値をコンピュートし、null (オプションの操作)でないかぎりこのマップに入力します。
    Severity
    computeIfPresent(PrinterStateReason key, BiFunction<? super PrinterStateReason, ? super Severity, ? extends Severity> remappingFunction)
    指定されたキーの値が存在し、null以外の場合は、キーとその現在のマップされた値(オプションの操作)を指定して、新しいマッピングのコンピュートを試みます。
    boolean
    containsKey(Object key)
    指定されたキーのマッピングがこのマップに含まれている場合にtrueを返します。
    boolean
    containsValue(Object value)
    このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。
    Set<Map.Entry<PrinterStateReason, Severity>>
    entrySet()
    このマップに含まれるマッピングのSetビューを返します。
    Severity
    get(Object key)
    指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合はnullを返します。
    boolean
    isEmpty()
    このマップがキーと値のマッピングを保持しない場合にtrueを返します。
    Set<PrinterStateReason>
    keySet()
    このマップに含まれるキーのSetビューを返します。
    Severity
    merge(PrinterStateReason key, Severity value, BiFunction<? super Severity, ? super Severity, ? extends Severity> remappingFunction)
    指定されたキーがまだ値に関連付けられていない場合、またはnullに関連付けられている場合は、指定されたnull以外の値(オプションの操作)に関連付けます。
    static <K,V> HashMap<K,V>
    newHashMap(int numMappings)
    必要なマッピング数に適した新しい空のHashMapを作成します。
    void
    putAll(Map<? extends PrinterStateReason, ? extends Severity> m)
    指定されたマップからすべてのマッピングをマップにコピーします。
    Severity
    remove(Object key)
    指定されたキーのマッピングがあればマップから削除します。
    int
    size()
    このマップ内のキー値マッピングの数を返します。
    Collection<Severity>
    values()
    このマップに含まれる値のCollectionビューを返します。

    クラスで宣言されたメソッド AbstractMap

    equals, hashCode, toString
    修飾子と型
    メソッド
    説明
    boolean
    equals(Object o)
    指定されたオブジェクトがこのマップと等しいかどうかを比較します。
    int
    hashCode()
    マップのハッシュ・コード値を返します。
    String
    toString()
    このマップの文字列表現を返します。

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

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

    インタフェースMapで宣言されたメソッド

    forEach, getOrDefault, putIfAbsent, remove, replace, replace, replaceAll
    修飾子と型
    メソッド
    説明
    default void
    forEach(BiConsumer<? super PrinterStateReason, ? super Severity> action)
    このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。
    default Severity
    getOrDefault(Object key, Severity defaultValue)
    指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合はdefaultValueを返します。
    default Severity
    putIfAbsent(PrinterStateReason key, Severity value)
    指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、そのキーは指定された値に関連付けられ、nullを返します。それ以外の場合は、現在の値(オプションの操作)を返します。
    default boolean
    remove(Object key, Object value)
    指定されたキーが現在、指定された値(オプションの操作)にマップされている場合にのみ、そのキーのエントリを削除します。
    default Severity
    replace(PrinterStateReason key, Severity value)
    指定されたキーのエントリが、現在値(オプションの操作)にマップされている場合にのみ、そのエントリを置換します。
    default boolean
    replace(PrinterStateReason key, Severity oldValue, Severity newValue)
    指定された値(オプションの操作)に現在マップされている場合にのみ、指定されたキーのエントリを置換します。
    default void
    replaceAll(BiFunction<? super PrinterStateReason, ? super Severity, ? extends Severity> function)
    すべてのエントリが処理されるか、関数が例外(オプションの操作)をスローするまで、各エントリの値を、そのエントリの指定された関数を呼び出した結果に置き換えます。

  • コンストラクタの詳細

    • PrinterStateReasons

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

    • PrinterStateReasons

      public PrinterStateReasons(int initialCapacity)
      新しい空のプリンタ状態理由属性を作成します。基本となるハッシュ・マップには、指定された初期容量とデフォルトの負荷係数があります。
      パラメータ:
      initialCapacity - 初期容量
      スロー:
      IllegalArgumentException - 初期容量が負の場合

    • PrinterStateReasons

      public PrinterStateReasons(int initialCapacity, float loadFactor)
      空のプリンタ状態理由属性を新しく構築します。基本となるハッシュ・マップは指定された初期容量と負荷係数を持ちます。
      パラメータ:
      initialCapacity - 初期容量
      loadFactor - 負荷率
      スロー:
      IllegalArgumentException - 初期容量が負の場合

    • 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
      戻り値:
      印刷属性クラス(category)、クラス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の場合