javax.print

Class 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, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

StreamPrintServiceFactory

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

Method Details

getOutputFormat

public abstract String getOutputFormat()
Returns the output format supported by this factory.
Returns:
The mime type of the output format as string representation.

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.

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.

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.

StreamPrintServiceFactory.java -- Copyright (C) 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.