[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
This commit is contained in:
parent
7cd9b02827
commit
85ff6f624e
95 changed files with 5497 additions and 70 deletions
226
libjava/javax/print/PrintService.java
Normal file
226
libjava/javax/print/PrintService.java
Normal file
|
@ -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);
|
||||
}
|
Loading…
Add table
Add a link
Reference in a new issue