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

Print this page




  24  */
  25 package javax.print.attribute.standard;
  26 
  27 import java.util.Locale;
  28 
  29 import javax.print.attribute.Attribute;
  30 import javax.print.attribute.TextSyntax;
  31 import javax.print.attribute.PrintServiceAttribute;
  32 
  33 /**
  34  * Class PrinterName is a printing attribute class, a text attribute, that
  35  * specifies the name of a printer. It is a name that is more end-user friendly
  36  * than a URI. An administrator determines a printer's name and sets this
  37  * attribute to that name. This name may be the last part of the printer's URI
  38  * or it may be unrelated. In non-US-English locales, a name may contain
  39  * characters that are not allowed in a URI.
  40  * <P>
  41  * <B>IPP Compatibility:</B> The string value gives the IPP name value. The
  42  * locale gives the IPP natural language. The category name returned by
  43  * <CODE>getName()</CODE> gives the IPP attribute name.
  44  * <P>
  45  *
  46  * @author  Alan Kaminsky
  47  */
  48 public final class PrinterName extends TextSyntax
  49         implements PrintServiceAttribute {
  50 
  51     private static final long serialVersionUID = 299740639137803127L;
  52 
  53     /**
  54      * Constructs a new printer name attribute with the given name and locale.
  55      *
  56      * @param  printerName  Printer name.
  57      * @param  locale       Natural language of the text string. null
  58      * is interpreted to mean the default locale as returned
  59      * by <code>Locale.getDefault()</code>
  60      *
  61      * @exception  NullPointerException
  62      *     (unchecked exception) Thrown if <CODE>printerName</CODE> is null.
  63      */
  64     public PrinterName(String printerName, Locale locale) {




  24  */
  25 package javax.print.attribute.standard;
  26 
  27 import java.util.Locale;
  28 
  29 import javax.print.attribute.Attribute;
  30 import javax.print.attribute.TextSyntax;
  31 import javax.print.attribute.PrintServiceAttribute;
  32 
  33 /**
  34  * Class PrinterName is a printing attribute class, a text attribute, that
  35  * specifies the name of a printer. It is a name that is more end-user friendly
  36  * than a URI. An administrator determines a printer's name and sets this
  37  * attribute to that name. This name may be the last part of the printer's URI
  38  * or it may be unrelated. In non-US-English locales, a name may contain
  39  * characters that are not allowed in a URI.
  40  * <P>
  41  * <B>IPP Compatibility:</B> The string value gives the IPP name value. The
  42  * locale gives the IPP natural language. The category name returned by
  43  * <CODE>getName()</CODE> gives the IPP attribute name.

  44  *
  45  * @author  Alan Kaminsky
  46  */
  47 public final class PrinterName extends TextSyntax
  48         implements PrintServiceAttribute {
  49 
  50     private static final long serialVersionUID = 299740639137803127L;
  51 
  52     /**
  53      * Constructs a new printer name attribute with the given name and locale.
  54      *
  55      * @param  printerName  Printer name.
  56      * @param  locale       Natural language of the text string. null
  57      * is interpreted to mean the default locale as returned
  58      * by <code>Locale.getDefault()</code>
  59      *
  60      * @exception  NullPointerException
  61      *     (unchecked exception) Thrown if <CODE>printerName</CODE> is null.
  62      */
  63     public PrinterName(String printerName, Locale locale) {