org.bson.io

Class Bits

java.lang.Object

org.bson.io.Bits

public class Bits
extends Object

Utility class for reading values from an input stream.

Constructor Summary

Constructors

Constructor and Description
Bits()

Method Summary

Modifier and Type	Method and Description
static void	readFully(InputStream in, byte[] b) Reads bytes from the input stream and puts them into the given byte buffer.
static void	readFully(InputStream in, byte[] b, int length) Reads bytes from the input stream and puts them into the given byte buffer.
static void	readFully(InputStream in, byte[] b, int startOffset, int length) Reads bytes from the input stream and puts them into the given byte buffer.
static int	readInt(byte[] data) Reads and returns a single integer value from the buffer.
static int	readInt(byte[] data, int offset) Reads and returns a single integer value from the buffer.
static int	readInt(InputStream in) Reads and returns a single integer value from the input stream.
static int	readInt(InputStream in, byte[] data) Reads and returns a single integer value from the input stream.
static int	readIntBE(byte[] data, int offset) Reads and returns a single big-endian integer value
static long	readLong(byte[] data) Reads and returns a single long value from the buffer.
static long	readLong(byte[] data, int offset) Reads and returns a single long value from the buffer.
static long	readLong(InputStream in) Reads and returns a single long value from the input stream.
static long	readLong(InputStream in, byte[] data) Reads and returns a single long value from the input stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

Bits

public Bits()

Method Detail

readFully

public static void readFully(InputStream in,
                             byte[] b)
                      throws IOException

Reads bytes from the input stream and puts them into the given byte buffer. The equivalent of calling readFully(java.io.InputStream, byte[], int, int) with an offset of zero and a length equal to the length of the buffer.

Parameters:

in - the input stream to read from

b - the buffer into which the data is read.

Throws:

IOException - if there's an error reading from the in

readFully

public static void readFully(InputStream in,
                             byte[] b,
                             int length)
                      throws IOException

Reads bytes from the input stream and puts them into the given byte buffer. The equivalent of calling readFully(java.io.InputStream, byte[], int, int) with an offset of zero.

Parameters:

in - the input stream to read from

b - the buffer into which the data is read.

length - the maximum number of bytes to read.

Throws:

IOException - if there's an error reading from the in

readFully

public static void readFully(InputStream in,
                             byte[] b,
                             int startOffset,
                             int length)
                      throws IOException

Reads bytes from the input stream and puts them into the given byte buffer.

Parameters:

in - the input stream to read from

b - the buffer into which the data is read.

startOffset - the start offset in array b at which the data is written.

length - the maximum number of bytes to read.

Throws:

IOException - if there's an error reading from the in

See Also:

InputStream.read(byte[], int, int)

readInt

public static int readInt(InputStream in)
                   throws IOException

Reads and returns a single integer value from the input stream.

Parameters:

in - the input stream to read from

Returns:

the integer value

Throws:

IOException - if there's an error reading from the in

readInt

public static int readInt(InputStream in,
                          byte[] data)
                   throws IOException

Reads and returns a single integer value from the input stream.

Parameters:

in - the input stream to read from

data - the buffer to write the input stream bytes into

Returns:

the integer value

Throws:

IOException - if there's an error reading from the in

readInt

public static int readInt(byte[] data)

Reads and returns a single integer value from the buffer. The equivalent of calling readInt(byte[], int) with an offset of zero.

Parameters:

data - the buffer to read from

Returns:

the integer value

readInt

public static int readInt(byte[] data,
                          int offset)

Reads and returns a single integer value from the buffer.

Parameters:

data - the buffer to read from

offset - the position to start reading from the buffer

Returns:

the integer value

readIntBE

public static int readIntBE(byte[] data,
                            int offset)

Reads and returns a single big-endian integer value

Parameters:

data - the buffer to read from

offset - the position to start reading from the buffer

Returns:

the integer value

readLong

public static long readLong(InputStream in)
                     throws IOException

Reads and returns a single long value from the input stream.

Parameters:

in - the input stream to read from

Returns:

the long value

Throws:

IOException - if there's an error reading from the in

readLong

public static long readLong(InputStream in,
                            byte[] data)
                     throws IOException

Reads and returns a single long value from the input stream.

Parameters:

in - the input stream to read from

data - the buffer to write the input stream bytes into

Returns:

the long value

Throws:

IOException - if there's an error reading from the in

readLong

public static long readLong(byte[] data)

Reads and returns a single long value from the buffer. The equivalent of called readLong(byte[], int) with an offset of zero.

Parameters:

data - the buffer to read from

Returns:

the long value

readLong

public static long readLong(byte[] data,
                            int offset)

Reads and returns a single long value from the buffer.

Parameters:

data - the buffer to read from

offset - the position to start reading from the buffer

Returns:

the long value