javax.print.attribute.standard
クラス JobKOctets

java.lang.Object
  |
  +--javax.print.attribute.IntegerSyntax
        |
        +--javax.print.attribute.standard.JobKOctets

すべての実装インタフェース:

Attribute, Cloneable, PrintJobAttribute, PrintRequestAttribute, Serializable

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	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 の値が同じである

オーバーライド:

クラス IntegerSyntax 内の equals

パラメータ:

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

戻り値:

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

getCategory

public final Class getCategory()

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

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

定義:

インタフェース Attribute 内の getCategory

戻り値:

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

getName

public final String getName()

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

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

定義:

インタフェース Attribute 内の getName

戻り値:

属性のカテゴリの名前