From 554fd8c5195424bdbcabf5de30fdc183aba391bd Mon Sep 17 00:00:00 2001 From: upstream source tree Date: Sun, 15 Mar 2015 20:14:05 -0400 Subject: obtained gcc-4.6.4.tar.bz2 from upstream website; verified gcc-4.6.4.tar.bz2.sig; imported gcc-4.6.4 source tree from verified upstream tarball. downloading a git-generated archive based on the 'upstream' tag should provide you with a source tree that is binary identical to the one extracted from the above tarball. if you have obtained the source via the command 'git clone', however, do note that line-endings of files in your working directory might differ from line-endings of the respective files in the upstream repository. --- libjava/classpath/javax/print/PrintService.java | 296 ++++++++++++++++++++++++ 1 file changed, 296 insertions(+) create mode 100644 libjava/classpath/javax/print/PrintService.java (limited to 'libjava/classpath/javax/print/PrintService.java') diff --git a/libjava/classpath/javax/print/PrintService.java b/libjava/classpath/javax/print/PrintService.java new file mode 100644 index 000000000..b7bd50088 --- /dev/null +++ b/libjava/classpath/javax/print/PrintService.java @@ -0,0 +1,296 @@ +/* PrintService.java -- + Copyright (C) 2004, 2006 Free Software Foundation, Inc. + +This file is part of GNU Classpath. + +GNU Classpath is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +GNU Classpath is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with GNU Classpath; see the file COPYING. If not, write to the +Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA +02110-1301 USA. + +Linking this library statically or dynamically with other modules is +making a combined work based on this library. Thus, the terms and +conditions of the GNU General Public License cover the whole +combination. + +As a special exception, the copyright holders of this library give you +permission to link this library with independent modules to produce an +executable, regardless of the license terms of these independent +modules, and to copy and distribute the resulting executable under +terms of your choice, provided that you also meet, for each linked +independent module, the terms and conditions of the license of that +module. An independent module is a module which is not derived from +or based on this library. If you modify this library, you may extend +this exception to your version of the library, but you are not +obligated to do so. If you do not wish to do so, delete this +exception statement from your version. */ + + +package javax.print; + +import javax.print.attribute.Attribute; +import javax.print.attribute.AttributeSet; +import javax.print.attribute.PrintServiceAttribute; +import javax.print.attribute.PrintServiceAttributeSet; +import javax.print.event.PrintServiceAttributeListener; + +/** + * A PrintService represents a printer available for printing. + *

+ * The print service hereby may be a real physical printer device, a printer + * group with same capabilities or a logical print service (like for example + * a PDF writer). The print service is used to query the capabilities of the + * represented printer instance. If a suitable print service is found it is + * used to create a print job for the actual printing process. + *

+ * @see javax.print.DocPrintJob + * + * @author Michael Koch (konqueror@gmx.de) + */ +public interface PrintService +{ + /** + * Creates and returns a new print job which is capable to handle all + * the document flavors supported by this print service. + * + * @return The created print job object. + */ + DocPrintJob createPrintJob(); + + /** + * Determines if two services refer to the same underlying service. + * + * @param obj the service to check against + * + * @return true if both services refer to the same underlying + * service, false otherwise. + */ + boolean equals(Object obj); + + /** + * Returns the value of the single specified attribute. + * + * @param category the category of a PrintServiceAttribute + * + * @return The value of the attribute, or null if the attribute + * category is not supported by this print service implementation. + * + * @throws NullPointerException if category is null. + * @throws IllegalArgumentException if category is not a class that + * implements PrintServiceAttribute. + */ + T getAttribute(Class category); + + /** + * Returns the attributes describing this print service. The returned + * attributes set is unmodifiable and represents the current state of + * the print service. As some print service attributes may change + * (depends on the print service implementation) a subsequent call to + * this method may return a different set. To monitor changes a + * PrintServiceAttributeListener may be registered. + * + * @return All the description attributes of this print service. + * @see #addPrintServiceAttributeListener(PrintServiceAttributeListener) + */ + PrintServiceAttributeSet getAttributes(); + + /** + * Determines and returns the default value for a given attribute category + * of this print service. + *

+ * A return value of null means either that the print service + * does not support the attribute category or there is no default value + * available for this category. To distinguish these two case one can test + * with {@link #isAttributeCategorySupported(Class)} if the category is + * supported. + *

+ * + * @param category the category of the attribute + * + * @return The default value, or null. + * + * @throws NullPointerException if category is null + * @throws IllegalArgumentException if category is a class + * not implementing Attribute + */ + Object getDefaultAttributeValue(Class category); + + /** + * Returns the name of this print service. + * This may be the value of the PrinterName attribute. + * + * @return The print service name. + */ + String getName(); + + /** + * Returns a factory for UI components if supported by the print service. + * + * @return A factory for UI components or null. + */ + ServiceUIFactory getServiceUIFactory(); + + /** + * Returns all supported attribute categories. + * + * @return The class array of all supported attribute categories. + */ + Class[] getSupportedAttributeCategories(); + + /** + * Determines and returns all supported attribute values of a given + * attribute category a client can use when setting up a print job + * for this print service. + *

+ * The returned object may be one of the following types: + *

    + *
  • A single instance of the attribute category to indicate that any + * value will be supported.
    • + *
  • An array of the same type as the attribute category to test, + * containing all the supported values for this category.
    • + *
  • A single object (of any other type than the attribute category) + * which indicates bounds on the supported values.
    • + *
+ *

+ * + * @param category the attribute category to test + * @param flavor the document flavor to use, or null + * @param attributes set of attributes for a supposed job, + * or null + * + * @return A object (as defined above) indicating the supported values + * for the given attribute category, or null if this print + * service doesn't support the given attribute category at all. + * + * @throws NullPointerException if category is null + * @throws IllegalArgumentException if category is a class not + * implementing Attribute, or if flavor is not + * supported + */ + Object getSupportedAttributeValues(Class category, + DocFlavor flavor, + AttributeSet attributes); + + /** + * Determines and returns an array of all supported document flavors which + * can be used to supply print data to this print service. + *

+ * The supported attribute categories may differ between the supported + * document flavors. To test for supported attributes one can use the + * {@link #getUnsupportedAttributes(DocFlavor, AttributeSet)} method with + * the specific doc flavor and attributes set. + *

+ * + * @return the supported document flavors + */ + DocFlavor[] getSupportedDocFlavors(); + + /** + * Identifies all the unsupported attributes of the given set of attributes + * in the context of the specified document flavor. + *

+ * The given flavor has to be supported by the print service (use + * {@link #isDocFlavorSupported(DocFlavor)} to verify). The method will + * return null if all given attributes are supported. Otherwise + * a set of unsupported attributes are returned. The attributes in the + * returned set may be completely unsupported or only the specific requested + * value. If flavor is null the default document flavor of the + * print service is used in the identification process. + *

+ * + * @param flavor document flavor to test, or null. + * @param attributes set of printing attributes for a supposed job + * + * @return null if this print service supports all the given + * attributes for the specified doc flavor. Otherwise the set of unsupported + * attributes are returned. + * + * @throws IllegalArgumentException if flavor is unsupported + */ + AttributeSet getUnsupportedAttributes(DocFlavor flavor, AttributeSet attributes); + + + /** + * Returns a hashcode for this print service. + * + * @return The hashcode. + */ + int hashCode(); + + /** + * Determines a given attribute category is supported by this + * print service implementation. This only tests for the category + * not for any specific values of this category nor in the context + * of a specific document flavor. + * + * @param category the category to check + * + * @return true if category is supported, + * false otherwise. + * + * @throws NullPointerException if category is null + * @throws IllegalArgumentException if category is a class not + * implementing Attribute. + */ + boolean isAttributeCategorySupported(Class category); + + /** + * Determines if a given attribute value is supported when creating a print + * job for this print service. + *

+ * If either the document flavor or the provided attributes are + * null it is determined if the given attribute value is + * supported in some combination of the available document flavors and + * attributes of the print service. Otherwise it is checked for the + * specific context of the given document flavor/attributes set. + *

+ * + * @param attrval the attribute value to check + * @param flavor the document flavor to use, or null. + * @param attributes set of attributes to use, or null. + * + * @return true if the attribute value is supported in the + * requested context, false otherwise. + * + * @throws NullPointerException if attrval is null. + * @throws IllegalArgumentException if flavor is not supported + * by this print service + */ + boolean isAttributeValueSupported(Attribute attrval, DocFlavor flavor, AttributeSet attributes); + + /** + * Determines if a given document flavor is supported or not. + * + * @param flavor the document flavor to check + * + * @return true if flavor is supported, + * false otherwise. + * + * @throws NullPointerException if flavor is null. + */ + boolean isDocFlavorSupported(DocFlavor flavor); + + /** + * Registers a print service attribute listener to this print service. + * + * @param listener the listener to add + */ + void addPrintServiceAttributeListener(PrintServiceAttributeListener listener); + + /** + * De-registers a print service attribute listener from this print service. + * + * @param listener the listener to remove + */ + void removePrintServiceAttributeListener(PrintServiceAttributeListener listener); +} -- cgit v1.2.3