Package com.sun.media.imageio.stream
Class FileChannelImageInputStream
- java.lang.Object
-
- javax.imageio.stream.ImageInputStreamImpl
-
- com.sun.media.imageio.stream.FileChannelImageInputStream
-
- All Implemented Interfaces:
Closeable
,DataInput
,AutoCloseable
,ImageInputStream
public class FileChannelImageInputStream extends ImageInputStreamImpl
A class which implementsImageInputStream
using aFileChannel
as the eventual data source. The channel contents are assumed to be stable during the lifetime of the object.Memory mapping and new I/O view
Buffer
s are used to read the data. Only methods which provide significant performance improvement with respect to the superclass implementation are overridden. Overridden methods are not commented individually unless some noteworthy aspect of the implementation must be described.The methods of this class are not synchronized.
- See Also:
ImageInputStream
,java.nio
,FileChannel
-
-
Field Summary
-
Fields inherited from class javax.imageio.stream.ImageInputStreamImpl
bitOffset, byteOrder, flushedPos, streamPos
-
-
Constructor Summary
Constructors Constructor Description FileChannelImageInputStream(FileChannel channel)
Constructs aFileChannelImageInputStream
from aFileChannel
.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
close()
Invokes the superclass method and sets the internal reference to the sourceFileChannel
tonull
.long
length()
Returns the number of bytes currently in theFileChannel
.int
read()
int
read(byte[] b, int off, int len)
void
readFully(char[] c, int off, int len)
void
readFully(double[] d, int off, int len)
void
readFully(float[] f, int off, int len)
void
readFully(int[] i, int off, int len)
void
readFully(long[] l, int off, int len)
void
readFully(short[] s, int off, int len)
void
seek(long pos)
Invokes the superclass method and sets the position within the memory mapped buffer.void
setByteOrder(ByteOrder networkByteOrder)
-
Methods inherited from class javax.imageio.stream.ImageInputStreamImpl
checkClosed, finalize, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, skipBytes, skipBytes
-
-
-
-
Constructor Detail
-
FileChannelImageInputStream
public FileChannelImageInputStream(FileChannel channel) throws IOException
Constructs aFileChannelImageInputStream
from aFileChannel
. The initial position of the stream stream is taken to be the position of theFileChannel
parameter when this constructor is invoked. The stream and flushed positions are therefore both initialized tochannel.position()
.- Parameters:
channel
- the sourceFileChannel
.- Throws:
IllegalArgumentException
- ifchannel
isnull
or is not open.IOException
- if a method invoked onchannel
throws anIOException
.
-
-
Method Detail
-
read
public int read() throws IOException
- Specified by:
read
in interfaceImageInputStream
- Specified by:
read
in classImageInputStreamImpl
- Throws:
IOException
-
read
public int read(byte[] b, int off, int len) throws IOException
- Specified by:
read
in interfaceImageInputStream
- Specified by:
read
in classImageInputStreamImpl
- Throws:
IOException
-
close
public void close() throws IOException
Invokes the superclass method and sets the internal reference to the sourceFileChannel
tonull
. The sourceFileChannel
is not closed.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceImageInputStream
- Overrides:
close
in classImageInputStreamImpl
- Throws:
IOException
- if an error occurs.
-
readFully
public void readFully(char[] c, int off, int len) throws IOException
- Specified by:
readFully
in interfaceImageInputStream
- Overrides:
readFully
in classImageInputStreamImpl
- Throws:
IOException
-
readFully
public void readFully(short[] s, int off, int len) throws IOException
- Specified by:
readFully
in interfaceImageInputStream
- Overrides:
readFully
in classImageInputStreamImpl
- Throws:
IOException
-
readFully
public void readFully(int[] i, int off, int len) throws IOException
- Specified by:
readFully
in interfaceImageInputStream
- Overrides:
readFully
in classImageInputStreamImpl
- Throws:
IOException
-
readFully
public void readFully(long[] l, int off, int len) throws IOException
- Specified by:
readFully
in interfaceImageInputStream
- Overrides:
readFully
in classImageInputStreamImpl
- Throws:
IOException
-
readFully
public void readFully(float[] f, int off, int len) throws IOException
- Specified by:
readFully
in interfaceImageInputStream
- Overrides:
readFully
in classImageInputStreamImpl
- Throws:
IOException
-
readFully
public void readFully(double[] d, int off, int len) throws IOException
- Specified by:
readFully
in interfaceImageInputStream
- Overrides:
readFully
in classImageInputStreamImpl
- Throws:
IOException
-
length
public long length()
Returns the number of bytes currently in theFileChannel
. If anIOException
is encountered when querying the channel's size, -1L will be returned.- Specified by:
length
in interfaceImageInputStream
- Overrides:
length
in classImageInputStreamImpl
- Returns:
- The number of bytes in the channel -1L to indicate unknown length.
-
seek
public void seek(long pos) throws IOException
Invokes the superclass method and sets the position within the memory mapped buffer. A new region is mapped if necessary. The position of the sourceFileChannel
is not changed, i.e.,FileChannel.position(long)
is not invoked.- Specified by:
seek
in interfaceImageInputStream
- Overrides:
seek
in classImageInputStreamImpl
- Throws:
IOException
-
setByteOrder
public void setByteOrder(ByteOrder networkByteOrder)
- Specified by:
setByteOrder
in interfaceImageInputStream
- Overrides:
setByteOrder
in classImageInputStreamImpl
-
-