[multiple changes]

2004-05-15  Mark Wielaard  <mark@klomp.org>

       * Makefile.am (ordinary_java_source_files): Add new javax.print
       classes.
       * Makefile.in: Regenerated.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/attribute/standard/DateTimeAtCompleted.java,
       javax/print/attribute/standard/DateTimeAtCreation.java,
       javax/print/attribute/standard/DateTimeAtProcessing.java,
       javax/print/attribute/standard/DocumentName.java,
       javax/print/attribute/standard/JobHoldUntil.java,
       javax/print/attribute/standard/JobImpressionsCompleted.java,
       javax/print/attribute/standard/JobMessageFromOperator.java,
       javax/print/attribute/standard/JobName.java,
       javax/print/attribute/standard/JobOriginatingUserName.java,
       javax/print/attribute/standard/JobPriority.java,
       javax/print/attribute/standard/JobPrioritySupported.java,
       javax/print/attribute/standard/NumberOfInterveningJobs.java,
       javax/print/attribute/standard/OutputDeviceAssigned.java,
       javax/print/attribute/standard/PrinterInfo.java,
       javax/print/attribute/standard/PrinterLocation.java,
       javax/print/attribute/standard/PrinterMakeAndModel.java,
       javax/print/attribute/standard/PrinterMessageFromOperator.java,
       javax/print/attribute/standard/PrinterName.java,
       javax/print/attribute/standard/QueuedJobCount.java,
       javax/print/attribute/standard/RequestingUserName.java:
       Fixed javadocs all over.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/DocFlavor.java,
       javax/print/attribute/standard/ColorSupported.java,
       javax/print/attribute/standard/Compression.java,
       javax/print/attribute/standard/CopiesSupported.java,
       javax/print/attribute/standard/Fidelity.java,
       javax/print/attribute/standard/Finishings.java,
       javax/print/attribute/standard/JobImpressionsSupported.java,
       javax/print/attribute/standard/JobKOctetsSupported.java,
       javax/print/attribute/standard/JobMediaSheetsSupported.java,
       javax/print/attribute/standard/JobSheets.java,
       javax/print/attribute/standard/JobState.java,
       javax/print/attribute/standard/JobStateReason.java,
       javax/print/attribute/standard/JobStateReasons.java,
       javax/print/attribute/standard/Media.java,
       javax/print/attribute/standard/MediaSizeName.java,
       javax/print/attribute/standard/MultipleDocumentHandling.java,
       javax/print/attribute/standard/NumberUpSupported.java,
       javax/print/attribute/standard/OrientationRequested.java,
       javax/print/attribute/standard/PDLOverrideSupported.java,
       javax/print/attribute/standard/PageRanges.java,
       javax/print/attribute/standard/PresentationDirection.java,
       javax/print/attribute/standard/PrintQuality.java,
       javax/print/attribute/standard/PrinterIsAcceptingJobs.java,
       javax/print/attribute/standard/PrinterMoreInfo.java,
       javax/print/attribute/standard/PrinterMoreInfoManufacturer.java,
       javax/print/attribute/standard/PrinterResolution.java,
       javax/print/attribute/standard/PrinterState.java,
       javax/print/attribute/standard/PrinterStateReason.java,
       javax/print/attribute/standard/PrinterStateReasons.java,
       javax/print/attribute/standard/PrinterURI.java,
       javax/print/attribute/standard/ReferenceUriSchemesSupported.java,
       javax/print/attribute/standard/Severity.java,
       javax/print/attribute/standard/SheetCollate.java,
       javax/print/attribute/standard/Sides.java:
       Added serialVersionUID and removed final keyword where it doenst
       belong.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/PrintServiceLookup.java: New file.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/DocFlavor.java:
       Implemented all flavor classes.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/attribute/standard/ColorSupported.java,
       javax/print/attribute/standard/Compression.java,
       javax/print/attribute/standard/CopiesSupported.java,
       javax/print/attribute/standard/Fidelity.java,
       javax/print/attribute/standard/Finishings.java,
       javax/print/attribute/standard/JobImpressionsSupported.java,
       javax/print/attribute/standard/JobKOctetsSupported.java,
       javax/print/attribute/standard/JobMediaSheetsSupported.java,
       javax/print/attribute/standard/JobSheets.java,
       javax/print/attribute/standard/JobState.java,
       javax/print/attribute/standard/JobStateReason.java,
       javax/print/attribute/standard/JobStateReasons.java,
       javax/print/attribute/standard/Media.java,
       javax/print/attribute/standard/MediaSizeName.java,
       javax/print/attribute/standard/MultipleDocumentHandling.java,
       javax/print/attribute/standard/NumberUpSupported.java,
       javax/print/attribute/standard/OrientationRequested.java,
       javax/print/attribute/standard/PDLOverrideSupported.java,
       javax/print/attribute/standard/PageRanges.java,
       javax/print/attribute/standard/PresentationDirection.java,
       javax/print/attribute/standard/PrintQuality.java,
       javax/print/attribute/standard/PrinterIsAcceptingJobs.java,
       javax/print/attribute/standard/PrinterMoreInfo.java,
       javax/print/attribute/standard/PrinterMoreInfoManufacturer.java,
       javax/print/attribute/standard/PrinterResolution.java,
       javax/print/attribute/standard/PrinterState.java,
       javax/print/attribute/standard/PrinterStateReason.java,
       javax/print/attribute/standard/PrinterStateReasons.java,
       javax/print/attribute/standard/PrinterURI.java,
       javax/print/attribute/standard/ReferenceUriSchemesSupported.java,
       javax/print/attribute/standard/Severity.java,
       javax/print/attribute/standard/SheetCollate.java,
       javax/print/attribute/standard/Sides.java: New files.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/Doc.java
       (getPrintData): Throws IOException.
       (getReaderForText): Likewise.
       (getStreamForBytes): Likewise.
       * javax/print/DocFlavor.java:
       Fixed filename in copyright.
       (serialVersionUID): New field.
       * javax/print/ServiceUIFactory.java:
       Made all constants final.
       * javax/print/AttributeException.java
       javax/print/MultiDoc.java
       javax/print/MultiDocPrintJob.java
       javax/print/MultiDocPrintService.java
       javax/print/StreamPrintService.java
       javax/print/URIException.java: New files.
       * javax/print/Makefile.am
       (EXTRA_DIST): Added all new files.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/attribute/standard/Copies.java,
       javax/print/attribute/standard/DateTimeAtCompleted.java,
       javax/print/attribute/standard/DateTimeAtCreation.java,
       javax/print/attribute/standard/DateTimeAtProcessing.java,
       javax/print/attribute/standard/DocumentName.java,
       javax/print/attribute/standard/JobHoldUntil.java,
       javax/print/attribute/standard/JobImpressions.java,
       javax/print/attribute/standard/JobImpressionsCompleted.java,
       javax/print/attribute/standard/JobKOctets.java,
       javax/print/attribute/standard/JobKOctetsProcessed.java,
       javax/print/attribute/standard/JobMediaSheets.java,
       javax/print/attribute/standard/JobMediaSheetsCompleted.java,
       javax/print/attribute/standard/JobMessageFromOperator.java,
       javax/print/attribute/standard/JobName.java,
       javax/print/attribute/standard/JobOriginatingUserName.java,
       javax/print/attribute/standard/JobPriority.java,
       javax/print/attribute/standard/JobPrioritySupported.java,
       javax/print/attribute/standard/NumberOfDocuments.java,
       javax/print/attribute/standard/NumberOfInterveningJobs.java,
       javax/print/attribute/standard/NumberUp.java,
       javax/print/attribute/standard/OutputDeviceAssigned.java,
       javax/print/attribute/standard/PagesPerMinute.java,
       javax/print/attribute/standard/PagesPerMinuteColor.java:
       Fixed @return tag all over.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/attribute/AttributeSetUtilities.java
       (verifyCategoryForValue): Fixed typo in javadoc.
       * javax/print/attribute/HashAttributeSet.java
       (containsKey): Fixed @return tag.
       (comtainsValue): Likewise.
       (equals): Likewise.
       * javax/print/attribute/IntegerSyntax.java
       (equals): Likewise.
       * javax/print/attribute/ResolutionSyntax.java
       (equals): Likewise.
       (getCrossFeedResolution): Removed unused code.
       (getFeedResolution): Likewise.
       * javax/print/attribute/SetOfIntegerSyntax.java
       (SetOfIntegerSyntax): Fixed HTML entities in javadoc.
       (equals): Fixed @return tag.
       * javax/print/attribute/TextSyntax.java
       (TextSyntax): Take locale into account.
       (hashCode): Better implementation.

2004-05-15  Michael Koch  <konqueror@gmx.de>

       * javax/print/CancelablePrintJob.java,
       javax/print/Doc.java,
       javax/print/DocFlavor.java,
       javax/print/DocPrintJob.java,
       javax/print/FlavorException.java,
       javax/print/PrintException.java,
       javax/print/PrintService.java,
       javax/print/ServiceUIFactory.java: New files.

From-SVN: r81901

1 files changed, 226 insertions, 0 deletions

diff --git a/libjava/javax/print/PrintService.java b/libjava/javax/print/PrintService.java
new file mode 100644
index 0000000..de11368
--- /dev/null
+++ b/libjava/javax/print/PrintService.java
@@ -0,0 +1,226 @@
+/* PrintService.java --
+   Copyright (C) 2004 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., 59 Temple Place, Suite 330, Boston, MA
+02111-1307 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;
+
+/**
+ * @author Michael Koch (konqueror@gmx.de)
+ */
+public interface PrintService
+{
+  /**
+   * Returns a new print job capable to handle all supported document flavors.
+   * 
+   * @return the new print job
+   */
+  DocPrintJob createPrintJob();
+  
+  /**
+   * Determines if two services refer to the same underlying service.
+   * 
+   * @param obj the service to check against
+   * 
+   * @return <code>true</code> if both services refer to the sam underlying
+   * service, <code>false</code> otherwise
+   */
+  boolean equals(Object obj);
+  
+  /**
+   * Returns the value of a single specified attribute.
+   * 
+   * @param category the category of a <code>PrintServiceAttribute</code>
+   * 
+   * @return the value of the attribute
+   * 
+   * @throws NullPointerException if category is null
+   * @throws IllegalArgumentException if category is not a class that
+   * implements <code>PrintServiceAttribute</code>
+   */
+  PrintServiceAttribute getAttribute(Class category);
+  
+  /**
+   * Returns all attributes of this printer service
+   * 
+   * @return all attributes of this print service
+   */
+  PrintServiceAttributeSet getAttributes();
+
+  /**
+   * Returns the service's default value for a given attribute.
+   * 
+   * @param category the category of the attribute
+   * 
+   * @return the default value
+   * 
+   * @throws NullPointerException if <code>category</code> is null
+   * @throws IllegalArgumentException if <code>category</code> is a class
+   * not implementing <code>Attribute</code> 
+   */
+  Object getDefaultAttributeValue(Class category);
+  
+  /**
+   * Returns the name of this print service.
+   * 
+   * @return the name
+   */
+  String getName();
+  
+  /**
+   * Returns a factory for UI components.
+   * 
+   * @return the factory
+   */
+  ServiceUIFactory getServiceUIFactory();
+  
+  /**
+   * Returns all supported attribute categories.
+   * 
+   * @return an array of all supported attribute categories
+   */
+  Class[] getSupportedAttributeCategories();
+  
+  /**
+   * Returns all supported attribute values a client can use when setting up
+   * a print job with this service.
+   * 
+   * @param category the attribute category to test
+   * @param flavor the document flavor to use, or null
+   * @param attributes set of printing attributes for a supposed job, or null
+   * 
+   * @return object indicating supported values for <code>category</code>,
+   * or null if this print service doesnt support specifying doc-level or
+   * job-level attribute in a print request.
+   * 
+   * @throws NullPointerException if <code>category</code> is null
+   * @throws IllegalArgumentException if <code>category</code> is a class not
+   * implementing <code>Attribute</code>, or if <code>flavor</code> is not
+   * supported
+   */
+  Object getSupportedAttributeValues(Class category, DocFlavor flavor, AttributeSet attributes);
+  
+  /**
+   * Returns an array of all supproted document flavors.
+   * 
+   * @return the supported document flavors
+   */
+  DocFlavor[] getSupportedDocFlavors();
+  
+  /**
+   * Returns all attributes that are unsupported for a print request in the
+   * context of a particular document flavor.
+   * 
+   * @param flavor document flavor to test, or null
+   * @param attributes set of printing attributes for a supposed job
+   * 
+   * @return null if this <code>PrintService</code> supports the print request
+   * specification, else the unsupported attributes
+   * 
+   * @throws IllegalArgumentException if <code>flavor</code> is unsupported
+   */
+  AttributeSet getUnsupportedAttributes(DocFlavor flavor, AttributeSet attributes);
+  
+  /**
+   * Returns a hashcode for this printer service.
+   * 
+   * @return the hashcode
+   */
+  int hashCode();
+  
+  /**
+   * Determines a given attribute category is supported or not.
+   * 
+   * @param category the category to check
+   * 
+   * @return <code>true</code> if <code>category</code> is supported,
+   * <code>false</code> otherwise
+   * 
+   * @throws NullPointerException if <code>category</code> is null
+   * @throws IllegalArgumentException if <code>category</code> is a class not
+   * implementing <code>Attribute</code>.
+   */
+  boolean isAttributeCategorySupported(Class category);
+  
+  /**
+   * Determines a given attribute value is supported when creating a print job
+   * for this print service.
+   * 
+   * @param attrval the attribute value to check
+   * @param flavor the document flavor to use, or null
+   * @param attributes set of printing attributes to use, or null
+   * 
+   * @return <code>true</code> if the attribute value is supported,
+   * <code>false</code> otherwise
+   * 
+   * @throws NullPointerException if <code>attrval</code> is null
+   * @throws IllegalArgumentException if <code>flavor</code> is not supported
+   * by this print service
+   */
+  boolean isAttributeValueSupported(Attribute attrval, DocFlavor flavor, AttributeSet attributes);
+  
+  /**
+   * Determines a given document flavor is supported or not.
+   * 
+   * @param flavor the document flavor to check
+   * 
+   * @return <code>true</code> if <code>flavor</code> is supported,
+   * <code>false</code> otherwise
+   * 
+   * @throws NullPointerException if <code>flavor</code> 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);
+}