net.lenni0451.mcstructs.nbt.io

Class NbtReadTracker

java.lang.Object

net.lenni0451.mcstructs.nbt.io.NbtReadTracker

public class NbtReadTracker
extends java.lang.Object

The Nbt read tracker is used to limit the size of Nbt data that is read.
If you do not want any size constraints you can use unlimited().

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_BYTES The default max bytes that can be read.
static int	DEFAULT_MAX_DEPTH The default max depth that can be read.

Constructor Summary

Constructors

Constructor and Description
NbtReadTracker() Create a new read tracker with the default max bytes (DEFAULT_MAX_BYTES) and max depth (DEFAULT_MAX_DEPTH).
NbtReadTracker(int maxBytes) Create a new read tracker with the given max bytes and the default max depth (DEFAULT_MAX_DEPTH).
NbtReadTracker(int maxDepth, int maxBytes) Create a new read tracker with the given max bytes and max depth.

Method Summary

Modifier and Type	Method and Description
void	popDepth() Pop a depth level.
void	pushDepth() Push a new depth level.
void	read(int bytes) Read the given amount of bytes.
static NbtReadTracker	unlimited() Create an unlimited read tracker.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_BYTES

public static final int DEFAULT_MAX_BYTES

The default max bytes that can be read.

See Also:

Constant Field Values

DEFAULT_MAX_DEPTH

public static final int DEFAULT_MAX_DEPTH

The default max depth that can be read.

See Also:

Constant Field Values

Constructor Detail

NbtReadTracker

public NbtReadTracker()

Create a new read tracker with the default max bytes (DEFAULT_MAX_BYTES) and max depth (DEFAULT_MAX_DEPTH).

NbtReadTracker

public NbtReadTracker(int maxBytes)

Create a new read tracker with the given max bytes and the default max depth (DEFAULT_MAX_DEPTH).

Parameters:

maxBytes - The max bytes that can be read

NbtReadTracker

public NbtReadTracker(int maxDepth,
                      int maxBytes)

Create a new read tracker with the given max bytes and max depth.

Parameters:

maxDepth - The max depth that can be read

maxBytes - The max bytes that can be read

Method Detail

unlimited

public static NbtReadTracker unlimited()

Create an unlimited read tracker.
The depth (DEFAULT_MAX_DEPTH) is still limited.

Returns:

The unlimited read tracker

pushDepth

public void pushDepth()
               throws NbtReadException

Push a new depth level.

Throws:

NbtReadException - If the max depth is reached

popDepth

public void popDepth()

Pop a depth level.

read

public void read(int bytes)
          throws NbtReadException

Read the given amount of bytes.

Parameters:

bytes - The amount of bytes that were read

Throws:

NbtReadException - If the max bytes were exceeded