This package contains basic mapper (conversion) functionality that allows for converting between regular streaming json content and various tree/object-based alternatives. Currently 2 main flavors are supported: "Object Mapper" and "Tree Mapper": implementing classes are, respectively, {@link org.codehaus.jackson.map.ObjectMapper} and {@link org.codehaus.jackson.map.TreeMapper}

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.