Modifier and Type	Class and Description
pack-priv static class	TypeBindings.AsKey Helper type used to allow caching of generic types
pack-priv static class	TypeBindings.TypeParamStash Helper class that contains simple logic for avoiding repeated lookups via `Class#getTypeParameters()` as that can be a performance issue for some use cases (wasteful, usually one-off or not reusing mapper).

Modifier and Type	Field and Description
private final int	_hashCode
private final String[]	_names Array of type (type variable) names.
private final JavaType[]	_types Types matching names
private final String[]	_unboundVariables Names of potentially unresolved type variables.
private static final TypeBindings	EMPTY
private static final String[]	NO_STRINGS
private static final JavaType[]	NO_TYPES
private static final long	serialVersionUID

Access	Constructor and Description
private	TypeBindings(String[] names, JavaType[] types, String[] uvars)

Method Summary

Modifier and Type	Method and Description
public Object	Returns: An object which can be used as a key in TypeFactory, or `null` if no key can be created. asKey(Class<?> rawBase) Factory method that will create an object that can be used as a key for caching purposes by `TypeFactory`
public static TypeBindings	create(Class<?> erasedType, List<JavaType> typeList) Factory method for constructing bindings for given class using specified type parameters.
public static TypeBindings	create(Class<?> erasedType, JavaType[] types)
public static TypeBindings	create(Class<?> erasedType, JavaType typeArg1)
public static TypeBindings	create(Class<?> erasedType, JavaType typeArg1, JavaType typeArg2)
public static TypeBindings	create(List<String> names, List<JavaType> types) Factory method for constructing bindings given names and associated types.
public static TypeBindings	createIfNeeded(Class<?> erasedType, JavaType typeArg1) Alternate factory method that may be called if it is possible that type does or does not require type parameters; this is mostly useful for collection- and map-like types.
public static TypeBindings	createIfNeeded(Class<?> erasedType, JavaType[] types) Alternate factory method that may be called if it is possible that type does or does not require type parameters; this is mostly useful for collection- and map-like types.
public static TypeBindings	emptyBindings()
public boolean	equals(Object the reference object with which to compare. o) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public JavaType	findBoundType(String name) Find type bound to specified name, if there is one; returns bound type if so, null if not.
public String	getBoundName(int index)
public JavaType	getBoundType(int index) Get the type bound to the variable at `index`.
public JavaType	getBoundTypeOrNull(int index) Get the type bound to the variable at `index`.
public List<JavaType>	getTypeParameters() Accessor for getting bound types in declaration order
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
public boolean	hasUnbound(String name)
private boolean	invalidCacheKey() Returns true if a shallow search of the type bindings includes a placeholder type which uses reference equality, thus cannot produce cache hits.
public boolean	isEmpty()
protected Object	readResolve()
public int	size() Returns number of bindings contained
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
protected JavaType[]	typeParameterArray()
public TypeBindings	withoutVariable(String name) Create a new instance with the same bindings as this object, except with the given variable removed.
public TypeBindings	withUnboundVariable(String name) Method for creating an instance that has same bindings as this object, plus an indicator for additional type variable that may be unbound within this context; this is needed to resolve recursive self-references.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

_hashCode	back to summary
private final int _hashCode

_names	back to summary
private final String[] _names Array of type (type variable) names.

_types	back to summary
private final JavaType[] _types Types matching names

_unboundVariables	back to summary
private final String[] _unboundVariables Names of potentially unresolved type variables. Since 2.3

_unboundVariables

back to summary

private final String[] _unboundVariables

Names of potentially unresolved type variables.

Since: 2.3

EMPTY	back to summary
private static final TypeBindings EMPTY

NO_STRINGS	back to summary
private static final String[] NO_STRINGS

NO_TYPES	back to summary
private static final JavaType[] NO_TYPES

serialVersionUID	back to summary
private static final long serialVersionUID

Constructor Detail

TypeBindings	back to summary
private TypeBindings(String[] names, JavaType[] types, String[] uvars)

Method Detail

asKey back to summary

asKey	back to summary
public Object asKey(Class<?> rawBase) Factory method that will create an object that can be used as a key for caching purposes by `TypeFactory` Returns:Object An object which can be used as a key in TypeFactory, or `null` if no key can be created. Since 2.8

public Object asKey(Class<?> rawBase)

Factory method that will create an object that can be used as a key for caching purposes by TypeFactory

Returns:Object: An object which can be used as a key in TypeFactory, or null if no key can be created.
Since: 2.8

create	back to summary
public static TypeBindings create(Class<?> erasedType, List<JavaType> typeList) Factory method for constructing bindings for given class using specified type parameters.

create	back to summary
public static TypeBindings create(Class<?> erasedType, JavaType[] types)

create	back to summary
public static TypeBindings create(Class<?> erasedType, JavaType typeArg1)

create	back to summary
public static TypeBindings create(Class<?> erasedType, JavaType typeArg1, JavaType typeArg2)

create	back to summary
public static TypeBindings create(List<String> names, List<JavaType> types) Factory method for constructing bindings given names and associated types.

createIfNeeded	back to summary
public static TypeBindings createIfNeeded(Class<?> erasedType, JavaType typeArg1) Alternate factory method that may be called if it is possible that type does or does not require type parameters; this is mostly useful for collection- and map-like types.

createIfNeeded	back to summary
public static TypeBindings createIfNeeded(Class<?> erasedType, JavaType[] types) Alternate factory method that may be called if it is possible that type does or does not require type parameters; this is mostly useful for collection- and map-like types.

emptyBindings	back to summary
public static TypeBindings emptyBindings()

equals back to summary

equals	back to summary
public boolean equals(Object o) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Parameters o:Object the reference object with which to compare. Returns:boolean `true` if this object is the same as the obj argument; `false` otherwise. Annotations @Override

public boolean equals(Object o)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

o:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

findBoundType	back to summary
public JavaType findBoundType(String name) Find type bound to specified name, if there is one; returns bound type if so, null if not.

getBoundName	back to summary
public String getBoundName(int index)

getBoundType	back to summary
public JavaType getBoundType(int index) Get the type bound to the variable at `index`. If the type is `not bound` but the index is within `size()` constraints, this method returns `TypeFactory#unknownType()` for compatibility. If the index is out of `size()` constraints, this method will still return `null`.

getBoundTypeOrNull back to summary

getBoundTypeOrNull	back to summary
public JavaType getBoundTypeOrNull(int index) Get the type bound to the variable at `index`. If the type is `not bound` or the index is within `size()` constraints, this method returns `null`. Since 2.16

public JavaType getBoundTypeOrNull(int index)

Get the type bound to the variable at index. If the type is not bound or the index is within size() constraints, this method returns null.

Since: 2.16

getTypeParameters	back to summary
public List<JavaType> getTypeParameters() Accessor for getting bound types in declaration order

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object

Annotations

@Override

hasUnbound	back to summary
public boolean hasUnbound(String name) Since 2.3

invalidCacheKey	back to summary
private boolean invalidCacheKey() Returns true if a shallow search of the type bindings includes a placeholder type which uses reference equality, thus cannot produce cache hits. This is an optimization to avoid churning memory in the cache unnecessarily. Note that it is still possible for nested type information to contain such placeholder types (see NestedTypes1604Test for an example) so it's vital that they produce a distribution of hashCode values, even if they may push reusable data out of the cache.

invalidCacheKey

back to summary

private boolean invalidCacheKey()

Returns true if a shallow search of the type bindings includes a placeholder type which uses reference equality, thus cannot produce cache hits. This is an optimization to avoid churning memory in the cache unnecessarily. Note that it is still possible for nested type information to contain such placeholder types (see NestedTypes1604Test for an example) so it's vital that they produce a distribution of hashCode values, even if they may push reusable data out of the cache.

isEmpty	back to summary
public boolean isEmpty()

readResolve	back to summary
protected Object readResolve()

size	back to summary
public int size() Returns number of bindings contained

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Returns:String a string representation of the object Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@Override

typeParameterArray	back to summary
protected JavaType[] typeParameterArray()

withoutVariable	back to summary
public TypeBindings withoutVariable(String name) Create a new instance with the same bindings as this object, except with the given variable removed. This is used to create generic types that are "partially raw", i.e. only have some variables bound. Since 2.16

withoutVariable

back to summary

public TypeBindings withoutVariable(String name)

Create a new instance with the same bindings as this object, except with the given variable removed. This is used to create generic types that are "partially raw", i.e. only have some variables bound.

Since: 2.16

withUnboundVariable	back to summary
public TypeBindings withUnboundVariable(String name) Method for creating an instance that has same bindings as this object, plus an indicator for additional type variable that may be unbound within this context; this is needed to resolve recursive self-references.

com.fasterxml.jackson.databind.type back to summary

pack-priv final Class TypeBindings.AsKey

Class Inheritance

extends Object

java.lang.Object
com.fasterxml.jackson.databind.type.TypeBindings.AsKey

Helper type used to allow caching of generic types

Since: 2.8

Field Summary

Modifier and Type	Field and Description
private final int	_hash
private final JavaType[]	_params
private final Class<?>	_raw

Constructor Summary

Access	Constructor and Description
public	AsKey(Class<?> raw, JavaType[] params, int hash)

Method Summary

Modifier and Type	Method and Description
public boolean	equals(Object the reference object with which to compare. o) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

_hash	back to summary
private final int _hash

_params	back to summary
private final JavaType[] _params

_raw	back to summary
private final Class<?> _raw

Constructor Detail

AsKey	back to summary
public AsKey(Class<?> raw, JavaType[] params, int hash)

Method Detail

equals back to summary

equals	back to summary
public boolean equals(Object o) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Parameters o:Object the reference object with which to compare. Returns:boolean `true` if this object is the same as the obj argument; `false` otherwise. Annotations @Override

public boolean equals(Object o)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

Parameters

o:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object

Annotations

@Override

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Returns:String a string representation of the object Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@Override

com.fasterxml.jackson.databind.type back to summary

pack-priv Class TypeBindings.TypeParamStash

Class Inheritance

extends Object

java.lang.Object
com.fasterxml.jackson.databind.type.TypeBindings.TypeParamStash

Helper class that contains simple logic for avoiding repeated lookups via Class#getTypeParameters() as that can be a performance issue for some use cases (wasteful, usually one-off or not reusing mapper). Partly isolated to avoid initialization for cases where no generic types are used.

Field Summary

Modifier and Type	Field and Description
private static final TypeVariable<?>[]	VARS_ABSTRACT_LIST
private static final TypeVariable<?>[]	VARS_ARRAY_LIST
private static final TypeVariable<?>[]	VARS_COLLECTION
private static final TypeVariable<?>[]	VARS_HASH_MAP
private static final TypeVariable<?>[]	VARS_ITERABLE
private static final TypeVariable<?>[]	VARS_LINKED_HASH_MAP
private static final TypeVariable<?>[]	VARS_LIST
private static final TypeVariable<?>[]	VARS_MAP

Constructor Summary

Access	Constructor and Description
pack-priv	TypeParamStash()

Method Summary

Modifier and Type	Method and Description
public static TypeVariable<?>[]	paramsFor1(Class<?> erasedType)
public static TypeVariable<?>[]	paramsFor2(Class<?> erasedType)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

VARS_ABSTRACT_LIST	back to summary
private static final TypeVariable<?>[] VARS_ABSTRACT_LIST

VARS_ARRAY_LIST	back to summary
private static final TypeVariable<?>[] VARS_ARRAY_LIST

VARS_COLLECTION	back to summary
private static final TypeVariable<?>[] VARS_COLLECTION

VARS_HASH_MAP	back to summary
private static final TypeVariable<?>[] VARS_HASH_MAP

VARS_ITERABLE	back to summary
private static final TypeVariable<?>[] VARS_ITERABLE

VARS_LINKED_HASH_MAP	back to summary
private static final TypeVariable<?>[] VARS_LINKED_HASH_MAP

VARS_LIST	back to summary
private static final TypeVariable<?>[] VARS_LIST

VARS_MAP	back to summary
private static final TypeVariable<?>[] VARS_MAP

Constructor Detail

TypeParamStash	back to summary
pack-priv TypeParamStash()

Method Detail

paramsFor1	back to summary
public static TypeVariable<?>[] paramsFor1(Class<?> erasedType)

paramsFor2	back to summary
public static TypeVariable<?>[] paramsFor2(Class<?> erasedType)

public Class TypeBindings

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class TypeBindings.AsKey

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class TypeBindings.TypeParamStash

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail