org.stellar.sdk.xdr

Class XdrDataInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.io.DataInputStream

org.stellar.sdk.xdr.XdrDataInputStream

All Implemented Interfaces:

java.io.Closeable, java.io.DataInput, java.lang.AutoCloseable

public class XdrDataInputStream
extends java.io.DataInputStream

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_DEPTH Default maximum decoding depth to prevent stack overflow from deeply nested structures.

Constructor Summary

Constructors

Constructor and Description
XdrDataInputStream(java.io.InputStream in) Creates a XdrDataInputStream that uses the specified underlying InputStream.

Method Summary

Modifier and Type	Method and Description
int	getRemainingInputLen() Returns the remaining input length if known, -1 otherwise.
int	read()
double[]	readDoubleArray() Deprecated. This method does not validate the array length and may cause OutOfMemoryError or NegativeArraySizeException with untrusted input. Use generated XDR type decoders instead which include proper validation.
float[]	readFloatArray() Deprecated. This method does not validate the array length and may cause OutOfMemoryError or NegativeArraySizeException with untrusted input. Use generated XDR type decoders instead which include proper validation.
int[]	readIntArray() Deprecated. This method does not validate the array length and may cause OutOfMemoryError or NegativeArraySizeException with untrusted input. Use generated XDR type decoders instead which include proper validation.
void	readPaddedData(byte[] b, int off, int len) Reads exactly len bytes of XDR opaque/string data, handling short reads, then reads and validates padding bytes to maintain 4-byte alignment.
boolean	readXdrBoolean() Reads an XDR boolean value from the stream.
void	setMaxInputLen(int maxInputLen) Maximum input length, -1 if unknown.

Methods inherited from class java.io.DataInputStream

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

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, reset, skip

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_DEPTH

public static final int DEFAULT_MAX_DEPTH

Default maximum decoding depth to prevent stack overflow from deeply nested structures.

See Also:

Constant Field Values

Constructor Detail

XdrDataInputStream

public XdrDataInputStream(java.io.InputStream in)

Creates a XdrDataInputStream that uses the specified underlying InputStream.

Parameters:

in - the specified input stream

Method Detail

getRemainingInputLen

public int getRemainingInputLen()

Returns the remaining input length if known, -1 otherwise. This can be used to validate sizes before allocating memory.

Returns:

remaining input length, or -1 if unknown

readXdrBoolean

public boolean readXdrBoolean()
                       throws java.io.IOException

Reads an XDR boolean value from the stream. Per RFC 4506, a boolean is encoded as an integer that must be 0 (FALSE) or 1 (TRUE).

Returns:

the boolean value

Throws:

java.io.IOException - if the value is not 0 or 1, or if an I/O error occurs

readIntArray

@Deprecated
public int[] readIntArray()
                               throws java.io.IOException

Deprecated. This method does not validate the array length and may cause OutOfMemoryError or NegativeArraySizeException with untrusted input. Use generated XDR type decoders instead which include proper validation.

Throws:

java.io.IOException

readFloatArray

@Deprecated
public float[] readFloatArray()
                                   throws java.io.IOException

Deprecated. This method does not validate the array length and may cause OutOfMemoryError or NegativeArraySizeException with untrusted input. Use generated XDR type decoders instead which include proper validation.

Throws:

java.io.IOException

readDoubleArray

@Deprecated
public double[] readDoubleArray()
                                     throws java.io.IOException

Deprecated. This method does not validate the array length and may cause OutOfMemoryError or NegativeArraySizeException with untrusted input. Use generated XDR type decoders instead which include proper validation.

Throws:

java.io.IOException

read

public int read()
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

readPaddedData

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

Reads exactly len bytes of XDR opaque/string data, handling short reads, then reads and validates padding bytes to maintain 4-byte alignment. This method must be used instead of read(byte[], int, int) for opaque data to correctly handle short reads from the underlying stream.

Parameters:

b - the buffer into which the data is read

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

len - the number of bytes to read

Throws:

java.io.IOException - if an I/O error occurs or EOF is reached before reading len bytes

setMaxInputLen

public void setMaxInputLen(int maxInputLen)

Maximum input length, -1 if unknown. This is used to validate that the declared size of variable-length arrays/opaques doesn't exceed the remaining input length, preventing DoS attacks.