Класс 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[]`	Длина символьного массива 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`	Зависит от реализации*

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

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

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает, эквивалентен ли этот атрибут задания К байт переданному объекту.
`final Class<? extends Attribute>`	`getCategory()`	Получает класс атрибута печати, который должен использоваться в качестве "категории" для этого значения атрибута печати.
`final 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)

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

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

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

equals

public boolean equals(Object object)

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

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

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

equals в классе IntegerSyntax

Параметры:

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/JobKOctets.html