codeql/java/ql/test/stubs/flexjson-2.1/flexjson/ObjectFactory.java

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);
}