com.sshtools.common.util

Class ByteArrayReader

java.lang.Object

java.io.InputStream

java.io.ByteArrayInputStream

com.sshtools.common.util.ByteArrayReader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class ByteArrayReader
extends java.io.ByteArrayInputStream

Utiltiy class to read common parameter types from a byte array.

Author:

Lee David Painter

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	encode

Fields inherited from class java.io.ByteArrayInputStream

buf, count, mark, pos

Constructor Summary

Constructors

Constructor and Description
ByteArrayReader(byte[] buffer)
ByteArrayReader(byte[] buffer, int start, int len) Construct a reader.

Method Summary

Modifier and Type	Method and Description
byte[]	array() Provides access to the underlying array
void	close()
static java.lang.String	decodeString(byte[] data)
void	dispose()
static java.lang.String	getCharsetEncoding() Get the current encoding being used for Strings variables.
int	getPosition() Get the current position within the array.
java.math.BigInteger	readBigInteger() Read a BigInteger from the array.
byte[]	readBinaryString() Read a binary string from the array.
boolean	readBoolean() Write a boolean value to the array.
void	readFully(byte[] b)
void	readFully(byte[] b, int off, int len) Read until the buffer supplied is full.
long	readInt() Read an integer (4 bytes) from the array.
static long	readInt(byte[] data, int start) Read an integer (4 bytes) from the array.
java.math.BigInteger	readMPINT() Reads a standard SSH1 MPINT using the first 16 bits as the length prefix
java.math.BigInteger	readMPINT32() Reads an MPINT using the first 32 bits as the length prefix
short	readShort()
static short	readShort(byte[] data, int start)
java.lang.String	readString() Read a String from the array.
java.lang.String	readString(java.lang.String charset) Read a String from the array converting using the given character set.
UnsignedInteger32	readUINT32()
UnsignedInteger64	readUINT64()
static void	setCharsetEncoding(java.lang.String charset) Allows the default encoding to be overriden for String variables processed by the class.
void	silentClose()

Methods inherited from class java.io.ByteArrayInputStream

available, mark, markSupported, read, read, reset, skip

Methods inherited from class java.io.InputStream

read

Methods inherited from class java.lang.Object

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

Field Detail

encode

public static boolean encode

Constructor Detail

ByteArrayReader

public ByteArrayReader(byte[] buffer,
                       int start,
                       int len)

Construct a reader.

Parameters:

buffer -

start -

len -

ByteArrayReader

public ByteArrayReader(byte[] buffer)

Method Detail

array

public byte[] array()

Provides access to the underlying array

Returns:

byte[]

setCharsetEncoding

public static void setCharsetEncoding(java.lang.String charset)

Allows the default encoding to be overriden for String variables processed by the class. This currently defaults to UTF-8.

Parameters:

charset -

Throws:

java.io.UnsupportedEncodingException

getCharsetEncoding

public static java.lang.String getCharsetEncoding()

Get the current encoding being used for Strings variables.

Returns:

readFully

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

Read until the buffer supplied is full.

Parameters:

b -

off -

len -

Throws:

java.io.IOException

readBoolean

public boolean readBoolean()
                    throws java.io.IOException

Write a boolean value to the array.

Parameters:

b -

Throws:

java.io.IOException

readFully

public void readFully(byte[] b)
               throws java.io.IOException

Throws:

java.io.IOException

readBigInteger

public java.math.BigInteger readBigInteger()
                                    throws java.io.IOException

Read a BigInteger from the array.

Returns:

the BigInteger value.

Throws:

java.io.IOException

readUINT64

public UnsignedInteger64 readUINT64()
                             throws java.io.IOException

Throws:

java.io.IOException

readUINT32

public UnsignedInteger32 readUINT32()
                             throws java.io.IOException

Throws:

java.io.IOException

readInt

public static long readInt(byte[] data,
                           int start)

Read an integer (4 bytes) from the array. This is returned as a long as we deal with unsigned ints so the value may be higher than the standard java int.

Parameters:

data -

start -

Returns:

the value represent by a long.

readShort

public static short readShort(byte[] data,
                              int start)

readBinaryString

public byte[] readBinaryString()
                        throws java.io.IOException

Read a binary string from the array.

Returns:

the byte array.

Throws:

java.io.IOException

readInt

public long readInt()
             throws java.io.IOException

Read an integer (4 bytes) from the array. This is returned as a long as we deal with unsigned ints so the value may be higher than the standard java int.

Returns:

the integer value as a long.

Throws:

java.io.IOException

readString

public java.lang.String readString()
                            throws java.io.IOException

Read a String from the array.

Returns:

the String value.

Throws:

java.io.IOException

readString

public java.lang.String readString(java.lang.String charset)
                            throws java.io.IOException

Read a String from the array converting using the given character set.

Parameters:

charset -

Returns:

Throws:

java.io.IOException

readShort

public short readShort()
                throws java.io.IOException

Throws:

java.io.IOException

readMPINT32

public java.math.BigInteger readMPINT32()
                                 throws java.io.IOException

Reads an MPINT using the first 32 bits as the length prefix

Returns:

Throws:

java.io.IOException

readMPINT

public java.math.BigInteger readMPINT()
                               throws java.io.IOException

Reads a standard SSH1 MPINT using the first 16 bits as the length prefix

Returns:

Throws:

java.io.IOException

getPosition

public int getPosition()

Get the current position within the array.

Returns:

the current position within the array

silentClose

public void silentClose()

dispose

public void dispose()

close

public void close()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.ByteArrayInputStream

decodeString

public static java.lang.String decodeString(byte[] data)
                                     throws java.io.IOException

Throws:

java.io.IOException