Module  java.desktop
软件包  javax.print

Class StreamPrintServiceFactory


  • public abstract class StreamPrintServiceFactory
extends Object
    A 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风味。

      • getPrintService

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

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

        参数
        out - 生成输出的目标流。
        结果
        一个PrintService，它将生成由本工厂支持的DocFlavor指定的格式。