com.asakusafw.runtime.io.util

Class DataBuffer

java.lang.Object

com.asakusafw.runtime.io.util.DataBuffer

All Implemented Interfaces:

DataInput, DataOutput

public class DataBuffer
extends Object
implements DataInput, DataOutput

A data buffer with DataInput and DataOutput interfaces.

Since:

0.7.0

Version:

0.7.1

Constructor Summary

Constructors

Constructor and Description
DataBuffer() Creates a new instance with empty buffer.
DataBuffer(int initialCapacity) Creates a new instance with empty buffer.
DataBuffer(int initialCapacity, double expansionFactor) Creates a new instance with empty buffer.

Method Summary

Modifier and Type	Method and Description
void	ensureCapacity(int newSize) Ensures capacity of this buffer.
byte[]	getData() Returns the data bytes.
int	getReadLimit() Returns the reading limit position in this buffer.
int	getReadPosition() Returns the reading position in this buffer.
int	getReadRemaining() Returns the data length in this buffer.
int	getWritePosition() Returns the next write position in this buffer.
int	read() Reads a byte value.
boolean	readBoolean()
byte	readByte()
char	readChar()
double	readDouble()
float	readFloat()
void	readFully(byte[] b)
void	readFully(byte[] b, int off, int len)
int	readInt()
String	readLine()
long	readLong()
short	readShort()
int	readUnsignedByte()
int	readUnsignedShort()
String	readUTF()
void	reset(byte[] bytes, int offset, int length) Resets data in this buffer.
void	reset(int offset, int length) Resets cursors in this buffer.
int	skipBytes(int n)
String	toString()
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(DataInput in, int len) Writes data from DataInput.
void	write(int b)
void	writeBoolean(boolean v)
void	writeByte(int v)
void	writeBytes(String s)
void	writeChar(int v)
void	writeChars(String s)
void	writeDouble(double v)
void	writeFloat(float v)
void	writeInt(int v)
void	writeLong(long v)
void	writeShort(int v)
void	writeUTF(String s)

Methods inherited from class java.lang.Object

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

Constructor Detail

DataBuffer

public DataBuffer()

Creates a new instance with empty buffer.

DataBuffer

public DataBuffer(int initialCapacity)

Creates a new instance with empty buffer.

Parameters:

initialCapacity - the initial buffer capacity in bytes

DataBuffer

public DataBuffer(int initialCapacity,
                  double expansionFactor)

Creates a new instance with empty buffer.

Parameters:

initialCapacity - the initial buffer capacity in bytes

expansionFactor - the buffer expansion factor

Since:

0.7.1

Method Detail

reset

public void reset(byte[] bytes,
                  int offset,
                  int length)

Resets data in this buffer.

Parameters:

bytes - the data

offset - the offset in bytes

length - the length in bytes

reset

public void reset(int offset,
                  int length)

Resets cursors in this buffer.

Parameters:

offset - the offset in bytes

length - the length in bytes

getData

public byte[] getData()

Returns the data bytes.

Returns:

the data bytes

See Also:

getReadPosition(), getReadRemaining()

getReadPosition

public int getReadPosition()

Returns the reading position in this buffer.

Returns:

the reading position in bytes

getReadLimit

public int getReadLimit()

Returns the reading limit position in this buffer.

Returns:

the reading limit position in bytes

getWritePosition

public int getWritePosition()

Returns the next write position in this buffer.

Returns:

the next write position in bytes

getReadRemaining

public int getReadRemaining()

Returns the data length in this buffer.

Returns:

the data length in bytes

ensureCapacity

public void ensureCapacity(int newSize)

Ensures capacity of this buffer.

Parameters:

newSize - the required capacity in bytes

read

public int read()
         throws IOException

Reads a byte value.

Returns:

an unsigned byte value, or -1 to no remained values

Throws:

IOException - if failed to read a value

readBoolean

public boolean readBoolean()
                    throws IOException

Specified by:

readBoolean in interface DataInput

Throws:

IOException

readByte

public byte readByte()
              throws IOException

Specified by:

readByte in interface DataInput

Throws:

IOException

readUnsignedByte

public int readUnsignedByte()
                     throws IOException

Specified by:

readUnsignedByte in interface DataInput

Throws:

IOException

readShort

public short readShort()
                throws IOException

Specified by:

readShort in interface DataInput

Throws:

IOException

readUnsignedShort

public int readUnsignedShort()
                      throws IOException

Specified by:

readUnsignedShort in interface DataInput

Throws:

IOException

readChar

public char readChar()
              throws IOException

Specified by:

readChar in interface DataInput

Throws:

IOException

readInt

public int readInt()
            throws IOException

Specified by:

readInt in interface DataInput

Throws:

IOException

readLong

public long readLong()
              throws IOException

Specified by:

readLong in interface DataInput

Throws:

IOException

readFloat

public float readFloat()
                throws IOException

Specified by:

readFloat in interface DataInput

Throws:

IOException

readDouble

public double readDouble()
                  throws IOException

Specified by:

readDouble in interface DataInput

Throws:

IOException

readFully

public void readFully(byte[] b)
               throws IOException

Specified by:

readFully in interface DataInput

Throws:

IOException

readFully

public void readFully(byte[] b,
                      int off,
                      int len)
               throws IOException

Specified by:

readFully in interface DataInput

Throws:

IOException

skipBytes

public int skipBytes(int n)
              throws IOException

Specified by:

skipBytes in interface DataInput

Throws:

IOException

readLine

public String readLine()
                throws IOException

Specified by:

readLine in interface DataInput

Throws:

IOException

readUTF

public String readUTF()
               throws IOException

Specified by:

readUTF in interface DataInput

Throws:

IOException

write

public void write(int b)
           throws IOException

Specified by:

write in interface DataOutput

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Specified by:

write in interface DataOutput

Throws:

IOException

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Specified by:

write in interface DataOutput

Throws:

IOException

writeBoolean

public void writeBoolean(boolean v)
                  throws IOException

Specified by:

writeBoolean in interface DataOutput

Throws:

IOException

writeByte

public void writeByte(int v)
               throws IOException

Specified by:

writeByte in interface DataOutput

Throws:

IOException

writeShort

public void writeShort(int v)
                throws IOException

Specified by:

writeShort in interface DataOutput

Throws:

IOException

writeChar

public void writeChar(int v)
               throws IOException

Specified by:

writeChar in interface DataOutput

Throws:

IOException

writeInt

public void writeInt(int v)
              throws IOException

Specified by:

writeInt in interface DataOutput

Throws:

IOException

writeLong

public void writeLong(long v)
               throws IOException

Specified by:

writeLong in interface DataOutput

Throws:

IOException

writeFloat

public void writeFloat(float v)
                throws IOException

Specified by:

writeFloat in interface DataOutput

Throws:

IOException

writeDouble

public void writeDouble(double v)
                 throws IOException

Specified by:

writeDouble in interface DataOutput

Throws:

IOException

writeBytes

public void writeBytes(String s)
                throws IOException

Specified by:

writeBytes in interface DataOutput

Throws:

IOException

writeChars

public void writeChars(String s)
                throws IOException

Specified by:

writeChars in interface DataOutput

Throws:

IOException

writeUTF

public void writeUTF(String s)
              throws IOException

Specified by:

writeUTF in interface DataOutput

Throws:

IOException

write

public void write(DataInput in,
                  int len)
           throws IOException

Writes data from DataInput.

Parameters:

in - the source input

len - data size in bytes

Throws:

IOException - if failed to read DataInput

toString

public String toString()

Overrides:

toString in class Object