模块 java.desktop
包 javax.print.attribute.standard

类 JobStateReason

java.lang.Object
javax.print.attribute.EnumSyntax
javax.print.attribute.standard.JobStateReason
所有已实现的接口：
Serializable , Cloneable , Attribute
public class JobStateReason extends EnumSyntax implements Attribute
类 JobStateReason 是一个打印属性类，一个枚举，它提供有关作业当前状态的附加信息，即增加作业的 JobState 属性值的信息。类 JobStateReason 定义标准作业状态原因值。打印服务实现只需要报告适合特定实现的作业状态原因；它不必报告每个定义的作业状态原因。

JobStateReason 的实例不会直接出现在打印作业的属性集中。相反，JobStateReasons 属性出现在打印作业的属性集中。 JobStateReasons 属性包含零个、一个或多个与打印作业状态相关的 JobStateReason 对象。当打印作业的相应条件变为真时，打印机将 JobStateReason 对象添加到打印作业的JobStateReasons 属性，当相应条件变为假时，打印机再次删除JobStateReason对象，而不管打印作业的整体JobState 是否也发生了变化。

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

参见：

  • 字段详细信息

    • JOB_INCOMING

      public static final JobStateReason  JOB_INCOMING
      打印机已创建打印作业，但打印机尚未完成访问或接受所有打印数据。

    • JOB_DATA_INSUFFICIENT

      public static final JobStateReason  JOB_DATA_INSUFFICIENT
      打印机已创建打印作业，但打印机需要额外的打印数据才能将作业移至 PROCESSING 状态。如果打印机在收到所有数据之前开始处理，则打印机会删除 JOB_DATA_INSUFFICIENT 原因，但 JOB_INCOMING 原因仍然存在。如果打印机在接收到所有数据后开始处理，打印机会同时删除JOB_DATA_INSUFFICIENT 和JOB_INCOMING 原因。

    • DOCUMENT_ACCESS_ERROR

      public static final JobStateReason  DOCUMENT_ACCESS_ERROR
      打印机无法访问通过引用传递的一个或多个文档（即打印数据表示对象是 URL ）。此原因旨在涵盖任何文件访问问题，包括文件不存在和由于访问控制问题而拒绝访问。打印机是中止作业并将作业移至 ABORTED 作业状态，还是打印所有可访问的文档并将作业移至 COMPLETED 作业状态并将 COMPLETED_WITH_ERRORS 原因添加到作业的 JobStateReasons 属性取决于实施和/或站点策略。如果打印机支持 URL 打印数据表示对象的文档风格，则应支持此值。

    • SUBMISSION_INTERRUPTED

      public static final JobStateReason  SUBMISSION_INTERRUPTED
      由于某些不可预见的原因，作业没有完全提交。可能性包括 (1) 打印机在客户完全提交作业之前崩溃，(2) 在文档数据完全传输到打印机之前，打印机或文档传输方法以某种不可恢复的方式崩溃，(3 ) 客户端在作业完全提交之前崩溃。

    • JOB_OUTGOING

      public static final JobStateReason  JOB_OUTGOING
      打印机正在将作业传输到输出设备。

    • JOB_HOLD_UNTIL_SPECIFIED

      public static final JobStateReason  JOB_HOLD_UNTIL_SPECIFIED
      作业的 JobHoldUntil 属性的值是使用仍处于未来的日期时间指定的。在删除此原因并且没有其他原因保留该工作之前，该工作不得成为处理的候选人。如果支持 JobHoldUntil 作业模板属性，则应支持此值。

    • RESOURCES_ARE_NOT_READY

      public static final JobStateReason  RESOURCES_ARE_NOT_READY
      作业所需的至少一种资源（例如媒体、字体、资源对象等）在作业候选的任何物理打印机上都没有准备好。这种情况可能会在作业被接受时检测到，或者随后在作业挂起或处理时检测到，具体取决于实施方式。根据实施和/或作业调度策略，作业可能会保持其当前状态或移动到 PENDING_HELD 状态。

    • PRINTER_STOPPED_PARTLY

      public static final JobStateReason  PRINTER_STOPPED_PARTLY
      打印机的 PrinterStateReasons 属性值包含 PrinterStateReason 值 STOPPED_PARTLY 。

    • PRINTER_STOPPED

      public static final JobStateReason  PRINTER_STOPPED
      打印机的 PrinterState 属性值 ia STOPPED 。

    • JOB_INTERPRETING

      public static final JobStateReason  JOB_INTERPRETING
      作业处于 PROCESSING 状态，但更具体地说，打印机正在解释文档数据。

    • JOB_QUEUED

      public static final JobStateReason  JOB_QUEUED
      作业处于 PROCESSING 状态，但更具体地说，打印机已将文档数据排队。

    • JOB_TRANSFORMING

      public static final JobStateReason  JOB_TRANSFORMING
      作业处于 PROCESSING 状态，但更具体地说，打印机正在解释文档数据并生成另一种电子表示形式。

    • JOB_QUEUED_FOR_MARKER

      public static final JobStateReason  JOB_QUEUED_FOR_MARKER
      作业处于 PENDING_HELD、PENDING 或 PROCESSING 状态，但更具体地说，打印机已完成足够的文档处理，可以开始标记，作业正在等待标记。需要人工干预才能释放作业的系统会将作业置于 PENDING_HELD 作业状态。自动选择作业以使用标记的系统将作业置于 PENDING 作业状态或在等待标记时将作业保持在 PROCESSING 作业状态，具体取决于实现。当标记确实开始时，所有实现都会将作业置于（或返回）PROCESSING 状态。

    • JOB_PRINTING

      public static final JobStateReason  JOB_PRINTING
      输出设备正在标记介质。此值对于花费大量时间处理 (1) 未进行标记然后想要显示正在进行标记或 (2) 正在取消或中止作业的打印机来说非常有用作业仍处于 PROCESSING 状态，但标记尚未停止，因此作业的印数或印张数仍在增加。

    • JOB_CANCELED_BY_USER

      public static final JobStateReason  JOB_CANCELED_BY_USER
      作业被作业的所有者取消，即被其认证身份与创建打印作业的原始用户的值相同的用户取消，或被其他一些授权的最终用户取消，例如作业所有者的安全组。这个值应该得到支持。

    • JOB_CANCELED_BY_OPERATOR

      public static final JobStateReason  JOB_CANCELED_BY_OPERATOR
      作业已被操作员取消，即被已被验证为具有操作员权限（无论是本地还是远程）的用户取消。如果安全策略允许任何人取消任何人的工作，那么当工作被除工作所有者以外的其他人取消时可以使用该值。对于这样的安全策略，实际上，就取消作业而言，每个人都是操作员。如果实现允许作业所有者以外的其他人取消，则应支持此值。

    • JOB_CANCELED_AT_DEVICE

      public static final JobStateReason  JOB_CANCELED_AT_DEVICE
      该作业被身份不明的本地用户取消，即设备控制台上的用户。如果实现支持在控制台取消作业，则应支持此值。

    • ABORTED_BY_SYSTEM

      public static final JobStateReason  ABORTED_BY_SYSTEM
      作业被系统中止。作业 (1) 正在中止，(2) 已被系统中止并置于 ABORTED 状态，或 (3) 已被系统中止并置于 PENDING_HELD 状态，以便用户或操作员可以手动再次尝试作业。这个值应该得到支持。

    • UNSUPPORTED_COMPRESSION

      public static final JobStateReason  UNSUPPORTED_COMPRESSION
      作业被系统中止，因为打印机在尝试解压缩文档数据时确定压缩实际上不在打印机支持的范围内。必须支持此值，因为 Compression 是必需的文档描述属性。

    • COMPRESSION_ERROR

      public static final JobStateReason  COMPRESSION_ERROR
      作业被系统中止，因为打印机在解压缩文档数据时遇到错误。如果打印机发布此原因，则文档数据已通过任何可能导致 UNSUPPORTED_COMPRESSION 作业状态原因的测试。

    • UNSUPPORTED_DOCUMENT_FORMAT

      public static final JobStateReason  UNSUPPORTED_DOCUMENT_FORMAT
      作业被系统中止，因为文档数据的文档格式（doc 风格）不属于打印机支持的格式。如果客户端指定 MIME 类型为 "application/octet-stream" 的文档风格，如果打印机无法通过自动检测确定文档数据的实际格式（即使打印机支持明确指定的文档格式），打印机也可能会中止作业。必须支持此值，因为需要为每个文档指定文档风格。

    • DOCUMENT_FORMAT_ERROR

      public static final JobStateReason  DOCUMENT_FORMAT_ERROR
      作业被系统中止，因为打印机在处理文档数据时遇到错误。如果打印机发布此原因，则文档数据已通过任何可能导致 UNSUPPORTED_DOCUMENT_FORMAT 作业状态原因的测试。

    • PROCESSING_TO_STOP_POINT

      public static final JobStateReason  PROCESSING_TO_STOP_POINT
      请求者已取消作业或打印机已中止作业，但打印机仍在对作业执行某些操作，直到出现指定的停止点或作业终止/清理完成。

      如果实施需要一些可测量的时间来取消处于 PROCESSING 或 PROCESSING_STOPPED 作业状态的作业，则打印机必须使用此原因来指示打印机仍在对作业执行某些操作，同时作业仍处于 PROCESSING 或 PROCESSING_STOPPED 状态。在作业的所有作业描述属性停止递增后，打印机将作业从 PROCESSING 状态移至 CANCELED 或 ABORTED 作业状态。

    • SERVICE_OFF_LINE

      public static final JobStateReason  SERVICE_OFF_LINE
      打印机处于离线状态并且不接受任何作业。所有 PENDING 作业都进入 PENDING_HELD 状态。如果服务或文档转换的输入受损或损坏，则可能会出现这种情况。

    • JOB_COMPLETED_SUCCESSFULLY

      public static final JobStateReason  JOB_COMPLETED_SUCCESSFULLY
      作业成功完成。这个值应该得到支持。

    • JOB_COMPLETED_WITH_WARNINGS

      public static final JobStateReason  JOB_COMPLETED_WITH_WARNINGS
      作业已完成，但出现警告。如果实现检测到警告，则应支持此值。

    • JOB_COMPLETED_WITH_ERRORS

      public static final JobStateReason  JOB_COMPLETED_WITH_ERRORS
      作业完成但有错误（也可能有警告）。如果实现检测到错误，则应支持此值。

    • JOB_RESTARTABLE

      public static final JobStateReason  JOB_RESTARTABLE
      此作业已保留，目前可以重新启动。如果 JOB_RESTARTABLE 包含在作业的 JobStateReasons 属性中，则打印机必须接受重新启动该作业的请求。如果支持重新启动作业，则应支持此值。[重新启动作业的能力目前不在 Java Print Service API 中。]

    • QUEUED_IN_DEVICE

      public static final JobStateReason  QUEUED_IN_DEVICE
      作业已转发到无法发回状态的设备或打印系统。打印机将作业的 JobState 属性设置为 COMPLETED，并将 QUEUED_IN_DEVICE 原因添加到作业的 JobStateReasons 属性，以指示打印机没有关于该作业的其他信息，并且永远不会有任何更好的信息。

  • 构造方法详细信息

    • JobStateReason

      protected JobStateReason(int value)
      使用给定的整数值构造一个新的作业状态原因枚举值。
      参数：
      value - 整数值

  • 方法详情

    • getStringTable

      protected String [] getStringTable()
      返回 JobStateReason string table
      重写：
      getStringTable 在类 EnumSyntax 中
      返回：
      字符串表

    • getEnumValueTable

      protected EnumSyntax [] getEnumValueTable()
      返回类 JobStateReason 的枚举值表。
      重写：
      getEnumValueTable 在类 EnumSyntax 中
      返回：
      值表

    • getCategory

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

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

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

    • getName

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

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

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