com.fasterxml.jackson.databind.deser.impl

Class BeanPropertyMap

java.lang.Object

com.fasterxml.jackson.databind.deser.impl.BeanPropertyMap

All Implemented Interfaces:

Serializable, Iterable<SettableBeanProperty>

public class BeanPropertyMap
extends Object
implements Iterable<SettableBeanProperty>, Serializable

Helper class used for storing mapping from property name to SettableBeanProperty instances.

Note that this class is used instead of generic HashMap for bit of performance gain (and some memory savings): although default implementation is very good for generic use cases, it can be streamlined a bit for specific use case we have. Even relatively small improvements matter since this is directly on the critical path during deserialization, as it is done for each and every POJO property deserialized.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	_caseInsensitive

Constructor Summary

Constructors

Constructor and Description
BeanPropertyMap(boolean caseInsensitive, Collection<SettableBeanProperty> props)

Method Summary

Modifier and Type	Method and Description
protected SettableBeanProperty	_rename(SettableBeanProperty prop, NameTransformer xf)
BeanPropertyMap	assignIndexes()
static BeanPropertyMap	construct(Collection<SettableBeanProperty> props, boolean caseInsensitive)
SettableBeanProperty	find(int index)
SettableBeanProperty	find(String key)
boolean	findDeserializeAndSet(com.fasterxml.jackson.core.JsonParser p, DeserializationContext ctxt, Object bean, String key) Convenience method that tries to find property with given name, and if it is found, call SettableBeanProperty.deserializeAndSet(com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.DeserializationContext, java.lang.Object) on it, and return true; or, if not found, return false.
SettableBeanProperty[]	getPropertiesInInsertionOrder() Method that will re-create initial insertion-ordering of properties contained in this map.
protected String	getPropertyName(SettableBeanProperty prop)
protected void	init(Collection<SettableBeanProperty> props)
Iterator<SettableBeanProperty>	iterator() Accessor for traversing over all contained properties.
void	remove(SettableBeanProperty propToRm) Specialized method for removing specified existing entry.
BeanPropertyMap	renameAll(NameTransformer transformer) Factory method for constructing a map where all entries use given prefix
void	replace(SettableBeanProperty newProp) Specialized method that can be used to replace an existing entry (note: entry MUST exist; otherwise exception is thrown) with specified replacement.
int	size()
String	toString()
BeanPropertyMap	withProperty(SettableBeanProperty newProp) Fluent copy method that creates a new instance that is a copy of this instance except for one additional property that is passed as the argument.
protected void	wrapAndThrow(Throwable t, Object bean, String fieldName, DeserializationContext ctxt)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

_caseInsensitive

protected final boolean _caseInsensitive

Since:

2.5

Constructor Detail

BeanPropertyMap

public BeanPropertyMap(boolean caseInsensitive,
                       Collection<SettableBeanProperty> props)

Method Detail

init

protected void init(Collection<SettableBeanProperty> props)

construct

public static BeanPropertyMap construct(Collection<SettableBeanProperty> props,
                                        boolean caseInsensitive)

Since:

2.6

withProperty

public BeanPropertyMap withProperty(SettableBeanProperty newProp)

Fluent copy method that creates a new instance that is a copy of this instance except for one additional property that is passed as the argument. Note that method does not modify this instance but constructs and returns a new one.

Since:

2.0

assignIndexes

public BeanPropertyMap assignIndexes()

renameAll

public BeanPropertyMap renameAll(NameTransformer transformer)

Factory method for constructing a map where all entries use given prefix

replace

public void replace(SettableBeanProperty newProp)

Specialized method that can be used to replace an existing entry (note: entry MUST exist; otherwise exception is thrown) with specified replacement.

iterator

public Iterator<SettableBeanProperty> iterator()

Accessor for traversing over all contained properties.

Specified by:

iterator in interface Iterable<SettableBeanProperty>

getPropertiesInInsertionOrder

public SettableBeanProperty[] getPropertiesInInsertionOrder()

Method that will re-create initial insertion-ordering of properties contained in this map. Note that if properties have been removed, array may contain nulls; otherwise it should be consecutive.

Since:

2.1

getPropertyName

protected final String getPropertyName(SettableBeanProperty prop)

find

public SettableBeanProperty find(int index)

Since:

2.3

find

public SettableBeanProperty find(String key)

size

public int size()

remove

public void remove(SettableBeanProperty propToRm)

Specialized method for removing specified existing entry. NOTE: entry MUST exist, otherwise an exception is thrown.

findDeserializeAndSet

public boolean findDeserializeAndSet(com.fasterxml.jackson.core.JsonParser p,
                                     DeserializationContext ctxt,
                                     Object bean,
                                     String key)
                              throws IOException

Convenience method that tries to find property with given name, and if it is found, call SettableBeanProperty.deserializeAndSet(com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.DeserializationContext, java.lang.Object) on it, and return true; or, if not found, return false. Note, too, that if deserialization is attempted, possible exceptions are wrapped if and as necessary, so caller need not handle those.

Throws:

IOException

Since:

2.5

toString

public String toString()

Overrides:

toString in class Object

_rename

protected SettableBeanProperty _rename(SettableBeanProperty prop,
                                       NameTransformer xf)

wrapAndThrow

protected void wrapAndThrow(Throwable t,
                            Object bean,
                            String fieldName,
                            DeserializationContext ctxt)
                     throws IOException

Throws:

IOException