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 |
---|---|
boolean |
canCreateFromBoolean()
Method that can be called to check whether a double (boolean / Boolean) based
creator is available to use (to call
createFromDouble(double) ). |
boolean |
canCreateFromDouble()
Method that can be called to check whether a double (double / Double) based
creator is available to use (to call
createFromDouble(double) ). |
boolean |
canCreateFromInt()
Method that can be called to check whether an integer (int, Integer) based
creator is available to use (to call
createFromInt(int) ). |
boolean |
canCreateFromLong()
Method that can be called to check whether a long (long, Long) based
creator is available to use (to call
createFromLong(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(boolean value) |
Object |
createFromDouble(double value) |
Object |
createFromInt(int value) |
Object |
createFromLong(long value) |
Object |
createFromObjectWith(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(String value) |
Object |
createUsingDefault()
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(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()
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()
Method called to determine types of instantiation arguments
to use when creating instances with creator arguments
(when
canCreateFromObjectWith() returns true). |
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(int)
).public boolean canCreateFromLong()
createFromLong(long)
).public boolean canCreateFromDouble()
createFromDouble(double)
).public boolean canCreateFromBoolean()
createFromDouble(double)
).public boolean canCreateUsingDefault()
public boolean canCreateUsingDelegate()
public boolean canCreateFromObjectWith()
public SettableBeanProperty[] getFromObjectArguments()
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()
public Object createUsingDefault() throws IOException, JsonProcessingException
This method is called if getFromObjectArguments()
returns
null or empty List.
IOException
JsonProcessingException
public Object createFromObjectWith(Object[] args) throws IOException, JsonProcessingException
This method is called if getFromObjectArguments()
returns
a non-empty List of arguments.
IOException
JsonProcessingException
public Object createUsingDelegate(Object delegate) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public Object createFromString(String value) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public Object createFromInt(int value) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public Object createFromLong(long value) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public Object createFromDouble(double value) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public Object createFromBoolean(boolean value) throws IOException, JsonProcessingException
IOException
JsonProcessingException
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 .