com.comphenix.protocol.utility

Class StreamSerializer

java.lang.Object

com.comphenix.protocol.utility.StreamSerializer

public class StreamSerializer
extends java.lang.Object

Utility methods for reading and writing Minecraft objects to streams.

Author:

Kristian

Constructor Summary

Constructors

Constructor and Description
StreamSerializer()

Method Summary

Methods

Modifier and Type	Method and Description
NbtCompound	deserializeCompound(java.io.DataInputStream input) Read or deserialize an NBT compound from a input stream.
org.bukkit.inventory.ItemStack	deserializeItemStack(java.io.DataInputStream input) Read or deserialize an item stack from an underlying input stream.
org.bukkit.inventory.ItemStack	deserializeItemStack(java.lang.String input) Deserialize an item stack from a base-64 encoded string.
java.lang.String	deserializeString(java.io.DataInputStream input, int maximumLength) Deserialize a string using the standard Minecraft UTF-16 encoding.
int	deserializeVarInt(java.io.DataInputStream source) Read a variable integer from an input stream.
static StreamSerializer	getDefault() Retrieve a default stream serializer.
void	serializeCompound(java.io.DataOutputStream output, NbtCompound compound) Write or serialize a NBT compound to the given output stream.
void	serializeItemStack(java.io.DataOutputStream output, org.bukkit.inventory.ItemStack stack) Write or serialize an item stack to the given output stream.
java.lang.String	serializeItemStack(org.bukkit.inventory.ItemStack stack) Serialize an item stack as a base-64 encoded string.
void	serializeString(java.io.DataOutputStream output, java.lang.String text) Serialize a string using the standard Minecraft UTF-16 encoding.
void	serializeVarInt(java.io.DataOutputStream destination, int value) Write a variable integer to an output stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

StreamSerializer

public StreamSerializer()

Method Detail

getDefault

public static StreamSerializer getDefault()

Retrieve a default stream serializer.

Returns:

A serializer.

deserializeVarInt

public int deserializeVarInt(@Nonnull
                    java.io.DataInputStream source)
                      throws java.io.IOException

Read a variable integer from an input stream.

Parameters:

source - - the source.

Returns:

The integer.

Throws:

java.io.IOException - The source stream threw an exception.

serializeVarInt

public void serializeVarInt(@Nonnull
                   java.io.DataOutputStream destination,
                   int value)
                     throws java.io.IOException

Write a variable integer to an output stream.

Parameters:

destination - - the destination.

value - - the value to write.

Throws:

java.io.IOException - The destination stream threw an exception.

deserializeItemStack

public org.bukkit.inventory.ItemStack deserializeItemStack(@Nonnull
                                                  java.io.DataInputStream input)
                                                    throws java.io.IOException

Read or deserialize an item stack from an underlying input stream.

To supply a byte array, wrap it in a ByteArrayInputStream and DataInputStream.

Parameters:

input - - the target input stream.

Returns:

The resulting item stack, or NULL if the serialized item stack was NULL.

Throws:

java.io.IOException - If the operation failed due to reflection or corrupt data.

deserializeCompound

public NbtCompound deserializeCompound(@Nonnull
                              java.io.DataInputStream input)
                                throws java.io.IOException

Read or deserialize an NBT compound from a input stream.

Parameters:

input - - the target input stream.

Returns:

The resulting compound, or NULL.

Throws:

java.io.IOException - If the operation failed due to reflection or corrupt data.

deserializeString

public java.lang.String deserializeString(@Nonnull
                                 java.io.DataInputStream input,
                                 int maximumLength)
                                   throws java.io.IOException

Deserialize a string using the standard Minecraft UTF-16 encoding.

Note that strings cannot exceed 32767 characters, regardless if maximum lenght.

Parameters:

input - - the input stream.

maximumLength - - the maximum lenght of the string.

Returns:

The deserialized string.

Throws:

java.io.IOException

deserializeItemStack

public org.bukkit.inventory.ItemStack deserializeItemStack(@Nonnull
                                                  java.lang.String input)
                                                    throws java.io.IOException

Deserialize an item stack from a base-64 encoded string.

Parameters:

input - - base-64 encoded string.

Returns:

A deserialized item stack, or NULL if the serialized ItemStack was also NULL.

Throws:

java.io.IOException - If the operation failed due to reflection or corrupt data.

serializeItemStack

public void serializeItemStack(@Nonnull
                      java.io.DataOutputStream output,
                      org.bukkit.inventory.ItemStack stack)
                        throws java.io.IOException

Write or serialize an item stack to the given output stream.

To supply a byte array, wrap it in a ByteArrayOutputStream and DataOutputStream.

Note: An ItemStack can be written to a stream even if it's NULL.

Parameters:

output - - the target output stream.

stack - - the item stack that will be written, or NULL to represent air/nothing.

Throws:

java.io.IOException - If the operation fails due to reflection problems.

serializeCompound

public void serializeCompound(@Nonnull
                     java.io.DataOutputStream output,
                     NbtCompound compound)
                       throws java.io.IOException

Write or serialize a NBT compound to the given output stream.

Note: An NBT compound can be written to a stream even if it's NULL.

Parameters:

output - - the target output stream.

compound - - the NBT compound to be serialized, or NULL to represent nothing.

Throws:

java.io.IOException - If the operation fails due to reflection problems.

serializeString

public void serializeString(@Nonnull
                   java.io.DataOutputStream output,
                   java.lang.String text)
                     throws java.io.IOException

Serialize a string using the standard Minecraft UTF-16 encoding.

Note that strings cannot exceed 32767 characters, regardless if maximum lenght.

Parameters:

output - - the output stream.

text - - the string to serialize.

Throws:

java.io.IOException - If the data in the string cannot be written.

serializeItemStack

public java.lang.String serializeItemStack(org.bukkit.inventory.ItemStack stack)
                                    throws java.io.IOException

Serialize an item stack as a base-64 encoded string.

Note: An ItemStack can be written to the serialized text even if it's NULL.

Parameters:

stack - - the item stack to serialize, or NULL to represent air/nothing.

Returns:

A base-64 representation of the given item stack.

Throws:

java.io.IOException - If the operation fails due to reflection problems.