|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.codehaus.jackson.map.MapperConfig<SerializationConfig>
org.codehaus.jackson.map.SerializationConfig
public class SerializationConfig
Object that contains baseline configuration for serialization
process. An instance is owned by ObjectMapper
, which makes
a copy that is passed during serialization process to
SerializerProvider
and SerializerFactory
.
Note: although configuration settings can be changed at any time (for factories and instances), they are not guaranteed to have effect if called after constructing relevant mapper or serializer instance. This because some objects may be configured, constructed and cached first time they are needed.
Nested Class Summary | |
---|---|
static class |
SerializationConfig.Feature
Enumeration that defines togglable features that guide the serialization feature. |
Nested classes/interfaces inherited from class org.codehaus.jackson.map.MapperConfig |
---|
MapperConfig.Base |
Field Summary | |
---|---|
protected int |
_featureFlags
|
protected FilterProvider |
_filterProvider
Object used for resolving filter ids to filter instances. |
protected JsonSerialize.Inclusion |
_serializationInclusion
Which Bean/Map properties are to be included in serialization? Default settings is to include all regardless of value; can be changed to only include non-null properties, or properties with non-default values. |
protected Class<?> |
_serializationView
View to use for filtering out properties to serialize. |
protected static int |
DEFAULT_FEATURE_FLAGS
Bitfield (set of flags) of all Features that are enabled by default. |
Fields inherited from class org.codehaus.jackson.map.MapperConfig |
---|
_base, _mixInAnnotations, _mixInAnnotationsShared, _subtypeResolver, DEFAULT_DATE_FORMAT |
Constructor Summary | |
---|---|
|
SerializationConfig(ClassIntrospector<? extends BeanDescription> intr,
AnnotationIntrospector annIntr,
VisibilityChecker<?> vc,
SubtypeResolver subtypeResolver,
PropertyNamingStrategy propertyNamingStrategy,
TypeFactory typeFactory,
HandlerInstantiator handlerInstantiator)
Constructor used by ObjectMapper to create default configuration object instance. |
protected |
SerializationConfig(SerializationConfig src)
|
protected |
SerializationConfig(SerializationConfig src,
Class<?> view)
|
protected |
SerializationConfig(SerializationConfig src,
FilterProvider filters)
|
protected |
SerializationConfig(SerializationConfig src,
HashMap<ClassKey,Class<?>> mixins,
SubtypeResolver str)
Constructor used to make a private copy of specific mix-in definitions. |
protected |
SerializationConfig(SerializationConfig src,
MapperConfig.Base base)
|
Method Summary | ||
---|---|---|
boolean |
canOverrideAccessModifiers()
Accessor for determining whether it is ok to try to force override of access modifiers to be able to get or set values of non-public Methods, Fields; to invoke non-public Constructors, Methods; or to instantiate non-public Classes. |
|
SerializationConfig |
createUnshared(SubtypeResolver subtypeResolver)
Method to use for constructing an instance that is not shared between multiple operations but only used for a single one (which may be this instance, if it is immutable; if not, a copy is constructed with same settings) |
|
SerializationConfig |
createUnshared(TypeResolverBuilder<?> typer,
VisibilityChecker<?> vc,
SubtypeResolver str)
Deprecated. Since 1.8 should use variant without arguments |
|
void |
disable(SerializationConfig.Feature f)
Method for disabling specified feature. |
|
void |
enable(SerializationConfig.Feature f)
Method for enabling specified feature. |
|
void |
fromAnnotations(Class<?> cls)
Method that checks class annotations that the argument Object has, and modifies settings of this configuration object accordingly, similar to how those annotations would affect actual value classes annotated with them, but with global scope. |
|
AnnotationIntrospector |
getAnnotationIntrospector()
Method for getting AnnotationIntrospector configured
to introspect annotation values used for configuration. |
|
FilterProvider |
getFilterProvider()
Method for getting provider used for locating filters given id (which is usually provided with filter annotations). |
|
JsonSerialize.Inclusion |
getSerializationInclusion()
|
|
Class<?> |
getSerializationView()
Method for checking which serialization view is being used, if any; null if none. |
|
|
introspect(JavaType type)
Method that will introspect full bean properties for the purpose of building a bean serializer |
|
|
introspectClassAnnotations(Class<?> cls)
Accessor for getting bean description that only contains class annotations: useful if no getter/setter/creator information is needed. |
|
|
introspectDirectClassAnnotations(Class<?> cls)
Accessor for getting bean description that only contains immediate class annotations: ones from the class, and its direct mix-in, if any, but not from super types. |
|
boolean |
isAnnotationProcessingEnabled()
Method for determining whether annotation processing is enabled or not (default settings are typically that it is enabled; must explicitly disable). |
|
boolean |
isEnabled(SerializationConfig.Feature f)
Method for checking whether given feature is enabled or not |
|
JsonSerializer<Object> |
serializerInstance(Annotated annotated,
Class<? extends JsonSerializer<?>> serClass)
|
|
void |
set(SerializationConfig.Feature f,
boolean state)
Method for enabling or disabling specified feature. |
|
void |
setDateFormat(DateFormat df)
Deprecated. Since 1.8, use withDateFormat(java.text.DateFormat) instead. |
|
void |
setSerializationInclusion(JsonSerialize.Inclusion props)
Method that will define global setting of which bean/map properties are to be included in serialization. |
|
void |
setSerializationView(Class<?> view)
Deprecated. Since 1.8, use withView(java.lang.Class>) instead |
|
String |
toString()
|
|
SerializationConfig |
withAnnotationIntrospector(AnnotationIntrospector ai)
Method for constructing and returning a new instance with different AnnotationIntrospector
to use (replacing old one). |
|
SerializationConfig |
withClassIntrospector(ClassIntrospector<? extends BeanDescription> ci)
Method for constructing and returning a new instance with different ClassIntrospector
to use. |
|
SerializationConfig |
withDateFormat(DateFormat df)
In addition to constructing instance with specified date format, will enable or disable Feature.WRITE_DATES_AS_TIMESTAMPS
(enable if format set as null; disable if non-null) |
|
SerializationConfig |
withFilters(FilterProvider filterProvider)
|
|
SerializationConfig |
withHandlerInstantiator(HandlerInstantiator hi)
Method for constructing and returning a new instance with different HandlerInstantiator
to use. |
|
SerializationConfig |
withPropertyNamingStrategy(PropertyNamingStrategy pns)
Method for constructing and returning a new instance with different PropertyNamingStrategy
to use. |
|
SerializationConfig |
withSubtypeResolver(SubtypeResolver str)
Method for constructing and returning a new instance with different SubtypeResolver
to use. |
|
SerializationConfig |
withTypeFactory(TypeFactory tf)
Method for constructing and returning a new instance with different TypeFactory
to use. |
|
SerializationConfig |
withTypeResolverBuilder(TypeResolverBuilder<?> trb)
Method for constructing and returning a new instance with different TypeResolverBuilder
to use. |
|
SerializationConfig |
withView(Class<?> view)
|
|
SerializationConfig |
withVisibilityChecker(VisibilityChecker<?> vc)
Method for constructing and returning a new instance with different VisibilityChecker
to use. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected static final int DEFAULT_FEATURE_FLAGS
protected int _featureFlags
protected JsonSerialize.Inclusion _serializationInclusion
Defaults to null for backwards compatibility; if left as null,
will check
deprecated SerializationConfig.Feature.WRITE_NULL_PROPERTIES
to choose between JsonSerialize.Inclusion.ALWAYS
and JsonSerialize.Inclusion.NON_NULL
.
protected Class<?> _serializationView
Object.class
is defined), meaning that all properties are to be included.
protected FilterProvider _filterProvider
Constructor Detail |
---|
public SerializationConfig(ClassIntrospector<? extends BeanDescription> intr, AnnotationIntrospector annIntr, VisibilityChecker<?> vc, SubtypeResolver subtypeResolver, PropertyNamingStrategy propertyNamingStrategy, TypeFactory typeFactory, HandlerInstantiator handlerInstantiator)
protected SerializationConfig(SerializationConfig src)
protected SerializationConfig(SerializationConfig src, HashMap<ClassKey,Class<?>> mixins, SubtypeResolver str)
protected SerializationConfig(SerializationConfig src, MapperConfig.Base base)
protected SerializationConfig(SerializationConfig src, FilterProvider filters)
protected SerializationConfig(SerializationConfig src, Class<?> view)
Method Detail |
---|
public SerializationConfig withClassIntrospector(ClassIntrospector<? extends BeanDescription> ci)
MapperConfig
ClassIntrospector
to use.
withClassIntrospector
in class MapperConfig<SerializationConfig>
public SerializationConfig withAnnotationIntrospector(AnnotationIntrospector ai)
MapperConfig
AnnotationIntrospector
to use (replacing old one).
withAnnotationIntrospector
in class MapperConfig<SerializationConfig>
public SerializationConfig withVisibilityChecker(VisibilityChecker<?> vc)
MapperConfig
VisibilityChecker
to use.
withVisibilityChecker
in class MapperConfig<SerializationConfig>
public SerializationConfig withTypeResolverBuilder(TypeResolverBuilder<?> trb)
MapperConfig
TypeResolverBuilder
to use.
withTypeResolverBuilder
in class MapperConfig<SerializationConfig>
public SerializationConfig withSubtypeResolver(SubtypeResolver str)
MapperConfig
SubtypeResolver
to use.
withSubtypeResolver
in class MapperConfig<SerializationConfig>
public SerializationConfig withPropertyNamingStrategy(PropertyNamingStrategy pns)
MapperConfig
PropertyNamingStrategy
to use.
withPropertyNamingStrategy
in class MapperConfig<SerializationConfig>
public SerializationConfig withTypeFactory(TypeFactory tf)
MapperConfig
TypeFactory
to use.
withTypeFactory
in class MapperConfig<SerializationConfig>
public SerializationConfig withDateFormat(DateFormat df)
Feature.WRITE_DATES_AS_TIMESTAMPS
(enable if format set as null; disable if non-null)
withDateFormat
in class MapperConfig<SerializationConfig>
public SerializationConfig withHandlerInstantiator(HandlerInstantiator hi)
MapperConfig
HandlerInstantiator
to use.
withHandlerInstantiator
in class MapperConfig<SerializationConfig>
public SerializationConfig withFilters(FilterProvider filterProvider)
public SerializationConfig withView(Class<?> view)
public void fromAnnotations(Class<?> cls)
Serialization annotations that are known to have effect are:
fromAnnotations
in class MapperConfig<SerializationConfig>
cls
- Class of which class annotations to use
for changing configuration settingspublic SerializationConfig createUnshared(SubtypeResolver subtypeResolver)
MapperConfig
createUnshared
in class MapperConfig<SerializationConfig>
public AnnotationIntrospector getAnnotationIntrospector()
MapperConfig
AnnotationIntrospector
configured
to introspect annotation values used for configuration.
Non-final since it is actually overridden by sub-classes (for now?)
getAnnotationIntrospector
in class MapperConfig<SerializationConfig>
public <T extends BeanDescription> T introspectClassAnnotations(Class<?> cls)
Note: part of MapperConfig
since 1.7
introspectClassAnnotations
in class MapperConfig<SerializationConfig>
public <T extends BeanDescription> T introspectDirectClassAnnotations(Class<?> cls)
Note: part of MapperConfig
since 1.7
introspectDirectClassAnnotations
in class MapperConfig<SerializationConfig>
public boolean isAnnotationProcessingEnabled()
MapperConfig
isAnnotationProcessingEnabled
in class MapperConfig<SerializationConfig>
public boolean canOverrideAccessModifiers()
MapperConfig
canOverrideAccessModifiers
in class MapperConfig<SerializationConfig>
public void enable(SerializationConfig.Feature f)
public void disable(SerializationConfig.Feature f)
public void set(SerializationConfig.Feature f, boolean state)
public final boolean isEnabled(SerializationConfig.Feature f)
public Class<?> getSerializationView()
public JsonSerialize.Inclusion getSerializationInclusion()
public void setSerializationInclusion(JsonSerialize.Inclusion props)
public FilterProvider getFilterProvider()
ObjectWriter
(or if serialization directly called from ObjectMapper
)
public <T extends BeanDescription> T introspect(JavaType type)
public JsonSerializer<Object> serializerInstance(Annotated annotated, Class<? extends JsonSerializer<?>> serClass)
@Deprecated public SerializationConfig createUnshared(TypeResolverBuilder<?> typer, VisibilityChecker<?> vc, SubtypeResolver str)
createUnshared
in class MapperConfig<SerializationConfig>
@Deprecated public final void setDateFormat(DateFormat df)
withDateFormat(java.text.DateFormat)
instead.
SerializationConfig.Feature.WRITE_DATES_AS_TIMESTAMPS
to false (if null format set), or true (if non-null format)
setDateFormat
in class MapperConfig<SerializationConfig>
@Deprecated public void setSerializationView(Class<?> view)
withView(java.lang.Class>)
instead
public String toString()
toString
in class Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |