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.deser (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.deser (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 <A HREF="../../../../../com/fasterxml/jackson/databind/cfg/package-summary.html"><B>PREV PACKAGE</B></A> 60 <A HREF="../../../../../com/fasterxml/jackson/databind/deser/impl/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/deser/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.deser 85</H2> 86Contains implementation classes of deserialization part of 87 data binding. 88<P> 89<B>See:</B> 90<BR> 91 <A HREF="#package_description"><B>Description</B></A> 92<P> 93 94<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 95<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 96<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 97<B>Interface Summary</B></FONT></TH> 98</TR> 99<TR BGCOLOR="white" CLASS="TableRowColor"> 100<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/ContextualDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser">ContextualDeserializer</A></B></TD> 101<TD>Add-on interface that <A HREF="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonDeserializer</CODE></A>s can implement to get a callback 102 that can be used to create contextual (context-dependent) instances of 103 deserializer to use for handling properties of supported type.</TD> 104</TR> 105<TR BGCOLOR="white" CLASS="TableRowColor"> 106<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/ContextualKeyDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser">ContextualKeyDeserializer</A></B></TD> 107<TD>Add-on interface that <A HREF="../../../../../com/fasterxml/jackson/databind/KeyDeserializer.html" title="class in com.fasterxml.jackson.databind"><CODE>KeyDeserializer</CODE></A>s can implement to get a callback 108 that can be used to create contextual instances of key deserializer to use for 109 handling Map keys of supported type.</TD> 110</TR> 111<TR BGCOLOR="white" CLASS="TableRowColor"> 112<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/Deserializers.html" title="interface in com.fasterxml.jackson.databind.deser">Deserializers</A></B></TD> 113<TD>Interface that defines API for simple extensions that can provide additional deserializers 114 for various types.</TD> 115</TR> 116<TR BGCOLOR="white" CLASS="TableRowColor"> 117<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/KeyDeserializers.html" title="interface in com.fasterxml.jackson.databind.deser">KeyDeserializers</A></B></TD> 118<TD>Interface that defines API for simple extensions that can provide additional deserializers 119 for deserializer Map keys of various types, from JSON property names.</TD> 120</TR> 121<TR BGCOLOR="white" CLASS="TableRowColor"> 122<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/ResolvableDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser">ResolvableDeserializer</A></B></TD> 123<TD>Interface used to indicate deserializers that want to do post-processing 124 after construction but before being returned to caller (and possibly cached) 125 and used.</TD> 126</TR> 127<TR BGCOLOR="white" CLASS="TableRowColor"> 128<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiators.html" title="interface in com.fasterxml.jackson.databind.deser">ValueInstantiators</A></B></TD> 129<TD>Interface for providers of <A HREF="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiator.html" title="class in com.fasterxml.jackson.databind.deser"><CODE>ValueInstantiator</CODE></A> instances.</TD> 130</TR> 131</TABLE> 132 133 134<P> 135 136<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 137<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 138<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 139<B>Class Summary</B></FONT></TH> 140</TR> 141<TR BGCOLOR="white" CLASS="TableRowColor"> 142<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/AbstractDeserializer.html" title="class in com.fasterxml.jackson.databind.deser">AbstractDeserializer</A></B></TD> 143<TD>Deserializer only used for abstract types used as placeholders during polymorphic 144 type handling deserialization.</TD> 145</TR> 146<TR BGCOLOR="white" CLASS="TableRowColor"> 147<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BasicDeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser">BasicDeserializerFactory</A></B></TD> 148<TD>Abstract factory base class that can provide deserializers for standard 149 JDK classes, including collection classes and simple heuristics for 150 "upcasting" commmon collection interface types 151 (such as <A HREF="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><CODE>Collection</CODE></A>).</TD> 152</TR> 153<TR BGCOLOR="white" CLASS="TableRowColor"> 154<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializer.html" title="class in com.fasterxml.jackson.databind.deser">BeanDeserializer</A></B></TD> 155<TD>Deserializer class that can deserialize instances of 156 arbitrary bean objects, usually from JSON Object structs, 157 but possibly also from simple types like String values.</TD> 158</TR> 159<TR BGCOLOR="white" CLASS="TableRowColor"> 160<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerBase.html" title="class in com.fasterxml.jackson.databind.deser">BeanDeserializerBase</A></B></TD> 161<TD>Base class for <code>BeanDeserializer</code>.</TD> 162</TR> 163<TR BGCOLOR="white" CLASS="TableRowColor"> 164<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerBuilder.html" title="class in com.fasterxml.jackson.databind.deser">BeanDeserializerBuilder</A></B></TD> 165<TD>Builder class used for aggregating deserialization information about 166 a POJO, in order to build a <A HREF="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonDeserializer</CODE></A> for deserializing 167 intances.</TD> 168</TR> 169<TR BGCOLOR="white" CLASS="TableRowColor"> 170<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser">BeanDeserializerFactory</A></B></TD> 171<TD>Concrete deserializer factory class that adds full Bean deserializer 172 construction logic using class introspection.</TD> 173</TR> 174<TR BGCOLOR="white" CLASS="TableRowColor"> 175<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerModifier.html" title="class in com.fasterxml.jackson.databind.deser">BeanDeserializerModifier</A></B></TD> 176<TD>Abstract class that defines API for objects that can be registered (for <A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser"><CODE>BeanDeserializerFactory</CODE></A> 177 to participate in constructing <A HREF="../../../../../com/fasterxml/jackson/databind/deser/BeanDeserializer.html" title="class in com.fasterxml.jackson.databind.deser"><CODE>BeanDeserializer</CODE></A> instances.</TD> 178</TR> 179<TR BGCOLOR="white" CLASS="TableRowColor"> 180<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/BuilderBasedDeserializer.html" title="class in com.fasterxml.jackson.databind.deser">BuilderBasedDeserializer</A></B></TD> 181<TD>Class that handles deserialization using a separate 182 Builder class, which is used for data binding and 183 produces actual deserialized value at the end 184 of data binding.</TD> 185</TR> 186<TR BGCOLOR="white" CLASS="TableRowColor"> 187<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/CreatorProperty.html" title="class in com.fasterxml.jackson.databind.deser">CreatorProperty</A></B></TD> 188<TD>This concrete sub-class implements property that is passed 189 via Creator (constructor or static factory method).</TD> 190</TR> 191<TR BGCOLOR="white" CLASS="TableRowColor"> 192<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/DefaultDeserializationContext.html" title="class in com.fasterxml.jackson.databind.deser">DefaultDeserializationContext</A></B></TD> 193<TD>Default <A HREF="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><CODE>DeserializationContext</CODE></A> implementation that adds 194 extended API for <A HREF="../../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A> (and <A HREF="../../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectReader</CODE></A>) 195 to call, as well as implements certain parts that base class 196 has left abstract.</TD> 197</TR> 198<TR BGCOLOR="white" CLASS="TableRowColor"> 199<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/DefaultDeserializationContext.Impl.html" title="class in com.fasterxml.jackson.databind.deser">DefaultDeserializationContext.Impl</A></B></TD> 200<TD> </TD> 201</TR> 202<TR BGCOLOR="white" CLASS="TableRowColor"> 203<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html" title="class in com.fasterxml.jackson.databind.deser">DeserializationProblemHandler</A></B></TD> 204<TD>This is the class that can be registered (via 205 <A HREF="../../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind"><CODE>DeserializationConfig</CODE></A> object owner by 206 <A HREF="../../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A>) to get calledn when a potentially 207 recoverable problem is encountered during deserialization 208 process.</TD> 209</TR> 210<TR BGCOLOR="white" CLASS="TableRowColor"> 211<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/DeserializerCache.html" title="class in com.fasterxml.jackson.databind.deser">DeserializerCache</A></B></TD> 212<TD>Class that defines caching layer between callers (like 213 <A HREF="../../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><CODE>ObjectMapper</CODE></A>, 214 <A HREF="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><CODE>DeserializationContext</CODE></A>) 215 and classes that construct deserializers 216 (<A HREF="../../../../../com/fasterxml/jackson/databind/deser/DeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser"><CODE>DeserializerFactory</CODE></A>).</TD> 217</TR> 218<TR BGCOLOR="white" CLASS="TableRowColor"> 219<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/DeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser">DeserializerFactory</A></B></TD> 220<TD>Abstract class that defines API used by <A HREF="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><CODE>DeserializationContext</CODE></A> 221 to construct actual 222 <A HREF="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><CODE>JsonDeserializer</CODE></A> instances (which are then cached by 223 context and/or dedicated cache).</TD> 224</TR> 225<TR BGCOLOR="white" CLASS="TableRowColor"> 226<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/Deserializers.Base.html" title="class in com.fasterxml.jackson.databind.deser">Deserializers.Base</A></B></TD> 227<TD>Basic <A HREF="../../../../../com/fasterxml/jackson/databind/deser/Deserializers.html" title="interface in com.fasterxml.jackson.databind.deser"><CODE>Deserializers</CODE></A> implementation that implements all methods but provides 228 no deserializers.</TD> 229</TR> 230<TR BGCOLOR="white" CLASS="TableRowColor"> 231<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/SettableAnyProperty.html" title="class in com.fasterxml.jackson.databind.deser">SettableAnyProperty</A></B></TD> 232<TD>Class that represents a "wildcard" set method which can be used 233 to generically set values of otherwise unmapped (aka "unknown") 234 properties read from Json content.</TD> 235</TR> 236<TR BGCOLOR="white" CLASS="TableRowColor"> 237<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/SettableBeanProperty.html" title="class in com.fasterxml.jackson.databind.deser">SettableBeanProperty</A></B></TD> 238<TD>Base class for deserilizable properties of a bean: contains 239 both type and name definitions, and reflection-based set functionality.</TD> 240</TR> 241<TR BGCOLOR="white" CLASS="TableRowColor"> 242<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiator.html" title="class in com.fasterxml.jackson.databind.deser">ValueInstantiator</A></B></TD> 243<TD>Class that defines simple API implemented by objects that create value 244 instances.</TD> 245</TR> 246<TR BGCOLOR="white" CLASS="TableRowColor"> 247<TD WIDTH="15%"><B><A HREF="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiators.Base.html" title="class in com.fasterxml.jackson.databind.deser">ValueInstantiators.Base</A></B></TD> 248<TD>Basic "NOP" implementation that can be used as the base class for custom implementations.</TD> 249</TR> 250</TABLE> 251 252 253<P> 254<A NAME="package_description"><!-- --></A><H2> 255Package com.fasterxml.jackson.databind.deser Description 256</H2> 257 258<P> 259Contains implementation classes of deserialization part of 260 data binding. 261<P> 262 263<P> 264<DL> 265</DL> 266<HR> 267 268 269<!-- ======= START OF BOTTOM NAVBAR ====== --> 270<A NAME="navbar_bottom"><!-- --></A> 271<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 272<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 273<TR> 274<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 275<A NAME="navbar_bottom_firstrow"><!-- --></A> 276<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 277 <TR ALIGN="center" VALIGN="top"> 278 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 279 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD> 280 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> 281 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 282 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 283 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 284 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 285 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 286 </TR> 287</TABLE> 288</TD> 289<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 290</EM> 291</TD> 292</TR> 293 294<TR> 295<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 296 <A HREF="../../../../../com/fasterxml/jackson/databind/cfg/package-summary.html"><B>PREV PACKAGE</B></A> 297 <A HREF="../../../../../com/fasterxml/jackson/databind/deser/impl/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD> 298<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 299 <A HREF="../../../../../index.html?com/fasterxml/jackson/databind/deser/package-summary.html" target="_top"><B>FRAMES</B></A> 300 <A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A> 301 <SCRIPT type="text/javascript"> 302 <!-- 303 if(window==top) { 304 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>'); 305 } 306 //--> 307</SCRIPT> 308<NOSCRIPT> 309 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A> 310</NOSCRIPT> 311 312 313</FONT></TD> 314</TR> 315</TABLE> 316<A NAME="skip-navbar_bottom"></A> 317<!-- ======== END OF BOTTOM NAVBAR ======= --> 318 319<HR> 320Copyright © 2012 <a href="http://fasterxml.com">fasterxml.com</a>. All Rights Reserved. 321</BODY> 322</HTML> 323