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_35) on Tue Oct 09 17:08:22 PDT 2012 --> 6<META http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<TITLE> 8com.fasterxml.jackson.databind (jackson-databind 2.1.0 API) 9</TITLE> 10 11<META NAME="date" CONTENT="2012-10-09"> 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.1.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<A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><CODE>JsonParser</CODE></A> 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 <A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><CODE>JsonGenerator</CODE></A> 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><B>Deprecated.</B> <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></TD> 145</TR> 146<TR BGCOLOR="white" CLASS="TableRowColor"> 147<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> 148<TD>Value type used with managed and back references; contains type and 149 logic name, used to link related references</TD> 150</TR> 151<TR BGCOLOR="white" CLASS="TableRowColor"> 152<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/BeanDescription.html" title="class in com.fasterxml.jackson.databind">BeanDescription</A></B></TD> 153<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 154 help in constructing serializers and deserializers.</TD> 155</TR> 156<TR BGCOLOR="white" CLASS="TableRowColor"> 157<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> 158<TD>Simple stand-alone implementation, useful as a placeholder 159 or base class for more complex implementations.</TD> 160</TR> 161<TR BGCOLOR="white" CLASS="TableRowColor"> 162<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind">DeserializationConfig</A></B></TD> 163<TD>Object that contains baseline configuration for deserialization 164 process.</TD> 165</TR> 166<TR BGCOLOR="white" CLASS="TableRowColor"> 167<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</A></B></TD> 168<TD>Context for the process of deserialization a single root-level value.</TD> 169</TR> 170<TR BGCOLOR="white" CLASS="TableRowColor"> 171<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/InjectableValues.html" title="class in com.fasterxml.jackson.databind">InjectableValues</A></B></TD> 172<TD>Abstract class that defines API for objects that provide value to 173 "inject" during deserialization.</TD> 174</TR> 175<TR BGCOLOR="white" CLASS="TableRowColor"> 176<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> 177<TD>Simple standard implementation which uses a simple Map to 178 store values to inject, identified by simple String keys.</TD> 179</TR> 180<TR BGCOLOR="white" CLASS="TableRowColor"> 181<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</A></B></TD> 182<TD>Base class for type token classes used both to contain information 183 and as keys for deserializers.</TD> 184</TR> 185<TR BGCOLOR="white" CLASS="TableRowColor"> 186<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer<T></A></B></TD> 187<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 188 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 189 arbitrary types from JSON, using provided <A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><CODE>JsonParser</CODE></A>.</TD> 190</TR> 191<TR BGCOLOR="white" CLASS="TableRowColor"> 192<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> 193<TD>This marker class is only to be used with annotations, to 194 indicate that <b>no deserializer is configured</b>.</TD> 195</TR> 196<TR BGCOLOR="white" CLASS="TableRowColor"> 197<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> 198<TD>Simple bean class used to contain references.</TD> 199</TR> 200<TR BGCOLOR="white" CLASS="TableRowColor"> 201<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonNode.html" title="class in com.fasterxml.jackson.databind">JsonNode</A></B></TD> 202<TD>Base class for all JSON nodes, which form the basis of JSON 203 Tree Model that Jackson implements.</TD> 204</TR> 205<TR BGCOLOR="white" CLASS="TableRowColor"> 206<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind">JsonSerializer<T></A></B></TD> 207<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 208 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 209 arbitrary types into JSON, using provided <A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><CODE>JsonGenerator</CODE></A>.</TD> 210</TR> 211<TR BGCOLOR="white" CLASS="TableRowColor"> 212<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> 213<TD>This marker class is only to be used with annotations, to 214 indicate that <b>no serializer is configured</b>.</TD> 215</TR> 216<TR BGCOLOR="white" CLASS="TableRowColor"> 217<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/KeyDeserializer.html" title="class in com.fasterxml.jackson.databind">KeyDeserializer</A></B></TD> 218<TD>Abstract class that defines API used for deserializing JSON content 219 field names into Java Map keys.</TD> 220</TR> 221<TR BGCOLOR="white" CLASS="TableRowColor"> 222<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> 223<TD>This marker class is only to be used with annotations, to 224 indicate that <b>no deserializer is configured</b>.</TD> 225</TR> 226<TR BGCOLOR="white" CLASS="TableRowColor"> 227<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/MappingIterator.html" title="class in com.fasterxml.jackson.databind">MappingIterator<T></A></B></TD> 228<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 229 objects.</TD> 230</TR> 231<TR BGCOLOR="white" CLASS="TableRowColor"> 232<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/MappingJsonFactory.html" title="class in com.fasterxml.jackson.databind">MappingJsonFactory</A></B></TD> 233<TD>Sub-class of <A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/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 234 <A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/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 235 JSON content and Java objects (POJOs).</TD> 236</TR> 237<TR BGCOLOR="white" CLASS="TableRowColor"> 238<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/Module.html" title="class in com.fasterxml.jackson.databind">Module</A></B></TD> 239<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> 240 to provide a well-defined set of extensions to default functionality; such as 241 support for new data types.</TD> 242</TR> 243<TR BGCOLOR="white" CLASS="TableRowColor"> 244<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind">ObjectMapper</A></B></TD> 245<TD>This mapper (or, data binder, or codec) provides functionality for 246 converting between Java objects (instances of JDK provided core classes, 247 beans), and matching JSON constructs.</TD> 248</TR> 249<TR BGCOLOR="white" CLASS="TableRowColor"> 250<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> 251<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 252 used with so-called "default typing" 253 (see <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html#enableDefaultTyping()"><CODE>ObjectMapper.enableDefaultTyping()</CODE></A> for details).</TD> 254</TR> 255<TR BGCOLOR="white" CLASS="TableRowColor"> 256<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind">ObjectReader</A></B></TD> 257<TD>Builder object that can be used for per-serialization configuration of 258 deserialization parameters, such as root type to use or object 259 to update (instead of constructing new instance).</TD> 260</TR> 261<TR BGCOLOR="white" CLASS="TableRowColor"> 262<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind">ObjectWriter</A></B></TD> 263<TD>Builder object that can be used for per-serialization configuration of 264 serialization parameters, such as JSON View and root type to use.</TD> 265</TR> 266<TR BGCOLOR="white" CLASS="TableRowColor"> 267<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/PropertyName.html" title="class in com.fasterxml.jackson.databind">PropertyName</A></B></TD> 268<TD>Simple value class used for containing names of properties as defined 269 by annotations (and possibly other configuration sources).</TD> 270</TR> 271<TR BGCOLOR="white" CLASS="TableRowColor"> 272<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy</A></B></TD> 273<TD>Class that defines how names of JSON properties ("external names") 274 are derived from names of POJO methods and fields ("internal names"), 275 in cases where they are not 276 auto-detected and no explicit annotations exist for naming.</TD> 277</TR> 278<TR BGCOLOR="white" CLASS="TableRowColor"> 279<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> 280<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 281 property names to lower case JSON element names, separated by 282 underscores.</TD> 283</TR> 284<TR BGCOLOR="white" CLASS="TableRowColor"> 285<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/PropertyNamingStrategy.PascalCaseStrategy.html" title="class in com.fasterxml.jackson.databind">PropertyNamingStrategy.PascalCaseStrategy</A></B></TD> 286<TD>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 287 property names to PascalCase JSON element names (i.e., with a capital 288 first letter).</TD> 289</TR> 290<TR BGCOLOR="white" CLASS="TableRowColor"> 291<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> 292<TD> </TD> 293</TR> 294<TR BGCOLOR="white" CLASS="TableRowColor"> 295<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/SerializationConfig.html" title="class in com.fasterxml.jackson.databind">SerializationConfig</A></B></TD> 296<TD>Object that contains baseline configuration for serialization 297 process.</TD> 298</TR> 299<TR BGCOLOR="white" CLASS="TableRowColor"> 300<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind">SerializerProvider</A></B></TD> 301<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 302 <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 303 instances of specific types; as well as the default implementation 304 of the functionality.</TD> 305</TR> 306</TABLE> 307 308 309<P> 310 311<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 312<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 313<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 314<B>Enum Summary</B></FONT></TH> 315</TR> 316<TR BGCOLOR="white" CLASS="TableRowColor"> 317<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> 318<TD> </TD> 319</TR> 320<TR BGCOLOR="white" CLASS="TableRowColor"> 321<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</A></B></TD> 322<TD>Enumeration that defines simple on/off features that affect 323 the way Java objects are deserialized from JSON</TD> 324</TR> 325<TR BGCOLOR="white" CLASS="TableRowColor"> 326<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</A></B></TD> 327<TD>Enumeration that defines simple on/off features to set 328 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) 329 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 330 through various convenience methods through context objects).</TD> 331</TR> 332<TR BGCOLOR="white" CLASS="TableRowColor"> 333<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> 334<TD>Enumeration used with <A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html#enableDefaultTyping()"><CODE>ObjectMapper.enableDefaultTyping()</CODE></A> 335 to specify what kind of types (classes) default typing should 336 be used for.</TD> 337</TR> 338<TR BGCOLOR="white" CLASS="TableRowColor"> 339<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</A></B></TD> 340<TD>Enumeration that defines simple on/off features that affect 341 the way Java objects are serialized.</TD> 342</TR> 343</TABLE> 344 345 346<P> 347 348<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 349<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 350<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 351<B>Exception Summary</B></FONT></TH> 352</TR> 353<TR BGCOLOR="white" CLASS="TableRowColor"> 354<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</A></B></TD> 355<TD>Checked exception used to signal fatal problems with mapping of 356 content.</TD> 357</TR> 358<TR BGCOLOR="white" CLASS="TableRowColor"> 359<TD WIDTH="15%"><B><A HREF="../../../../com/fasterxml/jackson/databind/RuntimeJsonMappingException.html" title="class in com.fasterxml.jackson.databind">RuntimeJsonMappingException</A></B></TD> 360<TD>Wrapper used when interface does not allow throwing a checked 361 <A HREF="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonMappingException</CODE></A></TD> 362</TR> 363</TABLE> 364 365 366<P> 367<A NAME="package_description"><!-- --></A><H2> 368Package com.fasterxml.jackson.databind Description 369</H2> 370 371<P> 372Contains basic mapper (conversion) functionality that 373allows for converting between regular streaming json content and 374Java objects (beans or Tree Model: support for both is via 375<A HREF="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> class, as well 376as convenience methods included in 377<A HREF="http://fasterxml.github.com/jackson-core/javadoc/2.1.0/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><CODE>JsonParser</CODE></A> 378<p> 379Object mapper will convert Json content to ant from 380basic Java wrapper types (Integer, Boolean, Double), 381Collection types (List, Map), Java Beans, 382Strings and nulls. 383<p> 384Tree 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 385from JSON content (and writes such trees as JSON), 386similar to how DOM model works with XML. 387Main benefits over Object mapping are: 388<ul> 389 <li>No null checks are needed (dummy 390nodes are created as necessary to represent "missing" Object fields 391and Array elements) 392 </li> 393 <li>No type casts are usually needed: all public access methods are defined 394in basic <code>JsonNode</code> class, and when "incompatible" method (such as Array 395element access on, say, Boolean node) is used, returned node is 396virtual "missing" node. 397 </li> 398</ul> 399Because of its dynamic nature, Tree mapping is often convenient 400for basic path access and tree navigation, where structure of 401the resulting tree is known in advance. 402<P> 403 404<P> 405<DL> 406</DL> 407<HR> 408 409 410<!-- ======= START OF BOTTOM NAVBAR ====== --> 411<A NAME="navbar_bottom"><!-- --></A> 412<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 413<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 414<TR> 415<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 416<A NAME="navbar_bottom_firstrow"><!-- --></A> 417<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 418 <TR ALIGN="center" VALIGN="top"> 419 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 420 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD> 421 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> 422 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 423 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 424 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 425 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 426 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 427 </TR> 428</TABLE> 429</TD> 430<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 431</EM> 432</TD> 433</TR> 434 435<TR> 436<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 437 PREV PACKAGE 438 <A HREF="../../../../com/fasterxml/jackson/databind/annotation/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD> 439<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 440 <A HREF="../../../../index.html?com/fasterxml/jackson/databind/package-summary.html" target="_top"><B>FRAMES</B></A> 441 <A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A> 442 <SCRIPT type="text/javascript"> 443 <!-- 444 if(window==top) { 445 document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); 446 } 447 //--> 448</SCRIPT> 449<NOSCRIPT> 450 <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> 451</NOSCRIPT> 452 453 454</FONT></TD> 455</TR> 456</TABLE> 457<A NAME="skip-navbar_bottom"></A> 458<!-- ======== END OF BOTTOM NAVBAR ======= --> 459 460<HR> 461Copyright © 2012 <a href="http://fasterxml.com/">FasterXML</a>. All Rights Reserved. 462</BODY> 463</HTML> 464