calabash-android 0.4.7.pre6 → 0.4.7.pre7

data/test-server/instrumentation-backend/src/sh/calaba/org/codehaus/jackson/map/AnnotationIntrospector.java

@@ -0,0 +1,1485 @@
+package sh.calaba.org.codehaus.jackson.map;
+
+import java.lang.annotation.Annotation;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import sh.calaba.org.codehaus.jackson.map.annotate.JsonSerialize;
+import sh.calaba.org.codehaus.jackson.map.deser.ValueInstantiator;
+import sh.calaba.org.codehaus.jackson.map.introspect.Annotated;
+import sh.calaba.org.codehaus.jackson.map.introspect.AnnotatedClass;
+import sh.calaba.org.codehaus.jackson.map.introspect.AnnotatedConstructor;
+import sh.calaba.org.codehaus.jackson.map.introspect.AnnotatedField;
+import sh.calaba.org.codehaus.jackson.map.introspect.AnnotatedMember;
+import sh.calaba.org.codehaus.jackson.map.introspect.AnnotatedMethod;
+import sh.calaba.org.codehaus.jackson.map.introspect.AnnotatedParameter;
+import sh.calaba.org.codehaus.jackson.map.introspect.NopAnnotationIntrospector;
+import sh.calaba.org.codehaus.jackson.map.introspect.VisibilityChecker;
+import sh.calaba.org.codehaus.jackson.map.jsontype.NamedType;
+import sh.calaba.org.codehaus.jackson.map.jsontype.TypeResolverBuilder;
+import sh.calaba.org.codehaus.jackson.type.JavaType;
+
+/**
+ * Abstract class that defines API used for introspecting annotation-based
+ * configuration for serialization and deserialization. Separated
+ * so that different sets of annotations can be supported, and support
+ * plugged-in dynamically.
+ *<p>
+ * NOTE: due to rapid addition of new methods (and changes to existing methods),
+ * it is <b>strongly</b> recommended that custom implementations should not directly
+ * extend this class, but rather extend {@link NopAnnotationIntrospector}.
+ * This way added methods will not break backwards compatibility of custom annotation
+ * introspectors.
+ */
+public abstract class AnnotationIntrospector
+{    
+    /*
+    /**********************************************************
+    /* Helper types
+    /**********************************************************
+     */
+
+    /**
+     * Value type used with managed and back references; contains type and
+     * logic name, used to link related references
+     * 
+     * @since 1.6
+     */
+    public static class ReferenceProperty
+    {
+        public enum Type {
+            /**
+             * Reference property that Jackson manages and that is serialized normally (by serializing
+             * reference object), but is used for resolving back references during
+             * deserialization.
+             * Usually this can be defined by using
+             * {@link sh.calaba.org.codehaus.jackson.annotate.JsonManagedReference}
+             */
+            MANAGED_REFERENCE
+    
+            /**
+             * Reference property that Jackson manages by suppressing it during serialization,
+             * and reconstructing during deserialization.
+             * Usually this can be defined by using
+             * {@link sh.calaba.org.codehaus.jackson.annotate.JsonBackReference}
+             */
+            ,BACK_REFERENCE
+            ;
+        }
+
+        private final Type _type;
+        private final String _name;
+
+        public ReferenceProperty(Type t, String n) {
+            _type = t;
+            _name = n;
+        }
+
+        public static ReferenceProperty managed(String name) { return new ReferenceProperty(Type.MANAGED_REFERENCE, name); }
+        public static ReferenceProperty back(String name) { return new ReferenceProperty(Type.BACK_REFERENCE, name); }
+        
+        public Type getType() { return _type; }
+        public String getName() { return _name; }
+
+        public boolean isManagedReference() { return _type == Type.MANAGED_REFERENCE; }
+        public boolean isBackReference() { return _type == Type.BACK_REFERENCE; }
+    }
+    
+    /*
+    /**********************************************************
+    /* Factory methods
+    /**********************************************************
+     */
+    
+    /**
+     * Factory method for accessing "no operation" implementation
+     * of introspector: instance that will never find any annotation-based
+     * configuration.
+     * 
+     * @since 1.3
+     */
+    public static AnnotationIntrospector nopInstance() {
+        return NopAnnotationIntrospector.instance;
+    }
+
+    public static AnnotationIntrospector pair(AnnotationIntrospector a1, AnnotationIntrospector a2) {
+        return new Pair(a1, a2);
+    }
+
+    /*
+    /**********************************************************
+    /* Access to possibly chained introspectors (1.7)
+    /**********************************************************
+     */
+
+    /**
+     * Method that can be used to collect all "real" introspectors that
+     * this introspector contains, if any; or this introspector
+     * if it is not a container. Used to get access to all container
+     * introspectors in their priority order.
+     *<p>
+     * Default implementation returns a Singleton list with this introspector
+     * as contents.
+     * This usually works for sub-classes, except for proxy or delegating "container
+     * introspectors" which need to override implementation.
+     */
+    public Collection<AnnotationIntrospector> allIntrospectors() {
+        return Collections.singletonList(this);
+    }
+    
+    /**
+     * Method that can be used to collect all "real" introspectors that
+     * this introspector contains, if any; or this introspector
+     * if it is not a container. Used to get access to all container
+     * introspectors in their priority order.
+     *<p>
+     * Default implementation adds this introspector in result; this usually
+     * works for sub-classes, except for proxy or delegating "container
+     * introspectors" which need to override implementation.
+     */
+    public Collection<AnnotationIntrospector> allIntrospectors(Collection<AnnotationIntrospector> result) {
+        result.add(this);
+        return result;
+    }
+    
+    /*
+    /**********************************************************
+    /* Generic annotation properties, lookup
+    /**********************************************************
+    */
+
+    /**
+     * Method called by framework to determine whether given annotation
+     * is handled by this introspector.
+     */
+    public abstract boolean isHandled(Annotation ann);
+    
+    /*
+    /**********************************************************
+    /* General class annotations
+    /**********************************************************
+    */
+
+    /**
+     * Method that checks whether specified class has annotations
+     * that indicate that it is (or is not) cachable. Exact
+     * semantics depend on type of class annotated and using
+     * class (factory or provider).
+     *<p>
+     * Currently only used
+     * with deserializers, to determine whether provider
+     * should cache instances, and if no annotations are found,
+     * assumes non-cachable instances.
+     *
+     * @return True, if class is considered cachable within context,
+     *   False if not, and null if introspector does not care either
+     *   way.
+     */
+    public Boolean findCachability(AnnotatedClass ac) {
+        return null;
+    }
+
+    /**
+     * Method for locating name used as "root name" (for use by
+     * some serializers when outputting root-level object -- mostly
+     * for XML compatibility purposes) for given class, if one
+     * is defined. Returns null if no declaration found; can return
+     * explicit empty String, which is usually ignored as well as null.
+     *
+     * @since 1.3
+     */
+    public abstract String findRootName(AnnotatedClass ac);
+
+    /**
+     * Method for finding list of properties to ignore for given class
+     * (null is returned if not specified).
+     * List of property names is applied
+     * after other detection mechanisms, to filter out these specific
+     * properties from being serialized and deserialized.
+     * 
+     * @since 1.4
+     */
+    public abstract String[] findPropertiesToIgnore(AnnotatedClass ac);
+
+    /**
+     * Method for checking whether an annotation indicates that all unknown properties
+     * 
+     * @since 1.4
+     */
+    public abstract Boolean findIgnoreUnknownProperties(AnnotatedClass ac);
+
+    /**
+     * Method for checking whether properties that have specified type
+     * (class, not generics aware) should be completely ignored for
+     * serialization and deserialization purposes.
+     * 
+     * @param ac Type to check
+     * 
+     * @return Boolean.TRUE if properties of type should be ignored;
+     *   Boolean.FALSE if they are not to be ignored, null for default
+     *   handling (which is 'do not ignore')
+     *   
+     * @since 1.7
+     */
+    public Boolean isIgnorableType(AnnotatedClass ac) {
+        return null;
+    }
+
+    /**
+     * Method for finding if annotated class has associated filter; and if so,
+     * to return id that is used to locate filter.
+     * 
+     * @return Id of the filter to use for filtering properties of annotated
+     *    class, if any; or null if none found.
+     */
+    public Object findFilterId(AnnotatedClass ac) {
+        return null;
+    }
+    
+    /*
+    /**********************************************************
+    /* Property auto-detection
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking if annotations indicate changes to minimum visibility levels
+     * needed for auto-detecting property elements (fields, methods, constructors).
+     * A baseline checker is given, and introspector is to either return it as is (if
+     * no annotations are found), or build and return a derived instance (using checker's build
+     * methods).
+     *
+     *  @since 1.5
+     */
+    public VisibilityChecker<?> findAutoDetectVisibility(AnnotatedClass ac, VisibilityChecker<?> checker) {
+        return checker;
+    }
+    
+    /*
+    /**********************************************************
+    /* Class annotations for Polymorphic type handling (1.5+)
+    /**********************************************************
+    */
+    
+    /**
+     * Method for checking if given class has annotations that indicate
+     * that specific type resolver is to be used for handling instances.
+     * This includes not only
+     * instantiating resolver builder, but also configuring it based on
+     * relevant annotations (not including ones checked with a call to
+     * {@link #findSubtypes}
+     * 
+     * @param config Configuration settings in effect (for serialization or deserialization)
+     * @param ac Annotated class to check for annotations
+     * @param baseType Base java type of value for which resolver is to be found
+     * 
+     * @return Type resolver builder for given type, if one found; null if none
+     * 
+     * @since 1.5 -- although changed in 1.8 to pass configuration object
+     */
+    public TypeResolverBuilder<?> findTypeResolver(MapperConfig<?> config,
+            AnnotatedClass ac, JavaType baseType) {
+        return null;
+    }
+
+    /**
+     * Method for checking if given property entity (field or method) has annotations
+     * that indicate that specific type resolver is to be used for handling instances.
+     * This includes not only
+     * instantiating resolver builder, but also configuring it based on
+     * relevant annotations (not including ones checked with a call to
+     * {@link #findSubtypes}
+     * 
+     * @param config Configuration settings in effect (for serialization or deserialization)
+     * @param am Annotated member (field or method) to check for annotations
+     * @param baseType Base java type of property for which resolver is to be found
+     * 
+     * @return Type resolver builder for properties of given entity, if one found;
+     *    null if none
+     * 
+     * @since 1.5 -- although changed in 1.8 to pass configuration object
+     */
+    public TypeResolverBuilder<?> findPropertyTypeResolver(MapperConfig<?> config,
+            AnnotatedMember am, JavaType baseType) {
+        return null;
+    }
+
+    /**
+     * Method for checking if given structured property entity (field or method that
+     * has nominal value of Map, Collection or array type) has annotations
+     * that indicate that specific type resolver is to be used for handling type
+     * information of contained values.
+     * This includes not only
+     * instantiating resolver builder, but also configuring it based on
+     * relevant annotations (not including ones checked with a call to
+     * {@link #findSubtypes}
+     * 
+     * @param config Configuration settings in effect (for serialization or deserialization)
+     * @param am Annotated member (field or method) to check for annotations
+     * @param containerType Type of property for which resolver is to be found (must be a container type)
+     * 
+     * @return Type resolver builder for values contained in properties of given entity,
+     *    if one found; null if none
+     * 
+     * @since 1.5 -- although changed in 1.8 to pass configuration object
+     */    
+    public TypeResolverBuilder<?> findPropertyContentTypeResolver(MapperConfig<?> config,
+            AnnotatedMember am, JavaType containerType) {
+        return null;
+    }
+
+    /**
+     * Method for locating annotation-specified subtypes related to annotated
+     * entity (class, method, field). Note that this is only guaranteed to be
+     * a list of directly
+     * declared subtypes, no recursive processing is guarantees (i.e. caller
+     * has to do it if/as necessary)
+     * 
+     * @param a Annotated entity (class, field/method) to check for annotations
+     * 
+     * @since 1.5
+     */
+    public List<NamedType> findSubtypes(Annotated a) {
+        return null;
+    }
+
+    /**
+     * Method for checking if specified type has explicit name.
+     * 
+     * @param ac Class to check for type name annotations
+     * 
+     * @since 1.5
+     */
+    public String findTypeName(AnnotatedClass ac) {
+        return null;
+    }
+
+    /*
+    /**********************************************************
+    /* General member (field, method/constructor) annotations
+    /**********************************************************
+     */
+
+    /**
+     * Note: defined as non-abstract to reduce fragility between
+     * versions.
+     * 
+     * @since 1.6
+     */
+    public ReferenceProperty findReferenceType(AnnotatedMember member) {
+        return null;
+    }
+
+    /**
+     * Method called to check whether given property is marked to be "unwrapped"
+     * when being serialized (and appropriately handled in reverse direction,
+     * i.e. expect unwrapped representation during deserialization)
+     * 
+     * @since 1.9
+     */
+    public Boolean shouldUnwrapProperty(AnnotatedMember member) {
+        return null;
+    }
+
+    /**
+     * Method called to check whether given property is marked to
+     * be ignored; but NOT to determine if it should necessarily
+     * be ignored, since that may depend on other factors.
+     *<p>
+     * Default implementation calls existing 'isIgnored' methods
+     * such as {@link #isIgnorableField(AnnotatedField)} and
+     * {@link #isIgnorableMethod(AnnotatedMethod)}.
+     * 
+     * @since 1.9
+     */
+    public boolean hasIgnoreMarker(AnnotatedMember m)
+    {
+        /* For maximum backwards compatibility, we better call
+         * existing methods.
+         */
+        /* TODO: For 2.0, replace with simple 'return false;'
+         */
+        if (m instanceof AnnotatedMethod) {
+            return isIgnorableMethod((AnnotatedMethod) m);
+        }
+        if (m instanceof AnnotatedField) {
+            return isIgnorableField((AnnotatedField) m);
+        }
+        if (m instanceof AnnotatedConstructor) {
+            return isIgnorableConstructor((AnnotatedConstructor) m);
+        }
+        return false;
+    }
+
+    /**
+     * Method called to find out whether given member expectes a value
+     * to be injected, and if so, what is the identifier of the value
+     * to use during injection.
+     * Type if identifier needs to be compatible with provider of
+     * values (of type {@link InjectableValues}); often a simple String
+     * id is used.
+     * 
+     * @param m Member to check
+     * 
+     * @return Identifier of value to inject, if any; null if no injection
+     *   indicator is found
+     */
+    public Object findInjectableValueId(AnnotatedMember m) {
+        return null;
+    }
+    
+    /*
+    /**********************************************************
+    /* General method annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether there is an annotation that
+     * indicates that given method should be ignored for all
+     * operations (serialization, deserialization).
+     *<p>
+     * Note that this method should <b>ONLY</b> return true for such
+     * explicit ignoral cases; and not if method just happens not to
+     * be visible for annotation processor.
+     *
+     * @return True, if an annotation is found to indicate that the
+     *    method should be ignored; false if not.
+     */
+    public abstract boolean isIgnorableMethod(AnnotatedMethod m);
+
+    /**
+     * @since 1.2
+     */
+    public abstract boolean isIgnorableConstructor(AnnotatedConstructor c);
+
+    /*
+    /**********************************************************
+    /* General field annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether there is an annotation that
+     * indicates that given field should be ignored for all
+     * operations (serialization, deserialization).
+     *
+     * @return True, if an annotation is found to indicate that the
+     *    field should be ignored; false if not.
+     */
+    public abstract boolean isIgnorableField(AnnotatedField f);
+
+    /*
+    /**********************************************************
+    /* Serialization: general annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for getting a serializer definition on specified method
+     * or field. Type of definition is either instance (of type
+     * {@link JsonSerializer}) or Class (of type
+     * <code>Class<JsonSerializer></code>); if value of different
+     * type is returned, a runtime exception may be thrown by caller.
+     *<p>
+     * Note: this variant was briefly deprecated for 1.7; should not be
+     */
+    public abstract Object findSerializer(Annotated am);
+
+    /**
+     * Method for getting a serializer definition for keys of associated <code>Map</code> property.
+     * Type of definition is either instance (of type
+     * {@link JsonSerializer}) or Class (of type
+     * <code>Class<JsonSerializer></code>); if value of different
+     * type is returned, a runtime exception may be thrown by caller.
+     * 
+     * @since 1.8
+     */
+    public Class<? extends JsonSerializer<?>> findKeySerializer(Annotated am) {
+        return null;
+    }
+
+    /**
+     * Method for getting a serializer definition for content (values) of
+     * associated <code>Collection</code>, <code>array</code> or <code>Map</code> property.
+     * Type of definition is either instance (of type
+     * {@link JsonSerializer}) or Class (of type
+     * <code>Class<JsonSerializer></code>); if value of different
+     * type is returned, a runtime exception may be thrown by caller.
+     * 
+     * @since 1.8
+     */
+    public Class<? extends JsonSerializer<?>> findContentSerializer(Annotated am) {
+        return null;
+    }
+    
+    /**
+     * Method for checking whether given annotated entity (class, method,
+     * field) defines which Bean/Map properties are to be included in
+     * serialization.
+     * If no annotation is found, method should return given second
+     * argument; otherwise value indicated by the annotation
+     *
+     * @return Enumerated value indicating which properties to include
+     *   in serialization
+     */
+    public JsonSerialize.Inclusion findSerializationInclusion(Annotated a, JsonSerialize.Inclusion defValue) {
+        return defValue;
+    }
+
+    /**
+     * Method for accessing annotated type definition that a
+     * method/field can have, to be used as the type for serialization
+     * instead of the runtime type.
+     * Type returned (if any) needs to be widening conversion (super-type).
+     * Declared return type of the method is also considered acceptable.
+     *
+     * @return Class to use instead of runtime type
+     */
+    public abstract Class<?> findSerializationType(Annotated a);
+
+    /**
+     * Method for finding possible widening type definition that a property
+     * value can have, to define less specific key type to use for serialization.
+     * It should be only be used with {@link java.util.Map} types.
+     * 
+     * @return Class specifying more general type to use instead of
+     *   declared type, if annotation found; null if not
+     */
+    public Class<?> findSerializationKeyType(Annotated am, JavaType baseType) {
+        return null;
+    }
+
+    /**
+     * Method for finding possible widening type definition that a property
+     * value can have, to define less specific key type to use for serialization.
+     * It should be only used with structured types (arrays, collections, maps).
+     * 
+     * @return Class specifying more general type to use instead of
+     *   declared type, if annotation found; null if not
+     */
+    public Class<?> findSerializationContentType(Annotated am, JavaType baseType) {
+        return null;
+    }
+    
+    /**
+     * Method for accessing declared typing mode annotated (if any).
+     * This is used for type detection, unless more granular settings
+     * (such as actual exact type; or serializer to use which means
+     * no type information is needed) take precedence.
+     *
+     * @since 1.2
+     *
+     * @return Typing mode to use, if annotation is found; null otherwise
+     */
+    public abstract JsonSerialize.Typing findSerializationTyping(Annotated a);
+
+    /**
+     * Method for checking if annotated serializable property (represented by
+     * field or getter method) has definitions for views it is to be included
+     * in. If null is returned, no view definitions exist and property is always
+     * included; otherwise it will only be included for views included in returned
+     * array. View matches are checked using class inheritance rules (sub-classes
+     * inherit inclusions of super-classes)
+     * 
+     * @param a Annotated serializable property (field or getter method)
+     * @return Array of views (represented by classes) that the property is included in;
+     *    if null, always included (same as returning array containing <code>Object.class</code>)
+     */
+    public abstract Class<?>[] findSerializationViews(Annotated a);
+    
+    /*
+    /**********************************************************
+    /* Serialization: class annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for accessing defined property serialization order (which may be
+     * partial). May return null if no ordering is defined.
+     * 
+     * @since 1.4
+     */
+    public abstract String[] findSerializationPropertyOrder(AnnotatedClass ac);
+
+    /**
+     * Method for checking whether an annotation indicates that serialized properties
+     * for which no explicit is defined should be alphabetically (lexicograpically)
+     * ordered
+     * 
+     * @since 1.4
+     */
+    public abstract Boolean findSerializationSortAlphabetically(AnnotatedClass ac);
+    
+    /*
+    /**********************************************************
+    /* Serialization: method annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether given method has an annotation
+     * that suggests property name associated with method that
+     * may be a "getter". Should return null if no annotation
+     * is found; otherwise a non-null String.
+     * If non-null value is returned, it is used as the property
+     * name, except for empty String ("") which is taken to mean
+     * "use standard bean name detection if applicable;
+     * method name if not".
+     */
+    public abstract String findGettablePropertyName(AnnotatedMethod am);
+
+    /**
+     * Method for checking whether given method has an annotation
+     * that suggests that the return value of annotated method
+     * should be used as "the value" of the object instance; usually
+     * serialized as a primitive value such as String or number.
+     *
+     * @return True if such annotation is found (and is not disabled);
+     *   false if no enabled annotation is found
+     */
+    public abstract boolean hasAsValueAnnotation(AnnotatedMethod am);
+
+    /**
+     * Method for determining the String value to use for serializing
+     * given enumeration entry; used when serializing enumerations
+     * as Strings (the standard method).
+     *
+     * @return Serialized enum value.
+     */
+    public abstract String findEnumValue(Enum<?> value);
+
+    /*
+    /**********************************************************
+    /* Serialization: field annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether given member field represent
+     * a serializable logical property; and if so, returns the
+     * name of that property.
+     * Should return null if no annotation is found (indicating it
+     * is not a serializable field); otherwise a non-null String.
+     * If non-null value is returned, it is used as the property
+     * name, except for empty String ("") which is taken to mean
+     * "use the field name as is".
+     */
+    public abstract String findSerializablePropertyName(AnnotatedField af);
+
+    /*
+    /**********************************************************
+    /* Deserialization: general annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for getting a deserializer definition on specified method
+     * or field.
+     * Type of definition is either instance (of type
+     * {@link JsonDeserializer}) or Class (of type
+     * <code>Class<JsonDeserializer></code>); if value of different
+     * type is returned, a runtime exception may be thrown by caller.
+     *<p>
+     * Note: this variant was briefly deprecated for 1.7; but it turns out
+     * we really should not try to push BeanProperty through at this point
+     */
+    public abstract Object findDeserializer(Annotated am);
+
+    /**
+     * Method for getting a deserializer definition for keys of
+     * associated <code>Map</code> property.
+     * Type of definition is either instance (of type
+     * {@link JsonDeserializer}) or Class (of type
+     * <code>Class<JsonDeserializer></code>); if value of different
+     * type is returned, a runtime exception may be thrown by caller.
+     * 
+     * @since 1.3
+     */
+    public abstract Class<? extends KeyDeserializer> findKeyDeserializer(Annotated am);
+
+    /**
+     * Method for getting a deserializer definition for content (values) of
+     * associated <code>Collection</code>, <code>array</code> or
+     * <code>Map</code> property.
+     * Type of definition is either instance (of type
+     * {@link JsonDeserializer}) or Class (of type
+     * <code>Class<JsonDeserializer></code>); if value of different
+     * type is returned, a runtime exception may be thrown by caller.
+     * 
+     * @since 1.3
+     */
+    public abstract Class<? extends JsonDeserializer<?>> findContentDeserializer(Annotated am);
+
+    /**
+     * Method for accessing annotated type definition that a
+     * method can have, to be used as the type for serialization
+     * instead of the runtime type.
+     * Type must be a narrowing conversion
+     * (i.e.subtype of declared type).
+     * Declared return type of the method is also considered acceptable.
+     *
+     * @param baseType Assumed type before considering annotations
+     * @param propName Logical property name of the property that uses
+     *    type, if known; null for types not associated with property
+     *
+     * @return Class to use for deserialization instead of declared type
+     */
+    public abstract Class<?> findDeserializationType(Annotated am, JavaType baseType,
+            String propName);
+
+    /**
+     * Method for accessing additional narrowing type definition that a
+     * method can have, to define more specific key type to use.
+     * It should be only be used with {@link java.util.Map} types.
+     * 
+     * @param baseKeyType Assumed key type before considering annotations
+     * @param propName Logical property name of the property that uses
+     *    type, if known; null for types not associated with property
+     *
+     * @return Class specifying more specific type to use instead of
+     *   declared type, if annotation found; null if not
+     */
+    public abstract Class<?> findDeserializationKeyType(Annotated am, JavaType baseKeyType,
+            String propName);
+
+    /**
+     * Method for accessing additional narrowing type definition that a
+     * method can have, to define more specific content type to use;
+     * content refers to Map values and Collection/array elements.
+     * It should be only be used with Map, Collection and array types.
+     * 
+     * @param baseContentType Assumed content (value) type before considering annotations
+     * @param propName Logical property name of the property that uses
+     *    type, if known; null for types not associated with property
+     *
+     * @return Class specifying more specific type to use instead of
+     *   declared type, if annotation found; null if not
+     */
+    public abstract Class<?> findDeserializationContentType(Annotated am, JavaType baseContentType,
+            String propName);
+
+    /*
+    /**********************************************************
+    /* Deserialization: class annotations
+    /**********************************************************
+    */
+
+    /**
+     * Method getting {@link ValueInstantiator} to use for given
+     * type (class): return value can either be an instance of
+     * instantiator, or class of instantiator to create.
+     * 
+     * @since 1.9
+     */
+    public Object findValueInstantiator(AnnotatedClass ac) {
+        return null;
+    }
+    
+    /*
+    /**********************************************************
+    /* Deserialization: method annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether given method has an annotation
+     * that suggests property name associated with method that
+     * may be a "setter". Should return null if no annotation
+     * is found; otherwise a non-null String.
+     * If non-null value is returned, it is used as the property
+     * name, except for empty String ("") which is taken to mean
+     * "use standard bean name detection if applicable;
+     * method name if not".
+     */
+    public abstract String findSettablePropertyName(AnnotatedMethod am);
+
+    /**
+     * Method for checking whether given method has an annotation
+     * that suggests that the method is to serve as "any setter";
+     * method to be used for setting values of any properties for
+     * which no dedicated setter method is found.
+     *
+     * @return True if such annotation is found (and is not disabled),
+     *   false otherwise
+     */
+    public boolean hasAnySetterAnnotation(AnnotatedMethod am) {
+        return false;
+    }
+
+    /**
+     * Method for checking whether given method has an annotation
+     * that suggests that the method is to serve as "any setter";
+     * method to be used for accessing set of miscellaneous "extra"
+     * properties, often bound with matching "any setter" method.
+     *
+     * @return True if such annotation is found (and is not disabled),
+     *   false otherwise
+     *   
+     * @since 1.6
+     */
+    public boolean hasAnyGetterAnnotation(AnnotatedMethod am) {
+        return false;
+    }
+    
+    /**
+     * Method for checking whether given annotated item (method, constructor)
+     * has an annotation
+     * that suggests that the method is a "creator" (aka factory)
+     * method to be used for construct new instances of deserialized
+     * values.
+     *
+     * @return True if such annotation is found (and is not disabled),
+     *   false otherwise
+     */
+    public boolean hasCreatorAnnotation(Annotated a) {
+        return false;
+    }
+
+    /*
+    /**********************************************************
+    /* Deserialization: field annotations
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether given member field represent
+     * a deserializable logical property; and if so, returns the
+     * name of that property.
+     * Should return null if no annotation is found (indicating it
+     * is not a deserializable field); otherwise a non-null String.
+     * If non-null value is returned, it is used as the property
+     * name, except for empty String ("") which is taken to mean
+     * "use the field name as is".
+     */
+    public abstract String findDeserializablePropertyName(AnnotatedField af);
+
+    /*
+    /**********************************************************
+    /* Deserialization: parameter annotations (for
+    /* creator method parameters)
+    /**********************************************************
+     */
+
+    /**
+     * Method for checking whether given set of annotations indicates
+     * property name for associated parameter.
+     * No actual parameter object can be passed since JDK offers no
+     * representation; just annotations.
+     */
+    public abstract String findPropertyNameForParam(AnnotatedParameter param);
+
+    /*
+    /**********************************************************
+    /* Helper classes
+    /**********************************************************
+     */
+
+    /**
+     * 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 (available
+     * since version 1.1).
+     */
+    public static class Pair
+        extends AnnotationIntrospector
+    {
+        protected final AnnotationIntrospector _primary, _secondary;
+
+        public Pair(AnnotationIntrospector p,
+                    AnnotationIntrospector s)
+        {
+            _primary = p;
+            _secondary = s;
+        }
+
+        /**
+         * 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)
+         * 
+         * @since 1.7
+         */
+        public static AnnotationIntrospector create(AnnotationIntrospector primary,
+                AnnotationIntrospector secondary)
+        {
+            if (primary == null) {
+                return secondary;
+            }
+            if (secondary == null) {
+                return primary;
+            }
+            return new Pair(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 isHandled(Annotation ann)
+        {
+            return _primary.isHandled(ann) || _secondary.isHandled(ann);
+        }
+
+        /*
+        /******************************************************
+        /* General class annotations
+        /******************************************************
+         */
+
+        @Override
+        public Boolean findCachability(AnnotatedClass ac)
+        {
+            Boolean result = _primary.findCachability(ac);
+            if (result == null) {
+                result = _secondary.findCachability(ac);
+            }
+            return result;
+        }
+
+        @Override
+        public String findRootName(AnnotatedClass ac)
+        {
+            String name1 = _primary.findRootName(ac);
+            if (name1 == null) {
+                return _secondary.findRootName(ac);
+            } else if (name1.length() > 0) {
+                return name1;
+            }
+            // name1 is empty; how about secondary?
+            String name2 = _secondary.findRootName(ac);
+            return (name2 == null) ? name1 : name2;
+        }
+
+        @Override
+        public String[] findPropertiesToIgnore(AnnotatedClass ac)
+        {
+            String[] result = _primary.findPropertiesToIgnore(ac);
+            if (result == null) {
+                result = _secondary.findPropertiesToIgnore(ac);
+            }
+            return result;            
+        }
+
+        @Override
+        public Boolean findIgnoreUnknownProperties(AnnotatedClass ac)
+        {
+            Boolean result = _primary.findIgnoreUnknownProperties(ac);
+            if (result == null) {
+                result = _secondary.findIgnoreUnknownProperties(ac);
+            }
+            return result;
+        }        
+
+        @Override
+        public Boolean isIgnorableType(AnnotatedClass ac)
+        {
+            Boolean result = _primary.isIgnorableType(ac);
+            if (result == null) {
+                result = _secondary.isIgnorableType(ac);
+            }
+            return result;
+        }
+
+        @Override
+        public Object findFilterId(AnnotatedClass ac)
+        {
+            Object id = _primary.findFilterId(ac);
+            if (id == null) {
+                id = _secondary.findFilterId(ac);
+            }
+            return id;
+        }
+        
+        /*
+        /******************************************************
+        /* Property auto-detection
+        /******************************************************
+        */
+        
+        @Override
+        public VisibilityChecker<?> findAutoDetectVisibility(AnnotatedClass ac,
+            VisibilityChecker<?> checker)
+        {
+            /* Note: to have proper priorities, we must actually call delegatees
+             * in reverse order:
+             */
+            checker = _secondary.findAutoDetectVisibility(ac, checker);
+            return _primary.findAutoDetectVisibility(ac, checker);
+        }
+
+        /*
+        /******************************************************
+        /* Type handling
+        /******************************************************
+        */
+        
+        @Override
+        public TypeResolverBuilder<?> findTypeResolver(MapperConfig<?> config,
+                AnnotatedClass ac, JavaType baseType)
+        {
+            TypeResolverBuilder<?> b = _primary.findTypeResolver(config, ac, baseType);
+            if (b == null) {
+                b = _secondary.findTypeResolver(config, ac, baseType);
+            }
+            return b;
+        }
+
+        @Override
+        public TypeResolverBuilder<?> findPropertyTypeResolver(MapperConfig<?> config,
+                AnnotatedMember am, JavaType baseType)
+        {
+            TypeResolverBuilder<?> b = _primary.findPropertyTypeResolver(config, am, baseType);
+            if (b == null) {
+                b = _secondary.findPropertyTypeResolver(config, am, baseType);
+            }
+            return b;
+        }
+
+        @Override
+        public TypeResolverBuilder<?> findPropertyContentTypeResolver(MapperConfig<?> config,
+                AnnotatedMember am, JavaType baseType)
+        {
+            TypeResolverBuilder<?> b = _primary.findPropertyContentTypeResolver(config, am, baseType);
+            if (b == null) {
+                b = _secondary.findPropertyContentTypeResolver(config, am, baseType);
+            }
+            return b;
+        }
+        
+        @Override
+        public List<NamedType> findSubtypes(Annotated a)
+        {
+            List<NamedType> types1 = _primary.findSubtypes(a);
+            List<NamedType> types2 = _secondary.findSubtypes(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(AnnotatedClass ac)
+        {
+            String name = _primary.findTypeName(ac);
+            if (name == null || name.length() == 0) {
+                name = _secondary.findTypeName(ac);                
+            }
+            return name;
+        }
+        
+        // // // General member (field, method/constructor) annotations
+        
+        @Override        
+        public ReferenceProperty findReferenceType(AnnotatedMember member)
+        {
+            ReferenceProperty ref = _primary.findReferenceType(member);
+            if (ref == null) {
+                ref = _secondary.findReferenceType(member);
+            }
+            return ref; 
+        }
+
+        @Override        
+        public Boolean shouldUnwrapProperty(AnnotatedMember member)
+        {
+            Boolean value = _primary.shouldUnwrapProperty(member);
+            if (value == null) {
+                value = _secondary.shouldUnwrapProperty(member);
+            }
+            return value;
+        }
+
+        @Override
+        public Object findInjectableValueId(AnnotatedMember m)
+        {
+            Object value = _primary.findInjectableValueId(m);
+            if (value == null) {
+                value = _secondary.findInjectableValueId(m);
+            }
+            return value;
+        }
+        
+        @Override
+        public boolean hasIgnoreMarker(AnnotatedMember m) {
+            return _primary.hasIgnoreMarker(m) || _secondary.hasIgnoreMarker(m);
+        }
+        
+        // // // General method annotations
+
+        @Override
+        public boolean isIgnorableMethod(AnnotatedMethod m) {
+            return _primary.isIgnorableMethod(m) || _secondary.isIgnorableMethod(m);
+        }
+        
+        @Override
+        public boolean isIgnorableConstructor(AnnotatedConstructor c) {
+            return _primary.isIgnorableConstructor(c) || _secondary.isIgnorableConstructor(c);
+        }
+
+        // // // General field annotations
+
+        @Override
+        public boolean isIgnorableField(AnnotatedField f)
+        {
+            return _primary.isIgnorableField(f) || _secondary.isIgnorableField(f);
+        }
+
+        // // // Serialization: general annotations
+
+        @Override
+        public Object findSerializer(Annotated am)
+        {
+            Object result = _primary.findSerializer(am);
+            if (result == null) {
+                result = _secondary.findSerializer(am);
+            }
+            return result;
+        }
+        
+        @Override
+        public Class<? extends JsonSerializer<?>> findKeySerializer(Annotated a)
+        {
+            Class<? extends JsonSerializer<?>> result = _primary.findKeySerializer(a);
+            if (result == null || result == JsonSerializer.None.class) {
+                result = _secondary.findKeySerializer(a);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<? extends JsonSerializer<?>> findContentSerializer(Annotated a)
+        {
+            Class<? extends JsonSerializer<?>> result = _primary.findContentSerializer(a);
+            if (result == null || result == JsonSerializer.None.class) {
+                result = _secondary.findContentSerializer(a);
+            }
+            return result;
+        }
+        
+        @Override
+        public JsonSerialize.Inclusion findSerializationInclusion(Annotated a,
+                JsonSerialize.Inclusion defValue)
+        {
+            /* This is bit trickier: need to combine results in a meaningful
+             * way. Seems like it should be a disjoint; that is, most
+             * restrictive value should be returned.
+             * For enumerations, comparison is done by indexes, which
+             * works: largest value is the last one, which is the most
+             * restrictive value as well.
+             */
+            /* 09-Mar-2010, tatu: Actually, as per [JACKSON-256], it is probably better to just
+             *    use strict overriding. Simpler, easier to understand.
+             */
+            // note: call secondary first, to give lower priority
+            defValue = _secondary.findSerializationInclusion(a, defValue);
+            defValue = _primary.findSerializationInclusion(a, defValue);
+            return defValue;
+        }
+        
+        @Override
+        public Class<?> findSerializationType(Annotated a)
+        {
+            Class<?> result = _primary.findSerializationType(a);
+            if (result == null) {
+                result = _secondary.findSerializationType(a);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<?> findSerializationKeyType(Annotated am, JavaType baseType)
+        {
+            Class<?> result = _primary.findSerializationKeyType(am, baseType);
+            if (result == null) {
+                result = _secondary.findSerializationKeyType(am, baseType);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<?> findSerializationContentType(Annotated am, JavaType baseType)
+        {
+            Class<?> result = _primary.findSerializationContentType(am, baseType);
+            if (result == null) {
+                result = _secondary.findSerializationContentType(am, baseType);
+            }
+            return result;
+        }
+        
+        @Override
+        public JsonSerialize.Typing findSerializationTyping(Annotated a)
+        {
+            JsonSerialize.Typing result = _primary.findSerializationTyping(a);
+            if (result == null) {
+                result = _secondary.findSerializationTyping(a);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<?>[] findSerializationViews(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.findSerializationViews(a);
+            if (result == null) {
+                result = _secondary.findSerializationViews(a);
+            }
+            return result;
+        }
+        
+        // // // Serialization: class annotations
+
+        @Override
+        public String[] findSerializationPropertyOrder(AnnotatedClass ac) {
+            String[] result = _primary.findSerializationPropertyOrder(ac);
+            if (result == null) {
+                result = _secondary.findSerializationPropertyOrder(ac);
+            }
+            return result;            
+        }
+
+        /**
+         * Method for checking whether an annotation indicates that serialized properties
+         * for which no explicit is defined should be alphabetically (lexicograpically)
+         * ordered
+         */
+        @Override
+        public Boolean findSerializationSortAlphabetically(AnnotatedClass ac) {
+            Boolean result = _primary.findSerializationSortAlphabetically(ac);
+            if (result == null) {
+                result = _secondary.findSerializationSortAlphabetically(ac);
+            }
+            return result;            
+        }
+
+        // // // Serialization: method annotations
+        
+        @Override
+        public String findGettablePropertyName(AnnotatedMethod am)
+        {
+            String result = _primary.findGettablePropertyName(am);
+            if (result == null) {
+                result = _secondary.findGettablePropertyName(am);
+            } else if (result.length() == 0) {
+                /* Empty String is a default; can be overridden by
+                 * more explicit answer from secondary entry
+                 */
+                String str2 = _secondary.findGettablePropertyName(am);
+                if (str2 != null) {
+                    result = str2;
+                }
+            }
+            return result;
+        }
+        
+        @Override
+        public boolean hasAsValueAnnotation(AnnotatedMethod am)
+        {
+            return _primary.hasAsValueAnnotation(am) || _secondary.hasAsValueAnnotation(am);
+        }
+        
+        @Override
+        public String findEnumValue(Enum<?> value)
+        {
+            String result = _primary.findEnumValue(value);
+            if (result == null) {
+                result = _secondary.findEnumValue(value);
+            }
+            return result;
+        }        
+
+        // // // Serialization: field annotations
+
+        @Override
+        public String findSerializablePropertyName(AnnotatedField af)
+        {
+            String result = _primary.findSerializablePropertyName(af);
+            if (result == null) {
+                result = _secondary.findSerializablePropertyName(af);
+            } else if (result.length() == 0) {
+                /* Empty String is a default; can be overridden by
+                 * more explicit answer from secondary entry
+                 */
+                String str2 = _secondary.findSerializablePropertyName(af);
+                if (str2 != null) {
+                    result = str2;
+                }
+            }
+            return result;
+        }
+
+        // // // Deserialization: general annotations
+
+        @Override
+        public Object findDeserializer(Annotated am)
+        {
+            Object result = _primary.findDeserializer(am);
+            if (result == null) {
+                result = _secondary.findDeserializer(am);
+            }
+            return result;
+        }
+        
+        @Override
+        public Class<? extends KeyDeserializer> findKeyDeserializer(Annotated am)
+        {
+            Class<? extends KeyDeserializer> result = _primary.findKeyDeserializer(am);
+            if (result == null || result == KeyDeserializer.None.class) {
+                result = _secondary.findKeyDeserializer(am);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<? extends JsonDeserializer<?>> findContentDeserializer(Annotated am)
+        {
+            Class<? extends JsonDeserializer<?>> result = _primary.findContentDeserializer(am);
+            if (result == null || result == JsonDeserializer.None.class) {
+                result = _secondary.findContentDeserializer(am);
+            }
+            return result;
+        }
+        
+        @Override
+        public Class<?> findDeserializationType(Annotated am, JavaType baseType,
+                String propName)
+        {
+            Class<?> result = _primary.findDeserializationType(am, baseType, propName);
+            if (result == null) {
+                result = _secondary.findDeserializationType(am, baseType, propName);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<?> findDeserializationKeyType(Annotated am, JavaType baseKeyType,
+                String propName)
+        {
+            Class<?> result = _primary.findDeserializationKeyType(am, baseKeyType, propName);
+            if (result == null) {
+                result = _secondary.findDeserializationKeyType(am, baseKeyType, propName);
+            }
+            return result;
+        }
+
+        @Override
+        public Class<?> findDeserializationContentType(Annotated am, JavaType baseContentType,
+                String propName)
+        {
+            Class<?> result = _primary.findDeserializationContentType(am, baseContentType, propName);
+            if (result == null) {
+                result = _secondary.findDeserializationContentType(am, baseContentType, propName);
+            }
+            return result;
+        }
+
+        // // // Deserialization: class annotations
+
+        @Override
+        public Object findValueInstantiator(AnnotatedClass ac)
+        {
+            Object result = _primary.findValueInstantiator(ac);
+            if (result == null) {
+                result = _secondary.findValueInstantiator(ac);
+            }
+            return result;
+        }
+
+        // // // Deserialization: method annotations
+
+        @Override
+        public String findSettablePropertyName(AnnotatedMethod am)
+        {
+            String result = _primary.findSettablePropertyName(am);
+            if (result == null) {
+                result = _secondary.findSettablePropertyName(am);
+            } else if (result.length() == 0) {
+                /* Empty String is a default; can be overridden by
+                 * more explicit answer from secondary entry
+                 */
+                String str2 = _secondary.findSettablePropertyName(am);
+                if (str2 != null) {
+                    result = str2;
+                }
+            }
+            return result;
+        }
+        
+        @Override
+        public boolean hasAnySetterAnnotation(AnnotatedMethod am)
+        {
+            return _primary.hasAnySetterAnnotation(am) || _secondary.hasAnySetterAnnotation(am);
+        }
+
+        @Override
+        public boolean hasAnyGetterAnnotation(AnnotatedMethod am)
+        {
+            return _primary.hasAnyGetterAnnotation(am) || _secondary.hasAnyGetterAnnotation(am);
+        }
+        
+        @Override
+        public boolean hasCreatorAnnotation(Annotated a)
+        {
+            return _primary.hasCreatorAnnotation(a) || _secondary.hasCreatorAnnotation(a);
+        }
+        
+        // // // Deserialization: field annotations
+
+        @Override
+        public String findDeserializablePropertyName(AnnotatedField af)
+        {
+            String result = _primary.findDeserializablePropertyName(af);
+            if (result == null) {
+                result = _secondary.findDeserializablePropertyName(af);
+            } else if (result.length() == 0) {
+                /* Empty String is a default; can be overridden by
+                 * more explicit answer from secondary entry
+                 */
+                String str2 = _secondary.findDeserializablePropertyName(af);
+                if (str2 != null) {
+                    result = str2;
+                }
+            }
+            return result;
+        }
+
+        // // // Deserialization: parameter annotations (for creators)
+
+        @Override
+        public String findPropertyNameForParam(AnnotatedParameter param)
+        {
+            String result = _primary.findPropertyNameForParam(param);
+            if (result == null) {
+                result = _secondary.findPropertyNameForParam(param);
+            }
+            return result;
+        }
+    }
+
+}