©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个软件包 下一个软件包 | 框架 无框架 |
请参见:
描述
接口摘要 | |
---|---|
Attribute | 接口 Attribute 是由任何一个打印属性类实现的基本接口,用于指示该类表示某一打印属性。 |
AttributeSet | 接口 AttributeSet 为打印属性集指定接口。 |
DocAttribute | 接口 DocAttribute 是打印属性类实现的一个标记接口,用于指示属性表示文档 (doc) 的设置(“Doc”是一个简短的、容易发音的术语,指“打印数据的片段”。 |
DocAttributeSet | 接口 DocAttributeSet 指定文档属性(即:实现接口 DocAttribute 的打印属性)集的接口。 |
PrintJobAttribute | PrintJobAttribute 是打印属性类实现的标记接口,以指示该属性描述“打印作业”的状态或“打印作业”的一些其他特征。 |
PrintJobAttributeSet | 接口 PrintJobAttributeSet 为打印作业属性(即:实现接口 PrintJobAttribute 的打印属性)集指定接口。 |
PrintRequestAttribute | 接口 PrintRequestAttribute 是打印属性类实现的标记接口,以指示属性表示用于打印作业的请求设置。 |
PrintRequestAttributeSet | 接口 PrintRequestAttributeSet 为打印请求属性(即:实现接口 PrintRequestAttribute 的打印属性)的集合指定接口。 |
PrintServiceAttribute | 接口 PrintServiceAttribute 是打印属性类实现的标记接口,以指示该属性描述“打印服务”的状态或“打印服务”的一些其他特征。 |
PrintServiceAttributeSet | 接口 PrintServiceAttributeSet 为打印作业属性(即:实现接口 PrintServiceAttribute 的打印属性)集指定接口。 |
SupportedValuesAttribute | 接口 SupportedValuesAttribute 是打印属性类实现的标记接口,以指示该属性描述用于其他属性的支持值。 |
类摘要 | |
---|---|
AttributeSetUtilities | 类 AttributeSetUtilities 为操作 AttributeSets 提供静态方法。 |
DateTimeSyntax | 类 DateTimeSyntax 是一个抽象的基类,它提供其值是日期和时间的所有属性的公共实现。 |
EnumSyntax | 类 EnumSyntax 是一个抽象的基类,它提供所有“类型安全枚举”对象的公共实现。 |
HashAttributeSet | 类 HashAttributeSet 提供具有哈希映射特征的 AttributeSet 实现。 |
HashDocAttributeSet | 类 HashDocAttributeSet 提供从类 HashAttributeSet 继承其实现的属性集,并强制执行接口 DocAttributeSet 的语义限制。 |
HashPrintJobAttributeSet | 类 HashPrintJobAttributeSet 提供从类 HashAttributeSet 继承其实现的属性集,并强制执行接口 PrintJobAttributeSet 的语义限制。 |
HashPrintRequestAttributeSet | 类 HashPrintRequestAttributeSet 从类 HashAttributeSet 继承其实现,并强制执行接口 PrintRequestAttributeSet 的语义限制。 |
HashPrintServiceAttributeSet | 类 HashPrintServiceAttributeSet 提供从类 HashAttributeSet 继承其实现的属性集,并强制执行接口 PrintServiceAttributeSet 的语义限制。 |
IntegerSyntax | 类 IntegerSyntax 是一个抽象的基类,它提供具有整数值的所有属性的公共实现。 |
ResolutionSyntax | 类 ResolutionSyntax 是一种抽象的基类,它提供表示打印机分辨率的所有属性的公共实现。 |
SetOfIntegerSyntax | 类 SetOfIntegerSyntax 是一种抽象的基类,它提供其值是非负整数集合的所有属性的公共实现。 |
Size2DSyntax | 类 Size2DSyntax 是一种抽象的基类,它提供表示二维大小的所有属性的公共实现。 |
TextSyntax | 类 TextSyntax 是一种抽象的基类,它提供其值是字符串的所有属性的公共实现。 |
URISyntax | 类 URISyntax 是一种抽象的基类,它提供其值是统一资源标识符 (URI) 的所有属性的公共实现。 |
异常摘要 | |
---|---|
UnmodifiableSetException | 当由于设置不可修改而无法执行请求的操作时,抛出该异常。 |
提供了描述 JavaTM Print Service 属性的类型以及如何分类这些属性的类和接口。
打印数据和处理指令都是独立的实体。这意味着:您可以在不同时间使用不同的处理指令打印同一打印数据。
处理指令不指定打印作业处理该请求的方式;每条处理指令仅是对打印作业结果的描述。打印作业确定实现处理指令所指定结果的方式。将处理指令表示为描述项可为实现打印作业提供更大的灵活性。
在 Java Print Service API 中,通过实现 Attribute 接口的 Java 类来表示属性类别。属性值是这样的类或其某个子类的实例。例如,要指定副本数,应用程序会构造一个具有所需副本数的 Copies 类的实例,并将 Copies
实例用作打印请求的一部分。在这种情况下,Copies
类表示属性类别,Copies
实例表示属性值。
打印机开始处理打印作业之后,关于该作业的其他信息将可供使用,可能包括:作业状态(如完成 或排队)和到目前为止已打印的页数。这些信息片段也是属性。属性还可描述打印机本身,如:打印机名称、打印机位置和已排队的作业数。
Java Print Service API 使用 Attribute
的五个子接口定义这些不同类型的属性:
DocAttribute
应用到打印作业中的一个文档,或作为 PrintRequestAttribute
应用到整个打印作业。某些低级别属性从不用于其自身,但是,总是可以将它们汇集到高级别属性中。这此低级别属性类仅实现接口 Attribute,不能实现任何标记子接口。
Java Print Service API 定义了一组标准属性类,它可以按照 Internet Printing Protocol (IPP) 版本 1.1 对属性进行建模。标准属性类位于子包 javax.print.attribute.standard 中,目的是保持实际属性类在概念上与包 javax.print.attribute 中定义的一般设备分开。
AttributeSet
接口类似于 Map 接口:它提供键到值的映射,其中每个键都是唯一的,并且只能包含一个值。但是,AttributeSet
接口设计用于专门支持 Java Print Service API 的需求。AttributeSet
要求:
AttributeSet
中的每个键对应于一个类别,键的值只能是属性值之一,它属于该键表示的类别。因此,与 Map
不同,AttributeSet
限制了键的可能值:不能将属性类别设置为不属于该类别的属性值。
Attribute
接口的属性添加到该集合。
javax.print.attribute 包中包括了作为属性集接口具体实现的 HashAttributeSet。HashAttributeSet
提供基于哈希映射的属性集。您可以使用此实现,或提供自已的接口 AttributeSet
实现。
Java Print Service API 提供属性集的四个规范,它们限于仅包含四种属性之一,如属性职责一节所讨论的:
在某些上下文中,属性集是只读的,这意味着只允许客户端检查属性集的内容,但不能更改它们。在其他上下文中,属性集是可读写的,这意味着允许客户端检查和更改属性集的内容。对于只读属性集,调用更改操作会抛出 UnmodifiableSetException
。
包 javax.print.attribute 包括每个属性集子接口的一个具体实现:
Copies
、类 Sides 和 类 PrinterResolution。每个属性类可以包装一个或多个包含属性值的基本数据项。属性集操作在添加属性、在同一类别中查找现有属性和查找给定其类别的属性时经常执行属性类别对象之间的比较。因为属性类别由类表示,所以使用 Class.equals
方法可以执行快速的属性值比较。
尽管 Java Print Service API 包括大量不同的属性类别,但是仅存在很少的不同类型的属性值。大多数属性可由少量数据类型表示,如:整数值、整数范围、文本或整数值的枚举。类别接受的属性值类型称为属性的抽象语法。为了提供一致性并减少代码重复,Java Print Service API 定义了抽象语法类,以表示每个抽象语法,并且只要可能,可以将这些类用作标准属性的父级。抽象语法类是:
每个属性类可以直接或间接实现 Attribute
接口,以便将其标记为打印属性。在某些上下文的限制属性集中出现的属性类也实现 Attribute
的一个或多个子接口。多数属性类也扩展适当的抽象语法类,以获取该实现。考虑 Sides
属性类:
public class Sides extends EnumSyntax implements DocAttribute, PrintRequestAttribute, PrintJobAttribute { public final Object getCategory() { return Sides.class; } ... }
由于每个属性类会实现 Attribute
,所以每个属性类必须提供返回属性类别的 getCategory
方法的实现。对于属性 Sides
,getCategory
方法返回 Sides.class
。getCategory
方法最终确保了标准属性类的所有供应商定义的子类都显示在同一类别中。每个属性对象在构造之后都是不可变的,这样可以随意地传递属性对象引用。要获取不同的属性值,请构造不同的属性对象。
EnumSyntax
的抽象语法类的枚举属性在编译时将所有的可能属性值指定为属性类的单个实例。这意味着在运行时无法构造新的枚举值。要为标准枚举属性定义新的特定于供应商的值,供应商必须定义一个指定单个新实例的新属性类。要确保新的属性值与标准属性值在相同的类别中,新的属性类必须是标准属性类的子类。
要定义新的属性类别,供应商需要定义新的属性类。此属性类(与标准属性类类似)实现 Attribute
或其子接口之一,并扩展抽象语法类。供应商可以使用现有的抽象语法类,或者定义新的抽象语法类。无论在哪里(如在 AttributeSet
中)使用 Attribute
,都可以使用供应商定义的新属性。
PrintRequestAttributeSet
,因为打印请求属性是客户端通常指定的属性类型。下面的示例介绍如何创建打印请求属性的属性集,并查找可以按照指定的属性打印文档的打印机:
FileInputStream psStream; try { psstream = new FileInputStream("file.ps"); } catch (FileNotFoundException ffne) { } if (psstream == null) { return; } //Set the document type. See the DocFlavor documentation for //more information. DocFlavor psInFormat = DocFlavor.INPUT_STREAM.POSTSCRIPT; Doc myDoc = new SimpleDoc(pstream, 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 引用具有有意义的解释时,方法的 null 引用参数才是正确的。与之相反的用法是不正确的编码,可能立即或在稍后某一时间导致运行时异常。IllegalArgumentException 和 NullPointerException 是针对这种情况的典型的、可接受的运行时异常的示例。
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个软件包 下一个软件包 | 框架 无框架 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。