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 Fri Jan 15 20:28:41 PST 2016 --> 6<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<title>DeserializationProblemHandler (jackson-databind 2.7.0 API)</title> 8<meta name="date" content="2016-01-15"> 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.7.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>Field | </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>Field | </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<!-- ======== CONSTRUCTOR SUMMARY ======== --> 126<ul class="blockList"> 127<li class="blockList"><a name="constructor_summary"> 128<!-- --> 129</a> 130<h3>Constructor Summary</h3> 131<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> 132<caption><span>Constructors</span><span class="tabEnd"> </span></caption> 133<tr> 134<th class="colOne" scope="col">Constructor and Description</th> 135</tr> 136<tr class="altColor"> 137<td class="colOne"><code><strong><a href="../../../../../com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html#DeserializationProblemHandler()">DeserializationProblemHandler</a></strong>()</code> </td> 138</tr> 139</table> 140</li> 141</ul> 142<!-- ========== METHOD SUMMARY =========== --> 143<ul class="blockList"> 144<li class="blockList"><a name="method_summary"> 145<!-- --> 146</a> 147<h3>Method Summary</h3> 148<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 149<caption><span>Methods</span><span class="tabEnd"> </span></caption> 150<tr> 151<th class="colFirst" scope="col">Modifier and Type</th> 152<th class="colLast" scope="col">Method and Description</th> 153</tr> 154<tr class="altColor"> 155<td class="colFirst"><code>boolean</code></td> 156<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, 157 <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> jp, 158 <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> deserializer, 159 <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, 160 <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> 161<div class="block">Method called when a JSON Map ("Object") entry with an unrecognized 162 name is encountered.</div> 163</td> 164</tr> 165</table> 166<ul class="blockList"> 167<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> 168<!-- --> 169</a> 170<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> 171<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> 172</ul> 173</li> 174</ul> 175</li> 176</ul> 177</div> 178<div class="details"> 179<ul class="blockList"> 180<li class="blockList"> 181<!-- ========= CONSTRUCTOR DETAIL ======== --> 182<ul class="blockList"> 183<li class="blockList"><a name="constructor_detail"> 184<!-- --> 185</a> 186<h3>Constructor Detail</h3> 187<a name="DeserializationProblemHandler()"> 188<!-- --> 189</a> 190<ul class="blockListLast"> 191<li class="blockList"> 192<h4>DeserializationProblemHandler</h4> 193<pre>public DeserializationProblemHandler()</pre> 194</li> 195</ul> 196</li> 197</ul> 198<!-- ============ METHOD DETAIL ========== --> 199<ul class="blockList"> 200<li class="blockList"><a name="method_detail"> 201<!-- --> 202</a> 203<h3>Method Detail</h3> 204<a name="handleUnknownProperty(com.fasterxml.jackson.databind.DeserializationContext, com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.JsonDeserializer, java.lang.Object, java.lang.String)"> 205<!-- --> 206</a> 207<ul class="blockListLast"> 208<li class="blockList"> 209<h4>handleUnknownProperty</h4> 210<pre>public boolean handleUnknownProperty(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 211 <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> jp, 212 <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> deserializer, 213 <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, 214 <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) 215 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>, 216 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonProcessingException.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonProcessingException</a></pre> 217<div class="block">Method called when a JSON Map ("Object") entry with an unrecognized 218 name is encountered. 219 Content (supposedly) matching the property are accessible via 220 parser that can be obtained from passed deserialization context. 221 Handler can also choose to skip the content; if so, it MUST return 222 true to indicate it did handle property successfully. 223 Skipping is usually done like so: 224<pre> 225 jp.skipChildren(); 226</pre> 227<p> 228 Note: version 1.2 added new deserialization feature 229 (<code>DeserializationConfig.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES</code>). 230 It will only have effect <b>after</b> handler is called, and only 231 if handler did <b>not</b> handle the problem.</div> 232<dl><dt><span class="strong">Parameters:</span></dt><dd><code>beanOrClass</code> - Either bean instance being deserialized (if one 233 has been instantiated so far); or Class that indicates type that 234 will be instantiated (if no instantiation done yet: for example 235 when bean uses non-default constructors)</dd><dd><code>jp</code> - Parser to use for handling problematic content</dd> 236<dt><span class="strong">Returns:</span></dt><dd>True if the problem is resolved (and content available used or skipped); 237 false if the handler did not anything and the problem is unresolved. Note that in 238 latter case caller will either throw an exception or explicitly skip the content, 239 depending on configuration.</dd> 240<dt><span class="strong">Throws:</span></dt> 241<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> 242<dd><code><a href="http://fasterxml.github.com/jackson-core/javadoc/2.7/com/fasterxml/jackson/core/JsonProcessingException.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonProcessingException</a></code></dd></dl> 243</li> 244</ul> 245</li> 246</ul> 247</li> 248</ul> 249</div> 250</div> 251<!-- ========= END OF CLASS DATA ========= --> 252<!-- ======= START OF BOTTOM NAVBAR ====== --> 253<div class="bottomNav"><a name="navbar_bottom"> 254<!-- --> 255</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> 256<!-- --> 257</a> 258<ul class="navList" title="Navigation"> 259<li><a href="../../../../../overview-summary.html">Overview</a></li> 260<li><a href="package-summary.html">Package</a></li> 261<li class="navBarCell1Rev">Class</li> 262<li><a href="class-use/DeserializationProblemHandler.html">Use</a></li> 263<li><a href="package-tree.html">Tree</a></li> 264<li><a href="../../../../../deprecated-list.html">Deprecated</a></li> 265<li><a href="../../../../../index-all.html">Index</a></li> 266<li><a href="../../../../../help-doc.html">Help</a></li> 267</ul> 268</div> 269<div class="subNav"> 270<ul class="navList"> 271<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> 272<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> 273</ul> 274<ul class="navList"> 275<li><a href="../../../../../index.html?com/fasterxml/jackson/databind/deser/DeserializationProblemHandler.html" target="_top">Frames</a></li> 276<li><a href="DeserializationProblemHandler.html" target="_top">No Frames</a></li> 277</ul> 278<ul class="navList" id="allclasses_navbar_bottom"> 279<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> 280</ul> 281<div> 282<script type="text/javascript"><!-- 283 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 284 if(window==top) { 285 allClassesLink.style.display = "block"; 286 } 287 else { 288 allClassesLink.style.display = "none"; 289 } 290 //--> 291</script> 292</div> 293<div> 294<ul class="subNavList"> 295<li>Summary: </li> 296<li>Nested | </li> 297<li>Field | </li> 298<li><a href="#constructor_summary">Constr</a> | </li> 299<li><a href="#method_summary">Method</a></li> 300</ul> 301<ul class="subNavList"> 302<li>Detail: </li> 303<li>Field | </li> 304<li><a href="#constructor_detail">Constr</a> | </li> 305<li><a href="#method_detail">Method</a></li> 306</ul> 307</div> 308<a name="skip-navbar_bottom"> 309<!-- --> 310</a></div> 311<!-- ======== END OF BOTTOM NAVBAR ======= --> 312<p class="legalCopy"><small>Copyright © 2008–2016 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 313</body> 314</html> 315