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_25) on Mon Jun 02 17:48:55 PDT 2014 --> 6<meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> 7<title>SerializationFeature (jackson-databind 2.4.0 API)</title> 8<meta name="date" content="2014-06-02"> 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="SerializationFeature (jackson-databind 2.4.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/SerializationFeature.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/SerializationConfig.html" title="class in com.fasterxml.jackson.databind"><span class="strong">Prev Class</span></a></li> 41<li><a href="../../../../com/fasterxml/jackson/databind/SerializerProvider.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/SerializationFeature.html" target="_top">Frames</a></li> 45<li><a href="SerializationFeature.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 SerializationFeature" class="title">Enum SerializationFeature</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/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a>></li> 92<li> 93<ul class="inheritance"> 94<li>com.fasterxml.jackson.databind.SerializationFeature</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/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a>></dd> 106</dl> 107<hr> 108<br> 109<pre>public enum <span class="strong">SerializationFeature</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/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</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 serialized. 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/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</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/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</code></a>.</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/SerializationFeature.html#CLOSE_CLOSEABLE">CLOSE_CLOSEABLE</a></strong></code> 140<div class="block">Feature that determines whether <code>close</code> method of 141 serialized <b>root level</b> objects (ones for which <code>ObjectMapper</code>'s 142 writeValue() (or equivalent) method is called) 143 that implement <a href="http://docs.oracle.com/javase/6/docs/api/java/io/Closeable.html?is-external=true" title="class or interface in java.io"><code>Closeable</code></a> 144 is called after serialization or not.</div> 145</td> 146</tr> 147<tr class="rowColor"> 148<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#EAGER_SERIALIZER_FETCH">EAGER_SERIALIZER_FETCH</a></strong></code> 149<div class="block">Feature that determines whether <a href="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</code></a> should 150 try to eagerly fetch necessary <a href="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind"><code>JsonSerializer</code></a> when 151 possible.</div> 152</td> 153</tr> 154<tr class="altColor"> 155<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#FAIL_ON_EMPTY_BEANS">FAIL_ON_EMPTY_BEANS</a></strong></code> 156<div class="block">Feature that determines what happens when no accessors are 157 found for a type (and there are no annotations to indicate 158 it is meant to be serialized).</div> 159</td> 160</tr> 161<tr class="rowColor"> 162<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#FAIL_ON_SELF_REFERENCES">FAIL_ON_SELF_REFERENCES</a></strong></code> 163<div class="block">Feature that determines what happens when a direct self-reference 164 is detected by a POJO (and no Object Id handling is enabled for it): 165 either a <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> is 166 thrown (if true), or reference is normally processed (false).</div> 167</td> 168</tr> 169<tr class="altColor"> 170<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#FAIL_ON_UNWRAPPED_TYPE_IDENTIFIERS">FAIL_ON_UNWRAPPED_TYPE_IDENTIFIERS</a></strong></code> 171<div class="block">Feature that determines what happens when an object which 172 normally has type information included by Jackson is used 173 in conjunction with <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.4/com/fasterxml/jackson/annotation/JsonUnwrapped.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonUnwrapped</code></a>.</div> 174</td> 175</tr> 176<tr class="rowColor"> 177<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#FLUSH_AFTER_WRITE_VALUE">FLUSH_AFTER_WRITE_VALUE</a></strong></code> 178<div class="block">Feature that determines whether <code>JsonGenerator.flush()</code> is 179 called after <code>writeValue()</code> method <b>that takes JsonGenerator 180 as an argument</b> completes (i.e.</div> 181</td> 182</tr> 183<tr class="altColor"> 184<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#INDENT_OUTPUT">INDENT_OUTPUT</a></strong></code> 185<div class="block">Feature that allows enabling (or disabling) indentation 186 for the underlying generator, using the default pretty 187 printer (see 188 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.4/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true#useDefaultPrettyPrinter()" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator.useDefaultPrettyPrinter()</code></a> 189 for details).</div> 190</td> 191</tr> 192<tr class="rowColor"> 193<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#ORDER_MAP_ENTRIES_BY_KEYS">ORDER_MAP_ENTRIES_BY_KEYS</a></strong></code> 194<div class="block">Feature that determines whether <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> entries are first 195 sorted by key before serialization or not: if enabled, additional sorting 196 step is performed if necessary (not necessary for <a href="http://docs.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util"><code>SortedMap</code></a>s), 197 if disabled, no additional sorting is needed.</div> 198</td> 199</tr> 200<tr class="altColor"> 201<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#USE_EQUALITY_FOR_OBJECT_ID">USE_EQUALITY_FOR_OBJECT_ID</a></strong></code> 202<div class="block">Feature that determines whether Object Identity is compared using 203 true JVM-level identity of Object (false); or, <code>equals()</code> method.</div> 204</td> 205</tr> 206<tr class="rowColor"> 207<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_EXCEPTIONS">WRAP_EXCEPTIONS</a></strong></code> 208<div class="block">Feature that determines whether Jackson code should catch 209 and wrap <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang"><code>Exception</code></a>s (but never <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 210 to add additional information about 211 location (within input) of problem or not.</div> 212</td> 213</tr> 214<tr class="altColor"> 215<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRAP_ROOT_VALUE">WRAP_ROOT_VALUE</a></strong></code> 216<div class="block">Feature that can be enabled to make root value (usually JSON 217 Object but can be any type) wrapped within a single property 218 JSON object, where key as the "root name", as determined by 219 annotation introspector (esp.</div> 220</td> 221</tr> 222<tr class="rowColor"> 223<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_BIGDECIMAL_AS_PLAIN">WRITE_BIGDECIMAL_AS_PLAIN</a></strong></code> 224<div class="block">Feature that determines whether <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a> entries are 225 serialized using <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true#toPlainString()" title="class or interface in java.math"><code>BigDecimal.toPlainString()</code></a> to prevent 226 values to be written using scientific notation.</div> 227</td> 228</tr> 229<tr class="altColor"> 230<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_CHAR_ARRAYS_AS_JSON_ARRAYS">WRITE_CHAR_ARRAYS_AS_JSON_ARRAYS</a></strong></code> 231<div class="block">Feature that determines how type <code>char[]</code> is serialized: 232 when enabled, will be serialized as an explict JSON array (with 233 single-character Strings as values); when disabled, defaults to 234 serializing them as Strings (which is more compact).</div> 235</td> 236</tr> 237<tr class="rowColor"> 238<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_DATE_KEYS_AS_TIMESTAMPS">WRITE_DATE_KEYS_AS_TIMESTAMPS</a></strong></code> 239<div class="block">Feature that determines whether <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Date.html?is-external=true" title="class or interface in java.util"><code>Date</code></a>s 240 (and sub-types) used as <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> keys are serialized 241 as timestamps or not (if not, will be serialized as textual 242 values).</div> 243</td> 244</tr> 245<tr class="altColor"> 246<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS">WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS</a></strong></code> 247<div class="block">Feature that controls whether numeric timestamp values are 248 to be written using nanosecond timestamps (enabled) or not (disabled); 249 <b>if and only if</b> datatype supports such resolution.</div> 250</td> 251</tr> 252<tr class="rowColor"> 253<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_DATES_AS_TIMESTAMPS">WRITE_DATES_AS_TIMESTAMPS</a></strong></code> 254<div class="block">Feature that determines whether <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Date.html?is-external=true" title="class or interface in java.util"><code>Date</code></a> values 255 (and Date-based things like <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Calendar.html?is-external=true" title="class or interface in java.util"><code>Calendar</code></a>s) are to be 256 serialized as numeric timestamps (true; the default), 257 or as something else (usually textual representation).</div> 258</td> 259</tr> 260<tr class="altColor"> 261<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_EMPTY_JSON_ARRAYS">WRITE_EMPTY_JSON_ARRAYS</a></strong></code> 262<div class="block">Feature that determines whether Container properties (POJO properties 263 with declared value of Collection or array; i.e.</div> 264</td> 265</tr> 266<tr class="rowColor"> 267<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_ENUMS_USING_INDEX">WRITE_ENUMS_USING_INDEX</a></strong></code> 268<div class="block">Feature that determines whethere Java Enum values are serialized 269 as numbers (true), or textual values (false).</div> 270</td> 271</tr> 272<tr class="altColor"> 273<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_ENUMS_USING_TO_STRING">WRITE_ENUMS_USING_TO_STRING</a></strong></code> 274<div class="block">Feature that determines standard serialization mechanism used for 275 Enum values: if enabled, return value of <code>Enum.toString()</code> 276 is used; if disabled, return value of <code>Enum.name()</code> is used.</div> 277</td> 278</tr> 279<tr class="rowColor"> 280<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_NULL_MAP_VALUES">WRITE_NULL_MAP_VALUES</a></strong></code> 281<div class="block">Feature that determines whether Map entries with null values are 282 to be serialized (true) or not (false).</div> 283</td> 284</tr> 285<tr class="altColor"> 286<td class="colOne"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED">WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED</a></strong></code> 287<div class="block">Feature added for interoperability, to work with oddities of 288 so-called "BadgerFish" convention.</div> 289</td> 290</tr> 291</table> 292</li> 293</ul> 294<!-- ========== METHOD SUMMARY =========== --> 295<ul class="blockList"> 296<li class="blockList"><a name="method_summary"> 297<!-- --> 298</a> 299<h3>Method Summary</h3> 300<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> 301<caption><span>Methods</span><span class="tabEnd"> </span></caption> 302<tr> 303<th class="colFirst" scope="col">Modifier and Type</th> 304<th class="colLast" scope="col">Method and Description</th> 305</tr> 306<tr class="altColor"> 307<td class="colFirst"><code>boolean</code></td> 308<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#enabledByDefault()">enabledByDefault</a></strong>()</code> 309<div class="block">Accessor for checking whether this feature is enabled by default.</div> 310</td> 311</tr> 312<tr class="rowColor"> 313<td class="colFirst"><code>int</code></td> 314<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#getMask()">getMask</a></strong>()</code> 315<div class="block">Returns bit mask for this feature instance</div> 316</td> 317</tr> 318<tr class="altColor"> 319<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a></code></td> 320<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.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> 321<div class="block">Returns the enum constant of this type with the specified name.</div> 322</td> 323</tr> 324<tr class="rowColor"> 325<td class="colFirst"><code>static <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a>[]</code></td> 326<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#values()">values</a></strong>()</code> 327<div class="block">Returns an array containing the constants of this enum type, in 328the order they are declared.</div> 329</td> 330</tr> 331</table> 332<ul class="blockList"> 333<li class="blockList"><a name="methods_inherited_from_class_java.lang.Enum"> 334<!-- --> 335</a> 336<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> 337<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> 338</ul> 339<ul class="blockList"> 340<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> 341<!-- --> 342</a> 343<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> 344<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> 345</ul> 346</li> 347</ul> 348</li> 349</ul> 350</div> 351<div class="details"> 352<ul class="blockList"> 353<li class="blockList"> 354<!-- ============ ENUM CONSTANT DETAIL =========== --> 355<ul class="blockList"> 356<li class="blockList"><a name="enum_constant_detail"> 357<!-- --> 358</a> 359<h3>Enum Constant Detail</h3> 360<a name="WRAP_ROOT_VALUE"> 361<!-- --> 362</a> 363<ul class="blockList"> 364<li class="blockList"> 365<h4>WRAP_ROOT_VALUE</h4> 366<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRAP_ROOT_VALUE</pre> 367<div class="block">Feature that can be enabled to make root value (usually JSON 368 Object but can be any type) wrapped within a single property 369 JSON object, where key as the "root name", as determined by 370 annotation introspector (esp. for JAXB that uses 371 <code>@XmlRootElement.name</code>) or fallback (non-qualified 372 class name). 373 Feature is mostly intended for JAXB compatibility. 374<p> 375 Feature is disabled by default.</div> 376</li> 377</ul> 378<a name="INDENT_OUTPUT"> 379<!-- --> 380</a> 381<ul class="blockList"> 382<li class="blockList"> 383<h4>INDENT_OUTPUT</h4> 384<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> INDENT_OUTPUT</pre> 385<div class="block">Feature that allows enabling (or disabling) indentation 386 for the underlying generator, using the default pretty 387 printer (see 388 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.4/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true#useDefaultPrettyPrinter()" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator.useDefaultPrettyPrinter()</code></a> 389 for details). 390<p> 391 Note that this only affects cases where 392 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.4/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator</code></a> 393 is constructed implicitly by ObjectMapper: if explicit 394 generator is passed, its configuration is not changed. 395<p> 396 Also note that if you want to configure details of indentation, 397 you need to directly configure the generator: there is a 398 method to use any <code>PrettyPrinter</code> instance. 399 This feature will only allow using the default implementation. 400<p> 401 Feature is enabled by default.</div> 402</li> 403</ul> 404<a name="FAIL_ON_EMPTY_BEANS"> 405<!-- --> 406</a> 407<ul class="blockList"> 408<li class="blockList"> 409<h4>FAIL_ON_EMPTY_BEANS</h4> 410<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> FAIL_ON_EMPTY_BEANS</pre> 411<div class="block">Feature that determines what happens when no accessors are 412 found for a type (and there are no annotations to indicate 413 it is meant to be serialized). If enabled (default), an 414 exception is thrown to indicate these as non-serializable 415 types; if disabled, they are serialized as empty Objects, 416 i.e. without any properties. 417<p> 418 Note that empty types that this feature has only effect on 419 those "empty" beans that do not have any recognized annotations 420 (like <code>@JsonSerialize</code>): ones that do have annotations 421 do not result in an exception being thrown. 422<p> 423 Feature is enabled by default.</div> 424</li> 425</ul> 426<a name="FAIL_ON_SELF_REFERENCES"> 427<!-- --> 428</a> 429<ul class="blockList"> 430<li class="blockList"> 431<h4>FAIL_ON_SELF_REFERENCES</h4> 432<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> FAIL_ON_SELF_REFERENCES</pre> 433<div class="block">Feature that determines what happens when a direct self-reference 434 is detected by a POJO (and no Object Id handling is enabled for it): 435 either a <a href="../../../../com/fasterxml/jackson/databind/JsonMappingException.html" title="class in com.fasterxml.jackson.databind"><code>JsonMappingException</code></a> is 436 thrown (if true), or reference is normally processed (false). 437<p> 438 Feature is enabled by default.</div> 439<dl><dt><span class="strong">Since:</span></dt> 440 <dd>2.4</dd></dl> 441</li> 442</ul> 443<a name="WRAP_EXCEPTIONS"> 444<!-- --> 445</a> 446<ul class="blockList"> 447<li class="blockList"> 448<h4>WRAP_EXCEPTIONS</h4> 449<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRAP_EXCEPTIONS</pre> 450<div class="block">Feature that determines whether Jackson code should catch 451 and wrap <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang"><code>Exception</code></a>s (but never <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Error.html?is-external=true" title="class or interface in java.lang"><code>Error</code></a>s!) 452 to add additional information about 453 location (within input) of problem or not. If enabled, 454 most exceptions will be caught and re-thrown (exception 455 specifically being that <a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io"><code>IOException</code></a>s may be passed 456 as is, since they are declared as throwable); this can be 457 convenient both in that all exceptions will be checked and 458 declared, and so there is more contextual information. 459 However, sometimes calling application may just want "raw" 460 unchecked exceptions passed as is. 461<p> 462<p> 463 Feature is enabled by default.</div> 464</li> 465</ul> 466<a name="FAIL_ON_UNWRAPPED_TYPE_IDENTIFIERS"> 467<!-- --> 468</a> 469<ul class="blockList"> 470<li class="blockList"> 471<h4>FAIL_ON_UNWRAPPED_TYPE_IDENTIFIERS</h4> 472<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> FAIL_ON_UNWRAPPED_TYPE_IDENTIFIERS</pre> 473<div class="block">Feature that determines what happens when an object which 474 normally has type information included by Jackson is used 475 in conjunction with <a href="http://fasterxml.github.com/jackson-annotations/javadoc/2.4/com/fasterxml/jackson/annotation/JsonUnwrapped.html?is-external=true" title="class or interface in com.fasterxml.jackson.annotation"><code>JsonUnwrapped</code></a>. 476 In the default (enabled) state, an error will be thrown when 477 an unwrapped object has type information. When disabled, the 478 object will be unwrapped and the type information discarded. 479<p> 480 Feature is enabled by default.</div> 481<dl><dt><span class="strong">Since:</span></dt> 482 <dd>2.4</dd></dl> 483</li> 484</ul> 485<a name="CLOSE_CLOSEABLE"> 486<!-- --> 487</a> 488<ul class="blockList"> 489<li class="blockList"> 490<h4>CLOSE_CLOSEABLE</h4> 491<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> CLOSE_CLOSEABLE</pre> 492<div class="block">Feature that determines whether <code>close</code> method of 493 serialized <b>root level</b> objects (ones for which <code>ObjectMapper</code>'s 494 writeValue() (or equivalent) method is called) 495 that implement <a href="http://docs.oracle.com/javase/6/docs/api/java/io/Closeable.html?is-external=true" title="class or interface in java.io"><code>Closeable</code></a> 496 is called after serialization or not. If enabled, <b>close()</b> will 497 be called after serialization completes (whether succesfully, or 498 due to an error manifested by an exception being thrown). You can 499 think of this as sort of "finally" processing. 500<p> 501 NOTE: only affects behavior with <b>root</b> objects, and not other 502 objects reachable from the root object. Put another way, only one 503 call will be made for each 'writeValue' call. 504<p> 505 Feature is disabled by default.</div> 506</li> 507</ul> 508<a name="FLUSH_AFTER_WRITE_VALUE"> 509<!-- --> 510</a> 511<ul class="blockList"> 512<li class="blockList"> 513<h4>FLUSH_AFTER_WRITE_VALUE</h4> 514<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> FLUSH_AFTER_WRITE_VALUE</pre> 515<div class="block">Feature that determines whether <code>JsonGenerator.flush()</code> is 516 called after <code>writeValue()</code> method <b>that takes JsonGenerator 517 as an argument</b> completes (i.e. does NOT affect methods 518 that use other destinations); same for methods in <a href="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</code></a>. 519 This usually makes sense; but there are cases where flushing 520 should not be forced: for example when underlying stream is 521 compressing and flush() causes compression state to be flushed 522 (which occurs with some compression codecs). 523<p> 524 Feature is enabled by default.</div> 525</li> 526</ul> 527<a name="WRITE_DATES_AS_TIMESTAMPS"> 528<!-- --> 529</a> 530<ul class="blockList"> 531<li class="blockList"> 532<h4>WRITE_DATES_AS_TIMESTAMPS</h4> 533<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_DATES_AS_TIMESTAMPS</pre> 534<div class="block">Feature that determines whether <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Date.html?is-external=true" title="class or interface in java.util"><code>Date</code></a> values 535 (and Date-based things like <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Calendar.html?is-external=true" title="class or interface in java.util"><code>Calendar</code></a>s) are to be 536 serialized as numeric timestamps (true; the default), 537 or as something else (usually textual representation). 538 If textual representation is used, the actual format is 539 one returned by a call to 540 <a href="../../../../com/fasterxml/jackson/databind/cfg/MapperConfig.html#getDateFormat()"><code>MapperConfig.getDateFormat()</code></a>: 541 the default setting being <a href="../../../../com/fasterxml/jackson/databind/util/StdDateFormat.html" title="class in com.fasterxml.jackson.databind.util"><code>StdDateFormat</code></a>, 542 which corresponds to format String of "yyyy-MM-dd'T'HH:mm:ss.SSSZ" 543 (see <a href="http://docs.oracle.com/javase/6/docs/api/java/text/DateFormat.html?is-external=true" title="class or interface in java.text"><code>DateFormat</code></a> for details of format Strings). 544<p> 545 Note: whether this feature affects handling of other date-related 546 types depend on handlers of those types, although ideally they 547 should use this feature 548<p> 549 Note: whether <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> keys are serialized as Strings 550 or not is controlled using <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_DATE_KEYS_AS_TIMESTAMPS"><code>WRITE_DATE_KEYS_AS_TIMESTAMPS</code></a>. 551<p> 552 Feature is enabled by default.</div> 553</li> 554</ul> 555<a name="WRITE_DATE_KEYS_AS_TIMESTAMPS"> 556<!-- --> 557</a> 558<ul class="blockList"> 559<li class="blockList"> 560<h4>WRITE_DATE_KEYS_AS_TIMESTAMPS</h4> 561<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_DATE_KEYS_AS_TIMESTAMPS</pre> 562<div class="block">Feature that determines whether <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Date.html?is-external=true" title="class or interface in java.util"><code>Date</code></a>s 563 (and sub-types) used as <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> keys are serialized 564 as timestamps or not (if not, will be serialized as textual 565 values). 566<p> 567 Default value is 'false', meaning that Date-valued Map keys are serialized 568 as textual (ISO-8601) values. 569<p> 570 Feature is disabled by default.</div> 571</li> 572</ul> 573<a name="WRITE_CHAR_ARRAYS_AS_JSON_ARRAYS"> 574<!-- --> 575</a> 576<ul class="blockList"> 577<li class="blockList"> 578<h4>WRITE_CHAR_ARRAYS_AS_JSON_ARRAYS</h4> 579<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_CHAR_ARRAYS_AS_JSON_ARRAYS</pre> 580<div class="block">Feature that determines how type <code>char[]</code> is serialized: 581 when enabled, will be serialized as an explict JSON array (with 582 single-character Strings as values); when disabled, defaults to 583 serializing them as Strings (which is more compact). 584<p> 585 Feature is disabled by default.</div> 586</li> 587</ul> 588<a name="WRITE_ENUMS_USING_TO_STRING"> 589<!-- --> 590</a> 591<ul class="blockList"> 592<li class="blockList"> 593<h4>WRITE_ENUMS_USING_TO_STRING</h4> 594<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_ENUMS_USING_TO_STRING</pre> 595<div class="block">Feature that determines standard serialization mechanism used for 596 Enum values: if enabled, return value of <code>Enum.toString()</code> 597 is used; if disabled, return value of <code>Enum.name()</code> is used. 598<p> 599 Note: this feature should usually have same value 600 as <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#READ_ENUMS_USING_TO_STRING"><code>DeserializationFeature.READ_ENUMS_USING_TO_STRING</code></a>. 601<p> 602 Feature is disabled by default.</div> 603</li> 604</ul> 605<a name="WRITE_ENUMS_USING_INDEX"> 606<!-- --> 607</a> 608<ul class="blockList"> 609<li class="blockList"> 610<h4>WRITE_ENUMS_USING_INDEX</h4> 611<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_ENUMS_USING_INDEX</pre> 612<div class="block">Feature that determines whethere Java Enum values are serialized 613 as numbers (true), or textual values (false). If textual values are 614 used, other settings are also considered. 615 If this feature is enabled, 616 return value of <code>Enum.ordinal()</code> 617 (an integer) will be used as the serialization. 618<p> 619 Note that this feature has precedence over <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_ENUMS_USING_TO_STRING"><code>WRITE_ENUMS_USING_TO_STRING</code></a>, 620 which is only considered if this feature is set to false. 621<p> 622 Feature is disabled by default.</div> 623</li> 624</ul> 625<a name="WRITE_NULL_MAP_VALUES"> 626<!-- --> 627</a> 628<ul class="blockList"> 629<li class="blockList"> 630<h4>WRITE_NULL_MAP_VALUES</h4> 631<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_NULL_MAP_VALUES</pre> 632<div class="block">Feature that determines whether Map entries with null values are 633 to be serialized (true) or not (false). 634<p> 635 For further details, check out [JACKSON-314] 636<p> 637 Feature is enabled by default.</div> 638</li> 639</ul> 640<a name="WRITE_EMPTY_JSON_ARRAYS"> 641<!-- --> 642</a> 643<ul class="blockList"> 644<li class="blockList"> 645<h4>WRITE_EMPTY_JSON_ARRAYS</h4> 646<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_EMPTY_JSON_ARRAYS</pre> 647<div class="block">Feature that determines whether Container properties (POJO properties 648 with declared value of Collection or array; i.e. things that produce JSON 649 arrays) that are empty (have no elements) 650 will be serialized as empty JSON arrays (true), or suppressed from output (false). 651<p> 652 Note that this does not change behavior of <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>s, or 653 "Collection-like" types. 654<p> 655 Feature is enabled by default.</div> 656</li> 657</ul> 658<a name="WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED"> 659<!-- --> 660</a> 661<ul class="blockList"> 662<li class="blockList"> 663<h4>WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED</h4> 664<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED</pre> 665<div class="block">Feature added for interoperability, to work with oddities of 666 so-called "BadgerFish" convention. 667 Feature determines handling of single element <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s 668 and arrays: if enabled, <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s and arrays that contain exactly 669 one element will be serialized as if that element itself was serialized. 670<p> 671 When enabled, a POJO with array that normally looks like this: 672<pre> 673 { "arrayProperty" : [ 1 ] } 674</pre> 675 will instead be serialized as 676<pre> 677 { "arrayProperty" : 1 } 678</pre> 679<p> 680 Note that this feature is counterpart to <a href="../../../../com/fasterxml/jackson/databind/DeserializationFeature.html#ACCEPT_SINGLE_VALUE_AS_ARRAY"><code>DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY</code></a> 681 (that is, usually both are enabled, or neither is). 682<p> 683 Feature is disabled by default, so that no special handling is done.</div> 684</li> 685</ul> 686<a name="WRITE_BIGDECIMAL_AS_PLAIN"> 687<!-- --> 688</a> 689<ul class="blockList"> 690<li class="blockList"> 691<h4>WRITE_BIGDECIMAL_AS_PLAIN</h4> 692<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_BIGDECIMAL_AS_PLAIN</pre> 693<div class="block">Feature that determines whether <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true" title="class or interface in java.math"><code>BigDecimal</code></a> entries are 694 serialized using <a href="http://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html?is-external=true#toPlainString()" title="class or interface in java.math"><code>BigDecimal.toPlainString()</code></a> to prevent 695 values to be written using scientific notation. 696<p> 697 NOTE: since this feature typically requires use of 698 <a href="http://fasterxml.github.com/jackson-core/javadoc/2.4/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true#writeNumber(java.lang.String)" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator.writeNumber(String)</code></a> 699 ot may cause compatibility problems since not all <a href="http://fasterxml.github.com/jackson-core/javadoc/2.4/com/fasterxml/jackson/core/JsonGenerator.html?is-external=true" title="class or interface in com.fasterxml.jackson.core"><code>JsonGenerator</code></a> 700 implementations support such mode of output: usually only text-based formats 701 support it. 702<p> 703 Feature is disabled by default.</div> 704</li> 705</ul> 706<a name="WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS"> 707<!-- --> 708</a> 709<ul class="blockList"> 710<li class="blockList"> 711<h4>WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS</h4> 712<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS</pre> 713<div class="block">Feature that controls whether numeric timestamp values are 714 to be written using nanosecond timestamps (enabled) or not (disabled); 715 <b>if and only if</b> datatype supports such resolution. 716 Only newer datatypes (such as Java8 Date/Time) support such resolution -- 717 older types (pre-Java8 <b>java.util.Date</b> etc) and Joda do not -- 718 and this setting <b>has no effect</b> on such types. 719<p> 720 If disabled, standard millisecond timestamps are assumed. 721 This is the counterpart to <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html#WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS"><code>WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS</code></a>. 722<p> 723 Feature is enabled by default, to support most accurate time values possible.</div> 724<dl><dt><span class="strong">Since:</span></dt> 725 <dd>2.2</dd></dl> 726</li> 727</ul> 728<a name="ORDER_MAP_ENTRIES_BY_KEYS"> 729<!-- --> 730</a> 731<ul class="blockList"> 732<li class="blockList"> 733<h4>ORDER_MAP_ENTRIES_BY_KEYS</h4> 734<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> ORDER_MAP_ENTRIES_BY_KEYS</pre> 735<div class="block">Feature that determines whether <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> entries are first 736 sorted by key before serialization or not: if enabled, additional sorting 737 step is performed if necessary (not necessary for <a href="http://docs.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util"><code>SortedMap</code></a>s), 738 if disabled, no additional sorting is needed. 739<p> 740 Feature is disabled by default.</div> 741</li> 742</ul> 743<a name="EAGER_SERIALIZER_FETCH"> 744<!-- --> 745</a> 746<ul class="blockList"> 747<li class="blockList"> 748<h4>EAGER_SERIALIZER_FETCH</h4> 749<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> EAGER_SERIALIZER_FETCH</pre> 750<div class="block">Feature that determines whether <a href="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</code></a> should 751 try to eagerly fetch necessary <a href="../../../../com/fasterxml/jackson/databind/JsonSerializer.html" title="class in com.fasterxml.jackson.databind"><code>JsonSerializer</code></a> when 752 possible. This improves performance in cases where similarly 753 configured <a href="../../../../com/fasterxml/jackson/databind/ObjectWriter.html" title="class in com.fasterxml.jackson.databind"><code>ObjectWriter</code></a> instance is used multiple 754 times; and should not significantly affect single-use cases. 755<p> 756 Note that there should not be any need to normally disable this 757 feature: only consider that if there are actual perceived problems. 758<p> 759 Feature is enabled by default.</div> 760<dl><dt><span class="strong">Since:</span></dt> 761 <dd>2.1</dd></dl> 762</li> 763</ul> 764<a name="USE_EQUALITY_FOR_OBJECT_ID"> 765<!-- --> 766</a> 767<ul class="blockListLast"> 768<li class="blockList"> 769<h4>USE_EQUALITY_FOR_OBJECT_ID</h4> 770<pre>public static final <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a> USE_EQUALITY_FOR_OBJECT_ID</pre> 771<div class="block">Feature that determines whether Object Identity is compared using 772 true JVM-level identity of Object (false); or, <code>equals()</code> method. 773 Latter is sometimes useful when dealing with Database-bound objects with 774 ORM libraries (like Hibernate). 775<p> 776 Feature is disabled by default; meaning that strict identity is used, not 777 <code>equals()</code></div> 778<dl><dt><span class="strong">Since:</span></dt> 779 <dd>2.3</dd></dl> 780</li> 781</ul> 782</li> 783</ul> 784<!-- ============ METHOD DETAIL ========== --> 785<ul class="blockList"> 786<li class="blockList"><a name="method_detail"> 787<!-- --> 788</a> 789<h3>Method Detail</h3> 790<a name="values()"> 791<!-- --> 792</a> 793<ul class="blockList"> 794<li class="blockList"> 795<h4>values</h4> 796<pre>public static <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</a>[] values()</pre> 797<div class="block">Returns an array containing the constants of this enum type, in 798the order they are declared. This method may be used to iterate 799over the constants as follows: 800<pre> 801for (SerializationFeature c : SerializationFeature.values()) 802 System.out.println(c); 803</pre></div> 804<dl><dt><span class="strong">Returns:</span></dt><dd>an array containing the constants of this enum type, in 805the order they are declared</dd></dl> 806</li> 807</ul> 808<a name="valueOf(java.lang.String)"> 809<!-- --> 810</a> 811<ul class="blockList"> 812<li class="blockList"> 813<h4>valueOf</h4> 814<pre>public static <a href="../../../../com/fasterxml/jackson/databind/SerializationFeature.html" title="enum in com.fasterxml.jackson.databind">SerializationFeature</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> 815<div class="block">Returns the enum constant of this type with the specified name. 816The string must match <i>exactly</i> an identifier used to declare an 817enum constant in this type. (Extraneous whitespace characters are 818not permitted.)</div> 819<dl><dt><span class="strong">Parameters:</span></dt><dd><code>name</code> - the name of the enum constant to be returned.</dd> 820<dt><span class="strong">Returns:</span></dt><dd>the enum constant with the specified name</dd> 821<dt><span class="strong">Throws:</span></dt> 822<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 823with the specified name</dd> 824<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> 825</li> 826</ul> 827<a name="enabledByDefault()"> 828<!-- --> 829</a> 830<ul class="blockList"> 831<li class="blockList"> 832<h4>enabledByDefault</h4> 833<pre>public boolean enabledByDefault()</pre> 834<div class="block"><strong>Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#enabledByDefault()">ConfigFeature</a></code></strong></div> 835<div class="block">Accessor for checking whether this feature is enabled by default.</div> 836<dl> 837<dt><strong>Specified by:</strong></dt> 838<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> 839</dl> 840</li> 841</ul> 842<a name="getMask()"> 843<!-- --> 844</a> 845<ul class="blockListLast"> 846<li class="blockList"> 847<h4>getMask</h4> 848<pre>public int getMask()</pre> 849<div class="block"><strong>Description copied from interface: <code><a href="../../../../com/fasterxml/jackson/databind/cfg/ConfigFeature.html#getMask()">ConfigFeature</a></code></strong></div> 850<div class="block">Returns bit mask for this feature instance</div> 851<dl> 852<dt><strong>Specified by:</strong></dt> 853<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> 854</dl> 855</li> 856</ul> 857</li> 858</ul> 859</li> 860</ul> 861</div> 862</div> 863<!-- ========= END OF CLASS DATA ========= --> 864<!-- ======= START OF BOTTOM NAVBAR ====== --> 865<div class="bottomNav"><a name="navbar_bottom"> 866<!-- --> 867</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> 868<!-- --> 869</a> 870<ul class="navList" title="Navigation"> 871<li><a href="../../../../overview-summary.html">Overview</a></li> 872<li><a href="package-summary.html">Package</a></li> 873<li class="navBarCell1Rev">Class</li> 874<li><a href="class-use/SerializationFeature.html">Use</a></li> 875<li><a href="package-tree.html">Tree</a></li> 876<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 877<li><a href="../../../../index-all.html">Index</a></li> 878<li><a href="../../../../help-doc.html">Help</a></li> 879</ul> 880</div> 881<div class="subNav"> 882<ul class="navList"> 883<li><a href="../../../../com/fasterxml/jackson/databind/SerializationConfig.html" title="class in com.fasterxml.jackson.databind"><span class="strong">Prev Class</span></a></li> 884<li><a href="../../../../com/fasterxml/jackson/databind/SerializerProvider.html" title="class in com.fasterxml.jackson.databind"><span class="strong">Next Class</span></a></li> 885</ul> 886<ul class="navList"> 887<li><a href="../../../../index.html?com/fasterxml/jackson/databind/SerializationFeature.html" target="_top">Frames</a></li> 888<li><a href="SerializationFeature.html" target="_top">No Frames</a></li> 889</ul> 890<ul class="navList" id="allclasses_navbar_bottom"> 891<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 892</ul> 893<div> 894<script type="text/javascript"><!-- 895 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 896 if(window==top) { 897 allClassesLink.style.display = "block"; 898 } 899 else { 900 allClassesLink.style.display = "none"; 901 } 902 //--> 903</script> 904</div> 905<div> 906<ul class="subNavList"> 907<li>Summary: </li> 908<li>Nested | </li> 909<li><a href="#enum_constant_summary">Enum Constants</a> | </li> 910<li>Field | </li> 911<li><a href="#method_summary">Method</a></li> 912</ul> 913<ul class="subNavList"> 914<li>Detail: </li> 915<li><a href="#enum_constant_detail">Enum Constants</a> | </li> 916<li>Field | </li> 917<li><a href="#method_detail">Method</a></li> 918</ul> 919</div> 920<a name="skip-navbar_bottom"> 921<!-- --> 922</a></div> 923<!-- ======== END OF BOTTOM NAVBAR ======= --> 924<p class="legalCopy"><small>Copyright © 2014 <a href="http://fasterxml.com/">FasterXML</a>. All Rights Reserved.</small></p> 925</body> 926</html> 927