- java.lang.Object
-
- javax.imageio.spi.IIOServiceProvider
-
- javax.imageio.spi.ImageInputStreamSpi
-
- All Implemented Interfaces:
- RegisterableService
public abstract class ImageInputStreamSpi extends IIOServiceProvider
The service provider interface (SPI) forImageInputStream
s. For more information on service provider interfaces, see the class comment for theIIORegistry
class.This interface allows arbitrary objects to be "wrapped" by instances of
ImageInputStream
. For example, a particularImageInputStreamSpi
might allow a genericInputStream
to be used as an input source; another might take input from aURL
.By treating the creation of
ImageInputStream
s as a pluggable service, it becomes possible to handle future input sources without changing the API. Also, high-performance implementations ofImageInputStream
(for example, native implementations for a particular platform) can be installed and used transparently by applications.- See Also:
IIORegistry
,ImageInputStream
-
-
Field Summary
Fields Modifier and Type Field and Description protected Class<?>
inputClass
AClass
object indicating the legal object type for use by thecreateInputStreamInstance
method.-
Fields inherited from class javax.imageio.spi.IIOServiceProvider
vendorName, version
-
-
Constructor Summary
Constructors Modifier Constructor and Description protected
ImageInputStreamSpi()
Constructs a blankImageInputStreamSpi
.ImageInputStreamSpi(String vendorName, String version, Class<?> inputClass)
Constructs anImageInputStreamSpi
with a given set of values.
-
Method Summary
Methods Modifier and Type Method and Description boolean
canUseCacheFile()
Returnstrue
if theImageInputStream
implementation associated with this service provider can optionally make use of a cache file for improved performance and/or memory footrprint.ImageInputStream
createInputStreamInstance(Object input)
Returns an instance of theImageInputStream
implementation associated with this service provider.abstract ImageInputStream
createInputStreamInstance(Object input, boolean useCache, File cacheDir)
Returns an instance of theImageInputStream
implementation associated with this service provider.Class<?>
getInputClass()
Returns aClass
object representing the class or interface type that must be implemented by an input source in order to be "wrapped" in anImageInputStream
via thecreateInputStreamInstance
method.boolean
needsCacheFile()
Returnstrue
if theImageInputStream
implementation associated with this service provider requires the use of a cacheFile
.-
Methods inherited from class javax.imageio.spi.IIOServiceProvider
getDescription, getVendorName, getVersion, onDeregistration, onRegistration
-
-
-
-
Field Detail
-
inputClass
protected Class<?> inputClass
AClass
object indicating the legal object type for use by thecreateInputStreamInstance
method.
-
-
Constructor Detail
-
ImageInputStreamSpi
protected ImageInputStreamSpi()
Constructs a blankImageInputStreamSpi
. It is up to the subclass to initialize instance variables and/or override method implementations in order to provide working versions of all methods.
-
ImageInputStreamSpi
public ImageInputStreamSpi(String vendorName, String version, Class<?> inputClass)
Constructs anImageInputStreamSpi
with a given set of values.- Parameters:
vendorName
- the vendor name.version
- a version identifier.inputClass
- aClass
object indicating the legal object type for use by thecreateInputStreamInstance
method.- Throws:
IllegalArgumentException
- ifvendorName
isnull
.IllegalArgumentException
- ifversion
isnull
.
-
-
Method Detail
-
getInputClass
public Class<?> getInputClass()
Returns aClass
object representing the class or interface type that must be implemented by an input source in order to be "wrapped" in anImageInputStream
via thecreateInputStreamInstance
method.Typical return values might include
InputStream.class
orURL.class
, but any class may be used.- Returns:
- a
Class
variable. - See Also:
createInputStreamInstance(Object, boolean, File)
-
canUseCacheFile
public boolean canUseCacheFile()
Returnstrue
if theImageInputStream
implementation associated with this service provider can optionally make use of a cache file for improved performance and/or memory footrprint. Iffalse
, the value of theuseCache
argument tocreateInputStreamInstance
will be ignored.The default implementation returns
false
.- Returns:
true
if a cache file can be used by the input streams created by this service provider.
-
needsCacheFile
public boolean needsCacheFile()
Returnstrue
if theImageInputStream
implementation associated with this service provider requires the use of a cacheFile
. Iftrue
, the value of theuseCache
argument tocreateInputStreamInstance
will be ignored.The default implementation returns
false
.- Returns:
true
if a cache file is needed by the input streams created by this service provider.
-
createInputStreamInstance
public abstract ImageInputStream createInputStreamInstance(Object input, boolean useCache, File cacheDir) throws IOException
Returns an instance of theImageInputStream
implementation associated with this service provider. If the use of a cache file is optional, theuseCache
parameter will be consulted. Where a cache is required, or not applicable, the value ofuseCache
will be ignored.- Parameters:
input
- an object of the class type returned bygetInputClass
.useCache
- aboolean
indicating whether a cache file should be used, in cases where it is optional.cacheDir
- aFile
indicating where the cache file should be created, ornull
to use the system directory.- Returns:
- an
ImageInputStream
instance. - Throws:
IllegalArgumentException
- ifinput
is not an instance of the correct class or isnull
.IllegalArgumentException
- if a cache file is needed butcacheDir
is non-null
and is not a directory.IOException
- if a cache file is needed but cannot be created.- See Also:
getInputClass()
,canUseCacheFile()
,needsCacheFile()
-
createInputStreamInstance
public ImageInputStream createInputStreamInstance(Object input) throws IOException
Returns an instance of theImageInputStream
implementation associated with this service provider. A cache file will be created in the system-dependent default temporary-file directory, if needed.- Parameters:
input
- an object of the class type returned bygetInputClass
.- Returns:
- an
ImageInputStream
instance. - Throws:
IllegalArgumentException
- ifinput
is not an instance of the correct class or isnull
.IOException
- if a cache file is needed but cannot be created.- See Also:
getInputClass()
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
24/11/2024 12:23:31 Cette version de la page est en cache (à la date du 24/11/2024 12:23:31) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/imageio/spi/imageinputstreamspi.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.