- java.lang.Object
-
- javax.imageio.spi.ServiceRegistry
-
- javax.imageio.spi.IIORegistry
-
public final class IIORegistry extends ServiceRegistry
A registry for service provider instances. Service provider classes may be detected at run time by means of meta-information in the JAR files containing them. The intent is that it be relatively inexpensive to load and inspect all available service provider classes. These classes may them be used to locate and instantiate more heavyweight classes that will perform actual work, in this case instances ofImageReader
,ImageWriter
,ImageTranscoder
,ImageInputStream
, andImageOutputStream
.Service providers found on the system classpath (e.g., the
jre/lib/ext
directory in Sun's implementation of JDK) are automatically loaded as soon as this class is instantiated.When the
registerApplicationClasspathSpis
method is called, service provider instances declared in the meta-information section of JAR files on the application class path are loaded. To declare a service provider, aservices
subdirectory is placed within theMETA-INF
directory that is present in every JAR file. This directory contains a file for each service provider interface that has one or more implementation classes present in the JAR file. For example, if the JAR file contained a class namedcom.mycompany.imageio.MyFormatReaderSpi
which implements theImageReaderSpi
interface, the JAR file would contain a file named:META-INF/services/javax.imageio.spi.ImageReaderSpi
containing the line:com.mycompany.imageio.MyFormatReaderSpi
The service provider classes are intended to be lightweight and quick to load. Implementations of these interfaces should avoid complex dependencies on other classes and on native code.
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 more details on declaring service providers, and the JAR format in general, see the JAR File Specification.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class javax.imageio.spi.ServiceRegistry
ServiceRegistry.Filter
-
-
Method Summary
Methods Modifier and Type Method and Description static IIORegistry
getDefaultInstance()
Returns the defaultIIORegistry
instance used by the Image I/O API.void
registerApplicationClasspathSpis()
Registers all available service providers found on the application class path, using the defaultClassLoader
.-
Methods inherited from class javax.imageio.spi.ServiceRegistry
contains, deregisterAll, deregisterAll, deregisterServiceProvider, deregisterServiceProvider, finalize, getCategories, getServiceProviderByClass, getServiceProviders, getServiceProviders, lookupProviders, lookupProviders, registerServiceProvider, registerServiceProvider, registerServiceProviders, setOrdering, unsetOrdering
-
-
-
-
Method Detail
-
getDefaultInstance
public static IIORegistry getDefaultInstance()
Returns the defaultIIORegistry
instance used by the Image I/O API. This instance should be used for all registry functions.Each
ThreadGroup
will receive its own instance; this allows differentApplet
s in the same browser (for example) to each have their own registry.- Returns:
- the default registry for the current
ThreadGroup
.
-
registerApplicationClasspathSpis
public void registerApplicationClasspathSpis()
Registers all available service providers found on the application class path, using the defaultClassLoader
. This method is typically invoked by theImageIO.scanForPlugins
method.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/imageio/spi/IIORegistry.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.