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_10-ea) on Mon Apr 22 19:50:32 PDT 2013 --> 6<meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> 7<title>MapperFeature (jackson-databind 2.2.0 API)</title> 8<meta name="date" content="2013-04-22"> 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="MapperFeature (jackson-databind 2.2.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/MapperFeature.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/KeyDeserializer.None.html" title="class in com.fasterxml.jackson.databind"><span class="strong">Prev Class</span></a></li> 41<li><a href="../../../../com/fasterxml/jackson/databind/MappingIterator.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/MapperFeature.html" target="_top">Frames</a></li> 45<li><a href="MapperFeature.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 MapperFeature" class="title">Enum MapperFeature</h2> 85</div> 86<div class="contentContainer"> 87<ul class="inheritance"> 88<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> 89<li> 90<ul class="inheritance"> 91<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/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a>></li> 92<li> 93<ul class="inheritance"> 94<li>com.fasterxml.jackson.databind.MapperFeature</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/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/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a>></dd> 106</dl> 107<hr> 108<br> 109<pre>public enum <span class="strong">MapperFeature</span> 110extends <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/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</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 to set 113 for <a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a>, and accessible (but not changeable) 114 via <a href="../../../../com/fasterxml/jackson/databind/ObjectReader.html" title="class in com.fasterxml.jackson.databind"><code>ObjectReader</code></a> and <a href="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</code></a> (as well as 115 through various convenience methods through context objects). 116<p> 117 Note that in addition to being only mutable via <a href="../../../../com/fasterxml/jackson/databind/ObjectMapper.html" title="class in com.fasterxml.jackson.databind"><code>ObjectMapper</code></a>, 118 changes only take effect when done <b>before any serialization or 119 deserialization</b> calls -- that is, caller must follow 120 "configure-then-use" pattern.</div> 121</li> 122</ul> 123</div> 124<div class="summary"> 125<ul class="blockList"> 126<li class="blockList"> 127<!-- =========== ENUM CONSTANT SUMMARY =========== --> 128<ul class="blockList"> 129<li class="blockList"><a name="enum_constant_summary"> 130<!-- --> 131</a> 132<h3>Enum Constant Summary</h3> 133<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Enum Constant Summary table, listing enum constants, and an explanation"> 134<caption><span>Enum Constants</span><span class="tabEnd"> </span></caption> 135<tr> 136<th class="colOne" scope="col">Enum Constant and Description</th> 137</tr> 138<tr class="altColor"> 139<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#ALLOW_FINAL_FIELDS_AS_MUTATORS">ALLOW_FINAL_FIELDS_AS_MUTATORS</a></strong></code> 140<div class="block">Feature that determines whether member fields declared as 'final' may 141 be auto-detected to be used mutators (used to change value of the logical 142 property) or not.</div> 143</td> 144</tr> 145<tr class="rowColor"> 146<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#AUTO_DETECT_CREATORS">AUTO_DETECT_CREATORS</a></strong></code> 147<div class="block">Feature that determines whether "creator" methods are 148 automatically detected by consider public constructors, 149 and static single argument methods with name "valueOf".</div> 150</td> 151</tr> 152<tr class="altColor"> 153<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#AUTO_DETECT_FIELDS">AUTO_DETECT_FIELDS</a></strong></code> 154<div class="block">Feature that determines whether non-static fields are recognized as 155 properties.</div> 156</td> 157</tr> 158<tr class="rowColor"> 159<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#AUTO_DETECT_GETTERS">AUTO_DETECT_GETTERS</a></strong></code> 160<div class="block">Feature that determines whether regualr "getter" methods are 161 automatically detected based on standard Bean naming convention 162 or not.</div> 163</td> 164</tr> 165<tr class="altColor"> 166<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#AUTO_DETECT_IS_GETTERS">AUTO_DETECT_IS_GETTERS</a></strong></code> 167<div class="block">Feature that determines whether "is getter" methods are 168 automatically detected based on standard Bean naming convention 169 or not.</div> 170</td> 171</tr> 172<tr class="rowColor"> 173<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#AUTO_DETECT_SETTERS">AUTO_DETECT_SETTERS</a></strong></code> 174<div class="block">Feature that determines whether "setter" methods are 175 automatically detected based on standard Bean naming convention 176 or not.</div> 177</td> 178</tr> 179<tr class="altColor"> 180<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#CAN_OVERRIDE_ACCESS_MODIFIERS">CAN_OVERRIDE_ACCESS_MODIFIERS</a></strong></code> 181<div class="block">Feature that determines whether method and field access 182 modifier settings can be overridden when accessing 183 properties.</div> 184</td> 185</tr> 186<tr class="rowColor"> 187<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#DEFAULT_VIEW_INCLUSION">DEFAULT_VIEW_INCLUSION</a></strong></code> 188<div class="block">Feature that determines whether properties that have no view 189 annotations are included in JSON serialization views (see 190 <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.1.1/com/fasterxml/jackson/annotation/JsonView.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonView</code></a> for more 191 details on JSON Views).</div> 192</td> 193</tr> 194<tr class="altColor"> 195<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#INFER_PROPERTY_MUTATORS">INFER_PROPERTY_MUTATORS</a></strong></code> 196<div class="block">Feature that determines whether member mutators (fields and 197 setters) may be "pulled in" even if they are not visible, 198 as long as there is a visible accessor (getter or field) with same name.</div> 199</td> 200</tr> 201<tr class="rowColor"> 202<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#REQUIRE_SETTERS_FOR_GETTERS">REQUIRE_SETTERS_FOR_GETTERS</a></strong></code> 203<div class="block">Feature that determines whether getters (getter methods) 204 can be auto-detected if there is no matching mutator (setter, 205 constructor parameter or field) or not: if set to true, 206 only getters that match a mutator are auto-discovered; if 207 false, all auto-detectable getters can be discovered.</div> 208</td> 209</tr> 210<tr class="altColor"> 211<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#SORT_PROPERTIES_ALPHABETICALLY">SORT_PROPERTIES_ALPHABETICALLY</a></strong></code> 212<div class="block">Feature that defines default property serialization order used 213 for POJO fields (note: does <b>not</b> apply to <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> 214 serialization!): 215 if enabled, default ordering is alphabetic (similar to 216 how <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.1.1/com/fasterxml/jackson/annotation/JsonPropertyOrder.html?is-external=true#alphabetic()" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonPropertyOrder.alphabetic()</code></a> 217 works); if disabled, order is unspecified (based on what JDK gives 218 us, which may be declaration order, but is not guaranteed).</div> 219</td> 220</tr> 221<tr class="rowColor"> 222<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#USE_ANNOTATIONS">USE_ANNOTATIONS</a></strong></code> 223<div class="block">Feature that determines whether annotation introspection 224 is used for configuration; if enabled, configured 225 <a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.html" title="class in com.fasterxml.jackson.databind"><code>AnnotationIntrospector</code></a> will be used: if disabled, 226 no annotations are considered.</div> 227</td> 228</tr> 229<tr class="altColor"> 230<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#USE_GETTERS_AS_SETTERS">USE_GETTERS_AS_SETTERS</a></strong></code> 231<div class="block">Feature that determines whether otherwise regular "getter" 232 methods (but only ones that handle Collections and Maps, 233 not getters of other type) 234 can be used for purpose of getting a reference to a Collection 235 and Map to modify the property, without requiring a setter 236 method.</div> 237</td> 238</tr> 239<tr class="rowColor"> 240<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#USE_STATIC_TYPING">USE_STATIC_TYPING</a></strong></code> 241<div class="block">Feature that determines whether the type detection for 242 serialization should be using actual dynamic runtime type, 243 or declared static type.</div> 244</td> 245</tr> 246<tr class="altColor"> 247<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#USE_WRAPPER_NAME_AS_PROPERTY_NAME">USE_WRAPPER_NAME_AS_PROPERTY_NAME</a></strong></code> 248<div class="block">Feature that can be enabled to make property names be 249 overridden by wrapper name (usually detected with annotations 250 as defined by <a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.html#findWrapperName(com.fasterxml.jackson.databind.introspect.Annotated)"><code>AnnotationIntrospector.findWrapperName(com.fasterxml.jackson.databind.introspect.Annotated)</code></a>.</div> 251</td> 252</tr> 253</table> 254</li> 255</ul> 256<!-- ========== METHOD SUMMARY =========== --> 257<ul class="blockList"> 258<li class="blockList"><a name="method_summary"> 259<!-- --> 260</a> 261<h3>Method Summary</h3> 262<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 263<caption><span>Methods</span><span class="tabEnd"> </span></caption> 264<tr> 265<th class="colFirst" scope="col">Modifier and Type</th> 266<th class="colLast" scope="col">Method and Description</th> 267</tr> 268<tr class="altColor"> 269<td class="colFirst"><code>boolean</code></td> 270<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#enabledByDefault()">enabledByDefault</a></strong>()</code> 271<div class="block">Accessor for checking whether this feature is enabled by default.</div> 272</td> 273</tr> 274<tr class="rowColor"> 275<td class="colFirst"><code>int</code></td> 276<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#getMask()">getMask</a></strong>()</code> 277<div class="block">Returns bit mask for this feature instance</div> 278</td> 279</tr> 280<tr class="altColor"> 281<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a></code></td> 282<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#valueOf(java.lang.String)">valueOf</a></strong>(<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> 283<div class="block">Returns the enum constant of this type with the specified name.</div> 284</td> 285</tr> 286<tr class="rowColor"> 287<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a>[]</code></td> 288<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#values()">values</a></strong>()</code> 289<div class="block">Returns an array containing the constants of this enum type, in 290the order they are declared.</div> 291</td> 292</tr> 293</table> 294<ul class="blockList"> 295<li class="blockList"><a name="methods_inherited_from_class_java.lang.Enum"> 296<!-- --> 297</a> 298<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> 299<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> 300</ul> 301<ul class="blockList"> 302<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> 303<!-- --> 304</a> 305<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> 306<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> 307</ul> 308</li> 309</ul> 310</li> 311</ul> 312</div> 313<div class="details"> 314<ul class="blockList"> 315<li class="blockList"> 316<!-- ============ ENUM CONSTANT DETAIL =========== --> 317<ul class="blockList"> 318<li class="blockList"><a name="enum_constant_detail"> 319<!-- --> 320</a> 321<h3>Enum Constant Detail</h3> 322<a name="USE_ANNOTATIONS"> 323<!-- --> 324</a> 325<ul class="blockList"> 326<li class="blockList"> 327<h4>USE_ANNOTATIONS</h4> 328<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> USE_ANNOTATIONS</pre> 329<div class="block">Feature that determines whether annotation introspection 330 is used for configuration; if enabled, configured 331 <a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.html" title="class in com.fasterxml.jackson.databind"><code>AnnotationIntrospector</code></a> will be used: if disabled, 332 no annotations are considered. 333<p> 334 Feature is enabled by default.</div> 335</li> 336</ul> 337<a name="AUTO_DETECT_CREATORS"> 338<!-- --> 339</a> 340<ul class="blockList"> 341<li class="blockList"> 342<h4>AUTO_DETECT_CREATORS</h4> 343<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> AUTO_DETECT_CREATORS</pre> 344<div class="block">Feature that determines whether "creator" methods are 345 automatically detected by consider public constructors, 346 and static single argument methods with name "valueOf". 347 If disabled, only methods explicitly annotated are considered 348 creator methods (except for the no-arg default constructor which 349 is always considered a factory method). 350<p> 351 Note that this feature has lower precedence than per-class 352 annotations, and is only used if there isn't more granular 353 configuration available. 354<P> 355 Feature is enabled by default.</div> 356</li> 357</ul> 358<a name="AUTO_DETECT_FIELDS"> 359<!-- --> 360</a> 361<ul class="blockList"> 362<li class="blockList"> 363<h4>AUTO_DETECT_FIELDS</h4> 364<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> AUTO_DETECT_FIELDS</pre> 365<div class="block">Feature that determines whether non-static fields are recognized as 366 properties. 367 If yes, then all public member fields 368 are considered as properties. If disabled, only fields explicitly 369 annotated are considered property fields. 370<p> 371 Note that this feature has lower precedence than per-class 372 annotations, and is only used if there isn't more granular 373 configuration available. 374<p> 375 Feature is enabled by default.</div> 376</li> 377</ul> 378<a name="AUTO_DETECT_GETTERS"> 379<!-- --> 380</a> 381<ul class="blockList"> 382<li class="blockList"> 383<h4>AUTO_DETECT_GETTERS</h4> 384<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> AUTO_DETECT_GETTERS</pre> 385<div class="block">Feature that determines whether regualr "getter" methods are 386 automatically detected based on standard Bean naming convention 387 or not. If yes, then all public zero-argument methods that 388 start with prefix "get" 389 are considered as getters. 390 If disabled, only methods explicitly annotated are considered getters. 391<p> 392 Note that since version 1.3, this does <b>NOT</b> include 393 "is getters" (see <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html#AUTO_DETECT_IS_GETTERS"><code>AUTO_DETECT_IS_GETTERS</code></a> for details) 394<p> 395 Note that this feature has lower precedence than per-class 396 annotations, and is only used if there isn't more granular 397 configuration available. 398<p> 399 Feature is enabled by default.</div> 400</li> 401</ul> 402<a name="AUTO_DETECT_IS_GETTERS"> 403<!-- --> 404</a> 405<ul class="blockList"> 406<li class="blockList"> 407<h4>AUTO_DETECT_IS_GETTERS</h4> 408<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> AUTO_DETECT_IS_GETTERS</pre> 409<div class="block">Feature that determines whether "is getter" methods are 410 automatically detected based on standard Bean naming convention 411 or not. If yes, then all public zero-argument methods that 412 start with prefix "is", and whose return type is boolean 413 are considered as "is getters". 414 If disabled, only methods explicitly annotated are considered getters. 415<p> 416 Note that this feature has lower precedence than per-class 417 annotations, and is only used if there isn't more granular 418 configuration available. 419<p> 420 Feature is enabled by default.</div> 421</li> 422</ul> 423<a name="AUTO_DETECT_SETTERS"> 424<!-- --> 425</a> 426<ul class="blockList"> 427<li class="blockList"> 428<h4>AUTO_DETECT_SETTERS</h4> 429<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> AUTO_DETECT_SETTERS</pre> 430<div class="block">Feature that determines whether "setter" methods are 431 automatically detected based on standard Bean naming convention 432 or not. If yes, then all public one-argument methods that 433 start with prefix "set" 434 are considered setters. If disabled, only methods explicitly 435 annotated are considered setters. 436<p> 437 Note that this feature has lower precedence than per-class 438 annotations, and is only used if there isn't more granular 439 configuration available. 440<P> 441 Feature is enabled by default.</div> 442</li> 443</ul> 444<a name="REQUIRE_SETTERS_FOR_GETTERS"> 445<!-- --> 446</a> 447<ul class="blockList"> 448<li class="blockList"> 449<h4>REQUIRE_SETTERS_FOR_GETTERS</h4> 450<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> REQUIRE_SETTERS_FOR_GETTERS</pre> 451<div class="block">Feature that determines whether getters (getter methods) 452 can be auto-detected if there is no matching mutator (setter, 453 constructor parameter or field) or not: if set to true, 454 only getters that match a mutator are auto-discovered; if 455 false, all auto-detectable getters can be discovered. 456<p> 457 Feature is disabled by default.</div> 458</li> 459</ul> 460<a name="USE_GETTERS_AS_SETTERS"> 461<!-- --> 462</a> 463<ul class="blockList"> 464<li class="blockList"> 465<h4>USE_GETTERS_AS_SETTERS</h4> 466<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> USE_GETTERS_AS_SETTERS</pre> 467<div class="block">Feature that determines whether otherwise regular "getter" 468 methods (but only ones that handle Collections and Maps, 469 not getters of other type) 470 can be used for purpose of getting a reference to a Collection 471 and Map to modify the property, without requiring a setter 472 method. 473 This is similar to how JAXB framework sets Collections and 474 Maps: no setter is involved, just setter. 475<p> 476 Note that such getters-as-setters methods have lower 477 precedence than setters, so they are only used if no 478 setter is found for the Map/Collection property. 479<p> 480 Feature is enabled by default.</div> 481</li> 482</ul> 483<a name="CAN_OVERRIDE_ACCESS_MODIFIERS"> 484<!-- --> 485</a> 486<ul class="blockList"> 487<li class="blockList"> 488<h4>CAN_OVERRIDE_ACCESS_MODIFIERS</h4> 489<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> CAN_OVERRIDE_ACCESS_MODIFIERS</pre> 490<div class="block">Feature that determines whether method and field access 491 modifier settings can be overridden when accessing 492 properties. If enabled, method 493 <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/reflect/AccessibleObject.html?is-external=true#setAccessible(java.lang.reflect.AccessibleObject[], boolean)" title="class or interface in java.lang.reflect"><code>AccessibleObject.setAccessible(java.lang.reflect.AccessibleObject[], boolean)</code></a> 494 may be called to enable access to otherwise unaccessible 495 objects. 496<p> 497 Feature is enabled by default.</div> 498</li> 499</ul> 500<a name="INFER_PROPERTY_MUTATORS"> 501<!-- --> 502</a> 503<ul class="blockList"> 504<li class="blockList"> 505<h4>INFER_PROPERTY_MUTATORS</h4> 506<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> INFER_PROPERTY_MUTATORS</pre> 507<div class="block">Feature that determines whether member mutators (fields and 508 setters) may be "pulled in" even if they are not visible, 509 as long as there is a visible accessor (getter or field) with same name. 510 For example: field "value" may be inferred as mutator, 511 if there is visible or explicitly marked getter "getValue()". 512 If enabled, inferring is enabled; otherwise (disabled) only visible and 513 explicitly annotated accessors are ever used. 514<p> 515 Note that 'getters' are never inferred and need to be either visible (including 516 bean-style naming) or explicitly annotated. 517<p> 518 Feature is enabled by default.</div> 519<dl><dt><span class="strong">Since:</span></dt> 520 <dd>2.2</dd></dl> 521</li> 522</ul> 523<a name="ALLOW_FINAL_FIELDS_AS_MUTATORS"> 524<!-- --> 525</a> 526<ul class="blockList"> 527<li class="blockList"> 528<h4>ALLOW_FINAL_FIELDS_AS_MUTATORS</h4> 529<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> ALLOW_FINAL_FIELDS_AS_MUTATORS</pre> 530<div class="block">Feature that determines whether member fields declared as 'final' may 531 be auto-detected to be used mutators (used to change value of the logical 532 property) or not. If enabled, 'final' access modifier has no effect, and 533 such fields may be detected according to usual visibility and inference 534 rules; if disabled, such fields are NOT used as mutators except if 535 explicitly annotated for such use. 536<p> 537 Feature is enabled by default, for backwards compatibility reasons.</div> 538</li> 539</ul> 540<a name="USE_STATIC_TYPING"> 541<!-- --> 542</a> 543<ul class="blockList"> 544<li class="blockList"> 545<h4>USE_STATIC_TYPING</h4> 546<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> USE_STATIC_TYPING</pre> 547<div class="block">Feature that determines whether the type detection for 548 serialization should be using actual dynamic runtime type, 549 or declared static type. 550 Note that deserialization always uses declared static types 551 since no runtime types are available (as we are creating 552 instances after using type information). 553<p> 554 This global default value can be overridden at class, method 555 or field level by using <a href="../../../../com/fasterxml/jackson/databind/annotation/JsonSerialize.html#typing()"><code>JsonSerialize.typing()</code></a> annotation 556 property. 557<p> 558 Feature is disabled by default which means that dynamic runtime types 559 are used (instead of declared static types) for serialization.</div> 560</li> 561</ul> 562<a name="DEFAULT_VIEW_INCLUSION"> 563<!-- --> 564</a> 565<ul class="blockList"> 566<li class="blockList"> 567<h4>DEFAULT_VIEW_INCLUSION</h4> 568<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> DEFAULT_VIEW_INCLUSION</pre> 569<div class="block">Feature that determines whether properties that have no view 570 annotations are included in JSON serialization views (see 571 <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.1.1/com/fasterxml/jackson/annotation/JsonView.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonView</code></a> for more 572 details on JSON Views). 573 If enabled, non-annotated properties will be included; 574 when disabled, they will be excluded. So this feature 575 changes between "opt-in" (feature disabled) and 576 "opt-out" (feature enabled) modes. 577<p> 578 Default value is enabled, meaning that non-annotated 579 properties are included in all views if there is no 580 <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.1.1/com/fasterxml/jackson/annotation/JsonView.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonView</code></a> annotation. 581<p> 582 Feature is enabled by default.</div> 583</li> 584</ul> 585<a name="SORT_PROPERTIES_ALPHABETICALLY"> 586<!-- --> 587</a> 588<ul class="blockList"> 589<li class="blockList"> 590<h4>SORT_PROPERTIES_ALPHABETICALLY</h4> 591<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> SORT_PROPERTIES_ALPHABETICALLY</pre> 592<div class="block">Feature that defines default property serialization order used 593 for POJO fields (note: does <b>not</b> apply to <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> 594 serialization!): 595 if enabled, default ordering is alphabetic (similar to 596 how <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.1.1/com/fasterxml/jackson/annotation/JsonPropertyOrder.html?is-external=true#alphabetic()" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonPropertyOrder.alphabetic()</code></a> 597 works); if disabled, order is unspecified (based on what JDK gives 598 us, which may be declaration order, but is not guaranteed). 599<p> 600 Note that this is just the default behavior, and can be overridden by 601 explicit overrides in classes. 602<p> 603 Feature is disabled by default.</div> 604</li> 605</ul> 606<a name="USE_WRAPPER_NAME_AS_PROPERTY_NAME"> 607<!-- --> 608</a> 609<ul class="blockListLast"> 610<li class="blockList"> 611<h4>USE_WRAPPER_NAME_AS_PROPERTY_NAME</h4> 612<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a> USE_WRAPPER_NAME_AS_PROPERTY_NAME</pre> 613<div class="block">Feature that can be enabled to make property names be 614 overridden by wrapper name (usually detected with annotations 615 as defined by <a href="../../../../com/fasterxml/jackson/databind/AnnotationIntrospector.html#findWrapperName(com.fasterxml.jackson.databind.introspect.Annotated)"><code>AnnotationIntrospector.findWrapperName(com.fasterxml.jackson.databind.introspect.Annotated)</code></a>. 616 If enabled, all properties that have associated non-empty Wrapper 617 name will use that wrapper name instead of property name. 618 If disabled, wrapper name is only used for wrapping (if anything). 619<p> 620 Feature is disabled by default.</div> 621<dl><dt><span class="strong">Since:</span></dt> 622 <dd>2.1</dd></dl> 623</li> 624</ul> 625</li> 626</ul> 627<!-- ============ METHOD DETAIL ========== --> 628<ul class="blockList"> 629<li class="blockList"><a name="method_detail"> 630<!-- --> 631</a> 632<h3>Method Detail</h3> 633<a name="values()"> 634<!-- --> 635</a> 636<ul class="blockList"> 637<li class="blockList"> 638<h4>values</h4> 639<pre>public static <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</a>[] values()</pre> 640<div class="block">Returns an array containing the constants of this enum type, in 641the order they are declared. This method may be used to iterate 642over the constants as follows: 643<pre> 644for (MapperFeature c : MapperFeature.values()) 645 System.out.println(c); 646</pre></div> 647<dl><dt><span class="strong">Returns:</span></dt><dd>an array containing the constants of this enum type, in 648the order they are declared</dd></dl> 649</li> 650</ul> 651<a name="valueOf(java.lang.String)"> 652<!-- --> 653</a> 654<ul class="blockList"> 655<li class="blockList"> 656<h4>valueOf</h4> 657<pre>public static <a href="../../../../com/fasterxml/jackson/databind/MapperFeature.html" title="enum in com.fasterxml.jackson.databind">MapperFeature</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> 658<div class="block">Returns the enum constant of this type with the specified name. 659The string must match <i>exactly</i> an identifier used to declare an 660enum constant in this type. (Extraneous whitespace characters are 661not permitted.)</div> 662<dl><dt><span class="strong">Parameters:</span></dt><dd><code>name</code> - the name of the enum constant to be returned.</dd> 663<dt><span class="strong">Returns:</span></dt><dd>the enum constant with the specified name</dd> 664<dt><span class="strong">Throws:</span></dt> 665<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 666with the specified name</dd> 667<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></dl> 668</li> 669</ul> 670<a name="enabledByDefault()"> 671<!-- --> 672</a> 673<ul class="blockList"> 674<li class="blockList"> 675<h4>enabledByDefault</h4> 676<pre>public boolean enabledByDefault()</pre> 677<div class="block"><strong>Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#enabledByDefault()">ConfigFeature</a></code></strong></div> 678<div class="block">Accessor for checking whether this feature is enabled by default.</div> 679<dl> 680<dt><strong>Specified by:</strong></dt> 681<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> 682</dl> 683</li> 684</ul> 685<a name="getMask()"> 686<!-- --> 687</a> 688<ul class="blockListLast"> 689<li class="blockList"> 690<h4>getMask</h4> 691<pre>public int getMask()</pre> 692<div class="block"><strong>Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#getMask()">ConfigFeature</a></code></strong></div> 693<div class="block">Returns bit mask for this feature instance</div> 694<dl> 695<dt><strong>Specified by:</strong></dt> 696<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> 697</dl> 698</li> 699</ul> 700</li> 701</ul> 702</li> 703</ul> 704</div> 705</div> 706<!-- ========= END OF CLASS DATA ========= --> 707<!-- ======= START OF BOTTOM NAVBAR ====== --> 708<div class="bottomNav"><a name="navbar_bottom"> 709<!-- --> 710</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> 711<!-- --> 712</a> 713<ul class="navList" title="Navigation"> 714<li><a href="../../../../overview-summary.html">Overview</a></li> 715<li><a href="package-summary.html">Package</a></li> 716<li class="navBarCell1Rev">Class</li> 717<li><a href="class-use/MapperFeature.html">Use</a></li> 718<li><a href="package-tree.html">Tree</a></li> 719<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 720<li><a href="../../../../index-all.html">Index</a></li> 721<li><a href="../../../../help-doc.html">Help</a></li> 722</ul> 723</div> 724<div class="subNav"> 725<ul class="navList"> 726<li><a href="../../../../com/fasterxml/jackson/databind/KeyDeserializer.None.html" title="class in com.fasterxml.jackson.databind"><span class="strong">Prev Class</span></a></li> 727<li><a href="../../../../com/fasterxml/jackson/databind/MappingIterator.html" title="class in com.fasterxml.jackson.databind"><span class="strong">Next Class</span></a></li> 728</ul> 729<ul class="navList"> 730<li><a href="../../../../index.html?com/fasterxml/jackson/databind/MapperFeature.html" target="_top">Frames</a></li> 731<li><a href="MapperFeature.html" target="_top">No Frames</a></li> 732</ul> 733<ul class="navList" id="allclasses_navbar_bottom"> 734<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 735</ul> 736<div> 737<script type="text/javascript"><!-- 738 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 739 if(window==top) { 740 allClassesLink.style.display = "block"; 741 } 742 else { 743 allClassesLink.style.display = "none"; 744 } 745 //--> 746</script> 747</div> 748<div> 749<ul class="subNavList"> 750<li>Summary: </li> 751<li>Nested | </li> 752<li><a href="#enum_constant_summary">Enum Constants</a> | </li> 753<li>Field | </li> 754<li><a href="#method_summary">Method</a></li> 755</ul> 756<ul class="subNavList"> 757<li>Detail: </li> 758<li><a href="#enum_constant_detail">Enum Constants</a> | </li> 759<li>Field | </li> 760<li><a href="#method_detail">Method</a></li> 761</ul> 762</div> 763<a name="skip-navbar_bottom"> 764<!-- --> 765</a></div> 766<!-- ======== END OF BOTTOM NAVBAR ======= --> 767<p class="legalCopy"><small>Copyright © 2012-2013 <a href="http://fasterxml.com/">FasterXML</a>. All Rights Reserved.</small></p> 768</body> 769</html> 770