模块  java.desktop
软件包  javax.print

Class StreamPrintServiceFactory

  • public abstract class StreamPrintServiceFactory
extends Object
    StreamPrintServiceFactory是StreamPrintService实例的工厂，可以以描述为mime类型的特定文档格式打印到输出流。 典型的输出文档格式可以是Postscript（TM）。

    此类由服务实现，并由使用ServiceLoader工具的实现定位 。

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

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

    • 构造方法详细信息

      • StreamPrintServiceFactory

        public StreamPrintServiceFactory()

    • 方法详细信息

      • lookupStreamPrintServiceFactories

        public static StreamPrintServiceFactory[] lookupStreamPrintServiceFactories​(DocFlavor flavor,
                                                                            String outputMimeType)
        找到可与打印作业一起使用的打印服务的工厂，以outputMimeType指定的格式输出数据流。

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

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

        参数
        flavor - 输入文档类型 - null表示匹配所有类型
        outputMimeType - 表示所需的输出格式，用于标识合适的流式打印机工厂。 值null表示匹配所有格式。
        结果
        匹配工厂用于流打印服务实例，如果找不到合适的工厂则为空

      • getOutputFormat

        public abstract String getOutputFormat()
        查询工厂以获取从此工厂获得的打印机发出的文档格式。
        结果
        输出格式描述为mime类型

      • getSupportedDocFlavors

        public abstract DocFlavor[] getSupportedDocFlavors()
        查询工厂以获取从此工厂获得的打印机可以接受的文档样式。
        结果
        支持的doc flavor的数组

      • getPrintService

        public abstract StreamPrintService getPrintService​(OutputStream out)
        返回可以打印到指定输出流的StreamPrintService 。 输出流由应用程序创建和管理。 应用程序负责关闭流并确保不重用此Printer 。 在从打印机创建的任何打印作业完成之前，应用程序不应关闭此流。 提前执行此操作可能会生成PrinterException以及指示作业失败的事件。

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

        参数
        out - 生成的输出的目标流
        结果
        a PrintService ，它将生成此工厂支持的 DocFlavor指定的格式