1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!-- NewPage --> 3<html lang="en"> 4<head> 5<!-- Generated by javadoc (version 1.7.0_10-ea) on Mon Apr 22 19:50:43 PDT 2013 --> 6<meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> 7<title>com.fasterxml.jackson.databind (jackson-databind 2.2.0 API)</title> 8<meta name="date" content="2013-04-22"> 9<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style"> 10</head> 11<body> 12<script type="text/javascript"><!-- 13 if (location.href.indexOf('is-external=true') == -1) { 14 parent.document.title="com.fasterxml.jackson.databind (jackson-databind 2.2.0 API)"; 15 } 16//--> 17</script> 18<noscript> 19<div>JavaScript is disabled on your browser.</div> 20</noscript> 21<!-- ========= START OF TOP NAVBAR ======= --> 22<div class="topNav"><a name="navbar_top"> 23<!-- --> 24</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow"> 25<!-- --> 26</a> 27<ul class="navList" title="Navigation"> 28<li><a href="../../../../overview-summary.html">Overview</a></li> 29<li class="navBarCell1Rev">Package</li> 30<li>Class</li> 31<li><a href="package-use.html">Use</a></li> 32<li><a href="package-tree.html">Tree</a></li> 33<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 34<li><a href="../../../../index-all.html">Index</a></li> 35<li><a href="../../../../help-doc.html">Help</a></li> 36</ul> 37</div> 38<div class="subNav"> 39<ul class="navList"> 40<li>Prev Package</li> 41<li><a href="../../../../com/fasterxml/jackson/databind/annotation/package-summary.html">Next Package</a></li> 42</ul> 43<ul class="navList"> 44<li><a href="../../../../index.html?com/fasterxml/jackson/databind/package-summary.html" target="_top">Frames</a></li> 45<li><a href="package-summary.html" target="_top">No Frames</a></li> 46</ul> 47<ul class="navList" id="allclasses_navbar_top"> 48<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 49</ul> 50<div> 51<script type="text/javascript"><!-- 52 allClassesLink = document.getElementById("allclasses_navbar_top"); 53 if(window==top) { 54 allClassesLink.style.display = "block"; 55 } 56 else { 57 allClassesLink.style.display = "none"; 58 } 59 //--> 60</script> 61</div> 62<a name="skip-navbar_top"> 63<!-- --> 64</a></div> 65<!-- ========= END OF TOP NAVBAR ========= --> 66<div class="header"> 67<h1 title="Package" class="title">Package com.fasterxml.jackson.databind</h1> 68<div class="docSummary"> 69<div class="block">Contains basic mapper (conversion) functionality that 70allows for converting between regular streaming json content and 71Java objects (beans or Tree Model: support for both is via 72<a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a> class, as well 73as convenience methods included in 74<a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonParser</code></a></div> 75</div> 76<p>See: <a href="#package_description">Description</a></p> 77</div> 78<div class="contentContainer"> 79<ul class="blockList"> 80<li class="blockList"> 81<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Interface Summary table, listing interfaces, and an explanation"> 82<caption><span>Interface Summary</span><span class="tabEnd"> </span></caption> 83<tr> 84<th class="colFirst" scope="col">Interface</th> 85<th class="colLast" scope="col">Description</th> 86</tr> 87<tbody> 88<tr class="altColor"> 89<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/BeanProperty.html" title="interface in com.fasterxml.jackson.databind">BeanProperty</a></td> 90<td class="colLast"> 91<div class="block">Bean properties are logical entities that represent data 92 that Java objects (POJOs (Plain Old Java Objects), sometimes also called "beans") 93 contain; and that are accessed using accessors (methods like getters 94 and setters, fields, contstructor parametrers).</div> 95</td> 96</tr> 97<tr class="rowColor"> 98<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonSerializable.html" title="interface in com.fasterxml.jackson.databind">JsonSerializable</a></td> 99<td class="colLast"> 100<div class="block">Interface that can be implemented by objects that know how to 101 serialize themselves to JSON, using <a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator</code></a> 102 (and <a href="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind"><code>SerializerProvider</code></a> if necessary).</div> 103</td> 104</tr> 105<tr class="altColor"> 106<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/Module.SetupContext.html" title="interface in com.fasterxml.jackson.databind">Module.SetupContext</a></td> 107<td class="colLast"> 108<div class="block">Interface Jackson exposes to modules for purpose of registering 109 extended functionality.</div> 110</td> 111</tr> 112</tbody> 113</table> 114</li> 115<li class="blockList"> 116<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Class Summary table, listing classes, and an explanation"> 117<caption><span>Class Summary</span><span class="tabEnd"> </span></caption> 118<tr> 119<th class="colFirst" scope="col">Class</th> 120<th class="colLast" scope="col">Description</th> 121</tr> 122<tbody> 123<tr class="altColor"> 124<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/AbstractTypeResolver.html" title="class in com.fasterxml.jackson.databind">AbstractTypeResolver</a></td> 125<td class="colLast"> 126<div class="block">Defines interface for resolvers that can resolve abstract types into concrete 127 ones; either by using static mappings, or possibly by materializing 128 implementations dynamically.</div> 129</td> 130</tr> 131<tr class="rowColor"> 132<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.html" title="class in com.fasterxml.jackson.databind">AnnotationIntrospector</a></td> 133<td class="colLast"> 134<div class="block">Abstract class that defines API used for introspecting annotation-based 135 configuration for serialization and deserialization.</div> 136</td> 137</tr> 138<tr class="altColor"> 139<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.Pair.html" title="class in com.fasterxml.jackson.databind">AnnotationIntrospector.Pair</a></td> 140<td class="colLast">Deprecated 141<div class="block"><i>Starting with 2.1, use <a href="../../../../com/fasterxml/jackson/databind/introspect/AnnotationIntrospectorPair.html" title="class in com.fasterxml.jackson.databind.introspect"><code>AnnotationIntrospectorPair</code></a> instead.</i></div> 142</td> 143</tr> 144<tr class="rowColor"> 145<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.ReferenceProperty.html" title="class in com.fasterxml.jackson.databind">AnnotationIntrospector.ReferenceProperty</a></td> 146<td class="colLast"> 147<div class="block">Value type used with managed and back references; contains type and 148 logic name, used to link related references</div> 149</td> 150</tr> 151<tr class="altColor"> 152<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/BeanDescription.html" title="class in com.fasterxml.jackson.databind">BeanDescription</a></td> 153<td class="colLast"> 154<div class="block">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 155 help in constructing serializers and deserializers.</div> 156</td> 157</tr> 158<tr class="rowColor"> 159<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/BeanProperty.Std.html" title="class in com.fasterxml.jackson.databind">BeanProperty.Std</a></td> 160<td class="colLast"> 161<div class="block">Simple stand-alone implementation, useful as a placeholder 162 or base class for more complex implementations.</div> 163</td> 164</tr> 165<tr class="altColor"> 166<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/DatabindContext.html" title="class in com.fasterxml.jackson.databind">DatabindContext</a></td> 167<td class="colLast"> 168<div class="block">Shared base class for <a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><code>DeserializationContext</code></a> and 169 <a href="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind"><code>SerializerProvider</code></a>, context objects passed through data-binding 170 process.</div> 171</td> 172</tr> 173<tr class="rowColor"> 174<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind">DeserializationConfig</a></td> 175<td class="colLast"> 176<div class="block">Object that contains baseline configuration for deserialization 177 process.</div> 178</td> 179</tr> 180<tr class="altColor"> 181<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a></td> 182<td class="colLast"> 183<div class="block">Context for the process of deserialization a single root-level value.</div> 184</td> 185</tr> 186<tr class="rowColor"> 187<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/InjectableValues.html" title="class in com.fasterxml.jackson.databind">InjectableValues</a></td> 188<td class="colLast"> 189<div class="block">Abstract class that defines API for objects that provide value to 190 "inject" during deserialization.</div> 191</td> 192</tr> 193<tr class="altColor"> 194<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/InjectableValues.Std.html" title="class in com.fasterxml.jackson.databind">InjectableValues.Std</a></td> 195<td class="colLast"> 196<div class="block">Simple standard implementation which uses a simple Map to 197 store values to inject, identified by simple String keys.</div> 198</td> 199</tr> 200<tr class="rowColor"> 201<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a></td> 202<td class="colLast"> 203<div class="block">Base class for type token classes used both to contain information 204 and as keys for deserializers.</div> 205</td> 206</tr> 207<tr class="altColor"> 208<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><T></td> 209<td class="colLast"> 210<div class="block">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/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><code>JsonDeserializer</code></a>s too) to deserialize Objects of 212 arbitrary types from JSON, using provided <a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonParser</code></a>.</div> 213</td> 214</tr> 215<tr class="rowColor"> 216<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.None.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer.None</a></td> 217<td class="colLast"> 218<div class="block">This marker class is only to be used with annotations, to 219 indicate that <b>no deserializer is configured</b>.</div> 220</td> 221</tr> 222<tr class="altColor"> 223<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.Reference.html" title="class in com.fasterxml.jackson.databind">JsonMappingException.Reference</a></td> 224<td class="colLast"> 225<div class="block">Simple bean class used to contain references.</div> 226</td> 227</tr> 228<tr class="rowColor"> 229<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonNode.html" title="class in com.fasterxml.jackson.databind">JsonNode</a></td> 230<td class="colLast"> 231<div class="block">Base class for all JSON nodes, which form the basis of JSON 232 Tree Model that Jackson implements.</div> 233</td> 234</tr> 235<tr class="altColor"> 236<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind">JsonSerializer</a><T></td> 237<td class="colLast"> 238<div class="block">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 239 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 240 arbitrary types into JSON, using provided <a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator</code></a>.</div> 241</td> 242</tr> 243<tr class="rowColor"> 244<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonSerializer.None.html" title="class in com.fasterxml.jackson.databind">JsonSerializer.None</a></td> 245<td class="colLast"> 246<div class="block">This marker class is only to be used with annotations, to 247 indicate that <b>no serializer is configured</b>.</div> 248</td> 249</tr> 250<tr class="altColor"> 251<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/KeyDeserializer.html" title="class in com.fasterxml.jackson.databind">KeyDeserializer</a></td> 252<td class="colLast"> 253<div class="block">Abstract class that defines API used for deserializing JSON content 254 field names into Java Map keys.</div> 255</td> 256</tr> 257<tr class="rowColor"> 258<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/KeyDeserializer.None.html" title="class in com.fasterxml.jackson.databind">KeyDeserializer.None</a></td> 259<td class="colLast"> 260<div class="block">This marker class is only to be used with annotations, to 261 indicate that <b>no deserializer is configured</b>.</div> 262</td> 263</tr> 264<tr class="altColor"> 265<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/MappingIterator.html" title="class in com.fasterxml.jackson.databind">MappingIterator</a><T></td> 266<td class="colLast"> 267<div class="block">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 268 objects.</div> 269</td> 270</tr> 271<tr class="rowColor"> 272<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/MappingJsonFactory.html" title="class in com.fasterxml.jackson.databind">MappingJsonFactory</a></td> 273<td class="colLast"> 274<div class="block">Sub-class of <a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/JsonFactory.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonFactory</code></a> that will create a proper 275 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/ObjectCodec.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>ObjectCodec</code></a> to allow seam-less conversions between 276 JSON content and Java objects (POJOs).</div> 277</td> 278</tr> 279<tr class="altColor"> 280<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/Module.html" title="class in com.fasterxml.jackson.databind">Module</a></td> 281<td class="colLast"> 282<div class="block">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> 283 to provide a well-defined set of extensions to default functionality; such as 284 support for new data types.</div> 285</td> 286</tr> 287<tr class="rowColor"> 288<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind">ObjectMapper</a></td> 289<td class="colLast"> 290<div class="block">This mapper (or, data binder, or codec) provides functionality for 291 converting between Java objects (instances of JDK provided core classes, 292 beans), and matching JSON constructs.</div> 293</td> 294</tr> 295<tr class="altColor"> 296<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.DefaultTypeResolverBuilder.html" title="class in com.fasterxml.jackson.databind">ObjectMapper.DefaultTypeResolverBuilder</a></td> 297<td class="colLast"> 298<div class="block">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 299 used with so-called "default typing" 300 (see <a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html#enableDefaultTyping()"><code>ObjectMapper.enableDefaultTyping()</code></a> for details).</div> 301</td> 302</tr> 303<tr class="rowColor"> 304<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind">ObjectReader</a></td> 305<td class="colLast"> 306<div class="block">Builder object that can be used for per-serialization configuration of 307 deserialization parameters, such as root type to use or object 308 to update (instead of constructing new instance).</div> 309</td> 310</tr> 311<tr class="altColor"> 312<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind">ObjectWriter</a></td> 313<td class="colLast"> 314<div class="block">Builder object that can be used for per-serialization configuration of 315 serialization parameters, such as JSON View and root type to use.</div> 316</td> 317</tr> 318<tr class="rowColor"> 319<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/PropertyName.html" title="class in com.fasterxml.jackson.databind">PropertyName</a></td> 320<td class="colLast"> 321<div class="block">Simple value class used for containing names of properties as defined 322 by annotations (and possibly other configuration sources).</div> 323</td> 324</tr> 325<tr class="altColor"> 326<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy</a></td> 327<td class="colLast"> 328<div class="block">Class that defines how names of JSON properties ("external names") 329 are derived from names of POJO methods and fields ("internal names"), 330 in cases where they are not 331 auto-detected and no explicit annotations exist for naming.</div> 332</td> 333</tr> 334<tr class="rowColor"> 335<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.LowerCaseWithUnderscoresStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy.LowerCaseWithUnderscoresStrategy</a></td> 336<td class="colLast"> 337<div class="block">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 338 property names to lower case JSON element names, separated by 339 underscores.</div> 340</td> 341</tr> 342<tr class="altColor"> 343<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.PascalCaseStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy.PascalCaseStrategy</a></td> 344<td class="colLast"> 345<div class="block">A <a href="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.html" title="class in com.fasterxml.jackson.databind"><code>PropertyNamingStrategy</code></a> that translates typical camelCase Java 346 property names to PascalCase JSON element names (i.e., with a capital 347 first letter).</div> 348</td> 349</tr> 350<tr class="rowColor"> 351<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.PropertyNamingStrategyBase.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy.PropertyNamingStrategyBase</a></td> 352<td class="colLast"> </td> 353</tr> 354<tr class="altColor"> 355<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/SerializationConfig.html" title="class in com.fasterxml.jackson.databind">SerializationConfig</a></td> 356<td class="colLast"> 357<div class="block">Object that contains baseline configuration for serialization 358 process.</div> 359</td> 360</tr> 361<tr class="rowColor"> 362<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind">SerializerProvider</a></td> 363<td class="colLast"> 364<div class="block">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 365 <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 366 instances of specific types; as well as the default implementation 367 of the functionality.</div> 368</td> 369</tr> 370</tbody> 371</table> 372</li> 373<li class="blockList"> 374<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Enum Summary table, listing enums, and an explanation"> 375<caption><span>Enum Summary</span><span class="tabEnd"> </span></caption> 376<tr> 377<th class="colFirst" scope="col">Enum</th> 378<th class="colLast" scope="col">Description</th> 379</tr> 380<tbody> 381<tr class="altColor"> 382<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.ReferenceProperty.Type.html" title="enum in com.fasterxml.jackson.databind">AnnotationIntrospector.ReferenceProperty.Type</a></td> 383<td class="colLast"> </td> 384</tr> 385<tr class="rowColor"> 386<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a></td> 387<td class="colLast"> 388<div class="block">Enumeration that defines simple on/off features that affect 389 the way Java objects are deserialized from JSON</div> 390</td> 391</tr> 392<tr class="altColor"> 393<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a></td> 394<td class="colLast"> 395<div class="block">Enumeration that defines simple on/off features to set 396 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) 397 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 398 through various convenience methods through context objects).</div> 399</td> 400</tr> 401<tr class="rowColor"> 402<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.DefaultTyping.html" title="enum in com.fasterxml.jackson.databind">ObjectMapper.DefaultTyping</a></td> 403<td class="colLast"> 404<div class="block">Enumeration used with <a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html#enableDefaultTyping()"><code>ObjectMapper.enableDefaultTyping()</code></a> 405 to specify what kind of types (classes) default typing should 406 be used for.</div> 407</td> 408</tr> 409<tr class="altColor"> 410<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a></td> 411<td class="colLast"> 412<div class="block">Enumeration that defines simple on/off features that affect 413 the way Java objects are serialized.</div> 414</td> 415</tr> 416</tbody> 417</table> 418</li> 419<li class="blockList"> 420<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Exception Summary table, listing exceptions, and an explanation"> 421<caption><span>Exception Summary</span><span class="tabEnd"> </span></caption> 422<tr> 423<th class="colFirst" scope="col">Exception</th> 424<th class="colLast" scope="col">Description</th> 425</tr> 426<tbody> 427<tr class="altColor"> 428<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</a></td> 429<td class="colLast"> 430<div class="block">Checked exception used to signal fatal problems with mapping of 431 content.</div> 432</td> 433</tr> 434<tr class="rowColor"> 435<td class="colFirst"><a href="../../../../com/fasterxml/jackson/databind/RuntimeJsonMappingException.html" title="class in com.fasterxml.jackson.databind">RuntimeJsonMappingException</a></td> 436<td class="colLast"> 437<div class="block">Wrapper used when interface does not allow throwing a checked 438 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a></div> 439</td> 440</tr> 441</tbody> 442</table> 443</li> 444</ul> 445<a name="package_description"> 446<!-- --> 447</a> 448<h2 title="Package com.fasterxml.jackson.databind Description">Package com.fasterxml.jackson.databind Description</h2> 449<div class="block">Contains basic mapper (conversion) functionality that 450allows for converting between regular streaming json content and 451Java objects (beans or Tree Model: support for both is via 452<a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a> class, as well 453as convenience methods included in 454<a href="http://fasterxml.github.com/jackson-core/javadoc/2.1.1/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonParser</code></a> 455<p> 456Object mapper will convert Json content to ant from 457basic Java wrapper types (Integer, Boolean, Double), 458Collection types (List, Map), Java Beans, 459Strings and nulls. 460<p> 461Tree 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 462from JSON content (and writes such trees as JSON), 463similar to how DOM model works with XML. 464Main benefits over Object mapping are: 465<ul> 466 <li>No null checks are needed (dummy 467nodes are created as necessary to represent "missing" Object fields 468and Array elements) 469 </li> 470 <li>No type casts are usually needed: all public access methods are defined 471in basic <code>JsonNode</code> class, and when "incompatible" method (such as Array 472element access on, say, Boolean node) is used, returned node is 473virtual "missing" node. 474 </li> 475</ul> 476Because of its dynamic nature, Tree mapping is often convenient 477for basic path access and tree navigation, where structure of 478the resulting tree is known in advance.</div> 479</div> 480<!-- ======= START OF BOTTOM NAVBAR ====== --> 481<div class="bottomNav"><a name="navbar_bottom"> 482<!-- --> 483</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> 484<!-- --> 485</a> 486<ul class="navList" title="Navigation"> 487<li><a href="../../../../overview-summary.html">Overview</a></li> 488<li class="navBarCell1Rev">Package</li> 489<li>Class</li> 490<li><a href="package-use.html">Use</a></li> 491<li><a href="package-tree.html">Tree</a></li> 492<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 493<li><a href="../../../../index-all.html">Index</a></li> 494<li><a href="../../../../help-doc.html">Help</a></li> 495</ul> 496</div> 497<div class="subNav"> 498<ul class="navList"> 499<li>Prev Package</li> 500<li><a href="../../../../com/fasterxml/jackson/databind/annotation/package-summary.html">Next Package</a></li> 501</ul> 502<ul class="navList"> 503<li><a href="../../../../index.html?com/fasterxml/jackson/databind/package-summary.html" target="_top">Frames</a></li> 504<li><a href="package-summary.html" target="_top">No Frames</a></li> 505</ul> 506<ul class="navList" id="allclasses_navbar_bottom"> 507<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 508</ul> 509<div> 510<script type="text/javascript"><!-- 511 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 512 if(window==top) { 513 allClassesLink.style.display = "block"; 514 } 515 else { 516 allClassesLink.style.display = "none"; 517 } 518 //--> 519</script> 520</div> 521<a name="skip-navbar_bottom"> 522<!-- --> 523</a></div> 524<!-- ======== END OF BOTTOM NAVBAR ======= --> 525<p class="legalCopy"><small>Copyright © 2012-2013 <a href="http://fasterxml.com/">FasterXML</a>. All Rights Reserved.</small></p> 526</body> 527</html> 528