javax.print
Class StreamPrintServiceFactory

java.lang.Object
  extended by javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory
extends Object

StreamPrintServiceFactory provides a static method to lookup registered factories to construct StreamPrintService instances.

StreamPrintService are used to print into a provided output stream in the document format provided by the stream print service implementation.

Implementations are located and loaded automatically through the SPI JAR file specification. Therefore implementation classes must provide a default constructor for instantiation.


Constructor Summary
StreamPrintServiceFactory()
          Default public constructor.
 
Method Summary
abstract  String getOutputFormat()
          Returns the output format supported by this factory.
abstract  StreamPrintService getPrintService(OutputStream out)
          Constructs a StreamPrintService which directs its output the given output stream.
abstract  DocFlavor[] getSupportedDocFlavors()
          Returns the document flavors this factory supports as flavors for the input documents.
static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)
          Searches for matching factories providing stream print services that support the printing of documents with the given document flavor into the given output mime type.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StreamPrintServiceFactory

public StreamPrintServiceFactory()
Default public constructor. Used for automatic loading and instantiation through the SPI jar file specification.

Method Detail

lookupStreamPrintServiceFactories

public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor,
                                                                            String outputMimeType)
Searches for matching factories providing stream print services that support the printing of documents with the given document flavor into the given output mime type.

Parameters:
flavor - the document flavor needed, null doesn't constrain the lookup result.
outputMimeType - the mime type needed, null doesn't constrain the lookup result.
Returns:
The matching StreamPrintServiceFactory instances.

getOutputFormat

public abstract String getOutputFormat()
Returns the output format supported by this factory.

Returns:
The mime type of the output format as string representation.

getSupportedDocFlavors

public abstract DocFlavor[] getSupportedDocFlavors()
Returns the document flavors this factory supports as flavors for the input documents.

Returns:
The array of supported document flavors.

getPrintService

public abstract StreamPrintService getPrintService(OutputStream out)
Constructs a StreamPrintService which directs its output the given output stream.

Parameters:
out - the output stream for the produced document.
Returns:
The constructed stream print service.