| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public final class PrinterStateReasons extends HashMap implements PrintServiceAttribute
Class PrinterStateReasons is a printing attribute class, a set of enumeration values, that provides additional information about the printer's current state, i.e., information that augments the value of the printer's {@link PrinterState PrinterState} attribute.
Instances of {@link PrinterStateReason PrinterStateReason} do not appear in a Print Service's attribute set directly. Rather, a PrinterStateReasons attribute appears in the Print Service's attribute set. The PrinterStateReasons attribute contains zero, one, or more than one {@link PrinterStateReason PrinterStateReason} objects which pertain to the Print Service's status, and each {@link PrinterStateReason PrinterStateReason} object is associated with a {@link Severity Severity} level of REPORT (least severe), WARNING, or ERROR (most severe). The printer adds a {@link PrinterStateReason PrinterStateReason} object to the Print Service's PrinterStateReasons attribute when the corresponding condition becomes true of the printer, and the printer removes the {@link PrinterStateReason PrinterStateReason} object again when the corresponding condition becomes false, regardless of whether the Print Service's overall {@link PrinterState PrinterState} also changed.
Class PrinterStateReasons inherits its implementation from class {@link java.util.HashMap java.util.HashMap}. Each entry in the map consists of a {@link PrinterStateReason PrinterStateReason} object (key) mapping to a {@link Severity Severity} object (value):
Unlike most printing attributes which are immutable once constructed, class PrinterStateReasons is designed to be mutable; you can add {@link PrinterStateReason PrinterStateReason} objects to an existing PrinterStateReasons object and remove them again. However, like class {@link java.util.HashMap java.util.HashMap}, class PrinterStateReasons is bot multiple thread safe. If a PrinterStateReasons object will be used by multiple threads, be sure to synchronize its operations (e.g., using a synchronized map view obtained from class {@link java.util.Collections java.util.Collections}).
IPP Compatibility: The string values returned by each individual
{@link PrinterStateReason PrinterStateReason} object's and the associated
{@link Severity Severity} object's toString()
methods,
concatenated
together with a hyphen ("-"
) in between, gives the IPP keyword
value. The category name returned by getName()
gives the IPP
attribute name.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class java.util.AbstractMap |
---|
AbstractMap.SimpleEntry, AbstractMap.SimpleImmutableEntry |
Constructor Summary | |
---|---|
Construct a new, empty printer state reasons attribute; the underlying hash map has the default initial capacity and load factor. |
|
PrinterStateReasons(int initialCapacity) super a new, empty printer state reasons attribute; the underlying hash map has the given initial capacity and the default load factor. |
|
PrinterStateReasons(int initialCapacity, float loadFactor) Construct a new, empty printer state reasons attribute; the underlying hash map has the given initial capacity and load factor. |
|
PrinterStateReasons(Map map) Construct a new printer state reasons attribute that contains the same javax.print.attribute.standard.PrinterStateReason-to-javax.print.attribute.standard.Severity mappings as the given map. |
Method Summary | |
---|---|
Class |
Get the printing attribute class which is to be used as the "category" for this printing attribute value. |
String |
getName() Get the name of the category of which this attribute value is an instance. |
Set |
printerStateReasonSet(Severity severity) Obtain an unmodifiable set view of the individual printer state reason attributes at the given severity level in this PrinterStateReasons attribute. |
Severity |
put(PrinterStateReason reason, Severity severity) Adds the given printer state reason to this printer state reasons attribute, associating it with the given severity level. |
Methods inherited from class java.util.HashMap |
---|
clear, clone, containsKey, containsValue, entrySet, get, isEmpty, keySet, put, putAll, remove, size, values |
Methods inherited from class java.util.AbstractMap |
---|
clear, clone, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, toString, values |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PrinterStateReasons()
public PrinterStateReasons(int initialCapacity)
initialCapacity
- Initial capacity.public PrinterStateReasons(int initialCapacity, float loadFactor)
initialCapacity
- Initial capacity.loadFactor
- Load factor.public PrinterStateReasons(Map map)
HashMap(Map)
}.
map
- Map to copy.Method Detail |
---|
public final Class getCategory()
For class PrinterStateReasons, the category is class PrinterStateReasons itself.
public final String getName()
For class PrinterStateReasons, the
category name is "printer-state-reasons"
.
public Set printerStateReasonSet(Severity severity)
severity
- Severity level.public Severity put(PrinterStateReason reason, Severity severity)
put
in class HashMap
reason
- Printer state reason. This must be an instance of
class {@link PrinterStateReason PrinterStateReason}.severity
- Severity of the printer state reason. This must be
an instance of class {@link Severity Severity}.
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |