org.apache.commons.compress.utils

Class MultiReadOnlySeekableByteChannel

java.lang.Object

org.apache.commons.compress.utils.MultiReadOnlySeekableByteChannel

All Implemented Interfaces:

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

public class MultiReadOnlySeekableByteChannel
extends Object
implements SeekableByteChannel

Read-Only Implementation of SeekableByteChannel that concatenates a collection of other SeekableByteChannels.

This is a lose port of MultiReadOnlySeekableByteChannel by Tim Underwood.

Since:

1.19

Constructor Summary

Constructors

Constructor and Description
MultiReadOnlySeekableByteChannel(List<SeekableByteChannel> channels) Concatenates the given channels.

Method Summary

Modifier and Type	Method and Description
void	close()
static SeekableByteChannel	forFiles(File... files) Concatenates the given files.
static SeekableByteChannel	forSeekableByteChannels(SeekableByteChannel... channels) Concatenates the given channels.
boolean	isOpen()
long	position()
SeekableByteChannel	position(long newPosition)
int	read(ByteBuffer dst)
long	size()
SeekableByteChannel	truncate(long size)
int	write(ByteBuffer src)

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiReadOnlySeekableByteChannel

public MultiReadOnlySeekableByteChannel(List<SeekableByteChannel> channels)

Concatenates the given channels.

Parameters:

channels - the channels to concatenate

Throws:

NullPointerException - if channels is null

Method Detail

read

public int read(ByteBuffer dst)
         throws IOException

Specified by:

read in interface ReadableByteChannel

Specified by:

read in interface SeekableByteChannel

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Channel

Throws:

IOException

isOpen

public boolean isOpen()

Specified by:

isOpen in interface Channel

position

public long position()

Specified by:

position in interface SeekableByteChannel

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

Throws:

NonWritableChannelException - since this implementation is read-only.

write

public int write(ByteBuffer src)

Specified by:

write in interface SeekableByteChannel

Specified by:

write in interface WritableByteChannel

Throws:

NonWritableChannelException - since this implementation is read-only.

position

public SeekableByteChannel position(long newPosition)
                             throws IOException

Specified by:

position in interface SeekableByteChannel

Throws:

IOException

forSeekableByteChannels

public static SeekableByteChannel forSeekableByteChannels(SeekableByteChannel... channels)

Concatenates the given channels.

Parameters:

channels - the channels to concatenate

Returns:

SeekableByteChannel that concatenates all provided channels

Throws:

NullPointerException - if channels is null

forFiles

public static SeekableByteChannel forFiles(File... files)
                                    throws IOException

Concatenates the given files.

Parameters:

files - the files to concatenate

Returns:

SeekableByteChannel that concatenates all provided files

Throws:

NullPointerException - if files is null

IOException - if opening a channel for one of the files fails