org.codehaus.jackson.map.deser.std

类 StdValueInstantiator

java.lang.Object

org.codehaus.jackson.map.deser.ValueInstantiator

org.codehaus.jackson.map.deser.std.StdValueInstantiator

public class StdValueInstantiator
extends ValueInstantiator

Basic ValueInstantiator implementation, which only supports use of default constructor. Sub-types can add support for alternate construction methods, such as using argument-taking constructors or static factory methods.

从以下版本开始:

1.9.0

字段概要

字段

限定符和类型	字段和说明
protected boolean	_cfgEmptyStringsAsObjects Are we allowed to convert empty Strings to null objects?
protected CreatorProperty[]	_constructorArguments
protected AnnotatedWithParams	_defaultCreator Default (no-argument) constructor to use for instantiation (with createUsingDefault())
protected AnnotatedWithParams	_delegateCreator
protected JavaType	_delegateType
protected AnnotatedWithParams	_fromBooleanCreator
protected AnnotatedWithParams	_fromDoubleCreator
protected AnnotatedWithParams	_fromIntCreator
protected AnnotatedWithParams	_fromLongCreator
protected AnnotatedWithParams	_fromStringCreator
protected String	_valueTypeDesc Type of values that are instantiated; used for error reporting purposes.
protected AnnotatedWithParams	_withArgsCreator

构造器概要

构造器

限定符	构造器和说明
	StdValueInstantiator(DeserializationConfig config, Class<?> valueType)
	StdValueInstantiator(DeserializationConfig config, JavaType valueType)
protected	StdValueInstantiator(StdValueInstantiator src) Copy-constructor that sub-classes can use when creating new instances by fluent-style construction

方法概要

方法

限定符和类型	方法和说明
protected Object	_createFromStringFallbacks(String value)
boolean	canCreateFromBoolean() Method that can be called to check whether a double (boolean / Boolean) based creator is available to use (to call ValueInstantiator.createFromDouble(double)).
boolean	canCreateFromDouble() Method that can be called to check whether a double (double / Double) based creator is available to use (to call ValueInstantiator.createFromDouble(double)).
boolean	canCreateFromInt() Method that can be called to check whether an integer (int, Integer) based creator is available to use (to call ValueInstantiator.createFromInt(int)).
boolean	canCreateFromLong() Method that can be called to check whether a long (long, Long) based creator is available to use (to call ValueInstantiator.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
void	configureFromBooleanCreator(AnnotatedWithParams creator)
void	configureFromDoubleCreator(AnnotatedWithParams creator)
void	configureFromIntCreator(AnnotatedWithParams creator)
void	configureFromLongCreator(AnnotatedWithParams creator)
void	configureFromObjectSettings(AnnotatedWithParams defaultCreator, AnnotatedWithParams delegateCreator, JavaType delegateType, AnnotatedWithParams withArgsCreator, CreatorProperty[] constructorArgs) Method for setting properties related to instantiating values from JSON Object.
void	configureFromStringCreator(AnnotatedWithParams creator)
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 ValueInstantiator.canCreateFromObjectWith() returns true).
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).
protected JsonMappingException	wrapException(Throwable t)

从类继承的方法 org.codehaus.jackson.map.deser.ValueInstantiator

canCreateUsingDelegate, canInstantiate

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

_valueTypeDesc

protected final String _valueTypeDesc

Type of values that are instantiated; used for error reporting purposes.

_cfgEmptyStringsAsObjects

protected final boolean _cfgEmptyStringsAsObjects

Are we allowed to convert empty Strings to null objects?

_defaultCreator

protected AnnotatedWithParams _defaultCreator

Default (no-argument) constructor to use for instantiation (with createUsingDefault())

_constructorArguments

protected CreatorProperty[] _constructorArguments

_withArgsCreator

protected AnnotatedWithParams _withArgsCreator

_delegateType

protected JavaType _delegateType

_delegateCreator

protected AnnotatedWithParams _delegateCreator

_fromStringCreator

protected AnnotatedWithParams _fromStringCreator

_fromIntCreator

protected AnnotatedWithParams _fromIntCreator

_fromLongCreator

protected AnnotatedWithParams _fromLongCreator

_fromDoubleCreator

protected AnnotatedWithParams _fromDoubleCreator

_fromBooleanCreator

protected AnnotatedWithParams _fromBooleanCreator

构造器详细资料

StdValueInstantiator

public StdValueInstantiator(DeserializationConfig config,
                    Class<?> valueType)

StdValueInstantiator

public StdValueInstantiator(DeserializationConfig config,
                    JavaType valueType)

StdValueInstantiator

protected StdValueInstantiator(StdValueInstantiator src)

Copy-constructor that sub-classes can use when creating new instances by fluent-style construction

方法详细资料

configureFromObjectSettings

public void configureFromObjectSettings(AnnotatedWithParams defaultCreator,
                               AnnotatedWithParams delegateCreator,
                               JavaType delegateType,
                               AnnotatedWithParams withArgsCreator,
                               CreatorProperty[] constructorArgs)

Method for setting properties related to instantiating values from JSON Object. We will choose basically only one approach (out of possible three), and clear other properties

configureFromStringCreator

public void configureFromStringCreator(AnnotatedWithParams creator)

configureFromIntCreator

public void configureFromIntCreator(AnnotatedWithParams creator)

configureFromLongCreator

public void configureFromLongCreator(AnnotatedWithParams creator)

configureFromDoubleCreator

public void configureFromDoubleCreator(AnnotatedWithParams creator)

configureFromBooleanCreator

public void configureFromBooleanCreator(AnnotatedWithParams creator)

getValueTypeDesc

public String getValueTypeDesc()

从类复制的说明: ValueInstantiator

Method that returns description of the value type this instantiator handles. Used for error messages, diagnostics.

指定者:

getValueTypeDesc 在类中 ValueInstantiator

canCreateFromString

public boolean canCreateFromString()

从类复制的说明: ValueInstantiator

Method that can be called to check whether a String-based creator is available for this instantiator

覆盖:

canCreateFromString 在类中 ValueInstantiator

canCreateFromInt

public boolean canCreateFromInt()

从类复制的说明: ValueInstantiator

Method that can be called to check whether an integer (int, Integer) based creator is available to use (to call ValueInstantiator.createFromInt(int)).

覆盖:

canCreateFromInt 在类中 ValueInstantiator

canCreateFromLong

public boolean canCreateFromLong()

从类复制的说明: ValueInstantiator

Method that can be called to check whether a long (long, Long) based creator is available to use (to call ValueInstantiator.createFromLong(long)).

覆盖:

canCreateFromLong 在类中 ValueInstantiator

canCreateFromDouble

public boolean canCreateFromDouble()

从类复制的说明: ValueInstantiator

Method that can be called to check whether a double (double / Double) based creator is available to use (to call ValueInstantiator.createFromDouble(double)).

覆盖:

canCreateFromDouble 在类中 ValueInstantiator

canCreateFromBoolean

public boolean canCreateFromBoolean()

从类复制的说明: ValueInstantiator

Method that can be called to check whether a double (boolean / Boolean) based creator is available to use (to call ValueInstantiator.createFromDouble(double)).

覆盖:

canCreateFromBoolean 在类中 ValueInstantiator

canCreateUsingDefault

public boolean canCreateUsingDefault()

从类复制的说明: ValueInstantiator

Method that can be called to check whether a default creator (constructor, or no-arg static factory method) is available for this instantiator

覆盖:

canCreateUsingDefault 在类中 ValueInstantiator

canCreateFromObjectWith

public boolean canCreateFromObjectWith()

从类复制的说明: ValueInstantiator

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

覆盖:

canCreateFromObjectWith 在类中 ValueInstantiator

getDelegateType

public JavaType getDelegateType()

从类复制的说明: ValueInstantiator

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. If non-null type is returned, deserializer will bind JSON into specified type (using standard deserializer for that type), and pass that to instantiator.

覆盖:

getDelegateType 在类中 ValueInstantiator

getFromObjectArguments

public SettableBeanProperty[] getFromObjectArguments()

从类复制的说明: ValueInstantiator

Method called to determine types of instantiation arguments to use when creating instances with creator arguments (when ValueInstantiator.canCreateFromObjectWith() returns true). These arguments are bound from JSON, using specified property types to locate deserializers.

NOTE: all properties will be of type CreatorProperty.

覆盖:

getFromObjectArguments 在类中 ValueInstantiator

createUsingDefault

public Object createUsingDefault()
                          throws IOException,
                                 JsonProcessingException

从类复制的说明: ValueInstantiator

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. It will only be used if more specific creator methods are not applicable; hence "default".

This method is called if ValueInstantiator.getFromObjectArguments() returns null or empty List.

覆盖:

createUsingDefault 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createFromObjectWith

public Object createFromObjectWith(Object[] args)
                            throws IOException,
                                   JsonProcessingException

从类复制的说明: ValueInstantiator

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.

This method is called if ValueInstantiator.getFromObjectArguments() returns a non-empty List of arguments.

覆盖:

createFromObjectWith 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createUsingDelegate

public Object createUsingDelegate(Object delegate)
                           throws IOException,
                                  JsonProcessingException

从类复制的说明: ValueInstantiator

Method to called to create value instance from JSON Object using an intermediate "delegate" value to pass to createor method

覆盖:

createUsingDelegate 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createFromString

public Object createFromString(String value)
                        throws IOException,
                               JsonProcessingException

覆盖:

createFromString 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createFromInt

public Object createFromInt(int value)
                     throws IOException,
                            JsonProcessingException

覆盖:

createFromInt 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createFromLong

public Object createFromLong(long value)
                      throws IOException,
                             JsonProcessingException

覆盖:

createFromLong 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createFromDouble

public Object createFromDouble(double value)
                        throws IOException,
                               JsonProcessingException

覆盖:

createFromDouble 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

createFromBoolean

public Object createFromBoolean(boolean value)
                         throws IOException,
                                JsonProcessingException

覆盖:

createFromBoolean 在类中 ValueInstantiator

抛出:

IOException

JsonProcessingException

getDelegateCreator

public AnnotatedWithParams getDelegateCreator()

从类复制的说明: ValueInstantiator

Method that can be called to try to access member (constructor, static factory method) that is used as the "delegate creator". Note that implementations not required to return actual object they use (or, they may use some other instantiation) method. That is, even if ValueInstantiator.canCreateUsingDelegate() returns true, this method may return null .

覆盖:

getDelegateCreator 在类中 ValueInstantiator

getDefaultCreator

public AnnotatedWithParams getDefaultCreator()

从类复制的说明: ValueInstantiator

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). Note that implementations not required to return actual object they use (or, they may use some other instantiation) method. That is, even if ValueInstantiator.canCreateUsingDefault() returns true, this method may return null .

覆盖:

getDefaultCreator 在类中 ValueInstantiator

getWithArgsCreator

public AnnotatedWithParams getWithArgsCreator()

从类复制的说明: ValueInstantiator

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). Note that implementations not required to return actual object they use (or, they may use some other instantiation) method. That is, even if ValueInstantiator.canCreateFromObjectWith() returns true, this method may return null .

覆盖:

getWithArgsCreator 在类中 ValueInstantiator

_createFromStringFallbacks

protected Object _createFromStringFallbacks(String value)
                                     throws IOException,
                                            JsonProcessingException

抛出:

IOException

JsonProcessingException

wrapException

protected JsonMappingException wrapException(Throwable t)