Package org.codehaus.jackson.map
Interface Module.SetupContext
-
- Enclosing class:
- Module
public static interface Module.SetupContextInterface Jackson exposes to modules for purpose of registering extended functionality.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddAbstractTypeResolver(AbstractTypeResolver resolver)Method that module can use to register additionalAbstractTypeResolverinstance, to handle resolution of abstract to concrete types (either by defaulting, or by materializing).voidaddBeanDeserializerModifier(BeanDeserializerModifier mod)Method that module can use to register additional modifier objects to customize configuration and construction of bean deserializers.voidaddBeanSerializerModifier(BeanSerializerModifier mod)Method that module can use to register additional modifier objects to customize configuration and construction of bean serializers.voidaddDeserializers(Deserializers d)Method that module can use to register additional deserializers to use for handling types.voidaddKeyDeserializers(KeyDeserializers s)Method that module can use to register additional deserializers to use for handling Map key values (which are separate from value deserializers because they are always serialized from String values)voidaddKeySerializers(Serializers s)Method that module can use to register additional serializers to use for handling Map key values (which are separate from value serializers because they must writeJsonToken.FIELD_NAMEinstead of String value).voidaddSerializers(Serializers s)Method that module can use to register additional serializers to use for handling types.voidaddTypeModifier(TypeModifier modifier)Method that module can use to register additionalTypeModifierinstance, which can augmentJavaTypeinstances constructed byTypeFactory.voidaddValueInstantiators(ValueInstantiators instantiators)Method that module can use to register additionalValueInstantiators, by addingValueInstantiatorsobject that gets called when instantatiator is needed by a deserializer.voidappendAnnotationIntrospector(AnnotationIntrospector ai)Method for registering specifiedAnnotationIntrospectoras the lowest priority introspector, chained with existing introspector(s) and called as fallback for cases not otherwise handled.DeserializationConfiggetDeserializationConfig()Method that returns current deserialization configuration settings.VersiongetMapperVersion()Method that returns version information aboutObjectMapperthat implements this context.SerializationConfiggetSerializationConfig()Method that returns current serialization configuration settings.voidinsertAnnotationIntrospector(AnnotationIntrospector ai)Method for registering specifiedAnnotationIntrospectoras the highest priority introspector (will be chained with existing introspector(s) which will be used as fallbacks for cases this introspector does not handle)booleanisEnabled(JsonGenerator.Feature f)booleanisEnabled(JsonParser.Feature f)booleanisEnabled(DeserializationConfig.Feature f)booleanisEnabled(SerializationConfig.Feature f)voidsetMixInAnnotations(Class<?> target, Class<?> mixinSource)Method used for defining mix-in annotations to use for augmenting specified class or interface.
-
-
-
Method Detail
-
getMapperVersion
Version getMapperVersion()
Method that returns version information aboutObjectMapperthat implements this context. Modules can use this to choose different settings or initialization order; or even decide to fail set up completely if version is compatible with module.
-
getDeserializationConfig
DeserializationConfig getDeserializationConfig()
Method that returns current deserialization configuration settings. Since modules may be interested in these settings, caller should make sure to make changes to settings before module registrations.
-
getSerializationConfig
SerializationConfig getSerializationConfig()
Method that returns current serialization configuration settings. Since modules may be interested in these settings, caller should make sure to make changes to settings before module registrations.- Since:
- 1.7.1 (1.7.0 unfortunately had a typo in method name!)
-
isEnabled
boolean isEnabled(DeserializationConfig.Feature f)
- Since:
- 1.9.0
-
isEnabled
boolean isEnabled(SerializationConfig.Feature f)
- Since:
- 1.9.0
-
isEnabled
boolean isEnabled(JsonParser.Feature f)
- Since:
- 1.9.0
-
isEnabled
boolean isEnabled(JsonGenerator.Feature f)
- Since:
- 1.9.0
-
addDeserializers
void addDeserializers(Deserializers d)
Method that module can use to register additional deserializers to use for handling types.- Parameters:
d- Object that can be called to find deserializer for types supported by module (null returned for non-supported types)
-
addKeyDeserializers
void addKeyDeserializers(KeyDeserializers s)
Method that module can use to register additional deserializers to use for handling Map key values (which are separate from value deserializers because they are always serialized from String values)- Since:
- 1.8
-
addSerializers
void addSerializers(Serializers s)
Method that module can use to register additional serializers to use for handling types.- Parameters:
s- Object that can be called to find serializer for types supported by module (null returned for non-supported types)
-
addKeySerializers
void addKeySerializers(Serializers s)
Method that module can use to register additional serializers to use for handling Map key values (which are separate from value serializers because they must writeJsonToken.FIELD_NAMEinstead of String value).- Since:
- 1.8
-
addBeanDeserializerModifier
void addBeanDeserializerModifier(BeanDeserializerModifier mod)
Method that module can use to register additional modifier objects to customize configuration and construction of bean deserializers.- Parameters:
mod- Modifier to register
-
addBeanSerializerModifier
void addBeanSerializerModifier(BeanSerializerModifier mod)
Method that module can use to register additional modifier objects to customize configuration and construction of bean serializers.- Parameters:
mod- Modifier to register
-
addAbstractTypeResolver
void addAbstractTypeResolver(AbstractTypeResolver resolver)
Method that module can use to register additionalAbstractTypeResolverinstance, to handle resolution of abstract to concrete types (either by defaulting, or by materializing).- Parameters:
resolver- Resolver to add.- Since:
- 1.8
-
addTypeModifier
void addTypeModifier(TypeModifier modifier)
Method that module can use to register additionalTypeModifierinstance, which can augmentJavaTypeinstances constructed byTypeFactory.- Parameters:
modifier- to add- Since:
- 1.8
-
addValueInstantiators
void addValueInstantiators(ValueInstantiators instantiators)
Method that module can use to register additionalValueInstantiators, by addingValueInstantiatorsobject that gets called when instantatiator is needed by a deserializer.- Parameters:
instantiators- Object that can provideValueInstantiators for constructing POJO values during deserialization- Since:
- 1.9
-
insertAnnotationIntrospector
void insertAnnotationIntrospector(AnnotationIntrospector ai)
Method for registering specifiedAnnotationIntrospectoras the highest priority introspector (will be chained with existing introspector(s) which will be used as fallbacks for cases this introspector does not handle)- Parameters:
ai- Annotation introspector to register.
-
appendAnnotationIntrospector
void appendAnnotationIntrospector(AnnotationIntrospector ai)
Method for registering specifiedAnnotationIntrospectoras the lowest priority introspector, chained with existing introspector(s) and called as fallback for cases not otherwise handled.- Parameters:
ai- Annotation introspector to register.
-
setMixInAnnotations
void setMixInAnnotations(Class<?> target, Class<?> mixinSource)
Method used for defining mix-in annotations to use for augmenting specified class or interface. All annotations frommixinSourceare taken to override annotations thattarget(or its supertypes) has.Note: mix-ins are registered both for serialization and deserialization (which can be different internally).
Note: currently only one set of mix-in annotations can be defined for a single class; so if multiple modules register mix-ins, highest priority one (last one registered) will have priority over other modules.
- Parameters:
target- Class (or interface) whose annotations to effectively overridemixinSource- Class (or interface) whose annotations are to be "added" to target's annotations, overriding as necessary
-
-