Class CreatorProperty
- java.lang.Object
-
- com.fasterxml.jackson.databind.introspect.ConcreteBeanPropertyBase
-
- com.fasterxml.jackson.databind.deser.SettableBeanProperty
-
- com.fasterxml.jackson.databind.deser.CreatorProperty
-
- All Implemented Interfaces:
BeanProperty
,Named
,java.io.Serializable
public class CreatorProperty extends SettableBeanProperty
This concrete sub-class implements property that is passed via Creator (constructor or static factory method). It is not a full-featured implementation in that its set method should usually not be called for primary mutation -- instead, value must separately passed -- but some aspects are still needed (specifically, injection).Note on injectable values: unlike with other mutators, where deserializer and injecting are separate, here we treat the two as related things. This is necessary to add proper priority, as well as to simplify coordination.
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.fasterxml.jackson.databind.deser.SettableBeanProperty
SettableBeanProperty.Delegating
-
Nested classes/interfaces inherited from interface com.fasterxml.jackson.databind.BeanProperty
BeanProperty.Bogus, BeanProperty.Std
-
-
Field Summary
-
Fields inherited from interface com.fasterxml.jackson.databind.BeanProperty
EMPTY_FORMAT, EMPTY_INCLUDE
-
-
Constructor Summary
Constructors Constructor Description CreatorProperty(PropertyName name, JavaType type, PropertyName wrapperName, TypeDeserializer typeDeser, Annotations contextAnnotations, AnnotatedParameter param, int index, java.lang.Object injectableValueId, PropertyMetadata metadata)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
deserializeAndSet(JsonParser p, DeserializationContext ctxt, java.lang.Object instance)
Method called to deserialize appropriate value, given parser (and context), and set it using appropriate mechanism.java.lang.Object
deserializeSetAndReturn(JsonParser p, DeserializationContext ctxt, java.lang.Object instance)
Alternative toSettableBeanProperty.deserializeAndSet(com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.DeserializationContext, java.lang.Object)
that returns either return value of setter method called (if one is), or null to indicate that no return value is available.java.lang.Object
findInjectableValue(DeserializationContext context, java.lang.Object beanInstance)
Method that can be called to locate value to be injected for this property, if it is configured for this.void
fixAccess(DeserializationConfig config)
Method called to ensure that the mutator has proper access rights to be called, as per configuration.<A extends java.lang.annotation.Annotation>
AgetAnnotation(java.lang.Class<A> acls)
Method for finding annotation associated with this property; meaning annotation associated with one of entities used to access property.int
getCreatorIndex()
Method for accessing index of the creator property: for other types of properties will simply return -1.java.lang.Object
getInjectableValueId()
Accessor for id of injectable value, if this bean property supports value injection.AnnotatedMember
getMember()
Method for accessing primary physical entity that represents the property; annotated field, method or constructor property.PropertyMetadata
getMetadata()
Accessor for additional optional information about property.void
inject(DeserializationContext context, java.lang.Object beanInstance)
Method to find value to inject, and inject it to this property.boolean
isIgnorable()
void
markAsIgnorable()
void
set(java.lang.Object instance, java.lang.Object value)
Method called to assign given value to this property, on specified Object.java.lang.Object
setAndReturn(java.lang.Object instance, java.lang.Object value)
Method called to assign given value to this property, on specified Object, and return whatever delegating accessor returned (if anything)void
setFallbackSetter(SettableBeanProperty fallbackSetter)
NOTE: one exception to immutability, due to problems with CreatorProperty instances being shared between Bean, separate PropertyBasedCreatorjava.lang.String
toString()
SettableBeanProperty
withName(PropertyName newName)
Fluent factory method for constructing and returning a new instance with specified property name.SettableBeanProperty
withNullProvider(NullValueProvider nva)
SettableBeanProperty
withValueDeserializer(JsonDeserializer<?> deser)
Fluent factory method for constructing and returning a new instance with specified value deserializer.-
Methods inherited from class com.fasterxml.jackson.databind.deser.SettableBeanProperty
assignIndex, depositSchemaProperty, deserialize, deserializeWith, getContextAnnotation, getFullName, getManagedReferenceName, getName, getNullValueProvider, getObjectIdInfo, getPropertyIndex, getType, getValueDeserializer, getValueTypeDeserializer, getWrapperName, hasValueDeserializer, hasValueTypeDeserializer, hasViews, setManagedReferenceName, setObjectIdInfo, setViews, visibleInView, withSimpleName
-
Methods inherited from class com.fasterxml.jackson.databind.introspect.ConcreteBeanPropertyBase
findAliases, findFormatOverrides, findPropertyFormat, findPropertyInclusion, isRequired, isVirtual
-
-
-
-
Constructor Detail
-
CreatorProperty
public CreatorProperty(PropertyName name, JavaType type, PropertyName wrapperName, TypeDeserializer typeDeser, Annotations contextAnnotations, AnnotatedParameter param, int index, java.lang.Object injectableValueId, PropertyMetadata metadata)
- Parameters:
name
- Name of the logical propertytype
- Type of the property, used to find deserializertypeDeser
- Type deserializer to use for handling polymorphic type information, if one is neededcontextAnnotations
- Contextual annotations (usually by class that declares creator [constructor, factory method] that includes this property)param
- Representation of property, constructor or factory method parameter; used for accessing annotations of the propertyindex
- Index of this property within creator invocation- Since:
- 2.3
-
-
Method Detail
-
withName
public SettableBeanProperty withName(PropertyName newName)
Description copied from class:SettableBeanProperty
Fluent factory method for constructing and returning a new instance with specified property name. Note that this method should NOT change configuration of this instance.- Specified by:
withName
in classSettableBeanProperty
- Parameters:
newName
- Name to use for the new instance.- Returns:
- Newly constructed instance, if property name differs from the one used for this instance; or 'this' if not.
-
withValueDeserializer
public SettableBeanProperty withValueDeserializer(JsonDeserializer<?> deser)
Description copied from class:SettableBeanProperty
Fluent factory method for constructing and returning a new instance with specified value deserializer. Note that this method should NOT change configuration of this instance.- Specified by:
withValueDeserializer
in classSettableBeanProperty
- Parameters:
deser
- Deserializer to assign to the new property instance- Returns:
- Newly constructed instance, if value deserializer differs from the one used for this instance; or 'this' if not.
-
withNullProvider
public SettableBeanProperty withNullProvider(NullValueProvider nva)
- Specified by:
withNullProvider
in classSettableBeanProperty
-
fixAccess
public void fixAccess(DeserializationConfig config)
Description copied from class:SettableBeanProperty
Method called to ensure that the mutator has proper access rights to be called, as per configuration. Overridden by implementations that have mutators that require access, fields and setters.- Overrides:
fixAccess
in classSettableBeanProperty
-
setFallbackSetter
public void setFallbackSetter(SettableBeanProperty fallbackSetter)
NOTE: one exception to immutability, due to problems with CreatorProperty instances being shared between Bean, separate PropertyBasedCreator- Since:
- 2.6
-
markAsIgnorable
public void markAsIgnorable()
- Overrides:
markAsIgnorable
in classSettableBeanProperty
-
isIgnorable
public boolean isIgnorable()
- Overrides:
isIgnorable
in classSettableBeanProperty
-
findInjectableValue
public java.lang.Object findInjectableValue(DeserializationContext context, java.lang.Object beanInstance) throws JsonMappingException
Method that can be called to locate value to be injected for this property, if it is configured for this.- Throws:
JsonMappingException
-
inject
public void inject(DeserializationContext context, java.lang.Object beanInstance) throws java.io.IOException
Method to find value to inject, and inject it to this property.- Throws:
java.io.IOException
-
getAnnotation
public <A extends java.lang.annotation.Annotation> A getAnnotation(java.lang.Class<A> acls)
Description copied from interface:BeanProperty
Method for finding annotation associated with this property; meaning annotation associated with one of entities used to access property.Note that this method should only be called for custom annotations; access to standard Jackson annotations (or ones supported by alternate
AnnotationIntrospector
s) should be accessed throughAnnotationIntrospector
.- Specified by:
getAnnotation
in interfaceBeanProperty
- Specified by:
getAnnotation
in classSettableBeanProperty
-
getMember
public AnnotatedMember getMember()
Description copied from interface:BeanProperty
Method for accessing primary physical entity that represents the property; annotated field, method or constructor property.- Specified by:
getMember
in interfaceBeanProperty
- Specified by:
getMember
in classSettableBeanProperty
-
getCreatorIndex
public int getCreatorIndex()
Description copied from class:SettableBeanProperty
Method for accessing index of the creator property: for other types of properties will simply return -1.- Overrides:
getCreatorIndex
in classSettableBeanProperty
-
deserializeAndSet
public void deserializeAndSet(JsonParser p, DeserializationContext ctxt, java.lang.Object instance) throws java.io.IOException
Description copied from class:SettableBeanProperty
Method called to deserialize appropriate value, given parser (and context), and set it using appropriate mechanism. Pre-condition is that passed parser must point to the first token that should be consumed to produce the value (the only value for scalars, multiple for Objects and Arrays).- Specified by:
deserializeAndSet
in classSettableBeanProperty
- Throws:
java.io.IOException
-
deserializeSetAndReturn
public java.lang.Object deserializeSetAndReturn(JsonParser p, DeserializationContext ctxt, java.lang.Object instance) throws java.io.IOException
Description copied from class:SettableBeanProperty
Alternative toSettableBeanProperty.deserializeAndSet(com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.DeserializationContext, java.lang.Object)
that returns either return value of setter method called (if one is), or null to indicate that no return value is available. Mostly used to support Builder style deserialization.- Specified by:
deserializeSetAndReturn
in classSettableBeanProperty
- Throws:
java.io.IOException
-
set
public void set(java.lang.Object instance, java.lang.Object value) throws java.io.IOException
Description copied from class:SettableBeanProperty
Method called to assign given value to this property, on specified Object.Note: this is an optional operation, not supported by all implementations, creator-backed properties for example do not support this method.
- Specified by:
set
in classSettableBeanProperty
- Throws:
java.io.IOException
-
setAndReturn
public java.lang.Object setAndReturn(java.lang.Object instance, java.lang.Object value) throws java.io.IOException
Description copied from class:SettableBeanProperty
Method called to assign given value to this property, on specified Object, and return whatever delegating accessor returned (if anything)Note: this is an optional operation, not supported by all implementations, creator-backed properties for example do not support this method.
- Specified by:
setAndReturn
in classSettableBeanProperty
- Throws:
java.io.IOException
-
getMetadata
public PropertyMetadata getMetadata()
Description copied from interface:BeanProperty
Accessor for additional optional information about property.- Specified by:
getMetadata
in interfaceBeanProperty
- Overrides:
getMetadata
in classConcreteBeanPropertyBase
- Returns:
- Metadata about property; never null.
-
getInjectableValueId
public java.lang.Object getInjectableValueId()
Description copied from class:SettableBeanProperty
Accessor for id of injectable value, if this bean property supports value injection.- Overrides:
getInjectableValueId
in classSettableBeanProperty
-
toString
public java.lang.String toString()
- Overrides:
toString
in classSettableBeanProperty
-
-