AnnotationIntrospectorPair.java
package tools.jackson.databind.introspect;
import java.lang.annotation.Annotation;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import java.util.Optional;
import com.fasterxml.jackson.annotation.*;
import tools.jackson.core.Version;
import tools.jackson.databind.*;
import tools.jackson.databind.annotation.JsonPOJOBuilder;
import tools.jackson.databind.annotation.JsonSerialize;
import tools.jackson.databind.cfg.MapperConfig;
import tools.jackson.databind.jsontype.NamedType;
import tools.jackson.databind.ser.BeanPropertyWriter;
import tools.jackson.databind.util.ClassUtil;
import tools.jackson.databind.util.NameTransformer;
/**
* Helper class that allows using 2 introspectors such that one
* introspector acts as the primary one to use; and second one
* as a fallback used if the primary does not provide conclusive
* or useful result for a method.
*<p>
* An obvious consequence of priority is that it is easy to construct
* longer chains of introspectors by linking multiple pairs.
* Currently most likely combination is that of using the default
* Jackson provider, along with JAXB annotation introspector.
*/
public class AnnotationIntrospectorPair
extends AnnotationIntrospector
implements java.io.Serializable
{
private static final long serialVersionUID = 1L;
protected final AnnotationIntrospector _primary, _secondary;
public AnnotationIntrospectorPair(AnnotationIntrospector p, AnnotationIntrospector s)
{
_primary = p;
_secondary = s;
}
@Override
public Version version() {
return _primary.version();
}
/**
* Helper method for constructing a Pair from two given introspectors (if
* neither is null); or returning non-null introspector if one is null
* (and return just null if both are null)
*/
public static AnnotationIntrospector create(AnnotationIntrospector primary,
AnnotationIntrospector secondary)
{
if (primary == null) {
return secondary;
}
if (secondary == null) {
return primary;
}
return new AnnotationIntrospectorPair(primary, secondary);
}
@Override
public Collection<AnnotationIntrospector> allIntrospectors() {
return allIntrospectors(new ArrayList<AnnotationIntrospector>());
}
@Override
public Collection<AnnotationIntrospector> allIntrospectors(Collection<AnnotationIntrospector> result)
{
_primary.allIntrospectors(result);
_secondary.allIntrospectors(result);
return result;
}
// // // Generic annotation properties, lookup
@Override
public boolean isAnnotationBundle(Annotation ann) {
return _primary.isAnnotationBundle(ann) || _secondary.isAnnotationBundle(ann);
}
/*
/**********************************************************************
/* General class annotations
/**********************************************************************
*/
@Override
public PropertyName findRootName(MapperConfig<?> config, AnnotatedClass ac)
{
return PropertyName.merge(_primary.findRootName(config, ac),
_secondary.findRootName(config, ac));
}
@Override
public JsonIgnoreProperties.Value findPropertyIgnoralByName(MapperConfig<?> config, Annotated a)
{
JsonIgnoreProperties.Value v2 = _secondary.findPropertyIgnoralByName(config, a);
JsonIgnoreProperties.Value v1 = _primary.findPropertyIgnoralByName(config, a);
return (v2 == null) // shouldn't occur but
? v1 : v2.withOverrides(v1);
}
@Override
public JsonIncludeProperties.Value findPropertyInclusionByName(MapperConfig<?> config, Annotated a)
{
JsonIncludeProperties.Value v2 = _secondary.findPropertyInclusionByName(config, a);
JsonIncludeProperties.Value v1 = _primary.findPropertyInclusionByName(config, a);
return (v2 == null) // shouldn't occur but
? v1 : v2.withOverrides(v1);
}
@Override
public Boolean isIgnorableType(MapperConfig<?> config, AnnotatedClass ac)
{
Boolean result = _primary.isIgnorableType(config, ac);
if (result == null) {
result = _secondary.isIgnorableType(config, ac);
}
return result;
}
@Override
public Object findFilterId(MapperConfig<?> config, Annotated ann)
{
Object id = _primary.findFilterId(config, ann);
if (id == null) {
id = _secondary.findFilterId(config, ann);
}
return id;
}
@Override
public Object findNamingStrategy(MapperConfig<?> config, AnnotatedClass ac)
{
Object str = _primary.findNamingStrategy(config, ac);
if (str == null) {
str = _secondary.findNamingStrategy(config, ac);
}
return str;
}
@Override
public Object findEnumNamingStrategy(MapperConfig<?> config, AnnotatedClass ac)
{
Object str = _primary.findEnumNamingStrategy(config, ac);
if (str == null) {
str = _secondary.findEnumNamingStrategy(config, ac);
}
return str;
}
@Override
public String findClassDescription(MapperConfig<?> config, AnnotatedClass ac) {
String str = _primary.findClassDescription(config, ac);
if ((str == null) || str.isEmpty()) {
str = _secondary.findClassDescription(config, ac);
}
return str;
}
/*
/**********************************************************************
/* Property auto-detection
/**********************************************************************
*/
@Override
public VisibilityChecker findAutoDetectVisibility(MapperConfig<?> config,
AnnotatedClass ac, VisibilityChecker checker)
{
/* Note: to have proper priorities, we must actually call delegatees
* in reverse order:
*/
checker = _secondary.findAutoDetectVisibility(config, ac, checker);
return _primary.findAutoDetectVisibility(config, ac, checker);
}
/*
/**********************************************************************
/* Type handling
/**********************************************************************
*/
@Override
public JsonTypeInfo.Value findPolymorphicTypeInfo(MapperConfig<?> config,
Annotated ann)
{
JsonTypeInfo.Value v = _primary.findPolymorphicTypeInfo(config, ann);
if (v == null) {
v = _secondary.findPolymorphicTypeInfo(config, ann);
}
return v;
}
@Override
public Object findTypeResolverBuilder(MapperConfig<?> config,
Annotated ann) {
Object b = _primary.findTypeResolverBuilder(config, ann);
if (b == null) {
b = _secondary.findTypeResolverBuilder(config, ann);
}
return b;
}
@Override
public Object findTypeIdResolver(MapperConfig<?> config, Annotated ann) {
Object b = _primary.findTypeIdResolver(config, ann);
if (b == null) {
b = _secondary.findTypeIdResolver(config, ann);
}
return b;
}
/*
@Override
public TypeResolverBuilder<?> findPropertyTypeResolver(MapperConfig<?> config,
Annotated ann, JavaType baseType, JsonTypeInfo.Value typeInfo)
{
TypeResolverBuilder<?> b = _primary.findPropertyTypeResolver(config, ann, baseType, typeInfo);
if (b == null) {
b = _secondary.findPropertyTypeResolver(config, ann, baseType, typeInfo);
}
return b;
}
@Override
public TypeResolverBuilder<?> findPropertyContentTypeResolver(MapperConfig<?> config,
Annotated ann, JavaType baseType, JsonTypeInfo.Value typeInfo)
{
TypeResolverBuilder<?> b = _primary.findPropertyContentTypeResolver(config, ann, baseType, typeInfo);
if (b == null) {
b = _secondary.findPropertyContentTypeResolver(config, ann, baseType, typeInfo);
}
return b;
}
*/
@Override
public List<NamedType> findSubtypes(MapperConfig<?> config, Annotated a)
{
List<NamedType> types1 = _primary.findSubtypes(config, a);
List<NamedType> types2 = _secondary.findSubtypes(config, a);
if (types1 == null || types1.isEmpty()) return types2;
if (types2 == null || types2.isEmpty()) return types1;
ArrayList<NamedType> result = new ArrayList<NamedType>(types1.size() + types2.size());
result.addAll(types1);
result.addAll(types2);
return result;
}
@Override
public String findTypeName(MapperConfig<?> config, AnnotatedClass ac)
{
String name = _primary.findTypeName(config, ac);
if (name == null || name.length() == 0) {
name = _secondary.findTypeName(config, ac);
}
return name;
}
/*
/**********************************************************************
/* General member (field, method/constructor) annotations
/**********************************************************************
*/
@Override
public ReferenceProperty findReferenceType(MapperConfig<?> config, AnnotatedMember member) {
ReferenceProperty r = _primary.findReferenceType(config, member);
return (r == null) ? _secondary.findReferenceType(config, member) : r;
}
@Override
public NameTransformer findUnwrappingNameTransformer(MapperConfig<?> config, AnnotatedMember member) {
NameTransformer r = _primary.findUnwrappingNameTransformer(config, member);
return (r == null) ? _secondary.findUnwrappingNameTransformer(config, member) : r;
}
@Override
public JacksonInject.Value findInjectableValue(MapperConfig<?> config, AnnotatedMember m) {
JacksonInject.Value r = _primary.findInjectableValue(config, m);
if (r == null || r.getUseInput() == null) {
JacksonInject.Value secondary = _secondary.findInjectableValue(config, m);
if (secondary != null) {
r = (r == null) ? secondary : r.withUseInput(secondary.getUseInput());
}
}
return r;
}
@Override
public boolean hasIgnoreMarker(MapperConfig<?> config, AnnotatedMember m) {
return _primary.hasIgnoreMarker(config, m) || _secondary.hasIgnoreMarker(config, m);
}
@Override
public Boolean hasRequiredMarker(MapperConfig<?> config, AnnotatedMember m) {
Boolean r = _primary.hasRequiredMarker(config, m);
return (r == null) ? _secondary.hasRequiredMarker(config, m) : r;
}
// // // Serialization: general annotations
@Override
public Object findSerializer(MapperConfig<?> config, Annotated am) {
Object r = _primary.findSerializer(config, am);
if (_isExplicitClassOrOb(r, ValueSerializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findSerializer(config, am),
ValueSerializer.None.class);
}
@Override
public Object findKeySerializer(MapperConfig<?> config, Annotated a) {
Object r = _primary.findKeySerializer(config, a);
if (_isExplicitClassOrOb(r, ValueSerializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findKeySerializer(config, a),
ValueSerializer.None.class);
}
@Override
public Object findContentSerializer(MapperConfig<?> config, Annotated a) {
Object r = _primary.findContentSerializer(config, a);
if (_isExplicitClassOrOb(r, ValueSerializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findContentSerializer(config, a),
ValueSerializer.None.class);
}
@Override
public Object findNullSerializer(MapperConfig<?> config, Annotated a) {
Object r = _primary.findNullSerializer(config, a);
if (_isExplicitClassOrOb(r, ValueSerializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findNullSerializer(config, a),
ValueSerializer.None.class);
}
@Override
public JsonInclude.Value findPropertyInclusion(MapperConfig<?> config, Annotated a)
{
JsonInclude.Value v2 = _secondary.findPropertyInclusion(config, a);
JsonInclude.Value v1 = _primary.findPropertyInclusion(config, a);
if (v2 == null) { // shouldn't occur but
return v1;
}
return v2.withOverrides(v1);
}
@Override
public JsonSerialize.Typing findSerializationTyping(MapperConfig<?> config, Annotated a) {
JsonSerialize.Typing r = _primary.findSerializationTyping(config, a);
return (r == null) ? _secondary.findSerializationTyping(config, a) : r;
}
@Override
public Object findSerializationConverter(MapperConfig<?> config, Annotated a) {
Object r = _primary.findSerializationConverter(config, a);
return (r == null) ? _secondary.findSerializationConverter(config, a) : r;
}
@Override
public Object findSerializationContentConverter(MapperConfig<?> config, AnnotatedMember a) {
Object r = _primary.findSerializationContentConverter(config, a);
return (r == null) ? _secondary.findSerializationContentConverter(config, a) : r;
}
@Override
public Class<?>[] findViews(MapperConfig<?> config, Annotated a) {
/* Theoretically this could be trickier, if multiple introspectors
* return non-null entries. For now, though, we'll just consider
* first one to return non-null to win.
*/
Class<?>[] result = _primary.findViews(config, a);
if (result == null) {
result = _secondary.findViews(config, a);
}
return result;
}
@Override
public Boolean isTypeId(MapperConfig<?> config, AnnotatedMember member) {
Boolean b = _primary.isTypeId(config, member);
return (b == null) ? _secondary.isTypeId(config, member) : b;
}
@Override
public ObjectIdInfo findObjectIdInfo(MapperConfig<?> config, Annotated ann) {
ObjectIdInfo r = _primary.findObjectIdInfo(config, ann);
return (r == null) ? _secondary.findObjectIdInfo(config, ann) : r;
}
@Override
public ObjectIdInfo findObjectReferenceInfo(MapperConfig<?> config,
Annotated ann, ObjectIdInfo objectIdInfo) {
// to give precedence for primary, must start with secondary:
objectIdInfo = _secondary.findObjectReferenceInfo(config, ann, objectIdInfo);
objectIdInfo = _primary.findObjectReferenceInfo(config, ann, objectIdInfo);
return objectIdInfo;
}
@Override
public JsonFormat.Value findFormat(MapperConfig<?> config, Annotated ann) {
JsonFormat.Value v1 = _primary.findFormat(config, ann);
JsonFormat.Value v2 = _secondary.findFormat(config, ann);
if (v2 == null) { // shouldn't occur but just in case
return v1;
}
return v2.withOverrides(v1);
}
@Override
public PropertyName findWrapperName(MapperConfig<?> config, Annotated ann) {
return PropertyName.merge(_primary.findWrapperName(config, ann),
_secondary.findWrapperName(config, ann));
}
@Override
public String findPropertyDefaultValue(MapperConfig<?> config, Annotated ann) {
String str = _primary.findPropertyDefaultValue(config, ann);
return (str == null || str.isEmpty()) ? _secondary.findPropertyDefaultValue(config, ann) : str;
}
@Override
public String findPropertyDescription(MapperConfig<?> config, Annotated ann) {
String r = _primary.findPropertyDescription(config, ann);
return (r == null) ? _secondary.findPropertyDescription(config, ann) : r;
}
@Override
public Integer findPropertyIndex(MapperConfig<?> config, Annotated ann) {
Integer r = _primary.findPropertyIndex(config, ann);
return (r == null) ? _secondary.findPropertyIndex(config, ann) : r;
}
@Override
public String findImplicitPropertyName(MapperConfig<?> config, AnnotatedMember ann) {
String r = _primary.findImplicitPropertyName(config, ann);
return (r == null) ? _secondary.findImplicitPropertyName(config, ann) : r;
}
@Override
public List<PropertyName> findPropertyAliases(MapperConfig<?> config, Annotated ann) {
List<PropertyName> r = _primary.findPropertyAliases(config, ann);
return (r == null) ? _secondary.findPropertyAliases(config, ann) : r;
}
@Override
public JsonProperty.Access findPropertyAccess(MapperConfig<?> config, Annotated ann) {
JsonProperty.Access acc = _primary.findPropertyAccess(config, ann);
if ((acc != null) && (acc != JsonProperty.Access.AUTO)) {
return acc;
}
acc = _secondary.findPropertyAccess(config, ann);
if (acc != null) {
return acc;
}
return JsonProperty.Access.AUTO;
}
@Override
public AnnotatedMethod resolveSetterConflict(MapperConfig<?> config,
AnnotatedMethod setter1, AnnotatedMethod setter2)
{
AnnotatedMethod res = _primary.resolveSetterConflict(config, setter1, setter2);
if (res == null) {
res = _secondary.resolveSetterConflict(config, setter1, setter2);
}
return res;
}
@Override // since 2.11
public PropertyName findRenameByField(MapperConfig<?> config,
AnnotatedField f, PropertyName implName) {
return PropertyName.merge(_secondary.findRenameByField(config, f, implName),
_primary.findRenameByField(config, f, implName));
}
// // // Serialization: type refinements
@Override
public JavaType refineSerializationType(MapperConfig<?> config,
Annotated a, JavaType baseType)
{
JavaType t = _secondary.refineSerializationType(config, a, baseType);
return _primary.refineSerializationType(config, a, t);
}
// // // Serialization: class annotations
@Override
public String[] findSerializationPropertyOrder(MapperConfig<?> config, AnnotatedClass ac) {
String[] r = _primary.findSerializationPropertyOrder(config, ac);
return (r == null) ? _secondary.findSerializationPropertyOrder(config, ac) : r;
}
@Override
public Boolean findSerializationSortAlphabetically(MapperConfig<?> config, Annotated ann) {
Boolean r = _primary.findSerializationSortAlphabetically(config, ann);
return (r == null) ? _secondary.findSerializationSortAlphabetically(config, ann) : r;
}
@Override
public void findAndAddVirtualProperties(MapperConfig<?> config, AnnotatedClass ac,
List<BeanPropertyWriter> properties) {
// first secondary, then primary, to give proper precedence
_primary.findAndAddVirtualProperties(config, ac, properties);
_secondary.findAndAddVirtualProperties(config, ac, properties);
}
// // // Serialization: property annotations
@Override
public PropertyName findNameForSerialization(MapperConfig<?> config, Annotated a) {
return PropertyName.merge(_primary.findNameForSerialization(config, a),
_secondary.findNameForSerialization(config, a));
}
@Override
public Boolean hasAsKey(MapperConfig<?> config, Annotated a) {
Boolean b = _primary.hasAsKey(config, a);
if (b == null) {
b = _secondary.hasAsKey(config, a);
}
return b;
}
@Override
public Boolean hasAsValue(MapperConfig<?> config, Annotated a) {
Boolean b = _primary.hasAsValue(config, a);
if (b == null) {
b = _secondary.hasAsValue(config, a);
}
return b;
}
@Override
public Boolean hasAnyGetter(MapperConfig<?> config, Annotated a) {
Boolean b = _primary.hasAnyGetter(config, a);
if (b == null) {
b = _secondary.hasAnyGetter(config, a);
}
return b;
}
@Override
public String[] findEnumValues(MapperConfig<?> config, AnnotatedClass annotatedClass,
Enum<?>[] enumValues, String[] names) {
// reverse order to give _primary higher precedence
names = _secondary.findEnumValues(config, annotatedClass, enumValues, names);
names = _primary.findEnumValues(config, annotatedClass, enumValues, names);
return names;
}
@Override
public void findEnumAliases(MapperConfig<?> config, AnnotatedClass annotatedClass,
Enum<?>[] enumConstants, String[][] aliases) {
// reverse order to give _primary higher precedence
_secondary.findEnumAliases(config, annotatedClass, enumConstants, aliases);
_primary.findEnumAliases(config, annotatedClass, enumConstants, aliases);
}
@Override
public Enum<?> findDefaultEnumValue(MapperConfig<?> config,
AnnotatedClass annotatedClass, Enum<?>[] enumValues) {
Enum<?> en = _primary.findDefaultEnumValue(config, annotatedClass, enumValues);
return (en == null) ? _secondary.findDefaultEnumValue(config, annotatedClass, enumValues) : en;
}
// // // Deserialization: general annotations
@Override
public Object findDeserializer(MapperConfig<?> config, Annotated a) {
Object r = _primary.findDeserializer(config, a);
if (_isExplicitClassOrOb(r, ValueDeserializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findDeserializer(config, a),
ValueDeserializer.None.class);
}
@Override
public Object findKeyDeserializer(MapperConfig<?> config, Annotated a) {
Object r = _primary.findKeyDeserializer(config, a);
if (_isExplicitClassOrOb(r, KeyDeserializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findKeyDeserializer(config, a),
KeyDeserializer.None.class);
}
@Override
public Object findContentDeserializer(MapperConfig<?> config, Annotated am) {
Object r = _primary.findContentDeserializer(config, am);
if (_isExplicitClassOrOb(r, ValueDeserializer.None.class)) {
return r;
}
return _explicitClassOrOb(_secondary.findContentDeserializer(config, am),
ValueDeserializer.None.class);
}
@Override
public Object findDeserializationConverter(MapperConfig<?> config, Annotated a) {
Object ob = _primary.findDeserializationConverter(config, a);
return (ob == null) ? _secondary.findDeserializationConverter(config, a) : ob;
}
@Override
public Object findDeserializationContentConverter(MapperConfig<?> config, AnnotatedMember a) {
Object ob = _primary.findDeserializationContentConverter(config, a);
return (ob == null) ? _secondary.findDeserializationContentConverter(config, a) : ob;
}
// // // Deserialization: type refinements
@Override
public JavaType refineDeserializationType(MapperConfig<?> config,
Annotated a, JavaType baseType)
{
JavaType t = _secondary.refineDeserializationType(config, a, baseType);
return _primary.refineDeserializationType(config, a, t);
}
/*
/**********************************************************************
/* Deserialization: value instantiation, Creators
/**********************************************************************
*/
@Override
public Object findValueInstantiator(MapperConfig<?> config, AnnotatedClass ac) {
Object result = _primary.findValueInstantiator(config, ac);
return (result == null) ? _secondary.findValueInstantiator(config, ac) : result;
}
@Override
public Class<?> findPOJOBuilder(MapperConfig<?> config, AnnotatedClass ac) {
Class<?> result = _primary.findPOJOBuilder(config, ac);
return (result == null) ? _secondary.findPOJOBuilder(config, ac) : result;
}
@Override
public JsonPOJOBuilder.Value findPOJOBuilderConfig(MapperConfig<?> config, AnnotatedClass ac) {
JsonPOJOBuilder.Value result = _primary.findPOJOBuilderConfig(config, ac);
return (result == null) ? _secondary.findPOJOBuilderConfig(config, ac) : result;
}
@Override
public JsonCreator.Mode findCreatorAnnotation(MapperConfig<?> config, Annotated a) {
JsonCreator.Mode mode = _primary.findCreatorAnnotation(config, a);
return (mode == null) ? _secondary.findCreatorAnnotation(config, a) : mode;
}
@Override
public PotentialCreator findPreferredCreator(MapperConfig<?> config,
AnnotatedClass valueClass,
List<PotentialCreator> declaredConstructors,
List<PotentialCreator> declaredFactories,
Optional<PotentialCreator> zeroParamsConstructor) {
PotentialCreator primaryCtor = _primary.findPreferredCreator(config,
valueClass, declaredConstructors, declaredFactories, zeroParamsConstructor);
if (primaryCtor == null) {
primaryCtor = _secondary.findPreferredCreator(config,
valueClass, declaredConstructors, declaredFactories, zeroParamsConstructor);
}
return primaryCtor;
}
/*
/**********************************************************************
/* Deserialization: other property annotations
/**********************************************************************
*/
@Override
public PropertyName findNameForDeserialization(MapperConfig<?> config, Annotated a)
{
return PropertyName.merge(
_primary.findNameForDeserialization(config, a),
_secondary.findNameForDeserialization(config, a));
}
@Override
public Boolean hasAnySetter(MapperConfig<?> config, Annotated a) {
Boolean b = _primary.hasAnySetter(config, a);
if (b == null) {
b = _secondary.hasAnySetter(config, a);
}
return b;
}
@Override
public JsonSetter.Value findSetterInfo(MapperConfig<?> config, Annotated a) {
JsonSetter.Value v2 = _secondary.findSetterInfo(config, a);
JsonSetter.Value v1 = _primary.findSetterInfo(config, a);
return (v2 == null) // shouldn't occur but
? v1 : v2.withOverrides(v1);
}
@Override
public Boolean findMergeInfo(MapperConfig<?> config, Annotated a) {
Boolean b = _primary.findMergeInfo(config, a);
if (b == null) {
b = _secondary.findMergeInfo(config, a);
}
return b;
}
protected boolean _isExplicitClassOrOb(Object maybeCls, Class<?> implicit) {
if ((maybeCls == null) || (maybeCls == implicit)) {
return false;
}
if (maybeCls instanceof Class<?> class1) {
return !ClassUtil.isBogusClass(class1);
}
return true;
}
protected Object _explicitClassOrOb(Object maybeCls, Class<?> implicit) {
if ((maybeCls == null) || (maybeCls == implicit)) {
return null;
}
if (maybeCls instanceof Class<?> class1 && ClassUtil.isBogusClass(class1)) {
return null;
}
return maybeCls;
}
}