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) on Sun Jul 19 11:36:49 PDT 2015 --> 6<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7<title>DeserializationFeature (jackson-databind 2.6.0 API)</title> 8<meta name="date" content="2015-07-19"> 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.6.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/6/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/6/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/6/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/6/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/6/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 as null.</div> 159</td> 160</tr> 161<tr class="rowColor"> 162<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> 163<div class="block">Feature that can be enabled to allow JSON empty String 164 value ("") to be bound to POJOs as null.</div> 165</td> 166</tr> 167<tr class="altColor"> 168<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> 169<div class="block">Feature that determines whether coercion from JSON floating point 170 number (anything with command (`.`) or exponent portion (`e` / `E')) 171 to an expected integral number (`int`, `long`, `java.lang.Integer`, `java.lang.Long`, 172 `java.math.BigDecimal`) is allowed or not.</div> 173</td> 174</tr> 175<tr class="rowColor"> 176<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> 177<div class="block">Feature that determines whether it is acceptable to coerce non-array 178 (in JSON) values to work with Java collection (arrays, java.util.Collection) 179 types.</div> 180</td> 181</tr> 182<tr class="altColor"> 183<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> 184<div class="block">Feature that specifies whether context provided <a href="http://docs.oracle.com/javase/6/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util"><code>TimeZone</code></a> 185 (<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html#getTimeZone--"><code>DeserializationContext.getTimeZone()</code></a> should be used to adjust Date/Time 186 values on deserialization, even if value itself contains timezone information.</div> 187</td> 188</tr> 189<tr class="rowColor"> 190<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#EAGER_DESERIALIZER_FETCH">EAGER_DESERIALIZER_FETCH</a></span></code> 191<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 192 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 193 possible.</div> 194</td> 195</tr> 196<tr class="altColor"> 197<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> 198<div class="block">Feature that determines what happens when a property that has been explicitly 199 marked as ignorable is encountered in input: if feature is enabled, 200 <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> 201</td> 202</tr> 203<tr class="rowColor"> 204<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> 205<div class="block">Feature that determines what happens when type of a polymorphic 206 value (indicated for example by <code>JsonTypeInfo</code>) 207 can not be found (missing) or resolved (invalid class name, unmappable id); 208 if enabled, an exception ir thrown; if false, null value is used instead.</div> 209</td> 210</tr> 211<tr class="altColor"> 212<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> 213<div class="block">Feature that determines what happens if one or more Creator properties (properties 214 bound to parameters of Creator method (constructor or static factory method)) 215 are missing value to bind to from content.</div> 216</td> 217</tr> 218<tr class="rowColor"> 219<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> 220<div class="block">Feature that determines whether encountering of JSON null 221 is an error when deserializing into Java primitive types 222 (like 'int' or 'double').</div> 223</td> 224</tr> 225<tr class="altColor"> 226<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> 227<div class="block">Feature that determines whether JSON integer numbers are valid 228 values to be used for deserializing Java enum values.</div> 229</td> 230</tr> 231<tr class="rowColor"> 232<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> 233<div class="block">Feature that determines what happens when reading JSON content into tree 234 (<code>TreeNode</code>) and a duplicate key 235 is encountered (property name that was already seen for the JSON Object).</div> 236</td> 237</tr> 238<tr class="altColor"> 239<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> 240<div class="block">Feature that determines whether encountering of unknown 241 properties (ones that do not map to a property, and there is 242 no "any setter" or handler that can handle it) 243 should result in a failure (by throwing a 244 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a>) or not.</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_UNRESOLVED_OBJECT_IDS">FAIL_ON_UNRESOLVED_OBJECT_IDS</a></span></code> 249<div class="block">Feature that determines what happens if an Object Id reference is encountered 250 that does not refer to an actual Object with that id ("unresolved Object Id"): 251 either an exception is thrown (<code>true</code>), or a null object is used 252 instead (<code>false</code>).</div> 253</td> 254</tr> 255<tr class="altColor"> 256<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> 257<div class="block">Feature that controls whether numeric timestamp values are expected 258 to be written using nanosecond timestamps (enabled) or not (disabled), 259 <b>if and only if</b> datatype supports such resolution.</div> 260</td> 261</tr> 262<tr class="rowColor"> 263<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> 264<div class="block">Feature that determines standard deserialization mechanism used for 265 Enum values: if enabled, Enums are assumed to have been serialized using 266 return value of <code>Enum.toString()</code>; 267 if disabled, return value of <code>Enum.name()</code> is assumed to have been used.</div> 268</td> 269</tr> 270<tr class="altColor"> 271<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> 272<div class="block">Feature that allows unknown Enum values to be parsed as null values.</div> 273</td> 274</tr> 275<tr class="rowColor"> 276<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#UNWRAP_ROOT_VALUE">UNWRAP_ROOT_VALUE</a></span></code> 277<div class="block">Feature to allow "unwrapping" root-level JSON value, to match setting of 278 <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_ROOT_VALUE"><code>SerializationFeature.WRAP_ROOT_VALUE</code></a> used for serialization.</div> 279</td> 280</tr> 281<tr class="altColor"> 282<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> 283<div class="block">Feature that determines whether it is acceptable to coerce single value array (in JSON) 284 values to the corresponding value type.</div> 285</td> 286</tr> 287<tr class="rowColor"> 288<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> 289<div class="block">Feature that determines whether JSON floating point numbers 290 are to be deserialized into <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a>s 291 if only generic type description (either <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 292 <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 293 or <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available.</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#USE_BIG_INTEGER_FOR_INTS">USE_BIG_INTEGER_FOR_INTS</a></span></code> 298<div class="block">Feature that determines whether JSON integral (non-floating-point) 299 numbers are to be deserialized into <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s 300 if only generic type description (either <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 301 <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 302 or <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available.</div> 303</td> 304</tr> 305<tr class="rowColor"> 306<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> 307<div class="block">Feature that determines whether JSON Array is mapped to 308 <code>Object[]</code> or <code>List<Object></code> when binding 309 "untyped" objects (ones with nominal type of <code>java.lang.Object</code>).</div> 310</td> 311</tr> 312<tr class="altColor"> 313<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> 314<div class="block">Feature that determines how "small" JSON integral (non-floating-point) 315 numbers -- ones that fit in 32-bit signed integer (`int`) -- are bound 316 when target type is loosely typed as <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> 317 (or within untyped <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context).</div> 318</td> 319</tr> 320<tr class="rowColor"> 321<td class="colOne"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#WRAP_EXCEPTIONS">WRAP_EXCEPTIONS</a></span></code> 322<div class="block">Feature that determines whether Jackson code should catch 323 and wrap <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 324 to add additional information about 325 location (within input) of problem or not.</div> 326</td> 327</tr> 328</table> 329</li> 330</ul> 331<!-- ========== METHOD SUMMARY =========== --> 332<ul class="blockList"> 333<li class="blockList"><a name="method.summary"> 334<!-- --> 335</a> 336<h3>Method Summary</h3> 337<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 338<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> 339<tr> 340<th class="colFirst" scope="col">Modifier and Type</th> 341<th class="colLast" scope="col">Method and Description</th> 342</tr> 343<tr id="i0" class="altColor"> 344<td class="colFirst"><code>boolean</code></td> 345<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#enabledByDefault--">enabledByDefault</a></span>()</code> 346<div class="block">Accessor for checking whether this feature is enabled by default.</div> 347</td> 348</tr> 349<tr id="i1" class="rowColor"> 350<td class="colFirst"><code>boolean</code></td> 351<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#enabledIn-int-">enabledIn</a></span>(int flags)</code> 352<div class="block">Convenience method for checking whether feature is enabled in given bitmask</div> 353</td> 354</tr> 355<tr id="i2" class="altColor"> 356<td class="colFirst"><code>int</code></td> 357<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#getMask--">getMask</a></span>()</code> 358<div class="block">Returns bit mask for this feature instance</div> 359</td> 360</tr> 361<tr id="i3" class="rowColor"> 362<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a></code></td> 363<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/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</code> 364<div class="block">Returns the enum constant of this type with the specified name.</div> 365</td> 366</tr> 367<tr id="i4" class="altColor"> 368<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>[]</code></td> 369<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#values--">values</a></span>()</code> 370<div class="block">Returns an array containing the constants of this enum type, in 371the order they are declared.</div> 372</td> 373</tr> 374</table> 375<ul class="blockList"> 376<li class="blockList"><a name="methods.inherited.from.class.java.lang.Enum"> 377<!-- --> 378</a> 379<h3>Methods inherited from class java.lang.<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">Enum</a></h3> 380<code><a href="http://docs.oracle.com/javase/6/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/6/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/6/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/6/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/6/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/6/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/6/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/6/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/6/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/6/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> 381</ul> 382<ul class="blockList"> 383<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object"> 384<!-- --> 385</a> 386<h3>Methods inherited from class java.lang.<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3> 387<code><a href="http://docs.oracle.com/javase/6/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/6/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/6/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/6/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/6/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/6/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li> 388</ul> 389</li> 390</ul> 391</li> 392</ul> 393</div> 394<div class="details"> 395<ul class="blockList"> 396<li class="blockList"> 397<!-- ============ ENUM CONSTANT DETAIL =========== --> 398<ul class="blockList"> 399<li class="blockList"><a name="enum.constant.detail"> 400<!-- --> 401</a> 402<h3>Enum Constant Detail</h3> 403<a name="USE_BIG_DECIMAL_FOR_FLOATS"> 404<!-- --> 405</a> 406<ul class="blockList"> 407<li class="blockList"> 408<h4>USE_BIG_DECIMAL_FOR_FLOATS</h4> 409<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> 410<div class="block">Feature that determines whether JSON floating point numbers 411 are to be deserialized into <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a>s 412 if only generic type description (either <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 413 <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 414 or <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available. 415 If enabled such values will be deserialized as <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a>s; 416 if disabled, will be deserialized as <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang"><code>Double</code></a>s. 417 <p> 418 Feature is disabled by default, meaning that "untyped" floating 419 point numbers will by default be deserialized as <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang"><code>Double</code></a>s 420 (choice is for performance reason -- BigDecimals are slower than 421 Doubles).</div> 422</li> 423</ul> 424<a name="USE_BIG_INTEGER_FOR_INTS"> 425<!-- --> 426</a> 427<ul class="blockList"> 428<li class="blockList"> 429<h4>USE_BIG_INTEGER_FOR_INTS</h4> 430<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> 431<div class="block">Feature that determines whether JSON integral (non-floating-point) 432 numbers are to be deserialized into <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s 433 if only generic type description (either <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang"><code>Object</code></a> or 434 <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 435 or <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context) is available. 436 If enabled such values will be deserialized as 437 <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a>s; 438 if disabled, will be deserialized as "smallest" available type, 439 which is either <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a> or 440 <a href="http://docs.oracle.com/javase/6/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. 441 <p> 442 Feature is disabled by default, meaning that "untyped" integral 443 numbers will by default be deserialized using whatever 444 is the most compact integral type, to optimize efficiency.</div> 445</li> 446</ul> 447<a name="USE_LONG_FOR_INTS"> 448<!-- --> 449</a> 450<ul class="blockList"> 451<li class="blockList"> 452<h4>USE_LONG_FOR_INTS</h4> 453<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> 454<div class="block">Feature that determines how "small" JSON integral (non-floating-point) 455 numbers -- ones that fit in 32-bit signed integer (`int`) -- are bound 456 when target type is loosely typed as <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> 457 (or within untyped <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> context). 458 If enabled, such values will be deserialized as <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a>; 459 if disabled, they will be deserialized as "smallest" available type, 460 <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a>. 461 In addition, if enabled, trying to bind values that do not fit in <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang"><code>Long</code></a> 462 will throw a <code>JsonProcessingException</code>. 463<p> 464 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 465 over this setting, forcing use of <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math"><code>BigInteger</code></a> for all 466 integral values. 467<p> 468 Feature is disabled by default, meaning that "untyped" integral 469 numbers will by default be deserialized using <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a> 470 if value fits.</div> 471<dl> 472<dt><span class="simpleTagLabel">Since:</span></dt> 473<dd>2.6</dd> 474</dl> 475</li> 476</ul> 477<a name="USE_JAVA_ARRAY_FOR_JSON_ARRAY"> 478<!-- --> 479</a> 480<ul class="blockList"> 481<li class="blockList"> 482<h4>USE_JAVA_ARRAY_FOR_JSON_ARRAY</h4> 483<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> 484<div class="block">Feature that determines whether JSON Array is mapped to 485 <code>Object[]</code> or <code>List<Object></code> when binding 486 "untyped" objects (ones with nominal type of <code>java.lang.Object</code>). 487 If true, binds as <code>Object[]</code>; if false, as <code>List<Object></code>. 488<p> 489 Feature is disabled by default, meaning that JSON arrays are bound as 490 <a href="http://docs.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util"><code>List</code></a>s.</div> 491</li> 492</ul> 493<a name="READ_ENUMS_USING_TO_STRING"> 494<!-- --> 495</a> 496<ul class="blockList"> 497<li class="blockList"> 498<h4>READ_ENUMS_USING_TO_STRING</h4> 499<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> 500<div class="block">Feature that determines standard deserialization mechanism used for 501 Enum values: if enabled, Enums are assumed to have been serialized using 502 return value of <code>Enum.toString()</code>; 503 if disabled, return value of <code>Enum.name()</code> is assumed to have been used. 504<p> 505 Note: this feature should usually have same value 506 as <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_ENUMS_USING_TO_STRING"><code>SerializationFeature.WRITE_ENUMS_USING_TO_STRING</code></a>. 507<p> 508 Feature is disabled by default.</div> 509</li> 510</ul> 511<a name="FAIL_ON_UNKNOWN_PROPERTIES"> 512<!-- --> 513</a> 514<ul class="blockList"> 515<li class="blockList"> 516<h4>FAIL_ON_UNKNOWN_PROPERTIES</h4> 517<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> 518<div class="block">Feature that determines whether encountering of unknown 519 properties (ones that do not map to a property, and there is 520 no "any setter" or handler that can handle it) 521 should result in a failure (by throwing a 522 <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a>) or not. 523 This setting only takes effect after all other handling 524 methods for unknown properties have been tried, and 525 property remains unhandled. 526<p> 527 Feature is enabled by default (meaning that a 528 <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 529 is encountered).</div> 530</li> 531</ul> 532<a name="FAIL_ON_NULL_FOR_PRIMITIVES"> 533<!-- --> 534</a> 535<ul class="blockList"> 536<li class="blockList"> 537<h4>FAIL_ON_NULL_FOR_PRIMITIVES</h4> 538<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> 539<div class="block">Feature that determines whether encountering of JSON null 540 is an error when deserializing into Java primitive types 541 (like 'int' or 'double'). If it is, a JsonProcessingException 542 is thrown to indicate this; if not, default value is used 543 (0 for 'int', 0.0 for double, same defaulting as what JVM uses). 544<p> 545 Feature is disabled by default.</div> 546</li> 547</ul> 548<a name="FAIL_ON_NUMBERS_FOR_ENUMS"> 549<!-- --> 550</a> 551<ul class="blockList"> 552<li class="blockList"> 553<h4>FAIL_ON_NUMBERS_FOR_ENUMS</h4> 554<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> 555<div class="block">Feature that determines whether JSON integer numbers are valid 556 values to be used for deserializing Java enum values. 557 If set to 'false' numbers are acceptable and are used to map to 558 ordinal() of matching enumeration value; if 'true', numbers are 559 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. 560 Latter behavior makes sense if there is concern that accidental 561 mapping from integer values to enums might happen (and when enums 562 are always serialized as JSON Strings) 563<p> 564 Feature is disabled by default.</div> 565</li> 566</ul> 567<a name="FAIL_ON_INVALID_SUBTYPE"> 568<!-- --> 569</a> 570<ul class="blockList"> 571<li class="blockList"> 572<h4>FAIL_ON_INVALID_SUBTYPE</h4> 573<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> 574<div class="block">Feature that determines what happens when type of a polymorphic 575 value (indicated for example by <code>JsonTypeInfo</code>) 576 can not be found (missing) or resolved (invalid class name, unmappable id); 577 if enabled, an exception ir thrown; if false, null value is used instead. 578<p> 579 Feature is enabled by default so that exception is thrown for missing or invalid 580 type information.</div> 581<dl> 582<dt><span class="simpleTagLabel">Since:</span></dt> 583<dd>2.2</dd> 584</dl> 585</li> 586</ul> 587<a name="FAIL_ON_READING_DUP_TREE_KEY"> 588<!-- --> 589</a> 590<ul class="blockList"> 591<li class="blockList"> 592<h4>FAIL_ON_READING_DUP_TREE_KEY</h4> 593<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> 594<div class="block">Feature that determines what happens when reading JSON content into tree 595 (<code>TreeNode</code>) and a duplicate key 596 is encountered (property name that was already seen for the JSON Object). 597 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 598 is thrown and the new (later) value overwrites the earlier value. 599<p> 600 Note that this property does NOT affect other aspects of data-binding; that is, 601 no detection is done with respect to POJO properties or <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> 602 keys. New features may be added to control additional cases. 603<p> 604 Feature is disabled by default so that no exception is thrown.</div> 605<dl> 606<dt><span class="simpleTagLabel">Since:</span></dt> 607<dd>2.3</dd> 608</dl> 609</li> 610</ul> 611<a name="FAIL_ON_IGNORED_PROPERTIES"> 612<!-- --> 613</a> 614<ul class="blockList"> 615<li class="blockList"> 616<h4>FAIL_ON_IGNORED_PROPERTIES</h4> 617<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> 618<div class="block">Feature that determines what happens when a property that has been explicitly 619 marked as ignorable is encountered in input: if feature is enabled, 620 <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. 621<p> 622 Feature is disabled by default so that no exception is thrown.</div> 623<dl> 624<dt><span class="simpleTagLabel">Since:</span></dt> 625<dd>2.3</dd> 626</dl> 627</li> 628</ul> 629<a name="FAIL_ON_UNRESOLVED_OBJECT_IDS"> 630<!-- --> 631</a> 632<ul class="blockList"> 633<li class="blockList"> 634<h4>FAIL_ON_UNRESOLVED_OBJECT_IDS</h4> 635<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> 636<div class="block">Feature that determines what happens if an Object Id reference is encountered 637 that does not refer to an actual Object with that id ("unresolved Object Id"): 638 either an exception is thrown (<code>true</code>), or a null object is used 639 instead (<code>false</code>). 640 Note that if this is set to <code>false</code>, no further processing is done; 641 specifically, if reference is defined via setter method, that method will NOT 642 be called. 643<p> 644 Feature is enabled by default, so that unknown Object Ids will result in an 645 exception being thrown, at the end of deserialization.</div> 646<dl> 647<dt><span class="simpleTagLabel">Since:</span></dt> 648<dd>2.5</dd> 649</dl> 650</li> 651</ul> 652<a name="FAIL_ON_MISSING_CREATOR_PROPERTIES"> 653<!-- --> 654</a> 655<ul class="blockList"> 656<li class="blockList"> 657<h4>FAIL_ON_MISSING_CREATOR_PROPERTIES</h4> 658<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> 659<div class="block">Feature that determines what happens if one or more Creator properties (properties 660 bound to parameters of Creator method (constructor or static factory method)) 661 are missing value to bind to from content. 662 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 663 thrown with information on the first one (by index) of missing properties. 664 If disabled, and if property is NOT marked as required, 665 missing Creator properties are filled 666 with <code>null values</code> provided by deserializer for the type of parameter 667 (usually null for Object types, and default value for primitives; but redefinable 668 via custom deserializers). 669<p> 670 Note that having an injectable value counts as "not missing". 671<p> 672 Feature is disabled by default, so that no exception is thrown for missing creator 673 property values, unless they are explicitly marked as `required`.</div> 674<dl> 675<dt><span class="simpleTagLabel">Since:</span></dt> 676<dd>2.6</dd> 677</dl> 678</li> 679</ul> 680<a name="WRAP_EXCEPTIONS"> 681<!-- --> 682</a> 683<ul class="blockList"> 684<li class="blockList"> 685<h4>WRAP_EXCEPTIONS</h4> 686<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a> WRAP_EXCEPTIONS</pre> 687<div class="block">Feature that determines whether Jackson code should catch 688 and wrap <a href="http://docs.oracle.com/javase/6/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/6/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 689 to add additional information about 690 location (within input) of problem or not. If enabled, 691 most exceptions will be caught and re-thrown (exception 692 specifically being that <a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a>s may be passed 693 as is, since they are declared as throwable); this can be 694 convenient both in that all exceptions will be checked and 695 declared, and so there is more contextual information. 696 However, sometimes calling application may just want "raw" 697 unchecked exceptions passed as is. 698<p> 699 Feature is enabled by default.</div> 700</li> 701</ul> 702<a name="ACCEPT_SINGLE_VALUE_AS_ARRAY"> 703<!-- --> 704</a> 705<ul class="blockList"> 706<li class="blockList"> 707<h4>ACCEPT_SINGLE_VALUE_AS_ARRAY</h4> 708<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> 709<div class="block">Feature that determines whether it is acceptable to coerce non-array 710 (in JSON) values to work with Java collection (arrays, java.util.Collection) 711 types. If enabled, collection deserializers will try to handle non-array 712 values as if they had "implicit" surrounding JSON array. 713 This feature is meant to be used for compatibility/interoperability reasons, 714 to work with packages (such as XML-to-JSON converters) that leave out JSON 715 array in cases where there is just a single element in array. 716<p> 717 Feature is disabled by default.</div> 718</li> 719</ul> 720<a name="UNWRAP_SINGLE_VALUE_ARRAYS"> 721<!-- --> 722</a> 723<ul class="blockList"> 724<li class="blockList"> 725<h4>UNWRAP_SINGLE_VALUE_ARRAYS</h4> 726<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> 727<div class="block">Feature that determines whether it is acceptable to coerce single value array (in JSON) 728 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> 729 feature. If more than one value is found in the array, a JsonMappingException is thrown. 730 <p> 731 732 Feature is disabled by default</div> 733<dl> 734<dt><span class="simpleTagLabel">Since:</span></dt> 735<dd>2.4</dd> 736</dl> 737</li> 738</ul> 739<a name="UNWRAP_ROOT_VALUE"> 740<!-- --> 741</a> 742<ul class="blockList"> 743<li class="blockList"> 744<h4>UNWRAP_ROOT_VALUE</h4> 745<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> 746<div class="block">Feature to allow "unwrapping" root-level JSON value, to match setting of 747 <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_ROOT_VALUE"><code>SerializationFeature.WRAP_ROOT_VALUE</code></a> used for serialization. 748 Will verify that the root JSON value is a JSON Object, and that it has 749 a single property with expected root name. If not, a 750 <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 751 will be deserialized as if it was the root value. 752<p> 753 Feature is disabled by default.</div> 754</li> 755</ul> 756<a name="ACCEPT_EMPTY_STRING_AS_NULL_OBJECT"> 757<!-- --> 758</a> 759<ul class="blockList"> 760<li class="blockList"> 761<h4>ACCEPT_EMPTY_STRING_AS_NULL_OBJECT</h4> 762<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> 763<div class="block">Feature that can be enabled to allow JSON empty String 764 value ("") to be bound to POJOs as null. 765 If disabled, standard POJOs can only be bound from JSON null or 766 JSON Object (standard meaning that no custom deserializers or 767 constructors are defined; both of which can add support for other 768 kinds of JSON values); if enabled, empty JSON String can be taken 769 to be equivalent of JSON null. 770<p> 771 Feature is disabled by default.</div> 772</li> 773</ul> 774<a name="ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT"> 775<!-- --> 776</a> 777<ul class="blockList"> 778<li class="blockList"> 779<h4>ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT</h4> 780<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> 781<div class="block">Feature that can be enabled to allow empty JSON Array 782 value (that is, <code>[ ]</code>) to be bound to POJOs as null. 783 If disabled, standard POJOs can only be bound from JSON null or 784 JSON Object (standard meaning that no custom deserializers or 785 constructors are defined; both of which can add support for other 786 kinds of JSON values); if enabled, empty JSON Array will be taken 787 to be equivalent of JSON null. 788<p> 789 Feature is disabled by default.</div> 790<dl> 791<dt><span class="simpleTagLabel">Since:</span></dt> 792<dd>2.5</dd> 793</dl> 794</li> 795</ul> 796<a name="ACCEPT_FLOAT_AS_INT"> 797<!-- --> 798</a> 799<ul class="blockList"> 800<li class="blockList"> 801<h4>ACCEPT_FLOAT_AS_INT</h4> 802<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> 803<div class="block">Feature that determines whether coercion from JSON floating point 804 number (anything with command (`.`) or exponent portion (`e` / `E')) 805 to an expected integral number (`int`, `long`, `java.lang.Integer`, `java.lang.Long`, 806 `java.math.BigDecimal`) is allowed or not. 807 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> 808 will be thrown. 809<p> 810 Feature is enabled by default.</div> 811<dl> 812<dt><span class="simpleTagLabel">Since:</span></dt> 813<dd>2.6</dd> 814</dl> 815</li> 816</ul> 817<a name="READ_UNKNOWN_ENUM_VALUES_AS_NULL"> 818<!-- --> 819</a> 820<ul class="blockList"> 821<li class="blockList"> 822<h4>READ_UNKNOWN_ENUM_VALUES_AS_NULL</h4> 823<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> 824<div class="block">Feature that allows unknown Enum values to be parsed as null values. 825 If disabled, unknown Enum values will throw exceptions. 826<p> 827 Note that in some cases this will basically ignore unknown Enum values; 828 this is the keys for keys of <a href="http://docs.oracle.com/javase/6/docs/api/java/util/EnumMap.html?is-external=true" title="class or interface in java.util"><code>EnumMap</code></a> and values 829 of <a href="http://docs.oracle.com/javase/6/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 830 cases). 831<p> 832 Feature is disabled by default.</div> 833<dl> 834<dt><span class="simpleTagLabel">Since:</span></dt> 835<dd>2.0</dd> 836</dl> 837</li> 838</ul> 839<a name="READ_DATE_TIMESTAMPS_AS_NANOSECONDS"> 840<!-- --> 841</a> 842<ul class="blockList"> 843<li class="blockList"> 844<h4>READ_DATE_TIMESTAMPS_AS_NANOSECONDS</h4> 845<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> 846<div class="block">Feature that controls whether numeric timestamp values are expected 847 to be written using nanosecond timestamps (enabled) or not (disabled), 848 <b>if and only if</b> datatype supports such resolution. 849 Only newer datatypes (such as Java8 Date/Time) support such resolution -- 850 older types (pre-Java8 <b>java.util.Date</b> etc) and Joda do not -- 851 and this setting <b>has no effect</b> on such types. 852<p> 853 If disabled, standard millisecond timestamps are assumed. 854 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>. 855<p> 856 Feature is enabled by default, to support most accurate time values possible.</div> 857<dl> 858<dt><span class="simpleTagLabel">Since:</span></dt> 859<dd>2.2</dd> 860</dl> 861</li> 862</ul> 863<a name="ADJUST_DATES_TO_CONTEXT_TIME_ZONE"> 864<!-- --> 865</a> 866<ul class="blockList"> 867<li class="blockList"> 868<h4>ADJUST_DATES_TO_CONTEXT_TIME_ZONE</h4> 869<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> 870<div class="block">Feature that specifies whether context provided <a href="http://docs.oracle.com/javase/6/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util"><code>TimeZone</code></a> 871 (<a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html#getTimeZone--"><code>DeserializationContext.getTimeZone()</code></a> should be used to adjust Date/Time 872 values on deserialization, even if value itself contains timezone information. 873 If enabled, contextual <code>TimeZone</code> will essentially override any other 874 TimeZone information; if disabled, it will only be used if value itself does not 875 contain any TimeZone information.</div> 876<dl> 877<dt><span class="simpleTagLabel">Since:</span></dt> 878<dd>2.2</dd> 879</dl> 880</li> 881</ul> 882<a name="EAGER_DESERIALIZER_FETCH"> 883<!-- --> 884</a> 885<ul class="blockListLast"> 886<li class="blockList"> 887<h4>EAGER_DESERIALIZER_FETCH</h4> 888<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> 889<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 890 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 891 possible. This improves performance in cases where similarly 892 configured <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a> instance is used multiple 893 times; and should not significantly affect single-use cases. 894<p> 895 Note that there should not be any need to normally disable this 896 feature: only consider that if there are actual perceived problems. 897<p> 898 Feature is enabled by default.</div> 899<dl> 900<dt><span class="simpleTagLabel">Since:</span></dt> 901<dd>2.1</dd> 902</dl> 903</li> 904</ul> 905</li> 906</ul> 907<!-- ============ METHOD DETAIL ========== --> 908<ul class="blockList"> 909<li class="blockList"><a name="method.detail"> 910<!-- --> 911</a> 912<h3>Method Detail</h3> 913<a name="values--"> 914<!-- --> 915</a> 916<ul class="blockList"> 917<li class="blockList"> 918<h4>values</h4> 919<pre>public static <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html" title="enum in com.fasterxml.jackson.databind">DeserializationFeature</a>[] values()</pre> 920<div class="block">Returns an array containing the constants of this enum type, in 921the order they are declared. This method may be used to iterate 922over the constants as follows: 923<pre> 924for (DeserializationFeature c : DeserializationFeature.values()) 925 System.out.println(c); 926</pre></div> 927<dl> 928<dt><span class="returnLabel">Returns:</span></dt> 929<dd>an array containing the constants of this enum type, in the order they are declared</dd> 930</dl> 931</li> 932</ul> 933<a name="valueOf-java.lang.String-"> 934<!-- --> 935</a> 936<ul class="blockList"> 937<li class="blockList"> 938<h4>valueOf</h4> 939<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/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> name)</pre> 940<div class="block">Returns the enum constant of this type with the specified name. 941The string must match <i>exactly</i> an identifier used to declare an 942enum constant in this type. (Extraneous whitespace characters are 943not permitted.)</div> 944<dl> 945<dt><span class="paramLabel">Parameters:</span></dt> 946<dd><code>name</code> - the name of the enum constant to be returned.</dd> 947<dt><span class="returnLabel">Returns:</span></dt> 948<dd>the enum constant with the specified name</dd> 949<dt><span class="throwsLabel">Throws:</span></dt> 950<dd><code><a href="http://docs.oracle.com/javase/6/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> 951<dd><code><a href="http://docs.oracle.com/javase/6/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> 952</dl> 953</li> 954</ul> 955<a name="enabledByDefault--"> 956<!-- --> 957</a> 958<ul class="blockList"> 959<li class="blockList"> 960<h4>enabledByDefault</h4> 961<pre>public boolean enabledByDefault()</pre> 962<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> 963<div class="block">Accessor for checking whether this feature is enabled by default.</div> 964<dl> 965<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 966<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> 967</dl> 968</li> 969</ul> 970<a name="getMask--"> 971<!-- --> 972</a> 973<ul class="blockList"> 974<li class="blockList"> 975<h4>getMask</h4> 976<pre>public int getMask()</pre> 977<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> 978<div class="block">Returns bit mask for this feature instance</div> 979<dl> 980<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 981<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> 982</dl> 983</li> 984</ul> 985<a name="enabledIn-int-"> 986<!-- --> 987</a> 988<ul class="blockListLast"> 989<li class="blockList"> 990<h4>enabledIn</h4> 991<pre>public boolean enabledIn(int flags)</pre> 992<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> 993<div class="block">Convenience method for checking whether feature is enabled in given bitmask</div> 994<dl> 995<dt><span class="overrideSpecifyLabel">Specified by:</span></dt> 996<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> 997</dl> 998</li> 999</ul> 1000</li> 1001</ul> 1002</li> 1003</ul> 1004</div> 1005</div> 1006<!-- ========= END OF CLASS DATA ========= --> 1007<!-- ======= START OF BOTTOM NAVBAR ====== --> 1008<div class="bottomNav"><a name="navbar.bottom"> 1009<!-- --> 1010</a> 1011<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> 1012<a name="navbar.bottom.firstrow"> 1013<!-- --> 1014</a> 1015<ul class="navList" title="Navigation"> 1016<li><a href="../../../../overview-summary.html">Overview</a></li> 1017<li><a href="package-summary.html">Package</a></li> 1018<li class="navBarCell1Rev">Class</li> 1019<li><a href="class-use/DeserializationFeature.html">Use</a></li> 1020<li><a href="package-tree.html">Tree</a></li> 1021<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 1022<li><a href="../../../../index-all.html">Index</a></li> 1023<li><a href="../../../../help-doc.html">Help</a></li> 1024</ul> 1025</div> 1026<div class="subNav"> 1027<ul class="navList"> 1028<li><a href="../../../../com/fasterxml/jackson/databind/DeserializationContext.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Prev Class</span></a></li> 1029<li><a href="../../../../com/fasterxml/jackson/databind/InjectableValues.html" title="class in com.fasterxml.jackson.databind"><span class="typeNameLink">Next Class</span></a></li> 1030</ul> 1031<ul class="navList"> 1032<li><a href="../../../../index.html?com/fasterxml/jackson/databind/DeserializationFeature.html" target="_top">Frames</a></li> 1033<li><a href="DeserializationFeature.html" target="_top">No Frames</a></li> 1034</ul> 1035<ul class="navList" id="allclasses_navbar_bottom"> 1036<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 1037</ul> 1038<div> 1039<script type="text/javascript"><!-- 1040 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 1041 if(window==top) { 1042 allClassesLink.style.display = "block"; 1043 } 1044 else { 1045 allClassesLink.style.display = "none"; 1046 } 1047 //--> 1048</script> 1049</div> 1050<div> 1051<ul class="subNavList"> 1052<li>Summary: </li> 1053<li>Nested | </li> 1054<li><a href="#enum.constant.summary">Enum Constants</a> | </li> 1055<li>Field | </li> 1056<li><a href="#method.summary">Method</a></li> 1057</ul> 1058<ul class="subNavList"> 1059<li>Detail: </li> 1060<li><a href="#enum.constant.detail">Enum Constants</a> | </li> 1061<li>Field | </li> 1062<li><a href="#method.detail">Method</a></li> 1063</ul> 1064</div> 1065<a name="skip.navbar.bottom"> 1066<!-- --> 1067</a></div> 1068<!-- ======== END OF BOTTOM NAVBAR ======= --> 1069<p class="legalCopy"><small>Copyright © 2014–2015 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 1070</body> 1071</html> 1072