• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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&nbsp;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:&nbsp;<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">&nbsp;</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">&nbsp;</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>&lt;T&gt;</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>&lt;T&gt;</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>&lt;T&gt;</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">&nbsp;</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">&nbsp;</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">&nbsp;</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">&nbsp;</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 &#169; 2012-2013 <a href="http://fasterxml.com/">FasterXML</a>. All Rights Reserved.</small></p>
526</body>
527</html>
528