Class POJOPropertiesCollector

java.lang.Object

tools.jackson.databind.introspect.POJOPropertiesCollector

public class POJOPropertiesCollector
extends Object

Helper class used for aggregating information about all possible properties of a POJO.

Field Summary

Fields

Modifier and Type	Field	Description
protected final AccessorNamingStrategy	_accessorNaming	Handler used for name-mangling of getter, mutator (setter/with) methods
protected final AnnotationIntrospector	_annotationIntrospector
protected LinkedList<AnnotatedMember>	_anyGetterField
protected LinkedList<AnnotatedMember>	_anyGetters
protected LinkedList<AnnotatedMember>	_anySetterField
protected LinkedList<AnnotatedMethod>	_anySetters
protected final AnnotatedClass	_classDef	Low-level introspected class information (methods, fields etc)
protected boolean	_collected	State flag we keep to indicate whether actual property information has been collected or not.
protected final MapperConfig<?>	_config	Configuration settings
protected List<POJOPropertyBuilder>	_creatorProperties
protected Map<PropertyName, PropertyName>	_fieldRenameMappings	A set of "field renamings" that have been discovered, indicating intended renaming of other accessors: key is the implicit original name and value intended name to use instead.
protected com.fasterxml.jackson.annotation.JsonFormat.Value	_formatOverrides	Lazily accessed information about POJO format overrides
protected final boolean	_forSerialization	True if introspection is done for serialization (giving precedence for serialization annotations), or not (false, deserialization)
protected HashSet<String>	_ignoredPropertyNames	Lazily collected list of properties that can be implicitly ignored during serialization; only updated when collecting information for deserialization purposes
protected LinkedHashMap<Object, AnnotatedMember>	_injectables	Lazily collected list of members that were annotated to indicate that they represent mutators for deserializer value injection.
protected final boolean	_isRecordType
protected LinkedList<AnnotatedMember>	_jsonKeyAccessors	Accessors (field or "getter" method annotated with JsonKey
protected LinkedList<AnnotatedMember>	_jsonValueAccessors	Accessors (field or "getter" method) annotated with JsonValue
protected PotentialCreators	_potentialCreators
protected LinkedHashMap<String, POJOPropertyBuilder>	_properties	Set of logical property information collected so far.
protected final JavaType	_type	Type of POJO for which properties are being collected.
protected final boolean	_useAnnotations
protected final VisibilityChecker	_visibilityChecker

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	POJOPropertiesCollector(MapperConfig<?> config, boolean forSerialization, JavaType type, AnnotatedClass classDef, AccessorNamingStrategy accessorNaming)

Method Summary

Modifier and Type	Method	Description
private void	_addCreatorParams(Map<String, POJOPropertyBuilder> props, PotentialCreator ctor, List<POJOPropertyBuilder> creatorProps)
protected void	_addCreators(Map<String, POJOPropertyBuilder> props)
private void	_addCreatorsWithAnnotatedNames(PotentialCreators collector, List<PotentialCreator> ctors, PotentialCreator primaryCtor)
private void	_addExplicitlyAnnotatedCreators(PotentialCreators collector, List<PotentialCreator> ctors, Map<String, POJOPropertyBuilder> props, boolean skipPropsBased)
protected void	_addFields(Map<String, POJOPropertyBuilder> props)	Method for collecting basic information on all fields found
protected void	_addGetterMethod(Map<String, POJOPropertyBuilder> props, AnnotatedMethod m)
private boolean	_addImplicitConstructor(PotentialCreators collector, List<PotentialCreator> ctors, Map<String, POJOPropertyBuilder> props)
protected void	_addInjectables(Map<String, POJOPropertyBuilder> props)
protected void	_addMethods(Map<String, POJOPropertyBuilder> props)	Method for collecting basic information on all accessor methods found
protected void	_addSetterMethod(Map<String, POJOPropertyBuilder> props, AnnotatedMethod m)
private boolean	_anyIndexed(Collection<POJOPropertyBuilder> props)
private String	_checkRenameByField(String implName)
private List<PotentialCreator>	_collectCreators(List<? extends AnnotatedWithParams> ctors)
protected void	_collectIgnorals(String name)	Helper method called to add explicitly ignored properties to a list of known ignored properties; this helps in proper reporting of errors.
protected void	_doAddInjectable(com.fasterxml.jackson.annotation.JacksonInject.Value injectable, AnnotatedMember m)
private List<PotentialCreator>	_findCreatorsWithAnnotatedNames(List<PotentialCreator> ctors)
private com.fasterxml.jackson.annotation.JsonFormat.Shape	_findFormatShape()	Helper method called to check if given property should be renamed using PropertyNamingStrategies.
private PropertyNamingStrategy	_findNamingStrategy()
private boolean	_firstOrSecondCharUpperCase(String name)
protected void	_fixLeadingFieldNameCase(Map<String, POJOPropertyBuilder> props)
private boolean	_isDelegatingConstructor(PotentialCreator ctor)
private boolean	_isDisabledCreator(PotentialCreator ctor)
private boolean	_isExplicitlyAnnotatedCreatorPropsBased(PotentialCreator ctor, Map<String, POJOPropertyBuilder> props, ConstructorDetector ctorDetector)
private PotentialCreator	_potentialCreator(AnnotatedWithParams ctor)
protected POJOPropertyBuilder	_property(Map<String, POJOPropertyBuilder> props, String implName)
protected POJOPropertyBuilder	_property(Map<String, POJOPropertyBuilder> props, PropertyName name)
private PropertyName	_propNameFromSimple(String simpleName)
private Map<String, POJOPropertyBuilder>	_putAnyGettersInTheEnd(Map<String, POJOPropertyBuilder> sortedProps)	[databind#5215] JsonAnyGetter Serializer behavior change from 2.18.4 to 2.19.0 Put anyGetter in the end, before actual sorting further down _sortProperties(Map)
private void	_removeDisabledCreators(List<PotentialCreator> ctors)
private void	_removeNonFactoryStaticMethods(List<PotentialCreator> ctors, PotentialCreator primaryCreator)
private void	_removeNonVisibleCreators(List<PotentialCreator> ctors)
protected void	_removeUnwantedAccessors(Map<String, POJOPropertyBuilder> props)	Method called to further get rid of unwanted individual accessors, based on read/write settings and rules for "pulling in" accessors (or not).
protected void	_removeUnwantedProperties(Map<String, POJOPropertyBuilder> props)	Method called to get rid of candidate properties that are marked as ignored.
protected void	_renameProperties(Map<String, POJOPropertyBuilder> props)
protected void	_renameUsing(Map<String, POJOPropertyBuilder> propMap, PropertyNamingStrategy naming)
protected void	_renameWithWrappers(Map<String, POJOPropertyBuilder> props)
protected boolean	_replaceCreatorProperty(List<POJOPropertyBuilder> creatorProperties, POJOPropertyBuilder prop)
protected boolean	_resolveFieldVsGetter(List<AnnotatedMember> accessors)	Method that will be given a List with 2 or more accessors that may be in conflict: it will need to remove lower-priority accessors to leave just a single highest-priority accessor to use.
protected void	_sortProperties(Map<String, POJOPropertyBuilder> props)
protected void	collectAll()	Internal method that will collect actual property information.
AnnotationIntrospector	getAnnotationIntrospector()
AnnotatedMember	getAnyGetterField()
AnnotatedMember	getAnyGetterMethod()
AnnotatedMember	getAnySetterField()
AnnotatedMethod	getAnySetterMethod()
AnnotatedClass	getClassDef()
MapperConfig<?>	getConfig()
com.fasterxml.jackson.annotation.JsonFormat.Value	getFormatOverrides()
Set<String>	getIgnoredPropertyNames()	Accessor for set of properties that are explicitly marked to be ignored via per-property markers (but NOT class annotations).
Map<Object, AnnotatedMember>	getInjectables()
AnnotatedMember	getJsonKeyAccessor()
AnnotatedMember	getJsonValueAccessor()
ObjectIdInfo	getObjectIdInfo()	Accessor to find out whether type specified requires inclusion of Object Identifier.
PotentialCreators	getPotentialCreators()
List<BeanPropertyDefinition>	getProperties()
protected Map<String, POJOPropertyBuilder>	getPropertyMap()
JavaType	getType()
boolean	isRecordType()
protected void	reportProblem(String msg, Object... args)

Methods inherited from class Object

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

Field Details

_config

protected final MapperConfig<?> _config

Configuration settings

_accessorNaming

protected final AccessorNamingStrategy _accessorNaming

Handler used for name-mangling of getter, mutator (setter/with) methods

_forSerialization

protected final boolean _forSerialization

True if introspection is done for serialization (giving precedence for serialization annotations), or not (false, deserialization)

_type

protected final JavaType _type

Type of POJO for which properties are being collected.

_classDef

protected final AnnotatedClass _classDef

Low-level introspected class information (methods, fields etc)

_visibilityChecker

protected final VisibilityChecker _visibilityChecker

_annotationIntrospector

protected final AnnotationIntrospector _annotationIntrospector

_useAnnotations

protected final boolean _useAnnotations

_isRecordType

protected final boolean _isRecordType

_collected

protected boolean _collected

State flag we keep to indicate whether actual property information has been collected or not.

_properties

protected LinkedHashMap<String, POJOPropertyBuilder> _properties

Set of logical property information collected so far.

_creatorProperties

protected List<POJOPropertyBuilder> _creatorProperties

_potentialCreators

protected PotentialCreators _potentialCreators

Since:

2.18

_fieldRenameMappings

protected Map<PropertyName, PropertyName> _fieldRenameMappings

A set of "field renamings" that have been discovered, indicating intended renaming of other accessors: key is the implicit original name and value intended name to use instead.

Note that these renamings are applied earlier than "regular" (explicit) renamings and affect implicit name: their effect may be changed by further renaming based on explicit indicators. The main use case is to effectively relink accessors based on fields discovered, and used to sort of correct otherwise missing linkage between fields and other accessors.

_anyGetters

protected LinkedList<AnnotatedMember> _anyGetters

_anyGetterField

protected LinkedList<AnnotatedMember> _anyGetterField

_anySetters

protected LinkedList<AnnotatedMethod> _anySetters

_anySetterField

protected LinkedList<AnnotatedMember> _anySetterField

_jsonKeyAccessors

protected LinkedList<AnnotatedMember> _jsonKeyAccessors

Accessors (field or "getter" method annotated with JsonKey

_jsonValueAccessors

protected LinkedList<AnnotatedMember> _jsonValueAccessors

Accessors (field or "getter" method) annotated with JsonValue

_ignoredPropertyNames

protected HashSet<String> _ignoredPropertyNames

Lazily collected list of properties that can be implicitly ignored during serialization; only updated when collecting information for deserialization purposes

_injectables

protected LinkedHashMap<Object, AnnotatedMember> _injectables

Lazily collected list of members that were annotated to indicate that they represent mutators for deserializer value injection.

_formatOverrides

protected com.fasterxml.jackson.annotation.JsonFormat.Value _formatOverrides

Lazily accessed information about POJO format overrides

Constructor Details

POJOPropertiesCollector

protected POJOPropertiesCollector(MapperConfig<?> config,
 boolean forSerialization,
 JavaType type,
 AnnotatedClass classDef,
 AccessorNamingStrategy accessorNaming)

Method Details

getConfig

public MapperConfig<?> getConfig()

getType

public JavaType getType()

isRecordType

public boolean isRecordType()

getClassDef

public AnnotatedClass getClassDef()

getAnnotationIntrospector

public AnnotationIntrospector getAnnotationIntrospector()

getProperties

public List<BeanPropertyDefinition> getProperties()

getPotentialCreators

public PotentialCreators getPotentialCreators()

getInjectables

public Map<Object, AnnotatedMember> getInjectables()

getJsonKeyAccessor

public AnnotatedMember getJsonKeyAccessor()

getJsonValueAccessor

public AnnotatedMember getJsonValueAccessor()

getAnyGetterField

public AnnotatedMember getAnyGetterField()

getAnyGetterMethod

public AnnotatedMember getAnyGetterMethod()

getAnySetterField

public AnnotatedMember getAnySetterField()

getAnySetterMethod

public AnnotatedMethod getAnySetterMethod()

getIgnoredPropertyNames

public Set<String> getIgnoredPropertyNames()

Accessor for set of properties that are explicitly marked to be ignored via per-property markers (but NOT class annotations).

getObjectIdInfo

public ObjectIdInfo getObjectIdInfo()

Accessor to find out whether type specified requires inclusion of Object Identifier.

getPropertyMap

protected Map<String, POJOPropertyBuilder> getPropertyMap()

getFormatOverrides

public com.fasterxml.jackson.annotation.JsonFormat.Value getFormatOverrides()

Since:

2.17

collectAll

protected void collectAll()

Internal method that will collect actual property information.

_putAnyGettersInTheEnd

private Map<String, POJOPropertyBuilder> _putAnyGettersInTheEnd(Map<String, POJOPropertyBuilder> sortedProps)

[databind#5215] JsonAnyGetter Serializer behavior change from 2.18.4 to 2.19.0 Put anyGetter in the end, before actual sorting further down _sortProperties(Map)

_addFields

protected void _addFields(Map<String, POJOPropertyBuilder> props)

Method for collecting basic information on all fields found

_addCreators

protected void _addCreators(Map<String, POJOPropertyBuilder> props)

_isDelegatingConstructor

private boolean _isDelegatingConstructor(PotentialCreator ctor)

_collectCreators

private List<PotentialCreator> _collectCreators(List<? extends AnnotatedWithParams> ctors)

_potentialCreator

private PotentialCreator _potentialCreator(AnnotatedWithParams ctor)

_removeDisabledCreators

private void _removeDisabledCreators(List<PotentialCreator> ctors)

_isDisabledCreator

private boolean _isDisabledCreator(PotentialCreator ctor)

_removeNonVisibleCreators

private void _removeNonVisibleCreators(List<PotentialCreator> ctors)

_removeNonFactoryStaticMethods

private void _removeNonFactoryStaticMethods(List<PotentialCreator> ctors,
 PotentialCreator primaryCreator)

_addExplicitlyAnnotatedCreators

private void _addExplicitlyAnnotatedCreators(PotentialCreators collector,
 List<PotentialCreator> ctors,
 Map<String, POJOPropertyBuilder> props,
 boolean skipPropsBased)

_isExplicitlyAnnotatedCreatorPropsBased

private boolean _isExplicitlyAnnotatedCreatorPropsBased(PotentialCreator ctor,
 Map<String, POJOPropertyBuilder> props,
 ConstructorDetector ctorDetector)

_addCreatorsWithAnnotatedNames

private void _addCreatorsWithAnnotatedNames(PotentialCreators collector,
 List<PotentialCreator> ctors,
 PotentialCreator primaryCtor)

_findCreatorsWithAnnotatedNames

private List<PotentialCreator> _findCreatorsWithAnnotatedNames(List<PotentialCreator> ctors)

_addImplicitConstructor

private boolean _addImplicitConstructor(PotentialCreators collector,
 List<PotentialCreator> ctors,
 Map<String, POJOPropertyBuilder> props)

_addCreatorParams

private void _addCreatorParams(Map<String, POJOPropertyBuilder> props,
 PotentialCreator ctor,
 List<POJOPropertyBuilder> creatorProps)

_addMethods

protected void _addMethods(Map<String, POJOPropertyBuilder> props)

Method for collecting basic information on all accessor methods found

_addGetterMethod

protected void _addGetterMethod(Map<String, POJOPropertyBuilder> props,
 AnnotatedMethod m)

_addSetterMethod

protected void _addSetterMethod(Map<String, POJOPropertyBuilder> props,
 AnnotatedMethod m)

_addInjectables

protected void _addInjectables(Map<String, POJOPropertyBuilder> props)

_doAddInjectable

protected void _doAddInjectable(com.fasterxml.jackson.annotation.JacksonInject.Value injectable,
 AnnotatedMember m)

_propNameFromSimple

private PropertyName _propNameFromSimple(String simpleName)

_checkRenameByField

private String _checkRenameByField(String implName)

_fixLeadingFieldNameCase

protected void _fixLeadingFieldNameCase(Map<String, POJOPropertyBuilder> props)

_firstOrSecondCharUpperCase

private boolean _firstOrSecondCharUpperCase(String name)

_removeUnwantedProperties

protected void _removeUnwantedProperties(Map<String, POJOPropertyBuilder> props)

Method called to get rid of candidate properties that are marked as ignored.

_removeUnwantedAccessors

protected void _removeUnwantedAccessors(Map<String, POJOPropertyBuilder> props)

Method called to further get rid of unwanted individual accessors, based on read/write settings and rules for "pulling in" accessors (or not).

_collectIgnorals

protected void _collectIgnorals(String name)

Helper method called to add explicitly ignored properties to a list of known ignored properties; this helps in proper reporting of errors.

_renameProperties

protected void _renameProperties(Map<String, POJOPropertyBuilder> props)

_renameUsing

protected void _renameUsing(Map<String, POJOPropertyBuilder> propMap,
 PropertyNamingStrategy naming)

_findFormatShape

private com.fasterxml.jackson.annotation.JsonFormat.Shape _findFormatShape()

Helper method called to check if given property should be renamed using PropertyNamingStrategies.

NOTE: copied+simplified version of BasicBeanDescription.findExpectedFormat().

Since:

2.16.2

_renameWithWrappers

protected void _renameWithWrappers(Map<String, POJOPropertyBuilder> props)

_sortProperties

protected void _sortProperties(Map<String, POJOPropertyBuilder> props)

_anyIndexed

private boolean _anyIndexed(Collection<POJOPropertyBuilder> props)

_resolveFieldVsGetter

protected boolean _resolveFieldVsGetter(List<AnnotatedMember> accessors)

Method that will be given a List with 2 or more accessors that may be in conflict: it will need to remove lower-priority accessors to leave just a single highest-priority accessor to use. If this succeeds method returns true, otherwise false.

NOTE: method will directly modify given List directly, regardless of whether it ultimately succeeds or not.

Returns:

True if seeming conflict was resolved and there only remains single accessor

reportProblem

protected void reportProblem(String msg,
 Object... args)

_property

protected POJOPropertyBuilder _property(Map<String, POJOPropertyBuilder> props,
 PropertyName name)

_property

protected POJOPropertyBuilder _property(Map<String, POJOPropertyBuilder> props,
 String implName)

_findNamingStrategy

private PropertyNamingStrategy _findNamingStrategy()

_replaceCreatorProperty

protected boolean _replaceCreatorProperty(List<POJOPropertyBuilder> creatorProperties,
 POJOPropertyBuilder prop)