public class MapSerializer extends ContainerSerializer<Map<?,?>> implements ContextualSerializer
Note: about the only configurable setting currently is ability to filter out entries with specified names.
JsonSerializer.None| Modifier and Type | Field and Description | 
|---|---|
| protected PropertySerializerMap | _dynamicValueSerializersIf value type cannot be statically determined, mapping from
 runtime value types to serializers are stored in this object. | 
| protected Object | _filterIdId of the property filter to use, if any; null if none. | 
| protected Set<String> | _ignoredEntriesSet of entries to omit during serialization, if any | 
| protected Set<String> | _includedEntriesSet of entries to include during serialization, if null, it is ignored, empty will include nothing. | 
| protected IgnorePropertiesUtil.Checker | _inclusionCheckerHelper object used for name-based filtering | 
| protected JsonSerializer<Object> | _keySerializerKey serializer to use, if it can be statically determined | 
| protected JavaType | _keyTypeDeclared type of keys | 
| protected BeanProperty | _propertyMap-valued property being serialized with this instance | 
| protected boolean | _sortKeysFlag set if output is forced to be sorted by keys (usually due
 to annotation). | 
| protected Object | _suppressableValueValue that indicates suppression mechanism to use for values contained;
 either "filter" (of which  equals()is called), or marker
 value ofMARKER_FOR_EMPTY, or null to indicate no filtering for
 non-null values. | 
| protected boolean | _suppressNullsFlag that indicates what to do with `null` values, distinct from
 handling of  _suppressableValue | 
| protected JsonSerializer<Object> | _valueSerializerValue serializer to use, if it can be statically determined | 
| protected JavaType | _valueTypeDeclared type of contained values | 
| protected boolean | _valueTypeIsStaticWhether static types should be used for serialization of values
 or not (if not, dynamic runtime type is used) | 
| protected TypeSerializer | _valueTypeSerializerType identifier serializer used for values, if any. | 
| static Object | MARKER_FOR_EMPTY | 
| protected static JavaType | UNSPECIFIED_TYPE | 
_handledType| Modifier | Constructor and Description | 
|---|---|
| protected  | MapSerializer(MapSerializer src,
             BeanProperty property,
             JsonSerializer<?> keySerializer,
             JsonSerializer<?> valueSerializer,
             Set<String> ignoredEntries)Deprecated. 
 in 2.12, remove from 3.0 | 
| protected  | MapSerializer(MapSerializer src,
             BeanProperty property,
             JsonSerializer<?> keySerializer,
             JsonSerializer<?> valueSerializer,
             Set<String> ignoredEntries,
             Set<String> includedEntries) | 
| protected  | MapSerializer(MapSerializer src,
             Object filterId,
             boolean sortKeys) | 
| protected  | MapSerializer(MapSerializer src,
             TypeSerializer vts,
             Object suppressableValue)Deprecated. 
 // since 2.9 | 
| protected  | MapSerializer(MapSerializer src,
             TypeSerializer vts,
             Object suppressableValue,
             boolean suppressNulls) | 
| protected  | MapSerializer(Set<String> ignoredEntries,
             JavaType keyType,
             JavaType valueType,
             boolean valueTypeIsStatic,
             TypeSerializer vts,
             JsonSerializer<?> keySerializer,
             JsonSerializer<?> valueSerializer)Deprecated. 
 in 2.12, remove from 3.0 | 
| protected  | MapSerializer(Set<String> ignoredEntries,
             Set<String> includedEntries,
             JavaType keyType,
             JavaType valueType,
             boolean valueTypeIsStatic,
             TypeSerializer vts,
             JsonSerializer<?> keySerializer,
             JsonSerializer<?> valueSerializer) | 
| Modifier and Type | Method and Description | 
|---|---|
| protected void | _ensureOverride()Deprecated.  | 
| protected void | _ensureOverride(String method) | 
| protected JsonSerializer<Object> | _findAndAddDynamic(PropertySerializerMap map,
                  Class<?> type,
                  SerializerProvider provider) | 
| protected JsonSerializer<Object> | _findAndAddDynamic(PropertySerializerMap map,
                  JavaType type,
                  SerializerProvider provider) | 
| protected boolean | _hasNullKey(Map<?,?> input) | 
| protected Map<?,?> | _orderEntries(Map<?,?> input,
             com.fasterxml.jackson.core.JsonGenerator gen,
             SerializerProvider provider) | 
| MapSerializer | _withValueTypeSerializer(TypeSerializer vts)Method that needs to be implemented to allow construction of a new
 serializer object with given  TypeSerializer, used when
 addition type information is to be embedded. | 
| protected void | _writeNullKeyedEntry(com.fasterxml.jackson.core.JsonGenerator gen,
                    SerializerProvider provider,
                    Object value) | 
| void | acceptJsonFormatVisitor(JsonFormatVisitorWrapper visitor,
                       JavaType typeHint)Default implementation specifies no format. | 
| static MapSerializer | construct(Set<String> ignoredEntries,
         JavaType mapType,
         boolean staticValueType,
         TypeSerializer vts,
         JsonSerializer<Object> keySerializer,
         JsonSerializer<Object> valueSerializer,
         Object filterId) | 
| static MapSerializer | construct(Set<String> ignoredEntries,
         Set<String> includedEntries,
         JavaType mapType,
         boolean staticValueType,
         TypeSerializer vts,
         JsonSerializer<Object> keySerializer,
         JsonSerializer<Object> valueSerializer,
         Object filterId) | 
| static MapSerializer | construct(String[] ignoredList,
         JavaType mapType,
         boolean staticValueType,
         TypeSerializer vts,
         JsonSerializer<Object> keySerializer,
         JsonSerializer<Object> valueSerializer,
         Object filterId)Deprecated. 
 Since 2.8 use the other overload | 
| JsonSerializer<?> | createContextual(SerializerProvider provider,
                BeanProperty property)Method called to see if a different (or differently configured) serializer
 is needed to serialize values of specified property. | 
| JsonSerializer<?> | getContentSerializer()Accessor for serializer used for serializing contents
 (List and array elements, Map values etc) of the
 container for which this serializer is used, if it is
 known statically. | 
| JavaType | getContentType()Accessor for finding declared (static) element type for
 type this serializer is used for. | 
| JsonSerializer<?> | getKeySerializer()Accessor for currently assigned key serializer. | 
| JsonNode | getSchema(SerializerProvider provider,
         Type typeHint)Default implementation simply claims type is "string"; usually
 overriden by custom serializers. | 
| boolean | hasSingleElement(Map<?,?> value)Method called to determine if the given value (of type handled by
 this serializer) contains exactly one element. | 
| boolean | isEmpty(SerializerProvider prov,
       Map<?,?> value)Method called to check whether given serializable value is
 considered "empty" value (for purposes of suppressing serialization
 of empty values). | 
| void | serialize(Map<?,?> value,
         com.fasterxml.jackson.core.JsonGenerator gen,
         SerializerProvider provider)Method that can be called to ask implementation to serialize
 values of type this serializer handles. | 
| void | serializeFields(Map<?,?> value,
               com.fasterxml.jackson.core.JsonGenerator gen,
               SerializerProvider provider)General-purpose serialization for contents, where we do not necessarily know
 the value serialization, but 
 we do know that no value suppression is needed (which simplifies processing a bit) | 
| void | serializeFieldsUsing(Map<?,?> value,
                    com.fasterxml.jackson.core.JsonGenerator gen,
                    SerializerProvider provider,
                    JsonSerializer<Object> ser)Method called to serialize fields, when the value type is statically known,
 so that value serializer is passed and does not need to be fetched from
 provider. | 
| void | serializeFilteredAnyProperties(SerializerProvider provider,
                              com.fasterxml.jackson.core.JsonGenerator gen,
                              Object bean,
                              Map<?,?> value,
                              PropertyFilter filter,
                              Object suppressableValue)Helper method used when we have a JSON Filter to use AND contents are
 "any properties" of a POJO. | 
| void | serializeFilteredFields(Map<?,?> value,
                       com.fasterxml.jackson.core.JsonGenerator gen,
                       SerializerProvider provider,
                       PropertyFilter filter,
                       Object suppressableValue)Helper method used when we have a JSON Filter to use for potentially
 filtering out Map entries. | 
| void | serializeOptionalFields(Map<?,?> value,
                       com.fasterxml.jackson.core.JsonGenerator gen,
                       SerializerProvider provider,
                       Object suppressableValue)Serialization method called when exclusion filtering needs to be applied. | 
| void | serializeTypedFields(Map<?,?> value,
                    com.fasterxml.jackson.core.JsonGenerator gen,
                    SerializerProvider provider,
                    Object suppressableValue) | 
| void | serializeWithoutTypeInfo(Map<?,?> value,
                        com.fasterxml.jackson.core.JsonGenerator gen,
                        SerializerProvider provider)General-purpose serialization for contents without writing object type. | 
| void | serializeWithType(Map<?,?> value,
                 com.fasterxml.jackson.core.JsonGenerator gen,
                 SerializerProvider provider,
                 TypeSerializer typeSer)Method that can be called to ask implementation to serialize
 values of type this serializer handles, using specified type serializer
 for embedding necessary type information. | 
| MapSerializer | withContentInclusion(Object suppressableValue)Deprecated. 
 since 2.9 | 
| MapSerializer | withContentInclusion(Object suppressableValue,
                    boolean suppressNulls)Mutant factory for constructing an instance with different inclusion strategy
 for content (Map values). | 
| MapSerializer | withFilterId(Object filterId)Mutant factory method that is called if contextual configuration indicates that
 a specific filter (as specified by  filterId) is to be used for
 serialization. | 
| MapSerializer | withResolved(BeanProperty property,
            JsonSerializer<?> keySerializer,
            JsonSerializer<?> valueSerializer,
            Set<String> ignored,
            boolean sortKeys) | 
| MapSerializer | withResolved(BeanProperty property,
            JsonSerializer<?> keySerializer,
            JsonSerializer<?> valueSerializer,
            Set<String> ignored,
            Set<String> included,
            boolean sortKeys) | 
hasContentTypeAnnotation, withValueTypeSerializer_neitherNull, _nonEmpty, createSchemaNode, createSchemaNode, findAnnotatedContentSerializer, findContextualConvertingSerializer, findConvertingContentSerializer, findFormatFeature, findFormatOverrides, findIncludeOverrides, findPropertyFilter, getSchema, handledType, isDefaultSerializer, visitArrayFormat, visitArrayFormat, visitFloatFormat, visitIntFormat, visitIntFormat, visitStringFormat, visitStringFormat, wrapAndThrow, wrapAndThrowgetDelegatee, isEmpty, isUnwrappingSerializer, properties, replaceDelegatee, unwrappingSerializer, usesObjectIdprotected static final JavaType UNSPECIFIED_TYPE
public static final Object MARKER_FOR_EMPTY
protected final BeanProperty _property
protected final boolean _valueTypeIsStatic
protected final JavaType _keyType
protected final JavaType _valueType
protected JsonSerializer<Object> _keySerializer
protected JsonSerializer<Object> _valueSerializer
protected final TypeSerializer _valueTypeSerializer
protected PropertySerializerMap _dynamicValueSerializers
protected final Set<String> _ignoredEntries
protected final Set<String> _includedEntries
protected final Object _filterId
protected final Object _suppressableValue
equals() is called), or marker
 value of MARKER_FOR_EMPTY, or null to indicate no filtering for
 non-null values.
 Note that inclusion value for Map instance itself is handled by caller (POJO
 property that refers to the Map value).protected final boolean _suppressNulls
_suppressableValueprotected final IgnorePropertiesUtil.Checker _inclusionChecker
protected final boolean _sortKeys
protected MapSerializer(Set<String> ignoredEntries, Set<String> includedEntries, JavaType keyType, JavaType valueType, boolean valueTypeIsStatic, TypeSerializer vts, JsonSerializer<?> keySerializer, JsonSerializer<?> valueSerializer)
@Deprecated protected MapSerializer(Set<String> ignoredEntries, JavaType keyType, JavaType valueType, boolean valueTypeIsStatic, TypeSerializer vts, JsonSerializer<?> keySerializer, JsonSerializer<?> valueSerializer)
protected MapSerializer(MapSerializer src, BeanProperty property, JsonSerializer<?> keySerializer, JsonSerializer<?> valueSerializer, Set<String> ignoredEntries, Set<String> includedEntries)
@Deprecated protected MapSerializer(MapSerializer src, BeanProperty property, JsonSerializer<?> keySerializer, JsonSerializer<?> valueSerializer, Set<String> ignoredEntries)
protected MapSerializer(MapSerializer src, TypeSerializer vts, Object suppressableValue, boolean suppressNulls)
protected MapSerializer(MapSerializer src, Object filterId, boolean sortKeys)
@Deprecated protected MapSerializer(MapSerializer src, TypeSerializer vts, Object suppressableValue)
public MapSerializer _withValueTypeSerializer(TypeSerializer vts)
ContainerSerializerTypeSerializer, used when
 addition type information is to be embedded._withValueTypeSerializer in class ContainerSerializer<Map<?,?>>public MapSerializer withResolved(BeanProperty property, JsonSerializer<?> keySerializer, JsonSerializer<?> valueSerializer, Set<String> ignored, Set<String> included, boolean sortKeys)
public MapSerializer withResolved(BeanProperty property, JsonSerializer<?> keySerializer, JsonSerializer<?> valueSerializer, Set<String> ignored, boolean sortKeys)
public MapSerializer withFilterId(Object filterId)
JsonSerializerfilterId) is to be used for
 serialization.
 Default implementation simply returns this; sub-classes that do support
 filtering will need to create and return new instance if filter changes.
withFilterId in class JsonSerializer<Map<?,?>>public MapSerializer withContentInclusion(Object suppressableValue, boolean suppressNulls)
public static MapSerializer construct(Set<String> ignoredEntries, Set<String> includedEntries, JavaType mapType, boolean staticValueType, TypeSerializer vts, JsonSerializer<Object> keySerializer, JsonSerializer<Object> valueSerializer, Object filterId)
public static MapSerializer construct(Set<String> ignoredEntries, JavaType mapType, boolean staticValueType, TypeSerializer vts, JsonSerializer<Object> keySerializer, JsonSerializer<Object> valueSerializer, Object filterId)
protected void _ensureOverride(String method)
@Deprecated protected void _ensureOverride()
@Deprecated public MapSerializer withContentInclusion(Object suppressableValue)
@Deprecated public static MapSerializer construct(String[] ignoredList, JavaType mapType, boolean staticValueType, TypeSerializer vts, JsonSerializer<Object> keySerializer, JsonSerializer<Object> valueSerializer, Object filterId)
public JsonSerializer<?> createContextual(SerializerProvider provider, BeanProperty property) throws JsonMappingException
ContextualSerializercreateContextual in interface ContextualSerializerprovider - Serializer provider to use for accessing config, other serializersproperty - Method or field that represents the property
   (and is used to access value to serialize).
   Should be available; but there may be cases where caller cannot provide it and
   null is passed instead (in which case impls usually pass 'this' serializer as is)JsonMappingExceptionpublic JavaType getContentType()
ContainerSerializergetContentType in class ContainerSerializer<Map<?,?>>public JsonSerializer<?> getContentSerializer()
ContainerSerializerContainerSerializer.getContentType() and
 SerializerProvider.findContentValueSerializer(com.fasterxml.jackson.databind.JavaType, com.fasterxml.jackson.databind.BeanProperty).getContentSerializer in class ContainerSerializer<Map<?,?>>public boolean isEmpty(SerializerProvider prov, Map<?,?> value)
JsonSerializerDefault implementation will consider only null values to be empty.
 NOTE: replaces JsonSerializer.isEmpty(Object), which was deprecated in 2.5
isEmpty in class JsonSerializer<Map<?,?>>public boolean hasSingleElement(Map<?,?> value)
ContainerSerializerNote: although it might seem sensible to instead define something like "getElementCount()" method, this would not work well for containers that do not keep track of size (like linked lists may not).
 Note, too, that as of now (2.9) this method is only called by serializer
 itself; and specifically is not used for non-array/collection types
 like Map or Map.Entry instances.
hasSingleElement in class ContainerSerializer<Map<?,?>>public JsonSerializer<?> getKeySerializer()
MapSerializer:
 depedencies are resolved during createContextual(com.fasterxml.jackson.databind.SerializerProvider, com.fasterxml.jackson.databind.BeanProperty) method
 (which can be overridden by custom implementations), but for some
 dynamic types, it is possible that serializer is only resolved
 during actual serialization.public void serialize(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider) throws IOException
JsonSerializerserialize in class StdSerializer<Map<?,?>>value - Value to serialize; can not be null.gen - Generator used to output resulting Json contentprovider - Provider that can be used to get serializers for
   serializing Objects value contains, if any.IOExceptionpublic void serializeWithType(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider, TypeSerializer typeSer) throws IOException
JsonSerializer
 Default implementation will throw UnsupportedOperationException
 to indicate that proper type handling needs to be implemented.
For simple datatypes written as a single scalar value (JSON String, Number, Boolean), implementation would look like:
// note: method to call depends on whether this type is serialized as JSON scalar, object or Array! typeSer.writeTypePrefixForScalar(value, gen); serialize(value, gen, provider); typeSer.writeTypeSuffixForScalar(value, gen);and implementations for type serialized as JSON Arrays or Objects would differ slightly, as
START-ARRAY/END-ARRAY and
 START-OBJECT/END-OBJECT pairs
 need to be properly handled with respect to serializing of contents.serializeWithType in class JsonSerializer<Map<?,?>>value - Value to serialize; can not be null.gen - Generator used to output resulting Json contentprovider - Provider that can be used to get serializers for
   serializing Objects value contains, if any.typeSer - Type serializer to use for including type informationIOExceptionpublic void serializeWithoutTypeInfo(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider) throws IOException
 Public since it also is called by AnyGetterWriter.
IOExceptionpublic void serializeFields(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider) throws IOException
IOExceptionpublic void serializeOptionalFields(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider, Object suppressableValue) throws IOException
IOExceptionpublic void serializeFieldsUsing(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider, JsonSerializer<Object> ser) throws IOException
IOExceptionpublic void serializeFilteredFields(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider, PropertyFilter filter, Object suppressableValue) throws IOException
IOExceptionpublic void serializeTypedFields(Map<?,?> value, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider, Object suppressableValue) throws IOException
IOExceptionpublic void serializeFilteredAnyProperties(SerializerProvider provider, com.fasterxml.jackson.core.JsonGenerator gen, Object bean, Map<?,?> value, PropertyFilter filter, Object suppressableValue) throws IOException
bean - Enclosing POJO that has any-getter used to obtain "any properties"IOExceptionpublic JsonNode getSchema(SerializerProvider provider, Type typeHint)
StdSerializergetSchema in interface SchemaAwaregetSchema in class StdSerializer<Map<?,?>>provider - The serializer provider.typeHint - A hint about the type.public void acceptJsonFormatVisitor(JsonFormatVisitorWrapper visitor, JavaType typeHint) throws JsonMappingException
StdSerializeracceptJsonFormatVisitor in interface JsonFormatVisitableacceptJsonFormatVisitor in class StdSerializer<Map<?,?>>typeHint - Type of element (entity like property) being visitedJsonMappingExceptionprotected final JsonSerializer<Object> _findAndAddDynamic(PropertySerializerMap map, Class<?> type, SerializerProvider provider) throws JsonMappingException
JsonMappingExceptionprotected final JsonSerializer<Object> _findAndAddDynamic(PropertySerializerMap map, JavaType type, SerializerProvider provider) throws JsonMappingException
JsonMappingExceptionprotected Map<?,?> _orderEntries(Map<?,?> input, com.fasterxml.jackson.core.JsonGenerator gen, SerializerProvider provider) throws IOException
IOExceptionprotected boolean _hasNullKey(Map<?,?> input)
protected void _writeNullKeyedEntry(com.fasterxml.jackson.core.JsonGenerator gen,
                                    SerializerProvider provider,
                                    Object value)
                             throws IOException
IOExceptionCopyright © 2008–2022 FasterXML. All rights reserved.