javax.print

Class SimpleDoc

java.lang.Object

javax.print.SimpleDoc

All Implemented Interfaces:

Doc

public final class SimpleDoc
extends Object
implements Doc

这个类是一个实现接口 Doc可用于许多常见的印刷要求。它可以处理所有当前定义的“定义”定义为在docflavor DOC香料类的静态变量。

特别是这个类实现了某些所需的语义的文件规范如下：

• 为服务构造一个服务的流，如果请求和适当的。
• 确保在一个方法中每个调用都返回相同的对象。
• 确保多个线程可以访问文件
• 执行一些验证的数据与文档的味道相匹配。

客户谁想要在其他工作的文档对象的重复使用，或需要一个多文档不想使用这个类。

如果打印数据流，或打印作业请求的数据流，然后SimpleDoc不会监控，如果服务正常关闭流数据传输完成或工作结束后。客户端可能更喜欢使用提供自己的实现的文件，增加了一个侦听器来监视作业完成，并验证这些资源，如流被释放（即关闭）。

构造方法摘要

构造方法

Constructor and Description
SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes) 构建一个与指定的打印数据 SimpleDoc，DOC的风味和文件属性设置。

方法摘要

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SimpleDoc

public SimpleDoc(Object printData,
                 DocFlavor flavor,
                 DocAttributeSet attributes)

构建了一个 SimpleDoc与指定的打印数据，DOC的风味和文件属性设置。

参数

printData -打印数据对象

flavor - DocFlavor对象

attributes - DocAttributeSet，可 null

异常

IllegalArgumentException -如果 flavor或 printData是 null，或 printData不符合指定的医生的味道--例如，数据没有被指定在 DocFlavor表示式。

方法详细信息

getDocFlavor

public DocFlavor getDocFlavor()

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

Specified by:

getDocFlavor 接口 Doc

结果

DOC的味道。

getAttributes

public DocAttributeSet getAttributes()

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

Specified by:

getAttributes 接口 Doc

结果

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

getPrintData

public Object getPrintData()
                    throws IOException

从接口复制的描述： Doc

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

Specified by:

getPrintData 接口 Doc

结果

打印数据表示对象。

异常

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

getReaderForText

public Reader getReaderForText()
                        throws IOException

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

• char[]
• java.lang.String
• java.io.Reader

文档的打印数据表示的对象是用来构建并返回一个阅读打印数据从打印数据对象表示的字符流 Reader。然而，如果打印数据表示对象本身是一个 Reader然后打印数据表示的对象只是返回。

Specified by:

getReaderForText 接口 Doc

结果

一种从文档阅读打印数据的特点 Reader。如果读者不能提供这个文件因为不符合以上标准， null返回。

异常

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

getStreamForBytes

public InputStream getStreamForBytes()
                              throws IOException

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

• byte[]
• java.io.InputStream

DOC的打印数据表示的对象。然后，从创建并返回的字节流中读取打印数据表示对象的打印数据的输入流。然而，如果打印数据表示对象本身是一个输入流，则简单返回打印数据表示对象的。

Specified by:

getStreamForBytes 接口 Doc

结果

从这个文件读取一个字节 InputStream打印数据。如果一个输入流无法提供因为这文件不符合以上标准， null返回。

异常

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