Класс 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 не должно включать множители, вносимые количеством копий, указанных атрибутом 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)`	Возвращает, эквивалентен ли этот атрибут задания в К байтах переданному объекту.
`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 - 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, 2023, 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/21/docs/api/java.desktop/javax/print/attribute/standard/JobKOctets.html