java.lang.Object javax.print.SimpleDoc
此类是接口 Doc
的实现,可用于很多常见的打印请求中。它可处理目前作为 DocFlavor 类中静态变量所定义的所有“预定义” doc flavor。
特别是此类实现了某些 Doc 规范所必需的语义:
如果打印数据是一个流,或者打印作业以流的形式请求数据,那么当数据传输完成或作业终止后服务正确地关闭该流时,SimpleDoc
不再进行监视。客户端可能优先使用其自己添加了侦听器的 doc 实现,以监视作业的完成并验证是否有诸如流等的可用资源(即是否已关闭)。
构造方法摘要 | |
---|---|
SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes) 构造具有指定打印数据、doc flavor 和 doc 属性集的 SimpleDoc 。 |
方法摘要 | |
---|---|
DocAttributeSet |
getAttributes() 获得此 doc 对象的打印属性集。 |
DocFlavor |
getDocFlavor() 确定其 doc 对象将提供其部分打印数据的 doc flavor。 |
Object |
getPrintData() 获得打印数据表示形式对象,该对象包含此 doc 对象的部分打印数据,其格式对应于受支持的 DocFlavor。 |
Reader |
getReaderForText() 获得一个从此 doc 中提取字符打印数据的 reader。 |
InputStream |
getStreamForBytes() 获得一个从此 doc 中提取 byte 打印数据的输入流。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
SimpleDoc
。
printData
- 打印数据对象
flavor
-
DocFlavor
对象
attributes
-
DocAttributeSet
,可以为
null
IllegalArgumentException
- 如果
flavor
或
printData
为
null
,或者
printData
不对应于指定的 doc flavor--例如,数据不是
DocFlavor
中的表示形式所指定的类型。
方法详细信息 |
---|
public DocFlavor getDocFlavor()
Doc
中的
getDocFlavor
public DocAttributeSet getAttributes()
Doc
中的
getAttributes
public Object getPrintData() throws IOException
Doc
复制的描述
getPrintData()
方法返回一个表示形式类的实例,其名称由
getDocFlavor()
、getRepresentationClassName()
给定,可将返回值从类 Object 强制转换为该表示形式类。
Doc
中的
getPrintData
IOException
- 如果表示形式类是一个流且在构造该流时存在 I/O 错误。
public Reader getReaderForText() throws IOException
DocFlavor
具有以下打印数据表示形式类之一,则需要
Doc
实现支持此方法,否则返回
null
:
char[]
java.lang.String
java.io.Reader
Reader
。但是,如果打印数据表示形式对象本身就是一个
Reader
,则只返回该打印数据表示形式对象。
Doc
中的
getReaderForText
Reader
。如果因为此 doc 不符合上述标准而无法提供 reader,则返回
null
。
IOException
- 如果创建 reader 时存在 I/O 错误。
public InputStream getStreamForBytes() throws IOException
DocFlavor
具有以下打印数据表示形式类之一,则需要
Doc
实现支持此方法,否则此方法返回
null
:
byte[]
java.io.InputStream
Doc
中的
getStreamForBytes
InputStream
。如果因为此 doc 不符合上述标准而无法提供输入流,则返回
null
。
IOException
- 如果创建输入流时存在 I/O 错误。