Interface PrintService

public void addPrintServiceAttributeListener(PrintServiceAttributeListener listener)

Registers a print service attribute listener to this print service.

Parameters:

listener - the listener to add

public DocPrintJob createPrintJob()

Returns a new print job capable to handle all supported document flavors.

Returns:

the new print job

public boolean equals(Object obj)

Determines if two services refer to the same underlying service.

Overrides:

equals in interface Object

Parameters:

obj - the service to check against

Returns:

true if both services refer to the sam underlying service, false otherwise

public PrintServiceAttribute getAttribute(Class category)

Returns the value of a single specified attribute.

Parameters:

category - the category of a PrintServiceAttribute

Returns:

the value of the attribute

Throws:

NullPointerException - if category is null

IllegalArgumentException - if category is not a class that implements PrintServiceAttribute

public PrintServiceAttributeSet getAttributes()

Returns all attributes of this printer service

Returns:

all attributes of this print service

public Object getDefaultAttributeValue(Class category)

Returns the service's default value for a given attribute.

Parameters:

category - the category of the attribute

Returns:

the default value

Throws:

NullPointerException - if category is null

IllegalArgumentException - if category is a class not implementing Attribute

public String getName()

Returns the name of this print service.

Returns:

the name

public ServiceUIFactory getServiceUIFactory()

Returns a factory for UI components.

Returns:

the factory

public Class[] getSupportedAttributeCategories()

Returns all supported attribute categories.

Returns:

an array of all supported attribute categories

public Object getSupportedAttributeValues(Class category,
                                          DocFlavor flavor,
                                          AttributeSet attributes)

Returns all supported attribute values a client can use when setting up a print job with this service.

Parameters:

category - the attribute category to test

flavor - the document flavor to use, or null

attributes - set of printing attributes for a supposed job, or null

Returns:

object indicating supported values for category, or null if this print service doesnt support specifying doc-level or job-level attribute in a print request.

Throws:

NullPointerException - if category is null

IllegalArgumentException - if category is a class not implementing Attribute, or if flavor is not supported

public DocFlavor[] getSupportedDocFlavors()

Returns an array of all supproted document flavors.

Returns:

the supported document flavors

public AttributeSet getUnsupportedAttributes(DocFlavor flavor,
                                             AttributeSet attributes)

Returns all attributes that are unsupported for a print request in the context of a particular document flavor.

Parameters:

flavor - document flavor to test, or null

attributes - set of printing attributes for a supposed job

Returns:

null if this PrintService supports the print request specification, else the unsupported attributes

Throws:

IllegalArgumentException - if flavor is unsupported

public int hashCode()

Returns a hashcode for this printer service.

Overrides:

hashCode in interface Object

Returns:

the hashcode

public boolean isAttributeCategorySupported(Class category)

Determines a given attribute category is supported or not.

Parameters:

category - the category to check

Returns:

true if category is supported, false otherwise

Throws:

NullPointerException - if category is null

IllegalArgumentException - if category is a class not implementing Attribute.

public boolean isAttributeValueSupported(Attribute attrval,
                                         DocFlavor flavor,
                                         AttributeSet attributes)

Determines a given attribute value is supported when creating a print job for this print service.

Parameters:

attrval - the attribute value to check

flavor - the document flavor to use, or null

attributes - set of printing attributes to use, or null

Returns:

true if the attribute value is supported, false otherwise

Throws:

NullPointerException - if attrval is null

IllegalArgumentException - if flavor is not supported by this print service

public boolean isDocFlavorSupported(DocFlavor flavor)

Determines a given document flavor is supported or not.

Parameters:

flavor - the document flavor to check

Returns:

true if flavor is supported, false otherwise

Throws:

NullPointerException - if flavor is null

public void removePrintServiceAttributeListener(PrintServiceAttributeListener listener)

De-registers a print service attribute listener from this print service.

Parameters:

listener - the listener to remove