vaadin-framework/src/com/vaadin/terminal/gwt/client/communication/VaadinSerializer.java

/*
@VaadinApache2LicenseForJavaFiles@
 */

package com.vaadin.terminal.gwt.client.communication;

import com.google.gwt.json.client.JSONObject;
import com.google.gwt.json.client.JSONValue;
import com.vaadin.terminal.gwt.client.ConnectorMap;
import com.vaadin.terminal.gwt.server.JsonCodec;

/**
 * Serializer that can deserialize custom objects received from the server.
 * 
 * Each serializer can handle objects of a single type - see
 * {@link SerializerMap}.
 * 
 * @since 7.0
 */
public interface VaadinSerializer {

    /**
     * Creates and deserializes an object received from the server. Must be
     * compatible with {@link #serialize(Object, ConnectorMap)} and also with
     * the server side
     * {@link JsonCodec#encode(Object, com.vaadin.terminal.gwt.server.PaintableIdMapper)}
     * .
     * 
     * @param jsonValue
     *            JSON map from property name to property value
     * @param idMapper
     *            mapper from paintable id to paintable, used to decode
     *            references to paintables
     * @return A deserialized object
     */
    Object deserialize(JSONObject jsonValue, ConnectorMap idMapper);

    /**
     * Serialize the given object into JSON. Must be compatible with
     * {@link #deserialize(JSONObject, ConnectorMap)} and also with the server
     * side
     * {@link JsonCodec#decode(com.vaadin.external.json.JSONArray, com.vaadin.terminal.gwt.server.PaintableIdMapper)}
     * 
     * @param value
     *            The object to serialize
     * @param idMapper
     *            mapper from paintable id to paintable, used to decode
     *            references to paintables
     * @return A JSON serialized version of the object
     */
    JSONObject serialize(Object value, ConnectorMap idMapper);

}