Class BasicBeanDescription

java.lang.Object

tools.jackson.databind.BeanDescription

tools.jackson.databind.introspect.BasicBeanDescription

public class BasicBeanDescription
extends BeanDescription

Default BeanDescription implementation used by Jackson.

Although sub-classing is a theoretical possibility there are no known use cases for that, nor is such usage tested or supported. Separation from API is mostly to isolate some implementation details here and keep API simple.

Nested Class Summary

Nested classes/interfaces inherited from class BeanDescription

BeanDescription.EagerSupplier, BeanDescription.LazySupplier, BeanDescription.Supplier, BeanDescription.SupplierBase

Field Summary

Fields

Modifier and Type	Field	Description
protected com.fasterxml.jackson.annotation.JsonFormat.Value	_classFormat	Results of introspecting `@JsonFormat` configuration for class, if any.
protected final AnnotatedClass	_classInfo	Information collected about the class introspected.
protected final MapperConfig<?>	_config
protected Class<?>[]	_defaultViews
protected boolean	_defaultViewsResolved
protected final AnnotationIntrospector	_intr
protected ObjectIdInfo	_objectIdInfo	Details of Object Id to include, if any
protected final POJOPropertiesCollector	_propCollector	We will hold a reference to the collector in cases where information is lazily accessed and constructed; properties are only accessed when they are actually needed.
protected List<BeanPropertyDefinition>	_properties	Properties collected for the POJO; initialized as needed.
private static final Class<?>[]	NO_VIEWS

Fields inherited from class BeanDescription

_type

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BasicBeanDescription(MapperConfig<?> config, JavaType type, AnnotatedClass classDef)	Alternate constructor used in cases where property information is not needed, only class info.
protected	BasicBeanDescription(POJOPropertiesCollector coll)
protected	BasicBeanDescription(POJOPropertiesCollector coll, JavaType type, AnnotatedClass classDef)

Method Summary

Modifier and Type	Method	Description
protected List<BeanPropertyDefinition>	_properties()
boolean	addProperty(BeanPropertyDefinition def)
AnnotatedMember	findAnyGetter()	Method used to locate the method of introspected class that implements JsonAnyGetter.
AnnotatedMember	findAnySetterAccessor()	Method used to locate a mutator (settable field, or 2-argument set method) of introspected class that is annotated with JsonAnySetter (or equivalent annotation).
List<BeanPropertyDefinition>	findBackReferences()	Method for locating all back-reference properties (setters, fields) bean has
AnnotatedConstructor	findDefaultConstructor()	Method that will locate the no-arg constructor for this class, if it has one, and that constructor has not been marked as ignorable.
Class<?>[]	findDefaultViews()	Method for finding out if the POJO specifies default view(s) to use for properties, considering both per-type annotations and global default settings.
protected AnnotatedAndMetadata<AnnotatedMethod, com.fasterxml.jackson.annotation.JsonCreator.Mode>	findFactoryMethodMetadata(AnnotatedMethod am)
Map<Object, AnnotatedMember>	findInjectables()
AnnotatedMember	findJsonKeyAccessor()	Method for locating accessor (readable field, or "getter" method) that has JsonKey annotation, if any.
AnnotatedMember	findJsonValueAccessor()	Method for locating accessor (readable field, or "getter" method) that has JsonValue annotation, if any.
AnnotatedMethod	findMethod(String name, Class<?>[] paramTypes)
List<BeanPropertyDefinition>	findProperties()
BeanPropertyDefinition	findProperty(PropertyName name)
com.fasterxml.jackson.annotation.JsonInclude.Value	findPropertyInclusion(com.fasterxml.jackson.annotation.JsonInclude.Value defValue)	Method for determining whether null properties should be written out for a Bean of introspected type.
static BasicBeanDescription	forDeserialization(POJOPropertiesCollector coll)	Factory method to use for constructing an instance to use for building deserializers.
static BasicBeanDescription	forOtherUse(MapperConfig<?> config, JavaType type, AnnotatedClass ac)	Factory method to use for constructing an instance to use for purposes other than building serializers or deserializers; will only have information on class, not on properties.
static BasicBeanDescription	forSerialization(POJOPropertiesCollector coll)	Factory method to use for constructing an instance to use for building serializers.
Annotations	getClassAnnotations()	Method for accessing collection of annotations the bean class has.
AnnotatedClass	getClassInfo()	Method for accessing low-level information about Class this item describes.
List<AnnotatedConstructor>	getConstructors()	Helper method that will return all non-default constructors (that is, constructors that take one or more arguments) this class has.
List<AnnotatedAndMetadata<AnnotatedConstructor, com.fasterxml.jackson.annotation.JsonCreator.Mode>>	getConstructorsWithMode()	Method similar to BeanDescription.getConstructors() except will also introspect JsonCreator.Mode and filter out ones marked as not applicable and include mode (or lack thereof) for remaining constructors.
List<AnnotatedMethod>	getFactoryMethods()	Helper method that will check all static methods of the bean class that seem like factory methods eligible to be used as Creators.
List<AnnotatedAndMetadata<AnnotatedMethod, com.fasterxml.jackson.annotation.JsonCreator.Mode>>	getFactoryMethodsWithMode()	Method similar to BeanDescription.getFactoryMethods() but will return JsonCreator.Mode metadata along with qualifying factory method candidates.
Set<String>	getIgnoredPropertyNames()
ObjectIdInfo	getObjectIdInfo()	Accessor for getting information about Object Id expected to be used for this POJO type, if any.
PotentialCreators	getPotentialCreators()	Method that is replacing earlier Creator introspection access methods.
boolean	hasKnownClassAnnotations()	Method for checking whether class being described has any annotations recognized by registered annotation introspector.
boolean	hasProperty(PropertyName name)
Object	instantiateBean(boolean fixAccess)	Method called to create a "default instance" of the bean, currently only needed for obtaining default field values which may be used for suppressing serialization of fields that have "not changed".
protected boolean	isFactoryMethod(AnnotatedMethod am)
boolean	removeProperty(String propName)	Method that can be used to prune unwanted properties, during construction of serializers and deserializers.
BeanDescription.Supplier	supplier()	Method for constructing a supplier for this bean description instance: sometimes needed when code expects supplier, not description instance.

Methods inherited from class BeanDescription

getBeanClass, getType, isNonStaticInnerClass, isRecordType

Methods inherited from class Object

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

Field Details

NO_VIEWS

private static final Class<?>[] NO_VIEWS

_propCollector

protected final POJOPropertiesCollector _propCollector

We will hold a reference to the collector in cases where information is lazily accessed and constructed; properties are only accessed when they are actually needed.

_config

protected final MapperConfig<?> _config

_intr

protected final AnnotationIntrospector _intr

_classInfo

protected final AnnotatedClass _classInfo

Information collected about the class introspected.

_defaultViews

protected Class<?>[] _defaultViews

_defaultViewsResolved

protected boolean _defaultViewsResolved

_properties

protected List<BeanPropertyDefinition> _properties

Properties collected for the POJO; initialized as needed.

_objectIdInfo

protected ObjectIdInfo _objectIdInfo

Details of Object Id to include, if any

_classFormat

protected transient com.fasterxml.jackson.annotation.JsonFormat.Value _classFormat

Results of introspecting `@JsonFormat` configuration for class, if any.

Since:

3.0

Constructor Details

BasicBeanDescription

protected BasicBeanDescription(POJOPropertiesCollector coll,
 JavaType type,
 AnnotatedClass classDef)

BasicBeanDescription

protected BasicBeanDescription(MapperConfig<?> config,
 JavaType type,
 AnnotatedClass classDef)

Alternate constructor used in cases where property information is not needed, only class info.

BasicBeanDescription

protected BasicBeanDescription(POJOPropertiesCollector coll)

Method Details

forDeserialization

public static BasicBeanDescription forDeserialization(POJOPropertiesCollector coll)

Factory method to use for constructing an instance to use for building deserializers.

forSerialization

public static BasicBeanDescription forSerialization(POJOPropertiesCollector coll)

Factory method to use for constructing an instance to use for building serializers.

forOtherUse

public static BasicBeanDescription forOtherUse(MapperConfig<?> config,
 JavaType type,
 AnnotatedClass ac)

Factory method to use for constructing an instance to use for purposes other than building serializers or deserializers; will only have information on class, not on properties.

_properties

protected List<BeanPropertyDefinition> _properties()

supplier

public BeanDescription.Supplier supplier()

Description copied from class: BeanDescription

Method for constructing a supplier for this bean description instance: sometimes needed when code expects supplier, not description instance.

Specified by:

supplier in class BeanDescription

removeProperty

public boolean removeProperty(String propName)

Method that can be used to prune unwanted properties, during construction of serializers and deserializers. Use with utmost care, if at all...

addProperty

public boolean addProperty(BeanPropertyDefinition def)

hasProperty

public boolean hasProperty(PropertyName name)

findProperty

public BeanPropertyDefinition findProperty(PropertyName name)

getClassInfo

public AnnotatedClass getClassInfo()

Description copied from class: BeanDescription

Method for accessing low-level information about Class this item describes.

Specified by:

getClassInfo in class BeanDescription

getObjectIdInfo

public ObjectIdInfo getObjectIdInfo()

Description copied from class: BeanDescription

Accessor for getting information about Object Id expected to be used for this POJO type, if any.

Specified by:

getObjectIdInfo in class BeanDescription

findProperties

public List<BeanPropertyDefinition> findProperties()

Specified by:

findProperties in class BeanDescription

Returns:

Ordered Map with logical property name as key, and matching getter method as value.

findJsonKeyAccessor

public AnnotatedMember findJsonKeyAccessor()

Description copied from class: BeanDescription

Method for locating accessor (readable field, or "getter" method) that has JsonKey annotation, if any. If multiple ones are found, an error is reported by throwing IllegalArgumentException

Overrides:

findJsonKeyAccessor in class BeanDescription

findJsonValueAccessor

public AnnotatedMember findJsonValueAccessor()

Description copied from class: BeanDescription

Method for locating accessor (readable field, or "getter" method) that has JsonValue annotation, if any. If multiple ones are found, an error is reported by throwing IllegalArgumentException

Specified by:

findJsonValueAccessor in class BeanDescription

getIgnoredPropertyNames

public Set<String> getIgnoredPropertyNames()

Specified by:

getIgnoredPropertyNames in class BeanDescription

hasKnownClassAnnotations

public boolean hasKnownClassAnnotations()

Description copied from class: BeanDescription

Method for checking whether class being described has any annotations recognized by registered annotation introspector.

Specified by:

hasKnownClassAnnotations in class BeanDescription

getClassAnnotations

public Annotations getClassAnnotations()

Description copied from class: BeanDescription

Method for accessing collection of annotations the bean class has.

Specified by:

getClassAnnotations in class BeanDescription

findDefaultConstructor

public AnnotatedConstructor findDefaultConstructor()

Description copied from class: BeanDescription

Method that will locate the no-arg constructor for this class, if it has one, and that constructor has not been marked as ignorable.

Specified by:

findDefaultConstructor in class BeanDescription

findAnySetterAccessor

public AnnotatedMember findAnySetterAccessor()
                                      throws IllegalArgumentException

Description copied from class: BeanDescription

Method used to locate a mutator (settable field, or 2-argument set method) of introspected class that is annotated with JsonAnySetter (or equivalent annotation). If no such mutator exists null is returned. If more than one are found an exception is thrown. Additional checks are also made to see that method signature is acceptable: needs to take 2 arguments, first one String or Object; second any can be any type.

Specified by:

findAnySetterAccessor in class BeanDescription

Throws:

IllegalArgumentException

findInjectables

public Map<Object, AnnotatedMember> findInjectables()

Specified by:

findInjectables in class BeanDescription

getConstructors

public List<AnnotatedConstructor> getConstructors()

Description copied from class: BeanDescription

Helper method that will return all non-default constructors (that is, constructors that take one or more arguments) this class has.

Specified by:

getConstructors in class BeanDescription

getConstructorsWithMode

public List<AnnotatedAndMetadata<AnnotatedConstructor, com.fasterxml.jackson.annotation.JsonCreator.Mode>> getConstructorsWithMode()

Description copied from class: BeanDescription

Method similar to BeanDescription.getConstructors() except will also introspect JsonCreator.Mode and filter out ones marked as not applicable and include mode (or lack thereof) for remaining constructors.

Note that no other filtering (regarding visibility or other annotations) is performed

Specified by:

getConstructorsWithMode in class BeanDescription

getPotentialCreators

public PotentialCreators getPotentialCreators()

Description copied from class: BeanDescription

Method that is replacing earlier Creator introspection access methods.

Specified by:

getPotentialCreators in class BeanDescription

Returns:

Container for introspected Creator candidates, if any

instantiateBean

public Object instantiateBean(boolean fixAccess)

Description copied from class: BeanDescription

Method called to create a "default instance" of the bean, currently only needed for obtaining default field values which may be used for suppressing serialization of fields that have "not changed".

Specified by:

instantiateBean in class BeanDescription

Parameters:

fixAccess - If true, method is allowed to fix access to the default constructor (to be able to call non-public constructor); if false, has to use constructor as is.

Returns:

Instance of class represented by this descriptor, if suitable default constructor was found; null otherwise.

findMethod

public AnnotatedMethod findMethod(String name,
 Class<?>[] paramTypes)

Specified by:

findMethod in class BeanDescription

findDefaultViews

public Class<?>[] findDefaultViews()

Description copied from class: BeanDescription

Method for finding out if the POJO specifies default view(s) to use for properties, considering both per-type annotations and global default settings.

Specified by:

findDefaultViews in class BeanDescription

findPropertyInclusion

public com.fasterxml.jackson.annotation.JsonInclude.Value findPropertyInclusion(com.fasterxml.jackson.annotation.JsonInclude.Value defValue)

Method for determining whether null properties should be written out for a Bean of introspected type. This is based on global feature (lowest priority, passed as argument) and per-class annotation (highest priority).

Specified by:

findPropertyInclusion in class BeanDescription

findAnyGetter

public AnnotatedMember findAnyGetter()
                              throws IllegalArgumentException

Method used to locate the method of introspected class that implements JsonAnyGetter. If no such method exists null is returned. If more than one are found, an exception is thrown.

Specified by:

findAnyGetter in class BeanDescription

Throws:

IllegalArgumentException

findBackReferences

public List<BeanPropertyDefinition> findBackReferences()

Description copied from class: BeanDescription

Method for locating all back-reference properties (setters, fields) bean has

Specified by:

findBackReferences in class BeanDescription

getFactoryMethods

public List<AnnotatedMethod> getFactoryMethods()

Description copied from class: BeanDescription

Helper method that will check all static methods of the bean class that seem like factory methods eligible to be used as Creators. This requires that the static method:

1. Returns type compatible with bean type (same or subtype)
2. Is recognized from either explicit annotation (usually @JsonCreator OR naming: names valueOf() and fromString() are recognized but only for 1-argument factory methods, and in case of fromString() argument type must further be either String or CharSequence.

Note that caller typically applies further checks for things like visibility.

Specified by:

getFactoryMethods in class BeanDescription

Returns:

List of static methods considered as possible Factory methods

getFactoryMethodsWithMode

public List<AnnotatedAndMetadata<AnnotatedMethod, com.fasterxml.jackson.annotation.JsonCreator.Mode>> getFactoryMethodsWithMode()

Description copied from class: BeanDescription

Method similar to BeanDescription.getFactoryMethods() but will return JsonCreator.Mode metadata along with qualifying factory method candidates.

Specified by:

getFactoryMethodsWithMode in class BeanDescription

isFactoryMethod

protected boolean isFactoryMethod(AnnotatedMethod am)

findFactoryMethodMetadata

protected AnnotatedAndMetadata<AnnotatedMethod, com.fasterxml.jackson.annotation.JsonCreator.Mode> findFactoryMethodMetadata(AnnotatedMethod am)