Класс 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 — это класс атрибута печати с целочисленным значением, указывающий общий размер документа или документов в К октетах, то есть в единицах по 1024 октета, которые необходимо обработать в задании. Значение необходимо округлить вверх: задание размером от 1 до 1024 октетов должно быть указано как 1 К октет, от 1025 до 2048 — как 2 К октета и т. д. Для задания печати с несколькими документами (задания с несколькими документами) значение JobKOctets вычисляется путем суммирования размеров отдельных документов в октетах с последующим округлением вверх до ближайшего значения в К октетах.

Атрибут JobKOctets описывает размер задания. Этот атрибут не предназначен для использования в качестве счетчика; он должен предоставлять полезную информацию для маршрутизации и планирования, если она известна. Если атрибут JobKOctets не указан в запросе на печать, принтер может попытаться вычислить его значение. Даже если клиент укажет значение атрибута JobKOctets в запросе на печать, принтер может изменить это значение, если способен вычислить более точное значение, чем указанное клиентом. Принтер может определить правильное значение атрибута JobKOctets как непосредственно при отправке задания, так и в любой момент позже.

Значение JobKOctets не должно учитывать множитель, обусловленный количеством копий, указанным атрибутом Copies, независимо от того, способен ли принтер печатать несколько копий без повторной обработки данных задания или документа и независимо от того, выполняется ли сортировка отпечатков. Таким образом, это значение не зависит от реализации и указывает размер документа или документов в К октетах независимо от количества копий.

Значение JobKOctets также не должно учитывать множитель, обусловленный инструкцией о количестве копий, встроенной в данные документа. Если данные документа фактически содержат дубликаты, это значение будет учитывать такое дублирование. Иными словами, это значение всегда соответствует размеру исходных данных документа, а не размеру создаваемого печатного экземпляра.

Размер документа вычисляется на основе класса представления печатных данных, указанного в DocFlavor документа, как показано в таблице ниже.

Таблица вычисления размеров документов
Класс представления	Размер документа
`byte[]`	Длина массива байтов
`java.io.InputStream`	Количество байтов, считанных из потока
`char[]`	Длина массива символов × 2
`java.lang.String`	Длина строки × 2
`java.io.Reader`	Количество символов, считанных из потока × 2
`java.net.URL`	Количество байтов, считанных из файла по указанному адресу `URL`
`java.awt.image.renderable.RenderableImage`	Зависит от реализации*
`java.awt.print.Printable`	Зависит от реализации*
`java.awt.print.Pageable`	Зависит от реализации*

* В этих случаях служба печати сама формирует данные печати, отправляемые на принтер. Если служба печати поддерживает атрибут JobKOctets, то в этих случаях она должна сама вычислить размер данных печати, заменив любое значение JobKOctets, указанное клиентом.

Совместимость с IPP: Целочисленное значение соответствует целочисленному значению IPP. Имя категории, возвращаемое методом getName(), соответствует имени атрибута IPP.

См. также:

Краткое описание конструкторов

Конструктор	Описание
`JobKOctets(int value)`	Создает новый атрибут задания в К октетах с указанным целочисленным значением.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает true, если этот атрибут задания в К октетах эквивалентен переданному объекту.
`final Class<? extends Attribute>`	`getCategory()`	Возвращает класс атрибута печати, который используется в качестве «категории» для значения этого атрибута печати.
`final String`	`getName()`	Возвращает имя категории, экземпляром которой является значение этого атрибута.

Методы, объявленные в классе IntegerSyntax

getValue, hashCode, toString

Методы, объявленные в классе Object

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

Подробное описание конструкторов

JobKOctets

public JobKOctets(int value)

Создает новый атрибут задания в К октетах с указанным целочисленным значением.

Параметры:: value — целочисленное значение
Исключения:: IllegalArgumentException — если value является отрицательным

Подробное описание методов

equals

public boolean equals(Object object)

Возвращает true, если этот атрибут задания в К октетах эквивалентен переданному объекту. Для эквивалентности должны выполняться все следующие условия:

object не является null.
object является экземпляром класса JobKOctets.
Значение этого атрибута задания в К октетах и значение object равны.

Переопределяет:

equals в классе IntegerSyntax

Параметры:

object — Object для сравнения

Возвращает:

true, если object эквивалентен этому атрибуту задания в К октетах, в противном случае — false

См. также:

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
Возвращает:: имя категории атрибута

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/JobKOctets.html