- java.lang.Object
-
- javax.print.attribute.EnumSyntax
-
- javax.print.attribute.standard.PrinterStateReason
-
- All Implemented Interfaces:
Serializable,Cloneable,Attribute
public class PrinterStateReason extends EnumSyntax implements Attribute
ClassPrinterStateReasonis a printing attribute class, an enumeration, that provides additional information about the printer's current state, i.e., information that augments the value of the printer'sPrinterStateattribute. Class PrinterStateReason defines standard printer state reason values. A Print Service implementation only needs to report those printer state reasons which are appropriate for the particular implementation; it does not have to report every defined printer state reason.Instances of
PrinterStateReasondo not appear in a Print Service's attribute set directly. Rather, aPrinterStateReasonsattribute appears in the Print Service's attribute set. ThePrinterStateReasonsattribute contains zero, one, or more than onePrinterStateReasonobjects which pertain to the Print Service's status, and each PrinterStateReason object is associated with aSeveritylevel ofREPORT(least severe),WARNING, orERROR(most severe). The printer adds aPrinterStateReasonobject to the Print Service'sPrinterStateReasonsattribute when the corresponding condition becomes true of the printer, and the printer removes thePrinterStateReasonobject again when the corresponding condition becomes false, regardless of whether the Print Service's overallPrinterStatealso changed.IPP Compatibility: The string values returned by each individual
PrinterStateReasonand associatedSeverityobject'stoString()methods, concatenated together with a hyphen ("-") in between, gives the IPP keyword value for aPrinterStateReasons. The category name returned bygetName()gives the IPP attribute name.- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static PrinterStateReasonCONNECTING_TO_DEVICEThe printer has scheduled a job on the output device and is in the process of connecting to a shared network output device (and might not be able to actually start printing the job for an arbitrarily long time depending on the usage of the output device by other servers on the network).static PrinterStateReasonCOVER_OPENOne or more covers on the device are open.static PrinterStateReasonDEVELOPER_EMPTYThe device is out of developer.static PrinterStateReasonDEVELOPER_LOWThe device is low on developer.static PrinterStateReasonDOOR_OPENOne or more doors on the device are open.static PrinterStateReasonFUSER_OVER_TEMPThe fuser temperature is above normal.static PrinterStateReasonFUSER_UNDER_TEMPThe fuser temperature is below normal.static PrinterStateReasonINPUT_TRAY_MISSINGOne or more input trays are not in the device.static PrinterStateReasonINTERLOCK_OPENOne or more interlock devices on the printer are unlocked.static PrinterStateReasonINTERPRETER_RESOURCE_UNAVAILABLEAn interpreter resource is unavailable (e.g., font, form).static PrinterStateReasonMARKER_SUPPLY_EMPTYThe device is out of at least one marker supply (e.g. toner, ink, ribbon).static PrinterStateReasonMARKER_SUPPLY_LOWThe device is low on at least one marker supply (e.g. toner, ink, ribbon).static PrinterStateReasonMARKER_WASTE_ALMOST_FULLThe device marker supply waste receptacle is almost full.static PrinterStateReasonMARKER_WASTE_FULLThe device marker supply waste receptacle is full.static PrinterStateReasonMEDIA_EMPTYAt least one input tray is empty.static PrinterStateReasonMEDIA_JAMThe device has a media jam.static PrinterStateReasonMEDIA_LOWAt least one input tray is low on media.static PrinterStateReasonMEDIA_NEEDEDA tray has run out of media.static PrinterStateReasonMOVING_TO_PAUSEDSomeone has paused the printer, but the device(s) are taking an appreciable time to stop.static PrinterStateReasonOPC_LIFE_OVERThe optical photo conductor is no longer functioning.static PrinterStateReasonOPC_NEAR_EOLThe optical photo conductor is near end of life.static PrinterStateReasonOTHERThe printer has detected an error other than ones listed below.static PrinterStateReasonOUTPUT_AREA_ALMOST_FULLOne or more output areas are almost full (e.g. tray, stacker, collator).static PrinterStateReasonOUTPUT_AREA_FULLOne or more output areas are full (e.g. tray, stacker, collator).static PrinterStateReasonOUTPUT_TRAY_MISSINGOne or more output trays are not in the device.static PrinterStateReasonPAUSEDSomeone has paused the printer and the printer'sPrinterStateisSTOPPED.static PrinterStateReasonSHUTDOWNSomeone has removed a printer from service, and the device may be powered down or physically removed.static PrinterStateReasonSPOOL_AREA_FULLThe limit of persistent storage allocated for spooling has been reached.static PrinterStateReasonSTOPPED_PARTLYWhen a printer controls more than one output device, this reason indicates that one or more output devices are stopped.static PrinterStateReasonSTOPPINGThe printer is in the process of stopping the device and will be stopped in a while.static PrinterStateReasonTIMED_OUTThe server was able to connect to the output device (or is always connected), but was unable to get a response from the output device.static PrinterStateReasonTONER_EMPTYThe device is out of toner.static PrinterStateReasonTONER_LOWThe device is low on toner.
-
Constructor Summary
Constructors Modifier Constructor Description protectedPrinterStateReason(int value)Construct a new printer state reason enumeration value with the given integer value.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Class<? extends Attribute>getCategory()Get the printing attribute class which is to be used as the "category" for this printing attribute value.protected EnumSyntax[]getEnumValueTable()Returns the enumeration value table for classPrinterStateReason.StringgetName()Get the name of the category of which this attribute value is an instance.protected String[]getStringTable()Returns the string table for classPrinterStateReason.-
Methods declared in class javax.print.attribute.EnumSyntax
clone, getOffset, getValue, hashCode, readResolve, toString
-
-
-
-
Field Detail
-
OTHER
public static final PrinterStateReason OTHER
The printer has detected an error other than ones listed below.
-
MEDIA_NEEDED
public static final PrinterStateReason MEDIA_NEEDED
A tray has run out of media.
-
MEDIA_JAM
public static final PrinterStateReason MEDIA_JAM
The device has a media jam.
-
MOVING_TO_PAUSED
public static final PrinterStateReason MOVING_TO_PAUSED
Someone has paused the printer, but the device(s) are taking an appreciable time to stop. Later, when all output has stopped, thePrinterStatebecomesSTOPPED, and thePAUSEDvalue replaces theMOVING_TO_PAUSEDvalue in thePrinterStateReasonsattribute. This value must be supported if the printer can be paused and the implementation takes significant time to pause a device in certain circumstances.
-
PAUSED
public static final PrinterStateReason PAUSED
Someone has paused the printer and the printer'sPrinterStateisSTOPPED. In this state, a printer must not produce printed output, but it must perform other operations requested by a client. If a printer had been printing a job when the printer was paused, thePrintermust resume printing that job when the printer is no longer paused and leave no evidence in the printed output of such a pause. This value must be supported if the printer can be paused.
-
SHUTDOWN
public static final PrinterStateReason SHUTDOWN
Someone has removed a printer from service, and the device may be powered down or physically removed. In this state, a printer must not produce printed output, and unless the printer is realized by a print server that is still active, the printer must perform no other operations requested by a client. If a printer had been printing a job when it was shut down, the printer need not resume printing that job when the printer is no longer shut down. If the printer resumes printing such a job, it may leave evidence in the printed output of such a shutdown, e.g. the part printed before the shutdown may be printed a second time after the shutdown.
-
CONNECTING_TO_DEVICE
public static final PrinterStateReason CONNECTING_TO_DEVICE
The printer has scheduled a job on the output device and is in the process of connecting to a shared network output device (and might not be able to actually start printing the job for an arbitrarily long time depending on the usage of the output device by other servers on the network).
-
TIMED_OUT
public static final PrinterStateReason TIMED_OUT
The server was able to connect to the output device (or is always connected), but was unable to get a response from the output device.
-
STOPPING
public static final PrinterStateReason STOPPING
The printer is in the process of stopping the device and will be stopped in a while. When the device is stopped, the printer will change thePrinterStatetoSTOPPED. TheSTOPPINGreason is never an error, even for a printer with a single output device. When an output device ceases accepting jobs, the printer'sPrinterStateReasonswill have this reason while the output device completes printing.
-
STOPPED_PARTLY
public static final PrinterStateReason STOPPED_PARTLY
When a printer controls more than one output device, this reason indicates that one or more output devices are stopped. If the reason's severity is a report, fewer than half of the output devices are stopped. If the reason's severity is a warning, half or more but fewer than all of the output devices are stopped.
-
TONER_LOW
public static final PrinterStateReason TONER_LOW
The device is low on toner.
-
TONER_EMPTY
public static final PrinterStateReason TONER_EMPTY
The device is out of toner.
-
SPOOL_AREA_FULL
public static final PrinterStateReason SPOOL_AREA_FULL
The limit of persistent storage allocated for spooling has been reached. The printer is temporarily unable to accept more jobs. The printer will remove this reason when it is able to accept more jobs. This value should be used by a non-spooling printer that only accepts one or a small number jobs at a time or a spooling printer that has filled the spool space.
-
COVER_OPEN
public static final PrinterStateReason COVER_OPEN
One or more covers on the device are open.
-
INTERLOCK_OPEN
public static final PrinterStateReason INTERLOCK_OPEN
One or more interlock devices on the printer are unlocked.
-
DOOR_OPEN
public static final PrinterStateReason DOOR_OPEN
One or more doors on the device are open.
-
INPUT_TRAY_MISSING
public static final PrinterStateReason INPUT_TRAY_MISSING
One or more input trays are not in the device.
-
MEDIA_LOW
public static final PrinterStateReason MEDIA_LOW
At least one input tray is low on media.
-
MEDIA_EMPTY
public static final PrinterStateReason MEDIA_EMPTY
At least one input tray is empty.
-
OUTPUT_TRAY_MISSING
public static final PrinterStateReason OUTPUT_TRAY_MISSING
One or more output trays are not in the device.
-
OUTPUT_AREA_ALMOST_FULL
public static final PrinterStateReason OUTPUT_AREA_ALMOST_FULL
One or more output areas are almost full (e.g. tray, stacker, collator).
-
OUTPUT_AREA_FULL
public static final PrinterStateReason OUTPUT_AREA_FULL
One or more output areas are full (e.g. tray, stacker, collator).
-
MARKER_SUPPLY_LOW
public static final PrinterStateReason MARKER_SUPPLY_LOW
The device is low on at least one marker supply (e.g. toner, ink, ribbon).
-
MARKER_SUPPLY_EMPTY
public static final PrinterStateReason MARKER_SUPPLY_EMPTY
The device is out of at least one marker supply (e.g. toner, ink, ribbon).
-
MARKER_WASTE_ALMOST_FULL
public static final PrinterStateReason MARKER_WASTE_ALMOST_FULL
The device marker supply waste receptacle is almost full.
-
MARKER_WASTE_FULL
public static final PrinterStateReason MARKER_WASTE_FULL
The device marker supply waste receptacle is full.
-
FUSER_OVER_TEMP
public static final PrinterStateReason FUSER_OVER_TEMP
The fuser temperature is above normal.
-
FUSER_UNDER_TEMP
public static final PrinterStateReason FUSER_UNDER_TEMP
The fuser temperature is below normal.
-
OPC_NEAR_EOL
public static final PrinterStateReason OPC_NEAR_EOL
The optical photo conductor is near end of life.
-
OPC_LIFE_OVER
public static final PrinterStateReason OPC_LIFE_OVER
The optical photo conductor is no longer functioning.
-
DEVELOPER_LOW
public static final PrinterStateReason DEVELOPER_LOW
The device is low on developer.
-
DEVELOPER_EMPTY
public static final PrinterStateReason DEVELOPER_EMPTY
The device is out of developer.
-
INTERPRETER_RESOURCE_UNAVAILABLE
public static final PrinterStateReason INTERPRETER_RESOURCE_UNAVAILABLE
An interpreter resource is unavailable (e.g., font, form).
-
-
Method Detail
-
getStringTable
protected String[] getStringTable()
Returns the string table for classPrinterStateReason.- Overrides:
getStringTablein classEnumSyntax- Returns:
- the string table
-
getEnumValueTable
protected EnumSyntax[] getEnumValueTable()
Returns the enumeration value table for classPrinterStateReason.- Overrides:
getEnumValueTablein classEnumSyntax- Returns:
- the value table
-
getCategory
public final Class<? extends Attribute> getCategory()
Get the printing attribute class which is to be used as the "category" for this printing attribute value.For class
PrinterStateReasonand any vendor-defined subclasses, the category is classPrinterStateReasonitself.- Specified by:
getCategoryin interfaceAttribute- Returns:
- printing attribute class (category), an instance of class
java.lang.Class
-
-