Package org.codehaus.jackson.map

Contains basic mapper (conversion) functionality that allows for converting between regular streaming json content and Java objects (beans or Tree Model: support for both is via ObjectMapper class, as well as convenience methods included in JsonParser

See:
Description

Interface Summary

JsonSerializable	Interface that can be implemented by objects that know how to serialize themselves to Json, using JsonGenerator (and SerializerProvider if necessary).
ResolvableDeserializer	Interface used to indicate deserializers that want to do post-processing after construction and being added to DeserializerProvider, but before being used.
ResolvableSerializer	Interface used to indicate serializers that want to do post-processing after construction and being added to SerializerProvider, but before being used.

Class Summary

BeanDescription	Basic container for information gathered by ClassIntrospector to help in constructing serializers and deserializers.
ClassIntrospector<T extends BeanDescription>	Helper class used to introspect features of POJO value classes used with Jackson.
DeserializationConfig	Object that contains baseline configuration for deserialization process.
DeserializationContext	Context for deserialization process.
DeserializationProblemHandler	This is the class that can be registered (via DeserializationConfig object owner by ObjectMapper) to get calledn when a potentially recoverable problem is encountered during deserialization process.
DeserializerFactory	Abstract class that defines API used by DeserializerProvider to obtain actual JsonDeserializer instances from multiple distinct factories.
DeserializerProvider	Abstract class that defines API used by ObjectMapper and JsonDeserializers to obtain deserializers capable of re-constructing instances of handled type from Json content.
JsonDeserializer<T>	Abstract class that defines API used by ObjectMapper (and other chained JsonDeserializers too) to deserialize Objects of arbitrary types from JSON, using provided JsonParser.
JsonMappingException.Reference	Simple bean class used to contain references.
JsonSerializer<T>	Abstract class that defines API used by ObjectMapper (and other chained JsonSerializers too) to serialize Objects of arbitrary types into JSON, using provided JsonGenerator.
KeyDeserializer	Abstract class that defines API used for deserializing Json content field names into Java Map keys.
MappingJsonFactory	Sub-class of JsonFactory that will create a proper ObjectCodec to allow seamless conversions between Json content and Java objects (POJOs).
ObjectMapper	This mapper (or, data binder, or codec) provides functionality for conversting between Java objects (instances of JDK provided core classes, beans), and matching JSON constructs.
SerializationConfig	Object that contains baseline configuration for serialization process.
SerializerFactory	Abstract class that defines API used by SerializerProvider to obtain actual JsonSerializer instances from multiple distinct factories.
SerializerProvider	Abstract class that defines API used by ObjectMapper and JsonSerializers to obtain serializers capable of serializing instances of specific types.
TreeMapper	This mapper (or, codec) provides mapping between Json, and Tree-like structure that consists of child-linked nodes that can be traversed with simple path operations (indexing arrays by element, objects by field name).

Enum Summary

DeserializationConfig.Feature	Enumeration that defines togglable features that guide the serialization feature.
SerializationConfig.Feature	Enumeration that defines togglable features that guide the serialization feature.
TreeMapper.DupFields	Enumeration that defines strategies available for dealing with duplicate field names (when mapping JSON to Java types).

Exception Summary

JsonMappingException

Checked exception used to signal fatal problems with mapping of content.

Package org.codehaus.jackson.map Description

Contains basic mapper (conversion) functionality that allows for converting between regular streaming json content and Java objects (beans or Tree Model: support for both is via ObjectMapper class, as well as convenience methods included in JsonParser

Object mapper will convert Json content to ant from basic Java wrapper types (Integer, Boolean, Double), Collection types (List, Map), Java Beans, Strings and nulls.

Tree mapper builds dynamically typed tree of JsonNodes from Json content (and writes such trees as Json), similar to how DOM model works with xml. Main benefits over Object mapping are:

• No null checks are needed (dummy nodes are created as necessary to represent "missing" Object fields and Array elements)
• No type casts are usually needed: all public access methods are defined in basic JsonNode class, and when "incompatible" method (such as Array element access on, say, Boolean node) is used, returned node is virtual "missing" node.

Because of its dynamic nature, Tree mapping is often convenient for basic path access and tree navigation, where structure of the resulting tree is known in advance.