Класс 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, который используется для указания альтернативного назначения для данных, отправленных на печать. Многие PrintService не поддерживают понятие назначения, отличного от устройства принтера, и поэтому не будут поддерживать этот атрибут.

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

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

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

См. также:: Сериализованная форма

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

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

Методы

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

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

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