ServiceRegistry (Java Platform SE 8 )

java.lang.Object
- javax.imageio.spi.ServiceRegistry

已知直接子类：

IIORegistry
```
public class ServiceRegistry
extends Object
```
服务提供商实例的注册表。
一个服务是一组众所周知的接口（通常是抽象的）类。 服务提供商是服务的具体实现。提供者中的类通常实现接口或子类化服务本身定义的类。

服务提供商存储在一个或多个类别中 ，每个类别由其所有成员必须实现的一类接口（由类对象描述）定义。可以动态地更改类别集合。

只有一个给定叶类的一个实例（也就是getClass()返回的实际类，而不是任何继承的类或接口）可以被注册。也就是说，假设com.mycompany.mypkg.GreenServiceProvider类实现了com.mycompany.mypkg.MyService接口。如果注册了一个GreenServiceProvider实例，它将被存储在由MyService类定义的类别中。如果一个新的实例GreenServiceProvider注册，它将替换以前的实例。实际上，服务提供商对象通常是单身，因此这种行为是合适的。

要声明服务提供商， services子目录将放置在每个JAR文件中存在的META-INF目录中。此目录包含每个服务提供程序接口的文件，该接口在JAR文件中具有一个或多个实现类。例如，如果JAR文件包含了一个名为类com.mycompany.mypkg.MyServiceImpl它实现了javax.someapi.SomeService接口，JAR文件将包含一个文件名为：
```
  META-INF/services/javax.someapi.SomeService 
```
包含行：
```
  com.mycompany.mypkg.MyService 
```
服务提供商类应该是轻量级的，并且加载速度快。这些接口的实现应避免对其他类和本地代码的复杂依赖。更复杂服务的通常模式是为重量级服务注册轻量级代理。

只要具有适当的运行时权限，应用程序就可以自定义注册表的内容。

有关声明服务提供商的更多详细信息，以及JAR格式，请参阅JAR File Specification 。
另请参见：

RegisterableService

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`ServiceRegistry.Filter` 通过使用一个简单的过滤器接口 `ServiceRegistry.getServiceProviders`选择提供商任意条件匹配的。

构造方法摘要

构造方法
Constructor and Description
`ServiceRegistry(Iterator<类<?>> categories)` 构造一个 `ServiceRegistry`实例，其中一组类别取自 `categories`参数。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`contains(Object provider)` 返回 `true`如果 `provider`当前注册。
`void`	`deregisterAll()` 取消注册所有类别的所有当前注册服务提供商。
`void`	`deregisterAll(类<?> category)` 取消注册目前在给定类别下注册的所有服务提供商对象。
`void`	`deregisterServiceProvider(Object provider)` 从包含它的所有类别中删除服务提供商对象。
`<T> boolean`	`deregisterServiceProvider(T provider, 类<T> category)` 从给定的类别中删除服务提供者对象。
`void`	`finalize()` 在垃圾收集之前完成此对象。
`Iterator<类<?>>`	`getCategories()` 返回一个 `Iterator`个 `类`对象，指示当前的一组类别。
`<T> T`	`getServiceProviderByClass(类<T> providerClass)` 返回给定类类型的当前注册的服务提供者对象。
`<T> Iterator<T>`	`getServiceProviders(类<T> category, boolean useOrdering)` 返回一个 `Iterator`包含给定类别中所有已注册的服务商。
`<T> Iterator<T>`	`getServiceProviders(类<T> category, ServiceRegistry.Filter filter, boolean useOrdering)` 返回 `Iterator`一个给定类别中满足由所提供的定义的条件的含服务提供程序对象 `ServiceRegistry.Filter`对象的 `filter`方法。
`static <T> Iterator<T>`	`lookupProviders(类<T> providerClass)` 使用上下文类加载器定位并递增实例化给定服务的可用提供程序。
`static <T> Iterator<T>`	`lookupProviders(类<T> providerClass, ClassLoader loader)` 使用给定的类加载器搜索特定服务类的实现。
`void`	`registerServiceProvider(Object provider)` 将服务提供者对象添加到注册表。
`<T> boolean`	`registerServiceProvider(T provider, 类<T> category)` 将服务提供者对象添加到注册表。
`void`	`registerServiceProviders(Iterator<?> providers)` 添加一组从 `Iterator`到注册表的服务提供者对象。
`<T> boolean`	`setOrdering(类<T> category, T firstProvider, T secondProvider)` 在给定类别中的两个服务提供者对象之间设置成对排序。
`<T> boolean`	`unsetOrdering(类<T> category, T firstProvider, T secondProvider)` 在给定类别中的两个服务提供者对象之间设置成对排序。

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - ServiceRegistry
```
public ServiceRegistry(Iterator<类<?>> categories)
```
    构造一个 ServiceRegistry实例，其中包含一组从 categories参数获取的 categories 。
    
    参数
    
    categories - 一个 Iterator包含用于定义类别的 类对象。
    
    异常
    
    IllegalArgumentException - 如果 categories是 null 。
- 方法详细信息
  - lookupProviders
```
public static <T> Iterator<T> lookupProviders(类<T> providerClass,
                                              ClassLoader loader)
```
    使用给定的类加载器搜索特定服务类的实现。
    此方法将给定服务类的名称转换为类注释中所述的提供者配置文件名，然后使用给定类加载器的getResources方法查找具有该名称的所有可用文件。然后读取和解析这些文件以产生一个提供者类名称列表。返回的迭代器使用给定的类加载器来查找列表中的每个元素，然后实例化。
    
    因为可以将扩展安装到正在运行的Java虚拟机中，所以每次调用此方法时都可能会返回不同的结果。
    
    参数类型
    
    T - T的类型。
    
    参数
    
    providerClass - 一个 类对象，指示正在检测到的服务提供商的类或接口。
    
    loader -类加载器用于加载提供者配置文件和实例化提供者类，或 null如果要使用的系统类加载器（或，如若不然引导类加载器）的。
    
    结果
    
    Iterator以某种任意顺序产生给定服务的提供者对象。迭代器都将抛出一个Error如果提供者配置文件违反指定的格式，或者如果一个供应商类不能被发现和实例化。
    
    异常
    
    IllegalArgumentException - 如果 providerClass是 null 。
  - lookupProviders
```
public static <T> Iterator<T> lookupProviders(类<T> providerClass)
```
    使用上下文类加载器定位并递增实例化给定服务的可用提供程序。这种方便方法相当于：
```
  ClassLoader cl = Thread.currentThread().getContextClassLoader();
   return Service.providers(service, cl); 
```
    参数类型
    
    T - T的类型。
    
    参数
    
    providerClass - 一个指示所检测到的服务提供商的类或接口的 类对象。
    
    结果
    
    Iterator以某种任意顺序产生给定服务的提供者对象。迭代器都将抛出一个Error如果提供者配置文件违反指定的格式，或者如果一个供应商类不能被发现和实例化。
    
    异常
    
    IllegalArgumentException - 如果 providerClass是 null 。
  - getCategories
```
public Iterator<类<?>> getCategories()
```
    返回Iterator的类对象，指示当前的类别集。如果没有类别，迭代器将为空。
    
    结果
    
    一个 Iterator包含 类对象。
  - registerServiceProvider
```
public <T> boolean registerServiceProvider(T provider,
                                           类<T> category)
```
    将服务提供者对象添加到注册表。提供者与给定类别相关联。
    如果provider实现了RegisterableService接口，则会调用其onRegistration方法。每当它从类别中注销时，将会调用其onDeregistration方法，例如，如果某个类别被删除或注册表被垃圾回收。
    
    参数类型
    
    T - 提供者的类型。
    
    参数
    
    provider - 服务提供要注册的对象。
    
    category - 注册提供者的类别。
    
    结果
    
    如果没有同一类的提供者以前在同一类别类别中注册，则为true。
    
    异常
    
    IllegalArgumentException - 如果 provider是 null 。
    
    IllegalArgumentException - 如果没有类别对应 category 。
    
    ClassCastException - 如果提供者没有实现由 类定义的 category 。
  - registerServiceProvider
```
public void registerServiceProvider(Object provider)
```
    将服务提供者对象添加到注册表。提供者在其类的注册表中存在的每个类别中关联。
    如果provider实现了RegisterableService接口，则其onRegistration方法将在其onRegistration的每个类别被调用一次。它的onDeregistration方法将在每次从类别注销时或注册表完成时被调用。
    
    参数
    
    provider - 要注册的服务提供商对象。
    
    异常
    
    IllegalArgumentException - 如果 provider是 null 。
  - registerServiceProviders
```
public void registerServiceProviders(Iterator<?> providers)
```
    添加一组服务提供者对象，从Iterator到注册表。每个提供者在其类的注册表中存在的每个类别中关联。
    对于实现providers接口的RegisterableService每个条目，其onRegistration方法对于其onRegistration的每个类别将被调用一次。它的onDeregistration方法将在每次从类别注销或注册表完成时被调用。
    
    参数
    
    providers - 一个包含要注册的服务提供商对象的迭代器。
    
    异常
    
    IllegalArgumentException - 如果 providers是 null或包含一个 null条目。
  - deregisterServiceProvider
```
public <T> boolean deregisterServiceProvider(T provider,
                                             类<T> category)
```
    从给定的类别中删除服务提供者对象。如果提供商以前没有注册，则不会发生任何反应，并返回false 。否则返回true 。如果与provider相同但不相等（使用== ）至provider被注册，则不会被注销。
    如果provider实现了RegisterableService接口，则会调用其onDeregistration方法。
    
    参数类型
    
    T - 提供者的类型。
    
    参数
    
    provider - 要注销的服务提供商对象。
    
    category - 从中注销提供者的类别。
    
    结果
    
    true如果提供商以前注册在同一类别类别中， false false。
    
    异常
    
    IllegalArgumentException - 如果 provider是 null 。
    
    IllegalArgumentException - 如果没有类别对应 category 。
    
    ClassCastException - 如果提供程序不实现由 category定义的类。
  - deregisterServiceProvider
```
public void deregisterServiceProvider(Object provider)
```
    从包含它的所有类别中删除服务提供商对象。
    
    参数
    
    provider - 要注销的服务提供商对象。
    
    异常
    
    IllegalArgumentException - 如果 provider是 null 。
  - contains
```
public boolean contains(Object provider)
```
    返回 true如果 provider当前注册。
    
    参数
    
    provider - 要查询的服务提供商对象。
    
    结果
    
    true如果给定的提供者已经注册。
    
    异常
    
    IllegalArgumentException - 如果 provider是 null 。
  - getServiceProviders
```
public <T> Iterator<T> getServiceProviders(类<T> category,
                                           boolean useOrdering)
```
    返回一个Iterator包含给定类别中所有已注册的服务商。如果useOrdering为false ，则迭代器将以任意顺序返回所有服务器提供程序对象。否则，订单将尊重已设置的任何成对订单。如果成对订单的图形包含循环，则不会返回属于循环的任何提供程序。
    
    参数类型
    
    T - 类别的类型。
    
    参数
    
    category - category的类别。
    
    useOrdering - true如果在订购返回的对象时应考虑成对订购。
    
    结果
    
    一个 Iterator来自给定类别的服务提供者对象的 Iterator ，可能是有序的。
    
    异常
    
    IllegalArgumentException - 如果没有类别对应 category 。
  - getServiceProviders
```
public <T> Iterator<T> getServiceProviders(类<T> category,
                                           ServiceRegistry.Filter filter,
                                           boolean useOrdering)
```
    返回Iterator一个给定类别中满足由所提供的定义的条件的含服务提供程序对象ServiceRegistry.Filter对象的filter方法。
    useOrdering参数使用与getServiceProviders(Class, boolean)相同的规则来控制结果的排序。
    
    参数类型
    
    T - 类别的类型。
    
    参数
    
    category - category的类别。
    
    filter - 将调用其 filter方法的 ServiceRegistry.Filter的实例。
    
    useOrdering - true如果在订购返回的对象时应考虑成对订购。
    
    结果
    
    一个 Iterator给定类别的服务提供者对象的 Iterator ，可能是顺序的。
    
    异常
    
    IllegalArgumentException - 如果没有类别对应 category 。
  - getServiceProviderByClass
```
public <T> T getServiceProviderByClass(类<T> providerClass)
```
    返回给定类类型的当前注册的服务提供者对象。给定类别的最多一个对象允许在任何给定时间被注册。如果没有注册对象具有所需的类类型，则返回null 。
    
    参数类型
    
    T - 提供者的类型。
    
    参数
    
    providerClass - 所需服务提供商对象的 类 。
    
    结果
    
    目前已注册的服务提供者对象具有所需的 类类型，或者是 null是不存在的。
    
    异常
    
    IllegalArgumentException - 如果 providerClass是 null 。
  - setOrdering
```
public <T> boolean setOrdering(类<T> category,
                               T firstProvider,
                               T secondProvider)
```
    在给定类别中的两个服务提供者对象之间设置成对排序。如果一个或两个对象当前未在给定类别中注册，或者如果所需的顺序已经设置，则不会发生任何反应，并返回false 。如果提供商之前已经按相反的方向进行订购，那么该订单将被删除。
    当他们的useOrdering参数为true时， getServiceProviders方法将使用排序。
    
    参数类型
    
    T - 类别的类型。
    
    参数
    
    category - 一个 类对象，指示要建立偏好的类别。
    
    firstProvider - 首选提供商。
    
    secondProvider -提供到 firstProvider是优选的。
    
    结果
    
    true如果先前未设定的顺序建立。
    
    异常
    
    IllegalArgumentException - 如果任一提供者是 null或它们是相同的对象。
    
    IllegalArgumentException - 如果没有类别对应 category 。
  - unsetOrdering
```
public <T> boolean unsetOrdering(类<T> category,
                                 T firstProvider,
                                 T secondProvider)
```
    在给定类别中的两个服务提供者对象之间设置成对排序。如果一个或两个对象当前没有在给定类别中注册，或者如果它们之间没有设置任何顺序，则不会发生任何反应，并返回false 。
    当他们的useOrdering参数为true时， getServiceProviders方法将使用排序。
    
    参数类型
    
    T - 类别的类型。
    
    参数
    
    category - 一个 类对象，指示优先级将被拆除的类别。
    
    firstProvider - 以前的首选提供商。
    
    secondProvider -提供到 firstProvider以前优选的。
    
    结果
    
    true如果先前设定的订单已经解散。
    
    异常
    
    IllegalArgumentException - 如果任一提供者是 null或它们是相同的对象。
    
    IllegalArgumentException - 如果没有类别对应 category 。
  - deregisterAll
```
public void deregisterAll(类<?> category)
```
    取消注册目前在给定类别下注册的所有服务提供商对象。
    
    参数
    
    category - 要清空的类别。
    
    异常
    
    IllegalArgumentException - 如果没有类别对应 category 。
  - deregisterAll
```
public void deregisterAll()
```
    取消注册所有类别的所有当前注册服务提供商。
  - finalize
```
public void finalize()
              throws Throwable
```
    在垃圾收集之前完成此对象。 deregisterAll方法被要求取消注册所有当前注册的服务提供商。不应该从应用程序代码调用此方法。
    
    重写：
    
    finalize在 Object
    
    异常
    
    Throwable - 如果超类最终化期间发生错误。
    
    另请参见：
    
    WeakReference, PhantomReference

Class ServiceRegistry

Nested Class Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

ServiceRegistry

方法详细信息

lookupProviders

lookupProviders

getCategories

registerServiceProvider

registerServiceProvider

registerServiceProviders

deregisterServiceProvider

deregisterServiceProvider

contains

getServiceProviders

getServiceProviders

getServiceProviderByClass

setOrdering

unsetOrdering

deregisterAll

deregisterAll

finalize