src/share/classes/javax/print/attribute/standard/Destination.java

Print this page




  33 
  34 /**
  35  * Class Destination is a printing attribute class, a URI, that is used to
  36  * indicate an alternate destination for the spooled printer formatted
  37  * data. Many PrintServices will not support the notion of a destination
  38  * other than the printer device, and so will not support this attribute.
  39  * <p>
  40  * A common use for this attribute will be applications which want
  41  * to redirect output to a local disk file : eg."file:out.prn".
  42  * Note that proper construction of "file:" scheme URI instances should
  43  * be performed using the <code>toURI()</code> method of class
  44  * {@link java.io.File File}.
  45  * See the documentation on that class for more information.
  46  * <p>
  47  * If a destination URI is specified in a PrintRequest and it is not
  48  * accessible for output by the PrintService, a PrintException will be thrown.
  49  * The PrintException may implement URIException to provide a more specific
  50  * cause.
  51  * <P>
  52  * <B>IPP Compatibility:</B> Destination is not an IPP attribute.
  53  * <P>
  54  *
  55  * @author  Phil Race.
  56  */
  57 public final class Destination extends URISyntax
  58         implements PrintJobAttribute, PrintRequestAttribute {
  59 
  60     private static final long serialVersionUID = 6776739171700415321L;
  61 
  62     /**
  63      * Constructs a new destination attribute with the specified URI.
  64      *
  65      * @param  uri  URI.
  66      *
  67      * @exception  NullPointerException
  68      *     (unchecked exception) Thrown if <CODE>uri</CODE> is null.
  69      */
  70     public Destination(URI uri) {
  71         super (uri);
  72     }
  73 




  33 
  34 /**
  35  * Class Destination is a printing attribute class, a URI, that is used to
  36  * indicate an alternate destination for the spooled printer formatted
  37  * data. Many PrintServices will not support the notion of a destination
  38  * other than the printer device, and so will not support this attribute.
  39  * <p>
  40  * A common use for this attribute will be applications which want
  41  * to redirect output to a local disk file : eg."file:out.prn".
  42  * Note that proper construction of "file:" scheme URI instances should
  43  * be performed using the <code>toURI()</code> method of class
  44  * {@link java.io.File File}.
  45  * See the documentation on that class for more information.
  46  * <p>
  47  * If a destination URI is specified in a PrintRequest and it is not
  48  * accessible for output by the PrintService, a PrintException will be thrown.
  49  * The PrintException may implement URIException to provide a more specific
  50  * cause.
  51  * <P>
  52  * <B>IPP Compatibility:</B> Destination is not an IPP attribute.

  53  *
  54  * @author  Phil Race.
  55  */
  56 public final class Destination extends URISyntax
  57         implements PrintJobAttribute, PrintRequestAttribute {
  58 
  59     private static final long serialVersionUID = 6776739171700415321L;
  60 
  61     /**
  62      * Constructs a new destination attribute with the specified URI.
  63      *
  64      * @param  uri  URI.
  65      *
  66      * @exception  NullPointerException
  67      *     (unchecked exception) Thrown if <CODE>uri</CODE> is null.
  68      */
  69     public Destination(URI uri) {
  70         super (uri);
  71     }
  72