OpenJDK 27 · javax.imageio.spi.IIORegistry · APIdia, the JavaDoc alternative

A registry for Image I/O service provider instances. Service provider classes may be discovered at runtime by the mechanisms documented in ServiceLoader. The intent is that it be relatively inexpensive to load and inspect all available Image I/O service provider classes. These classes may then be used to locate and instantiate more heavyweight classes that will perform actual work, in this case instances of ImageReader, ImageWriter, ImageTranscoder, ImageInputStream, and ImageOutputStream. Service providers included in the Java runtime are automatically loaded as soon as this class is instantiated.

When the registerApplicationClasspathSpis method is called, additional service provider instances will be discovered using ServiceLoader.

It is also possible to manually add service providers not found automatically, as well as to remove those that are using the interfaces of the ServiceRegistry class. Thus the application may customize the contents of the registry as it sees fit.

For information on how to create and deploy service providers, refer to the documentation on ServiceLoader

Field Summary

Modifier and Type	Field and Description
private static final List<Class<?>>	initialCategories A `List` containing the valid IIO registry categories (superinterfaces) to be used in the constructor.
private static final IIORegistry	registry

Access	Constructor and Description
private	IIORegistry() Set up the valid service provider categories and automatically register all available service providers.

Access

Constructor and Description

private

IIORegistry()

Set up the valid service provider categories and automatically register all available service providers.

Modifier and Type	Method and Description
public static IIORegistry	Returns: the default registry for the Image I/O API getDefaultInstance() Returns the default `IIORegistry` instance used by the Image I/O API.
public void	registerApplicationClasspathSpis() Registers all available service providers found on the application class path, using the default `ClassLoader`.
private void	registerInstalledProviders()
private void	registerStandardSpis()

Modifier and Type

Method and Description

public static IIORegistry

Returns:

the default registry for the Image I/O API

getDefaultInstance()

Returns the default IIORegistry instance used by the Image I/O API.

public void

registerApplicationClasspathSpis()

Registers all available service providers found on the application class path, using the default ClassLoader.

private void

registerInstalledProviders()

private void

registerStandardSpis()

initialCategories	back to summary
private static final List<Class<?>> initialCategories A `List` containing the valid IIO registry categories (superinterfaces) to be used in the constructor.

initialCategories

back to summary

private static final List<Class<?>> initialCategories

A List containing the valid IIO registry categories (superinterfaces) to be used in the constructor.

registry	back to summary
private static final IIORegistry registry

registry

back to summary

private static final IIORegistry registry

IIORegistry	back to summary
private IIORegistry() Set up the valid service provider categories and automatically register all available service providers. The constructor is private in order to prevent creation of additional instances.

IIORegistry

back to summary

private IIORegistry()

Set up the valid service provider categories and automatically register all available service providers.

The constructor is private in order to prevent creation of additional instances.

Method Detail

getDefaultInstance back to summary

getDefaultInstance	back to summary
public static IIORegistry getDefaultInstance() Returns the default `IIORegistry` instance used by the Image I/O API. This instance should be used for all registry functions. Returns:IIORegistry the default registry for the Image I/O API

public static IIORegistry getDefaultInstance()

Returns the default IIORegistry instance used by the Image I/O API. This instance should be used for all registry functions.

Returns:IIORegistry: the default registry for the Image I/O API

registerApplicationClasspathSpis back to summary

registerApplicationClasspathSpis	back to summary
public void registerApplicationClasspathSpis() Registers all available service providers found on the application class path, using the default `ClassLoader`. This method is typically invoked by the `ImageIO.scanForPlugins` method. See Also `javax.imageio.ImageIO#scanForPlugins`, `ClassLoader#getResources`

public void registerApplicationClasspathSpis()

Registers all available service providers found on the application class path, using the default ClassLoader. This method is typically invoked by the ImageIO.scanForPlugins method.

See Also: javax.imageio.ImageIO#scanForPlugins, ClassLoader#getResources

registerInstalledProviders	back to summary
private void registerInstalledProviders()

registerStandardSpis	back to summary
private void registerStandardSpis()

public final Class IIORegistry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail