PrintService (Java Platform SE 8 )

All Known Subinterfaces:: MultiDocPrintService

所有已知实现类：: StreamPrintService

public interface PrintService

界面打字是一个docprintjob工厂。一个打字了打印机的功能，可以查询关于打印机的支持的属性。

例子:


   DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT;
   PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
   aset.add(MediaSizeName.ISO_A4);
   PrintService[] pservices =
                 PrintServiceLookup.lookupPrintServices(flavor, aset);
   if (pservices.length > 0) {
       DocPrintJob pj = pservices[0].createPrintJob();
       try {
           FileInputStream fis = new FileInputStream("test.ps");
           Doc doc = new SimpleDoc(fis, flavor, null);
           pj.print(doc, aset);
        } catch (FileNotFoundException fe) {
        } catch (PrintException e) {
        }
   }

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`addPrintServiceAttributeListener(PrintServiceAttributeListener listener)` 注册一个在打字的事件监听器。
`DocPrintJob`	`createPrintJob()` 创建并返回一个能够处理从任何支持的文档数据PRINTJOB口味。
`boolean`	`equals(Object obj)` 确定两个服务是否指同一个基础服务。
`<T extends PrintServiceAttribute> T`	`getAttribute(类<T> category)` 获取单个指定的服务属性的值。
`PrintServiceAttributeSet`	`getAttributes()` 获取此打印服务的打印机描述属性的设置，使此打印服务的状态。
`Object`	`getDefaultAttributeValue(类<? extends Attribute> category)` 确定在给定类别中的该打印服务的默认打印属性值。
`String`	`getName()` 返回用于请求特定打印服务的应用程序使用的打印服务的字符串名称。
`ServiceUIFactory`	`getServiceUIFactory()` 返回一个允许用户在不同角色中与服务交互的用户界面组件的工厂。
`类<?>[]`	`getSupportedAttributeCategories()` 确定在为该打印服务设置一个作业时，客户机可以指定的打印属性类别。
`Object`	`getSupportedAttributeValues(类<? extends Attribute> category, DocFlavor flavor, AttributeSet attributes)` 确定在为该打印服务设置一个作业时，客户端可以在指定类别中指定的打印属性值。
`DocFlavor[]`	`getSupportedDocFlavors()` 确定打印数据格式，客户可以指定当建立这个 `PrintService`工作。
`AttributeSet`	`getUnsupportedAttributes(DocFlavor flavor, AttributeSet attributes)` 确定了在特定的语境docflavor打印请求是不支持的属性。
`int`	`hashCode()` 应使用此方法始终与 `equals(Object)`。
`boolean`	`isAttributeCategorySupported(类<? extends Attribute> category)` 确定是否在为该打印服务设置一个作业时，客户端是否可以指定给定的打印属性类别。
`boolean`	`isAttributeValueSupported(Attribute attrval, DocFlavor flavor, AttributeSet attributes)` 确定在设置此打印服务的作业时，客户端是否可以指定给定的打印属性值。
`boolean`	`isDocFlavorSupported(DocFlavor flavor)` 确定这是否打印服务支持一个特定的 `DocFlavor`。
`void`	`removePrintServiceAttributeListener(PrintServiceAttributeListener listener)` 从该打印服务中删除打印服务侦听器。

- 方法详细信息
  - getName
```
String getName()
```
    返回用于请求特定打印服务的应用程序使用的打印服务的字符串名称。在一个合适的上下文中，例如一个名称服务，这个名称必须是唯一的。在某些环境中，这种独特的名称可以作为用户友好的打印机名称定义为 PrinterName属性相同。
    
    结果
    
    服务名称。
  - createPrintJob
```
DocPrintJob createPrintJob()
```
    创建并返回一个能够处理从任何支持的文档数据PRINTJOB口味。
    
    结果
    
    一个docprintjob对象
  - addPrintServiceAttributeListener
```
void addPrintServiceAttributeListener(PrintServiceAttributeListener listener)
```
    注册一个在打字的事件监听器。
    
    参数
    
    listener - printserviceattributelistener，监测打印服务的状态
    
    另请参见：
    
    removePrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)
  - removePrintServiceAttributeListener
```
void removePrintServiceAttributeListener(PrintServiceAttributeListener listener)
```
    从该打印服务中删除打印服务侦听器。这意味着，听众不再是 PrintService事件感兴趣。
    
    参数
    
    listener - printserviceattributelistener对象
    
    另请参见：
    
    addPrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)
  - getAttributes
```
PrintServiceAttributeSet getAttributes()
```
    获取此打印服务的打印机描述属性的设置，使此打印服务的状态。返回的对象是不可修改的属性集。返回的属性设置的对象是一个“快照”这个打印服务的属性设置在 getAttributes()方法调用的时间：即返回的属性集的内容将不被更新，如果将来改变这种打印服务的属性集的内容。检测属性值的变化，又称 getAttributes()比较集前面的属性设置新的属性；另外，登记一个打印服务的事件监听器。
    
    结果
    
    不可修改的快照这个打印服务的属性集。可能是空的，但不是空的。
  - getAttribute
```
<T extends PrintServiceAttribute> T getAttribute(类<T> category)
```
    获取单个指定的服务属性的值。这可能是有用的客户端，只需要一个属性的值，并希望尽量减少开销。
    
    参数
    
    category -一个printserviceattribute这个服务支持类不得空。
    
    结果
    
    如果不支持此服务，支持的属性或空的值。
    
    异常
    
    NullPointerException -如果类别是空的。
    
    IllegalArgumentException -（unchecked例外）如果 category不是 类实现接口 PrintServiceAttribute。
  - getSupportedDocFlavors
```
DocFlavor[] getSupportedDocFlavors()
```
    确定打印数据格式，客户可以指定当建立这个 PrintService工作。打印数据格式由一个“博士味指定”（类 DocFlavor）组成的一个MIME类型加上打印数据表示的类。
    请注意，一些文档的味道可能不被支持与所有属性相结合。使用getUnsupportedAttributes(..)验证特定的组合。
    
    结果
    
    支持的文档的味道，应该至少有一个元素。
  - isDocFlavorSupported
```
boolean isDocFlavorSupported(DocFlavor flavor)
```
    确定这是否打印服务支持一个特定的 DocFlavor。这是一个确定的 DocFlavor会对 getSupportedDocFlavors()结果成员方便的方法。
    请注意，一些文档的味道可能不被支持与所有属性相结合。使用getUnsupportedAttributes(..)验证特定的组合。
    
    参数
    
    flavor -支持 DocFlavorto查询。
    
    结果
    
    true如果打印服务支持指定的 DocFlavor； false否则。
    
    异常
    
    NullPointerException -（unchecked异常）如果 flavor空抛。
  - getSupportedAttributeCategories
```
类<?>[] getSupportedAttributeCategories()
```
    确定在为该打印服务设置一个作业时，客户机可以指定的打印属性类别。打印属性范畴是由 类实现指定接口 Attribute。此方法返回的属性类别所支持的；它不返回特定的属性价值观所支持。
    此方法返回此打印服务支持的所有可能的作业的所有打印属性类别。某些类别可能不在特定情况下的支持（即一个特定的DocFlavor）。使用的方法包括DocFlavor之前提交验证请求，如getSupportedAttributeValues(..)。
    
    结果
    
    客户机可以在打印请求中指定为文档级或作业级属性的打印属性类别的数组。数组中的每个元素是一个 类实现接口 Attribute。数组是空的，如果没有支持类别。
  - isAttributeCategorySupported
```
boolean isAttributeCategorySupported(类<? extends Attribute> category)
```
    确定是否在为该打印服务设置一个作业时，客户端是否可以指定给定的打印属性类别。打印属性范畴是由 类实现指定接口 Attribute。这个方法告诉属性是否类别支持；它不能告诉是否一个特定的属性价值支持。
    某些类别可能不在特定情况下的支持（即一个特定的DocFlavor）。使用的方法包括DocFlavor之前提交验证请求，如getSupportedAttributeValues(..)。
    
    这是一个确定的类别会对getSupportedAttributeCategories()结果成员方便的方法。
    
    参数
    
    category打印属性分类测试。它必须是一个 类实现接口 Attribute。
    
    结果
    
    true如果打印服务支持指定医生水平或工作水平 category属性在打印要求； false如果不行。
    
    异常
    
    NullPointerException -（unchecked异常）如果 category空抛。
    
    IllegalArgumentException -（unchecked例外）如果 category不是 类实现接口 Attribute扔。
  - getDefaultAttributeValue
```
Object getDefaultAttributeValue(类<? extends Attribute> category)
```
    确定在给定类别中的该打印服务的默认打印属性值。打印属性值是一个类实现接口 Attribute实例。如果一个客户机设置了一个打印作业，并且不在指定的类别中指定任何属性值，则此打印服务将使用默认属性值代替。
    有些属性可能不在特定情况下的支持（即一个特定的DocFlavor）。使用的方法包括DocFlavor之前提交验证请求，如getSupportedAttributeValues(..)。
    
    并不是所有的属性都有一个默认值。例如，服务不会有RequestingUser即支持的类空返回值，意味着有没有分类服务的默认值。使用isAttributeCategorySupported(Class)方法区分这些情况。
    
    参数
    
    category打印属性类的默认属性值的要求。它必须是一个 类实现接口 Attribute。
    
    结果
    
    category默认属性值为空，或者如果这个打印服务不支持指定的医生水平或工作水平 category属性在打印请求，或服务不具有此属性的默认值。
    
    异常
    
    NullPointerException -（unchecked异常）如果 category空抛。
    
    IllegalArgumentException -（unchecked例外）如果 category不是 类实现接口 Attribute扔。
  - getSupportedAttributeValues
```
Object getSupportedAttributeValues(类<? extends Attribute> category,
                                   DocFlavor flavor,
                                   AttributeSet attributes)
```
    确定在为该打印服务设置一个作业时，客户端可以在指定类别中指定的打印属性值。打印属性值是一个类实现接口 Attribute实例。
    如果flavor无效attributes是null或空设置，此方法返回所有的打印属性值这个打印服务支持任何可能的工作。如果flavor是无效的或attributes不是空集，此方法返回只是打印属性值，与给定的DOC的风味和/或组属性兼容。那是一个空的返回值可能表明指定此属性与指定的docflavor不相容。如果DocFlavor不为空，它必须是一个味道的打字时会被支持，其他。
    
    如果attributes参数包含的类别为category参数相同的属性，服务必须忽略该属性在attributeset。
    
    DocAttributes是在Doc指定必须包含在这套精确表示上下文。
    
    此方法返回一个对象，因为不同的打印属性类别表示支持的属性值以不同的方式显示。在包装印刷javax.print.attribute.standard每个属性的文档介绍了如何每个属性表明其支持的值。指示支持的可能方式包括：
    - 返回属性类别的一个实例，以表示任何值都是合法的，例如，由一个属性，其值是一个任意的文本字符串。返回的属性对象的值是不相关的。）
    - 返回属性类别的一个或多个实例的数组，其中包含的法律值-使用的，例如，由一个属性列表的枚举值。数组的类型是指定的属性类型的getCategory(Class)返回一个数组。
    - 返回一个单一的对象（一些类以外的属性类别），表示范围的法律值-使用，例如，由一个整数值的属性，必须在一定范围内。
    参数
    
    category打印属性分类测试。它必须是一个 类实现接口 Attribute。
    
    flavor文档风味的一个工作，或者为空。
    
    attributes -设置一个打印作业属性（工作级别的属性和文件级属性），或空。
    
    结果
    
    对象表示支持的值为 category，或null如果打印服务不支持指定的医生水平或工作水平 category属性在打印请求。
    
    异常
    
    NullPointerException -（unchecked异常）如果 category空抛。
    
    IllegalArgumentException -（unchecked例外）如果 category不是 类实现接口 Attribute抛出，或 DocFlavor是不被支持的服务。
  - isAttributeValueSupported
```
boolean isAttributeValueSupported(Attribute attrval,
                                  DocFlavor flavor,
                                  AttributeSet attributes)
```
    确定在设置此打印服务的作业时，客户端是否可以指定给定的打印属性值。打印属性值是一个类实现接口 Attribute实例。
    如果flavor无效attributes是null或空设置，这个方法告诉这是否打印服务支持给医生一些可能的组合印刷的属性值和属性集。如果flavor是无效的或attributes不是空集，这个方法告诉这是否打印服务支持给定的打印属性值与给定的DOC的风味和/或组属性组合。
    
    如果DocFlavor不为空，它必须是一个味道的打字时会被支持，其他。
    
    DocAttributes是在Doc指定必须包含在这套精确表示上下文。
    
    这是一个确定的值会对getSupportedAttributeValues(...)结果成员方便的方法。
    
    参数
    
    attrval打印属性值来测试。
    
    flavor文档风味的一个工作，或者为空。
    
    attributes -设置一个打印作业属性（工作级别的属性和文件级属性），或空。
    
    结果
    
    如果这个打印服务支持指定 attrval为DOC级别或职位级别属性在打印请求真，假如果不行。
    
    异常
    
    NullPointerException -（unchecked异常）如果 attrval是空的。
    
    IllegalArgumentException如果味道不支持这个打字。
  - getUnsupportedAttributes
```
AttributeSet getUnsupportedAttributes(DocFlavor flavor,
                                      AttributeSet attributes)
```
    确定了在特定的语境docflavor打印请求是不支持的属性。此方法是有用的用于验证一个潜在的打印作业，并确定不能支持的特定属性。它只提供一个支持docflavor或将抛出IllegalArgumentException重要。如果这个方法的返回值为空，则所有属性都被支持。
    DocAttributes是在Doc指定必须包含在这套精确表示上下文。
    
    如果返回值为非零，在返回的集合的所有属性都不支持这个docflavor。返回的集合不区分由不支持的属性值所支持的属性类别。
    
    然后支持的打印请求就可以从原来的属性集，去除所有不支持的属性创建的，除了不支持的情况下，docflavor。
    
    如果任何属性都是不支持的，因为他们是在与其他属性的冲突，那么它是在服务的自由裁量权选择的属性（S）被确定为冲突的原因。
    
    使用isDocFlavorSupported()验证docflavor支撑在调用此方法之前。
    
    参数
    
    flavor文档味道测试，或空
    
    attributes -设置一个打印作业属性（工作级别的属性和文件级属性），或空。
    
    结果
    
    如果此打印服务支持打印请求规范，否则将不支持的属性。
    
    异常
    
    IllegalArgumentException -如果 flavor不支持这个打字。
  - getServiceUIFactory
```
ServiceUIFactory getServiceUIFactory()
```
    返回一个允许用户在不同角色中与服务交互的用户界面组件的工厂。不提供任何用户界面的服务应该返回为空。打印服务，不提供用户界面却要在一个没有UI支持环境支持应确保工厂不初始化，除非应用程序调用此方法得到厂。更多信息见 ServiceUIFactory。
    
    结果
    
    为用户界面组件的空或一个工厂。
  - equals
```
boolean equals(Object obj)
```
    确定两个服务是否指同一个基础服务。封装打印服务的对象即使它们引用相同的底层服务，也可能不会表现出引用的平等性。
    客户应该调用此方法来确定是否两个服务是指同一个基本服务。
    
    服务必须实现这个方法，只有在比较服务对象可以互换使用的客户端返回true。服务是免费返回相同的对象引用到一个基本的服务，如果该，但客户不能依靠平等的参考。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -参考对象的比较。
    
    结果
    
    如果此服务被作为obj参数相同的真，否则为假。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
int hashCode()
```
    应使用此方法始终与 equals(Object)。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface PrintService

方法摘要

方法详细信息

getName

createPrintJob

addPrintServiceAttributeListener

removePrintServiceAttributeListener

getAttributes

getAttribute

getSupportedDocFlavors

isDocFlavorSupported

getSupportedAttributeCategories

isAttributeCategorySupported

getDefaultAttributeValue

getSupportedAttributeValues

isAttributeValueSupported

getUnsupportedAttributes

getServiceUIFactory

equals

hashCode