Interface TypeResolverBuilder<T extends TypeResolverBuilder<T>>

All Known Implementing Classes:
ObjectMapper.DefaultTypeResolverBuilder, StdTypeResolverBuilder

public interface TypeResolverBuilder<T extends TypeResolverBuilder<T>>
Interface that defines builders that are configured based on annotations (like JsonTypeInfo or JAXB annotations), and produce type serializers and deserializers used for handling type information embedded in JSON to allow for safe polymorphic type handling.

Builder is first initialized by calling init(com.fasterxml.jackson.annotation.JsonTypeInfo.Id, com.fasterxml.jackson.databind.jsontype.TypeIdResolver) method, and then configured using 'set' methods like inclusion(com.fasterxml.jackson.annotation.JsonTypeInfo.As). Finally, after calling all configuration methods, buildTypeSerializer(com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.JavaType, java.util.Collection<com.fasterxml.jackson.databind.jsontype.NamedType>) or buildTypeDeserializer(com.fasterxml.jackson.databind.DeserializationConfig, com.fasterxml.jackson.databind.JavaType, java.util.Collection<com.fasterxml.jackson.databind.jsontype.NamedType>) will be called to get actual type resolver constructed and used for resolving types for configured base type and its subtypes.

Note that instances are used for two related but distinct use cases:

  • To create builders to use with explicit type information inclusion (usually via @JsonTypeInfo annotation)
  • To create builders when "default typing" is used; if so, type information is automatically included for certain kind of types, regardless of annotations
Important distinction between the cases is that in first case, calls to create builders are only made when builders are certainly needed; whereas in second case builder has to first verify whether type information is applicable for given type, and if not, just return null to indicate this.
  • Method Summary

    Modifier and Type
    Method
    Description
    Method for building type deserializer based on current configuration of this builder.
    Method for building type serializer based on current configuration of this builder.
    defaultImpl(Class<?> defaultImpl)
    Method for specifying default implementation to use if type id is either not available, or cannot be resolved.
    Accessor for currently configured default type; implementation class that may be used in case no valid type information is available during type resolution
    inclusion(com.fasterxml.jackson.annotation.JsonTypeInfo.As includeAs)
    Method for specifying mechanism to use for including type metadata in JSON.
    init(com.fasterxml.jackson.annotation.JsonTypeInfo.Id idType, TypeIdResolver res)
    Initialization method that is called right after constructing the builder instance.
    default T
    init(com.fasterxml.jackson.annotation.JsonTypeInfo.Value settings, TypeIdResolver res)
    Initialization method that is called right after constructing the builder instance, in cases where information could not be passed directly (for example when instantiated for an annotation)
    typeIdVisibility(boolean isVisible)
    Method for specifying whether type id should be visible to JsonDeserializers or not.
    typeProperty(String propName)
    Method for specifying name of property used for including type information.
    default T
    withDefaultImpl(Class<?> defaultImpl)
    "Mutant factory" method for creating a new instance with different default implementation.
    default T
    withSettings(com.fasterxml.jackson.annotation.JsonTypeInfo.Value typeInfo)
    Method for overriding type information.
  • Method Details

    • getDefaultImpl

      Class<?> getDefaultImpl()
      Accessor for currently configured default type; implementation class that may be used in case no valid type information is available during type resolution
    • buildTypeSerializer

      TypeSerializer buildTypeSerializer(SerializationConfig config, JavaType baseType, Collection<NamedType> subtypes)
      Method for building type serializer based on current configuration of this builder.
      Parameters:
      baseType - Base type that constructed resolver will handle; super type of all types it will be used for.
    • buildTypeDeserializer

      TypeDeserializer buildTypeDeserializer(DeserializationConfig config, JavaType baseType, Collection<NamedType> subtypes)
      Method for building type deserializer based on current configuration of this builder.
      Parameters:
      baseType - Base type that constructed resolver will handle; super type of all types it will be used for.
      subtypes - Known subtypes of the base type.
    • init

      T init(com.fasterxml.jackson.annotation.JsonTypeInfo.Id idType, TypeIdResolver res)
      Initialization method that is called right after constructing the builder instance.
      Parameters:
      idType - Which type metadata is used
      res - (optional) Custom type id resolver used, if any
      Returns:
      Resulting builder instance (usually this builder, but not necessarily)
    • init

      default T init(com.fasterxml.jackson.annotation.JsonTypeInfo.Value settings, TypeIdResolver res)
      Initialization method that is called right after constructing the builder instance, in cases where information could not be passed directly (for example when instantiated for an annotation)

      NOTE: This method is abstract in Jackson 3.0, at the moment of writing.

      Parameters:
      settings - Configuration settings to apply.
      Returns:
      Resulting builder instance (usually this builder, but not necessarily)
      Since:
      2.16 (backported from Jackson 3.0)
    • inclusion

      T inclusion(com.fasterxml.jackson.annotation.JsonTypeInfo.As includeAs)
      Method for specifying mechanism to use for including type metadata in JSON. If not explicitly called, setting defaults to JsonTypeInfo.As.PROPERTY.
      Parameters:
      includeAs - Mechanism used for including type metadata in JSON
      Returns:
      Resulting builder instance (usually this builder, but may be a newly constructed instance for immutable builders}
    • typeProperty

      T typeProperty(String propName)
      Method for specifying name of property used for including type information. Not used for all inclusion mechanisms; usually only used with JsonTypeInfo.As.PROPERTY.

      If not explicitly called, name of property to use is based on defaults for JsonTypeInfo.Id configured.

      Parameters:
      propName - Name of JSON property to use for including type information
      Returns:
      Resulting builder instance (usually this builder, but may be a newly constructed instance for immutable builders}
    • defaultImpl

      T defaultImpl(Class<?> defaultImpl)
      Method for specifying default implementation to use if type id is either not available, or cannot be resolved.
      Returns:
      Resulting builder instance (usually this builder, but may be a newly constructed instance for immutable builders}
    • typeIdVisibility

      T typeIdVisibility(boolean isVisible)
      Method for specifying whether type id should be visible to JsonDeserializers or not.
      Returns:
      Resulting builder instance (usually this builder, but may be a newly constructed instance for immutable builders}
      Since:
      2.0
    • withDefaultImpl

      default T withDefaultImpl(Class<?> defaultImpl)
      "Mutant factory" method for creating a new instance with different default implementation.
      Returns:
      Either this instance (if nothing changed) or a new instance with different default implementation
      Since:
      2.13
    • withSettings

      default T withSettings(com.fasterxml.jackson.annotation.JsonTypeInfo.Value typeInfo)
      Method for overriding type information.
      Since:
      2.16