com.fitbur.jackson.core.util.Instantiatable Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of external-jackson Show documentation

There is a newer version: 1.0.0

package com.fitbur.jackson.core.util;

/**
 * Add-on interface used to indicate things that may be "blueprint" objects
 * which can not be used as is, but are used for creating usable per-process
 * (serialization, deserialization) instances, using
 * {@link #createInstance} method.
 *
 * Note that some implementations may choose to implement {@link #createInstance}
 * by simply returning 'this': this is acceptable if instances are stateless.
 * 
 * @see DefaultPrettyPrinter
 * 
 * @since 2.1
 */
public interface Instantiatable
{
    /**
     * Method called to ensure that we have a non-blueprint object to use;
     * it is either this object (if stateless), or a newly created object
     * with separate state.
     */
    T createInstance();
}