Класс 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.

См. также:: JobKOctetsSupported, JobKOctetsProcessed, JobImpressions, JobMediaSheets, Сериализованная форма

Конструкторы

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

Методы

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

Методы

equals

public boolean equals(Object object)

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

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

Переопределяет:: equals в классе IntegerSyntax
Параметры:: object — объект Object для сравнения
Возвращает:: true если object эквивалентен атрибуту задания K байт, false в противном случае
См. также:: Object.hashCode(), HashMap

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