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: "Java type" and "JSON type" mappers.

Java type mapper will use basic wrapper types (Integer, Boolean, Double), Collection types (List, Map), Strings and nulls to represent JSON concepts.

Json type mapper uses dynamically typed tree of JsonNodes, bit similar to how DOM model works with xml. Main benefits over Java type 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 needed: all public 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, this mapping is often convenient
for basic path access and tree navigation, where structure of
the resulting tree is known in advance.