JavaTM Platform
Standard Ed. 6

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 类定义了标准的作业状态原因值。Print Service 实现只需报告适合于特定实现的作业状态原因;它不必报告每个定义的作业状态原因。

JobStateReason 的实例不直接出现在 Print Job 的属性集中。但是,JobStateReasons 属性出现在 Print Job 的属性集中。JobStateReasons 属性包含零个、一个或多个 JobStateReason 对象,它们属于 Print Job 的状态。当 Print Job 的对应条件变为 true 时,打印机将 JobStateReason 对象添加到 Print Job 的 JobStateReasons 属性,且当对应条件变为 false 时,再移除 JobStateReason 对象,而不管 Print Job 的总体 JobState 是否也更改。

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

另请参见:
序列化表格

字段摘要
static JobStateReason ABORTED_BY_SYSTEM
          系统中止了作业。
static JobStateReason COMPRESSION_ERROR
          系统中止了作业,因为打印机在解压缩文档数据中遇到错误。
static JobStateReason DOCUMENT_ACCESS_ERROR
          打印机不能访问由引用传递的一个或多个文档(即打印数据表示形式对象为 URL)。
static JobStateReason DOCUMENT_FORMAT_ERROR
          系统中止了作业,因为打印机在处理文档数据时遇到错误。
static JobStateReason JOB_CANCELED_AT_DEVICE
          非标识本地用户取消了作业,即在设备控制台的用户取消了作业。
static JobStateReason JOB_CANCELED_BY_OPERATOR
          操作员取消了作业,操作员即用户,其已被授权为具有操作员权限(无论是本地还是远程)。
static JobStateReason JOB_CANCELED_BY_USER
          作业所有者取消了作业,作业所有者即用户,通过验证的该用户身份与创建 Print Job 的初始用户的值相同,或某位其他授权终端用户,例如作业所有者安全组成员。
static JobStateReason JOB_COMPLETED_SUCCESSFULLY
          作业成功完成。
static JobStateReason JOB_COMPLETED_WITH_ERRORS
          作业以错误结束(也可能是警告)。
static JobStateReason JOB_COMPLETED_WITH_WARNINGS
          作业以警告结束。
static JobStateReason JOB_DATA_INSUFFICIENT
          打印机已创建 Print Job,但打印机在可以将作业转为 PROCESSING 状态之前还需要额外的打印数据。
static JobStateReason JOB_HOLD_UNTIL_SPECIFIED
          为作业的 JobHoldUntil 属性值指定一个将来的日期-时间。
static JobStateReason JOB_INCOMING
          打印机已创建 Print Job,但打印机尚未完成访问或接收所有打印数据。
static JobStateReason JOB_INTERPRETING
          作业处于 PROCESSING 状态,更明确地讲,打印机正解释文档数据。
static JobStateReason JOB_OUTGOING
          打印机正将作业传输到输出设备。
static JobStateReason JOB_PRINTING
          输出设备为标记介质。
static JobStateReason JOB_QUEUED
          打印机处于 PROCESSING 状态,更明确地讲,打印机已对文档数据排队。
static JobStateReason JOB_QUEUED_FOR_MARKER
          打印机处于 PENDING_HELD、PENDING 或 PROCESSING 状态,更明确地讲,打印机已完成足够的文档处理,能够开始标记且作业正在等待标记。
static JobStateReason JOB_RESTARTABLE
          此作业被保留,且当前可以重新开始。
static JobStateReason JOB_TRANSFORMING
          作业处于 PROCESSING 状态,更明确地讲,打印机正解释文档数据并生成另一个电子表示形式。
static JobStateReason PRINTER_STOPPED
          打印机的 PrinterState 属性值为 STOPPED。
static JobStateReason PRINTER_STOPPED_PARTLY
          打印机的 PrinterStateReasons 属性值包含 STOPPED_PARTLY 的 PrinterStateReason 值。
static JobStateReason PROCESSING_TO_STOP_POINT
          请求者已取消作业,或打印机已中止作业,但打印机仍在执行该作业的某些操作,直到遇到指定的停止点,或已完成作业终止/清除操作。
static JobStateReason QUEUED_IN_DEVICE
          作业已被转发到某个不能发送回状态的设备或打印系统。
static JobStateReason RESOURCES_ARE_NOT_READY
          在候选作业的任何物理打印机上,至少有一个该作业所需的资源(例如介质、字体、资源对象等)未就绪。
static JobStateReason SERVICE_OFF_LINE
          打印机离线,不接受作业。
static JobStateReason SUBMISSION_INTERRUPTED
          由于某些不可预见的原因,作业未完成提交。
static JobStateReason UNSUPPORTED_COMPRESSION
          系统取消了作业,这是因为打印机尝试解压缩文档数据时确定该压缩实际上不在打印机所支持的文档数据中。
static JobStateReason UNSUPPORTED_DOCUMENT_FORMAT
          系统中止了作业,因为文档数据的文档格式(doc flavor)不在打印机所支持的格式中。
 
构造方法摘要
protected JobStateReason(int value)
          构造具有给定整数值的新 JobStateReason 枚举值。
 
方法摘要
 Class<? extends Attribute> getCategory()
          获取将被用作此打印属性值的“类别”的打印属性类。
protected  EnumSyntax[] getEnumValueTable()
          返回 JobStateReason 类的枚举值表。
 String getName()
          获取类别名称,此属性值为该类别的实例。
protected  String[] getStringTable()
          返回 JobStateReason 类的字符串表。
 
从类 javax.print.attribute.EnumSyntax 继承的方法
clone, getOffset, getValue, hashCode, readResolve, toString
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, notify, notifyAll, wait, wait, wait
 

字段详细信息

JOB_INCOMING

public static final JobStateReason JOB_INCOMING
打印机已创建 Print Job,但打印机尚未完成访问或接收所有打印数据。


JOB_DATA_INSUFFICIENT

public static final JobStateReason JOB_DATA_INSUFFICIENT
打印机已创建 Print Job,但打印机在可以将作业转为 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 属性值包含 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
输出设备为标记介质。此值适用于花费大量时间处理以下情况的打印机:(1) 当未发生标记并希望显示标记现在正在发生时,或者 (2)当作业正处于被取消或中止的进程中,同时作业保持在 PROCESSING 状态,但标记尚未停止,因此作业的印张或纸张计数仍在增加。


JOB_CANCELED_BY_USER

public static final JobStateReason JOB_CANCELED_BY_USER
作业所有者取消了作业,作业所有者即用户,通过验证的该用户身份与创建 Print Job 的初始用户的值相同,或某位其他授权终端用户,例如作业所有者安全组成员。此值应受支持。


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 flavor)不在打印机所支持的格式中。如果客户机指定了具有 "application/octet-stream" 的 MIME 类型的 doc flavor,则如果打印机不能通过自动感知确定文档数据的实际格式,则打印机可能中止该作业(即使打印机支持显式指定的文档格式)。此值必须受支持,因为每个文档都需要指定 doc flavor。


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
此作业被保留,且当前可以重新开始。如果作业的 JobStateReasons 属性中包含 JOB_RESTARTABLE,则打印机必须接受请求以重新开始该作业。如果支持重新开始作业,则此值应受支持。[目前 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)
构造具有给定整数值的新 JobStateReason 枚举值。

参数:
value - 整数值。
方法详细信息

getStringTable

protected String[] getStringTable()
返回 JobStateReason 类的字符串表。

覆盖:
EnumSyntax 中的 getStringTable
返回:
字符串表

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()
返回 JobStateReason 类的枚举值表。

覆盖:
EnumSyntax 中的 getEnumValueTable
返回:
值表

getCategory

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

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

指定者:
接口 Attribute 中的 getCategory
返回:
打印属性类(类别),它是 java.lang.Class 类的实例。

getName

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

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

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策