Serializable
, Cloneable
, Attribute
, PrintJobAttribute
public class JobState extends EnumSyntax implements PrintJobAttribute
JobState
is a printing attribute class, an enumeration, that identifies the current state of a print job. Class JobState
defines standard job state values. A Print Service implementation only needs to report those job states which are appropriate for the particular implementation; it does not have to report every defined job state. The JobStateReasons
attribute augments the JobState
attribute to give more detailed information about the job in the given job state. IPP Compatibility: The category name returned by getName()
is the IPP attribute name. The enumeration's integer value is the IPP enum value. The toString()
method returns the IPP string representation of the attribute value.
Modifier and Type | Field | Description |
---|---|---|
static final JobState |
ABORTED |
The job has been aborted by the system (usually while the job was in the PROCESSING or PROCESSING_STOPPED state), the printer has completed aborting the job, and all job status attributes have reached their final values for the job. |
static final JobState |
CANCELED |
The job has been canceled by some human agency, the printer has completed canceling the job, and all job status attributes have reached their final values for the job. |
static final JobState |
COMPLETED |
The job has completed successfully or with warnings or errors after processing, all of the job media sheets have been successfully stacked in the appropriate output bin(s), and all job status attributes have reached their final values for the job. |
static final JobState |
PENDING |
The job is a candidate to start processing, but is not yet processing. |
static final JobState |
PENDING_HELD |
The job is not a candidate for processing for any number of reasons but will return to the PENDING state as soon as the reasons are no longer present. |
static final JobState |
PROCESSING |
The job is processing. |
static final JobState |
PROCESSING_STOPPED |
The job has stopped while processing for any number of reasons and will return to the PROCESSING state as soon as the reasons are no longer present. |
static final JobState |
UNKNOWN |
The job state is unknown. |
Modifier | Constructor | Description |
---|---|---|
protected |
Construct a new job state enumeration value with the given integer value. |
Modifier and Type | Method | Description |
---|---|---|
final Class |
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 class JobState . |
final String |
getName() |
Get the name of the category of which this attribute value is an instance. |
protected String[] |
getStringTable() |
Returns the string table for class JobState . |
clone, getOffset, getValue, hashCode, readResolve, toString
public static final JobState UNKNOWN
public static final JobState PENDING
public static final JobState PENDING_HELD
PENDING
state as soon as the reasons are no longer present. The job's JobStateReasons
attribute must indicate why the job is no longer a candidate for processing.public static final JobState PROCESSING
PROCESSING
state, the entire job state includes the detailed status represented in the printer's PrinterState
and PrinterStateReasons
attributes. Implementations may, though they need not, include additional values in the job's JobStateReasons
attribute to indicate the progress of the job, such as adding the JOB_PRINTING
value to indicate when the output device is actually making marks on paper and/or the PROCESSING_TO_STOP_POINT
value to indicate that the printer is in the process of canceling or aborting the job.
public static final JobState PROCESSING_STOPPED
PROCESSING
state as soon as the reasons are no longer present. The job's JobStateReasons
attribute may indicate why the job has stopped processing. For example, if the output device is stopped, the PRINTER_STOPPED
value may be included in the job's JobStateReasons
attribute.
Note: When an output device is stopped, the device usually indicates its condition in human readable form locally at the device. A client can obtain more complete device status remotely by querying the printer's PrinterState
and PrinterStateReasons
attributes.
public static final JobState CANCELED
JobStateReasons
attribute should contain the PROCESSING_TO_STOP_POINT
value and one of the CANCELED_BY_USER
, CANCELED_BY_OPERATOR
, or CANCELED_AT_DEVICE
values. When the job moves to the CANCELED
state, the PROCESSING_TO_STOP_POINT
value, if present, must be removed, but the CANCELED_BY_xxx value, if present, must remain.public static final JobState ABORTED
PROCESSING
or PROCESSING_STOPPED
state), the printer has completed aborting the job, and all job status attributes have reached their final values for the job. While the printer is aborting the job, the job remains in its current state, but the job's JobStateReasons
attribute should contain the PROCESSING_TO_STOP_POINT
and ABORTED_BY_SYSTEM
values. When the job moves to the ABORTED
state, the PROCESSING_TO_STOP_POINT
value, if present, must be removed, but the ABORTED_BY_SYSTEM
value, if present, must remain.public static final JobState COMPLETED
JobStateReasons
attribute should contain one of these values: COMPLETED_SUCCESSFULLY
, COMPLETED_WITH_WARNINGS
, or COMPLETED_WITH_ERRORS
.protected JobState(int value)
value
- Integer valueprotected String[] getStringTable()
JobState
.getStringTable
in class EnumSyntax
protected EnumSyntax[] getEnumValueTable()
JobState
.getEnumValueTable
in class EnumSyntax
public final Class<? extends Attribute> getCategory()
For class JobState
and any vendor-defined subclasses, the category is class JobState
itself.
getCategory
in interface Attribute
java.lang.Class
public final String getName()
For class JobState
and any vendor-defined subclasses, the category name is "job-state"
.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/print/attribute/standard/JobState.html