loci.common

Class AbstractNIOHandle

java.lang.Object

loci.common.AbstractNIOHandle

All Implemented Interfaces:

DataInput, DataOutput, IRandomAccess

Direct Known Subclasses:

ByteArrayHandle, NIOFileHandle

public abstract class AbstractNIOHandle
extends Object
implements IRandomAccess

A wrapper for buffered NIO logic that implements the IRandomAccess interface.

Author:

Chris Allan

See Also:

IRandomAccess, RandomAccessFile

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	EOF_ERROR_MSG Error message to be used when instantiating an EOFException.

Constructor Summary

Constructors

Constructor and Description
AbstractNIOHandle()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	setLength(long length) Sets the new length of the handle.
protected boolean	validateLength(int writeLength) Ensures that the handle has the correct length to be written to and extends it as required.
protected void	validateMode(String mode) Ensures that the file mode is either "r" or "rw".

Methods inherited from class java.lang.Object

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

Methods inherited from interface loci.common.IRandomAccess

close, getFilePointer, getOrder, length, read, read, read, read, seek, setOrder, write, write

Methods inherited from interface java.io.DataInput

readBoolean, readByte, readChar, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedShort, readUTF, skipBytes

Methods inherited from interface java.io.DataOutput

write, write, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeDouble, writeFloat, writeInt, writeLong, writeShort, writeUTF

Field Detail

EOF_ERROR_MSG

protected static final String EOF_ERROR_MSG

Error message to be used when instantiating an EOFException.

See Also:

Constant Field Values

Constructor Detail

AbstractNIOHandle

public AbstractNIOHandle()

Method Detail

validateMode

protected void validateMode(String mode)

Ensures that the file mode is either "r" or "rw".

Parameters:

mode - Mode to validate.

Throws:

IllegalArgumentException - If an illegal mode is passed.

validateLength

protected boolean validateLength(int writeLength)
                          throws IOException

Ensures that the handle has the correct length to be written to and extends it as required.

Parameters:

writeLength - Number of bytes to write.

Returns:

true if the buffer has not required an extension. false otherwise.

Throws:

IOException - If there is an error changing the handle's length.

setLength

protected abstract void setLength(long length)
                           throws IOException

Sets the new length of the handle.

Parameters:

length - New length.

Throws:

IOException - If there is an error changing the handle's length.