java.lang.Object
javax.print.attribute.URISyntax
javax.print.attribute.standard.Destination
- All Implemented Interfaces:
Serializable
,Cloneable
,Attribute
,PrintJobAttribute
,PrintRequestAttribute
public final class Destination
extends URISyntax
implements PrintJobAttribute, PrintRequestAttribute
Class
Destination
is a printing attribute class, a URI
, that
is used to indicate an alternate destination for the spooled printer
formatted data. Many PrintServices
will not support the notion of a
destination other than the printer device, and so will not support this
attribute.
A common use for this attribute will be applications which want to redirect
output to a local disk file : eg."file:out.prn". Note that proper
construction of "file:" scheme URI
instances should be performed
using the toURI()
method of class File
. See the
documentation on that class for more information.
If a destination URI
is specified in a PrintRequest and it is not
accessible for output by the PrintService
, a PrintException
will be thrown. The PrintException
may implement URIException
to provide a more specific cause.
IPP Compatibility: Destination is not an IPP attribute.
- See Also:
-
Constructor Summary
ConstructorDescriptionDestination
(URI uri) Constructs a new destination attribute with the specifiedURI
. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Returns whether this destination attribute is equivalent to the passed in object.Get the printing attribute class which is to be used as the "category" for this printing attribute value.final String
getName()
Get the name of the category of which this attribute value is an instance.
-
Constructor Details
-
Destination
Constructs a new destination attribute with the specifiedURI
.- Parameters:
uri
-URI
- Throws:
NullPointerException
- ifuri
isnull
-
-
Method Details
-
equals
Returns whether this destination attribute is equivalent to the passed in object. To be equivalent, all of the following conditions must be true:object
is notnull
.object
is an instance of classDestination
.- This destination attribute's
URI
andobject
'sURI
are equal.
-
getCategory
Get the printing attribute class which is to be used as the "category" for this printing attribute value.For class
Destination
, the category is classDestination
itself.- Specified by:
getCategory
in interfaceAttribute
- Returns:
- printing attribute class (category), an instance of class
java.lang.Class
-
getName
Get the name of the category of which this attribute value is an instance.For class
Destination
, the category name is"spool-data-destination"
.
-