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>DeserializationFeature (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="DeserializationFeature (jackson-databind 2.9.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="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><a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a>, <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a>s, <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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.com/jackson-annotations/javadoc/2.9/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.com/jackson-annotations/javadoc/2.9/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.com/jackson-core/javadoc/2.9/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.com/jackson-annotations/javadoc/2.9/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 319 <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 320 or <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 328 <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 329 or <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> or <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">Enum</a></h3> 407<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.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/Enum.html?is-external=true#compareTo-E-" title="class or interface in java.lang">compareTo</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.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/Enum.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/Enum.html?is-external=true#getDeclaringClass--" title="class or interface in java.lang">getDeclaringClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.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/Enum.html?is-external=true#name--" title="class or interface in java.lang">name</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.html?is-external=true#ordinal--" title="class or interface in java.lang">ordinal</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.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/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="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> 414<code><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#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#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> 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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 440 <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 441 or <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang"><code>Double</code></a>s. 444 <p> 445 Feature is disabled by default, meaning that "untyped" floating 446 point numbers will by default be deserialized as <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang"><code>Double</code></a>s 447 (choice is for performance reason -- BigDecimals are slower than 448 Doubles).</div> 449</li> 450</ul> 451<a name="USE_BIG_INTEGER_FOR_INTS"> 452<!-- --> 453</a> 454<ul class="blockList"> 455<li class="blockList"> 456<h4>USE_BIG_INTEGER_FOR_INTS</h4> 457<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> 458<div class="block">Feature that determines whether JSON integral (non-floating-point) 459 numbers are to be deserialized into <a href="http://docs.oracle.com/javase/7/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s 460 if only generic type description (either <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 461 <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 462 or <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available. 463 If enabled such values will be deserialized as 464 <a href="http://docs.oracle.com/javase/7/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s; 465 if disabled, will be deserialized as "smallest" available type, 466 which is either <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a> or 467 <a href="http://docs.oracle.com/javase/7/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. 468 <p> 469 Feature is disabled by default, meaning that "untyped" integral 470 numbers will by default be deserialized using whatever 471 is the most compact integral type, to optimize efficiency.</div> 472</li> 473</ul> 474<a name="USE_LONG_FOR_INTS"> 475<!-- --> 476</a> 477<ul class="blockList"> 478<li class="blockList"> 479<h4>USE_LONG_FOR_INTS</h4> 480<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> 481<div class="block">Feature that determines how "small" JSON integral (non-floating-point) 482 numbers -- ones that fit in 32-bit signed integer (`int`) -- are bound 483 when target type is loosely typed as <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> 484 (or within untyped <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> or <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context). 485 If enabled, such values will be deserialized as <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a>; 486 if disabled, they will be deserialized as "smallest" available type, 487 <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a>. 488 In addition, if enabled, trying to bind values that do not fit in <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a> 489 will throw a <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"><code>JsonProcessingException</code></a>. 490<p> 491 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 492 over this setting, forcing use of <a href="http://docs.oracle.com/javase/7/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a> for all 493 integral values. 494<p> 495 Feature is disabled by default, meaning that "untyped" integral 496 numbers will by default be deserialized using <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a> 497 if value fits.</div> 498<dl> 499<dt><span class="simpleTagLabel">Since:</span></dt> 500<dd>2.6</dd> 501</dl> 502</li> 503</ul> 504<a name="USE_JAVA_ARRAY_FOR_JSON_ARRAY"> 505<!-- --> 506</a> 507<ul class="blockList"> 508<li class="blockList"> 509<h4>USE_JAVA_ARRAY_FOR_JSON_ARRAY</h4> 510<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> 511<div class="block">Feature that determines whether JSON Array is mapped to 512 <code>Object[]</code> or <code>List<Object></code> when binding 513 "untyped" objects (ones with nominal type of <code>java.lang.Object</code>). 514 If true, binds as <code>Object[]</code>; if false, as <code>List<Object></code>. 515<p> 516 Feature is disabled by default, meaning that JSON arrays are bound as 517 <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util"><code>List</code></a>s.</div> 518</li> 519</ul> 520<a name="FAIL_ON_UNKNOWN_PROPERTIES"> 521<!-- --> 522</a> 523<ul class="blockList"> 524<li class="blockList"> 525<h4>FAIL_ON_UNKNOWN_PROPERTIES</h4> 526<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> 527<div class="block">Feature that determines whether encountering of unknown 528 properties (ones that do not map to a property, and there is 529 no "any setter" or handler that can handle it) 530 should result in a failure (by throwing a 531 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a>) or not. 532 This setting only takes effect after all other handling 533 methods for unknown properties have been tried, and 534 property remains unhandled. 535<p> 536 Feature is enabled by default (meaning that a 537 <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 538 is encountered).</div> 539</li> 540</ul> 541<a name="FAIL_ON_NULL_FOR_PRIMITIVES"> 542<!-- --> 543</a> 544<ul class="blockList"> 545<li class="blockList"> 546<h4>FAIL_ON_NULL_FOR_PRIMITIVES</h4> 547<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> 548<div class="block">Feature that determines whether encountering of JSON null 549 is an error when deserializing into Java primitive types 550 (like 'int' or 'double'). If it is, a JsonProcessingException 551 is thrown to indicate this; if not, default value is used 552 (0 for 'int', 0.0 for double, same defaulting as what JVM uses). 553<p> 554 Feature is disabled by default.</div> 555</li> 556</ul> 557<a name="FAIL_ON_NUMBERS_FOR_ENUMS"> 558<!-- --> 559</a> 560<ul class="blockList"> 561<li class="blockList"> 562<h4>FAIL_ON_NUMBERS_FOR_ENUMS</h4> 563<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> 564<div class="block">Feature that determines whether JSON integer numbers are valid 565 values to be used for deserializing Java enum values. 566 If set to 'false' numbers are acceptable and are used to map to 567 ordinal() of matching enumeration value; if 'true', numbers are 568 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. 569 Latter behavior makes sense if there is concern that accidental 570 mapping from integer values to enums might happen (and when enums 571 are always serialized as JSON Strings) 572<p> 573 Feature is disabled by default.</div> 574</li> 575</ul> 576<a name="FAIL_ON_INVALID_SUBTYPE"> 577<!-- --> 578</a> 579<ul class="blockList"> 580<li class="blockList"> 581<h4>FAIL_ON_INVALID_SUBTYPE</h4> 582<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> 583<div class="block">Feature that determines what happens when type of a polymorphic 584 value (indicated for example by <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.9/com/fasterxml/jackson/annotation/JsonTypeInfo.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonTypeInfo</code></a>) 585 cannot be found (missing) or resolved (invalid class name, unmappable id); 586 if enabled, an exception ir thrown; if false, null value is used instead. 587<p> 588 Feature is enabled by default so that exception is thrown for missing or invalid 589 type information.</div> 590<dl> 591<dt><span class="simpleTagLabel">Since:</span></dt> 592<dd>2.2</dd> 593</dl> 594</li> 595</ul> 596<a name="FAIL_ON_READING_DUP_TREE_KEY"> 597<!-- --> 598</a> 599<ul class="blockList"> 600<li class="blockList"> 601<h4>FAIL_ON_READING_DUP_TREE_KEY</h4> 602<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> 603<div class="block">Feature that determines what happens when reading JSON content into tree 604 (<a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/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 605 is encountered (property name that was already seen for the JSON Object). 606 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 607 is thrown and the new (later) value overwrites the earlier value. 608<p> 609 Note that this property does NOT affect other aspects of data-binding; that is, 610 no detection is done with respect to POJO properties or <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 611 keys. New features may be added to control additional cases. 612<p> 613 Feature is disabled by default so that no exception is thrown.</div> 614<dl> 615<dt><span class="simpleTagLabel">Since:</span></dt> 616<dd>2.3</dd> 617</dl> 618</li> 619</ul> 620<a name="FAIL_ON_IGNORED_PROPERTIES"> 621<!-- --> 622</a> 623<ul class="blockList"> 624<li class="blockList"> 625<h4>FAIL_ON_IGNORED_PROPERTIES</h4> 626<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> 627<div class="block">Feature that determines what happens when a property that has been explicitly 628 marked as ignorable is encountered in input: if feature is enabled, 629 <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. 630<p> 631 Feature is disabled by default so that no exception is thrown.</div> 632<dl> 633<dt><span class="simpleTagLabel">Since:</span></dt> 634<dd>2.3</dd> 635</dl> 636</li> 637</ul> 638<a name="FAIL_ON_UNRESOLVED_OBJECT_IDS"> 639<!-- --> 640</a> 641<ul class="blockList"> 642<li class="blockList"> 643<h4>FAIL_ON_UNRESOLVED_OBJECT_IDS</h4> 644<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> 645<div class="block">Feature that determines what happens if an Object Id reference is encountered 646 that does not refer to an actual Object with that id ("unresolved Object Id"): 647 either an exception is thrown (<code>true</code>), or a null object is used 648 instead (<code>false</code>). 649 Note that if this is set to <code>false</code>, no further processing is done; 650 specifically, if reference is defined via setter method, that method will NOT 651 be called. 652<p> 653 Feature is enabled by default, so that unknown Object Ids will result in an 654 exception being thrown, at the end of deserialization.</div> 655<dl> 656<dt><span class="simpleTagLabel">Since:</span></dt> 657<dd>2.5</dd> 658</dl> 659</li> 660</ul> 661<a name="FAIL_ON_MISSING_CREATOR_PROPERTIES"> 662<!-- --> 663</a> 664<ul class="blockList"> 665<li class="blockList"> 666<h4>FAIL_ON_MISSING_CREATOR_PROPERTIES</h4> 667<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> 668<div class="block">Feature that determines what happens if one or more Creator properties (properties 669 bound to parameters of Creator method (constructor or static factory method)) 670 are missing value to bind to from content. 671 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 672 thrown with information on the first one (by index) of missing properties. 673 If disabled, and if property is NOT marked as required, 674 missing Creator properties are filled 675 with <code>null values</code> provided by deserializer for the type of parameter 676 (usually null for Object types, and default value for primitives; but redefinable 677 via custom deserializers). 678<p> 679 Note that having an injectable value counts as "not missing". 680<p> 681 Feature is disabled by default, so that no exception is thrown for missing creator 682 property values, unless they are explicitly marked as `required`.</div> 683<dl> 684<dt><span class="simpleTagLabel">Since:</span></dt> 685<dd>2.6</dd> 686</dl> 687</li> 688</ul> 689<a name="FAIL_ON_NULL_CREATOR_PROPERTIES"> 690<!-- --> 691</a> 692<ul class="blockList"> 693<li class="blockList"> 694<h4>FAIL_ON_NULL_CREATOR_PROPERTIES</h4> 695<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> 696<div class="block">Feature that determines what happens if one or more Creator properties (properties 697 bound to parameters of Creator method (constructor or static factory method)) 698 are bound to null values - either from the JSON or as a default value. This 699 is useful if you want to avoid nulls in your codebase, and particularly useful 700 if you are using Java or Scala optionals for non-mandatory fields. 701 Feature is disabled by default, so that no exception is thrown for missing creator 702 property values, unless they are explicitly marked as `required`.</div> 703<dl> 704<dt><span class="simpleTagLabel">Since:</span></dt> 705<dd>2.8</dd> 706</dl> 707</li> 708</ul> 709<a name="FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY"> 710<!-- --> 711</a> 712<ul class="blockList"> 713<li class="blockList"> 714<h4>FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY</h4> 715<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> 716<div class="block">Feature that determines what happens when a property annotated with 717 <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.9/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, 718 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 719 thrown when property value is missing (if type id does exist); 720 if disabled, exception is only thrown if property is marked as `required`. 721<p> 722 Feature is enabled by default, so that exception is thrown when a subtype property is 723 missing.</div> 724<dl> 725<dt><span class="simpleTagLabel">Since:</span></dt> 726<dd>2.9</dd> 727</dl> 728</li> 729</ul> 730<a name="FAIL_ON_TRAILING_TOKENS"> 731<!-- --> 732</a> 733<ul class="blockList"> 734<li class="blockList"> 735<h4>FAIL_ON_TRAILING_TOKENS</h4> 736<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> 737<div class="block">Feature that determines behaviour for data-binding after binding the root value. 738 If feature is enabled, one more call to 739 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.9/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 740 no more tokens are found (and if any is found, 741 <a href="../../../../com/fasterxml/jackson/databind/exc/MismatchedInputException.html" title="class in com.fasterxml.jackson.databind.exc"><code>MismatchedInputException</code></a> is thrown); if 742 disabled, no further checks are made. 743<p> 744 Feature could alternatively be called <code>READ_FULL_STREAM</code>, since it 745 effectively verifies that input stream contains only as much data as is needed 746 for binding the full value, and nothing more (except for possible ignorable 747 white space or comments, if supported by data format). 748<p> 749 Feature is disabled by default (so that no check is made for possible trailing 750 token(s)) for backwards compatibility reasons.</div> 751<dl> 752<dt><span class="simpleTagLabel">Since:</span></dt> 753<dd>2.9</dd> 754</dl> 755</li> 756</ul> 757<a name="WRAP_EXCEPTIONS"> 758<!-- --> 759</a> 760<ul class="blockList"> 761<li class="blockList"> 762<h4>WRAP_EXCEPTIONS</h4> 763<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> WRAP_EXCEPTIONS</pre> 764<div class="block">Feature that determines whether Jackson code should catch 765 and wrap <a href="http://docs.oracle.com/javase/7/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="http://docs.oracle.com/javase/7/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 766 to add additional information about 767 location (within input) of problem or not. If enabled, 768 most exceptions will be caught and re-thrown (exception 769 specifically being that <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a>s may be passed 770 as is, since they are declared as throwable); this can be 771 convenient both in that all exceptions will be checked and 772 declared, and so there is more contextual information. 773 However, sometimes calling application may just want "raw" 774 unchecked exceptions passed as is. 775<p> 776 Feature is enabled by default.</div> 777</li> 778</ul> 779<a name="ACCEPT_SINGLE_VALUE_AS_ARRAY"> 780<!-- --> 781</a> 782<ul class="blockList"> 783<li class="blockList"> 784<h4>ACCEPT_SINGLE_VALUE_AS_ARRAY</h4> 785<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> 786<div class="block">Feature that determines whether it is acceptable to coerce non-array 787 (in JSON) values to work with Java collection (arrays, java.util.Collection) 788 types. If enabled, collection deserializers will try to handle non-array 789 values as if they had "implicit" surrounding JSON array. 790 This feature is meant to be used for compatibility/interoperability reasons, 791 to work with packages (such as XML-to-JSON converters) that leave out JSON 792 array in cases where there is just a single element in array. 793<p> 794 Feature is disabled by default.</div> 795</li> 796</ul> 797<a name="UNWRAP_SINGLE_VALUE_ARRAYS"> 798<!-- --> 799</a> 800<ul class="blockList"> 801<li class="blockList"> 802<h4>UNWRAP_SINGLE_VALUE_ARRAYS</h4> 803<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> 804<div class="block">Feature that determines whether it is acceptable to coerce single value array (in JSON) 805 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> 806 feature. If more than one value is found in the array, a JsonMappingException is thrown. 807 <p> 808 809 Feature is disabled by default</div> 810<dl> 811<dt><span class="simpleTagLabel">Since:</span></dt> 812<dd>2.4</dd> 813</dl> 814</li> 815</ul> 816<a name="UNWRAP_ROOT_VALUE"> 817<!-- --> 818</a> 819<ul class="blockList"> 820<li class="blockList"> 821<h4>UNWRAP_ROOT_VALUE</h4> 822<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> 823<div class="block">Feature to allow "unwrapping" root-level JSON value, to match setting of 824 <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_ROOT_VALUE"><code>SerializationFeature.WRAP_ROOT_VALUE</code></a> used for serialization. 825 Will verify that the root JSON value is a JSON Object, and that it has 826 a single property with expected root name. If not, a 827 <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 828 will be deserialized as if it was the root value. 829<p> 830 Feature is disabled by default.</div> 831</li> 832</ul> 833<a name="ACCEPT_EMPTY_STRING_AS_NULL_OBJECT"> 834<!-- --> 835</a> 836<ul class="blockList"> 837<li class="blockList"> 838<h4>ACCEPT_EMPTY_STRING_AS_NULL_OBJECT</h4> 839<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> 840<div class="block">Feature that can be enabled to allow JSON empty String 841 value ("") to be bound as `null` for POJOs and other structured 842 values (<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a>s, <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s). 843 If disabled, standard POJOs can only be bound from JSON `null` or 844 JSON Object (standard meaning that no custom deserializers or 845 constructors are defined; both of which can add support for other 846 kinds of JSON values); if enabled, empty JSON String can be taken 847 to be equivalent of JSON null. 848<p> 849 NOTE: this does NOT apply to scalar values such as booleans and numbers; 850 whether they can be coerced depends on 851 <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#ALLOW_COERCION_OF_SCALARS"><code>MapperFeature.ALLOW_COERCION_OF_SCALARS</code></a>. 852<p> 853 Feature is disabled by default.</div> 854</li> 855</ul> 856<a name="ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT"> 857<!-- --> 858</a> 859<ul class="blockList"> 860<li class="blockList"> 861<h4>ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT</h4> 862<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> 863<div class="block">Feature that can be enabled to allow empty JSON Array 864 value (that is, <code>[ ]</code>) to be bound to POJOs (and 865 with 2.9, other values too) as `null`. 866 If disabled, standard POJOs can only be bound from JSON `null` or 867 JSON Object (standard meaning that no custom deserializers or 868 constructors are defined; both of which can add support for other 869 kinds of JSON values); if enabled, empty JSON Array will be taken 870 to be equivalent of JSON null. 871<p> 872 Feature is disabled by default.</div> 873<dl> 874<dt><span class="simpleTagLabel">Since:</span></dt> 875<dd>2.5</dd> 876</dl> 877</li> 878</ul> 879<a name="ACCEPT_FLOAT_AS_INT"> 880<!-- --> 881</a> 882<ul class="blockList"> 883<li class="blockList"> 884<h4>ACCEPT_FLOAT_AS_INT</h4> 885<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> 886<div class="block">Feature that determines whether coercion from JSON floating point 887 number (anything with command (`.`) or exponent portion (`e` / `E')) 888 to an expected integral number (`int`, `long`, `java.lang.Integer`, `java.lang.Long`, 889 `java.math.BigDecimal`) is allowed or not. 890 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> 891 will be thrown. 892<p> 893 Feature is enabled by default.</div> 894<dl> 895<dt><span class="simpleTagLabel">Since:</span></dt> 896<dd>2.6</dd> 897</dl> 898</li> 899</ul> 900<a name="READ_ENUMS_USING_TO_STRING"> 901<!-- --> 902</a> 903<ul class="blockList"> 904<li class="blockList"> 905<h4>READ_ENUMS_USING_TO_STRING</h4> 906<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> 907<div class="block">Feature that determines standard deserialization mechanism used for 908 Enum values: if enabled, Enums are assumed to have been serialized using 909 return value of <code>Enum.toString()</code>; 910 if disabled, return value of <code>Enum.name()</code> is assumed to have been used. 911<p> 912 Note: this feature should usually have same value 913 as <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_ENUMS_USING_TO_STRING"><code>SerializationFeature.WRITE_ENUMS_USING_TO_STRING</code></a>. 914<p> 915 Feature is disabled by default.</div> 916</li> 917</ul> 918<a name="READ_UNKNOWN_ENUM_VALUES_AS_NULL"> 919<!-- --> 920</a> 921<ul class="blockList"> 922<li class="blockList"> 923<h4>READ_UNKNOWN_ENUM_VALUES_AS_NULL</h4> 924<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> 925<div class="block">Feature that allows unknown Enum values to be parsed as null values. 926 If disabled, unknown Enum values will throw exceptions. 927<p> 928 Note that in some cases this will basically ignore unknown Enum values; 929 this is the keys for keys of <a href="http://docs.oracle.com/javase/7/docs/api/java/util/EnumMap.html?is-external=true" title="class or interface in java.util"><code>EnumMap</code></a> and values 930 of <a href="http://docs.oracle.com/javase/7/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 931 cases). 932<p> 933 Feature is disabled by default.</div> 934<dl> 935<dt><span class="simpleTagLabel">Since:</span></dt> 936<dd>2.0</dd> 937</dl> 938</li> 939</ul> 940<a name="READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE"> 941<!-- --> 942</a> 943<ul class="blockList"> 944<li class="blockList"> 945<h4>READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE</h4> 946<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> 947<div class="block">Feature that allows unknown Enum values to be ignored and a predefined value specified through 948 <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.9/com/fasterxml/jackson/annotation/JsonEnumDefaultValue.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>@JsonEnumDefaultValue</code></a> annotation. 949 If disabled, unknown Enum values will throw exceptions. 950 If enabled, but no predefined default Enum value is specified, an exception will be thrown as well. 951<p> 952 Feature is disabled by default.</div> 953<dl> 954<dt><span class="simpleTagLabel">Since:</span></dt> 955<dd>2.8</dd> 956</dl> 957</li> 958</ul> 959<a name="READ_DATE_TIMESTAMPS_AS_NANOSECONDS"> 960<!-- --> 961</a> 962<ul class="blockList"> 963<li class="blockList"> 964<h4>READ_DATE_TIMESTAMPS_AS_NANOSECONDS</h4> 965<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> 966<div class="block">Feature that controls whether numeric timestamp values are expected 967 to be written using nanosecond timestamps (enabled) or not (disabled), 968 <b>if and only if</b> datatype supports such resolution. 969 Only newer datatypes (such as Java8 Date/Time) support such resolution -- 970 older types (pre-Java8 <b>java.util.Date</b> etc) and Joda do not -- 971 and this setting <b>has no effect</b> on such types. 972<p> 973 If disabled, standard millisecond timestamps are assumed. 974 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>. 975<p> 976 Feature is enabled by default, to support most accurate time values possible.</div> 977<dl> 978<dt><span class="simpleTagLabel">Since:</span></dt> 979<dd>2.2</dd> 980</dl> 981</li> 982</ul> 983<a name="ADJUST_DATES_TO_CONTEXT_TIME_ZONE"> 984<!-- --> 985</a> 986<ul class="blockList"> 987<li class="blockList"> 988<h4>ADJUST_DATES_TO_CONTEXT_TIME_ZONE</h4> 989<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> 990<div class="block">Feature that specifies whether context provided <a href="http://docs.oracle.com/javase/7/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util"><code>TimeZone</code></a> 991 (<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html#getTimeZone--"><code>DeserializationContext.getTimeZone()</code></a> should be used to adjust Date/Time 992 values on deserialization, even if value itself contains timezone information. 993 If enabled, contextual <code>TimeZone</code> will essentially override any other 994 TimeZone information; if disabled, it will only be used if value itself does not 995 contain any TimeZone information. 996<p> 997 Note that exact behavior depends on date/time types in question; and specifically 998 JDK type of <a href="http://docs.oracle.com/javase/7/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 999 so this setting has no effect. 1000 Further, while <a href="http://docs.oracle.com/javase/7/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 1001 JDK <a href="http://docs.oracle.com/javase/7/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, 1002 and as a result, <a href="http://docs.oracle.com/javase/7/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 1003 adjustment regardless of this setting. 1004<p> 1005<p> 1006 Taking above into account, this feature is supported only by extension modules for 1007 Joda and Java 8 date/tyime datatypes.</div> 1008<dl> 1009<dt><span class="simpleTagLabel">Since:</span></dt> 1010<dd>2.2</dd> 1011</dl> 1012</li> 1013</ul> 1014<a name="EAGER_DESERIALIZER_FETCH"> 1015<!-- --> 1016</a> 1017<ul class="blockListLast"> 1018<li class="blockList"> 1019<h4>EAGER_DESERIALIZER_FETCH</h4> 1020<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> 1021<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 1022 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 1023 possible. This improves performance in cases where similarly 1024 configured <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a> instance is used multiple 1025 times; and should not significantly affect single-use cases. 1026<p> 1027 Note that there should not be any need to normally disable this 1028 feature: only consider that if there are actual perceived problems. 1029<p> 1030 Feature is enabled by default.</div> 1031<dl> 1032<dt><span class="simpleTagLabel">Since:</span></dt> 1033<dd>2.1</dd> 1034</dl> 1035</li> 1036</ul> 1037</li> 1038</ul> 1039<!-- ============ METHOD DETAIL ========== --> 1040<ul class="blockList"> 1041<li class="blockList"><a name="method.detail"> 1042<!-- --> 1043</a> 1044<h3>Method Detail</h3> 1045<a name="values--"> 1046<!-- --> 1047</a> 1048<ul class="blockList"> 1049<li class="blockList"> 1050<h4>values</h4> 1051<pre>public static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>[] values()</pre> 1052<div class="block">Returns an array containing the constants of this enum type, in 1053the order they are declared. This method may be used to iterate 1054over the constants as follows: 1055<pre> 1056for (DeserializationFeature c : DeserializationFeature.values()) 1057 System.out.println(c); 1058</pre></div> 1059<dl> 1060<dt><span class="returnLabel">Returns:</span></dt> 1061<dd>an array containing the constants of this enum type, in the order they are declared</dd> 1062</dl> 1063</li> 1064</ul> 1065<a name="valueOf-java.lang.String-"> 1066<!-- --> 1067</a> 1068<ul class="blockList"> 1069<li class="blockList"> 1070<h4>valueOf</h4> 1071<pre>public static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> valueOf(<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> name)</pre> 1072<div class="block">Returns the enum constant of this type with the specified name. 1073The string must match <i>exactly</i> an identifier used to declare an 1074enum constant in this type. (Extraneous whitespace characters are 1075not permitted.)</div> 1076<dl> 1077<dt><span class="paramLabel">Parameters:</span></dt> 1078<dd><code>name</code> - the name of the enum constant to be returned.</dd> 1079<dt><span class="returnLabel">Returns:</span></dt> 1080<dd>the enum constant with the specified name</dd> 1081<dt><span class="throwsLabel">Throws:</span></dt> 1082<dd><code><a href="http://docs.oracle.com/javase/7/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> 1083<dd><code><a href="http://docs.oracle.com/javase/7/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> 1084</dl> 1085</li> 1086</ul> 1087<a name="enabledByDefault--"> 1088<!-- --> 1089</a> 1090<ul class="blockList"> 1091<li class="blockList"> 1092<h4>enabledByDefault</h4> 1093<pre>public boolean enabledByDefault()</pre> 1094<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> 1095<div class="block">Accessor for checking whether this feature is enabled by default.</div> 1096<dl> 1097<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 1098<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> 1099</dl> 1100</li> 1101</ul> 1102<a name="getMask--"> 1103<!-- --> 1104</a> 1105<ul class="blockList"> 1106<li class="blockList"> 1107<h4>getMask</h4> 1108<pre>public int getMask()</pre> 1109<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> 1110<div class="block">Returns bit mask for this feature instance</div> 1111<dl> 1112<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 1113<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> 1114</dl> 1115</li> 1116</ul> 1117<a name="enabledIn-int-"> 1118<!-- --> 1119</a> 1120<ul class="blockListLast"> 1121<li class="blockList"> 1122<h4>enabledIn</h4> 1123<pre>public boolean enabledIn(int flags)</pre> 1124<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> 1125<div class="block">Convenience method for checking whether feature is enabled in given bitmask</div> 1126<dl> 1127<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 1128<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> 1129</dl> 1130</li> 1131</ul> 1132</li> 1133</ul> 1134</li> 1135</ul> 1136</div> 1137</div> 1138<!-- ========= END OF CLASS DATA ========= --> 1139<!-- ======= START OF BOTTOM NAVBAR ====== --> 1140<div class="bottomNav"><a name="navbar.bottom"> 1141<!-- --> 1142</a> 1143<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> 1144<a name="navbar.bottom.firstrow"> 1145<!-- --> 1146</a> 1147<ul class="navList" title="Navigation"> 1148<li><a href="../../../../overview-summary.html">Overview</a></li> 1149<li><a href="package-summary.html">Package</a></li> 1150<li class="navBarCell1Rev">Class</li> 1151<li><a href="class-use/DeserializationFeature.html">Use</a></li> 1152<li><a href="package-tree.html">Tree</a></li> 1153<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 1154<li><a href="../../../../index-all.html">Index</a></li> 1155<li><a href="../../../../help-doc.html">Help</a></li> 1156</ul> 1157</div> 1158<div class="subNav"> 1159<ul class="navList"> 1160<li><a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Prev Class</span></a></li> 1161<li><a href="../../../../com/fasterxml/jackson/databind/InjectableValues.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Next Class</span></a></li> 1162</ul> 1163<ul class="navList"> 1164<li><a href="../../../../index.html?com/fasterxml/jackson/databind/DeserializationFeature.html" target="_top">Frames</a></li> 1165<li><a href="DeserializationFeature.html" target="_top">No Frames</a></li> 1166</ul> 1167<ul class="navList" id="allclasses_navbar_bottom"> 1168<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 1169</ul> 1170<div> 1171<script type="text/javascript"><!-- 1172 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 1173 if(window==top) { 1174 allClassesLink.style.display = "block"; 1175 } 1176 else { 1177 allClassesLink.style.display = "none"; 1178 } 1179 //--> 1180</script> 1181</div> 1182<div> 1183<ul class="subNavList"> 1184<li>Summary: </li> 1185<li>Nested | </li> 1186<li><a href="#enum.constant.summary">Enum Constants</a> | </li> 1187<li>Field | </li> 1188<li><a href="#method.summary">Method</a></li> 1189</ul> 1190<ul class="subNavList"> 1191<li>Detail: </li> 1192<li><a href="#enum.constant.detail">Enum Constants</a> | </li> 1193<li>Field | </li> 1194<li><a href="#method.detail">Method</a></li> 1195</ul> 1196</div> 1197<a name="skip.navbar.bottom"> 1198<!-- --> 1199</a></div> 1200<!-- ======== END OF BOTTOM NAVBAR ======= --> 1201<p class="legalCopy"><small>Copyright © 2008–2018 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 1202</body> 1203</html> 1204