Package com.itextpdf.io.source
Class FileChannelRandomAccessSource
java.lang.Object
com.itextpdf.io.source.FileChannelRandomAccessSource
- All Implemented Interfaces:
-
IRandomAccessSource
A RandomAccessSource that is based on an underlying
FileChannel
. The entire channel will be mapped into memory for efficient reads.
-
Constructor Summary
ConstructorDescriptionFileChannelRandomAccessSource
(FileChannel channel) Constructs a newFileChannelRandomAccessSource
based on the specified FileChannel. -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Closes this source.int
get
(long position) Gets a byte at the specified positionint
get
(long position, byte[] bytes, int off, int len) Read an array of bytes of specified length from the specified position of source to the buffer applying the offset.long
length()
Gets the length of the source
-
Constructor Details
-
FileChannelRandomAccessSource
Constructs a newFileChannelRandomAccessSource
based on the specified FileChannel. The entire source channel will be mapped into memory.- Parameters:
-
channel
- the channel to use as the backing store - Throws:
-
IOException
- if the channel cannot be opened or mapped
-
-
Method Details
-
close
Closes this source. The underlying data structure or source (if any) will also be closed Cleans the mapped byte buffers and closes the channel- Specified by:
-
close
in interfaceIRandomAccessSource
- Throws:
-
IOException
- in case of any reading error.
-
get
Gets a byte at the specified position- Specified by:
-
get
in interfaceIRandomAccessSource
- Parameters:
-
position
- byte position - Returns:
- the byte, or -1 if EOF is reached
- Throws:
-
IOException
- in case of any reading error.
-
get
Read an array of bytes of specified length from the specified position of source to the buffer applying the offset. If the number of bytes requested cannot be read, all the possible bytes will be read to the buffer, and the number of actually read bytes will be returned.- Specified by:
-
get
in interfaceIRandomAccessSource
- Parameters:
-
position
- the position in the RandomAccessSource to read from -
bytes
- output buffer -
off
- offset into the output buffer where results will be placed -
len
- the number of bytes to read - Returns:
- the number of bytes actually read, or -1 if the file is at EOF
- Throws:
-
IOException
- in case of any I/O error.
-
length
public long length()Gets the length of the source- Specified by:
-
length
in interfaceIRandomAccessSource
- Returns:
- the length of this source
-