1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!--NewPage--> 3<HTML> 4<HEAD> 5<!-- Generated by javadoc (build 1.6.0_29) on Mon Mar 26 19:07:19 PDT 2012 --> 6<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<TITLE> 8com.fasterxml.jackson.databind (jackson-databind 2.0.0 API) 9</TITLE> 10 11<META NAME="date" CONTENT="2012-03-26"> 12 13<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style"> 14 15<SCRIPT type="text/javascript"> 16function windowTitle() 17{ 18 if (location.href.indexOf('is-external=true') == -1) { 19 parent.document.title="com.fasterxml.jackson.databind (jackson-databind 2.0.0 API)"; 20 } 21} 22</SCRIPT> 23<NOSCRIPT> 24</NOSCRIPT> 25 26</HEAD> 27 28<BODY BGCOLOR="white" onload="windowTitle();"> 29<HR> 30 31 32<!-- ========= START OF TOP NAVBAR ======= --> 33<A NAME="navbar_top"><!-- --></A> 34<A HREF="#skip-navbar_top" title="Skip navigation links"></A> 35<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 36<TR> 37<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 38<A NAME="navbar_top_firstrow"><!-- --></A> 39<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 40 <TR ALIGN="center" VALIGN="top"> 41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 42 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD> 43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> 44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 45 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 46 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 47 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 48 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 49 </TR> 50</TABLE> 51</TD> 52<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 53</EM> 54</TD> 55</TR> 56 57<TR> 58<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 59 PREV PACKAGE 60 <A HREF="../../../../com/fasterxml/jackson/databind/annotation/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD> 61<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 62 <A HREF="../../../../index.html?com/fasterxml/jackson/databind/package-summary.html" target="_top"><B>FRAMES</B></A> 63 <A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A> 64 <SCRIPT type="text/javascript"> 65 <!-- 66 if(window==top) { 67 document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); 68 } 69 //--> 70</SCRIPT> 71<NOSCRIPT> 72 <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> 73</NOSCRIPT> 74 75 76</FONT></TD> 77</TR> 78</TABLE> 79<A NAME="skip-navbar_top"></A> 80<!-- ========= END OF TOP NAVBAR ========= --> 81 82<HR> 83<H2> 84Package com.fasterxml.jackson.databind 85</H2> 86Contains basic mapper (conversion) functionality that 87allows for converting between regular streaming json content and 88Java objects (beans or Tree Model: support for both is via 89<A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> class, as well 90as convenience methods included in 91<CODE>JsonParser</CODE> 92<P> 93<B>See:</B> 94<BR> 95 <A HREF="#package_description"><B>Description</B></A> 96<P> 97 98<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 99<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 100<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 101<B>Interface Summary</B></FONT></TH> 102</TR> 103<TR BGCOLOR="white" CLASS="TableRowColor"> 104<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/BeanProperty.html" title="interface in com.fasterxml.jackson.databind">BeanProperty</A></B></TD> 105<TD>Bean properties are logical entities that represent data 106 that Java objects (POJOs (Plain Old Java Objects), sometimes also called "beans") 107 contain; and that are accessed using accessors (methods like getters 108 and setters, fields, contstructor parametrers).</TD> 109</TR> 110<TR BGCOLOR="white" CLASS="TableRowColor"> 111<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonSerializable.html" title="interface in com.fasterxml.jackson.databind">JsonSerializable</A></B></TD> 112<TD>Interface that can be implemented by objects that know how to 113 serialize themselves to JSON, using <CODE>JsonGenerator</CODE> 114 (and <A HREF="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind"><CODE>SerializerProvider</CODE></A> if necessary).</TD> 115</TR> 116<TR BGCOLOR="white" CLASS="TableRowColor"> 117<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/Module.SetupContext.html" title="interface in com.fasterxml.jackson.databind">Module.SetupContext</A></B></TD> 118<TD>Interface Jackson exposes to modules for purpose of registering 119 extended functionality.</TD> 120</TR> 121</TABLE> 122 123 124<P> 125 126<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 127<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 128<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 129<B>Class Summary</B></FONT></TH> 130</TR> 131<TR BGCOLOR="white" CLASS="TableRowColor"> 132<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/AbstractTypeResolver.html" title="class in com.fasterxml.jackson.databind">AbstractTypeResolver</A></B></TD> 133<TD>Defines interface for resolvers that can resolve abstract types into concrete 134 ones; either by using static mappings, or possibly by materializing 135 implementations dynamically.</TD> 136</TR> 137<TR BGCOLOR="white" CLASS="TableRowColor"> 138<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.html" title="class in com.fasterxml.jackson.databind">AnnotationIntrospector</A></B></TD> 139<TD>Abstract class that defines API used for introspecting annotation-based 140 configuration for serialization and deserialization.</TD> 141</TR> 142<TR BGCOLOR="white" CLASS="TableRowColor"> 143<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.Pair.html" title="class in com.fasterxml.jackson.databind">AnnotationIntrospector.Pair</A></B></TD> 144<TD>Helper class that allows using 2 introspectors such that one 145 introspector acts as the primary one to use; and second one 146 as a fallback used if the primary does not provide conclusive 147 or useful result for a method.</TD> 148</TR> 149<TR BGCOLOR="white" CLASS="TableRowColor"> 150<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.ReferenceProperty.html" title="class in com.fasterxml.jackson.databind">AnnotationIntrospector.ReferenceProperty</A></B></TD> 151<TD>Value type used with managed and back references; contains type and 152 logic name, used to link related references</TD> 153</TR> 154<TR BGCOLOR="white" CLASS="TableRowColor"> 155<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/BeanDescription.html" title="class in com.fasterxml.jackson.databind">BeanDescription</A></B></TD> 156<TD>Basic container for information gathered by <A HREF="../../../../com/fasterxml/jackson/databind/introspect/ClassIntrospector.html" title="class in com.fasterxml.jackson.databind.introspect"><CODE>ClassIntrospector</CODE></A> to 157 help in constructing serializers and deserializers.</TD> 158</TR> 159<TR BGCOLOR="white" CLASS="TableRowColor"> 160<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/BeanProperty.Std.html" title="class in com.fasterxml.jackson.databind">BeanProperty.Std</A></B></TD> 161<TD>Simple stand-alone implementation, useful as a placeholder 162 or base class for more complex implementations.</TD> 163</TR> 164<TR BGCOLOR="white" CLASS="TableRowColor"> 165<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind">DeserializationConfig</A></B></TD> 166<TD>Object that contains baseline configuration for deserialization 167 process.</TD> 168</TR> 169<TR BGCOLOR="white" CLASS="TableRowColor"> 170<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</A></B></TD> 171<TD>Context for the process of deserialization a single root-level value.</TD> 172</TR> 173<TR BGCOLOR="white" CLASS="TableRowColor"> 174<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/InjectableValues.html" title="class in com.fasterxml.jackson.databind">InjectableValues</A></B></TD> 175<TD>Abstract class that defines API for objects that provide value to 176 "inject" during deserialization.</TD> 177</TR> 178<TR BGCOLOR="white" CLASS="TableRowColor"> 179<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/InjectableValues.Std.html" title="class in com.fasterxml.jackson.databind">InjectableValues.Std</A></B></TD> 180<TD>Simple standard implementation which uses a simple Map to 181 store values to inject, identified by simple String keys.</TD> 182</TR> 183<TR BGCOLOR="white" CLASS="TableRowColor"> 184<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</A></B></TD> 185<TD>Base class for type token classes used both to contain information 186 and as keys for deserializers.</TD> 187</TR> 188<TR BGCOLOR="white" CLASS="TableRowColor"> 189<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer<T></A></B></TD> 190<TD>Abstract class that defines API used by <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> (and 191 other chained <A HREF="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonDeserializer</CODE></A>s too) to deserialize Objects of 192 arbitrary types from JSON, using provided <CODE>JsonParser</CODE>.</TD> 193</TR> 194<TR BGCOLOR="white" CLASS="TableRowColor"> 195<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonDeserializer.None.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer.None</A></B></TD> 196<TD>This marker class is only to be used with annotations, to 197 indicate that <b>no deserializer is configured</b>.</TD> 198</TR> 199<TR BGCOLOR="white" CLASS="TableRowColor"> 200<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonMappingException.Reference.html" title="class in com.fasterxml.jackson.databind">JsonMappingException.Reference</A></B></TD> 201<TD>Simple bean class used to contain references.</TD> 202</TR> 203<TR BGCOLOR="white" CLASS="TableRowColor"> 204<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonNode.html" title="class in com.fasterxml.jackson.databind">JsonNode</A></B></TD> 205<TD>Base class for all JSON nodes, which form the basis of JSON 206 Tree Model that Jackson implements.</TD> 207</TR> 208<TR BGCOLOR="white" CLASS="TableRowColor"> 209<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind">JsonSerializer<T></A></B></TD> 210<TD>Abstract class that defines API used by <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> (and 211 other chained <A HREF="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonSerializer</CODE></A>s too) to serialize Objects of 212 arbitrary types into JSON, using provided <CODE>JsonGenerator</CODE>.</TD> 213</TR> 214<TR BGCOLOR="white" CLASS="TableRowColor"> 215<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonSerializer.None.html" title="class in com.fasterxml.jackson.databind">JsonSerializer.None</A></B></TD> 216<TD>This marker class is only to be used with annotations, to 217 indicate that <b>no serializer is configured</b>.</TD> 218</TR> 219<TR BGCOLOR="white" CLASS="TableRowColor"> 220<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/KeyDeserializer.html" title="class in com.fasterxml.jackson.databind">KeyDeserializer</A></B></TD> 221<TD>Abstract class that defines API used for deserializing JSON content 222 field names into Java Map keys.</TD> 223</TR> 224<TR BGCOLOR="white" CLASS="TableRowColor"> 225<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/KeyDeserializer.None.html" title="class in com.fasterxml.jackson.databind">KeyDeserializer.None</A></B></TD> 226<TD>This marker class is only to be used with annotations, to 227 indicate that <b>no deserializer is configured</b>.</TD> 228</TR> 229<TR BGCOLOR="white" CLASS="TableRowColor"> 230<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/MappingIterator.html" title="class in com.fasterxml.jackson.databind">MappingIterator<T></A></B></TD> 231<TD>Iterator exposed by <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> when binding sequence of 232 objects.</TD> 233</TR> 234<TR BGCOLOR="white" CLASS="TableRowColor"> 235<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/MappingJsonFactory.html" title="class in com.fasterxml.jackson.databind">MappingJsonFactory</A></B></TD> 236<TD>Sub-class of <CODE>JsonFactory</CODE> that will create a proper 237 <CODE>ObjectCodec</CODE> to allow seamless conversions between 238 Json content and Java objects (POJOs).</TD> 239</TR> 240<TR BGCOLOR="white" CLASS="TableRowColor"> 241<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/Module.html" title="class in com.fasterxml.jackson.databind">Module</A></B></TD> 242<TD>Simple interface for extensions that can be registered with <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> 243 to provide a well-defined set of extensions to default functionality; such as 244 support for new data types.</TD> 245</TR> 246<TR BGCOLOR="white" CLASS="TableRowColor"> 247<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind">ObjectMapper</A></B></TD> 248<TD>This mapper (or, data binder, or codec) provides functionality for 249 converting between Java objects (instances of JDK provided core classes, 250 beans), and matching JSON constructs.</TD> 251</TR> 252<TR BGCOLOR="white" CLASS="TableRowColor"> 253<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.DefaultTypeResolverBuilder.html" title="class in com.fasterxml.jackson.databind">ObjectMapper.DefaultTypeResolverBuilder</A></B></TD> 254<TD>Customized <A HREF="../../../../com/fasterxml/jackson/databind/jsontype/TypeResolverBuilder.html" title="interface in com.fasterxml.jackson.databind.jsontype"><CODE>TypeResolverBuilder</CODE></A> that provides type resolver builders 255 used with so-called "default typing" 256 (see <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html#enableDefaultTyping()"><CODE>ObjectMapper.enableDefaultTyping()</CODE></A> for details).</TD> 257</TR> 258<TR BGCOLOR="white" CLASS="TableRowColor"> 259<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind">ObjectReader</A></B></TD> 260<TD>Builder object that can be used for per-serialization configuration of 261 deserialization parameters, such as root type to use or object 262 to update (instead of constructing new instance).</TD> 263</TR> 264<TR BGCOLOR="white" CLASS="TableRowColor"> 265<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind">ObjectWriter</A></B></TD> 266<TD>Builder object that can be used for per-serialization configuration of 267 serialization parameters, such as JSON View and root type to use.</TD> 268</TR> 269<TR BGCOLOR="white" CLASS="TableRowColor"> 270<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy</A></B></TD> 271<TD>Class that defines how names of JSON properties ("external names") 272 are derived from names of POJO methods and fields ("internal names"), 273 in cases where they are not 274 auto-detected and no explicit annotations exist for naming.</TD> 275</TR> 276<TR BGCOLOR="white" CLASS="TableRowColor"> 277<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.LowerCaseWithUnderscoresStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy.LowerCaseWithUnderscoresStrategy</A></B></TD> 278<TD>A <A HREF="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.html" title="class in com.fasterxml.jackson.databind"><CODE>PropertyNamingStrategy</CODE></A> that translates typical camel case Java 279 property names to lower case JSON element names, separated by 280 underscores.</TD> 281</TR> 282<TR BGCOLOR="white" CLASS="TableRowColor"> 283<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.PropertyNamingStrategyBase.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy.PropertyNamingStrategyBase</A></B></TD> 284<TD> </TD> 285</TR> 286<TR BGCOLOR="white" CLASS="TableRowColor"> 287<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/SerializationConfig.html" title="class in com.fasterxml.jackson.databind">SerializationConfig</A></B></TD> 288<TD>Object that contains baseline configuration for serialization 289 process.</TD> 290</TR> 291<TR BGCOLOR="white" CLASS="TableRowColor"> 292<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind">SerializerProvider</A></B></TD> 293<TD>Class that defines API used by <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> and 294 <A HREF="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonSerializer</CODE></A>s to obtain serializers capable of serializing 295 instances of specific types; as well as the default implementation 296 of the functionality.</TD> 297</TR> 298</TABLE> 299 300 301<P> 302 303<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 304<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 305<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 306<B>Enum Summary</B></FONT></TH> 307</TR> 308<TR BGCOLOR="white" CLASS="TableRowColor"> 309<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.ReferenceProperty.Type.html" title="enum in com.fasterxml.jackson.databind">AnnotationIntrospector.ReferenceProperty.Type</A></B></TD> 310<TD> </TD> 311</TR> 312<TR BGCOLOR="white" CLASS="TableRowColor"> 313<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</A></B></TD> 314<TD>Enumeration that defines simple on/off features that affect 315 the way Java objects are deserialized from JSON</TD> 316</TR> 317<TR BGCOLOR="white" CLASS="TableRowColor"> 318<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</A></B></TD> 319<TD>Enumeration that defines simple on/off features to set 320 for <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A>, and accessible (but not changeable) 321 via <A HREF="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectReader</CODE></A> and <A HREF="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectWriter</CODE></A> (as well as 322 through various convenience methods through context objects).</TD> 323</TR> 324<TR BGCOLOR="white" CLASS="TableRowColor"> 325<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.DefaultTyping.html" title="enum in com.fasterxml.jackson.databind">ObjectMapper.DefaultTyping</A></B></TD> 326<TD>Enumeration used with <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html#enableDefaultTyping()"><CODE>ObjectMapper.enableDefaultTyping()</CODE></A> 327 to specify what kind of types (classes) default typing should 328 be used for.</TD> 329</TR> 330<TR BGCOLOR="white" CLASS="TableRowColor"> 331<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</A></B></TD> 332<TD>Enumeration that defines simple on/off features that affect 333 the way Java objects are serialized.</TD> 334</TR> 335</TABLE> 336 337 338<P> 339 340<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 341<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 342<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 343<B>Exception Summary</B></FONT></TH> 344</TR> 345<TR BGCOLOR="white" CLASS="TableRowColor"> 346<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</A></B></TD> 347<TD>Checked exception used to signal fatal problems with mapping of 348 content.</TD> 349</TR> 350<TR BGCOLOR="white" CLASS="TableRowColor"> 351<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/RuntimeJsonMappingException.html" title="class in com.fasterxml.jackson.databind">RuntimeJsonMappingException</A></B></TD> 352<TD>Wrapper used when interface does not allow throwing a checked 353 <A HREF="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonMappingException</CODE></A></TD> 354</TR> 355</TABLE> 356 357 358<P> 359<A NAME="package_description"><!-- --></A><H2> 360Package com.fasterxml.jackson.databind Description 361</H2> 362 363<P> 364Contains basic mapper (conversion) functionality that 365allows for converting between regular streaming json content and 366Java objects (beans or Tree Model: support for both is via 367<A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> class, as well 368as convenience methods included in 369<CODE>JsonParser</CODE> 370<p> 371Object mapper will convert Json content to ant from 372basic Java wrapper types (Integer, Boolean, Double), 373Collection types (List, Map), Java Beans, 374Strings and nulls. 375<p> 376Tree mapper builds dynamically typed tree of <A HREF="../../../../com/fasterxml/jackson/databind/JsonNode.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonNode</CODE></A>s 377from JSON content (and writes such trees as JSON), 378similar to how DOM model works with XML. 379Main benefits over Object mapping are: 380<ul> 381 <li>No null checks are needed (dummy 382nodes are created as necessary to represent "missing" Object fields 383and Array elements) 384 </li> 385 <li>No type casts are usually needed: all public access methods are defined 386in basic <code>JsonNode</code> class, and when "incompatible" method (such as Array 387element access on, say, Boolean node) is used, returned node is 388virtual "missing" node. 389 </li> 390</ul> 391Because of its dynamic nature, Tree mapping is often convenient 392for basic path access and tree navigation, where structure of 393the resulting tree is known in advance. 394<P> 395 396<P> 397<DL> 398</DL> 399<HR> 400 401 402<!-- ======= START OF BOTTOM NAVBAR ====== --> 403<A NAME="navbar_bottom"><!-- --></A> 404<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 405<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 406<TR> 407<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 408<A NAME="navbar_bottom_firstrow"><!-- --></A> 409<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 410 <TR ALIGN="center" VALIGN="top"> 411 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 412 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD> 413 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> 414 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 415 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 416 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 417 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 418 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 419 </TR> 420</TABLE> 421</TD> 422<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 423</EM> 424</TD> 425</TR> 426 427<TR> 428<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 429 PREV PACKAGE 430 <A HREF="../../../../com/fasterxml/jackson/databind/annotation/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD> 431<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 432 <A HREF="../../../../index.html?com/fasterxml/jackson/databind/package-summary.html" target="_top"><B>FRAMES</B></A> 433 <A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A> 434 <SCRIPT type="text/javascript"> 435 <!-- 436 if(window==top) { 437 document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); 438 } 439 //--> 440</SCRIPT> 441<NOSCRIPT> 442 <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> 443</NOSCRIPT> 444 445 446</FONT></TD> 447</TR> 448</TABLE> 449<A NAME="skip-navbar_bottom"></A> 450<!-- ======== END OF BOTTOM NAVBAR ======= --> 451 452<HR> 453Copyright © 2012 <a href="http://fasterxml.com">fasterxml.com</a>. All Rights Reserved. 454</BODY> 455</HTML> 456