javax.print.attribute.standard

Class Destination

java.lang.Object

javax.print.attribute.URISyntax

javax.print.attribute.standard.Destination

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, javax.print.attribute.Attribute, javax.print.attribute.PrintJobAttribute, javax.print.attribute.PrintRequestAttribute

public final class Destination
extends javax.print.attribute.URISyntax
implements javax.print.attribute.PrintJobAttribute, javax.print.attribute.PrintRequestAttribute

The Destination attribute provides a URI for an alternate destination of the printing output.

As not an IPP attribute many print services will not support this attribute and only provide the printer device as a destination. An alternate output destination would be a file on the local harddisk given as a file scheme URI.

If a print service does not support the destination attributes URI it will throw a PrintException. This exception may further implement the interface URIException.

IPP Compatibility: Destination is not an IPP 1.1 attribute.

See Also:

PrintException, URIException, Serialized Form

Constructor Summary

Constructors

Constructor and Description
Destination(java.net.URI uri) Constructs a Destination object.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Tests if the given object is equal to this object.
java.lang.Class<? extends javax.print.attribute.Attribute>	getCategory() Returns category of this class.
java.lang.String	getName() Returns the name of this attribute.

Methods inherited from class javax.print.attribute.URISyntax

getURI, hashCode, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Destination

public Destination(java.net.URI uri)

Constructs a Destination object.

Parameters:

uri - the URI of the output destination.

Throws:

java.lang.NullPointerException - if the given uri is null.

Method Detail

equals

public boolean equals(java.lang.Object obj)

Tests if the given object is equal to this object.

Overrides:

equals in class javax.print.attribute.URISyntax

Parameters:

obj - the object to test

Returns:

true if both objects are equal, false otherwise.

See Also:

Object.hashCode()

getCategory

public java.lang.Class<? extends javax.print.attribute.Attribute> getCategory()

Returns category of this class.

Specified by:

getCategory in interface javax.print.attribute.Attribute

Returns:

The class Destination itself.

getName

public java.lang.String getName()

Returns the name of this attribute.

Specified by:

getName in interface javax.print.attribute.Attribute

Returns:

The name "spool-data-destination"