com.owlike.genson

Interface Serializer<T>

Type Parameters:

T - the type of objects this Serializer can serialize.

All Known Subinterfaces:

Converter<T>

All Known Implementing Classes:

BeanDescriptor, BeanViewConverter, ClassMetadataConverter, DefaultConverters.ArrayConverter, DefaultConverters.BigDecimalConverter, DefaultConverters.BigIntegerConverter, DefaultConverters.BooleanConverter, DefaultConverters.ByteArrayAsIntArrayConverter, DefaultConverters.ByteArrayConverter, DefaultConverters.CalendarConverter, DefaultConverters.CollectionConverter, DefaultConverters.ComplexMapConverter, DefaultConverters.DateConverter, DefaultConverters.DoubleConverter, DefaultConverters.EnumConverter, DefaultConverters.EnumSetConverter, DefaultConverters.FileConverter, DefaultConverters.HashMapConverter, DefaultConverters.HashTableConverter, DefaultConverters.IntegerConverter, DefaultConverters.LongConverter, DefaultConverters.MapConverter, DefaultConverters.NumberConverter, DefaultConverters.PrimitiveConverterFactory.booleanConverter, DefaultConverters.PrimitiveConverterFactory.doubleConverter, DefaultConverters.PrimitiveConverterFactory.intConverter, DefaultConverters.PrimitiveConverterFactory.longConverter, DefaultConverters.PropertiesConverter, DefaultConverters.SetConverter, DefaultConverters.StringConverter, DefaultConverters.TimestampConverter, DefaultConverters.URIConverter, DefaultConverters.URLConverter, DefaultConverters.UUIDConverter, JSR353Bundle.JsonValueConverter, NullConverter, NullConverter.NullConverterWrapper, OptionalConverter, RuntimeTypeConverter

public interface Serializer<T>

Serializers handle serialization by writing a java object of type T to a stream using ObjectWriter. Genson Serializers work like classic serializers from other libraries. Here is an example of a custom serializer that will delegate the serialization of Author type to the library:

 class Book {
        String title;
        int totalPages;
        Author author;
 }
 
 class Author {
        String name;
 }
 
 static class BookSerializer implements Serializer<Book> {
        private final Serializer<Author> authorSerializer;
 
        // a reference to a delegated author serializer
        BookSerializer(Serializer<Author> authorSerializer) {
                this.authorSerializer = authorSerializer;
        }
 
        public void serialize(Book book, ObjectWriter writer, Context ctx) {
                // we don't have to worry if book is null by default it is handled by the library.
                writer.beginObject().writeName("title").writeValue(book.title).writeName("totalPages")
                                .writeValue(book.totalPages).writeName("author");
 
                // again no need to check if author is null the library will handle it
                authorSerializer.serialize(book.author, writer, ctx);
                writer.endObject();
        }
 
         public final static Factory<Serializer<Book>> bookFactory = new Factory<Serializer<Book>>() {
 
                public Serializer<Book> create(Type type, Genson genson) {
                        Serializer<Author> authorSerializer = genson.provideConverter(Author.class);
                        return new GoodBookSerializer(authorSerializer);
                }
        }
 }
 

As you see it involves very few lines of code and is quite powerful.

Author:

eugen

See Also:

Converter, Factory

Method Summary

Methods

Modifier and Type	Method and Description
void	serialize(T object, ObjectWriter writer, Context ctx)

Method Detail

serialize

void serialize(T object,
             ObjectWriter writer,
             Context ctx)
               throws Exception

Parameters:

object - 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.

Throws:

JsonBindingException

JsonStreamException

Exception