| |
Java高级编程:使用打印服务API |
|
时间: 2005-08-29 来自:matrix |
 |
|
|
表现类
MIME类型描述将要打印的数据的类型,表现的类则表示如何让打印服务得到这些数据。DocFlavor包含了几个静态的内部类,每一个相对应一个表现类和如何装载要打印得数据。
表1中列出了上面提到的内部类和表现类。注意在SERVICE_FORMATTED(一会我会更详细地解释)旁边,每一个和"binary"或者 "character"相对应。事实上,这些差别是人为的,因为"character"数据类型本身就是一种特殊的binary类型。这种情况下,我们说的二进制(binary)数据包括人们可以看懂的字符和一些格式化的字符比如tabs,换行回车等。当然,这些差别很重要,反映出面向字符的表现类并不适合存储二进制数据。
例如,你不会用字符队列或者字符串来保存一个gif文件,你也不能通过Reader接口来访问它。另一方面,因为字符也是一种特殊的二进制数据,它完全适合储存文本信息到字节数组里或者通过InputStream或者一个URL来访问它。
上面定义的任何一个静态内部类相对应一个表现类,但是请记住我说过每一个DocFlavor的实例通过一个表现类和一个MIME来确认要打印的数据的类型。
要访问这样一个实例,你要通过表1总列出的内部类。例如,我们假设你要打印一个在网上通过URL访问的gif文件,这样的话,就选择表现类是javav.net.url,对应的在DocFlavor中的静态类就是URL类。如果你打开那个内部类的文档,你会发现其实它定义了一系列静态的内部类,每一个对应一种打印机支持的MIME类型。表2描述了在DocFlavor.URL里的内部类和MIME
 Table 2. The DocFlavor.URL inner classes | 因为要通过URL打印gif图片,你可以用一下代码来获得实例
| DocFlavor flavor = DocFlavor.URL.GIF; | 这个代码创建了一个DocFlavor实例,代表类是java.net.URL,MIME是image/gif。 表2列出的了DocFlavor.URL的类,那么其他六个内部类呢?我们等下来讨论一下SERVICE_FORMATTED,这之前,看看与二进制数据联系的所有三种类型(BYTE_ARRAY, INPUT_STREAM, and URL)相关的内部类。例如,如果你把gif储存到了一个字节数组里,那么你可以用以下代码:
| DocFlavor flavor = DocFlavor.BYTE_ARRAY.GIF; | 正如有三个与二进制类型关联的内部类一样,与字符类型相关的另外三个类列在表3里
 Table 3. CHAR_ARRAY, READER, and STRING | 所以,如果你想打印储存在字符串中的文本数据,用以下代码: DocFlavor flavor = DocFlavor.STRING.TEXT_PLAIN;
类似的,如果文本来自于网页上的HTML文档,用以下代码:
| DocFlavor flavor = DocFlavor.STRING.TEXT_HTML; | 选择正确的打印机
还记得我们在开始关于讨论DocFlavor之前关于打印机的那个精确支持你想要打印的数据类型的假设吗?这似乎看起来没有必要。实际上,你会对给你的打印机所支持的文档类型感到吃惊。例如,刚提到文本类型看起来似乎是最容易支持的,所以,如果你的程序要打印一个普通文本或者HTML文本,你可以随便选择一个打印服务并把它送到打印机那去。然而大部分打印机不支持基于文本的表现类,如果你试图向打印机发送它不支持的DocFlavor,会产生下面的异常:
Exception in thread "main" sun.print.PrintJobFlavorException: invalid flavor at sun.print.Win32PrintJob.print(Win32PrintJob.java:290) at PrintTest.main(PrintTest.java:11) | 现在你已经知道了如何得到一个DocFlavor的引用而且我们也讨论了选择支持这个flavor的打印机重要性,接下来我来告诉你如何确定你使用的打印机支持它。我先前说过lookupPrintServices()允许你指定一个DocFlavor作为第一个参数,如果你指定的参数非空,那么方法会返回相应支持这个的打印机的实例。例如以下代码将返回可以通过URL来打印gif文件的打印机的列表:
DocFlavor flavor = DocFlavor.URL.GIF; PrintService[] services = PrintServiceLookup.lookupPrintServices(flavor, null); | 另外,如果你的程序已经获得了打印服务的实例,而你想知道它是否支持另一种特定的flavor,你可以调用isDocFlavorSupported()方法。在下面的代码里,将得到一个默认打印机的引用,如果不能打印gif就会出现错误信息:
PrintService service = PrintServiceLookup.lookupDefaultPrintService(); DocFlavor flavor = DocFlavor.URL.GIF; if (!service.isDocFlavorSupported(flavor)) { System.err.println("The printer does not support the appropriate DocFlavor"); } | AttributeSet
正如你看到的,DocFlavor描述打印数据而且可以用来确定打印服务是否支持这种数据。然而,你的程序需要选择一个基于那些支持的元素的打印机。例如,你要打印图片用不同的颜色来描述不同的信息,你想知道提供的服务是否支持彩色打印,如果不,那么要么禁止它使用或者要求提供一个黑白图片。
类似彩色打印,两边打印或者使用不同的定位取决于打印机本身的属性,而javax.print.attribute包包含了许多你可以用于描述这些属性的包和接口。其中一个接口是前面提到的lookupPrintServices()中第二个参数AttributeSet。正如你愿,它返回属性的集合,在调用lookupPrintServices()指定一个不为空的值将返回支持这些属性的打印服务。换句话说,如果DocFlavor和 AttributeSet都不为空,那么方法将返回那些这两种属性都支持的打印机
Attribute
AttributeSet 是属性的集合,一个显而易见的问题是如何指定属性的值呢? javax.print.attribute包里同时含有一个叫Attribute的接口,你马上可以看到通过调用add方法来给AttributeSet创建一个Attribute实例来获得这个集合。在javax.print.attribute.standard包里定义了大量你将要用到的接口。在之前,你可以查看javax.print.attribute这个包里的其他接口。
属性模块
目前为止,我们把属性描述成打印服务的功能,而实际上在java支持的属性中算很简单的。对应每个属性,java都有相应的模块。只有遵循这些模块属性才有效。在不同的java打印服务位置使用不同的属性,而不是所有的属性在任何地方都适用。
为了更好的理解这个,来看一下javax.print.attribute.standard 包里定义的
OrientationRequested和 ColorSupported接口。创建一个新的打印文档时可以指定OrientationRequested属性和用于打印的定位。ColorSupported在你调用PrintService接口的getAttributes方法时返回。OrientationRequested是一个你用来传给打印机的属性,而ColorSupported是打印服务用来提供给你关于打印机能力信息的工具。你可以在创建打印文档时把ColorSupported作为属性指定,因为打印机是否支持彩色打印是你的程序不能控制的。
|
|
|
|
|
|
|
|