当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

IIORegistry (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.imageio.spi
类 IIORegistry

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

---

public final class IIORegistry
extends ServiceRegistry

用于服务提供程序实例的注册表。使用包含服务提供程序类的 JAR 文件中的元信息可在运行时检测服务提供程序。这是一种相对划算的加载和检查所有可用的服务提供程序类的方式。然后可使用这些类定位和实例化更具重量级的将执行实际工作的类，这里指 ImageReader、ImageWriter、ImageTranscoder、ImageInputStream 和 ImageOutputStream 的实例。

在系统类路径（例如，Sun 的 JDK 实现中的 jre/lib/ext 目录）中找到的服务提供程序在此类实例化后即自动加载。

调用 registerApplicationClasspathSpis 方法时，在应用程序类路径中的 JAR 文件的元信息部分声明的服务提供程序实例将被加载。为声明服务提供程序，在每个 JAR 文件都有的 META-INF 目录中加入一个 services 子目录。此目录针对每个在 JAR 文件中具有一个或多个实现类的服务提供程序接口都包含一个文件。例如，假设 JAR 文件包含了一个名为 com.mycompany.imageio.MyFormatReaderSpi 的类，它实现 ImageReaderSpi 接口，则此 JAR 文件将包含一个名称如下所示的文件：

 META-INF/services/javax.imageio.spi.ImageReaderSpi
 

包含行：

 com.mycompany.imageio.MyFormatReaderSpi
 

服务提供程序类为轻量级的，可快速加载。这些接口的实现应避免复杂化其他类和本地代码的依赖性。

还可以手动添加无法自动找到的服务提供程序，也可以手动移除那些使用 ServiceRegistry 类的接口的服务提供程序。因此，应用程序可根据需要自定义注册表的内容。

有关声明服务提供程序和通用 JAR 格式的更详细的信息，请参见 JAR File Specification。

---

嵌套类摘要

 

从类 javax.imageio.spi.ServiceRegistry 继承的嵌套类/接口
ServiceRegistry.Filter

 

方法摘要
static IIORegistry	getDefaultInstance()           返回 Image I/O API 使用的默认 IIORegistry 实例。
void	registerApplicationClasspathSpis()           使用默认的 ClassLoader 注册应用程序类路径中找到的所有可用的服务提供程序。

 

从类 javax.imageio.spi.ServiceRegistry 继承的方法
contains, deregisterAll, deregisterAll, deregisterServiceProvider, deregisterServiceProvider, finalize, getCategories, getServiceProviderByClass, getServiceProviders, getServiceProviders, lookupProviders, lookupProviders, registerServiceProvider, registerServiceProvider, registerServiceProviders, setOrdering, unsetOrdering

 

从类 java.lang.Object 继承的方法
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

方法详细信息

getDefaultInstance

public static IIORegistry getDefaultInstance()

返回 Image I/O API 使用的默认 IIORegistry 实例。此实例应该用于所有注册表功能。

每个 ThreadGroup 将收到其自身的实例；这样同一个浏览器（举例）中的每个不同的 Applet 都将有其自己的注册表。

返回：

当前 ThreadGroup 的默认注册表。

---

registerApplicationClasspathSpis

public void registerApplicationClasspathSpis()

使用默认的 ClassLoader 注册应用程序类路径中找到的所有可用的服务提供程序。此方法通常由 ImageIO.scanForPlugins 方法调用。

另请参见：

ImageIO.scanForPlugins(), ClassLoader.getResources(java.lang.String)

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。