- java.lang.Object
-
- javax.print.StreamPrintServiceFactory
-
public abstract class StreamPrintServiceFactory extends Object
AStreamPrintServiceFactory
is the factory forStreamPrintService
instances, which can print to an output stream in a particular document format described as a mime type. A typical output document format may be Postscript(TM).This class is implemented by a service and located by the implementation using the SPI JAR File specification.
Applications locate instances of this class by calling the
lookupStreamPrintServiceFactories(DocFlavor, String)
method.Applications can use a
StreamPrintService
obtained from a factory in place of aPrintService
which represents a physical printer device.
-
-
Constructor Summary
Constructors Constructor and Description StreamPrintServiceFactory()
-
Method Summary
Methods Modifier and Type Method and Description abstract String
getOutputFormat()
Queries the factory for the document format that is emitted by printers obtained from this factory.abstract StreamPrintService
getPrintService(OutputStream out)
Returns aStreamPrintService
that can print to the specified output stream.abstract DocFlavor[]
getSupportedDocFlavors()
Queries the factory for the document flavors that can be accepted by printers obtained from this factory.static StreamPrintServiceFactory[]
lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)
Locates factories for print services that can be used with a print job to output a stream of data in the format specified byoutputMimeType
.
-
-
-
Method Detail
-
lookupStreamPrintServiceFactories
public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType)
Locates factories for print services that can be used with a print job to output a stream of data in the format specified byoutputMimeType
.The
outputMimeType
parameter describes the document type that you want to create, whereas theflavor
parameter describes the format in which the input data will be provided by the application to theStreamPrintService
.Although null is an acceptable value to use in the lookup of stream printing services, it's typical to search for a particular desired format, such as Postscript(TM).
- Parameters:
flavor
- of the input document type - null means match all types.outputMimeType
- representing the required output format, used to identify suitable stream printer factories. A value of null means match all formats.- Returns:
- - matching factories for stream print service instance, empty if no suitable factories could be located.
-
getOutputFormat
public abstract String getOutputFormat()
Queries the factory for the document format that is emitted by printers obtained from this factory.- Returns:
- the output format described as a mime type.
-
getSupportedDocFlavors
public abstract DocFlavor[] getSupportedDocFlavors()
Queries the factory for the document flavors that can be accepted by printers obtained from this factory.- Returns:
- array of supported doc flavors.
-
getPrintService
public abstract StreamPrintService getPrintService(OutputStream out)
Returns aStreamPrintService
that can print to the specified output stream. The output stream is created and managed by the application. It is the application's responsibility to close the stream and to ensure that this Printer is not reused. The application should not close this stream until any print job created from the printer is complete. Doing so earlier may generate aPrinterException
and an event indicating that the job failed.Whereas a
PrintService
connected to a physical printer can be reused, aStreamPrintService
connected to a stream cannot. The underlyingStreamPrintService
may be disposed by the print system with thedispose
method before returning from theprint
method ofDocPrintJob
so that the print system knows this printer is no longer usable. This is equivalent to a physical printer going offline - permanently. Applications may supply a null print stream to create a queryable service. It is not valid to create a PrintJob for such a stream. Implementations which allocate resources on construction should examine the stream and may wish to only allocate resources if the stream is non-null.- Parameters:
out
- destination stream for generated output.- Returns:
- a PrintService which will generate the format specified by the DocFlavor supported by this Factory.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/print/StreamPrintServiceFactory.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.