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 オクテットなどとなるように切り上げて表示されなければいけません。 multidoc 印刷ジョブ (複数のドキュメントを持つジョブ) の場合、JobKOctets の値は、個々のドキュメントのサイズをオクテット単位で合計して、次の K オクテットの値に切り上げることよって計算されます。

JobKOctets 属性はジョブのサイズを記述します。この属性は、カウンタとなるためのものではありません。これは、有益な経路構成とスケジューリング情報 (既知の場合) となるためのものです。プリンタは、Print Request に指定されない場合、JobKOctets 属性の値を計算しようとします。クライアントが JobKOctets 属性の値を Print Request に指定する場合でも、プリンタが、クライアントが指定した値より正確な値を計算できる場合、プリンタは値の変更を選択できます。プリンタは、ちょうどジョブを送信した時間またはそのしばらくあとに 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 属性をサポートする場合、クライアントが指定した JobKOctets の値に置き換えるために、これらの場合に対して Print Service 自体が印刷データのサイズを計算しなければいけません。

IPP 互換性: 整数値は IPP 整数値を示します。getName() によって返されるカテゴリ名は IPP 属性の名前を示します。

関連項目:

JobKOctetsSupported, JobKOctetsProcessed, JobImpressions, JobMediaSheets, 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
JobKOctets(int value) 指定された整数値で新しいジョブ K オクテット属性を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	equals(Object object) このジョブ K オクテット属性がオブジェクトに渡された属性と等しいかどうかを返します。
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)

指定された整数値で新しいジョブ K オクテット属性を構築します。

パラメータ:

value - 整数値。

例外:

IllegalArgumentException - 非チェック例外。value が 0 より小さい場合にスローされる。

メソッドの詳細

equals

public boolean equals(Object object)

このジョブ K オクテット属性がオブジェクトに渡された属性と等しいかどうかを返します。次の条件がすべて true の場合に同等とみなされます。

1. object が null ではない。
2. object が JobKOctets クラスのインスタンスである。
3. このジョブ K オクテット属性の値と object の値が同じである。

オーバーライド:

equals、クラス: IntegerSyntax

パラメータ:

object - 比較対象のオブジェクト。

戻り値:

object がこのジョブ K オクテット属性と等しい場合は true、そうでない場合は false。

関連項目:

Object.hashCode()、HashMap

getCategory

public final Class<? extends Attribute> getCategory()

この印刷属性値の「カテゴリ」として使用される印刷属性クラスを返します。

JobKOctets クラスの場合、カテゴリは JobKOctets クラス自体です。

定義:

getCategory、インタフェース: Attribute

戻り値:

印刷属性クラス (カテゴリ)、java.lang.Class クラスのインスタンス。

getName

public final String getName()

属性値がインスタンスとなるカテゴリの名前を返します。

JobKOctets クラスの場合、カテゴリ名は "job-k-octets" です。

定義:

getName、インタフェース: Attribute

戻り値:

属性カテゴリの名前