Class HttpSeekableByteChannel

java.lang.Object

org.broadinstitute.http.nio.HttpSeekableByteChannel

All Implemented Interfaces:

Closeable, AutoCloseable, ByteChannel, Channel, ReadableByteChannel, SeekableByteChannel, WritableByteChannel

public class HttpSeekableByteChannel
extends Object
implements SeekableByteChannel

Implementation for a SeekableByteChannel for URL open as a connection.

The current implementation is thread-safe using the synchronized keyword in every method.

Author:

Daniel Gomez-Sanchez (magicDGS)

Constructor Summary

Constructors

Constructor	Description
HttpSeekableByteChannel(URI uri)	create a new seekable channel with default setttings at beggining of the file
HttpSeekableByteChannel(URI uri, long position)	Create a new seekable channel with default setttins and seek to the given position
HttpSeekableByteChannel(URI uri, HttpFileSystemProviderSettings settings, long position)	Create a new seekable channel which reads from the requested URI

Method Summary

Modifier and Type	Method	Description
void	close()
boolean	isOpen()
long	position()
HttpSeekableByteChannel	position(long newPosition)
int	read(ByteBuffer dst)
static int	readWithoutPerturbingTheBufferIfAnErrorOccurs(ByteBuffer dst, ReadableByteChannel channel)	Performs the equivalent of a channel.read(buf) operation but in the case of an exception the state of the input buffer is not adversely impacted.
long	size()
SeekableByteChannel	truncate(long size)
int	write(ByteBuffer src)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

HttpSeekableByteChannel

public HttpSeekableByteChannel(URI uri)
                        throws IOException

create a new seekable channel with default setttings at beggining of the file

Parameters:

uri - the URI to connect to, this should not include range parameters already

Throws:

IOException - if no connection can be established

HttpSeekableByteChannel

public HttpSeekableByteChannel(URI uri,
 long position)
                        throws IOException

Create a new seekable channel with default setttins and seek to the given position

Parameters:

uri - the URI to connect to, this should not include range parameters already

position - an initial byte offset to open the file at

Throws:

IOException - if no connection can be established

HttpSeekableByteChannel

public HttpSeekableByteChannel(URI uri,
 HttpFileSystemProviderSettings settings,
 long position)
                        throws IOException

Create a new seekable channel which reads from the requested URI

Parameters:

uri - the URI to connect to, this should not include range parameters already

settings - settings to configure the connection and retry handling

position - an initial byte offset to open the file at

Throws:

IOException - if no connection can be established

Method Details

read

public int read(ByteBuffer dst)
         throws IOException

Specified by:

read in interface ReadableByteChannel

Specified by:

read in interface SeekableByteChannel

Throws:

IOException

readWithoutPerturbingTheBufferIfAnErrorOccurs

public static int readWithoutPerturbingTheBufferIfAnErrorOccurs(ByteBuffer dst,
 ReadableByteChannel channel)
                                                         throws IOException

Performs the equivalent of a channel.read(buf) operation but in the case of an exception the state of the input buffer is not adversely impacted.

Parameters:

dst - a ByteBuffer to read into

channel - the channel to reaad from

Returns:

the number of bytes read from the channel

Throws:

IOException - if the read operation throws

write

public int write(ByteBuffer src)

Specified by:

write in interface SeekableByteChannel

Specified by:

write in interface WritableByteChannel

position

public long position()
              throws IOException

Specified by:

position in interface SeekableByteChannel

Throws:

IOException

position

public HttpSeekableByteChannel position(long newPosition)
                                 throws IOException

Specified by:

position in interface SeekableByteChannel

Throws:

IOException

size

public long size()
          throws IOException

Specified by:

size in interface SeekableByteChannel

Throws:

IOException

truncate

public SeekableByteChannel truncate(long size)

Specified by:

truncate in interface SeekableByteChannel

isOpen

public boolean isOpen()

Specified by:

isOpen in interface Channel

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Channel

Specified by:

close in interface Closeable

Throws:

IOException