0N/A/*
2362N/A * Copyright (c) 2000, 2004, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/Apackage javax.print.attribute.standard;
0N/A
0N/Aimport java.util.Locale;
0N/A
0N/Aimport javax.print.attribute.Attribute;
0N/Aimport javax.print.attribute.TextSyntax;
0N/Aimport javax.print.attribute.PrintServiceAttribute;
0N/A
0N/A/**
0N/A * Class PrinterInfo is a printing attribute class, a text attribute, that
0N/A * provides descriptive information about a printer. This could include things
0N/A * like: <CODE>"This printer can be used for printing color transparencies for
0N/A * HR presentations"</CODE>, or <CODE>"Out of courtesy for others, please
0N/A * print only small (1-5 page) jobs at this printer"</CODE>, or even \
0N/A * <CODE>"This printer is going away on July 1, 1997, please find a new
0N/A * printer"</CODE>.
0N/A * <P>
0N/A * <B>IPP Compatibility:</B> The string value gives the IPP name value. The
0N/A * locale gives the IPP natural language. The category name returned by
0N/A * <CODE>getName()</CODE> gives the IPP attribute name.
0N/A * <P>
0N/A *
0N/A * @author Alan Kaminsky
0N/A */
0N/Apublic final class PrinterInfo extends TextSyntax
0N/A implements PrintServiceAttribute {
0N/A
0N/A private static final long serialVersionUID = 7765280618777599727L;
0N/A
0N/A /**
0N/A * Constructs a new printer info attribute with the given information
0N/A * string and locale.
0N/A *
0N/A * @param info Printer information string.
0N/A * @param locale Natural language of the text string. null
0N/A * is interpreted to mean the default locale as returned
0N/A * by <code>Locale.getDefault()</code>
0N/A *
0N/A * @exception NullPointerException
0N/A * (unchecked exception) Thrown if <CODE>info</CODE> is null.
0N/A */
0N/A public PrinterInfo(String info, Locale locale) {
0N/A super (info, locale);
0N/A }
0N/A
0N/A /**
0N/A * Returns whether this printer info attribute is equivalent to the passed
0N/A * in object. To be equivalent, all of the following conditions must be
0N/A * true:
0N/A * <OL TYPE=1>
0N/A * <LI>
0N/A * <CODE>object</CODE> is not null.
0N/A * <LI>
0N/A * <CODE>object</CODE> is an instance of class PrinterInfo.
0N/A * <LI>
0N/A * This printer info attribute's underlying string and
0N/A * <CODE>object</CODE>'s underlying string are equal.
0N/A * <LI>
0N/A * This printer info attribute's locale and <CODE>object</CODE>'s
0N/A * locale are equal.
0N/A * </OL>
0N/A *
0N/A * @param object Object to compare to.
0N/A *
0N/A * @return True if <CODE>object</CODE> is equivalent to this printer
0N/A * info attribute, false otherwise.
0N/A */
0N/A public boolean equals(Object object) {
0N/A return (super.equals(object) && object instanceof PrinterInfo);
0N/A }
0N/A
0N/A /**
0N/A * Get the printing attribute class which is to be used as the "category"
0N/A * for this printing attribute value.
0N/A * <P>
0N/A * For class PrinterInfo, the category is class PrinterInfo itself.
0N/A *
0N/A * @return Printing attribute class (category), an instance of class
0N/A * {@link java.lang.Class java.lang.Class}.
0N/A */
0N/A public final Class<? extends Attribute> getCategory() {
0N/A return PrinterInfo.class;
0N/A }
0N/A
0N/A /**
0N/A * Get the name of the category of which this attribute value is an
0N/A * instance.
0N/A * <P>
0N/A * For class PrinterInfo, the category name is <CODE>"printer-info"</CODE>.
0N/A *
0N/A * @return Attribute category name.
0N/A */
0N/A public final String getName() {
0N/A return "printer-info";
0N/A }
0N/A
0N/A}