Module  java.desktop
软件包  javax.print

Class StreamPrintServiceFactory



  • public abstract class StreamPrintServiceFactory
    extends Object
    A StreamPrintServiceFactoryStreamPrintService实例的工厂,可以以描述为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指定的格式。