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 (1.8.0_162) on Tue Jan 23 20:22:13 PST 2018 --> 6<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<title>DeserializationProblemHandler (jackson-databind 2.9.0 API)</title> 8<meta name="date" content="2018-01-23"> 9<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> 10<script type="text/javascript" src="../../../../../script.js"></script> 11</head> 12<body> 13<script type="text/javascript"><!-- 14 try { 15 if (location.href.indexOf('is-external=true') == -1) { 16 parent.document.title="DeserializationProblemHandler (jackson-databind 2.9.0 API)"; 17 } 18 } 19 catch(err) { 20 } 21//--> 22var methods = {"i0":10,"i1":42,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10}; 23var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]}; 24var altColor = "altColor"; 25var rowColor = "rowColor"; 26var tableTab = "tableTab"; 27var activeTableTab = "activeTableTab"; 28</script> 29<noscript> 30<div>JavaScript is disabled on your browser.</div> 31</noscript> 32<!-- ========= START OF TOP NAVBAR ======= --> 33<div class="topNav"><a name="navbar.top"> 34<!-- --> 35</a> 36<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div> 37<a name="navbar.top.firstrow"> 38<!-- --> 39</a> 40<ul class="navList" title="Navigation"> 41<li><a href="../../../../../overview-summary.html">Overview</a></li> 42<li><a href="package-summary.html">Package</a></li> 43<li class="navBarCell1Rev">Class</li> 44<li><a href="class-use/DeserializationProblemHandler.html">Use</a></li> 45<li><a href="package-tree.html">Tree</a></li> 46<li><a href="../../../../../deprecated-list.html">Deprecated</a></li> 47<li><a href="../../../../../index-all.html">Index</a></li> 48<li><a href="../../../../../help-doc.html">Help</a></li> 49</ul> 50</div> 51<div class="subNav"> 52<ul class="navList"> 53<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DefaultDeserializationContext.Impl.html" title="class in com.fasterxml.jackson.databind.deser"><span class="typeNameLink">Prev Class</span></a></li> 54<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializerCache.html" title="class in com.fasterxml.jackson.databind.deser"><span class="typeNameLink">Next Class</span></a></li> 55</ul> 56<ul class="navList"> 57<li><a href="../../../../../index.html?com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html" target="_top">Frames</a></li> 58<li><a href="DeserializationProblemHandler.html" target="_top">No Frames</a></li> 59</ul> 60<ul class="navList" id="allclasses_navbar_top"> 61<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> 62</ul> 63<div> 64<script type="text/javascript"><!-- 65 allClassesLink = document.getElementById("allclasses_navbar_top"); 66 if(window==top) { 67 allClassesLink.style.display = "block"; 68 } 69 else { 70 allClassesLink.style.display = "none"; 71 } 72 //--> 73</script> 74</div> 75<div> 76<ul class="subNavList"> 77<li>Summary: </li> 78<li>Nested | </li> 79<li><a href="#field.summary">Field</a> | </li> 80<li><a href="#constructor.summary">Constr</a> | </li> 81<li><a href="#method.summary">Method</a></li> 82</ul> 83<ul class="subNavList"> 84<li>Detail: </li> 85<li><a href="#field.detail">Field</a> | </li> 86<li><a href="#constructor.detail">Constr</a> | </li> 87<li><a href="#method.detail">Method</a></li> 88</ul> 89</div> 90<a name="skip.navbar.top"> 91<!-- --> 92</a></div> 93<!-- ========= END OF TOP NAVBAR ========= --> 94<!-- ======== START OF CLASS DATA ======== --> 95<div class="header"> 96<div class="subTitle">com.fasterxml.jackson.databind.deser</div> 97<h2 title="Class DeserializationProblemHandler" class="title">Class DeserializationProblemHandler</h2> 98</div> 99<div class="contentContainer"> 100<ul class="inheritance"> 101<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> 102<li> 103<ul class="inheritance"> 104<li>com.fasterxml.jackson.databind.deser.DeserializationProblemHandler</li> 105</ul> 106</li> 107</ul> 108<div class="description"> 109<ul class="blockList"> 110<li class="blockList"> 111<hr> 112<br> 113<pre>public abstract class <span class="typeNameLabel">DeserializationProblemHandler</span> 114extends <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> 115<div class="block">This is the class that can be registered (via 116 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind"><code>DeserializationConfig</code></a> object owner by 117 <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 118 recoverable problem is encountered during deserialization 119 process. Handlers can try to resolve the problem, throw 120 an exception or just skip the content. 121<p> 122 Default implementations for all methods implemented minimal 123 "do nothing" functionality, which is roughly equivalent to 124 not having a registered listener at all. This allows for 125 only implemented handler methods one is interested in, without 126 handling other cases. 127<p> 128 NOTE: it is typically <b>NOT</b> acceptable to simply do nothing, 129 because this will result in unprocessed tokens being left in 130 token stream (read via <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/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 131 (JSON Object or JSON Array) value is being pointed to by parser.</div> 132</li> 133</ul> 134</div> 135<div class="summary"> 136<ul class="blockList"> 137<li class="blockList"> 138<!-- =========== FIELD SUMMARY =========== --> 139<ul class="blockList"> 140<li class="blockList"><a name="field.summary"> 141<!-- --> 142</a> 143<h3>Field Summary</h3> 144<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation"> 145<caption><span>Fields</span><span class="tabEnd"> </span></caption> 146<tr> 147<th class="colFirst" scope="col">Modifier and Type</th> 148<th class="colLast" scope="col">Field and Description</th> 149</tr> 150<tr class="altColor"> 151<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> 152<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#NOT_HANDLED">NOT_HANDLED</a></span></code> 153<div class="block">Marker value returned by some handler methods to indicate that 154 they could not handle problem and produce replacement value.</div> 155</td> 156</tr> 157</table> 158</li> 159</ul> 160<!-- ======== CONSTRUCTOR SUMMARY ======== --> 161<ul class="blockList"> 162<li class="blockList"><a name="constructor.summary"> 163<!-- --> 164</a> 165<h3>Constructor Summary</h3> 166<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> 167<caption><span>Constructors</span><span class="tabEnd"> </span></caption> 168<tr> 169<th class="colOne" scope="col">Constructor and Description</th> 170</tr> 171<tr class="altColor"> 172<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#DeserializationProblemHandler--">DeserializationProblemHandler</a></span>()</code> </td> 173</tr> 174</table> 175</li> 176</ul> 177<!-- ========== METHOD SUMMARY =========== --> 178<ul class="blockList"> 179<li class="blockList"><a name="method.summary"> 180<!-- --> 181</a> 182<h3>Method Summary</h3> 183<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 184<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span><span id="t6" class="tableTab"><span><a href="javascript:show(32);">Deprecated Methods</a></span><span class="tabEnd"> </span></span></caption> 185<tr> 186<th class="colFirst" scope="col">Modifier and Type</th> 187<th class="colLast" scope="col">Method and Description</th> 188</tr> 189<tr id="i0" class="altColor"> 190<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> 191<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleInstantiationProblem-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.Object-java.lang.Throwable-">handleInstantiationProblem</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 192 <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, 193 <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, 194 <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> 195<div class="block">Method called when instance creation for a type fails due to an exception.</div> 196</td> 197</tr> 198<tr id="i1" class="rowColor"> 199<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> 200<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleMissingInstantiator-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-com.fasterxml.jackson.core.JsonParser-java.lang.String-">handleMissingInstantiator</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 201 <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, 202 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 203 <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> 204<div class="block"><span class="deprecatedLabel">Deprecated.</span> 205<div class="block"><span class="deprecationComment">Since 2.9: use variant that takes <a href="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiator.html" title="class in com.fasterxml.jackson.databind.deser"><code>ValueInstantiator</code></a></span></div> 206</div> 207</td> 208</tr> 209<tr id="i2" class="altColor"> 210<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> 211<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleMissingInstantiator-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-com.fasterxml.jackson.databind.deser.ValueInstantiator-com.fasterxml.jackson.core.JsonParser-java.lang.String-">handleMissingInstantiator</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 212 <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, 213 <a href="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiator.html" title="class in com.fasterxml.jackson.databind.deser">ValueInstantiator</a> valueInsta, 214 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 215 <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> 216<div class="block">Method called when instance creation for a type fails due to lack of an 217 instantiator.</div> 218</td> 219</tr> 220<tr id="i3" class="rowColor"> 221<td class="colFirst"><code><a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a></code></td> 222<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleMissingTypeId-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.JavaType-com.fasterxml.jackson.databind.jsontype.TypeIdResolver-java.lang.String-">handleMissingTypeId</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 223 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> baseType, 224 <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a> idResolver, 225 <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> 226<div class="block">Handler method called if an expected type id for a polymorphic value is 227 not found and no "default type" is specified or allowed.</div> 228</td> 229</tr> 230<tr id="i4" class="altColor"> 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><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleUnexpectedToken-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-com.fasterxml.jackson.core.JsonToken-com.fasterxml.jackson.core.JsonParser-java.lang.String-">handleUnexpectedToken</a></span>(<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><?> targetType, 234 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonToken.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonToken</a> t, 235 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 236 <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> 237<div class="block">Method that deserializers should call if the first token of the value to 238 deserialize is of unexpected type (that is, type of token that deserializer 239 cannot handle).</div> 240</td> 241</tr> 242<tr id="i5" class="rowColor"> 243<td class="colFirst"><code>boolean</code></td> 244<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleUnknownProperty-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.JsonDeserializer-java.lang.Object-java.lang.String-">handleUnknownProperty</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 245 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 246 <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> deserializer, 247 <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, 248 <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> 249<div class="block">Method called when a JSON Object property with an unrecognized 250 name is encountered.</div> 251</td> 252</tr> 253<tr id="i6" class="altColor"> 254<td class="colFirst"><code><a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a></code></td> 255<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleUnknownTypeId-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.JavaType-java.lang.String-com.fasterxml.jackson.databind.jsontype.TypeIdResolver-java.lang.String-">handleUnknownTypeId</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 256 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> baseType, 257 <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, 258 <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a> idResolver, 259 <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> 260<div class="block">Handler method called if resolution of type id from given String failed 261 to produce a subtype; usually because logical id is not mapped to actual 262 implementation class.</div> 263</td> 264</tr> 265<tr id="i7" class="rowColor"> 266<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> 267<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdKey-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.String-java.lang.String-">handleWeirdKey</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 268 <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, 269 <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, 270 <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> 271<div class="block">Method called when a property name from input cannot be converted to a 272 non-Java-String key type (passed as <code>rawKeyType</code>) due to format problem.</div> 273</td> 274</tr> 275<tr id="i8" class="altColor"> 276<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> 277<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdNativeValue-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.JavaType-java.lang.Object-com.fasterxml.jackson.core.JsonParser-">handleWeirdNativeValue</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 278 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> targetType, 279 <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> valueToConvert, 280 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p)</code> 281<div class="block">Method called when an embedded (native) value (<a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonToken.html?is-external=true#VALUE_EMBEDDED_OBJECT" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.VALUE_EMBEDDED_OBJECT</code></a>) 282 cannot be converted directly into expected value type (usually POJO).</div> 283</td> 284</tr> 285<tr id="i9" class="rowColor"> 286<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> 287<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdNumberValue-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.Number-java.lang.String-">handleWeirdNumberValue</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 288 <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, 289 <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, 290 <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> 291<div class="block">Method called when a numeric value (integral or floating-point from input 292 cannot be converted to a non-numeric value type due to specific problem 293 (as opposed to numeric values never being usable).</div> 294</td> 295</tr> 296<tr id="i10" class="altColor"> 297<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> 298<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#handleWeirdStringValue-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.String-java.lang.String-">handleWeirdStringValue</a></span>(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 299 <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, 300 <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, 301 <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> 302<div class="block">Method called when a String value 303 cannot be converted to a non-String value type due to specific problem 304 (as opposed to String values never being usable).</div> 305</td> 306</tr> 307</table> 308<ul class="blockList"> 309<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object"> 310<!-- --> 311</a> 312<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> 313<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-int-" title="class or interface in java.lang">wait</a></code></li> 314</ul> 315</li> 316</ul> 317</li> 318</ul> 319</div> 320<div class="details"> 321<ul class="blockList"> 322<li class="blockList"> 323<!-- ============ FIELD DETAIL =========== --> 324<ul class="blockList"> 325<li class="blockList"><a name="field.detail"> 326<!-- --> 327</a> 328<h3>Field Detail</h3> 329<a name="NOT_HANDLED"> 330<!-- --> 331</a> 332<ul class="blockListLast"> 333<li class="blockList"> 334<h4>NOT_HANDLED</h4> 335<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> 336<div class="block">Marker value returned by some handler methods to indicate that 337 they could not handle problem and produce replacement value.</div> 338<dl> 339<dt><span class="simpleTagLabel">Since:</span></dt> 340<dd>2.7</dd> 341</dl> 342</li> 343</ul> 344</li> 345</ul> 346<!-- ========= CONSTRUCTOR DETAIL ======== --> 347<ul class="blockList"> 348<li class="blockList"><a name="constructor.detail"> 349<!-- --> 350</a> 351<h3>Constructor Detail</h3> 352<a name="DeserializationProblemHandler--"> 353<!-- --> 354</a> 355<ul class="blockListLast"> 356<li class="blockList"> 357<h4>DeserializationProblemHandler</h4> 358<pre>public DeserializationProblemHandler()</pre> 359</li> 360</ul> 361</li> 362</ul> 363<!-- ============ METHOD DETAIL ========== --> 364<ul class="blockList"> 365<li class="blockList"><a name="method.detail"> 366<!-- --> 367</a> 368<h3>Method Detail</h3> 369<a name="handleUnknownProperty-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.JsonDeserializer-java.lang.Object-java.lang.String-"> 370<!-- --> 371</a> 372<ul class="blockList"> 373<li class="blockList"> 374<h4>handleUnknownProperty</h4> 375<pre>public boolean handleUnknownProperty(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 376 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 377 <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> deserializer, 378 <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, 379 <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) 380 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> 381<div class="block">Method called when a JSON Object property with an unrecognized 382 name is encountered. 383 Content (supposedly) matching the property are accessible via 384 parser that can be obtained from passed deserialization context. 385 Handler can also choose to skip the content; if so, it MUST return 386 true to indicate it did handle property successfully. 387 Skipping is usually done like so: 388<pre> 389 parser.skipChildren(); 390</pre> 391<p> 392 Note: <a href="../../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_UNKNOWN_PROPERTIES"><code>DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES</code></a>) 393 takes effect only <b>after</b> handler is called, and only 394 if handler did <b>not</b> handle the problem.</div> 395<dl> 396<dt><span class="paramLabel">Parameters:</span></dt> 397<dd><code>beanOrClass</code> - Either bean instance being deserialized (if one 398 has been instantiated so far); or Class that indicates type that 399 will be instantiated (if no instantiation done yet: for example 400 when bean uses non-default constructors)</dd> 401<dd><code>p</code> - Parser to use for handling problematic content</dd> 402<dt><span class="returnLabel">Returns:</span></dt> 403<dd>True if the problem is resolved (and content available used or skipped); 404 false if the handler did not anything and the problem is unresolved. Note that in 405 latter case caller will either throw an exception or explicitly skip the content, 406 depending on configuration.</dd> 407<dt><span class="throwsLabel">Throws:</span></dt> 408<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> 409</dl> 410</li> 411</ul> 412<a name="handleWeirdKey-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.String-java.lang.String-"> 413<!-- --> 414</a> 415<ul class="blockList"> 416<li class="blockList"> 417<h4>handleWeirdKey</h4> 418<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, 419 <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, 420 <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, 421 <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) 422 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> 423<div class="block">Method called when a property name from input cannot be converted to a 424 non-Java-String key type (passed as <code>rawKeyType</code>) due to format problem. 425 Handler may choose to do one of 3 things: 426<ul> 427 <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> 428 </li> 429 <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 430 standard exception caller would throw 431 </li> 432 <li>Return actual key value to use as replacement, and continue processing. 433 </li> 434 </ul></div> 435<dl> 436<dt><span class="paramLabel">Parameters:</span></dt> 437<dd><code>failureMsg</code> - Message that will be used by caller (by calling 438 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html#weirdKeyException-java.lang.Class-java.lang.String-java.lang.String-"><code>DeserializationContext.weirdKeyException(Class, String, String)</code></a>) 439 to indicate type of failure unless handler produces key to use</dd> 440<dt><span class="returnLabel">Returns:</span></dt> 441<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 442 what to do (and exception may be thrown), or value to use as key (possibly 443 <code>null</code></dd> 444<dt><span class="throwsLabel">Throws:</span></dt> 445<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> 446<dt><span class="simpleTagLabel">Since:</span></dt> 447<dd>2.8</dd> 448</dl> 449</li> 450</ul> 451<a name="handleWeirdStringValue-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.String-java.lang.String-"> 452<!-- --> 453</a> 454<ul class="blockList"> 455<li class="blockList"> 456<h4>handleWeirdStringValue</h4> 457<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, 458 <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, 459 <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, 460 <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) 461 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> 462<div class="block">Method called when a String value 463 cannot be converted to a non-String value type due to specific problem 464 (as opposed to String values never being usable). 465 Handler may choose to do one of 3 things: 466<ul> 467 <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> 468 </li> 469 <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 470 standard exception caller would throw 471 </li> 472 <li>Return actual converted value (of type <code>targetType</code>) to use as 473 replacement, and continue processing. 474 </li> 475 </ul></div> 476<dl> 477<dt><span class="paramLabel">Parameters:</span></dt> 478<dd><code>failureMsg</code> - Message that will be used by caller (by calling 479 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html#weirdNumberException-java.lang.Number-java.lang.Class-java.lang.String-"><code>DeserializationContext.weirdNumberException(java.lang.Number, java.lang.Class<?>, java.lang.String)</code></a>) 480 to indicate type of failure unless handler produces key to use</dd> 481<dt><span class="returnLabel">Returns:</span></dt> 482<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 483 what to do (and exception may be thrown), or value to use as (possibly 484 <code>null</code>)</dd> 485<dt><span class="throwsLabel">Throws:</span></dt> 486<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> 487<dt><span class="simpleTagLabel">Since:</span></dt> 488<dd>2.8</dd> 489</dl> 490</li> 491</ul> 492<a name="handleWeirdNumberValue-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.Number-java.lang.String-"> 493<!-- --> 494</a> 495<ul class="blockList"> 496<li class="blockList"> 497<h4>handleWeirdNumberValue</h4> 498<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, 499 <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, 500 <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, 501 <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) 502 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> 503<div class="block">Method called when a numeric value (integral or floating-point from input 504 cannot be converted to a non-numeric value type due to specific problem 505 (as opposed to numeric values never being usable). 506 Handler may choose to do one of 3 things: 507<ul> 508 <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> 509 </li> 510 <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 511 standard exception caller would throw 512 </li> 513 <li>Return actual converted value (of type <code>targetType</code>) to use as 514 replacement, and continue processing. 515 </li> 516 </ul></div> 517<dl> 518<dt><span class="paramLabel">Parameters:</span></dt> 519<dd><code>failureMsg</code> - Message that will be used by caller (by calling 520 <a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html#weirdNumberException-java.lang.Number-java.lang.Class-java.lang.String-"><code>DeserializationContext.weirdNumberException(java.lang.Number, java.lang.Class<?>, java.lang.String)</code></a>) 521 to indicate type of failure unless handler produces key to use</dd> 522<dt><span class="returnLabel">Returns:</span></dt> 523<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 524 what to do (and exception may be thrown), or value to use as (possibly 525 <code>null</code>)</dd> 526<dt><span class="throwsLabel">Throws:</span></dt> 527<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> 528<dt><span class="simpleTagLabel">Since:</span></dt> 529<dd>2.8</dd> 530</dl> 531</li> 532</ul> 533<a name="handleWeirdNativeValue-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.JavaType-java.lang.Object-com.fasterxml.jackson.core.JsonParser-"> 534<!-- --> 535</a> 536<ul class="blockList"> 537<li class="blockList"> 538<h4>handleWeirdNativeValue</h4> 539<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> handleWeirdNativeValue(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 540 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> targetType, 541 <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> valueToConvert, 542 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p) 543 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> 544<div class="block">Method called when an embedded (native) value (<a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonToken.html?is-external=true#VALUE_EMBEDDED_OBJECT" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.VALUE_EMBEDDED_OBJECT</code></a>) 545 cannot be converted directly into expected value type (usually POJO). 546 Handler may choose to do one of 3 things: 547<ul> 548 <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> 549 </li> 550 <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 551 standard exception caller would throw 552 </li> 553 <li>Return actual converted value (of type <code>targetType</code>) to use as 554 replacement, and continue processing. 555 </li> 556 </ul></div> 557<dl> 558<dt><span class="returnLabel">Returns:</span></dt> 559<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 560 what to do (and exception may be thrown), or value to use (possibly 561 <code>null</code>)</dd> 562<dt><span class="throwsLabel">Throws:</span></dt> 563<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> 564<dt><span class="simpleTagLabel">Since:</span></dt> 565<dd>2.9</dd> 566</dl> 567</li> 568</ul> 569<a name="handleUnexpectedToken-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-com.fasterxml.jackson.core.JsonToken-com.fasterxml.jackson.core.JsonParser-java.lang.String-"> 570<!-- --> 571</a> 572<ul class="blockList"> 573<li class="blockList"> 574<h4>handleUnexpectedToken</h4> 575<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, 576 <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, 577 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonToken.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonToken</a> t, 578 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 579 <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) 580 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> 581<div class="block">Method that deserializers should call if the first token of the value to 582 deserialize is of unexpected type (that is, type of token that deserializer 583 cannot handle). This could occur, for example, if a Number deserializer 584 encounter <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/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 585 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/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.9/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>. 586<ul> 587 <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> 588 </li> 589 <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 590 standard exception caller would throw 591 </li> 592 <li>Handle content to match (by consuming or skipping it), and return actual 593 instantiated value (of type <code>targetType</code>) to use as replacement; 594 value may be `null` as well as expected target type. 595 </li> 596 </ul></div> 597<dl> 598<dt><span class="paramLabel">Parameters:</span></dt> 599<dd><code>failureMsg</code> - Message that will be used by caller 600 to indicate type of failure unless handler produces value to use</dd> 601<dt><span class="returnLabel">Returns:</span></dt> 602<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 603 what to do (and exception may be thrown), or value to use (possibly 604 <code>null</code></dd> 605<dt><span class="throwsLabel">Throws:</span></dt> 606<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> 607<dt><span class="simpleTagLabel">Since:</span></dt> 608<dd>2.8</dd> 609</dl> 610</li> 611</ul> 612<a name="handleInstantiationProblem-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-java.lang.Object-java.lang.Throwable-"> 613<!-- --> 614</a> 615<ul class="blockList"> 616<li class="blockList"> 617<h4>handleInstantiationProblem</h4> 618<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, 619 <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, 620 <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, 621 <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) 622 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> 623<div class="block">Method called when instance creation for a type fails due to an exception. 624 Handler may choose to do one of following things: 625<ul> 626 <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> 627 </li> 628 <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 629 standard exception caller would throw 630 </li> 631 <li>Return actual instantiated value (of type <code>targetType</code>) to use as 632 replacement, and continue processing. 633 </li> 634 <li>Return <code>null</code> to use null as value but not to try further 635 processing (in cases where properties would otherwise be bound) 636 </li> 637 </ul></div> 638<dl> 639<dt><span class="paramLabel">Parameters:</span></dt> 640<dd><code>instClass</code> - Type that was to be instantiated</dd> 641<dd><code>argument</code> - (optional) Additional argument that was passed to creator, if any</dd> 642<dd><code>t</code> - Exception that caused instantiation failure</dd> 643<dt><span class="returnLabel">Returns:</span></dt> 644<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 645 what to do (and exception may be thrown), or value to use (possibly 646 <code>null</code></dd> 647<dt><span class="throwsLabel">Throws:</span></dt> 648<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> 649<dt><span class="simpleTagLabel">Since:</span></dt> 650<dd>2.8</dd> 651</dl> 652</li> 653</ul> 654<a name="handleMissingInstantiator-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-com.fasterxml.jackson.databind.deser.ValueInstantiator-com.fasterxml.jackson.core.JsonParser-java.lang.String-"> 655<!-- --> 656</a> 657<ul class="blockList"> 658<li class="blockList"> 659<h4>handleMissingInstantiator</h4> 660<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, 661 <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, 662 <a href="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiator.html" title="class in com.fasterxml.jackson.databind.deser">ValueInstantiator</a> valueInsta, 663 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 664 <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) 665 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> 666<div class="block">Method called when instance creation for a type fails due to lack of an 667 instantiator. Method is called before actual deserialization from input 668 is attempted, so handler may do one of following things: 669<ul> 670 <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> 671 </li> 672 <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 673 standard exception caller would throw 674 </li> 675 <li>Handle content to match (by consuming or skipping it), and return actual 676 instantiated value (of type <code>targetType</code>) to use as replacement; 677 value may be `null` as well as expected target type. 678 </li> 679 </ul></div> 680<dl> 681<dt><span class="paramLabel">Parameters:</span></dt> 682<dd><code>instClass</code> - Type that was to be instantiated</dd> 683<dd><code>p</code> - Parser to use for accessing content that needs handling, to either 684 use it or skip it (latter with <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/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> 685<dt><span class="returnLabel">Returns:</span></dt> 686<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 687 what to do (and exception may be thrown), or value to use (possibly 688 <code>null</code></dd> 689<dt><span class="throwsLabel">Throws:</span></dt> 690<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> 691<dt><span class="simpleTagLabel">Since:</span></dt> 692<dd>2.9</dd> 693</dl> 694</li> 695</ul> 696<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-"> 697<!-- --> 698</a> 699<ul class="blockList"> 700<li class="blockList"> 701<h4>handleUnknownTypeId</h4> 702<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, 703 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> baseType, 704 <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, 705 <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a> idResolver, 706 <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) 707 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> 708<div class="block">Handler method called if resolution of type id from given String failed 709 to produce a subtype; usually because logical id is not mapped to actual 710 implementation class. 711 Handler may choose to do one of following things: 712<ul> 713 <li>Indicate it does not know what to do by returning `null` 714 </li> 715 <li>Indicate that nothing should be deserialized, by return `Void.class` 716 </li> 717 <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 718 standard exception caller would throw 719 </li> 720 <li>Return actual resolved type to use for type id. 721 </li> 722 </ul></div> 723<dl> 724<dt><span class="paramLabel">Parameters:</span></dt> 725<dd><code>ctxt</code> - Deserialization context to use for accessing information or 726 constructing exception to throw</dd> 727<dd><code>baseType</code> - Base type to use for resolving subtype id</dd> 728<dd><code>subTypeId</code> - Subtype id that failed to resolve</dd> 729<dd><code>failureMsg</code> - Informational message that would be thrown as part of 730 exception, if resolution still fails</dd> 731<dt><span class="returnLabel">Returns:</span></dt> 732<dd>Actual type to use, if resolved; `null` if handler does not know what 733 to do; or `Void.class` to indicate that nothing should be deserialized for 734 type with the id (which caller may choose to do... or not)</dd> 735<dt><span class="throwsLabel">Throws:</span></dt> 736<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> 737<dt><span class="simpleTagLabel">Since:</span></dt> 738<dd>2.8</dd> 739</dl> 740</li> 741</ul> 742<a name="handleMissingTypeId-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.JavaType-com.fasterxml.jackson.databind.jsontype.TypeIdResolver-java.lang.String-"> 743<!-- --> 744</a> 745<ul class="blockList"> 746<li class="blockList"> 747<h4>handleMissingTypeId</h4> 748<pre>public <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> handleMissingTypeId(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 749 <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a> baseType, 750 <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a> idResolver, 751 <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) 752 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> 753<div class="block">Handler method called if an expected type id for a polymorphic value is 754 not found and no "default type" is specified or allowed. 755 Handler may choose to do one of following things: 756<ul> 757 <li>Indicate it does not know what to do by returning `null` 758 </li> 759 <li>Indicate that nothing should be deserialized, by return `Void.class` 760 </li> 761 <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 762 standard exception caller would throw 763 </li> 764 <li>Return actual resolved type to use for this particular case. 765 </li> 766 </ul></div> 767<dl> 768<dt><span class="paramLabel">Parameters:</span></dt> 769<dd><code>ctxt</code> - Deserialization context to use for accessing information or 770 constructing exception to throw</dd> 771<dd><code>baseType</code> - Base type to use for resolving subtype id</dd> 772<dd><code>failureMsg</code> - Informational message that would be thrown as part of 773 exception, if resolution still fails</dd> 774<dt><span class="returnLabel">Returns:</span></dt> 775<dd>Actual type to use, if resolved; `null` if handler does not know what 776 to do; or `Void.class` to indicate that nothing should be deserialized for 777 type with the id (which caller may choose to do... or not)</dd> 778<dt><span class="throwsLabel">Throws:</span></dt> 779<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> 780<dt><span class="simpleTagLabel">Since:</span></dt> 781<dd>2.9</dd> 782</dl> 783</li> 784</ul> 785<a name="handleMissingInstantiator-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Class-com.fasterxml.jackson.core.JsonParser-java.lang.String-"> 786<!-- --> 787</a> 788<ul class="blockListLast"> 789<li class="blockList"> 790<h4>handleMissingInstantiator</h4> 791<pre><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Deprecated.html?is-external=true" title="class or interface in java.lang">@Deprecated</a> 792public <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, 793 <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, 794 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonParser.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonParser</a> p, 795 <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) 796 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> 797<div class="block"><span class="deprecatedLabel">Deprecated.</span> <span class="deprecationComment">Since 2.9: use variant that takes <a href="../../../../../com/fasterxml/jackson/databind/deser/ValueInstantiator.html" title="class in com.fasterxml.jackson.databind.deser"><code>ValueInstantiator</code></a></span></div> 798<dl> 799<dt><span class="throwsLabel">Throws:</span></dt> 800<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> 801<dt><span class="simpleTagLabel">Since:</span></dt> 802<dd>2.8</dd> 803</dl> 804</li> 805</ul> 806</li> 807</ul> 808</li> 809</ul> 810</div> 811</div> 812<!-- ========= END OF CLASS DATA ========= --> 813<!-- ======= START OF BOTTOM NAVBAR ====== --> 814<div class="bottomNav"><a name="navbar.bottom"> 815<!-- --> 816</a> 817<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> 818<a name="navbar.bottom.firstrow"> 819<!-- --> 820</a> 821<ul class="navList" title="Navigation"> 822<li><a href="../../../../../overview-summary.html">Overview</a></li> 823<li><a href="package-summary.html">Package</a></li> 824<li class="navBarCell1Rev">Class</li> 825<li><a href="class-use/DeserializationProblemHandler.html">Use</a></li> 826<li><a href="package-tree.html">Tree</a></li> 827<li><a href="../../../../../deprecated-list.html">Deprecated</a></li> 828<li><a href="../../../../../index-all.html">Index</a></li> 829<li><a href="../../../../../help-doc.html">Help</a></li> 830</ul> 831</div> 832<div class="subNav"> 833<ul class="navList"> 834<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DefaultDeserializationContext.Impl.html" title="class in com.fasterxml.jackson.databind.deser"><span class="typeNameLink">Prev Class</span></a></li> 835<li><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializerCache.html" title="class in com.fasterxml.jackson.databind.deser"><span class="typeNameLink">Next Class</span></a></li> 836</ul> 837<ul class="navList"> 838<li><a href="../../../../../index.html?com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html" target="_top">Frames</a></li> 839<li><a href="DeserializationProblemHandler.html" target="_top">No Frames</a></li> 840</ul> 841<ul class="navList" id="allclasses_navbar_bottom"> 842<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> 843</ul> 844<div> 845<script type="text/javascript"><!-- 846 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 847 if(window==top) { 848 allClassesLink.style.display = "block"; 849 } 850 else { 851 allClassesLink.style.display = "none"; 852 } 853 //--> 854</script> 855</div> 856<div> 857<ul class="subNavList"> 858<li>Summary: </li> 859<li>Nested | </li> 860<li><a href="#field.summary">Field</a> | </li> 861<li><a href="#constructor.summary">Constr</a> | </li> 862<li><a href="#method.summary">Method</a></li> 863</ul> 864<ul class="subNavList"> 865<li>Detail: </li> 866<li><a href="#field.detail">Field</a> | </li> 867<li><a href="#constructor.detail">Constr</a> | </li> 868<li><a href="#method.detail">Method</a></li> 869</ul> 870</div> 871<a name="skip.navbar.bottom"> 872<!-- --> 873</a></div> 874<!-- ======== END OF BOTTOM NAVBAR ======= --> 875<p class="legalCopy"><small>Copyright © 2008–2018 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 876</body> 877</html> 878