模块  java.desktop
软件包  javax.print

Class StreamPrintServiceFactory


  • public abstract class StreamPrintServiceFactory
    extends Object
    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 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指定的格式