Класс 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()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

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

getValue, hashCode, toString

Модификатор и тип	Метод	Описание
`int`	`getValue()`	Возвращает целочисленное значение этого целочисленного атрибута.
`int`	`hashCode()`	Возвращает хеш-код этого целочисленного атрибута.
`String`	`toString()`	Возвращает строковое представление этого целочисленного атрибута.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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, 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.