com.comphenix.protocol.events

Class NetworkMarker

java.lang.Object

com.comphenix.protocol.events.NetworkMarker

Direct Known Subclasses:

NetworkMarker.EmptyBufferMarker

public abstract class NetworkMarker
extends java.lang.Object

Marker containing the serialized packet data seen from the network, or output handlers that will serialize the current packet.

Author:

Kristian

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NetworkMarker.EmptyBufferMarker

Constructor Summary

Constructors

Constructor and Description
NetworkMarker(ConnectionSide side, byte[] inputBuffer, PacketType type) Construct a new network marker.
NetworkMarker(ConnectionSide side, java.nio.ByteBuffer inputBuffer, PacketType type) Construct a new network marker.

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract java.nio.ByteBuffer	addHeader(java.nio.ByteBuffer buffer, PacketType type) Return the byte buffer prepended with the packet header.
protected abstract java.io.DataInputStream	addHeader(java.io.DataInputStream input, PacketType type) Return the input stream prepended with the packet header.
boolean	addOutputHandler(PacketOutputHandler handler) Enqueue the given output handler for managing how the current packet will be written to the network stream.
static byte[]	getByteBuffer(NetworkMarker marker) Retrieve the byte buffer stored in the given marker.
java.nio.ByteBuffer	getInputBuffer() Retrieve the serialized packet data (excluding the header by default) from the network input stream.
java.nio.ByteBuffer	getInputBuffer(boolean excludeHeader) Retrieve the serialized packet data from the network input stream.
java.io.DataInputStream	getInputStream() Retrieve the serialized packet data (excluding the header by default) as an input stream.
java.io.DataInputStream	getInputStream(boolean excludeHeader) Retrieve the serialized packet data as an input stream.
static NetworkMarker	getNetworkMarker(PacketEvent event) Retrieve the network marker of a particular event without creating it.
java.util.Collection<PacketOutputHandler>	getOutputHandlers() Retrieve every registered output handler in no particular order.
StreamSerializer	getSerializer() Retrieve a utility class for serializing and deserializing Minecraft objects.
ConnectionSide	getSide() Retrieve whether or not this marker belongs to a client or a server side packet.
static boolean	hasOutputHandlers(NetworkMarker marker) Determine if the given marker has any output handlers.
boolean	removeOutputHandler(PacketOutputHandler handler) Remove a given output handler from the serialization queue.
boolean	requireOutputHeader() Whether or not the output handlers have to write a packet header.
protected java.nio.ByteBuffer	skipHeader(java.nio.ByteBuffer buffer) Return a byte buffer without the header in the current packet.
protected abstract java.io.DataInputStream	skipHeader(java.io.DataInputStream input) Return an input stream without the header in the current packet.

Methods inherited from class java.lang.Object

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

Constructor Detail

NetworkMarker

public NetworkMarker(@Nonnull
             ConnectionSide side,
             java.nio.ByteBuffer inputBuffer,
             PacketType type)

Construct a new network marker.

Parameters:

side - - whether or not this marker belongs to a client or server packet.

inputBuffer - - the read serialized packet data.

NetworkMarker

public NetworkMarker(@Nonnull
             ConnectionSide side,
             byte[] inputBuffer,
             PacketType type)

Construct a new network marker.

The input buffer is only non-null for client-side packets.

Parameters:

side - - whether or not this marker belongs to a client or server packet.

inputBuffer - - the read serialized packet data.

handler - - handle skipping headers.

Method Detail

getSide

public ConnectionSide getSide()

Retrieve whether or not this marker belongs to a client or a server side packet.

Returns:

The side the parent packet belongs to.

getSerializer

public StreamSerializer getSerializer()

Retrieve a utility class for serializing and deserializing Minecraft objects.

Returns:

Serialization utility class.

getInputBuffer

public java.nio.ByteBuffer getInputBuffer()

Retrieve the serialized packet data (excluding the header by default) from the network input stream.

The returned buffer is read-only. If the parent event is a server side packet this method throws IllegalStateException.

It returns NULL if the packet was transmitted by a plugin locally.

Returns:

A byte buffer containing the raw packet data read from the network.

getInputBuffer

public java.nio.ByteBuffer getInputBuffer(boolean excludeHeader)

Retrieve the serialized packet data from the network input stream.

The returned buffer is read-only. If the parent event is a server side packet this method throws IllegalStateException.

It returns NULL if the packet was transmitted by a plugin locally.

Parameters:

excludeHeader - - whether or not to exclude the packet ID header.

Returns:

A byte buffer containing the raw packet data read from the network.

getInputStream

public java.io.DataInputStream getInputStream()

Retrieve the serialized packet data (excluding the header by default) as an input stream.

The data is exactly the same as in getInputBuffer().

Parameters:

excludeHeader - - whether or not to exclude the packet ID header.

Returns:

The incoming serialized packet data as a stream, or NULL if the packet was transmitted locally.

See Also:

getInputBuffer()

getInputStream

public java.io.DataInputStream getInputStream(boolean excludeHeader)

Retrieve the serialized packet data as an input stream.

The data is exactly the same as in getInputBuffer().

Parameters:

excludeHeader - - whether or not to exclude the packet ID header.

Returns:

The incoming serialized packet data as a stream, or NULL if the packet was transmitted locally.

See Also:

getInputBuffer()

requireOutputHeader

public boolean requireOutputHeader()

Whether or not the output handlers have to write a packet header.

Returns:

TRUE if they do, FALSE otherwise.

addOutputHandler

public boolean addOutputHandler(@Nonnull
                       PacketOutputHandler handler)

Enqueue the given output handler for managing how the current packet will be written to the network stream.

Note that output handlers are not serialized, as most consumers will probably implement them using anonymous classes. It is not safe to serialize anonymous classes, as their name depend on the order in which they are declared in the parent class.

This can only be invoked on server side packet events.

Parameters:

handler - - the handler that will take part in serializing the packet.

Returns:

TRUE if it was added, FALSE if it has already been added.

removeOutputHandler

public boolean removeOutputHandler(@Nonnull
                          PacketOutputHandler handler)

Remove a given output handler from the serialization queue.

This can only be invoked on server side packet events.

Parameters:

handler - - the handler to remove.

Returns:

TRUE if the handler was removed, FALSE otherwise.

getOutputHandlers

@Nonnull
public java.util.Collection<PacketOutputHandler> getOutputHandlers()

Retrieve every registered output handler in no particular order.

Returns:

Every registered output handler.

skipHeader

protected java.nio.ByteBuffer skipHeader(java.nio.ByteBuffer buffer)
                                  throws java.io.IOException

Return a byte buffer without the header in the current packet.

It's safe to modify the position of the buffer.

Parameters:

buffer - - a read-only byte source.

Throws:

java.io.IOException

skipHeader

protected abstract java.io.DataInputStream skipHeader(java.io.DataInputStream input)
                                               throws java.io.IOException

Return an input stream without the header in the current packet.

It's safe to modify the input stream.

Throws:

java.io.IOException

addHeader

protected abstract java.nio.ByteBuffer addHeader(java.nio.ByteBuffer buffer,
                            PacketType type)

Return the byte buffer prepended with the packet header.

Parameters:

buffer - - the read-only byte buffer.

type - - the current packet.

Returns:

The byte buffer.

addHeader

protected abstract java.io.DataInputStream addHeader(java.io.DataInputStream input,
                                PacketType type)

Return the input stream prepended with the packet header.

Parameters:

input - - the input stream.

type - - the current packet.

Returns:

The byte buffer.

hasOutputHandlers

public static boolean hasOutputHandlers(NetworkMarker marker)

Determine if the given marker has any output handlers.

Parameters:

marker - - the marker to check.

Returns:

TRUE if it does, FALSE otherwise.

getByteBuffer

public static byte[] getByteBuffer(NetworkMarker marker)

Retrieve the byte buffer stored in the given marker.

Parameters:

marker - - the marker.

Returns:

The byte buffer, or NULL if not found.

getNetworkMarker

public static NetworkMarker getNetworkMarker(PacketEvent event)

Retrieve the network marker of a particular event without creating it.

This is an internal method that should not be used by API users.

Parameters:

event - - the event.

Returns:

The network marker.