Класс 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 октетов и т.д. Для задания печати с несколькими документами (задания с несколькими документами) значение вычисляется путем суммирования размеров отдельных документов в октетах, а затем округления до ближайшего значения K октетов.

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

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

Значение 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)`	Создает новый атрибут задания K октетов со значением целого числа.

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает, эквивалентен ли этот атрибут задания K октетов переданному объекту.
`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)

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

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

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

equals

public boolean equals(Object object)

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

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

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

equals в классе IntegerSyntax

Параметры:

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

Возвращает:

true если object эквивалентен этому атрибуту задания K октетов, 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, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/standard/JobKOctets.html