javax.print

Interface Doc

所有已知实现类：

SimpleDoc

public interface Doc

接口文档指定为打印作业提供一个打印数据的对象的接口。”“文档”是一个简短的，易于发音的术语，意思是“一个打印数据”，客户机传递到打印作业的一个对象，实现了接口文档，和打印作业调用的方法在该对象上获得打印数据。doc界面让打印作业：

• 确定的格式，或“博士味”（类DocFlavor），其中打印数据是可用的。DOC风味指定打印数据格式（MIME类型）和表示类对象的打印数据。

• 获取打印数据表示对象，这是文档味道的表示类的一个实例。打印作业可以从表示对象中获取实际的打印数据。

• 获取指定附加属性的打印属性，或指定要应用于文档的处理说明的属性。印刷包装javax.print.attribute属性定义。doc返回打印属性存储在一个javax.print.attribute.DocAttributeSet。

在实现接口文件的实现中的每一种方法是允许总是返回相同的对象，每次调用的方法。这对于打印数据表示对象“消耗”打印数据的文档对象的打印作业或其他调用方的影响，因为调用方获得打印数据，例如是一个流的打印数据表示对象。一旦打印作业已被称为getPrintData()得到流，任何进一步的要求getPrintData()将返回相同的流对象的阅读可能已经在进行中，不新的流对象，将重新从头开始读打印数据。指定一个文档对象的行为，这种方式简化了实现的文件对象，并有理由的理由是，一个特定的文件是为了传达打印数据只到一个打印作业，而不是几个不同的打印作业。（向多个不同的打印作业传达相同的打印数据，您必须在同一个打印数据源的顶部创建多个不同的文档对象。）

接口文档提供了相当大的实现灵活性。当文档对象被构造时，打印数据可能已经存在了。在这种情况下，由文档的方法返回的对象可以提供给文档的构造函数，提前存储在文件中，并简单地返回时调用。或者，当构建文档对象时，打印数据可能不存在。在这种情况下，文档对象可能会提供一个“懒惰”的实现，生成打印数据表示的对象（和/或打印数据）只有当打印作业需要（当打印作业要求getPrintData()法）。

有没有限制的客户端线程的数量，可能会同时访问相同的文件。因此，所有的接口文件的实现都必须设计为多线程安全。

然而，只有一个消费者的打印数据从医生获得的。

如果从客户端获得一个流是打印数据，通过调用文件的getReaderForText()或getStreamForBytes()方法，或者因为打印数据源已经是一个InputStream或Reader，然后打印服务应该关闭这些流在所有工作完成情况的客户。用下面的警告。如果打印数据本身是一个流，服务将永远关闭它。如果打印数据在其他可以被请求作为流的其他东西，服务将只关闭流，如果它获得了流在终止。就是说，仅仅因为一个打印服务可能要求数据流并不意味着它将与DOC的实现依赖于服务关闭它们应该只响应来自服务请求创建流的影响。

方法摘要

Modifier and Type	Method and Description
DocAttributeSet	getAttributes() 获取此文档对象的打印属性集。
DocFlavor	getDocFlavor() 确定此文档对象将提供其打印数据的文档的味道。
Object	getPrintData() 获取包含此文档对象的打印数据的打印数据表示对象，该对象的打印数据对应于支持的文档味道的格式。
Reader	getReaderForText() 获取一个用于从该文档中提取字符打印数据的读写器。
InputStream	getStreamForBytes() 获取一个用于从该文档中提取字节打印数据的输入流。

方法详细信息

getDocFlavor

DocFlavor getDocFlavor()

确定此文档对象将提供其打印数据的文档的味道。

结果

DOC的味道。

getPrintData

Object getPrintData()
             throws IOException

获取包含此文档对象的打印数据的打印数据表示对象，该对象的打印数据对应于支持的文档味道的格式。方法返回的 getPrintData()表示类的名称是由 getDocFlavor().getRepresentationClassName()实例，并返回值可以转换从类对象类，表示。

结果

打印数据表示对象。

异常

IOException如果表示的类是一个流有I/O错误而构建流扔。

getAttributes

DocAttributeSet getAttributes()

获取此文档对象的打印属性集。如果返回的属性集包括一个特定属性X的实例，打印机必须使用该属性值为这个文件，重写作业属性集中的任何属性x的值。如果返回的属性集不包括一个特定属性x的实例或返回，打印机必须咨询工作的属性集，以获得属性x的值，如果没有发现，打印机必须使用一个依赖于实现的默认值。返回的属性集是不可修改的。

结果

不可修改的文档打印属性，或空从工作的属性获得的所有属性值的设置。

getReaderForText

Reader getReaderForText()
                 throws IOException

获取一个用于从该文档中提取字符打印数据的读写器。doc实现来支持此方法如果docflavor具有下面的打印数据表示的类，并返回空，否则：

• 字符[ ]
• java.lang.string
• java.io.reader

文档的打印数据表示的对象是用来构建并返回一个读者阅读的打印数据从打印数据表示对象的字符流。但是，如果打印数据表示对象本身是一个读写器，则简单返回打印数据表示对象。

结果

用于读取本文档的打印数据字符的读写器。如果无法提供读写器，因为此文档不符合上面所述的条件，则返回。

异常

IOException -扔如果有I/O错误而创造读者。

getStreamForBytes

InputStream getStreamForBytes()
                       throws IOException

获取一个用于从该文档中提取字节打印数据的输入流。doc实现来支持此方法如果docflavor具有下面的打印数据表示的类，并返回空，否则：获得

• 字节[ ]
• 输入流

文档的打印数据表示的对象，然后阅读打印数据的打印数据表示的对象作为一个字节流被创建并返回一个输入流。但是，如果打印数据表示对象本身是一个输入流，则简单返回打印数据表示对象。

结果

用于读取从本文档的打印数据字节的输入流。如果不能提供输入流，因为此文档不符合上面所述的条件，则返回。

异常

IOException -扔如果有I/O错误而创建的输入流。