javax.print.attribute.standard
類別 JobKOctets

java.lang.Object
  javax.print.attribute.IntegerSyntax
      javax.print.attribute.standard.JobKOctets

所有已實作的介面：

Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute

public final class JobKOctets
extends IntegerSyntax
implements PrintRequestAttribute, PrintJobAttribute

JobKOctets 類別是整數值形式的列印屬性類別，它指定了以 K 位元組為單位的文檔總大小，即以要在作業中處理的所請求的 1024 位元組為單位。必須對該值進行捨入操作，這樣 1 位元組和 1024 位元組之間的作業必須指示為 1K 位元組，1025 到 2048 必須指示為 2K 位元組， 依此類別推。對於多文檔列印作業（具有多個文檔的作業），JobKOctets 值的計算是通過累加單個文檔的位元組大小，然後捨入到最近的 K 位元組值來實作的。

JobKOctets 屬性描述了作業的大小。此屬性不是計數器，它應是有用的路徑和計劃資訊（如果已知）。如果在 Print Request 中未提供 JobKOctets 屬性值，則印表機可能嘗試計算該值。即使客戶機在 Print Request 中提供了 JobKOctets 屬性值，如果印表機能夠計算出比客戶機所提供的值更精確的值，則印表機可以選擇更改該值。在剛好提交作業的時刻，或提交後的任意時刻，印表機可以確定 JobKOctets 屬性的正確值。

JobKOctets 值不能包括由 Copies 屬性指定的副本數所產生的乘數，這與設備能否在無需多次傳遞作業或文檔資料的情況下處理多個副本無關，並且與輸出是否逐份列印無關。因此，該值與實作無關，它指示文檔（或多個文檔）大小，度量單位是與副本數無關的 K 位元組。

JobKOctets 值不能包括由嵌入文檔資料的副本指令產生的乘數。如果文檔資料實際上包括文檔資料的複製，則此值將包括這樣的複製。換句話說，此值總是源文檔資料的大小，而不是要產生的硬拷貝輸出的度量。

文檔大小是根據文檔的 DocFlavor 指定的列印資料表示形式類別計算的，如下表所示。

表示形式類別	文檔大小
byte[]	位元組陣列的長度
java.io.InputStream	從串流讀取的位元組數
char[]	字元陣列的長度 x 2
java.lang.String	字元串的長度 x 2
java.io.Reader	從串流讀取的字元數 x 2
java.net.URL	從給定的 URL 位址處的檔案讀取的位元組數
java.awt.image.renderable.RenderableImage	與實作有關*
java.awt.print.Printable	與實作有關*
java.awt.print.Pageable	與實作有關*

* 在這些情況下，Print Service 本身產生要發送到印表機的列印資料。如果 Print Service 支持 JobKOctets 屬性，則對於這些情況，Print Service 本身必須計算列印資料的大小，替換客戶機所指定的任何 JobKOctets 值。

IPP Compatibility: 整數值給出了 IPP 整數值。getName() 所返回的類別別名稱給出了 IPP 屬性名稱。

另請參見：

JobKOctetsSupported, JobKOctetsProcessed, JobImpressions, JobMediaSheets, 序列化表格

建構子摘要

JobKOctets(int value)
建構具有給定整數值的新 JobKOctets 屬性。

方法摘要

boolean	equals(Object object) 返回此 JobKOctets 屬性是否等效於傳入的物件。
Class<? extends Attribute>	getCategory() 獲取將被用作此列印屬性值的“類別別”的列印屬性類別。
String	getName() 獲取類別別名稱，此屬性值為該類別別的實例。

從類別 javax.print.attribute.IntegerSyntax 繼承的方法

getValue, hashCode, toString

從類別 java.lang.Object 繼承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

JobKOctets

public JobKOctets(int value)

建構具有給定整數值的新 JobKOctets 屬性。

參數：

value - 整數值。

拋出：

IllegalArgumentException - （未檢查的異常）如果 value 小於 0，則拋出該異常。

方法詳細資訊

equals

public boolean equals(Object object)

返回此 JobKOctets 屬性是否等效於傳入的物件。若要等效，以下所有條件都必須為 true：

1. object 不為 null。
2. object 為 JobKOctets 類別的實例。
3. 此 JobKOctets 屬性值與 object 的值相等。

覆寫：

類別 IntegerSyntax 中的 equals

參數：

object - 要比較的 Object。

返回：

如果 object 等效於此 JobKOctets 屬性，則返回 true，否則返回 false。

另請參見：

Object.hashCode(), Hashtable

getCategory

public final Class<? extends Attribute> getCategory()

獲取將被用作此列印屬性值的“類別別”的列印屬性類別。

對於 JobKOctets 類別，類別別為 JobKOctets 類別本身。

指定者：

介面 Attribute 中的 getCategory

返回：

列印屬性類別（類別別），它是 java.lang.Class 類別的實例。

getName

public final String getName()

獲取類別別名稱，此屬性值為該類別別的實例。

對於 JobKOctets 類別，類別別名稱為 "job-k-octets"。

指定者：

介面 Attribute 中的 getName

返回：

屬性類別別名稱。