net.sf.eBus.messages.type

Class ArrayType

java.lang.Object

net.sf.eBus.messages.type.DataType

net.sf.eBus.messages.type.ArrayType

All Implemented Interfaces:

Comparable<DataType>

public final class ArrayType
extends DataType

Provides binary serialization/de-serialization of an object collection. The collection must contain EMessageObject objects of the same class type.

Supports array sizes up to DataType.MAX_ARRAY_SIZE items.

Author:

Charles Rapp

Field Summary

Fields inherited from class net.sf.eBus.messages.type.DataType

ADDRESS_TYPE, ARRAY_SUFFIX, CHARSET, CLASS_TYPE, EMPTY_STRING, FIELD_MASK_SIZE, INDENT, INDENT1, KEY_TYPE, MAX_ARRAY_SIZE, MAX_FIELDS, MAX_FILE_NAME_LENGTH, MAX_STRING_LENGTH, mBuiltinFlag, mClass, mDefaultValue, mSize, sClasses, sCompiledClasses, STRING_TYPE, VARIABLE_SIZE

Constructor Summary

Constructors

Constructor and Description
ArrayType(Class<?> jClass, DataType subtype) Creates an array type which encapsulates the specified data type.

Method Summary

Modifier and Type	Method and Description
protected void	createDeserializer(MessageType.MessageField field, String fieldName, String indent, Formatter output, boolean useBuilder) Generates the Java code for de-serializing an array.
protected void	createSerializer(MessageType.MessageField field, String fieldName, String indent, Formatter output) Generates the array serialization code.
String	dataClassName() Returns the Java class name with "[]" appended.
Object	deserialize(ByteBuffer buffer) Returns the deserialized collection as an Object.
boolean	isInstance(Object o) Returns true if o is either null or a Collection instance; false otherwise.
void	serialize(Object o, ByteBuffer buffer) Serializes this list to the buffer.
DataType	subtype() Returns the array subtype.
String	toString() Returns the subtype Java class name followed by "[]".

Methods inherited from class net.sf.eBus.messages.type.DataType

compareTo, dataClass, defaultValue, equals, fields, findCharset, findType, hashCode, isArray, isBuiltin, isEnum, isLocalOnly, isMessage, isPrimitive, replyClasses, size

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ArrayType

public ArrayType(Class<?> jClass,
                 DataType subtype)

Creates an array type which encapsulates the specified data type. Arrays are homogenous collections and considered a built-in type.

Parameters:

jClass - the Java array class.

subtype - the array element type.

Method Detail

isInstance

public boolean isInstance(Object o)

Returns true if o is either null or a Collection instance; false otherwise.

Overrides:

isInstance in class DataType

Parameters:

o - Check this object's type.

Returns:

true if o is either null or a Collection instance; false otherwise.

serialize

public void serialize(Object o,
                      ByteBuffer buffer)
               throws BufferOverflowException

Serializes this list to the buffer.

Specified by:

serialize in class DataType

Parameters:

o - a list of objects.

buffer - serialize to this buffer.

Throws:

BufferOverflowException - if buffer overflows.

See Also:

deserialize(ByteBuffer)

deserialize

public Object deserialize(ByteBuffer buffer)
                   throws BufferUnderflowException

Returns the deserialized collection as an Object. If the array size is zero, then returns an empty collection. The returned value may be safely typecast to java.util.Collection.

Specified by:

deserialize in class DataType

Parameters:

buffer - Deserialize the list object from this ByteBuffer.

Returns:

the deserialized Collection.

Throws:

BufferUnderflowException - if buffer contains an incomplete serialized array.

See Also:

serialize(Object, ByteBuffer)

createSerializer

protected void createSerializer(MessageType.MessageField field,
                                String fieldName,
                                String indent,
                                Formatter output)

Generates the array serialization code.

Specified by:

createSerializer in class DataType

Parameters:

field - message field.

fieldName - fully-qualified field name.

indent - indent generated code by this spacing.

output - place generated code into this formatter.

createDeserializer

protected void createDeserializer(MessageType.MessageField field,
                                  String fieldName,
                                  String indent,
                                  Formatter output,
                                  boolean useBuilder)

Generates the Java code for de-serializing an array.

Specified by:

createDeserializer in class DataType

Parameters:

field - message field.

fieldName - the array message field name.

indent - indent the code by this amount.

output - append the code to this formatter.

useBuilder - if true then fieldName is a builder method name; otherwise a local variable.

dataClassName

public String dataClassName()

Returns the Java class name with "[]" appended.

Overrides:

dataClassName in class DataType

Returns:

Java class name.

subtype

public DataType subtype()

Returns the array subtype. All array items are of this type.

Returns:

the array subtype.

toString

public String toString()

Returns the subtype Java class name followed by "[]".

Overrides:

toString in class DataType

Returns:

the subtype Java class name followed by "[]".