Module java.desktop
Package javax.print.attribute.standard

Class JobState

java.lang.Object
javax.print.attribute.EnumSyntax
javax.print.attribute.standard.JobState
所有已实现的接口:
Serializable, Cloneable, Attribute, PrintJobAttribute
public class JobState extends EnumSyntax implements PrintJobAttribute
JobState 是一个打印属性类，一个枚举，用于标识打印作业的当前状态。类JobState 定义了标准作业状态值。打印服务实现只需要报告适用于特定实现的作业状态；它不必报告每个定义的作业状态。 JobStateReasons 属性扩展了JobState 属性，以提供有关处于给定作业状态的作业的更详细信息。

IPP 兼容性: getName() 返回的类别名称是 IPP 属性名称。枚举的整数值是 IPP 枚举值。 toString() 方法返回属性值的 IPP 字符串表示形式。

参见:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final JobState
    ABORTED
    作业已被系统中止（通常在作业处于PROCESSING或PROCESSING_STOPPED状态时），打印机已完成中止作业，并且所有作业状态属性已达到作业的最终值。
    static final JobState
    CANCELED
    作业已被某个人为机构取消，打印机已完成取消作业，并且所有作业状态属性已达到作业的最终值。
    static final JobState
    COMPLETED
    作业在处理后已成功完成或带有警告或错误，所有作业介质已成功堆叠在适当的输出箱中，并且所有作业状态属性已达到作业的最终值。
    static final JobState
    PENDING
    作业是可以开始处理的候选作业，但尚未处理。
    static final JobState
    PENDING_HELD
    作业由于各种原因不适合处理，但一旦这些原因不再存在，作业将立即返回到PENDING状态。
    static final JobState
    PROCESSING
    作业正在处理。
    static final JobState
    PROCESSING_STOPPED
    作业在处理时停止，由于各种原因，一旦这些原因不再存在，作业将返回到PROCESSING状态。
    static final JobState
    UNKNOWN
    作业状态未知。

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    JobState(int value)
    使用给定整数值构造新的作业状态枚举值。

  • Method Summary

    Modifier and Type
    Method
    Description
    final Class<? extends Attribute>
    getCategory()
    获取用作此打印属性值的“类别”的打印属性类。
    protected EnumSyntax[]
    getEnumValueTable()
    返回类JobState的枚举值表。
    final String
    getName()
    获取此属性值是其实例的类别的名称。
    protected String[]
    getStringTable()
    返回类JobState的字符串表。

    Methods declared in class javax.print.attribute.EnumSyntax

    clone, getOffset, getValue, hashCode, readResolve, toString

    Methods declared in class java.lang.Object

    equals, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Field Details

    • UNKNOWN

      public static final JobState UNKNOWN
      作业状态未知。

    • PENDING

      public static final JobState PENDING
      作业是可以开始处理的候选作业，但尚未处理。

    • PENDING_HELD

      public static final JobState PENDING_HELD
      作业由于各种原因不适合处理，但一旦这些原因不再存在，作业将立即返回到PENDING状态。作业的JobStateReasons属性必须指示作业不再适合处理的原因。

    • PROCESSING

      public static final JobState PROCESSING
      作业正在处理。以下一项或多项活动正在进行：
      1. 作业正在使用一个或多个纯软件进程，这些进程正在分析、创建或解释 PDL 等。
      2. 作业正在使用一个或多个硬件设备，这些设备正在解释 PDL，在介质上做标记，和/或执行整理，如装订等。
      3. 打印机已准备好打印作业，但输出设备尚未打印它，要么是因为作业尚未到达输出设备，要么是因为作业在输出设备或其他 spooler 中排队，等待输出设备打印它。
      当作业处于PROCESSING状态时，整个作业状态包括打印机的PrinterState和PrinterStateReasons属性中表示的详细状态。

      实现可以（但不必须）在作业的JobStateReasons属性中包含额外的值，以指示作业的进度，例如添加JOB_PRINTING值以指示输出设备实际上正在在纸上做标记和/或PROCESSING_TO_STOP_POINT值以指示打印机正在取消或中止作业。

    • PROCESSING_STOPPED

      public static final JobState PROCESSING_STOPPED
      作业在处理时由于各种原因停止，并且一旦这些原因不再存在，作业将立即返回到PROCESSING状态。

      作业的JobStateReasons属性可能指示作业为何停止处理。例如，如果输出设备停止，作业的JobStateReasons属性中可能包含PRINTER_STOPPED值。

      注意: 当输出设备停止时，设备通常会在设备本地以人类可读的形式指示其状态。客户端可以通过查询打印机的PrinterState和PrinterStateReasons属性来远程获取更完整的设备状态。

    • CANCELED

      public static final JobState CANCELED
      作业已被某个人为机构取消，打印机已完成取消作业，并且所有作业状态属性已达到作业的最终值。在打印机取消作业时，作业保持在当前状态，但作业的JobStateReasons属性应包含PROCESSING_TO_STOP_POINT值和CANCELED_BY_USER、CANCELED_BY_OPERATOR或CANCELED_AT_DEVICE值之一。当作业移动到CANCELED状态时，如果存在PROCESSING_TO_STOP_POINT值，则必须将其删除，但如果存在CANCELED_BY_xxx值，则必须保留。

    • ABORTED

      public static final JobState ABORTED
      作业已被系统中止（通常在作业处于PROCESSING或PROCESSING_STOPPED状态时），打印机已完成中止作业，并且所有作业状态属性已达到作业的最终值。在打印机中止作业时，作业保持在当前状态，但作业的JobStateReasons属性应包含PROCESSING_TO_STOP_POINT和ABORTED_BY_SYSTEM值。当作业移动到ABORTED状态时，如果存在PROCESSING_TO_STOP_POINT值，则必须将其删除，但如果存在ABORTED_BY_SYSTEM值，则必须保留。

    • COMPLETED

      public static final JobState COMPLETED
      作业在处理后已成功完成或带有警告或错误，所有作业介质已成功堆叠在适当的输出箱中，并且所有作业状态属性已达到作业的最终值。作业的JobStateReasons属性应包含以下值之一：COMPLETED_SUCCESSFULLY、COMPLETED_WITH_WARNINGS或COMPLETED_WITH_ERRORS。

  • Constructor Details

    • JobState

      protected JobState(int value)
      使用给定整数值构造新的作业状态枚举值。
      参数:
      value - 整数值

  • Method Details

    • getStringTable

      protected String[] getStringTable()
      返回类JobState的字符串表。
      覆盖:
      getStringTable 在类 EnumSyntax 中
      返回:
      字符串表

    • getEnumValueTable

      protected EnumSyntax[] getEnumValueTable()
      返回类JobState的枚举值表。
      覆盖:
      getEnumValueTable 在类 EnumSyntax 中
      返回:
      值表

    • getCategory

      public final Class<? extends Attribute> getCategory()
      获取用作此打印属性值的“类别”的打印属性类。

      对于类JobState和任何供应商定义的子类，类别是JobState类本身。

      指定者:
      getCategory 在接口 Attribute 中
      返回:
      打印属性类（类别），java.lang.Class类的实例

    • getName

      public final String getName()
      获取此属性值是其实例的类别的名称。

      对于类JobState和任何供应商定义的子类，类别名称是"job-state"。

      指定者:
      getName 在接口 Attribute 中
      返回:
      属性类别名称