public class CreatorProperty extends SettableBeanProperty
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.
BeanProperty.Std| Modifier and Type | Field and Description |
|---|---|
protected AnnotatedParameter |
_annotated
Placeholder that represents constructor parameter, when it is created
from actual constructor.
|
protected int |
_creatorIndex |
protected SettableBeanProperty |
_fallbackSetter
In special cases, when implementing "updateValue", we can not use
constructors or factory methods, but have to fall back on using a
setter (or mutable field property).
|
protected Object |
_injectableValueId
Id of value to inject, if value injection should be used for this parameter
(in addition to, or instead of, regular deserialization).
|
_contextAnnotations, _managedReferenceName, _objectIdInfo, _propertyIndex, _propName, _type, _valueDeserializer, _valueTypeDeserializer, _viewMatcher, _wrapperName, MISSING_VALUE_DESERIALIZER_metadata, _propertyFormatEMPTY_FORMAT, EMPTY_INCLUDE| Modifier | Constructor and Description |
|---|---|
protected |
CreatorProperty(CreatorProperty src,
JsonDeserializer<?> deser) |
protected |
CreatorProperty(CreatorProperty src,
PropertyName newName) |
|
CreatorProperty(PropertyName name,
JavaType type,
PropertyName wrapperName,
TypeDeserializer typeDeser,
Annotations contextAnnotations,
AnnotatedParameter param,
int index,
Object injectableValueId,
PropertyMetadata metadata) |
| Modifier and Type | Method and Description |
|---|---|
void |
deserializeAndSet(JsonParser jp,
DeserializationContext ctxt,
Object instance)
Method called to deserialize appropriate value, given parser (and
context), and set it using appropriate mechanism.
|
Object |
deserializeSetAndReturn(JsonParser jp,
DeserializationContext ctxt,
Object instance)
Alternative to
SettableBeanProperty.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. |
Object |
findInjectableValue(DeserializationContext context,
Object beanInstance)
Method that can be called to locate value to be injected for this
property, if it is configured for this.
|
<A extends Annotation> |
getAnnotation(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.
|
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.
|
void |
inject(DeserializationContext context,
Object beanInstance)
Method to find value to inject, and inject it to this property.
|
void |
set(Object instance,
Object value)
Method called to assign given value to this property, on
specified Object.
|
Object |
setAndReturn(Object instance,
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 PropertyBasedCreator
|
String |
toString() |
CreatorProperty |
withName(PropertyName newName)
Fluent factory method for constructing and returning a new instance
with specified property name.
|
CreatorProperty |
withValueDeserializer(JsonDeserializer<?> deser)
Fluent factory method for constructing and returning a new instance
with specified value deserializer.
|
_throwAsIOE, _throwAsIOE, _throwAsIOE, _throwAsIOE, assignIndex, depositSchemaProperty, deserialize, getContextAnnotation, getDeclaringClass, getFullName, getManagedReferenceName, getName, getObjectIdInfo, getPropertyIndex, getType, getValueDeserializer, getValueTypeDeserializer, getWrapperName, hasValueDeserializer, hasValueTypeDeserializer, hasViews, setManagedReferenceName, setObjectIdInfo, setViews, visibleInView, withName, withSimpleNamefindFormatOverrides, findPropertyFormat, findPropertyInclusion, getMetadata, isRequired, isVirtualprotected final AnnotatedParameter _annotated
protected final Object _injectableValueId
protected final int _creatorIndex
protected SettableBeanProperty _fallbackSetter
Mutable only to allow setting after construction, but must be strictly set before any use.
public CreatorProperty(PropertyName name, JavaType type, PropertyName wrapperName, TypeDeserializer typeDeser, Annotations contextAnnotations, AnnotatedParameter param, int index, Object injectableValueId, PropertyMetadata metadata)
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 invocationprotected CreatorProperty(CreatorProperty src, PropertyName newName)
protected CreatorProperty(CreatorProperty src, JsonDeserializer<?> deser)
public CreatorProperty withName(PropertyName newName)
SettableBeanPropertywithName in class SettableBeanPropertynewName - Name to use for the new instance.public CreatorProperty withValueDeserializer(JsonDeserializer<?> deser)
SettableBeanPropertywithValueDeserializer in class SettableBeanPropertydeser - Deserializer to assign to the new property instancepublic void setFallbackSetter(SettableBeanProperty fallbackSetter)
public Object findInjectableValue(DeserializationContext context, Object beanInstance)
public void inject(DeserializationContext context, Object beanInstance) throws IOException
IOExceptionpublic <A extends Annotation> A getAnnotation(Class<A> acls)
BeanProperty
Note that this method should only be called for custom annotations;
access to standard Jackson annotations (or ones supported by
alternate AnnotationIntrospectors) should be accessed
through AnnotationIntrospector.
getAnnotation in interface BeanPropertygetAnnotation in class SettableBeanPropertypublic AnnotatedMember getMember()
BeanPropertygetMember in interface BeanPropertygetMember in class SettableBeanPropertypublic int getCreatorIndex()
SettableBeanPropertygetCreatorIndex in class SettableBeanPropertypublic void deserializeAndSet(JsonParser jp, DeserializationContext ctxt, Object instance) throws IOException, JsonProcessingException
SettableBeanPropertydeserializeAndSet in class SettableBeanPropertyIOExceptionJsonProcessingExceptionpublic Object deserializeSetAndReturn(JsonParser jp, DeserializationContext ctxt, Object instance) throws IOException, JsonProcessingException
SettableBeanPropertySettableBeanProperty.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.deserializeSetAndReturn in class SettableBeanPropertyIOExceptionJsonProcessingExceptionpublic void set(Object instance, Object value) throws IOException
SettableBeanPropertyNote: this is an optional operation, not supported by all implementations, creator-backed properties for example do not support this method.
set in class SettableBeanPropertyIOExceptionpublic Object setAndReturn(Object instance, Object value) throws IOException
SettableBeanPropertyNote: this is an optional operation, not supported by all implementations, creator-backed properties for example do not support this method.
setAndReturn in class SettableBeanPropertyIOExceptionpublic Object getInjectableValueId()
SettableBeanPropertygetInjectableValueId in class SettableBeanPropertypublic String toString()
toString in class SettableBeanPropertyCopyright © 2008–2016 FasterXML. All rights reserved.