ca.uqac.lif.azrael

Class ReflectionReadHandler<T>

java.lang.Object

ca.uqac.lif.azrael.ReflectionReadHandler<T>

Type Parameters:

T - The type from which objects are deserialized

All Implemented Interfaces:

ReadHandler<T>

public class ReflectionReadHandler<T>
extends java.lang.Object
implements ReadHandler<T>

Read handler that uses reflection to deserialize and populate the fields of an object.

Author:

Sylvain Hallé

Field Summary

Fields

Modifier and Type	Field and Description
protected ObjectReader<T>	m_reader The internal object reader

Constructor Summary

Constructors

Constructor and Description
ReflectionReadHandler(ObjectReader<T> reader) Creates a new reflection read handler

Method Summary

Modifier and Type	Method and Description
boolean	canHandle(T o) Indicates whether this handler can take care of reading a particular object.
java.lang.Object	handle(T o) Reads an object
protected java.lang.Object	populateObject(java.lang.Object o, java.util.Map<java.lang.String,java.lang.Object> contents, java.lang.Class<?> clazz) Populates an instance of an object based on its deserialized contents.

Methods inherited from class java.lang.Object

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

Field Detail

m_reader

protected ObjectReader<T> m_reader

The internal object reader

Constructor Detail

ReflectionReadHandler

public ReflectionReadHandler(ObjectReader<T> reader)

Creates a new reflection read handler

Parameters:

reader - The internal object reader

Method Detail

canHandle

public boolean canHandle(T o)
                  throws ReadException

Description copied from interface: ReadHandler

Indicates whether this handler can take care of reading a particular object.

Specified by:

canHandle in interface ReadHandler<T>

Parameters:

o - The serialized version of the object

Returns:

true if this handler can read this object, false otherwise

Throws:

ReadException - The internal object printer

handle

public java.lang.Object handle(T o)
                        throws ReadException

Description copied from interface: ReadHandler

Reads an object

Specified by:

handle in interface ReadHandler<T>

Parameters:

o - The serialized version of the object

Returns:

The object read from t

Throws:

ReadException - Thrown if the object cannot be read

populateObject

protected java.lang.Object populateObject(java.lang.Object o,
                                          java.util.Map<java.lang.String,java.lang.Object> contents,
                                          java.lang.Class<?> clazz)
                                   throws ReadException

Populates an instance of an object based on its deserialized contents. That is, this method is expected to "fill" the object's member fields with deserialized data.

Parameters:

o - The object to use as the basis for the population

contents - The deserialized member fields of the object

clazz - The class this object should be an instance of

Returns:

A populated instance of the object. Note that this can be a different instance than the one passed through o.

Throws:

ReadException - If the operation cannot be carried on