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