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 Sat Apr 25 17:14:47 PDT 2020 --> 6<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<title>DeserializationFeature (jackson-databind 2.11.0 API)</title> 8<meta name="date" content="2020-04-25"> 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="DeserializationFeature (jackson-databind 2.11.0 API)"; 17 } 18 } 19 catch(err) { 20 } 21//--> 22var methods = {"i0":10,"i1":10,"i2":10,"i3":9,"i4":9}; 23var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete 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/DeserializationFeature.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/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Prev Class</span></a></li> 54<li><a href="../../../../com/fasterxml/jackson/databind/InjectableValues.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/DeserializationFeature.html" target="_top">Frames</a></li> 58<li><a href="DeserializationFeature.html" target="_top">No Frames</a></li> 59</ul> 60<ul class="navList" id="allclasses_navbar_top"> 61<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 62</ul> 63<div> 64<script type="text/javascript"><!-- 65 allClassesLink = document.getElementById("allclasses_navbar_top"); 66 if(window==top) { 67 allClassesLink.style.display = "block"; 68 } 69 else { 70 allClassesLink.style.display = "none"; 71 } 72 //--> 73</script> 74</div> 75<div> 76<ul class="subNavList"> 77<li>Summary: </li> 78<li>Nested | </li> 79<li><a href="#enum.constant.summary">Enum Constants</a> | </li> 80<li>Field | </li> 81<li><a href="#method.summary">Method</a></li> 82</ul> 83<ul class="subNavList"> 84<li>Detail: </li> 85<li><a href="#enum.constant.detail">Enum Constants</a> | </li> 86<li>Field | </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="Enum DeserializationFeature" class="title">Enum DeserializationFeature</h2> 98</div> 99<div class="contentContainer"> 100<ul class="inheritance"> 101<li><a href="https://docs.oracle.com/javase/8/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><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">java.lang.Enum</a><<a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>></li> 105<li> 106<ul class="inheritance"> 107<li>com.fasterxml.jackson.databind.DeserializationFeature</li> 108</ul> 109</li> 110</ul> 111</li> 112</ul> 113<div class="description"> 114<ul class="blockList"> 115<li class="blockList"> 116<dl> 117<dt>All Implemented Interfaces:</dt> 118<dd><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html" title="interface in com.fasterxml.jackson.databind.cfg">ConfigFeature</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>></dd> 119</dl> 120<hr> 121<br> 122<pre>public enum <span class="typeNameLabel">DeserializationFeature</span> 123extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">Enum</a><<a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>> 124implements <a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html" title="interface in com.fasterxml.jackson.databind.cfg">ConfigFeature</a></pre> 125<div class="block">Enumeration that defines simple on/off features that affect 126 the way Java objects are deserialized from JSON 127<p> 128 Note that features can be set both through 129 <a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a> (as sort of defaults) and through 130 <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a>. 131 In first case these defaults must follow "config-then-use" patterns 132 (i.e. defined once, not changed afterwards); all per-call 133 changes must be done using <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a>. 134<p> 135 Note that features that do not indicate version of inclusion 136 were available in Jackson 2.0 (or earlier); only later additions 137 indicate version of inclusion.</div> 138</li> 139</ul> 140</div> 141<div class="summary"> 142<ul class="blockList"> 143<li class="blockList"> 144<!-- =========== ENUM CONSTANT SUMMARY =========== --> 145<ul class="blockList"> 146<li class="blockList"><a name="enum.constant.summary"> 147<!-- --> 148</a> 149<h3>Enum Constant Summary</h3> 150<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Enum Constant Summary table, listing enum constants, and an explanation"> 151<caption><span>Enum Constants</span><span class="tabEnd"> </span></caption> 152<tr> 153<th class="colOne" scope="col">Enum Constant and Description</th> 154</tr> 155<tr class="altColor"> 156<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT">ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT</a></span></code> 157<div class="block">Feature that can be enabled to allow empty JSON Array 158 value (that is, <code>[ ]</code>) to be bound to POJOs (and 159 with 2.9, other values too) as `null`.</div> 160</td> 161</tr> 162<tr class="rowColor"> 163<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ACCEPT_EMPTY_STRING_AS_NULL_OBJECT">ACCEPT_EMPTY_STRING_AS_NULL_OBJECT</a></span></code> 164<div class="block">Feature that can be enabled to allow JSON empty String 165 value ("") to be bound as `null` for POJOs and other structured 166 values (<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a>s, <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s).</div> 167</td> 168</tr> 169<tr class="altColor"> 170<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ACCEPT_FLOAT_AS_INT">ACCEPT_FLOAT_AS_INT</a></span></code> 171<div class="block">Feature that determines whether coercion from JSON floating point 172 number (anything with command (`.`) or exponent portion (`e` / `E')) 173 to an expected integral number (`int`, `long`, `java.lang.Integer`, `java.lang.Long`, 174 `java.math.BigDecimal`) is allowed or not.</div> 175</td> 176</tr> 177<tr class="rowColor"> 178<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ACCEPT_SINGLE_VALUE_AS_ARRAY">ACCEPT_SINGLE_VALUE_AS_ARRAY</a></span></code> 179<div class="block">Feature that determines whether it is acceptable to coerce non-array 180 (in JSON) values to work with Java collection (arrays, java.util.Collection) 181 types.</div> 182</td> 183</tr> 184<tr class="altColor"> 185<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ADJUST_DATES_TO_CONTEXT_TIME_ZONE">ADJUST_DATES_TO_CONTEXT_TIME_ZONE</a></span></code> 186<div class="block">Feature that specifies whether context provided <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util"><code>TimeZone</code></a> 187 (<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html#getTimeZone--"><code>DeserializationContext.getTimeZone()</code></a> should be used to adjust Date/Time 188 values on deserialization, even if value itself contains timezone information.</div> 189</td> 190</tr> 191<tr class="rowColor"> 192<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#EAGER_DESERIALIZER_FETCH">EAGER_DESERIALIZER_FETCH</a></span></code> 193<div class="block">Feature that determines whether <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a> should 194 try to eagerly fetch necessary <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><code>JsonDeserializer</code></a> when 195 possible.</div> 196</td> 197</tr> 198<tr class="altColor"> 199<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_IGNORED_PROPERTIES">FAIL_ON_IGNORED_PROPERTIES</a></span></code> 200<div class="block">Feature that determines what happens when a property that has been explicitly 201 marked as ignorable is encountered in input: if feature is enabled, 202 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> is thrown; if false, property is quietly skipped.</div> 203</td> 204</tr> 205<tr class="rowColor"> 206<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_INVALID_SUBTYPE">FAIL_ON_INVALID_SUBTYPE</a></span></code> 207<div class="block">Feature that determines what happens when type of a polymorphic 208 value (indicated for example by <a href="http://fasterxml.github.io/jackson-annotations/javadoc/2.11/com/fasterxml/jackson/annotation/JsonTypeInfo.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonTypeInfo</code></a>) 209 cannot be found (missing) or resolved (invalid class name, unmappable id); 210 if enabled, an exception ir thrown; if false, null value is used instead.</div> 211</td> 212</tr> 213<tr class="altColor"> 214<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_MISSING_CREATOR_PROPERTIES">FAIL_ON_MISSING_CREATOR_PROPERTIES</a></span></code> 215<div class="block">Feature that determines what happens if one or more Creator properties (properties 216 bound to parameters of Creator method (constructor or static factory method)) 217 are missing value to bind to from content.</div> 218</td> 219</tr> 220<tr class="rowColor"> 221<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY">FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY</a></span></code> 222<div class="block">Feature that determines what happens when a property annotated with 223 <a href="http://fasterxml.github.io/jackson-annotations/javadoc/2.11/com/fasterxml/jackson/annotation/JsonTypeInfo.As.html?is-external=true#EXTERNAL_PROPERTY" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonTypeInfo.As.EXTERNAL_PROPERTY</code></a> is missing, 224 but associated type id is available.</div> 225</td> 226</tr> 227<tr class="altColor"> 228<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_NULL_CREATOR_PROPERTIES">FAIL_ON_NULL_CREATOR_PROPERTIES</a></span></code> 229<div class="block">Feature that determines what happens if one or more Creator properties (properties 230 bound to parameters of Creator method (constructor or static factory method)) 231 are bound to null values - either from the JSON or as a default value.</div> 232</td> 233</tr> 234<tr class="rowColor"> 235<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_NULL_FOR_PRIMITIVES">FAIL_ON_NULL_FOR_PRIMITIVES</a></span></code> 236<div class="block">Feature that determines whether encountering of JSON null 237 is an error when deserializing into Java primitive types 238 (like 'int' or 'double').</div> 239</td> 240</tr> 241<tr class="altColor"> 242<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_NUMBERS_FOR_ENUMS">FAIL_ON_NUMBERS_FOR_ENUMS</a></span></code> 243<div class="block">Feature that determines whether JSON integer numbers are valid 244 values to be used for deserializing Java enum values.</div> 245</td> 246</tr> 247<tr class="rowColor"> 248<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_READING_DUP_TREE_KEY">FAIL_ON_READING_DUP_TREE_KEY</a></span></code> 249<div class="block">Feature that determines what happens when reading JSON content into tree 250 (<a href="http://fasterxml.github.io/jackson-core/javadoc/2.11/com/fasterxml/jackson/core/TreeNode.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>TreeNode</code></a>) and a duplicate key 251 is encountered (property name that was already seen for the JSON Object).</div> 252</td> 253</tr> 254<tr class="altColor"> 255<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_TRAILING_TOKENS">FAIL_ON_TRAILING_TOKENS</a></span></code> 256<div class="block">Feature that determines behaviour for data-binding after binding the root value.</div> 257</td> 258</tr> 259<tr class="rowColor"> 260<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_UNKNOWN_PROPERTIES">FAIL_ON_UNKNOWN_PROPERTIES</a></span></code> 261<div class="block">Feature that determines whether encountering of unknown 262 properties (ones that do not map to a property, and there is 263 no "any setter" or handler that can handle it) 264 should result in a failure (by throwing a 265 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a>) or not.</div> 266</td> 267</tr> 268<tr class="altColor"> 269<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#FAIL_ON_UNRESOLVED_OBJECT_IDS">FAIL_ON_UNRESOLVED_OBJECT_IDS</a></span></code> 270<div class="block">Feature that determines what happens if an Object Id reference is encountered 271 that does not refer to an actual Object with that id ("unresolved Object Id"): 272 either an exception is thrown (<code>true</code>), or a null object is used 273 instead (<code>false</code>).</div> 274</td> 275</tr> 276<tr class="rowColor"> 277<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#READ_DATE_TIMESTAMPS_AS_NANOSECONDS">READ_DATE_TIMESTAMPS_AS_NANOSECONDS</a></span></code> 278<div class="block">Feature that controls whether numeric timestamp values are expected 279 to be written using nanosecond timestamps (enabled) or not (disabled), 280 <b>if and only if</b> datatype supports such resolution.</div> 281</td> 282</tr> 283<tr class="altColor"> 284<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#READ_ENUMS_USING_TO_STRING">READ_ENUMS_USING_TO_STRING</a></span></code> 285<div class="block">Feature that determines standard deserialization mechanism used for 286 Enum values: if enabled, Enums are assumed to have been serialized using 287 return value of <code>Enum.toString()</code>; 288 if disabled, return value of <code>Enum.name()</code> is assumed to have been used.</div> 289</td> 290</tr> 291<tr class="rowColor"> 292<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#READ_UNKNOWN_ENUM_VALUES_AS_NULL">READ_UNKNOWN_ENUM_VALUES_AS_NULL</a></span></code> 293<div class="block">Feature that allows unknown Enum values to be parsed as null values.</div> 294</td> 295</tr> 296<tr class="altColor"> 297<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE">READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE</a></span></code> 298<div class="block">Feature that allows unknown Enum values to be ignored and a predefined value specified through 299 <a href="http://fasterxml.github.io/jackson-annotations/javadoc/2.11/com/fasterxml/jackson/annotation/JsonEnumDefaultValue.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>@JsonEnumDefaultValue</code></a> annotation.</div> 300</td> 301</tr> 302<tr class="rowColor"> 303<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#UNWRAP_ROOT_VALUE">UNWRAP_ROOT_VALUE</a></span></code> 304<div class="block">Feature to allow "unwrapping" root-level JSON value, to match setting of 305 <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_ROOT_VALUE"><code>SerializationFeature.WRAP_ROOT_VALUE</code></a> used for serialization.</div> 306</td> 307</tr> 308<tr class="altColor"> 309<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#UNWRAP_SINGLE_VALUE_ARRAYS">UNWRAP_SINGLE_VALUE_ARRAYS</a></span></code> 310<div class="block">Feature that determines whether it is acceptable to coerce single value array (in JSON) 311 values to the corresponding value type.</div> 312</td> 313</tr> 314<tr class="rowColor"> 315<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#USE_BIG_DECIMAL_FOR_FLOATS">USE_BIG_DECIMAL_FOR_FLOATS</a></span></code> 316<div class="block">Feature that determines whether JSON floating point numbers 317 are to be deserialized into <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a>s 318 if only generic type description (either <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 319 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a>, or within untyped <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 320 or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available.</div> 321</td> 322</tr> 323<tr class="altColor"> 324<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#USE_BIG_INTEGER_FOR_INTS">USE_BIG_INTEGER_FOR_INTS</a></span></code> 325<div class="block">Feature that determines whether JSON integral (non-floating-point) 326 numbers are to be deserialized into <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s 327 if only generic type description (either <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 328 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a>, or within untyped <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 329 or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available.</div> 330</td> 331</tr> 332<tr class="rowColor"> 333<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#USE_JAVA_ARRAY_FOR_JSON_ARRAY">USE_JAVA_ARRAY_FOR_JSON_ARRAY</a></span></code> 334<div class="block">Feature that determines whether JSON Array is mapped to 335 <code>Object[]</code> or <code>List<Object></code> when binding 336 "untyped" objects (ones with nominal type of <code>java.lang.Object</code>).</div> 337</td> 338</tr> 339<tr class="altColor"> 340<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#USE_LONG_FOR_INTS">USE_LONG_FOR_INTS</a></span></code> 341<div class="block">Feature that determines how "small" JSON integral (non-floating-point) 342 numbers -- ones that fit in 32-bit signed integer (`int`) -- are bound 343 when target type is loosely typed as <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> 344 (or within untyped <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context).</div> 345</td> 346</tr> 347<tr class="rowColor"> 348<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#WRAP_EXCEPTIONS">WRAP_EXCEPTIONS</a></span></code> 349<div class="block">Feature that determines whether Jackson code should catch 350 and wrap <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang"><code>Exception</code></a>s (but never <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 351 to add additional information about 352 location (within input) of problem or not.</div> 353</td> 354</tr> 355</table> 356</li> 357</ul> 358<!-- ========== METHOD SUMMARY =========== --> 359<ul class="blockList"> 360<li class="blockList"><a name="method.summary"> 361<!-- --> 362</a> 363<h3>Method Summary</h3> 364<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 365<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span></caption> 366<tr> 367<th class="colFirst" scope="col">Modifier and Type</th> 368<th class="colLast" scope="col">Method and Description</th> 369</tr> 370<tr id="i0" class="altColor"> 371<td class="colFirst"><code>boolean</code></td> 372<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#enabledByDefault--">enabledByDefault</a></span>()</code> 373<div class="block">Accessor for checking whether this feature is enabled by default.</div> 374</td> 375</tr> 376<tr id="i1" class="rowColor"> 377<td class="colFirst"><code>boolean</code></td> 378<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#enabledIn-int-">enabledIn</a></span>(int flags)</code> 379<div class="block">Convenience method for checking whether feature is enabled in given bitmask</div> 380</td> 381</tr> 382<tr id="i2" class="altColor"> 383<td class="colFirst"><code>int</code></td> 384<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#getMask--">getMask</a></span>()</code> 385<div class="block">Returns bit mask for this feature instance</div> 386</td> 387</tr> 388<tr id="i3" class="rowColor"> 389<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a></code></td> 390<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#valueOf-java.lang.String-">valueOf</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</code> 391<div class="block">Returns the enum constant of this type with the specified name.</div> 392</td> 393</tr> 394<tr id="i4" class="altColor"> 395<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>[]</code></td> 396<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#values--">values</a></span>()</code> 397<div class="block">Returns an array containing the constants of this enum type, in 398the order they are declared.</div> 399</td> 400</tr> 401</table> 402<ul class="blockList"> 403<li class="blockList"><a name="methods.inherited.from.class.java.lang.Enum"> 404<!-- --> 405</a> 406<h3>Methods inherited from class java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">Enum</a></h3> 407<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#compareTo-E-" title="class or interface in java.lang">compareTo</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#getDeclaringClass--" title="class or interface in java.lang">getDeclaringClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#name--" title="class or interface in java.lang">name</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#ordinal--" title="class or interface in java.lang">ordinal</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true#valueOf-java.lang.Class-java.lang.String-" title="class or interface in java.lang">valueOf</a></code></li> 408</ul> 409<ul class="blockList"> 410<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object"> 411<!-- --> 412</a> 413<h3>Methods inherited from class java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3> 414<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li> 415</ul> 416</li> 417</ul> 418</li> 419</ul> 420</div> 421<div class="details"> 422<ul class="blockList"> 423<li class="blockList"> 424<!-- ============ ENUM CONSTANT DETAIL =========== --> 425<ul class="blockList"> 426<li class="blockList"><a name="enum.constant.detail"> 427<!-- --> 428</a> 429<h3>Enum Constant Detail</h3> 430<a name="USE_BIG_DECIMAL_FOR_FLOATS"> 431<!-- --> 432</a> 433<ul class="blockList"> 434<li class="blockList"> 435<h4>USE_BIG_DECIMAL_FOR_FLOATS</h4> 436<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> USE_BIG_DECIMAL_FOR_FLOATS</pre> 437<div class="block">Feature that determines whether JSON floating point numbers 438 are to be deserialized into <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a>s 439 if only generic type description (either <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 440 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a>, or within untyped <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 441 or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available. 442 If enabled such values will be deserialized as <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a>s; 443 if disabled, will be deserialized as <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang"><code>Double</code></a>s. 444<p> 445 NOTE: one aspect of <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a> handling that may need 446 configuring is whether trailing zeroes are trimmed: 447 <a href="../../../../com/fasterxml/jackson/databind/node/JsonNodeFactory.html" title="class in com.fasterxml.jackson.databind.node"><code>JsonNodeFactory</code></a> has 448 <a href="../../../../com/fasterxml/jackson/databind/node/JsonNodeFactory.html#withExactBigDecimals-boolean-"><code>JsonNodeFactory.withExactBigDecimals(boolean)</code></a> for 449 changing default behavior (default is for trailing zeroes to be trimmed). 450<p> 451 Feature is disabled by default, meaning that "untyped" floating 452 point numbers will by default be deserialized as <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang"><code>Double</code></a>s 453 (choice is for performance reason -- BigDecimals are slower than 454 Doubles).</div> 455</li> 456</ul> 457<a name="USE_BIG_INTEGER_FOR_INTS"> 458<!-- --> 459</a> 460<ul class="blockList"> 461<li class="blockList"> 462<h4>USE_BIG_INTEGER_FOR_INTS</h4> 463<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> USE_BIG_INTEGER_FOR_INTS</pre> 464<div class="block">Feature that determines whether JSON integral (non-floating-point) 465 numbers are to be deserialized into <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s 466 if only generic type description (either <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 467 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a>, or within untyped <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 468 or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available. 469 If enabled such values will be deserialized as 470 <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s; 471 if disabled, will be deserialized as "smallest" available type, 472 which is either <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a> or 473 <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>, depending on number of digits. 474 <p> 475 Feature is disabled by default, meaning that "untyped" integral 476 numbers will by default be deserialized using whatever 477 is the most compact integral type, to optimize efficiency.</div> 478</li> 479</ul> 480<a name="USE_LONG_FOR_INTS"> 481<!-- --> 482</a> 483<ul class="blockList"> 484<li class="blockList"> 485<h4>USE_LONG_FOR_INTS</h4> 486<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> USE_LONG_FOR_INTS</pre> 487<div class="block">Feature that determines how "small" JSON integral (non-floating-point) 488 numbers -- ones that fit in 32-bit signed integer (`int`) -- are bound 489 when target type is loosely typed as <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> 490 (or within untyped <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context). 491 If enabled, such values will be deserialized as <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a>; 492 if disabled, they will be deserialized as "smallest" available type, 493 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a>. 494 In addition, if enabled, trying to bind values that do not fit in <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a> 495 will throw a <a href="http://fasterxml.github.io/jackson-core/javadoc/2.11/com/fasterxml/jackson/core/JsonProcessingException.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonProcessingException</code></a>. 496<p> 497 Note: if <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#USE_BIG_INTEGER_FOR_INTS"><code>USE_BIG_INTEGER_FOR_INTS</code></a> is enabled, it has precedence 498 over this setting, forcing use of <a href="https://docs.oracle.com/javase/8/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a> for all 499 integral values. 500<p> 501 Feature is disabled by default, meaning that "untyped" integral 502 numbers will by default be deserialized using <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a> 503 if value fits.</div> 504<dl> 505<dt><span class="simpleTagLabel">Since:</span></dt> 506<dd>2.6</dd> 507</dl> 508</li> 509</ul> 510<a name="USE_JAVA_ARRAY_FOR_JSON_ARRAY"> 511<!-- --> 512</a> 513<ul class="blockList"> 514<li class="blockList"> 515<h4>USE_JAVA_ARRAY_FOR_JSON_ARRAY</h4> 516<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> USE_JAVA_ARRAY_FOR_JSON_ARRAY</pre> 517<div class="block">Feature that determines whether JSON Array is mapped to 518 <code>Object[]</code> or <code>List<Object></code> when binding 519 "untyped" objects (ones with nominal type of <code>java.lang.Object</code>). 520 If true, binds as <code>Object[]</code>; if false, as <code>List<Object></code>. 521<p> 522 Feature is disabled by default, meaning that JSON arrays are bound as 523 <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util"><code>List</code></a>s.</div> 524</li> 525</ul> 526<a name="FAIL_ON_UNKNOWN_PROPERTIES"> 527<!-- --> 528</a> 529<ul class="blockList"> 530<li class="blockList"> 531<h4>FAIL_ON_UNKNOWN_PROPERTIES</h4> 532<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_UNKNOWN_PROPERTIES</pre> 533<div class="block">Feature that determines whether encountering of unknown 534 properties (ones that do not map to a property, and there is 535 no "any setter" or handler that can handle it) 536 should result in a failure (by throwing a 537 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a>) or not. 538 This setting only takes effect after all other handling 539 methods for unknown properties have been tried, and 540 property remains unhandled. 541<p> 542 Feature is enabled by default (meaning that a 543 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> will be thrown if an unknown property 544 is encountered).</div> 545</li> 546</ul> 547<a name="FAIL_ON_NULL_FOR_PRIMITIVES"> 548<!-- --> 549</a> 550<ul class="blockList"> 551<li class="blockList"> 552<h4>FAIL_ON_NULL_FOR_PRIMITIVES</h4> 553<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_NULL_FOR_PRIMITIVES</pre> 554<div class="block">Feature that determines whether encountering of JSON null 555 is an error when deserializing into Java primitive types 556 (like 'int' or 'double'). If it is, a JsonProcessingException 557 is thrown to indicate this; if not, default value is used 558 (0 for 'int', 0.0 for double, same defaulting as what JVM uses). 559<p> 560 Feature is disabled by default.</div> 561</li> 562</ul> 563<a name="FAIL_ON_NUMBERS_FOR_ENUMS"> 564<!-- --> 565</a> 566<ul class="blockList"> 567<li class="blockList"> 568<h4>FAIL_ON_NUMBERS_FOR_ENUMS</h4> 569<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_NUMBERS_FOR_ENUMS</pre> 570<div class="block">Feature that determines whether JSON integer numbers are valid 571 values to be used for deserializing Java enum values. 572 If set to 'false' numbers are acceptable and are used to map to 573 ordinal() of matching enumeration value; if 'true', numbers are 574 not allowed and a <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> will be thrown. 575 Latter behavior makes sense if there is concern that accidental 576 mapping from integer values to enums might happen (and when enums 577 are always serialized as JSON Strings) 578<p> 579 Feature is disabled by default.</div> 580</li> 581</ul> 582<a name="FAIL_ON_INVALID_SUBTYPE"> 583<!-- --> 584</a> 585<ul class="blockList"> 586<li class="blockList"> 587<h4>FAIL_ON_INVALID_SUBTYPE</h4> 588<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_INVALID_SUBTYPE</pre> 589<div class="block">Feature that determines what happens when type of a polymorphic 590 value (indicated for example by <a href="http://fasterxml.github.io/jackson-annotations/javadoc/2.11/com/fasterxml/jackson/annotation/JsonTypeInfo.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonTypeInfo</code></a>) 591 cannot be found (missing) or resolved (invalid class name, unmappable id); 592 if enabled, an exception ir thrown; if false, null value is used instead. 593<p> 594 Feature is enabled by default so that exception is thrown for missing or invalid 595 type information.</div> 596<dl> 597<dt><span class="simpleTagLabel">Since:</span></dt> 598<dd>2.2</dd> 599</dl> 600</li> 601</ul> 602<a name="FAIL_ON_READING_DUP_TREE_KEY"> 603<!-- --> 604</a> 605<ul class="blockList"> 606<li class="blockList"> 607<h4>FAIL_ON_READING_DUP_TREE_KEY</h4> 608<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_READING_DUP_TREE_KEY</pre> 609<div class="block">Feature that determines what happens when reading JSON content into tree 610 (<a href="http://fasterxml.github.io/jackson-core/javadoc/2.11/com/fasterxml/jackson/core/TreeNode.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>TreeNode</code></a>) and a duplicate key 611 is encountered (property name that was already seen for the JSON Object). 612 If enabled, <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> will be thrown; if disabled, no exception 613 is thrown and the new (later) value overwrites the earlier value. 614<p> 615 Note that this property does NOT affect other aspects of data-binding; that is, 616 no detection is done with respect to POJO properties or <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 617 keys. New features may be added to control additional cases. 618<p> 619 Feature is disabled by default so that no exception is thrown.</div> 620<dl> 621<dt><span class="simpleTagLabel">Since:</span></dt> 622<dd>2.3</dd> 623</dl> 624</li> 625</ul> 626<a name="FAIL_ON_IGNORED_PROPERTIES"> 627<!-- --> 628</a> 629<ul class="blockList"> 630<li class="blockList"> 631<h4>FAIL_ON_IGNORED_PROPERTIES</h4> 632<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_IGNORED_PROPERTIES</pre> 633<div class="block">Feature that determines what happens when a property that has been explicitly 634 marked as ignorable is encountered in input: if feature is enabled, 635 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> is thrown; if false, property is quietly skipped. 636<p> 637 Feature is disabled by default so that no exception is thrown.</div> 638<dl> 639<dt><span class="simpleTagLabel">Since:</span></dt> 640<dd>2.3</dd> 641</dl> 642</li> 643</ul> 644<a name="FAIL_ON_UNRESOLVED_OBJECT_IDS"> 645<!-- --> 646</a> 647<ul class="blockList"> 648<li class="blockList"> 649<h4>FAIL_ON_UNRESOLVED_OBJECT_IDS</h4> 650<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_UNRESOLVED_OBJECT_IDS</pre> 651<div class="block">Feature that determines what happens if an Object Id reference is encountered 652 that does not refer to an actual Object with that id ("unresolved Object Id"): 653 either an exception is thrown (<code>true</code>), or a null object is used 654 instead (<code>false</code>). 655 Note that if this is set to <code>false</code>, no further processing is done; 656 specifically, if reference is defined via setter method, that method will NOT 657 be called. 658<p> 659 Feature is enabled by default, so that unknown Object Ids will result in an 660 exception being thrown, at the end of deserialization.</div> 661<dl> 662<dt><span class="simpleTagLabel">Since:</span></dt> 663<dd>2.5</dd> 664</dl> 665</li> 666</ul> 667<a name="FAIL_ON_MISSING_CREATOR_PROPERTIES"> 668<!-- --> 669</a> 670<ul class="blockList"> 671<li class="blockList"> 672<h4>FAIL_ON_MISSING_CREATOR_PROPERTIES</h4> 673<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_MISSING_CREATOR_PROPERTIES</pre> 674<div class="block">Feature that determines what happens if one or more Creator properties (properties 675 bound to parameters of Creator method (constructor or static factory method)) 676 are missing value to bind to from content. 677 If enabled, such missing values result in a <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> being 678 thrown with information on the first one (by index) of missing properties. 679 If disabled, and if property is NOT marked as required, 680 missing Creator properties are filled 681 with <code>null values</code> provided by deserializer for the type of parameter 682 (usually null for Object types, and default value for primitives; but redefinable 683 via custom deserializers). 684<p> 685 Note that having an injectable value counts as "not missing". 686<p> 687 Feature is disabled by default, so that no exception is thrown for missing creator 688 property values, unless they are explicitly marked as `required`.</div> 689<dl> 690<dt><span class="simpleTagLabel">Since:</span></dt> 691<dd>2.6</dd> 692</dl> 693</li> 694</ul> 695<a name="FAIL_ON_NULL_CREATOR_PROPERTIES"> 696<!-- --> 697</a> 698<ul class="blockList"> 699<li class="blockList"> 700<h4>FAIL_ON_NULL_CREATOR_PROPERTIES</h4> 701<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_NULL_CREATOR_PROPERTIES</pre> 702<div class="block">Feature that determines what happens if one or more Creator properties (properties 703 bound to parameters of Creator method (constructor or static factory method)) 704 are bound to null values - either from the JSON or as a default value. This 705 is useful if you want to avoid nulls in your codebase, and particularly useful 706 if you are using Java or Scala optionals for non-mandatory fields. 707 Feature is disabled by default, so that no exception is thrown for missing creator 708 property values, unless they are explicitly marked as `required`.</div> 709<dl> 710<dt><span class="simpleTagLabel">Since:</span></dt> 711<dd>2.8</dd> 712</dl> 713</li> 714</ul> 715<a name="FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY"> 716<!-- --> 717</a> 718<ul class="blockList"> 719<li class="blockList"> 720<h4>FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY</h4> 721<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY</pre> 722<div class="block">Feature that determines what happens when a property annotated with 723 <a href="http://fasterxml.github.io/jackson-annotations/javadoc/2.11/com/fasterxml/jackson/annotation/JsonTypeInfo.As.html?is-external=true#EXTERNAL_PROPERTY" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonTypeInfo.As.EXTERNAL_PROPERTY</code></a> is missing, 724 but associated type id is available. If enabled, <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> is always 725 thrown when property value is missing (if type id does exist); 726 if disabled, exception is only thrown if property is marked as `required`. 727<p> 728 Feature is enabled by default, so that exception is thrown when a subtype property is 729 missing.</div> 730<dl> 731<dt><span class="simpleTagLabel">Since:</span></dt> 732<dd>2.9</dd> 733</dl> 734</li> 735</ul> 736<a name="FAIL_ON_TRAILING_TOKENS"> 737<!-- --> 738</a> 739<ul class="blockList"> 740<li class="blockList"> 741<h4>FAIL_ON_TRAILING_TOKENS</h4> 742<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> FAIL_ON_TRAILING_TOKENS</pre> 743<div class="block">Feature that determines behaviour for data-binding after binding the root value. 744 If feature is enabled, one more call to 745 <a href="http://fasterxml.github.io/jackson-core/javadoc/2.11/com/fasterxml/jackson/core/JsonParser.html?is-external=true#nextToken--" title="class or interface in com.fasterxml.jackson.core"><code>JsonParser.nextToken()</code></a> is made to ensure that 746 no more tokens are found (and if any is found, 747 <a href="../../../../com/fasterxml/jackson/databind/exc/MismatchedInputException.html" title="class in com.fasterxml.jackson.databind.exc"><code>MismatchedInputException</code></a> is thrown); if 748 disabled, no further checks are made. 749<p> 750 Feature could alternatively be called <code>READ_FULL_STREAM</code>, since it 751 effectively verifies that input stream contains only as much data as is needed 752 for binding the full value, and nothing more (except for possible ignorable 753 white space or comments, if supported by data format). 754<p> 755 Feature is disabled by default (so that no check is made for possible trailing 756 token(s)) for backwards compatibility reasons.</div> 757<dl> 758<dt><span class="simpleTagLabel">Since:</span></dt> 759<dd>2.9</dd> 760</dl> 761</li> 762</ul> 763<a name="WRAP_EXCEPTIONS"> 764<!-- --> 765</a> 766<ul class="blockList"> 767<li class="blockList"> 768<h4>WRAP_EXCEPTIONS</h4> 769<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> WRAP_EXCEPTIONS</pre> 770<div class="block">Feature that determines whether Jackson code should catch 771 and wrap <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang"><code>Exception</code></a>s (but never <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 772 to add additional information about 773 location (within input) of problem or not. If enabled, 774 most exceptions will be caught and re-thrown (exception 775 specifically being that <a href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a>s may be passed 776 as is, since they are declared as throwable); this can be 777 convenient both in that all exceptions will be checked and 778 declared, and so there is more contextual information. 779 However, sometimes calling application may just want "raw" 780 unchecked exceptions passed as is. 781<p> 782 Feature is enabled by default.</div> 783</li> 784</ul> 785<a name="ACCEPT_SINGLE_VALUE_AS_ARRAY"> 786<!-- --> 787</a> 788<ul class="blockList"> 789<li class="blockList"> 790<h4>ACCEPT_SINGLE_VALUE_AS_ARRAY</h4> 791<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> ACCEPT_SINGLE_VALUE_AS_ARRAY</pre> 792<div class="block">Feature that determines whether it is acceptable to coerce non-array 793 (in JSON) values to work with Java collection (arrays, java.util.Collection) 794 types. If enabled, collection deserializers will try to handle non-array 795 values as if they had "implicit" surrounding JSON array. 796 This feature is meant to be used for compatibility/interoperability reasons, 797 to work with packages (such as XML-to-JSON converters) that leave out JSON 798 array in cases where there is just a single element in array. 799<p> 800 Feature is disabled by default.</div> 801</li> 802</ul> 803<a name="UNWRAP_SINGLE_VALUE_ARRAYS"> 804<!-- --> 805</a> 806<ul class="blockList"> 807<li class="blockList"> 808<h4>UNWRAP_SINGLE_VALUE_ARRAYS</h4> 809<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> UNWRAP_SINGLE_VALUE_ARRAYS</pre> 810<div class="block">Feature that determines whether it is acceptable to coerce single value array (in JSON) 811 values to the corresponding value type. This is basically the opposite of the <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ACCEPT_SINGLE_VALUE_AS_ARRAY"><code>ACCEPT_SINGLE_VALUE_AS_ARRAY</code></a> 812 feature. If more than one value is found in the array, a JsonMappingException is thrown. 813 <p> 814 815 Feature is disabled by default</div> 816<dl> 817<dt><span class="simpleTagLabel">Since:</span></dt> 818<dd>2.4</dd> 819</dl> 820</li> 821</ul> 822<a name="UNWRAP_ROOT_VALUE"> 823<!-- --> 824</a> 825<ul class="blockList"> 826<li class="blockList"> 827<h4>UNWRAP_ROOT_VALUE</h4> 828<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> UNWRAP_ROOT_VALUE</pre> 829<div class="block">Feature to allow "unwrapping" root-level JSON value, to match setting of 830 <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_ROOT_VALUE"><code>SerializationFeature.WRAP_ROOT_VALUE</code></a> used for serialization. 831 Will verify that the root JSON value is a JSON Object, and that it has 832 a single property with expected root name. If not, a 833 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> is thrown; otherwise value of the wrapped property 834 will be deserialized as if it was the root value. 835<p> 836 Feature is disabled by default.</div> 837</li> 838</ul> 839<a name="ACCEPT_EMPTY_STRING_AS_NULL_OBJECT"> 840<!-- --> 841</a> 842<ul class="blockList"> 843<li class="blockList"> 844<h4>ACCEPT_EMPTY_STRING_AS_NULL_OBJECT</h4> 845<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> ACCEPT_EMPTY_STRING_AS_NULL_OBJECT</pre> 846<div class="block">Feature that can be enabled to allow JSON empty String 847 value ("") to be bound as `null` for POJOs and other structured 848 values (<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a>s, <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s). 849 If disabled, standard POJOs can only be bound from JSON `null` or 850 JSON Object (standard meaning that no custom deserializers or 851 constructors are defined; both of which can add support for other 852 kinds of JSON values); if enabled, empty JSON String can be taken 853 to be equivalent of JSON null. 854<p> 855 NOTE: this does NOT apply to scalar values such as booleans and numbers; 856 whether they can be coerced depends on 857 <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#ALLOW_COERCION_OF_SCALARS"><code>MapperFeature.ALLOW_COERCION_OF_SCALARS</code></a>. 858<p> 859 Feature is disabled by default.</div> 860</li> 861</ul> 862<a name="ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT"> 863<!-- --> 864</a> 865<ul class="blockList"> 866<li class="blockList"> 867<h4>ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT</h4> 868<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT</pre> 869<div class="block">Feature that can be enabled to allow empty JSON Array 870 value (that is, <code>[ ]</code>) to be bound to POJOs (and 871 with 2.9, other values too) as `null`. 872 If disabled, standard POJOs can only be bound from JSON `null` or 873 JSON Object (standard meaning that no custom deserializers or 874 constructors are defined; both of which can add support for other 875 kinds of JSON values); if enabled, empty JSON Array will be taken 876 to be equivalent of JSON null. 877<p> 878 Feature is disabled by default.</div> 879<dl> 880<dt><span class="simpleTagLabel">Since:</span></dt> 881<dd>2.5</dd> 882</dl> 883</li> 884</ul> 885<a name="ACCEPT_FLOAT_AS_INT"> 886<!-- --> 887</a> 888<ul class="blockList"> 889<li class="blockList"> 890<h4>ACCEPT_FLOAT_AS_INT</h4> 891<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> ACCEPT_FLOAT_AS_INT</pre> 892<div class="block">Feature that determines whether coercion from JSON floating point 893 number (anything with command (`.`) or exponent portion (`e` / `E')) 894 to an expected integral number (`int`, `long`, `java.lang.Integer`, `java.lang.Long`, 895 `java.math.BigDecimal`) is allowed or not. 896 If enabled, coercion truncates value; if disabled, a <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> 897 will be thrown. 898<p> 899 Feature is enabled by default.</div> 900<dl> 901<dt><span class="simpleTagLabel">Since:</span></dt> 902<dd>2.6</dd> 903</dl> 904</li> 905</ul> 906<a name="READ_ENUMS_USING_TO_STRING"> 907<!-- --> 908</a> 909<ul class="blockList"> 910<li class="blockList"> 911<h4>READ_ENUMS_USING_TO_STRING</h4> 912<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> READ_ENUMS_USING_TO_STRING</pre> 913<div class="block">Feature that determines standard deserialization mechanism used for 914 Enum values: if enabled, Enums are assumed to have been serialized using 915 return value of <code>Enum.toString()</code>; 916 if disabled, return value of <code>Enum.name()</code> is assumed to have been used. 917<p> 918 Note: this feature should usually have same value 919 as <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_ENUMS_USING_TO_STRING"><code>SerializationFeature.WRITE_ENUMS_USING_TO_STRING</code></a>. 920<p> 921 Feature is disabled by default.</div> 922</li> 923</ul> 924<a name="READ_UNKNOWN_ENUM_VALUES_AS_NULL"> 925<!-- --> 926</a> 927<ul class="blockList"> 928<li class="blockList"> 929<h4>READ_UNKNOWN_ENUM_VALUES_AS_NULL</h4> 930<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> READ_UNKNOWN_ENUM_VALUES_AS_NULL</pre> 931<div class="block">Feature that allows unknown Enum values to be parsed as null values. 932 If disabled, unknown Enum values will throw exceptions. 933<p> 934 Note that in some cases this will basically ignore unknown Enum values; 935 this is the keys for keys of <a href="https://docs.oracle.com/javase/8/docs/api/java/util/EnumMap.html?is-external=true" title="class or interface in java.util"><code>EnumMap</code></a> and values 936 of <a href="https://docs.oracle.com/javase/8/docs/api/java/util/EnumSet.html?is-external=true" title="class or interface in java.util"><code>EnumSet</code></a> (because nulls are not accepted in these 937 cases). 938<p> 939 Feature is disabled by default.</div> 940<dl> 941<dt><span class="simpleTagLabel">Since:</span></dt> 942<dd>2.0</dd> 943</dl> 944</li> 945</ul> 946<a name="READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE"> 947<!-- --> 948</a> 949<ul class="blockList"> 950<li class="blockList"> 951<h4>READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE</h4> 952<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE</pre> 953<div class="block">Feature that allows unknown Enum values to be ignored and a predefined value specified through 954 <a href="http://fasterxml.github.io/jackson-annotations/javadoc/2.11/com/fasterxml/jackson/annotation/JsonEnumDefaultValue.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>@JsonEnumDefaultValue</code></a> annotation. 955 If disabled, unknown Enum values will throw exceptions. 956 If enabled, but no predefined default Enum value is specified, an exception will be thrown as well. 957<p> 958 Feature is disabled by default.</div> 959<dl> 960<dt><span class="simpleTagLabel">Since:</span></dt> 961<dd>2.8</dd> 962</dl> 963</li> 964</ul> 965<a name="READ_DATE_TIMESTAMPS_AS_NANOSECONDS"> 966<!-- --> 967</a> 968<ul class="blockList"> 969<li class="blockList"> 970<h4>READ_DATE_TIMESTAMPS_AS_NANOSECONDS</h4> 971<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> READ_DATE_TIMESTAMPS_AS_NANOSECONDS</pre> 972<div class="block">Feature that controls whether numeric timestamp values are expected 973 to be written using nanosecond timestamps (enabled) or not (disabled), 974 <b>if and only if</b> datatype supports such resolution. 975 Only newer datatypes (such as Java8 Date/Time) support such resolution -- 976 older types (pre-Java8 <b>java.util.Date</b> etc) and Joda do not -- 977 and this setting <b>has no effect</b> on such types. 978<p> 979 If disabled, standard millisecond timestamps are assumed. 980 This is the counterpart to <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS"><code>SerializationFeature.WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS</code></a>. 981<p> 982 Feature is enabled by default, to support most accurate time values possible.</div> 983<dl> 984<dt><span class="simpleTagLabel">Since:</span></dt> 985<dd>2.2</dd> 986</dl> 987</li> 988</ul> 989<a name="ADJUST_DATES_TO_CONTEXT_TIME_ZONE"> 990<!-- --> 991</a> 992<ul class="blockList"> 993<li class="blockList"> 994<h4>ADJUST_DATES_TO_CONTEXT_TIME_ZONE</h4> 995<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> ADJUST_DATES_TO_CONTEXT_TIME_ZONE</pre> 996<div class="block">Feature that specifies whether context provided <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util"><code>TimeZone</code></a> 997 (<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html#getTimeZone--"><code>DeserializationContext.getTimeZone()</code></a> should be used to adjust Date/Time 998 values on deserialization, even if value itself contains timezone information. 999 If enabled, contextual <code>TimeZone</code> will essentially override any other 1000 TimeZone information; if disabled, it will only be used if value itself does not 1001 contain any TimeZone information. 1002<p> 1003 Note that exact behavior depends on date/time types in question; and specifically 1004 JDK type of <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true" title="class or interface in java.util"><code>Date</code></a> does NOT have in-built timezone information 1005 so this setting has no effect. 1006 Further, while <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html?is-external=true" title="class or interface in java.util"><code>Calendar</code></a> does have this information basic 1007 JDK <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text"><code>SimpleDateFormat</code></a> is unable to retain parsed zone information, 1008 and as a result, <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html?is-external=true" title="class or interface in java.util"><code>Calendar</code></a> will always get context timezone 1009 adjustment regardless of this setting. 1010<p> 1011<p> 1012 Taking above into account, this feature is supported only by extension modules for 1013 Joda and Java 8 date/tyime datatypes.</div> 1014<dl> 1015<dt><span class="simpleTagLabel">Since:</span></dt> 1016<dd>2.2</dd> 1017</dl> 1018</li> 1019</ul> 1020<a name="EAGER_DESERIALIZER_FETCH"> 1021<!-- --> 1022</a> 1023<ul class="blockListLast"> 1024<li class="blockList"> 1025<h4>EAGER_DESERIALIZER_FETCH</h4> 1026<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> EAGER_DESERIALIZER_FETCH</pre> 1027<div class="block">Feature that determines whether <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a> should 1028 try to eagerly fetch necessary <a href="../../../../com/fasterxml/jackson/databind/JsonDeserializer.html" title="class in com.fasterxml.jackson.databind"><code>JsonDeserializer</code></a> when 1029 possible. This improves performance in cases where similarly 1030 configured <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a> instance is used multiple 1031 times; and should not significantly affect single-use cases. 1032<p> 1033 Note that there should not be any need to normally disable this 1034 feature: only consider that if there are actual perceived problems. 1035<p> 1036 Feature is enabled by default.</div> 1037<dl> 1038<dt><span class="simpleTagLabel">Since:</span></dt> 1039<dd>2.1</dd> 1040</dl> 1041</li> 1042</ul> 1043</li> 1044</ul> 1045<!-- ============ METHOD DETAIL ========== --> 1046<ul class="blockList"> 1047<li class="blockList"><a name="method.detail"> 1048<!-- --> 1049</a> 1050<h3>Method Detail</h3> 1051<a name="values--"> 1052<!-- --> 1053</a> 1054<ul class="blockList"> 1055<li class="blockList"> 1056<h4>values</h4> 1057<pre>public static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>[] values()</pre> 1058<div class="block">Returns an array containing the constants of this enum type, in 1059the order they are declared. This method may be used to iterate 1060over the constants as follows: 1061<pre> 1062for (DeserializationFeature c : DeserializationFeature.values()) 1063 System.out.println(c); 1064</pre></div> 1065<dl> 1066<dt><span class="returnLabel">Returns:</span></dt> 1067<dd>an array containing the constants of this enum type, in the order they are declared</dd> 1068</dl> 1069</li> 1070</ul> 1071<a name="valueOf-java.lang.String-"> 1072<!-- --> 1073</a> 1074<ul class="blockList"> 1075<li class="blockList"> 1076<h4>valueOf</h4> 1077<pre>public static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> valueOf(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</pre> 1078<div class="block">Returns the enum constant of this type with the specified name. 1079The string must match <i>exactly</i> an identifier used to declare an 1080enum constant in this type. (Extraneous whitespace characters are 1081not permitted.)</div> 1082<dl> 1083<dt><span class="paramLabel">Parameters:</span></dt> 1084<dd><code>name</code> - the name of the enum constant to be returned.</dd> 1085<dt><span class="returnLabel">Returns:</span></dt> 1086<dd>the enum constant with the specified name</dd> 1087<dt><span class="throwsLabel">Throws:</span></dt> 1088<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if this enum type has no constant with the specified name</dd> 1089<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the argument is null</dd> 1090</dl> 1091</li> 1092</ul> 1093<a name="enabledByDefault--"> 1094<!-- --> 1095</a> 1096<ul class="blockList"> 1097<li class="blockList"> 1098<h4>enabledByDefault</h4> 1099<pre>public boolean enabledByDefault()</pre> 1100<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#enabledByDefault--">ConfigFeature</a></code></span></div> 1101<div class="block">Accessor for checking whether this feature is enabled by default.</div> 1102<dl> 1103<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 1104<dd><code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#enabledByDefault--">enabledByDefault</a></code> in interface <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html" title="interface in com.fasterxml.jackson.databind.cfg">ConfigFeature</a></code></dd> 1105</dl> 1106</li> 1107</ul> 1108<a name="getMask--"> 1109<!-- --> 1110</a> 1111<ul class="blockList"> 1112<li class="blockList"> 1113<h4>getMask</h4> 1114<pre>public int getMask()</pre> 1115<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#getMask--">ConfigFeature</a></code></span></div> 1116<div class="block">Returns bit mask for this feature instance</div> 1117<dl> 1118<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 1119<dd><code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#getMask--">getMask</a></code> in interface <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html" title="interface in com.fasterxml.jackson.databind.cfg">ConfigFeature</a></code></dd> 1120</dl> 1121</li> 1122</ul> 1123<a name="enabledIn-int-"> 1124<!-- --> 1125</a> 1126<ul class="blockListLast"> 1127<li class="blockList"> 1128<h4>enabledIn</h4> 1129<pre>public boolean enabledIn(int flags)</pre> 1130<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#enabledIn-int-">ConfigFeature</a></code></span></div> 1131<div class="block">Convenience method for checking whether feature is enabled in given bitmask</div> 1132<dl> 1133<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 1134<dd><code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#enabledIn-int-">enabledIn</a></code> in interface <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html" title="interface in com.fasterxml.jackson.databind.cfg">ConfigFeature</a></code></dd> 1135</dl> 1136</li> 1137</ul> 1138</li> 1139</ul> 1140</li> 1141</ul> 1142</div> 1143</div> 1144<!-- ========= END OF CLASS DATA ========= --> 1145<!-- ======= START OF BOTTOM NAVBAR ====== --> 1146<div class="bottomNav"><a name="navbar.bottom"> 1147<!-- --> 1148</a> 1149<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> 1150<a name="navbar.bottom.firstrow"> 1151<!-- --> 1152</a> 1153<ul class="navList" title="Navigation"> 1154<li><a href="../../../../overview-summary.html">Overview</a></li> 1155<li><a href="package-summary.html">Package</a></li> 1156<li class="navBarCell1Rev">Class</li> 1157<li><a href="class-use/DeserializationFeature.html">Use</a></li> 1158<li><a href="package-tree.html">Tree</a></li> 1159<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 1160<li><a href="../../../../index-all.html">Index</a></li> 1161<li><a href="../../../../help-doc.html">Help</a></li> 1162</ul> 1163</div> 1164<div class="subNav"> 1165<ul class="navList"> 1166<li><a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Prev Class</span></a></li> 1167<li><a href="../../../../com/fasterxml/jackson/databind/InjectableValues.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Next Class</span></a></li> 1168</ul> 1169<ul class="navList"> 1170<li><a href="../../../../index.html?com/fasterxml/jackson/databind/DeserializationFeature.html" target="_top">Frames</a></li> 1171<li><a href="DeserializationFeature.html" target="_top">No Frames</a></li> 1172</ul> 1173<ul class="navList" id="allclasses_navbar_bottom"> 1174<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 1175</ul> 1176<div> 1177<script type="text/javascript"><!-- 1178 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 1179 if(window==top) { 1180 allClassesLink.style.display = "block"; 1181 } 1182 else { 1183 allClassesLink.style.display = "none"; 1184 } 1185 //--> 1186</script> 1187</div> 1188<div> 1189<ul class="subNavList"> 1190<li>Summary: </li> 1191<li>Nested | </li> 1192<li><a href="#enum.constant.summary">Enum Constants</a> | </li> 1193<li>Field | </li> 1194<li><a href="#method.summary">Method</a></li> 1195</ul> 1196<ul class="subNavList"> 1197<li>Detail: </li> 1198<li><a href="#enum.constant.detail">Enum Constants</a> | </li> 1199<li>Field | </li> 1200<li><a href="#method.detail">Method</a></li> 1201</ul> 1202</div> 1203<a name="skip.navbar.bottom"> 1204<!-- --> 1205</a></div> 1206<!-- ======== END OF BOTTOM NAVBAR ======= --> 1207<p class="legalCopy"><small>Copyright © 2008–2020 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 1208</body> 1209</html> 1210