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_79) on Wed Jul 20 08:39:11 PDT 2016 --> 6<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<title>DeserializationProblemHandler (jackson-databind 2.8.0 API)</title> 8<meta name="date" content="2016-07-20"> 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="DeserializationProblemHandler (jackson-databind 2.8.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><a href="package-summary.html">Package</a></li> 30<li class="navBarCell1Rev">Class</li> 31<li><a href="class-use/DeserializationProblemHandler.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><a href="../../../../../com/fasterxml/jackson/databind/deser/DefaultDeserializationContext.Impl.html" title="class in com.fasterxml.jackson.databind.deser"><span class="strong">Prev Class</span></a></li> 41<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializerCache.html" title="class in com.fasterxml.jackson.databind.deser"><span class="strong">Next Class</span></a></li> 42</ul> 43<ul class="navList"> 44<li><a href="../../../../../index.html?com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html" target="_top">Frames</a></li> 45<li><a href="DeserializationProblemHandler.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<div> 63<ul class="subNavList"> 64<li>Summary: </li> 65<li>Nested | </li> 66<li><a href="#field_summary">Field</a> | </li> 67<li><a href="#constructor_summary">Constr</a> | </li> 68<li><a href="#method_summary">Method</a></li> 69</ul> 70<ul class="subNavList"> 71<li>Detail: </li> 72<li><a href="#field_detail">Field</a> | </li> 73<li><a href="#constructor_detail">Constr</a> | </li> 74<li><a href="#method_detail">Method</a></li> 75</ul> 76</div> 77<a name="skip-navbar_top"> 78<!-- --> 79</a></div> 80<!-- ========= END OF TOP NAVBAR ========= --> 81<!-- ======== START OF CLASS DATA ======== --> 82<div class="header"> 83<div class="subTitle">com.fasterxml.jackson.databind.deser</div> 84<h2 title="Class DeserializationProblemHandler" class="title">Class DeserializationProblemHandler</h2> 85</div> 86<div class="contentContainer"> 87<ul class="inheritance"> 88<li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li> 89<li> 90<ul class="inheritance"> 91<li>com.fasterxml.jackson.databind.deser.DeserializationProblemHandler</li> 92</ul> 93</li> 94</ul> 95<div class="description"> 96<ul class="blockList"> 97<li class="blockList"> 98<hr> 99<br> 100<pre>public abstract class <span class="strong">DeserializationProblemHandler</span> 101extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre> 102<div class="block">This is the class that can be registered (via 103 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind"><code>DeserializationConfig</code></a> object owner by 104 <a href="../../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a>) to get called when a potentially 105 recoverable problem is encountered during deserialization 106 process. Handlers can try to resolve the problem, throw 107 an exception or just skip the content. 108<p> 109 Default implementations for all methods implemented minimal 110 "do nothing" functionality, which is roughly equivalent to 111 not having a registered listener at all. This allows for 112 only implemented handler methods one is interested in, without 113 handling other cases. 114<p> 115 NOTE: it is typically <b>NOT</b> acceptable to simply do nothing, 116 because this will result in unprocessed tokens being left in 117 token stream (read via <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonParser</code></a>, in case a structured 118 (JSON Object or JSON Array) value is being pointed to by parser.</div> 119</li> 120</ul> 121</div> 122<div class="summary"> 123<ul class="blockList"> 124<li class="blockList"> 125<!-- =========== FIELD SUMMARY =========== --> 126<ul class="blockList"> 127<li class="blockList"><a name="field_summary"> 128<!-- --> 129</a> 130<h3>Field Summary</h3> 131<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation"> 132<caption><span>Fields</span><span class="tabEnd"> </span></caption> 133<tr> 134<th class="colFirst" scope="col">Modifier and Type</th> 135<th class="colLast" scope="col">Field and Description</th> 136</tr> 137<tr class="altColor"> 138<td class="colFirst"><code>static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 139<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED">NOT_HANDLED</a></strong></code> 140<div class="block">Marker value returned by some handler methods to indicate that 141 they could not handle problem and produce replacement value.</div> 142</td> 143</tr> 144</table> 145</li> 146</ul> 147<!-- ======== CONSTRUCTOR SUMMARY ======== --> 148<ul class="blockList"> 149<li class="blockList"><a name="constructor_summary"> 150<!-- --> 151</a> 152<h3>Constructor Summary</h3> 153<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> 154<caption><span>Constructors</span><span class="tabEnd"> </span></caption> 155<tr> 156<th class="colOne" scope="col">Constructor and Description</th> 157</tr> 158<tr class="altColor"> 159<td class="colOne"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#DeserializationProblemHandler()">DeserializationProblemHandler</a></strong>()</code> </td> 160</tr> 161</table> 162</li> 163</ul> 164<!-- ========== METHOD SUMMARY =========== --> 165<ul class="blockList"> 166<li class="blockList"><a name="method_summary"> 167<!-- --> 168</a> 169<h3>Method Summary</h3> 170<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 171<caption><span>Methods</span><span class="tabEnd"> </span></caption> 172<tr> 173<th class="colFirst" scope="col">Modifier and Type</th> 174<th class="colLast" scope="col">Method and Description</th> 175</tr> 176<tr class="altColor"> 177<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 178<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleInstantiationProblem(com.fasterxml.jackson.databind.DeserializationContext,%20java.lang.Class,%20java.lang.Object,%20java.lang.Throwable)">handleInstantiationProblem</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 179 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> instClass, 180 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> argument, 181 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> t)</code> 182<div class="block">Method called when instance creation for a type fails due to an exception.</div> 183</td> 184</tr> 185<tr class="rowColor"> 186<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 187<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleMissingInstantiator(com.fasterxml.jackson.databind.DeserializationContext,%20java.lang.Class,%20com.fasterxml.jackson.core.JsonParser,%20java.lang.String)">handleMissingInstantiator</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 188 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> instClass, 189 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 190 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> msg)</code> 191<div class="block">Method called when instance creation for a type fails due to lack of an 192 instantiator.</div> 193</td> 194</tr> 195<tr class="altColor"> 196<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 197<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleUnexpectedToken(com.fasterxml.jackson.databind.DeserializationContext,%20java.lang.Class,%20com.fasterxml.jackson.core.JsonToken,%20com.fasterxml.jackson.core.JsonParser,%20java.lang.String)">handleUnexpectedToken</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 198 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> targetType, 199 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonToken.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonToken</a> t, 200 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 201 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg)</code> 202<div class="block">Method that deserializers should call if the first token of the value to 203 deserialize is of unexpected type (that is, type of token that deserializer 204 can not handle).</div> 205</td> 206</tr> 207<tr class="rowColor"> 208<td class="colFirst"><code>boolean</code></td> 209<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleUnknownProperty(com.fasterxml.jackson.databind.DeserializationContext,%20com.fasterxml.jackson.core.JsonParser,%20com.fasterxml.jackson.databind.JsonDeserializer,%20java.lang.Object,%20java.lang.String)">handleUnknownProperty</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 210 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 211 <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> deserializer, 212 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> beanOrClass, 213 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> propertyName)</code> 214<div class="block">Method called when a JSON Object property with an unrecognized 215 name is encountered.</div> 216</td> 217</tr> 218<tr class="altColor"> 219<td class="colFirst"><code><a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a></code></td> 220<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleUnknownTypeId(com.fasterxml.jackson.databind.DeserializationContext,%20com.fasterxml.jackson.databind.JavaType,%20java.lang.String,%20com.fasterxml.jackson.databind.jsontype.TypeIdResolver,%20java.lang.String)">handleUnknownTypeId</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 221 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> baseType, 222 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> subTypeId, 223 <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a> idResolver, 224 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg)</code> 225<div class="block">Handler method called if resolution of type id from given String failed 226 to produce a subtype; usually because logical id is not mapped to actual 227 implementation class.</div> 228</td> 229</tr> 230<tr class="rowColor"> 231<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 232<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdKey(com.fasterxml.jackson.databind.DeserializationContext,%20java.lang.Class,%20java.lang.String,%20java.lang.String)">handleWeirdKey</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 233 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> rawKeyType, 234 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> keyValue, 235 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg)</code> 236<div class="block">Method called when a property name from input can not be converted to a 237 non-Java-String key type (passed as <code>rawKeyType</code>) due to format problem.</div> 238</td> 239</tr> 240<tr class="altColor"> 241<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 242<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdNumberValue(com.fasterxml.jackson.databind.DeserializationContext,%20java.lang.Class,%20java.lang.Number,%20java.lang.String)">handleWeirdNumberValue</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 243 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> targetType, 244 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a> valueToConvert, 245 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg)</code> 246<div class="block">Method called when a numeric value (integral or floating-point from input 247 can not be converted to a non-numeric value type due to specific problem 248 (as opposed to numeric values never being usable).</div> 249</td> 250</tr> 251<tr class="rowColor"> 252<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td> 253<td class="colLast"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdStringValue(com.fasterxml.jackson.databind.DeserializationContext,%20java.lang.Class,%20java.lang.String,%20java.lang.String)">handleWeirdStringValue</a></strong>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 254 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> targetType, 255 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> valueToConvert, 256 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg)</code> 257<div class="block">Method called when a String value 258 can not be converted to a non-String value type due to specific problem 259 (as opposed to String values never being usable).</div> 260</td> 261</tr> 262</table> 263<ul class="blockList"> 264<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> 265<!-- --> 266</a> 267<h3>Methods inherited from class java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3> 268<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long,%20int)" title="class or interface in java.lang">wait</a></code></li> 269</ul> 270</li> 271</ul> 272</li> 273</ul> 274</div> 275<div class="details"> 276<ul class="blockList"> 277<li class="blockList"> 278<!-- ============ FIELD DETAIL =========== --> 279<ul class="blockList"> 280<li class="blockList"><a name="field_detail"> 281<!-- --> 282</a> 283<h3>Field Detail</h3> 284<a name="NOT_HANDLED"> 285<!-- --> 286</a> 287<ul class="blockListLast"> 288<li class="blockList"> 289<h4>NOT_HANDLED</h4> 290<pre>public static final <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> NOT_HANDLED</pre> 291<div class="block">Marker value returned by some handler methods to indicate that 292 they could not handle problem and produce replacement value.</div> 293<dl><dt><span class="strong">Since:</span></dt> 294 <dd>2.7</dd></dl> 295</li> 296</ul> 297</li> 298</ul> 299<!-- ========= CONSTRUCTOR DETAIL ======== --> 300<ul class="blockList"> 301<li class="blockList"><a name="constructor_detail"> 302<!-- --> 303</a> 304<h3>Constructor Detail</h3> 305<a name="DeserializationProblemHandler()"> 306<!-- --> 307</a> 308<ul class="blockListLast"> 309<li class="blockList"> 310<h4>DeserializationProblemHandler</h4> 311<pre>public DeserializationProblemHandler()</pre> 312</li> 313</ul> 314</li> 315</ul> 316<!-- ============ METHOD DETAIL ========== --> 317<ul class="blockList"> 318<li class="blockList"><a name="method_detail"> 319<!-- --> 320</a> 321<h3>Method Detail</h3> 322<a name="handleUnknownProperty(com.fasterxml.jackson.databind.DeserializationContext, com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.JsonDeserializer, java.lang.Object, java.lang.String)"> 323<!-- --> 324</a> 325<ul class="blockList"> 326<li class="blockList"> 327<h4>handleUnknownProperty</h4> 328<pre>public boolean handleUnknownProperty(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 329 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 330 <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> deserializer, 331 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> beanOrClass, 332 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> propertyName) 333 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 334<div class="block">Method called when a JSON Object property with an unrecognized 335 name is encountered. 336 Content (supposedly) matching the property are accessible via 337 parser that can be obtained from passed deserialization context. 338 Handler can also choose to skip the content; if so, it MUST return 339 true to indicate it did handle property successfully. 340 Skipping is usually done like so: 341<pre> 342 parser.skipChildren(); 343</pre> 344<p> 345 Note: <a href="../../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_UNKNOWN_PROPERTIES"><code>DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES</code></a>) 346 takes effect only <b>after</b> handler is called, and only 347 if handler did <b>not</b> handle the problem.</div> 348<dl><dt><span class="strong">Parameters:</span></dt><dd><code>beanOrClass</code> - Either bean instance being deserialized (if one 349 has been instantiated so far); or Class that indicates type that 350 will be instantiated (if no instantiation done yet: for example 351 when bean uses non-default constructors)</dd><dd><code>p</code> - Parser to use for handling problematic content</dd> 352<dt><span class="strong">Returns:</span></dt><dd>True if the problem is resolved (and content available used or skipped); 353 false if the handler did not anything and the problem is unresolved. Note that in 354 latter case caller will either throw an exception or explicitly skip the content, 355 depending on configuration.</dd> 356<dt><span class="strong">Throws:</span></dt> 357<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd></dl> 358</li> 359</ul> 360<a name="handleWeirdKey(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class, java.lang.String, java.lang.String)"> 361<!-- --> 362</a> 363<ul class="blockList"> 364<li class="blockList"> 365<h4>handleWeirdKey</h4> 366<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> handleWeirdKey(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 367 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> rawKeyType, 368 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> keyValue, 369 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg) 370 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 371<div class="block">Method called when a property name from input can not be converted to a 372 non-Java-String key type (passed as <code>rawKeyType</code>) due to format problem. 373 Handler may choose to do one of 3 things: 374<ul> 375 <li>Indicate it does not know what to do by returning <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> 376 </li> 377 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 378 standard exception caller would throw 379 </li> 380 <li>Return actual key value to use as replacement, and continue processing. 381 </li> 382 </ul></div> 383<dl><dt><span class="strong">Parameters:</span></dt><dd><code>failureMsg</code> - Message that will be used by caller (by calling 384 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html#weirdKeyException(java.lang.Class,%20java.lang.String,%20java.lang.String)"><code>DeserializationContext.weirdKeyException(Class, String, String)</code></a>) 385 to indicate type of failure unless handler produces key to use</dd> 386<dt><span class="strong">Returns:</span></dt><dd>Either <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> to indicate that handler does not know 387 what to do (and exception may be thrown), or value to use as key (possibly 388 <code>null</code></dd> 389<dt><span class="strong">Throws:</span></dt> 390<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 391 <dd>2.8</dd></dl> 392</li> 393</ul> 394<a name="handleWeirdStringValue(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class, java.lang.String, java.lang.String)"> 395<!-- --> 396</a> 397<ul class="blockList"> 398<li class="blockList"> 399<h4>handleWeirdStringValue</h4> 400<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> handleWeirdStringValue(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 401 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> targetType, 402 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> valueToConvert, 403 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg) 404 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 405<div class="block">Method called when a String value 406 can not be converted to a non-String value type due to specific problem 407 (as opposed to String values never being usable). 408 Handler may choose to do one of 3 things: 409<ul> 410 <li>Indicate it does not know what to do by returning <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> 411 </li> 412 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 413 standard exception caller would throw 414 </li> 415 <li>Return actual converted value (of type <code>targetType</code>) to use as 416 replacement, and continue processing. 417 </li> 418 </ul></div> 419<dl><dt><span class="strong">Parameters:</span></dt><dd><code>failureMsg</code> - Message that will be used by caller (by calling 420 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html#weirdNumberException(java.lang.Number,%20java.lang.Class,%20java.lang.String)"><code>DeserializationContext.weirdNumberException(java.lang.Number, java.lang.Class<?>, java.lang.String)</code></a>) 421 to indicate type of failure unless handler produces key to use</dd> 422<dt><span class="strong">Returns:</span></dt><dd>Either <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> to indicate that handler does not know 423 what to do (and exception may be thrown), or value to use as key (possibly 424 <code>null</code></dd> 425<dt><span class="strong">Throws:</span></dt> 426<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 427 <dd>2.8</dd></dl> 428</li> 429</ul> 430<a name="handleWeirdNumberValue(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class, java.lang.Number, java.lang.String)"> 431<!-- --> 432</a> 433<ul class="blockList"> 434<li class="blockList"> 435<h4>handleWeirdNumberValue</h4> 436<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> handleWeirdNumberValue(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 437 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> targetType, 438 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a> valueToConvert, 439 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg) 440 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 441<div class="block">Method called when a numeric value (integral or floating-point from input 442 can not be converted to a non-numeric value type due to specific problem 443 (as opposed to numeric values never being usable). 444 Handler may choose to do one of 3 things: 445<ul> 446 <li>Indicate it does not know what to do by returning <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> 447 </li> 448 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 449 standard exception caller would throw 450 </li> 451 <li>Return actual converted value (of type <code>targetType</code>) to use as 452 replacement, and continue processing. 453 </li> 454 </ul></div> 455<dl><dt><span class="strong">Parameters:</span></dt><dd><code>failureMsg</code> - Message that will be used by caller (by calling 456 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html#weirdNumberException(java.lang.Number,%20java.lang.Class,%20java.lang.String)"><code>DeserializationContext.weirdNumberException(java.lang.Number, java.lang.Class<?>, java.lang.String)</code></a>) 457 to indicate type of failure unless handler produces key to use</dd> 458<dt><span class="strong">Returns:</span></dt><dd>Either <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> to indicate that handler does not know 459 what to do (and exception may be thrown), or value to use as key (possibly 460 <code>null</code></dd> 461<dt><span class="strong">Throws:</span></dt> 462<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 463 <dd>2.8</dd></dl> 464</li> 465</ul> 466<a name="handleUnexpectedToken(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class, com.fasterxml.jackson.core.JsonToken, com.fasterxml.jackson.core.JsonParser, java.lang.String)"> 467<!-- --> 468</a> 469<ul class="blockList"> 470<li class="blockList"> 471<h4>handleUnexpectedToken</h4> 472<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> handleUnexpectedToken(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 473 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> targetType, 474 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonToken.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonToken</a> t, 475 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 476 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg) 477 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 478<div class="block">Method that deserializers should call if the first token of the value to 479 deserialize is of unexpected type (that is, type of token that deserializer 480 can not handle). This could occur, for example, if a Number deserializer 481 encounter <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonToken.html?is-external=true#START_ARRAY" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.START_ARRAY</code></a> instead of 482 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonToken.html?is-external=true#VALUE_NUMBER_INT" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.VALUE_NUMBER_INT</code></a> or <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonToken.html?is-external=true#VALUE_NUMBER_FLOAT" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.VALUE_NUMBER_FLOAT</code></a>. 483<ul> 484 <li>Indicate it does not know what to do by returning <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> 485 </li> 486 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 487 standard exception caller would throw 488 </li> 489 <li>Handle content to match (by consuming or skipping it), and return actual 490 instantiated value (of type <code>targetType</code>) to use as replacement; 491 value may be `null` as well as expected target type. 492 </li> 493 </ul></div> 494<dl><dt><span class="strong">Parameters:</span></dt><dd><code>failureMsg</code> - Message that will be used by caller 495 to indicate type of failure unless handler produces value to use</dd> 496<dt><span class="strong">Returns:</span></dt><dd>Either <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> to indicate that handler does not know 497 what to do (and exception may be thrown), or value to use (possibly 498 <code>null</code></dd> 499<dt><span class="strong">Throws:</span></dt> 500<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 501 <dd>2.8</dd></dl> 502</li> 503</ul> 504<a name="handleInstantiationProblem(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class, java.lang.Object, java.lang.Throwable)"> 505<!-- --> 506</a> 507<ul class="blockList"> 508<li class="blockList"> 509<h4>handleInstantiationProblem</h4> 510<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> handleInstantiationProblem(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 511 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> instClass, 512 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> argument, 513 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a> t) 514 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 515<div class="block">Method called when instance creation for a type fails due to an exception. 516 Handler may choose to do one of following things: 517<ul> 518 <li>Indicate it does not know what to do by returning <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> 519 </li> 520 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 521 standard exception caller would throw 522 </li> 523 <li>Return actual instantiated value (of type <code>targetType</code>) to use as 524 replacement, and continue processing. 525 </li> 526 <li>Return <code>null</code> to use null as value but not to try further 527 processing (in cases where properties would otherwise be bound) 528 </li> 529 </ul></div> 530<dl><dt><span class="strong">Parameters:</span></dt><dd><code>instClass</code> - Type that was to be instantiated</dd><dd><code>argument</code> - (optional) Additional argument that was passed to creator, if any</dd><dd><code>t</code> - Exception that caused instantiation failure</dd> 531<dt><span class="strong">Returns:</span></dt><dd>Either <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> to indicate that handler does not know 532 what to do (and exception may be thrown), or value to use (possibly 533 <code>null</code></dd> 534<dt><span class="strong">Throws:</span></dt> 535<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 536 <dd>2.8</dd></dl> 537</li> 538</ul> 539<a name="handleMissingInstantiator(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class, com.fasterxml.jackson.core.JsonParser, java.lang.String)"> 540<!-- --> 541</a> 542<ul class="blockList"> 543<li class="blockList"> 544<h4>handleMissingInstantiator</h4> 545<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> handleMissingInstantiator(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 546 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> instClass, 547 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 548 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> msg) 549 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 550<div class="block">Method called when instance creation for a type fails due to lack of an 551 instantiator. Method is called before actual deserialization from input 552 is attempted, so handler may do one of following things: 553<ul> 554 <li>Indicate it does not know what to do by returning <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> 555 </li> 556 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 557 standard exception caller would throw 558 </li> 559 <li>Handle content to match (by consuming or skipping it), and return actual 560 instantiated value (of type <code>targetType</code>) to use as replacement; 561 value may be `null` as well as expected target type. 562 </li> 563 </ul></div> 564<dl><dt><span class="strong">Parameters:</span></dt><dd><code>instClass</code> - Type that was to be instantiated</dd><dd><code>p</code> - Parser to use for accessing content that needs handling, to either 565 use it or skip it (latter with <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonParser.html?is-external=true#skipChildren()" title="class or interface in com.fasterxml.jackson.core"><code>JsonParser.skipChildren()</code></a>.</dd> 566<dt><span class="strong">Returns:</span></dt><dd>Either <a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED"><code>NOT_HANDLED</code></a> to indicate that handler does not know 567 what to do (and exception may be thrown), or value to use (possibly 568 <code>null</code></dd> 569<dt><span class="strong">Throws:</span></dt> 570<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 571 <dd>2.8</dd></dl> 572</li> 573</ul> 574<a name="handleUnknownTypeId(com.fasterxml.jackson.databind.DeserializationContext, com.fasterxml.jackson.databind.JavaType, java.lang.String, com.fasterxml.jackson.databind.jsontype.TypeIdResolver, java.lang.String)"> 575<!-- --> 576</a> 577<ul class="blockListLast"> 578<li class="blockList"> 579<h4>handleUnknownTypeId</h4> 580<pre>public <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> handleUnknownTypeId(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 581 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> baseType, 582 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> subTypeId, 583 <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a> idResolver, 584 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> failureMsg) 585 throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre> 586<div class="block">Handler method called if resolution of type id from given String failed 587 to produce a subtype; usually because logical id is not mapped to actual 588 implementation class. 589 Handler may choose to do one of following things: 590<ul> 591 <li>Indicate it does not know what to do by returning `null` 592 </li> 593 <li>Indicate that nothing should be deserialized, by return `Void.class` 594 </li> 595 <li>Throw a <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a> to indicate specific fail message (instead of 596 standard exception caller would throw 597 </li> 598 <li>Return actual resolved type to use for type id. 599 </li> 600 </ul></div> 601<dl><dt><span class="strong">Parameters:</span></dt><dd><code>ctxt</code> - Deserialization context to use for accessing information or 602 constructing exception to throw</dd><dd><code>baseType</code> - Base type to use for resolving subtype id</dd><dd><code>subTypeId</code> - Subtype id that failed to resolve</dd><dd><code>failureMsg</code> - Informational message that would be thrown as part of 603 exception, if resolution still fails</dd> 604<dt><span class="strong">Returns:</span></dt><dd>Actual type to use, if resolved; `null` if handler does not know what 605 to do; or `Void.class` to indicate that nothing should be deserialized for 606 type with the id (which caller may choose to do... or not)</dd> 607<dt><span class="strong">Throws:</span></dt> 608<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd><dt><span class="strong">Since:</span></dt> 609 <dd>2.8</dd></dl> 610</li> 611</ul> 612</li> 613</ul> 614</li> 615</ul> 616</div> 617</div> 618<!-- ========= END OF CLASS DATA ========= --> 619<!-- ======= START OF BOTTOM NAVBAR ====== --> 620<div class="bottomNav"><a name="navbar_bottom"> 621<!-- --> 622</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> 623<!-- --> 624</a> 625<ul class="navList" title="Navigation"> 626<li><a href="../../../../../overview-summary.html">Overview</a></li> 627<li><a href="package-summary.html">Package</a></li> 628<li class="navBarCell1Rev">Class</li> 629<li><a href="class-use/DeserializationProblemHandler.html">Use</a></li> 630<li><a href="package-tree.html">Tree</a></li> 631<li><a href="../../../../../deprecated-list.html">Deprecated</a></li> 632<li><a href="../../../../../index-all.html">Index</a></li> 633<li><a href="../../../../../help-doc.html">Help</a></li> 634</ul> 635</div> 636<div class="subNav"> 637<ul class="navList"> 638<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DefaultDeserializationContext.Impl.html" title="class in com.fasterxml.jackson.databind.deser"><span class="strong">Prev Class</span></a></li> 639<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializerCache.html" title="class in com.fasterxml.jackson.databind.deser"><span class="strong">Next Class</span></a></li> 640</ul> 641<ul class="navList"> 642<li><a href="../../../../../index.html?com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html" target="_top">Frames</a></li> 643<li><a href="DeserializationProblemHandler.html" target="_top">No Frames</a></li> 644</ul> 645<ul class="navList" id="allclasses_navbar_bottom"> 646<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> 647</ul> 648<div> 649<script type="text/javascript"><!-- 650 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 651 if(window==top) { 652 allClassesLink.style.display = "block"; 653 } 654 else { 655 allClassesLink.style.display = "none"; 656 } 657 //--> 658</script> 659</div> 660<div> 661<ul class="subNavList"> 662<li>Summary: </li> 663<li>Nested | </li> 664<li><a href="#field_summary">Field</a> | </li> 665<li><a href="#constructor_summary">Constr</a> | </li> 666<li><a href="#method_summary">Method</a></li> 667</ul> 668<ul class="subNavList"> 669<li>Detail: </li> 670<li><a href="#field_detail">Field</a> | </li> 671<li><a href="#constructor_detail">Constr</a> | </li> 672<li><a href="#method_detail">Method</a></li> 673</ul> 674</div> 675<a name="skip-navbar_bottom"> 676<!-- --> 677</a></div> 678<!-- ======== END OF BOTTOM NAVBAR ======= --> 679<p class="legalCopy"><small>Copyright © 2008–2016 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 680</body> 681</html> 682