Класс Destination

java.lang.Object

javax.print.attribute.URISyntax

javax.print.attribute.standard.Destination

Все реализуемые интерфейсы:: Serializable, Cloneable, Attribute, PrintJobAttribute, PrintRequestAttribute

public final class Destination extends URISyntax implements PrintJobAttribute, PrintRequestAttribute

Класс Destination — это класс атрибута печати, URI, используемый для указания альтернативного назначения форматированных данных, помещённых в очередь печати. Многие PrintServices не поддерживают понятие назначения, отличного от устройства принтера, и поэтому не поддерживают этот атрибут.

Этот атрибут часто используется приложениями, которым необходимо перенаправить вывод в локальный файл на диске, например «file:out.prn». Обратите внимание, что экземпляры URI схемы «file:» следует правильно создавать с помощью метода toURI() класса File. Дополнительные сведения см. в документации этого класса.

Если в PrintRequest указано назначение URI, недоступное для вывода через PrintService, будет выброшено исключение PrintException. PrintException может реализовать URIException, чтобы предоставить более конкретную причину.

Совместимость с IPP: Destination не является атрибутом IPP.

См. также:

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

Конструктор	Описание
`Destination(URI uri)`	Создаёт новый атрибут назначения с указанным `URI`.

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object object)`	Возвращает, эквивалентен ли этот атрибут назначения переданному объекту.
`final Class<? extends Attribute>`	`getCategory()`	Возвращает класс атрибута печати, который используется в качестве «категории» для этого значения атрибута печати.
`final String`	`getName()`	Возвращает имя категории, экземпляром которой является это значение атрибута.

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

getURI, hashCode, toString

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

Методы, объявленные в классе 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, либо до истечения заданного интервала реального времени.

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

Destination

public Destination(URI uri)

Создаёт новый атрибут назначения с указанным URI.

Параметры:: uri — URI
Исключения:: NullPointerException — если uri равен null

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

equals

public boolean equals(Object object)

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

object не равен null.
object является экземпляром класса Destination.
URI этого атрибута назначения и URI объекта object равны.

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

equals в классе URISyntax

Параметры:

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

Возвращает:

true, если object эквивалентен этому атрибуту назначения, иначе false

См. также:

getCategory

public final Class<? extends Attribute> getCategory()

Возвращает класс атрибута печати, который используется в качестве «категории» для этого значения атрибута печати.

Для класса Destination категорией является сам класс Destination.

Определено в:: getCategory в интерфейсе Attribute
Возвращает:: класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()

Возвращает имя категории, экземпляром которой является это значение атрибута.

Для класса Destination именем категории является "spool-data-destination".

Определено в:: 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.