com.owlike.genson.reflect

Class BeanDescriptor<T>

java.lang.Object

com.owlike.genson.reflect.BeanDescriptor<T>

Type Parameters:

T - type that this BeanDescriptor can serialize and deserialize.

All Implemented Interfaces:

Converter<T>, Deserializer<T>, Serializer<T>

public class BeanDescriptor<T>
extends Object
implements Converter<T>

BeanDescriptors are used to serialize/deserialize objects based on their fields, methods and constructors. By default it is supposed to work on JavaBeans, however it can be configured and extended to support different kind of objects.

In most cases BeanDescriptors should not be used directly as it is used internally to support objects not handled by the default Converters. The most frequent case when you will use directly a BeanDescriptor is when you want to deserialize into an existing instance. Here is an example :

 Genson genson = new Genson();
 BeanDescriptorProvider provider = genson.getBeanDescriptorProvider();
 BeanDescriptor<MyClass> descriptor = provider.provide(MyClass.class, genson);

 MyClass existingInstance = descriptor.deserialize(existingInstance, new JsonReader("{}"),
                new Context(genson));
 

Author:

eugen

See Also:

BeanDescriptorProvider

Constructor Summary

Constructors

Constructor and Description
BeanDescriptor(Class<T> forClass, Class<?> fromDeclaringClass, List<PropertyAccessor> readableBps, Map<String,PropertyMutator> writableBps, BeanCreator creator, boolean failOnMissingProperty)

Method Summary

Modifier and Type	Method and Description
protected T	_deserWithCtrArgs(ObjectReader reader, Context ctx)
T	deserialize(ObjectReader reader, Context ctx)
void	deserialize(T into, ObjectReader reader, Context ctx)
Class<T>	getOfClass()
boolean	isReadable()
boolean	isWritable()
void	serialize(T obj, ObjectWriter writer, Context ctx)

Methods inherited from class java.lang.Object

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

Constructor Detail

BeanDescriptor

public BeanDescriptor(Class<T> forClass,
                      Class<?> fromDeclaringClass,
                      List<PropertyAccessor> readableBps,
                      Map<String,PropertyMutator> writableBps,
                      BeanCreator creator,
                      boolean failOnMissingProperty)

Method Detail

isReadable

public boolean isReadable()

isWritable

public boolean isWritable()

serialize

public void serialize(T obj,
                      ObjectWriter writer,
                      Context ctx)

Specified by:

serialize in interface Converter<T>

Specified by:

serialize in interface Serializer<T>

Parameters:

obj - we want to serialize. The object is of type T or a subclass (if this serializer has been registered for subclasses).

writer - to use to write data to the output stream.

ctx - the current context.

deserialize

public T deserialize(ObjectReader reader,
                     Context ctx)

Specified by:

deserialize in interface Converter<T>

Specified by:

deserialize in interface Deserializer<T>

Parameters:

reader - used to read data from.

ctx - the current context.

Returns:

an instance of T or a subclass of T.

deserialize

public void deserialize(T into,
                        ObjectReader reader,
                        Context ctx)

_deserWithCtrArgs

protected T _deserWithCtrArgs(ObjectReader reader,
                              Context ctx)

getOfClass

public Class<T> getOfClass()