flexjson.ObjectFactory Maven / Gradle / Ivy

Go to download
package flexjson;

import java.lang.reflect.Type;

/**
 * ObjectFactory allows you to instantiate specific types of objects on path or class types.  This interface allows
 * you to override the default rules.  
 */
public interface ObjectFactory
{
	/**
	 * This method is called by the deserializer to construct and bind an object.  At the end of this method
	 * the object should be fully constructed.  {@link flexjson.ObjectBinder} can be used to bind values into
	 * the object according to default rules.  For simple implementations you won't need to use this, but
	 * for more complex or generic objects reusing methods like {@link flexjson.ObjectBinder#bind(Object, java.lang.reflect.Type)}
	 * and {@link flexjson.ObjectBinder#bindIntoCollection(java.util.Collection, java.util.Collection, java.lang.reflect.Type)}.
	 *
	 * @param context the object binding context to keep track of where we are in the object graph
	 * and used for binding into objects.
	 * @param value This is the value from the json object at the current path.
	 * @param targetType This is the type pulled from the object introspector.  Used for Collections and generic types.
	 * @param targetClass concrete class pulled from the configuration of the deserializer.
	 *
	 * @return the fully bound object.  At the end of this method the object should be fully constructed.
	 */
	public Object instantiate(ObjectBinder context, Object value, Type targetType, Class targetClass);
}