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

返回：

屬性類別別名稱。