Класс 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". Обратите внимание, что правильное построение схемы "file:" URI должно выполняться с использованием метода toURI() класса File. См. документацию по этому классу для получения дополнительной информации.

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

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

См. также:

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

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

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

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

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

getURI, hashCode, toString

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

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

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

Destination

public Destination(URI uri)

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

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

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

equals

public boolean equals(Object object)

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

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

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

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/Destination.html