Class JavaSerialiser
- java.lang.Object
-
- uk.gov.gchq.gaffer.serialisation.implementation.JavaSerialiser
-
- All Implemented Interfaces:
Serializable
,Serialiser<Object,byte[]>
,ToBytesSerialiser<Object>
public class JavaSerialiser extends Object implements ToBytesSerialiser<Object>
This class is used to serialise and deserialise objects in java.- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from interface uk.gov.gchq.gaffer.serialisation.ToBytesSerialiser
EMPTY_BYTES
-
-
Constructor Summary
Constructors Constructor Description JavaSerialiser()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
canHandle(Class clazz)
Check whether the serialiser can serialise a particular class.Object
deserialise(byte[] bytes)
Deserialise an array of bytes into the original object.Object
deserialise(byte[] allBytes, int offset, int length)
Object
deserialiseEmpty()
Handle an empty byte array and reconstruct an appropriate representation in T form.boolean
equals(Object obj)
int
hashCode()
boolean
isConsistent()
Indicates whether the serialisation process produces a predictable, consistent OUTPUT, from a given INPUT, ie the same object should always serialise in the same way for this to be true.boolean
preservesObjectOrdering()
Indicates whether the serialisation process preserves the ordering of the T, i.e.byte[]
serialise(Object object)
Serialise some object and returns the raw bytes of the serialised form.-
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface uk.gov.gchq.gaffer.serialisation.ToBytesSerialiser
serialiseNull
-
-
-
-
Method Detail
-
serialise
public byte[] serialise(Object object) throws SerialisationException
Description copied from interface:ToBytesSerialiser
Serialise some object and returns the raw bytes of the serialised form.- Specified by:
serialise
in interfaceSerialiser<Object,byte[]>
- Specified by:
serialise
in interfaceToBytesSerialiser<Object>
- Parameters:
object
- the object to be serialised- Returns:
- byte[] the serialised bytes
- Throws:
SerialisationException
- if the object fails to serialise
-
deserialise
public Object deserialise(byte[] allBytes, int offset, int length) throws SerialisationException
- Specified by:
deserialise
in interfaceToBytesSerialiser<Object>
- Parameters:
allBytes
- The bytes to be decoded into charactersoffset
- The index of the first byte to decodelength
- The number of bytes to decode- Returns:
- T the deserialised object
- Throws:
SerialisationException
- issues during deserialisation
-
deserialise
public Object deserialise(byte[] bytes) throws SerialisationException
Description copied from interface:ToBytesSerialiser
Deserialise an array of bytes into the original object.- Specified by:
deserialise
in interfaceSerialiser<Object,byte[]>
- Specified by:
deserialise
in interfaceToBytesSerialiser<Object>
- Parameters:
bytes
- the bytes to deserialise- Returns:
- T the deserialised object
- Throws:
SerialisationException
- if the object fails to deserialiseNote that this implementation is less efficient than using deserialise with an offset and a length, but may still be used if necessary. It has been marked deprecated but will not be removed as it is needed in the Serialiser interface.
- See Also:
ToBytesSerialiser.deserialise(byte[], int, int)
-
deserialiseEmpty
public Object deserialiseEmpty()
Description copied from interface:ToBytesSerialiser
Handle an empty byte array and reconstruct an appropriate representation in T form.- Specified by:
deserialiseEmpty
in interfaceSerialiser<Object,byte[]>
- Specified by:
deserialiseEmpty
in interfaceToBytesSerialiser<Object>
- Returns:
- T the deserialised object
-
canHandle
public boolean canHandle(Class clazz)
Description copied from interface:Serialiser
Check whether the serialiser can serialise a particular class.//Warning: Due to erasure you may get false positives. e.g.
Set<Foo> set = Sets.newHashSet(); boolean b = new Serialiser<Set<Bar>, byte[]>().canHandle(set.getClass()); b will incorrectly be true because of type erasure between Set<Foo> Set<Bar>
- Specified by:
canHandle
in interfaceSerialiser<Object,byte[]>
- Parameters:
clazz
- the object class to serialise- Returns:
- boolean true if it can be handled
-
preservesObjectOrdering
public boolean preservesObjectOrdering()
Description copied from interface:ToBytesSerialiser
Indicates whether the serialisation process preserves the ordering of the T, i.e. if x and y are objects of class T, and x is less than y, then this method should return true if the serialised form of x is guaranteed to be less than the serialised form of y (using the standard ordering of byte arrays). If T is not Comparable then this test makes no sense and false should be returned.- Specified by:
preservesObjectOrdering
in interfaceSerialiser<Object,byte[]>
- Specified by:
preservesObjectOrdering
in interfaceToBytesSerialiser<Object>
- Returns:
- true if the serialisation will preserve the order of the T, otherwise false.
-
isConsistent
public boolean isConsistent()
Description copied from interface:Serialiser
Indicates whether the serialisation process produces a predictable, consistent OUTPUT, from a given INPUT, ie the same object should always serialise in the same way for this to be true.- Specified by:
isConsistent
in interfaceSerialiser<Object,byte[]>
- Returns:
- true if serialisation is consistent for a given object, otherwise false.
-
-