Package javax.print

提供了主要的类和接口的java ^TM打印服务API。

See: 描述

接口摘要

接口	描述
AttributeException	接口attributeexception是混合接口的子类可以实现一个 PrintException涉及一个或多个打印属性，特定的打印服务实例不支持错误情况的报告。
CancelablePrintJob	此接口用于打印应用程序以取消打印作业。
Doc	接口文档指定为打印作业提供一个打印数据的对象的接口。
DocPrintJob	此接口表示一个打印作业，可以打印一个指定的文档，具有一组工作属性。
FlavorException	接口flavorexception是混合接口的子类可以实现 PrintException涉及DOC的味道或风味错误情况报告（类 DocFlavor）。
MultiDoc	多文档界面指定对象提供一个以上的用于打印作业的打印数据接口。
MultiDocPrintJob	从multidocprintservice获得，一multidocprintjob可以打印指定的文档集合作为一个组的工作属性单打印作业。
MultiDocPrintService	接口multiprintservice是一multidocprintjob工厂。
PrintService	界面打字是一个docprintjob工厂。
URIException	接口uriexception是混合接口的子类可以实现 PrintException涉及一个URI地址错误情况的报告。

类摘要

类	描述
DocFlavor	DocFlavor封装了一个类对象指定的格式，打印数据提供给 DocPrintJob。
DocFlavor.BYTE_ARRAY	类docflavor.byte_array提供预定义的静态常量docflavor对象例如DOC香料使用一个字节数组（ byte[]）作为打印数据表示的类。
DocFlavor.CHAR_ARRAY	类docflavor.char_array提供预定义的静态常量docflavor对象例如DOC香料使用字符数组（ char[]）作为打印数据表示的类。
DocFlavor.INPUT_STREAM	类docflavor.input_stream提供预定义的静态常量docflavor对象例如DOC香料使用的字节流（ java.io.InputStream）作为打印数据表示的类。
DocFlavor.READER	类docflavor.reader提供预定义的静态常量docflavor对象例如DOC香料使用字符流（ java.io.Reader）作为打印数据表示的类。
DocFlavor.SERVICE_FORMATTED	类docflavor.service_formatted提供预定义的静态常量docflavor对象例如DOC口味服务格式化打印数据。
DocFlavor.STRING	类docflavor.string提供预定义的静态常量docflavor对象例如DOC香料使用字符串（ java.lang.String）作为打印数据表示的类。
DocFlavor.URL	类docflavor.url提供预定义的静态常量docflavor对象。
PrintServiceLookup	这个类的实现提供打印服务（通常相当于打印机）的查找服务（通常是特定类型的打印机）。
ServiceUI	这个类是一个集合的用户界面方便的方法浏览打印服务提供了一个图形化的用户对话框抬头通过java打印服务API。
ServiceUIFactory	服务可以提供用户界面，允许不同风格的不同角色的互动。
SimpleDoc	这个类是一个实现接口 Doc可用于许多常见的印刷要求。
StreamPrintService	这类扩展 PrintService代表打印服务的打印数据格式不同，给客户提供的输出流。
StreamPrintServiceFactory	一个 StreamPrintServiceFactory是 StreamPrintService实例的工厂，可以打印在一个特定的文件格式称为MIME类型的输出流。

异常摘要

异常	描述
PrintException	类printexception封装印刷相关的错误条件时使用打印服务实例。

Package javax.print Description

提供了主要的类和接口的java ^TM打印服务API。java打印服务API允许客户端和服务器应用程序：

• 根据他们的能力发现和选择打印服务
• 指定打印数据的格式
• 向支持要打印的文档类型的服务提交打印作业。

打印服务发现

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

JDK包括PrintServiceLookup实现定位的标准平台打印机。寻找其他类型的打印机，如IPP打印机或Jini的打印机，打印服务提供商可以实现PrintServiceLookup。打印服务提供商可以动态地安装这些PrintServiceLookup实现使用 SPI JAR file specification。

属性定义

的 javax.print.attribute和 javax.print.attribute.standard包定义打印属性，它描述一个打印服务的能力，指定打印作业的要求，并跟踪打印作业的进展。

的javax.print.attribute包描述了属性的类型以及如何将它们收集到集。的javax.print.attribute.standard封装枚举所有的标准属性的API支持，其中大部分是属性在IETF规范，规定 RFC 2911 Internet Printing Protocol, 1.1: Model and Semantics实现，日期为九月2000。在javax.print.attribute.standard指定的属性包括常见的功能，如：分辨率、拷贝、媒体的大小，工作的重点，和页面范围。

文档类型说明

的 DocFlavor类代表数据的打印格式，如JPEG、后记。一个 DocFlavor对象由一个MIME类型，描述的格式，和一个文档表示的类的名称，说明文档传送到打印机或输出流。一个应用程序使用的 DocFlavor和属性设置为找到打印机，可以打印的 DocFlavor指定文档类型和有能力指定的属性设置。一个典型的应用程序使用java

使用API

打印服务API执行这些步骤打印要求：

1. 选择一个DocFlavor。
2. 创建一个属性集。
3. 找到一个打印服务可以处理打印请求的DocFlavor和指定的属性设置。
4. 创建一个Doc对象封装DocFlavor和实际打印的数据，它可以有许多形式，包括：PostScript文件，JPEG图像的URL，或纯文本。
5. 获取一个打印作业，以DocPrintJob，从打印服务。
6. 调用打印作业的打印方法。

下面的代码示例演示java打印服务的典型应用API：定位打印机，可以打印五张A4纸双面对PostScript文件，从一个返回打印服务创建一个打印作业，调用打印。

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(MediaSize.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引用参数的方法不正确，除非明确记录方法的有意义的解释。相反的用法是不正确的编码，并可能会导致运行时间的异常，无论是立即或在稍后的时间。时和时是典型的和可以接受的这种情况下运行时的异常实例。

从以下版本开始：

1.4