CONTENTS | PREV | NEXT |
IIOException
The Image I/O API makes use of its
own subclass of the standard IOException
class, called
IIOException
. IIOException
s are used to
signal all errors encountered during the parsing of a source file
(e.g., an incorrect checksum or an invalid value for a particular
byte within the file), including true I/O errors that result in an
IOException
being thrown within the reader.
An IIOException
contains a (non-localized) message describing the reason for the
exception, as well as a reference to another Exception
that was the cause of the IIOException
, if one
exists.
Thus, application code that attempts to provide graceful handling of errors will look something like:
File f = new File("c:\images\myimage.gif"); ImageInputStream iis = null; try { iis = ImageIO.createImageInputStream(f); } catch (IIOException iioe1) { System.out.println("Unable to create an input stream!"); return; } reader.setInput(stream); try { reader.read(0, param); } catch (IIOException iioe2) { System.out.println("An error occurred during reading: " + iioe2.getMessage()); Throwable t = iioe2.getCause(); if ((t != null) && (t instanceof IOException)) { System.out.println("Caused by IOException: " + t.getMessage()); } }