org.codehaus.jackson.map.DeserializerFactory Maven / Gradle / Ivy
package org.codehaus.jackson.map;
import org.codehaus.jackson.JsonNode;
import org.codehaus.jackson.map.deser.BeanDeserializerModifier;
import org.codehaus.jackson.map.type.*;
import org.codehaus.jackson.type.JavaType;
/**
* Abstract class that defines API used by {@link DeserializerProvider}
* to obtain actual
* {@link JsonDeserializer} instances from multiple distinct factories.
*
* Since there are multiple broad categories of deserializers, there are
* multiple factory methods:
*
* - For JSON "Array" type, we need 2 methods: one to deal with expected
* Java arrays ({@link #createArrayDeserializer})
* and the other for other Java containers like {@link java.util.List}s
* and {@link java.util.Set}s ({@link #createCollectionDeserializer(DeserializationConfig, DeserializerProvider, CollectionType, BeanProperty)})
*
* - For JSON "Object" type, we need 2 methods: one to deal with
* expected Java {@link java.util.Map}s
* ({@link #createMapDeserializer}), and another for POJOs
* ({@link #createBeanDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)}.
*
* - For Tree Model ({@link org.codehaus.jackson.JsonNode}) properties there is
* {@link #createTreeDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)}
*
- For enumerated types ({@link java.lang.Enum}) there is
* {@link #createEnumDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)}
*
* - For all other types, {@link #createBeanDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)}
* is used.
*
*
* All above methods take 2 type arguments, except for the first one
* which takes just a single argument.
*/
public abstract class DeserializerFactory
{
protected final static Deserializers[] NO_DESERIALIZERS = new Deserializers[0];
/*
/**********************************************************
/* Helper class to contain configuration settings
/**********************************************************
*/
/**
* Configuration settings container class for bean deserializer factory
*
* @since 1.7
*/
public abstract static class Config
{
/**
* Fluent/factory method used to construct a configuration object that
* has same deserializer providers as this instance, plus one specified
* as argument. Additional provider will be added before existing ones,
* meaning it has priority over existing definitions.
*/
public abstract Config withAdditionalDeserializers(Deserializers additional);
/**
* Fluent/factory method used to construct a configuration object that
* has same configuration as this instance plus one additional
* deserialiazer modifier. Added modified has highest priority (that is, it
* gets called before any already registered modifier).
*/
public abstract Config withDeserializerModifier(BeanDeserializerModifier modifier);
public abstract Iterable deserializers();
public abstract Iterable deserializerModifiers();
public abstract boolean hasDeserializers();
public abstract boolean hasDeserializerModifiers();
}
/*
/********************************************************
/* Configuration handling
/********************************************************
*/
/**
* @since 1.7
*/
public abstract Config getConfig();
/**
* Method used for creating a new instance of this factory, but with different
* configuration. Reason for specifying factory method (instead of plain constructor)
* is to allow proper sub-classing of factories.
*
* Note that custom sub-classes must override implementation
* of this method, as it usually requires instantiating a new instance of
* factory type. Check out javadocs for
* {@link org.codehaus.jackson.map.deser.BeanDeserializerFactory} for more details.
*
* @since 1.7
*/
public abstract DeserializerFactory withConfig(Config config);
/**
* Convenience method for creating a new factory instance with additional deserializer
* provider.
*
* @since 1.7
*/
public final DeserializerFactory withAdditionalDeserializers(Deserializers additional) {
return withConfig(getConfig().withAdditionalDeserializers(additional));
}
/**
* Convenience method for creating a new factory instance with additional
* {@link BeanDeserializerModifier}.
*
* @since 1.7
*/
public final DeserializerFactory withDeserializerModifier(BeanDeserializerModifier modifier) {
return withConfig(getConfig().withDeserializerModifier(modifier));
}
/*
/**********************************************************
/* Basic DeserializerFactory API:
/**********************************************************
*/
/**
* Method called to create (or, for completely immutable deserializers,
* reuse) a deserializer that can convert JSON content into values of
* specified Java "bean" (POJO) type.
* At this point it is known that the type is not otherwise recognized
* as one of structured types (array, Collection, Map) or a well-known
* JDK type (enum, primitives/wrappers, String); this method only
* gets called if other options are exhausted. This also means that
* this method can be overridden to add support for custom types.
*
* @param type Type to be deserialized
* @param p Provider that can be called to create deserializers for
* contained member types
*/
public abstract JsonDeserializer