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:12 PST 2018 --> 6<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<title>JsonDeserializer (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="JsonDeserializer (jackson-databind 2.9.0 API)"; 17 } 18 } 19 catch(err) { 20 } 21//--> 22var methods = {"i0":6,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":42,"i7":10,"i8":10,"i9":10,"i10":42,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10}; 23var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract 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/JsonDeserializer.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/JavaType.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Prev Class</span></a></li> 54<li><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.None.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Next Class</span></a></li> 55</ul> 56<ul class="navList"> 57<li><a href="../../../../index.html?com/fasterxml/jackson/databind/JsonDeserializer.html" target="_top">Frames</a></li> 58<li><a href="JsonDeserializer.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><a href="#nested.class.summary">Nested</a> | </li> 79<li>Field | </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>Field | </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</div> 97<h2 title="Class JsonDeserializer" class="title">Class JsonDeserializer<T></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.JsonDeserializer<T></li> 105</ul> 106</li> 107</ul> 108<div class="description"> 109<ul class="blockList"> 110<li class="blockList"> 111<dl> 112<dt>All Implemented Interfaces:</dt> 113<dd><a href="../../../../com/fasterxml/jackson/databind/deser/NullValueProvider.html" title="interface in com.fasterxml.jackson.databind.deser">NullValueProvider</a></dd> 114</dl> 115<dl> 116<dt>Direct Known Subclasses:</dt> 117<dd><a href="../../../../com/fasterxml/jackson/databind/deser/AbstractDeserializer.html" title="class in com.fasterxml.jackson.databind.deser">AbstractDeserializer</a>, <a href="../../../../com/fasterxml/jackson/databind/deser/impl/ErrorThrowingDeserializer.html" title="class in com.fasterxml.jackson.databind.deser.impl">ErrorThrowingDeserializer</a>, <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.None.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer.None</a>, <a href="../../../../com/fasterxml/jackson/databind/deser/std/StdDeserializer.html" title="class in com.fasterxml.jackson.databind.deser.std">StdDeserializer</a>, <a href="../../../../com/fasterxml/jackson/databind/deser/impl/TypeWrappedDeserializer.html" title="class in com.fasterxml.jackson.databind.deser.impl">TypeWrappedDeserializer</a></dd> 118</dl> 119<hr> 120<br> 121<pre>public abstract class <span class="typeNameLabel">JsonDeserializer<T></span> 122extends <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> 123implements <a href="../../../../com/fasterxml/jackson/databind/deser/NullValueProvider.html" title="interface in com.fasterxml.jackson.databind.deser">NullValueProvider</a></pre> 124<div class="block">Abstract class that defines API used by <a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a> (and 125 other chained <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><code>JsonDeserializer</code></a>s too) to deserialize Objects of 126 arbitrary types from JSON, using provided <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>. 127<p> 128 Custom deserializers should usually not directly extend this class, 129 but instead extend <a href="../../../../com/fasterxml/jackson/databind/deser/std/StdDeserializer.html" title="class in com.fasterxml.jackson.databind.deser.std"><code>StdDeserializer</code></a> 130 (or its subtypes like <a href="../../../../com/fasterxml/jackson/databind/deser/std/StdScalarDeserializer.html" title="class in com.fasterxml.jackson.databind.deser.std"><code>StdScalarDeserializer</code></a>). 131<p> 132 If deserializer is an aggregate one -- meaning it delegates handling of some 133 of its contents by using other deserializer(s) -- it typically also needs 134 to implement <a href="../../../../com/fasterxml/jackson/databind/deser/ResolvableDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser"><code>ResolvableDeserializer</code></a>, 135 which can locate dependant deserializers. This is important to allow dynamic 136 overrides of deserializers; separate call interface is needed to separate 137 resolution of dependant deserializers (which may have cyclic link back 138 to deserializer itself, directly or indirectly). 139<p> 140 In addition, to support per-property annotations (to configure aspects 141 of deserialization on per-property basis), deserializers may want 142 to implement 143 <a href="../../../../com/fasterxml/jackson/databind/deser/ContextualDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser"><code>ContextualDeserializer</code></a>, 144 which allows specialization of deserializers: call to 145 <a href="../../../../com/fasterxml/jackson/databind/deser/ContextualDeserializer.html#createContextual-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.BeanProperty-"><code>ContextualDeserializer.createContextual(com.fasterxml.jackson.databind.DeserializationContext, com.fasterxml.jackson.databind.BeanProperty)</code></a> 146 is passed information on property, and can create a newly configured 147 deserializer for handling that particular property. 148<p> 149 If both 150 <a href="../../../../com/fasterxml/jackson/databind/deser/ResolvableDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser"><code>ResolvableDeserializer</code></a> and 151 <a href="../../../../com/fasterxml/jackson/databind/deser/ContextualDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser"><code>ContextualDeserializer</code></a> 152 are implemented, resolution of deserializers occurs before 153 contextualization.</div> 154</li> 155</ul> 156</div> 157<div class="summary"> 158<ul class="blockList"> 159<li class="blockList"> 160<!-- ======== NESTED CLASS SUMMARY ======== --> 161<ul class="blockList"> 162<li class="blockList"><a name="nested.class.summary"> 163<!-- --> 164</a> 165<h3>Nested Class Summary</h3> 166<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Nested Class Summary table, listing nested classes, and an explanation"> 167<caption><span>Nested Classes</span><span class="tabEnd"> </span></caption> 168<tr> 169<th class="colFirst" scope="col">Modifier and Type</th> 170<th class="colLast" scope="col">Class and Description</th> 171</tr> 172<tr class="altColor"> 173<td class="colFirst"><code>static class </code></td> 174<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.None.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer.None</a></span></code> 175<div class="block">This marker class is only to be used with annotations, to 176 indicate that <b>no deserializer is configured</b>.</div> 177</td> 178</tr> 179</table> 180</li> 181</ul> 182<!-- ======== CONSTRUCTOR SUMMARY ======== --> 183<ul class="blockList"> 184<li class="blockList"><a name="constructor.summary"> 185<!-- --> 186</a> 187<h3>Constructor Summary</h3> 188<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> 189<caption><span>Constructors</span><span class="tabEnd"> </span></caption> 190<tr> 191<th class="colOne" scope="col">Constructor and Description</th> 192</tr> 193<tr class="altColor"> 194<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#JsonDeserializer--">JsonDeserializer</a></span>()</code> </td> 195</tr> 196</table> 197</li> 198</ul> 199<!-- ========== METHOD SUMMARY =========== --> 200<ul class="blockList"> 201<li class="blockList"><a name="method.summary"> 202<!-- --> 203</a> 204<h3>Method Summary</h3> 205<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 206<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="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract 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> 207<tr> 208<th class="colFirst" scope="col">Modifier and Type</th> 209<th class="colLast" scope="col">Method and Description</th> 210</tr> 211<tr id="i0" class="altColor"> 212<td class="colFirst"><code>abstract <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a></code></td> 213<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-">deserialize</a></span>(<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, 214 <a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt)</code> 215<div class="block">Method that can be called to ask implementation to deserialize 216 JSON content into the value type this serializer handles.</div> 217</td> 218</tr> 219<tr id="i1" class="rowColor"> 220<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a></code></td> 221<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-T-">deserialize</a></span>(<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, 222 <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/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a> intoValue)</code> 224<div class="block">Alternate deserialization method (compared to the most commonly 225 used, <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-"><code>deserialize(JsonParser, DeserializationContext)</code></a>), 226 which takes in initialized value instance, to be 227 configured and/or populated by deserializer.</div> 228</td> 229</tr> 230<tr id="i2" 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/JsonDeserializer.html#deserializeWithType-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.jsontype.TypeDeserializer-">deserializeWithType</a></span>(<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, 233 <a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 234 <a href="../../../../com/fasterxml/jackson/databind/jsontype/TypeDeserializer.html" title="class in com.fasterxml.jackson.databind.jsontype">TypeDeserializer</a> typeDeserializer)</code> 235<div class="block">Deserialization called when type being deserialized is defined to 236 contain additional type identifier, to allow for correctly 237 instantiating correct subtype.</div> 238</td> 239</tr> 240<tr id="i3" class="rowColor"> 241<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/deser/SettableBeanProperty.html" title="class in com.fasterxml.jackson.databind.deser">SettableBeanProperty</a></code></td> 242<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#findBackReference-java.lang.String-">findBackReference</a></span>(<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> refName)</code> 243<div class="block">Method needed by <a href="../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser"><code>BeanDeserializerFactory</code></a> to properly link 244 managed- and back-reference pairs.</div> 245</td> 246</tr> 247<tr id="i4" class="altColor"> 248<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?></code></td> 249<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getDelegatee--">getDelegatee</a></span>()</code> 250<div class="block">Accessor that can be used to determine if this deserializer uses 251 another deserializer for actual deserialization, by delegating 252 calls.</div> 253</td> 254</tr> 255<tr id="i5" class="rowColor"> 256<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/util/AccessPattern.html" title="enum in com.fasterxml.jackson.databind.util">AccessPattern</a></code></td> 257<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getEmptyAccessPattern--">getEmptyAccessPattern</a></span>()</code> 258<div class="block">This method may be called in conjunction with calls to 259 <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getEmptyValue-com.fasterxml.jackson.databind.DeserializationContext-"><code>getEmptyValue(DeserializationContext)</code></a>, to check whether it needs 260 to be called just once (static values), or each time empty value is 261 needed.</div> 262</td> 263</tr> 264<tr id="i6" class="altColor"> 265<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> 266<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getEmptyValue--">getEmptyValue</a></span>()</code> 267<div class="block"><span class="deprecatedLabel">Deprecated.</span> 268<div class="block"><span class="deprecationComment">Since 2.6 Use overloaded variant that takes context argument</span></div> 269</div> 270</td> 271</tr> 272<tr id="i7" class="rowColor"> 273<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> 274<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getEmptyValue-com.fasterxml.jackson.databind.DeserializationContext-">getEmptyValue</a></span>(<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt)</code> 275<div class="block">Method called to determine value to be used for "empty" values 276 (most commonly when deserializing from empty JSON Strings).</div> 277</td> 278</tr> 279<tr id="i8" class="altColor"> 280<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><<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> 281<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getKnownPropertyNames--">getKnownPropertyNames</a></span>()</code> 282<div class="block">Method that will 283 either return null to indicate that type being deserializers 284 has no concept of properties; or a collection of identifiers 285 for which <code>toString</code> will give external property 286 name.</div> 287</td> 288</tr> 289<tr id="i9" class="rowColor"> 290<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/util/AccessPattern.html" title="enum in com.fasterxml.jackson.databind.util">AccessPattern</a></code></td> 291<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getNullAccessPattern--">getNullAccessPattern</a></span>()</code> 292<div class="block">Default implementation indicates that "null value" to use for input null 293 is simply Java `null` for all deserializers, unless overridden by sub-classes.</div> 294</td> 295</tr> 296<tr id="i10" class="altColor"> 297<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a></code></td> 298<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getNullValue--">getNullValue</a></span>()</code> 299<div class="block"><span class="deprecatedLabel">Deprecated.</span> 300<div class="block"><span class="deprecationComment">Since 2.6 Use overloaded variant that takes context argument</span></div> 301</div> 302</td> 303</tr> 304<tr id="i11" class="rowColor"> 305<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a></code></td> 306<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getNullValue-com.fasterxml.jackson.databind.DeserializationContext-">getNullValue</a></span>(<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt)</code> 307<div class="block">Method that can be called to determine value to be used for 308 representing null values (values deserialized when JSON token 309 is <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonToken.html?is-external=true#VALUE_NULL" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.VALUE_NULL</code></a>).</div> 310</td> 311</tr> 312<tr id="i12" class="altColor"> 313<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/deser/impl/ObjectIdReader.html" title="class in com.fasterxml.jackson.databind.deser.impl">ObjectIdReader</a></code></td> 314<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getObjectIdReader--">getObjectIdReader</a></span>()</code> 315<div class="block">Accessor that can be used to check whether this deserializer 316 is expecting to possibly get an Object Identifier value instead of full value 317 serialization, and if so, should be able to resolve it to actual 318 Object instance to return as deserialized value.</div> 319</td> 320</tr> 321<tr id="i13" class="rowColor"> 322<td class="colFirst"><code><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><?></code></td> 323<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#handledType--">handledType</a></span>()</code> 324<div class="block">Method for accessing type of values this deserializer produces.</div> 325</td> 326</tr> 327<tr id="i14" class="altColor"> 328<td class="colFirst"><code>boolean</code></td> 329<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#isCachable--">isCachable</a></span>()</code> 330<div class="block">Method called to see if deserializer instance is cachable and 331 usable for other properties of same type (type for which instance 332 was created).</div> 333</td> 334</tr> 335<tr id="i15" class="rowColor"> 336<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?></code></td> 337<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#replaceDelegatee-com.fasterxml.jackson.databind.JsonDeserializer-">replaceDelegatee</a></span>(<a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> delegatee)</code> 338<div class="block">Method that can be called to try to replace deserializer this deserializer 339 delegates calls to.</div> 340</td> 341</tr> 342<tr id="i16" class="altColor"> 343<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a></code></td> 344<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#supportsUpdate-com.fasterxml.jackson.databind.DeserializationConfig-">supportsUpdate</a></span>(<a href="../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind">DeserializationConfig</a> config)</code> 345<div class="block">Introspection method that may be called to see whether deserializer supports 346 update of an existing value (aka "merging") or not.</div> 347</td> 348</tr> 349<tr id="i17" class="rowColor"> 350<td class="colFirst"><code><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><<a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a>></code></td> 351<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#unwrappingDeserializer-com.fasterxml.jackson.databind.util.NameTransformer-">unwrappingDeserializer</a></span>(<a href="../../../../com/fasterxml/jackson/databind/util/NameTransformer.html" title="class in com.fasterxml.jackson.databind.util">NameTransformer</a> unwrapper)</code> 352<div class="block">Method that will return deserializer instance that is able 353 to handle "unwrapped" value instances 354 If no unwrapped instance can be constructed, will simply 355 return this object as-is.</div> 356</td> 357</tr> 358</table> 359<ul class="blockList"> 360<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object"> 361<!-- --> 362</a> 363<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> 364<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> 365</ul> 366</li> 367</ul> 368</li> 369</ul> 370</div> 371<div class="details"> 372<ul class="blockList"> 373<li class="blockList"> 374<!-- ========= CONSTRUCTOR DETAIL ======== --> 375<ul class="blockList"> 376<li class="blockList"><a name="constructor.detail"> 377<!-- --> 378</a> 379<h3>Constructor Detail</h3> 380<a name="JsonDeserializer--"> 381<!-- --> 382</a> 383<ul class="blockListLast"> 384<li class="blockList"> 385<h4>JsonDeserializer</h4> 386<pre>public JsonDeserializer()</pre> 387</li> 388</ul> 389</li> 390</ul> 391<!-- ============ METHOD DETAIL ========== --> 392<ul class="blockList"> 393<li class="blockList"><a name="method.detail"> 394<!-- --> 395</a> 396<h3>Method Detail</h3> 397<a name="deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-"> 398<!-- --> 399</a> 400<ul class="blockList"> 401<li class="blockList"> 402<h4>deserialize</h4> 403<pre>public abstract <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a> deserialize(<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, 404 <a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt) 405 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>, 406 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonProcessingException.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonProcessingException</a></pre> 407<div class="block">Method that can be called to ask implementation to deserialize 408 JSON content into the value type this serializer handles. 409 Returned instance is to be constructed by method itself. 410<p> 411 Pre-condition for this method is that the parser points to the 412 first event that is part of value to deserializer (and which 413 is never JSON 'null' literal, more on this below): for simple 414 types it may be the only value; and for structured types the 415 Object start marker or a FIELD_NAME. 416 </p> 417 <p> 418 The two possible input conditions for structured types result 419 from polymorphism via fields. In the ordinary case, Jackson 420 calls this method when it has encountered an OBJECT_START, 421 and the method implementation must advance to the next token to 422 see the first field name. If the application configures 423 polymorphism via a field, then the object looks like the following. 424 <pre> 425 { 426 "@class": "class name", 427 ... 428 } 429 </pre> 430 Jackson consumes the two tokens (the <tt>@class</tt> field name 431 and its value) in order to learn the class and select the deserializer. 432 Thus, the stream is pointing to the FIELD_NAME for the first field 433 after the @class. Thus, if you want your method to work correctly 434 both with and without polymorphism, you must begin your method with: 435 <pre> 436 if (p.getCurrentToken() == JsonToken.START_OBJECT) { 437 p.nextToken(); 438 } 439 </pre> 440 This results in the stream pointing to the field name, so that 441 the two conditions align. 442 <p> 443 Post-condition is that the parser will point to the last 444 event that is part of deserialized value (or in case deserialization 445 fails, event that was not recognized or usable, which may be 446 the same event as the one it pointed to upon call). 447<p> 448 Note that this method is never called for JSON null literal, 449 and thus deserializers need (and should) not check for it.</div> 450<dl> 451<dt><span class="paramLabel">Parameters:</span></dt> 452<dd><code>p</code> - Parsed used for reading JSON content</dd> 453<dd><code>ctxt</code> - Context that can be used to access information about 454 this deserialization activity.</dd> 455<dt><span class="returnLabel">Returns:</span></dt> 456<dd>Deserialized value</dd> 457<dt><span class="throwsLabel">Throws:</span></dt> 458<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> 459<dd><code><a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonProcessingException.html?is-external=true" title="class or interface in com.fasterxml.jackson.core">JsonProcessingException</a></code></dd> 460</dl> 461</li> 462</ul> 463<a name="deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-java.lang.Object-"> 464<!-- --> 465</a><a name="deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-T-"> 466<!-- --> 467</a> 468<ul class="blockList"> 469<li class="blockList"> 470<h4>deserialize</h4> 471<pre>public <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a> deserialize(<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, 472 <a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 473 <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a> intoValue) 474 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> 475<div class="block">Alternate deserialization method (compared to the most commonly 476 used, <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#deserialize-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-"><code>deserialize(JsonParser, DeserializationContext)</code></a>), 477 which takes in initialized value instance, to be 478 configured and/or populated by deserializer. 479 Method is not necessarily used (or supported) by all types 480 (it will not work for immutable types, for obvious reasons): 481 most commonly it is used for Collections and Maps. 482 It may be used both with "updating readers" (for POJOs) and 483 when Collections and Maps use "getter as setter". 484<p> 485 Default implementation just throws 486 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang"><code>UnsupportedOperationException</code></a>, to indicate that types 487 that do not explicitly add support do not necessarily support 488 update-existing-value operation (esp. immutable types)</div> 489<dl> 490<dt><span class="throwsLabel">Throws:</span></dt> 491<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> 492</dl> 493</li> 494</ul> 495<a name="deserializeWithType-com.fasterxml.jackson.core.JsonParser-com.fasterxml.jackson.databind.DeserializationContext-com.fasterxml.jackson.databind.jsontype.TypeDeserializer-"> 496<!-- --> 497</a> 498<ul class="blockList"> 499<li class="blockList"> 500<h4>deserializeWithType</h4> 501<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> deserializeWithType(<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, 502 <a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt, 503 <a href="../../../../com/fasterxml/jackson/databind/jsontype/TypeDeserializer.html" title="class in com.fasterxml.jackson.databind.jsontype">TypeDeserializer</a> typeDeserializer) 504 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> 505<div class="block">Deserialization called when type being deserialized is defined to 506 contain additional type identifier, to allow for correctly 507 instantiating correct subtype. This can be due to annotation on 508 type (or its supertype), or due to global settings without 509 annotations. 510<p> 511 Default implementation may work for some types, but ideally subclasses 512 should not rely on current default implementation. 513 Implementation is mostly provided to avoid compilation errors with older 514 code.</div> 515<dl> 516<dt><span class="paramLabel">Parameters:</span></dt> 517<dd><code>typeDeserializer</code> - Deserializer to use for handling type information</dd> 518<dt><span class="throwsLabel">Throws:</span></dt> 519<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> 520</dl> 521</li> 522</ul> 523<a name="unwrappingDeserializer-com.fasterxml.jackson.databind.util.NameTransformer-"> 524<!-- --> 525</a> 526<ul class="blockList"> 527<li class="blockList"> 528<h4>unwrappingDeserializer</h4> 529<pre>public <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><<a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a>> unwrappingDeserializer(<a href="../../../../com/fasterxml/jackson/databind/util/NameTransformer.html" title="class in com.fasterxml.jackson.databind.util">NameTransformer</a> unwrapper)</pre> 530<div class="block">Method that will return deserializer instance that is able 531 to handle "unwrapped" value instances 532 If no unwrapped instance can be constructed, will simply 533 return this object as-is. 534<p> 535 Default implementation just returns 'this' 536 indicating that no unwrapped variant exists</div> 537</li> 538</ul> 539<a name="replaceDelegatee-com.fasterxml.jackson.databind.JsonDeserializer-"> 540<!-- --> 541</a> 542<ul class="blockList"> 543<li class="blockList"> 544<h4>replaceDelegatee</h4> 545<pre>public <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> replaceDelegatee(<a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> delegatee)</pre> 546<div class="block">Method that can be called to try to replace deserializer this deserializer 547 delegates calls to. If not supported (either this deserializer does not 548 delegate anything; or it does not want any changes), should either 549 throw <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang"><code>UnsupportedOperationException</code></a> (if operation does not 550 make sense or is not allowed); or return this deserializer as is.</div> 551<dl> 552<dt><span class="simpleTagLabel">Since:</span></dt> 553<dd>2.1</dd> 554</dl> 555</li> 556</ul> 557<a name="handledType--"> 558<!-- --> 559</a> 560<ul class="blockList"> 561<li class="blockList"> 562<h4>handledType</h4> 563<pre>public <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><?> handledType()</pre> 564<div class="block">Method for accessing type of values this deserializer produces. 565 Note that this information is not guaranteed to be exact -- it 566 may be a more generic (super-type) -- but it should not be 567 incorrect (return a non-related type). 568<p> 569 Default implementation will return null, which means almost same 570 same as returning <code>Object.class</code> would; that is, that 571 nothing is known about handled type. 572<p></div> 573<dl> 574<dt><span class="simpleTagLabel">Since:</span></dt> 575<dd>2.3</dd> 576</dl> 577</li> 578</ul> 579<a name="isCachable--"> 580<!-- --> 581</a> 582<ul class="blockList"> 583<li class="blockList"> 584<h4>isCachable</h4> 585<pre>public boolean isCachable()</pre> 586<div class="block">Method called to see if deserializer instance is cachable and 587 usable for other properties of same type (type for which instance 588 was created). 589<p> 590 Note that cached instances are still resolved on per-property basis, 591 if instance implements <a href="../../../../com/fasterxml/jackson/databind/deser/ResolvableDeserializer.html" title="interface in com.fasterxml.jackson.databind.deser"><code>ResolvableDeserializer</code></a>: 592 cached instance is just as the base. This means that in most cases it is safe to 593 cache instances; however, it only makes sense to cache instances 594 if instantiation is expensive, or if instances are heavy-weight. 595<p> 596 Default implementation returns false, to indicate that no caching 597 is done.</div> 598</li> 599</ul> 600<a name="getDelegatee--"> 601<!-- --> 602</a> 603<ul class="blockList"> 604<li class="blockList"> 605<h4>getDelegatee</h4> 606<pre>public <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind">JsonDeserializer</a><?> getDelegatee()</pre> 607<div class="block">Accessor that can be used to determine if this deserializer uses 608 another deserializer for actual deserialization, by delegating 609 calls. If so, will return immediate delegate (which itself may 610 delegate to further deserializers); otherwise will return null.</div> 611<dl> 612<dt><span class="returnLabel">Returns:</span></dt> 613<dd>Deserializer this deserializer delegates calls to, if null; 614 null otherwise.</dd> 615<dt><span class="simpleTagLabel">Since:</span></dt> 616<dd>2.1</dd> 617</dl> 618</li> 619</ul> 620<a name="getKnownPropertyNames--"> 621<!-- --> 622</a> 623<ul class="blockList"> 624<li class="blockList"> 625<h4>getKnownPropertyNames</h4> 626<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a><<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>> getKnownPropertyNames()</pre> 627<div class="block">Method that will 628 either return null to indicate that type being deserializers 629 has no concept of properties; or a collection of identifiers 630 for which <code>toString</code> will give external property 631 name. 632 This is only to be used for error reporting and diagnostics 633 purposes (most commonly, to accompany "unknown property" 634 exception).</div> 635<dl> 636<dt><span class="simpleTagLabel">Since:</span></dt> 637<dd>2.0</dd> 638</dl> 639</li> 640</ul> 641<a name="getNullValue-com.fasterxml.jackson.databind.DeserializationContext-"> 642<!-- --> 643</a> 644<ul class="blockList"> 645<li class="blockList"> 646<h4>getNullValue</h4> 647<pre>public <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a> getNullValue(<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt) 648 throws <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</a></pre> 649<div class="block">Method that can be called to determine value to be used for 650 representing null values (values deserialized when JSON token 651 is <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/com/fasterxml/jackson/core/JsonToken.html?is-external=true#VALUE_NULL" title="class or interface in com.fasterxml.jackson.core"><code>JsonToken.VALUE_NULL</code></a>). Usually this is simply 652 Java null, but for some types (especially primitives) it may be 653 necessary to use non-null values. 654<p> 655 Since version 2.6 (in which the context argument was added), call is 656 expected to be made each and every time a null token needs to 657 be handled. 658<p> 659 Default implementation simply returns null.</div> 660<dl> 661<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 662<dd><code><a href="../../../../com/fasterxml/jackson/databind/deser/NullValueProvider.html#getNullValue-com.fasterxml.jackson.databind.DeserializationContext-">getNullValue</a></code> in interface <code><a href="../../../../com/fasterxml/jackson/databind/deser/NullValueProvider.html" title="interface in com.fasterxml.jackson.databind.deser">NullValueProvider</a></code></dd> 663<dt><span class="throwsLabel">Throws:</span></dt> 664<dd><code><a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</a></code></dd> 665<dt><span class="simpleTagLabel">Since:</span></dt> 666<dd>2.6 Added to replace earlier no-arguments variant</dd> 667</dl> 668</li> 669</ul> 670<a name="getNullAccessPattern--"> 671<!-- --> 672</a> 673<ul class="blockList"> 674<li class="blockList"> 675<h4>getNullAccessPattern</h4> 676<pre>public <a href="../../../../com/fasterxml/jackson/databind/util/AccessPattern.html" title="enum in com.fasterxml.jackson.databind.util">AccessPattern</a> getNullAccessPattern()</pre> 677<div class="block">Default implementation indicates that "null value" to use for input null 678 is simply Java `null` for all deserializers, unless overridden by sub-classes. 679 This information may be used as optimization.</div> 680<dl> 681<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 682<dd><code><a href="../../../../com/fasterxml/jackson/databind/deser/NullValueProvider.html#getNullAccessPattern--">getNullAccessPattern</a></code> in interface <code><a href="../../../../com/fasterxml/jackson/databind/deser/NullValueProvider.html" title="interface in com.fasterxml.jackson.databind.deser">NullValueProvider</a></code></dd> 683</dl> 684</li> 685</ul> 686<a name="getEmptyAccessPattern--"> 687<!-- --> 688</a> 689<ul class="blockList"> 690<li class="blockList"> 691<h4>getEmptyAccessPattern</h4> 692<pre>public <a href="../../../../com/fasterxml/jackson/databind/util/AccessPattern.html" title="enum in com.fasterxml.jackson.databind.util">AccessPattern</a> getEmptyAccessPattern()</pre> 693<div class="block">This method may be called in conjunction with calls to 694 <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getEmptyValue-com.fasterxml.jackson.databind.DeserializationContext-"><code>getEmptyValue(DeserializationContext)</code></a>, to check whether it needs 695 to be called just once (static values), or each time empty value is 696 needed.</div> 697<dl> 698<dt><span class="simpleTagLabel">Since:</span></dt> 699<dd>2.9</dd> 700</dl> 701</li> 702</ul> 703<a name="getEmptyValue-com.fasterxml.jackson.databind.DeserializationContext-"> 704<!-- --> 705</a> 706<ul class="blockList"> 707<li class="blockList"> 708<h4>getEmptyValue</h4> 709<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> getEmptyValue(<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind">DeserializationContext</a> ctxt) 710 throws <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</a></pre> 711<div class="block">Method called to determine value to be used for "empty" values 712 (most commonly when deserializing from empty JSON Strings). 713 Usually this is same as <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getNullValue-com.fasterxml.jackson.databind.DeserializationContext-"><code>getNullValue(com.fasterxml.jackson.databind.DeserializationContext)</code></a> (which in turn 714 is usually simply Java null), but it can be overridden 715 for types. Or, if type should never be converted from empty 716 String, method can also throw an exception. 717<p> 718 Since version 2.6 (in which the context argument was added), call is 719 expected to be made each and every time an empty value is needed. 720<p> 721 Since version 2.9 does not require return of `T` any more. 722<p> 723 Default implementation simply calls <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html#getNullValue-com.fasterxml.jackson.databind.DeserializationContext-"><code>getNullValue(com.fasterxml.jackson.databind.DeserializationContext)</code></a> and 724 returns value.</div> 725<dl> 726<dt><span class="throwsLabel">Throws:</span></dt> 727<dd><code><a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind">JsonMappingException</a></code></dd> 728<dt><span class="simpleTagLabel">Since:</span></dt> 729<dd>2.6 Added to replace earlier no-arguments variant</dd> 730</dl> 731</li> 732</ul> 733<a name="getObjectIdReader--"> 734<!-- --> 735</a> 736<ul class="blockList"> 737<li class="blockList"> 738<h4>getObjectIdReader</h4> 739<pre>public <a href="../../../../com/fasterxml/jackson/databind/deser/impl/ObjectIdReader.html" title="class in com.fasterxml.jackson.databind.deser.impl">ObjectIdReader</a> getObjectIdReader()</pre> 740<div class="block">Accessor that can be used to check whether this deserializer 741 is expecting to possibly get an Object Identifier value instead of full value 742 serialization, and if so, should be able to resolve it to actual 743 Object instance to return as deserialized value. 744<p> 745 Default implementation returns null, as support cannot be implemented 746 generically. Some standard deserializers (most notably 747 <a href="../../../../com/fasterxml/jackson/databind/deser/BeanDeserializer.html" title="class in com.fasterxml.jackson.databind.deser"><code>BeanDeserializer</code></a>) 748 do implement this feature, and may return reader instance, depending on exact 749 configuration of instance (which is based on type, and referring property).</div> 750<dl> 751<dt><span class="returnLabel">Returns:</span></dt> 752<dd>ObjectIdReader used for resolving possible Object Identifier 753 value, instead of full value serialization, if deserializer can do that; 754 null if no Object Id is expected.</dd> 755<dt><span class="simpleTagLabel">Since:</span></dt> 756<dd>2.0</dd> 757</dl> 758</li> 759</ul> 760<a name="findBackReference-java.lang.String-"> 761<!-- --> 762</a> 763<ul class="blockList"> 764<li class="blockList"> 765<h4>findBackReference</h4> 766<pre>public <a href="../../../../com/fasterxml/jackson/databind/deser/SettableBeanProperty.html" title="class in com.fasterxml.jackson.databind.deser">SettableBeanProperty</a> findBackReference(<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> refName)</pre> 767<div class="block">Method needed by <a href="../../../../com/fasterxml/jackson/databind/deser/BeanDeserializerFactory.html" title="class in com.fasterxml.jackson.databind.deser"><code>BeanDeserializerFactory</code></a> to properly link 768 managed- and back-reference pairs.</div> 769<dl> 770<dt><span class="simpleTagLabel">Since:</span></dt> 771<dd>2.2 (was moved out of <code>BeanDeserializerBase</code>)</dd> 772</dl> 773</li> 774</ul> 775<a name="supportsUpdate-com.fasterxml.jackson.databind.DeserializationConfig-"> 776<!-- --> 777</a> 778<ul class="blockList"> 779<li class="blockList"> 780<h4>supportsUpdate</h4> 781<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a> supportsUpdate(<a href="../../../../com/fasterxml/jackson/databind/DeserializationConfig.html" title="class in com.fasterxml.jackson.databind">DeserializationConfig</a> config)</pre> 782<div class="block">Introspection method that may be called to see whether deserializer supports 783 update of an existing value (aka "merging") or not. Return value should either 784 be <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Boolean.html?is-external=true#FALSE" title="class or interface in java.lang"><code>Boolean.FALSE</code></a> if update is not supported at all (immutable values); 785 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Boolean.html?is-external=true#TRUE" title="class or interface in java.lang"><code>Boolean.TRUE</code></a> if update should usually work (regular POJOs, for example), 786 or <code>null</code> if this is either not known, or may sometimes work. 787<p> 788 Information gathered is typically used to either prevent merging update for 789 property (either by skipping, if based on global defaults; or by exception during 790 deserialization construction if explicit attempt made) if <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Boolean.html?is-external=true#FALSE" title="class or interface in java.lang"><code>Boolean.FALSE</code></a> 791 returned, or inclusion if <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Boolean.html?is-external=true#TRUE" title="class or interface in java.lang"><code>Boolean.TRUE</code></a> is specified. If "unknown" case 792 (<code>null</code> returned) behavior is to exclude property if global defaults 793 used; or to allow if explicit per-type or property merging is defined. 794<p> 795 Default implementation returns <code>null</code> to allow explicit per-type 796 or per-property attempts.</div> 797<dl> 798<dt><span class="simpleTagLabel">Since:</span></dt> 799<dd>2.9</dd> 800</dl> 801</li> 802</ul> 803<a name="getNullValue--"> 804<!-- --> 805</a> 806<ul class="blockList"> 807<li class="blockList"> 808<h4>getNullValue</h4> 809<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> 810public <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="type parameter in JsonDeserializer">T</a> getNullValue()</pre> 811<div class="block"><span class="deprecatedLabel">Deprecated.</span> <span class="deprecationComment">Since 2.6 Use overloaded variant that takes context argument</span></div> 812</li> 813</ul> 814<a name="getEmptyValue--"> 815<!-- --> 816</a> 817<ul class="blockListLast"> 818<li class="blockList"> 819<h4>getEmptyValue</h4> 820<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> 821public <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> getEmptyValue()</pre> 822<div class="block"><span class="deprecatedLabel">Deprecated.</span> <span class="deprecationComment">Since 2.6 Use overloaded variant that takes context argument</span></div> 823</li> 824</ul> 825</li> 826</ul> 827</li> 828</ul> 829</div> 830</div> 831<!-- ========= END OF CLASS DATA ========= --> 832<!-- ======= START OF BOTTOM NAVBAR ====== --> 833<div class="bottomNav"><a name="navbar.bottom"> 834<!-- --> 835</a> 836<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> 837<a name="navbar.bottom.firstrow"> 838<!-- --> 839</a> 840<ul class="navList" title="Navigation"> 841<li><a href="../../../../overview-summary.html">Overview</a></li> 842<li><a href="package-summary.html">Package</a></li> 843<li class="navBarCell1Rev">Class</li> 844<li><a href="class-use/JsonDeserializer.html">Use</a></li> 845<li><a href="package-tree.html">Tree</a></li> 846<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 847<li><a href="../../../../index-all.html">Index</a></li> 848<li><a href="../../../../help-doc.html">Help</a></li> 849</ul> 850</div> 851<div class="subNav"> 852<ul class="navList"> 853<li><a href="../../../../com/fasterxml/jackson/databind/JavaType.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Prev Class</span></a></li> 854<li><a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.None.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Next Class</span></a></li> 855</ul> 856<ul class="navList"> 857<li><a href="../../../../index.html?com/fasterxml/jackson/databind/JsonDeserializer.html" target="_top">Frames</a></li> 858<li><a href="JsonDeserializer.html" target="_top">No Frames</a></li> 859</ul> 860<ul class="navList" id="allclasses_navbar_bottom"> 861<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 862</ul> 863<div> 864<script type="text/javascript"><!-- 865 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 866 if(window==top) { 867 allClassesLink.style.display = "block"; 868 } 869 else { 870 allClassesLink.style.display = "none"; 871 } 872 //--> 873</script> 874</div> 875<div> 876<ul class="subNavList"> 877<li>Summary: </li> 878<li><a href="#nested.class.summary">Nested</a> | </li> 879<li>Field | </li> 880<li><a href="#constructor.summary">Constr</a> | </li> 881<li><a href="#method.summary">Method</a></li> 882</ul> 883<ul class="subNavList"> 884<li>Detail: </li> 885<li>Field | </li> 886<li><a href="#constructor.detail">Constr</a> | </li> 887<li><a href="#method.detail">Method</a></li> 888</ul> 889</div> 890<a name="skip.navbar.bottom"> 891<!-- --> 892</a></div> 893<!-- ======== END OF BOTTOM NAVBAR ======= --> 894<p class="legalCopy"><small>Copyright © 2008–2018 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 895</body> 896</html> 897