クラスJobStateReasons

java.lang.Object
java.util.AbstractCollection<JobStateReason>
java.util.AbstractSet<JobStateReason>
java.util.HashSet<JobStateReason>
javax.print.attribute.standard.JobStateReasons
すべての実装されたインタフェース:
Serializable, Cloneable, Iterable<JobStateReason>, Collection<JobStateReason>, Set<JobStateReason>, Attribute, PrintJobAttribute
public final class JobStateReasons extends HashSet<JobStateReason> implements PrintJobAttribute
クラスJobStateReasonsは、出力属性クラスであり、一連の列挙値であり、ジョブの現在の状態に関する追加情報、つまりジョブのJobState属性の値を補強する情報を提供します。

JobStateReasonのインスタンスは印刷ジョブの属性セットでは直接使用されません。 かわりに、印刷ジョブの属性セットにJobStateReasons属性が表示されます。 JobStateReasons属性には、印刷ジョブのステータスに関連するゼロ、1または複数のJobStateReasonオブジェクトが含まれます。 プリンタは印刷ジョブのJobStateReasonsオブジェクトに対応する条件がtrueになったときに、JobStateReasonオブジェクトを印刷ジョブのJobStateReasons属性に追加し、falseになったときに、このJobStateReasonを削除します。印刷ジョブ全体のJobStateの変更とは無関係にこの処理が行われます。

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

IPP互換性: 個々のJobStateReasonオブジェクトのtoString()メソッドによって返される文字列の値はIPPキーワード値を示します。 getName()によって返されるカテゴリ名はIPP属性の名前を示します。

関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    JobStateReasons()
    空のジョブ状態理由属性を新しく構築します。基本となるハッシュ・セットは既定の初期容量と負荷係数を持ちます。
    JobStateReasons(int initialCapacity)
    空のジョブ状態理由属性を新しく構築します。基本となるハッシュ・セットは指定された初期容量と既定の負荷係数を持ちます。
    JobStateReasons(int initialCapacity, float loadFactor)
    空のジョブ状態理由属性を新しく構築します。基本となるハッシュ・セットは指定された初期容量と負荷係数を持ちます。
    JobStateReasons(Collection<JobStateReason> collection)
    指定されコレクションと同じJobStateReasonオブジェクトを持つジョブ状態理由属性を新しく構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    add(JobStateReason o)
    指定された要素がこのジョブ状態理由属性に未登録の場合にこれを追加します。
    final Class<? extends Attribute>
    getCategory()
    この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。
    final String
    getName()
    属性値がインスタンスとなるカテゴリの名前を返します。

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

    clear, clone, contains, isEmpty, iterator, newHashSet, remove, size, spliterator, toArray, toArray
    修飾子と型
    メソッド
    説明
    void
    clear()
    すべての要素をセットから削除します。
    Object
    clone()
    このHashSetインスタンスのシャロー・コピーを返します: 要素自体はクローンされません。
    boolean
    contains(Object o)
    指定された要素がこのセットに含まれている場合にtrueを返します。
    boolean
    isEmpty()
    このセットに要素が1つも含まれていない場合にtrueを返します。
    Iterator<JobStateReason>
    iterator()
    セット内の各要素についてのイテレータを返します。
    static <T> HashSet<T>
    newHashSet(int numElements)
    予想される要素数に適した新しい空のHashSetを作成します。
    boolean
    remove(Object o)
    指定された要素がこのセットに存在する場合に、要素をセットから削除します。
    int
    size()
    セット内の要素数(そのカーディナリティ)を返します。
    Spliterator<JobStateReason>
    spliterator()
    このセット内の要素に対する遅延バインディングおよびフェイルファスト Spliteratorを作成します。
    Object[]
    toArray()
    このコレクションの要素がすべて格納されている配列を返します。
    <T> T[]
    toArray(T[] a)
    このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。

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

    equals, hashCode, removeAll
    修飾子と型
    メソッド
    説明
    boolean
    equals(Object o)
    指定されたオブジェクトがセットと同じかどうかを比較します。
    int
    hashCode()
    セットのハッシュ・コード値を返します。
    boolean
    removeAll(Collection<?> c)
    このセットから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。

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

    addAll, containsAll, retainAll, toArray, toArray, toString
    修飾子と型
    メソッド
    説明
    boolean
    addAll(Collection<? extends JobStateReason> c)
    指定されたコレクションのすべての要素をこのコレクションに追加します(オプションの操作)。
    boolean
    containsAll(Collection<?> c)
    指定したコレクションのすべての要素がこのコレクションに含まれている場合、trueを返します。
    boolean
    retainAll(Collection<?> c)
    このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。
    Object[]
    toArray()
    このコレクションの要素がすべて格納されている配列を返します。
    <T> T[]
    toArray(T[] a)
    このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。
    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であるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

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

    parallelStream, removeIf, stream, toArray
    修飾子と型
    メソッド
    説明
    default Stream<JobStateReason>
    parallelStream()
    このコレクションをソースとして、潜在的に並列のStreamを返します。
    default boolean
    removeIf(Predicate<? super JobStateReason> filter)
    指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。
    default Stream<JobStateReason>
    stream()
    このコレクションをソースとして使用して、逐次的なStreamを返します。
    default <T> T[]
    toArray(IntFunction<T[]> generator)
    指定されたgenerator関数を使用してこのコレクションのすべての要素を含む配列を返し、返された配列を割り当てます。

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

    forEach
    修飾子と型
    メソッド
    説明
    default void
    forEach(Consumer<? super JobStateReason> action)
    Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。

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

    addAll, containsAll, retainAll
    修飾子と型
    メソッド
    説明
    boolean
    addAll(Collection<? extends JobStateReason> c)
    指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します(オプションの操作)。
    boolean
    containsAll(Collection<?> c)
    指定されたコレクションのすべての要素がこのセットに含まれている場合にtrueを返します。
    boolean
    retainAll(Collection<?> c)
    セット内の要素のうち、指定されたコレクション内にある要素だけを保持します(オプションの操作)。

  • コンストラクタの詳細

    • JobStateReasons

      public JobStateReasons()
      空のジョブ状態理由属性を新しく構築します。基本となるハッシュ・セットは既定の初期容量と負荷係数を持ちます。

    • JobStateReasons

      public JobStateReasons(int initialCapacity)
      空のジョブ状態理由属性を新しく構築します。基本となるハッシュ・セットは指定された初期容量と既定の負荷係数を持ちます。
      パラメータ:
      initialCapacity - 初期容量
      スロー:
      IllegalArgumentException - 初期容量が負の場合

    • JobStateReasons

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

    • JobStateReasons

      public JobStateReasons(Collection<JobStateReason> collection)
      指定されコレクションと同じJobStateReasonオブジェクトを持つジョブ状態理由属性を新しく構築します。 基本となるハッシュ・セットの初期容量と負荷係数はスーパー・クラスのコンストラクタHashSet(Collection)で指定されます。
      パラメータ:
      collection - コピーするコレクション
      スロー:
      NullPointerException - collectionがnullの場合、またはcollectionの要素がnullの場合
      ClassCastException - collectionの要素がJobStateReasonクラスのインスタンスでない場合

  • メソッドの詳細

    • add

      public boolean add(JobStateReason o)
      指定された要素がこのジョブ状態理由属性に未登録の場合にこれを追加します。 追加する要素は、JobStateReasonクラスのインスタンスである必要があります。 このジョブ状態理由属性に指定された要素がすでに含まれている場合、コールはこのジョブ状態理由属性を変更せずに、falseを返します。
      定義:
      add、インタフェースCollection<JobStateReason>
      定義:
      add、インタフェースSet<JobStateReason>
      オーバーライド:
      add、クラスHashSet<JobStateReason>
      パラメータ:
      o - このジョブ状態理由属性に追加される要素
      戻り値:
      このジョブ状態事由属性に指定された要素がまだ含まれていない場合、true
      スロー:
      NullPointerException - 指定された要素がnullの場合
      ClassCastException - 指定された要素がクラスJobStateReasonのインスタンスでない場合
      導入されたバージョン:
      1.5

    • getCategory

      public final Class<? extends Attribute> getCategory()
      この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

      JobStateReasonsクラスの場合、カテゴリはJobStateReasonsクラスそのものです。

      定義:
      getCategory、インタフェースAttribute
      戻り値:
      印刷属性クラス(category)、クラスjava.lang.Classのインスタンス

    • getName

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

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

      定義:
      getName、インタフェースAttribute
      戻り値:
      属性カテゴリ名