模块  java.desktop

Package javax.print

提供Java™打印服务API的主要类和接口。 Java Print Service API使客户端和服务器应用程序能够:
  • 根据其功能发现并选择打印服务
  • 指定打印数据的格式
  • 将打印作业提交给支持要打印的文档类型的服务。

打印服务发现

应用程序调用抽象类PrintServiceLookup的静态方法来定位具有满足应用程序打印请求的功能的打印服务。 例如,要打印双面文档,应用程序首先需要找到具有双面打印功能的打印机。

JDK包括可以定位标准平台打印机的PrintServiceLookup实现。 要找到其他类型的打印机,例如IPP打印机或JINI打印机,打印服务提供商可以编写PrintServiceLookup实现。 打印服务提供商可以使用ServiceLoader工具动态安装这些PrintServiceLookup实现。

属性定义

javax.print.attributejavax.print.attribute.standard程序包定义打印属性,这些属性描述打印服务的功能,指定打印作业的要求以及跟踪打印作业的进度。

javax.print.attribute包描述了属性的类型以及如何将它们收集到集合中。 javax.print.attribute.standard程序包枚举了API支持的所有标准属性,其中大多数是2000年9月IETF规范RFC 2911 Internet Printing Protocol, 1.1: Model and Semantics中指定的属性的实现javax.print.attribute.standard指定的属性包括常用功能,例如:分辨率,副本,媒体大小,作业优先级和页面范围。

文件类型规格

DocFlavor类表示打印数据格式,例如JPEG或PostScript。 DocFlavor对象由描述格式的MIME类型和指示文档如何传递到打印机或输出流的文档表示类名组成。 应用程序使用DocFlavor和属性集来查找可以打印DocFlavor指定的文档类型并具有属性集指定的功能的打印机。

使用API

使用Java Print Service API的典型应用程序执行以下步骤来处理打印请求:
  1. 选择DocFlavor
  2. 创建一组属性。
  3. 找到可以处理DocFlavor和属性集指定的打印请求的打印服务。
  4. 创建封装DocFlavorDoc对象和实际打印数据,可以采用多种形式,包括:Postscript文件,JPEG图像, URL或纯文本。
  5. 从打印服务获取打印作业,由DocPrintJob表示。
  6. 调用打印作业的打印方法。
下面的代码示例演示了Java Print Service API的典型用法:找到可以在A4纸上打印5张Postscript文档双面副本的打印机,从返回的打印服务之一创建打印作业,然后调用print。
 FileInputStream psStream; try {     psStream = new FileInputStream("file.ps"); } catch (FileNotFoundException ffne) { } if (psStream == null) {     return; } DocFlavor psInFormat = DocFlavor.INPUT_STREAM.POSTSCRIPT; Doc myDoc = new SimpleDoc(psStream, psInFormat, null); PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet(); aset.add(new Copies(5)); aset.add(MediaSizeName.ISO_A4); aset.add(Sides.DUPLEX); PrintService[] services = PrintServiceLookup.lookupPrintServices(psInFormat, aset); if (services.length > 0) {     DocPrintJob job = services[0].createPrintJob();     try {         job.print(myDoc, aset);     } catch (PrintException pe) {} } 

请注意:在javax.print API中,方法的null引用参数不正确,除非在方法上明确记录为具有有意义的解释。 相反的用法是不正确的编码,并且可能立即或稍后导致运行时异常。 IllegalArgumentExceptionNullPointerException是此类情况的典型和可接受的运行时异常的示例。

从以下版本开始:
1.4