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

Методы, объявленные в классе 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.
URI этого атрибута места назначения и object объекта 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/attribute/standard/Destination.html