javax.print

Class StreamPrintServiceFactory

java.lang.Object

javax.print.StreamPrintServiceFactory

public abstract class StreamPrintServiceFactory
extends Object

A StreamPrintServiceFactory是StreamPrintService实例的工厂，可以以描述为MIME类型的特定文档格式打印到输出流。 典型的输出文档格式可以是Postscript（TM）。

此类由服务实现和定位是通过使用实施SPI JAR File specification 。

应用程序通过调用lookupStreamPrintServiceFactories(DocFlavor, String)方法来定位此类的实例。

应用程序可以使用一个StreamPrintService代替的从工厂获得PrintService ，其表示物理打印机设备。

构造方法摘要

构造方法

Constructor and Description
StreamPrintServiceFactory()

方法摘要

Modifier and Type	Method and Description
abstract String	getOutputFormat() 查询工厂获得的打印机发出的文档格式。
abstract StreamPrintService	getPrintService(OutputStream out) 返回 StreamPrintService ，可以打印到指定的输出流。
abstract DocFlavor[]	getSupportedDocFlavors() 查询工厂的文件风味，可以从本厂获得的打印机接受。
static StreamPrintServiceFactory[]	lookupStreamPrintServiceFactories(DocFlavor flavor, String outputMimeType) 找到可用于打印作业的打印服务的工厂，以 outputMimeType的格式输出数据流。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

StreamPrintServiceFactory

public StreamPrintServiceFactory()

方法详细信息

lookupStreamPrintServiceFactories

public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocFlavor flavor,
                                                                            String outputMimeType)

找到可与打印作业一起使用的打印服务的工厂，以outputMimeType的格式输出数据流。

outputMimeType参数描述要创建的文档类型，而flavor参数描述了应用程序将输入数据提供给StreamPrintService的StreamPrintService 。

尽管null是用于查找流打印服务的可接受的值，但是典型的是搜索特定期望的格式，例如Postscript（TM）。

参数

flavor - 输入文档类型 - null表示匹配所有类型。

outputMimeType - 代表所需的输出格式，用于识别合适的流打印机工厂。 值为null表示匹配所有格式。

结果

- 匹配工厂的流打印服务实例，如果没有合适的工厂可以找到空的。

getOutputFormat

public abstract String getOutputFormat()

查询工厂获得的打印机发出的文档格式。

结果

输出格式描述为mime类型。

getSupportedDocFlavors

public abstract DocFlavor[] getSupportedDocFlavors()

查询工厂的文件风味，可以从本厂获得的打印机接受。

结果

数组支持的doc风味。

getPrintService

public abstract StreamPrintService getPrintService(OutputStream out)

返回StreamPrintService ，可以打印到指定的输出流。 输出流由应用程序创建和管理。 应用程序有责任关闭流，并确保本打印机不被重复使用。 在从打印机创建的任何打印作业完成之前，应用程序不应关闭此流。 以前执行此操作可能会生成PrinterException和表示作业失败的事件。

而PrintService连接到物理打印机可以重复使用，一个StreamPrintService连接到流不能。 底层StreamPrintService可通过与所述打印系统被布置dispose方法从返回之前print的方法DocPrintJob ，使得打印系统知道该打印机不再可用。 这相当于一个物理打印机永久脱机。 应用程序可以提供空打印流来创建可查询的服务。 为这样一个流创建一个PrintJob是无效的。 在构建时分配资源的实现应该检查流，并且如果流是非空的，可能希望仅分配资源。

参数

out - 生成输出的目标流。

结果

一个PrintService，它将生成由本工厂支持的DocFlavor指定的格式。