com.comphenix.protocol.wrappers

Class WrappedDataWatcher

java.lang.Object

com.comphenix.protocol.wrappers.WrappedDataWatcher

public class WrappedDataWatcher
extends java.lang.Object

Wraps a DataWatcher that is used to transmit arbitrary key-value pairs with a given entity.

Author:

Kristian

Field Summary

Fields

Modifier and Type	Field and Description
protected net.minecraft.server.DataWatcher	handle

Constructor Summary

Constructors

Constructor and Description
WrappedDataWatcher() Initialize a new data watcher.
WrappedDataWatcher(net.minecraft.server.DataWatcher handle) Create a wrapper for a given data watcher.
WrappedDataWatcher(java.util.List<WrappedWatchableObject> watchableObjects) Create a new data watcher from a list of watchable objects.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Byte	getByte(int index) Get a watched byte.
WrappedChunkCoordinate	getChunkCoordinate(int index) Get a watched string.
static WrappedDataWatcher	getEntityWatcher(org.bukkit.entity.Entity entity) Retrieve the data watcher associated with an entity.
java.lang.Float	getFloat(int index) Get a watched float.
net.minecraft.server.DataWatcher	getHandle() Retrieves the underlying data watcher.
java.lang.Integer	getInteger(int index) Get a watched integer.
org.bukkit.inventory.ItemStack	getItemStack(int index) Get a watched string.
java.lang.Object	getObject(int index) Retrieve a watchable object by index.
protected java.util.concurrent.locks.ReadWriteLock	getReadWriteLock() Retrieve the current read write lock.
java.lang.Short	getShort(int index) Get a watched short.
java.lang.String	getString(int index) Get a watched string.
static java.lang.Class<?>	getTypeClass(int id) Retrieve the type of a given ID, if it's allowed to be watched.
static java.lang.Integer	getTypeID(java.lang.Class<?> clazz) Retrieve the ID of a given type, if it's allowed to be watched.
protected java.util.Map<java.lang.Integer,java.lang.Object>	getWatchableObjectMap() Retrieve the underlying map of key values that stores watchable objects.
java.util.List<WrappedWatchableObject>	getWatchableObjects() Retrieve every watchable object in this watcher.
java.util.Set<java.lang.Integer>	indexSet() Retrieve a copy of every index associated with a watched object.
void	setObject(int index, java.lang.Object newValue) Set a watched byte.
void	setObject(int index, java.lang.Object newValue, boolean update) Set a watched byte.
int	size() Retrieve the number of watched objects.

Methods inherited from class java.lang.Object

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

Field Detail

handle

protected net.minecraft.server.DataWatcher handle

Constructor Detail

WrappedDataWatcher

public WrappedDataWatcher()

Initialize a new data watcher.

Throws:

FieldAccessException - If we're unable to wrap a DataWatcher.

WrappedDataWatcher

public WrappedDataWatcher(net.minecraft.server.DataWatcher handle)

Create a wrapper for a given data watcher.

Parameters:

handle - - the data watcher to wrap.

Throws:

FieldAccessException - If we're unable to wrap a DataWatcher.

WrappedDataWatcher

public WrappedDataWatcher(java.util.List<WrappedWatchableObject> watchableObjects)
                   throws FieldAccessException

Create a new data watcher from a list of watchable objects.

Parameters:

watchableObjects - - list of watchable objects that will be copied.

Throws:

FieldAccessException - Unable to read watchable objects.

Method Detail

getHandle

public net.minecraft.server.DataWatcher getHandle()

Retrieves the underlying data watcher.

Returns:

The underlying data watcher.

getTypeID

public static java.lang.Integer getTypeID(java.lang.Class<?> clazz)
                                   throws FieldAccessException

Retrieve the ID of a given type, if it's allowed to be watched.

Returns:

The ID, or NULL if it cannot be watched.

Throws:

FieldAccessException - If we cannot initialize the reflection machinery.

getTypeClass

public static java.lang.Class<?> getTypeClass(int id)
                                       throws FieldAccessException

Retrieve the type of a given ID, if it's allowed to be watched.

Returns:

The type using a given ID, or NULL if it cannot be watched.

Throws:

FieldAccessException - If we cannot initialize the reflection machinery.

getByte

public java.lang.Byte getByte(int index)
                       throws FieldAccessException

Get a watched byte.

Parameters:

index - - index of the watched byte.

Returns:

The watched byte, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getShort

public java.lang.Short getShort(int index)
                         throws FieldAccessException

Get a watched short.

Parameters:

index - - index of the watched short.

Returns:

The watched short, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getInteger

public java.lang.Integer getInteger(int index)
                             throws FieldAccessException

Get a watched integer.

Parameters:

index - - index of the watched integer.

Returns:

The watched integer, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getFloat

public java.lang.Float getFloat(int index)
                         throws FieldAccessException

Get a watched float.

Parameters:

index - - index of the watched float.

Returns:

The watched float, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getString

public java.lang.String getString(int index)
                           throws FieldAccessException

Get a watched string.

Parameters:

index - - index of the watched string.

Returns:

The watched string, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getItemStack

public org.bukkit.inventory.ItemStack getItemStack(int index)
                                            throws FieldAccessException

Get a watched string.

Parameters:

index - - index of the watched string.

Returns:

The watched string, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getChunkCoordinate

public WrappedChunkCoordinate getChunkCoordinate(int index)
                                          throws FieldAccessException

Get a watched string.

Parameters:

index - - index of the watched string.

Returns:

The watched string, or NULL if this value doesn't exist.

Throws:

FieldAccessException - Cannot read underlying field.

getObject

public java.lang.Object getObject(int index)
                           throws FieldAccessException

Retrieve a watchable object by index.

Parameters:

index - - index of the object to retrieve.

Returns:

The watched object.

Throws:

FieldAccessException - Cannot read underlying field.

getWatchableObjects

public java.util.List<WrappedWatchableObject> getWatchableObjects()
                                                           throws FieldAccessException

Retrieve every watchable object in this watcher.

Returns:

Every watchable object.

Throws:

FieldAccessException - If reflection failed.

indexSet

public java.util.Set<java.lang.Integer> indexSet()
                                          throws FieldAccessException

Retrieve a copy of every index associated with a watched object.

Returns:

Every watched object index.

Throws:

FieldAccessException - If we're unable to read the underlying object.

size

public int size()
         throws FieldAccessException

Retrieve the number of watched objects.

Returns:

Watched object count.

Throws:

FieldAccessException - If we're unable to read the underlying object.

setObject

public void setObject(int index,
             java.lang.Object newValue)
               throws FieldAccessException

Set a watched byte.

Parameters:

index - - index of the watched byte.

newValue - - the new watched value.

Throws:

FieldAccessException - Cannot read underlying field.

setObject

public void setObject(int index,
             java.lang.Object newValue,
             boolean update)
               throws FieldAccessException

Set a watched byte.

Parameters:

index - - index of the watched byte.

newValue - - the new watched value.

update - - whether or not to refresh every listening clients.

Throws:

FieldAccessException - Cannot read underlying field.

getReadWriteLock

protected java.util.concurrent.locks.ReadWriteLock getReadWriteLock()
                                                             throws FieldAccessException

Retrieve the current read write lock.

Returns:

Current read write lock.

Throws:

FieldAccessException - If we're unable to read the underlying field.

getWatchableObjectMap

protected java.util.Map<java.lang.Integer,java.lang.Object> getWatchableObjectMap()
                                                                           throws FieldAccessException

Retrieve the underlying map of key values that stores watchable objects.

Returns:

A map of watchable objects.

Throws:

FieldAccessException - If we don't have permission to perform reflection.

getEntityWatcher

public static WrappedDataWatcher getEntityWatcher(org.bukkit.entity.Entity entity)
                                           throws FieldAccessException

Retrieve the data watcher associated with an entity.

Parameters:

entity - - the entity to read from.

Returns:

Associated data watcher.

Throws:

FieldAccessException - Reflection failed.