de.gsi.dataset.serializer.spi

Class BinarySerialiser

java.lang.Object

de.gsi.dataset.serializer.spi.BinarySerialiser

Direct Known Subclasses:

BinaryArrayFactory

public class BinarySerialiser
extends Object

Generic binary serialiser aimed at efficiently transferring data between server/client and in particular between Java/C++/web-based programs.

Author:

rstein

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BinarySerialiser.HeaderInfo

Field Summary

Fields

Modifier and Type	Field and Description
protected static BinarySerialiser.HeaderInfo	headerThis
protected static BinarySerialiser	SELF
static byte	VERSION_MAJOR
static byte	VERSION_MICRO
static byte	VERSION_MINOR

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BinarySerialiser()

Method Summary

Modifier and Type	Method and Description
static void	adjustDataByteSizeBlock(IoBuffer buffer, long sizeMarkerStart)
static BinarySerialiser.HeaderInfo	checkHeaderInfo(IoBuffer readBuffer)
static int[]	getArrayDimensions(IoBuffer readBuffer)
static boolean	getBoolean(IoBuffer readBuffer)
static boolean[]	getBooleanArray(IoBuffer readBuffer)
static int	getBufferIncrements()
static byte	getByte(IoBuffer readBuffer)
static byte[]	getByteArray(IoBuffer readBuffer)
static char[]	getCharArray(IoBuffer readBuffer)
static <E> Collection<E>	getCollection(IoBuffer readBuffer, Collection<E> collection)
static double	getDouble(IoBuffer readBuffer)
static double[]	getDoubleArray(IoBuffer readBuffer)
static double[]	getDoubleArray(IoBuffer readBuffer, DataType dataType)
static Enum<?>	getEnum(IoBuffer readBuffer, Enum<?> enumeration)
static String	getEnumTypeList(IoBuffer readBuffer)
static FieldHeader	getFieldHeader(IoBuffer readBuffer)
static float	getFloat(IoBuffer readBuffer)
static float[]	getFloatArray(IoBuffer readBuffer)
protected static Object[]	getGenericArrayAsPrimitive(IoBuffer readBuffer, DataType dataType)
static int[]	getIntArray(IoBuffer readBuffer)
static int	getInteger(IoBuffer readBuffer)
static <E> List<E>	getList(IoBuffer readBuffer, List<E> collection)
static long	getLong(IoBuffer readBuffer)
static long[]	getLongArray(IoBuffer readBuffer)
static <K,V> Map<K,V>	getMap(IoBuffer readBuffer, Map<K,V> map)
static <E> Queue<E>	getQueue(IoBuffer readBuffer, Queue<E> collection)
static <E> Set<E>	getSet(IoBuffer readBuffer, Set<E> collection)
static short	getShort(IoBuffer readBuffer)
static short[]	getShortArray(IoBuffer readBuffer)
static String	getString(IoBuffer readBuffer)
static String[]	getStringArray(IoBuffer readBuffer)
static FieldHeader	parseIoStream(IoBuffer buffer)
protected static void	parseIoStream(IoBuffer buffer, FieldHeader fieldRoot, int recursionDepth)
static void	put(IoBuffer buffer, String fieldName, boolean value)
static void	put(IoBuffer buffer, String fieldName, boolean[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, boolean[] arrayValue, int[] dims)
static void	put(IoBuffer buffer, String fieldName, byte value)
static void	put(IoBuffer buffer, String fieldName, byte[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, byte[] arrayValue, int[] dims)
static <E> void	put(IoBuffer buffer, String fieldName, Collection<E> collection)
static void	put(IoBuffer buffer, String fieldName, double value)
static void	put(IoBuffer buffer, String fieldName, double[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, double[] arrayValue, int[] dims)
static void	put(IoBuffer buffer, String fieldName, Enum<?> enumeration)
static void	put(IoBuffer buffer, String fieldName, float value)
static void	put(IoBuffer buffer, String fieldName, float[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, float[] arrayValue, int[] dims)
static void	put(IoBuffer buffer, String fieldName, int value)
static void	put(IoBuffer buffer, String fieldName, int[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, int[] arrayValue, int[] dims)
static void	put(IoBuffer buffer, String fieldName, long value)
static void	put(IoBuffer buffer, String fieldName, long[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, long[] arrayValue, int[] dims)
static <K,V> void	put(IoBuffer buffer, String fieldName, Map<K,V> map)
static void	put(IoBuffer buffer, String fieldName, short value)
static void	put(IoBuffer buffer, String fieldName, short[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, short[] arrayValue, int[] dims)
static void	put(IoBuffer buffer, String fieldName, String value)
static void	put(IoBuffer buffer, String fieldName, String[] arrayValue)
static void	put(IoBuffer buffer, String fieldName, String[] arrayValue, int[] dims)
static long	putArrayHeader(IoBuffer buffer, String fieldName, DataType dataType, int[] dims, int nElements)
static void	putEndMarker(IoBuffer buffer, String markerName)
static void	putFieldHeader(IoBuffer buffer, String fieldName, DataType dataType)
static void	putFieldHeader(IoBuffer buffer, String fieldName, DataType dataType, int additionalSize)
static void	putGenericArrayAsPrimitive(IoBuffer buffer, DataType dataType, Object[] data, int nToCopy)
static void	putHeaderInfo(IoBuffer buffer) Adds header and version information
static void	putStartMarker(IoBuffer buffer, String markerName)
static void	setBufferIncrements(int bufferIncrements)
protected static void	swallowRest(IoBuffer readBuffer, FieldHeader fieldHeader)

Methods inherited from class java.lang.Object

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

Field Detail

VERSION_MAJOR

public static final byte VERSION_MAJOR

See Also:

Constant Field Values

VERSION_MINOR

public static final byte VERSION_MINOR

See Also:

Constant Field Values

VERSION_MICRO

public static final byte VERSION_MICRO

See Also:

Constant Field Values

SELF

protected static final BinarySerialiser SELF

headerThis

protected static BinarySerialiser.HeaderInfo headerThis

Constructor Detail

BinarySerialiser

protected BinarySerialiser()

Method Detail

adjustDataByteSizeBlock

public static void adjustDataByteSizeBlock(IoBuffer buffer,
                                           long sizeMarkerStart)

checkHeaderInfo

public static BinarySerialiser.HeaderInfo checkHeaderInfo(IoBuffer readBuffer)

getArrayDimensions

public static int[] getArrayDimensions(IoBuffer readBuffer)

getBoolean

public static boolean getBoolean(IoBuffer readBuffer)

getBooleanArray

public static boolean[] getBooleanArray(IoBuffer readBuffer)

getBufferIncrements

public static int getBufferIncrements()

getByte

public static byte getByte(IoBuffer readBuffer)

getByteArray

public static byte[] getByteArray(IoBuffer readBuffer)

getCharArray

public static char[] getCharArray(IoBuffer readBuffer)

getCollection

public static <E> Collection<E> getCollection(IoBuffer readBuffer,
                                              Collection<E> collection)

getDouble

public static double getDouble(IoBuffer readBuffer)

getDoubleArray

public static double[] getDoubleArray(IoBuffer readBuffer)

getDoubleArray

public static double[] getDoubleArray(IoBuffer readBuffer,
                                      DataType dataType)

getEnum

public static Enum<?> getEnum(IoBuffer readBuffer,
                              Enum<?> enumeration)

getEnumTypeList

public static String getEnumTypeList(IoBuffer readBuffer)

getFieldHeader

public static FieldHeader getFieldHeader(IoBuffer readBuffer)

getFloat

public static float getFloat(IoBuffer readBuffer)

getFloatArray

public static float[] getFloatArray(IoBuffer readBuffer)

getGenericArrayAsPrimitive

protected static Object[] getGenericArrayAsPrimitive(IoBuffer readBuffer,
                                                     DataType dataType)

getIntArray

public static int[] getIntArray(IoBuffer readBuffer)

getInteger

public static int getInteger(IoBuffer readBuffer)

getList

public static <E> List<E> getList(IoBuffer readBuffer,
                                  List<E> collection)

getLong

public static long getLong(IoBuffer readBuffer)

getLongArray

public static long[] getLongArray(IoBuffer readBuffer)

getMap

public static <K,V> Map<K,V> getMap(IoBuffer readBuffer,
                                    Map<K,V> map)

getQueue

public static <E> Queue<E> getQueue(IoBuffer readBuffer,
                                    Queue<E> collection)

getSet

public static <E> Set<E> getSet(IoBuffer readBuffer,
                                Set<E> collection)

getShort

public static short getShort(IoBuffer readBuffer)

getShortArray

public static short[] getShortArray(IoBuffer readBuffer)

getString

public static String getString(IoBuffer readBuffer)

getStringArray

public static String[] getStringArray(IoBuffer readBuffer)

parseIoStream

public static FieldHeader parseIoStream(IoBuffer buffer)

parseIoStream

protected static void parseIoStream(IoBuffer buffer,
                                    FieldHeader fieldRoot,
                                    int recursionDepth)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       boolean value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       boolean[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       boolean[] arrayValue,
                       int[] dims)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       byte value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       byte[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       byte[] arrayValue,
                       int[] dims)

put

public static <E> void put(IoBuffer buffer,
                           String fieldName,
                           Collection<E> collection)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       double value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       double[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       double[] arrayValue,
                       int[] dims)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       Enum<?> enumeration)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       float value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       float[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       float[] arrayValue,
                       int[] dims)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       int value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       int[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       int[] arrayValue,
                       int[] dims)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       long value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       long[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       long[] arrayValue,
                       int[] dims)

put

public static <K,V> void put(IoBuffer buffer,
                             String fieldName,
                             Map<K,V> map)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       short value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       short[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       short[] arrayValue,
                       int[] dims)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       String value)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       String[] arrayValue)

put

public static void put(IoBuffer buffer,
                       String fieldName,
                       String[] arrayValue,
                       int[] dims)

putArrayHeader

public static long putArrayHeader(IoBuffer buffer,
                                  String fieldName,
                                  DataType dataType,
                                  int[] dims,
                                  int nElements)

putEndMarker

public static void putEndMarker(IoBuffer buffer,
                                String markerName)

putFieldHeader

public static void putFieldHeader(IoBuffer buffer,
                                  String fieldName,
                                  DataType dataType)

putFieldHeader

public static void putFieldHeader(IoBuffer buffer,
                                  String fieldName,
                                  DataType dataType,
                                  int additionalSize)

putGenericArrayAsPrimitive

public static void putGenericArrayAsPrimitive(IoBuffer buffer,
                                              DataType dataType,
                                              Object[] data,
                                              int nToCopy)

putHeaderInfo

public static void putHeaderInfo(IoBuffer buffer)

Adds header and version information

Parameters:

buffer - to use for serialisation

putStartMarker

public static void putStartMarker(IoBuffer buffer,
                                  String markerName)

setBufferIncrements

public static void setBufferIncrements(int bufferIncrements)

swallowRest

protected static void swallowRest(IoBuffer readBuffer,
                                  FieldHeader fieldHeader)