public abstract class ValueInstantiator extends Object
Note that this type is not parameterized (even though it would seemingly
make sense), because such type information can not be use effectively
during runtime: access is always using either wildcard type, or just
basic Object
; and so adding type parameter seems
like unnecessary extra work.
Actual implementations are strongly recommended to be based on
StdValueInstantiator
which implements all methods, and as such will be compatible
across versions even if new methods were added to this interface.
Constructor and Description |
---|
ValueInstantiator() |
Modifier and Type | Method and Description |
---|---|
protected Object |
_createFromStringFallbacks(DeserializationContext ctxt,
String value) |
boolean |
canCreateFromBoolean()
Method that can be called to check whether a double (boolean / Boolean) based
creator is available to use (to call
createFromDouble(com.fasterxml.jackson.databind.DeserializationContext, double) ). |
boolean |
canCreateFromDouble()
Method that can be called to check whether a double (double / Double) based
creator is available to use (to call
createFromDouble(com.fasterxml.jackson.databind.DeserializationContext, double) ). |
boolean |
canCreateFromInt()
Method that can be called to check whether an integer (int, Integer) based
creator is available to use (to call
createFromInt(com.fasterxml.jackson.databind.DeserializationContext, int) ). |
boolean |
canCreateFromLong()
Method that can be called to check whether a long (long, Long) based
creator is available to use (to call
createFromLong(com.fasterxml.jackson.databind.DeserializationContext, long) ). |
boolean |
canCreateFromObjectWith()
Method that can be called to check whether a property-based creator
(argument-taking constructor or factory method)
is available to instantiate values from JSON Object
|
boolean |
canCreateFromString()
Method that can be called to check whether a String-based creator
is available for this instantiator
|
boolean |
canCreateUsingDefault()
Method that can be called to check whether a default creator (constructor,
or no-arg static factory method)
is available for this instantiator
|
boolean |
canCreateUsingDelegate()
Method that can be called to check whether a delegate-based creator (single-arg
constructor or factory method)
is available for this instantiator
|
boolean |
canInstantiate()
Method that will return true if any of
canCreateXxx method
returns true: that is, if there is any way that an instance could
be created. |
Object |
createFromBoolean(DeserializationContext ctxt,
boolean value) |
Object |
createFromDouble(DeserializationContext ctxt,
double value) |
Object |
createFromInt(DeserializationContext ctxt,
int value) |
Object |
createFromLong(DeserializationContext ctxt,
long value) |
Object |
createFromObjectWith(DeserializationContext ctxt,
Object[] args)
Method called to create value instance from JSON Object when
instantiation arguments are passed; this is done, for example when passing information
specified with "Creator" annotations.
|
Object |
createFromString(DeserializationContext ctxt,
String value) |
Object |
createUsingDefault(DeserializationContext ctxt)
Method called to create value instance from a JSON value when
no data needs to passed to creator (constructor, factory method);
typically this will call the default constructor of the value object.
|
Object |
createUsingDelegate(DeserializationContext ctxt,
Object delegate)
Method to called to create value instance from JSON Object using
an intermediate "delegate" value to pass to createor method
|
AnnotatedWithParams |
getDefaultCreator()
Method that can be called to try to access member (constructor,
static factory method) that is used as the "default creator"
(creator that is called without arguments; typically default
[zero-argument] constructor of the type).
|
AnnotatedWithParams |
getDelegateCreator()
Method that can be called to try to access member (constructor,
static factory method) that is used as the "delegate creator".
|
JavaType |
getDelegateType(DeserializationConfig config)
Method that can be used to determine what is the type of delegate
type to use, if any; if no delegates are used, will return null.
|
SettableBeanProperty[] |
getFromObjectArguments(DeserializationConfig config)
Method called to determine types of instantiation arguments
to use when creating instances with creator arguments
(when
canCreateFromObjectWith() returns true). |
AnnotatedParameter |
getIncompleteParameter()
If an incomplete creator was found, this is the first parameter that
needs further annotation to help make the creator complete.
|
abstract String |
getValueTypeDesc()
Method that returns description of the value type this instantiator
handles.
|
AnnotatedWithParams |
getWithArgsCreator()
Method that can be called to try to access member (constructor,
static factory method) that is used as the "non-default creator"
(constructor or factory method that takes one or more arguments).
|
public abstract String getValueTypeDesc()
public boolean canInstantiate()
canCreateXxx
method
returns true: that is, if there is any way that an instance could
be created.public boolean canCreateFromString()
public boolean canCreateFromInt()
createFromInt(com.fasterxml.jackson.databind.DeserializationContext, int)
).public boolean canCreateFromLong()
createFromLong(com.fasterxml.jackson.databind.DeserializationContext, long)
).public boolean canCreateFromDouble()
createFromDouble(com.fasterxml.jackson.databind.DeserializationContext, double)
).public boolean canCreateFromBoolean()
createFromDouble(com.fasterxml.jackson.databind.DeserializationContext, double)
).public boolean canCreateUsingDefault()
public boolean canCreateUsingDelegate()
public boolean canCreateFromObjectWith()
public SettableBeanProperty[] getFromObjectArguments(DeserializationConfig config)
canCreateFromObjectWith()
returns true).
These arguments are bound from JSON, using specified
property types to locate deserializers.
NOTE: all properties will be of type
CreatorProperty
.
public JavaType getDelegateType(DeserializationConfig config)
public Object createUsingDefault(DeserializationContext ctxt) throws IOException
This method is called if getFromObjectArguments(com.fasterxml.jackson.databind.DeserializationConfig)
returns
null or empty List.
IOException
public Object createFromObjectWith(DeserializationContext ctxt, Object[] args) throws IOException
This method is called if getFromObjectArguments(com.fasterxml.jackson.databind.DeserializationConfig)
returns
a non-empty List of arguments.
IOException
public Object createUsingDelegate(DeserializationContext ctxt, Object delegate) throws IOException
IOException
public Object createFromString(DeserializationContext ctxt, String value) throws IOException
IOException
public Object createFromInt(DeserializationContext ctxt, int value) throws IOException
IOException
public Object createFromLong(DeserializationContext ctxt, long value) throws IOException
IOException
public Object createFromDouble(DeserializationContext ctxt, double value) throws IOException
IOException
public Object createFromBoolean(DeserializationContext ctxt, boolean value) throws IOException
IOException
public AnnotatedWithParams getDefaultCreator()
canCreateUsingDefault()
returns true,
this method may return null .public AnnotatedWithParams getDelegateCreator()
canCreateUsingDelegate()
returns true,
this method may return null .public AnnotatedWithParams getWithArgsCreator()
canCreateFromObjectWith()
returns true,
this method may return null .public AnnotatedParameter getIncompleteParameter()
protected Object _createFromStringFallbacks(DeserializationContext ctxt, String value) throws IOException, com.fasterxml.jackson.core.JsonProcessingException
IOException
com.fasterxml.jackson.core.JsonProcessingException
StdValueInstantiator)
Copyright © 2014-2015 FasterXML. All Rights Reserved.