• Home
  • History
  • Annotate
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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:&nbsp;</li>
65<li>Nested&nbsp;|&nbsp;</li>
66<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
67<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
68<li><a href="#method_summary">Method</a></li>
69</ul>
70<ul class="subNavList">
71<li>Detail:&nbsp;</li>
72<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
73<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</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">&nbsp;</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">&nbsp;</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>&nbsp;</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">&nbsp;</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>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;p,
211                     <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;ctxt,
221                   <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a>&nbsp;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>&nbsp;subTypeId,
223                   <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a>&nbsp;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>&nbsp;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>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&nbsp;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&nbsp;<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&nbsp;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&nbsp;boolean&nbsp;handleUnknownProperty(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&nbsp;p,
330                            <a href="../../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&nbsp;<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>&nbsp;handleWeirdKey(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&nbsp;<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>&nbsp;handleWeirdStringValue(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&lt;?&gt;, 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&nbsp;<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>&nbsp;handleWeirdNumberValue(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&lt;?&gt;, 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&nbsp;<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>&nbsp;handleUnexpectedToken(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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>&nbsp;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&nbsp;<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>&nbsp;handleInstantiationProblem(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&nbsp;<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>&nbsp;handleMissingInstantiator(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;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>&lt;?&gt;&nbsp;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>&nbsp;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>&nbsp;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&nbsp;<a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a>&nbsp;handleUnknownTypeId(<a href="../../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a>&nbsp;ctxt,
581                           <a href="../../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind">JavaType</a>&nbsp;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>&nbsp;subTypeId,
583                           <a href="../../../../../com/fasterxml/jackson/databind/jsontype/TypeIdResolver.html" title="interface in com.fasterxml.jackson.databind.jsontype">TypeIdResolver</a>&nbsp;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>&nbsp;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:&nbsp;</li>
663<li>Nested&nbsp;|&nbsp;</li>
664<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
665<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
666<li><a href="#method_summary">Method</a></li>
667</ul>
668<ul class="subNavList">
669<li>Detail:&nbsp;</li>
670<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
671<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</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 &#169; 2008&#x2013;2016 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p>
680</body>
681</html>
682