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

Class 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字符串表示形式。

参见:

  • Field Details

    • 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作业状态，并向作业的JobStateReasons属性添加COMPLETED_WITH_ERRORS原因，取决于实现和/或站点策略。如果打印机支持具有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属性值包含STOPPED_PARTLY的PrinterStateReason值。

    • PRINTER_STOPPED

      public static final JobStateReason PRINTER_STOPPED
      打印机的PrinterState属性值为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
      输出设备正在标记介质。对于那些在没有标记发生时花费大量时间处理的打印机，此值很有用，然后希望显示现在正在进行标记，或者当作业正在被取消或中止的过程中，作业仍处于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
      作业已被系统中止，因为文档数据的文档格式（文档类型）不属于打印机支持的文档格式之列。如果客户端指定具有"application/octet-stream" MIME类型的文档类型，如果打印机无法通过自动感知确定文档数据的实际格式（即使打印机支持明确指定的文档格式），则打印机可能会中止作业。必须支持此值，因为必须为每个文档指定一个文档类型。

    • 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打印服务API中尚未包含重新启动作业的功能。]

    • QUEUED_IN_DEVICE

      public static final JobStateReason QUEUED_IN_DEVICE
      作业已转发到无法发送状态的设备或打印系统。打印机将作业的JobState属性设置为COMPLETED，并将QUEUED_IN_DEVICE原因添加到作业的JobStateReasons属性中，以指示打印机对作业没有更多信息，也永远不会有更好的信息。

  • Constructor Details

    • JobStateReason

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

  • Method Details

    • getStringTable

      protected String[] getStringTable()
      返回类JobStateReason的字符串表。
      覆盖：
      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中
      返回：
      属性类别名称