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_67) on Thu Jul 16 17:03:17 PDT 2015 --> 6<meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> 7<title>JsonIdentityReference (Jackson-annotations 2.6.0 API)</title> 8<meta name="date" content="2015-07-16"> 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="JsonIdentityReference (Jackson-annotations 2.6.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="../../../../com/fasterxml/jackson/annotation/package-summary.html">Package</a></li> 29<li class="navBarCell1Rev">Class</li> 30<li><a href="class-use/JsonIdentityReference.html">Use</a></li> 31<li><a href="package-tree.html">Tree</a></li> 32<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 33<li><a href="../../../../index-all.html">Index</a></li> 34<li><a href="../../../../help-doc.html">Help</a></li> 35</ul> 36</div> 37<div class="subNav"> 38<ul class="navList"> 39<li><a href="../../../../com/fasterxml/jackson/annotation/JsonIdentityInfo.html" title="annotation in com.fasterxml.jackson.annotation"><span class="strong">Prev Class</span></a></li> 40<li><a href="../../../../com/fasterxml/jackson/annotation/JsonIgnore.html" title="annotation in com.fasterxml.jackson.annotation"><span class="strong">Next Class</span></a></li> 41</ul> 42<ul class="navList"> 43<li><a href="../../../../index.html?com/fasterxml/jackson/annotation/JsonIdentityReference.html" target="_top">Frames</a></li> 44<li><a href="JsonIdentityReference.html" target="_top">No Frames</a></li> 45</ul> 46<ul class="navList" id="allclasses_navbar_top"> 47<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 48</ul> 49<div> 50<script type="text/javascript"><!-- 51 allClassesLink = document.getElementById("allclasses_navbar_top"); 52 if(window==top) { 53 allClassesLink.style.display = "block"; 54 } 55 else { 56 allClassesLink.style.display = "none"; 57 } 58 //--> 59</script> 60</div> 61<div> 62<ul class="subNavList"> 63<li>Summary: </li> 64<li>Required | </li> 65<li><a href="#annotation_type_optional_element_summary">Optional</a></li> 66</ul> 67<ul class="subNavList"> 68<li>Detail: </li> 69<li><a href="#annotation_type_element_detail">Element</a></li> 70</ul> 71</div> 72<a name="skip-navbar_top"> 73<!-- --> 74</a></div> 75<!-- ========= END OF TOP NAVBAR ========= --> 76<!-- ======== START OF CLASS DATA ======== --> 77<div class="header"> 78<div class="subTitle">com.fasterxml.jackson.annotation</div> 79<h2 title="Annotation Type JsonIdentityReference" class="title">Annotation Type JsonIdentityReference</h2> 80</div> 81<div class="contentContainer"> 82<div class="description"> 83<ul class="blockList"> 84<li class="blockList"> 85<hr> 86<br> 87<pre><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/Target.html?is-external=true" title="class or interface in java.lang.annotation">@Target</a>(<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/Target.html?is-external=true#value()" title="class or interface in java.lang.annotation">value</a>={<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/ElementType.html?is-external=true#ANNOTATION_TYPE" title="class or interface in java.lang.annotation">ANNOTATION_TYPE</a>,<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/ElementType.html?is-external=true#TYPE" title="class or interface in java.lang.annotation">TYPE</a>,<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/ElementType.html?is-external=true#FIELD" title="class or interface in java.lang.annotation">FIELD</a>,<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/ElementType.html?is-external=true#METHOD" title="class or interface in java.lang.annotation">METHOD</a>,<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/ElementType.html?is-external=true#PARAMETER" title="class or interface in java.lang.annotation">PARAMETER</a>}) 88<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/Retention.html?is-external=true" title="class or interface in java.lang.annotation">@Retention</a>(<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/Retention.html?is-external=true#value()" title="class or interface in java.lang.annotation">value</a>=<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/annotation/RetentionPolicy.html?is-external=true#RUNTIME" title="class or interface in java.lang.annotation">RUNTIME</a>) 89public @interface <span class="strong">JsonIdentityReference</span></pre> 90<div class="block">Optional annotation that can be used for customizing details of a reference 91 to Objects for which "Object Identity" is enabled (see <a href="../../../../com/fasterxml/jackson/annotation/JsonIdentityInfo.html" title="annotation in com.fasterxml.jackson.annotation"><code>JsonIdentityInfo</code></a>). 92 The main use case is that of enforcing use of Object Id even for the first 93 time an Object is referenced, instead of first instance being serialized 94 as full POJO.</div> 95<dl><dt><span class="strong">Since:</span></dt> 96 <dd>2.1</dd></dl> 97</li> 98</ul> 99</div> 100<div class="summary"> 101<ul class="blockList"> 102<li class="blockList"> 103<!-- =========== ANNOTATION TYPE OPTIONAL MEMBER SUMMARY =========== --> 104<ul class="blockList"> 105<li class="blockList"><a name="annotation_type_optional_element_summary"> 106<!-- --> 107</a> 108<h3>Optional Element Summary</h3> 109<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Optional Element Summary table, listing optional elements, and an explanation"> 110<caption><span>Optional Elements</span><span class="tabEnd"> </span></caption> 111<tr> 112<th class="colFirst" scope="col">Modifier and Type</th> 113<th class="colLast" scope="col">Optional Element and Description</th> 114</tr> 115<tr class="altColor"> 116<td class="colFirst"><code>boolean</code></td> 117<td class="colLast"><code><strong><a href="../../../../com/fasterxml/jackson/annotation/JsonIdentityReference.html#alwaysAsId()">alwaysAsId</a></strong></code> 118<div class="block">Marker to indicate whether all referenced values are to 119 be serialized as ids (true); or by serializing the 120 first encountered reference as POJO and only then as id (false).</div> 121</td> 122</tr> 123</table> 124</li> 125</ul> 126</li> 127</ul> 128</div> 129<div class="details"> 130<ul class="blockList"> 131<li class="blockList"> 132<!-- ============ ANNOTATION TYPE MEMBER DETAIL =========== --> 133<ul class="blockList"> 134<li class="blockList"><a name="annotation_type_element_detail"> 135<!-- --> 136</a> 137<h3>Element Detail</h3> 138<a name="alwaysAsId()"> 139<!-- --> 140</a> 141<ul class="blockListLast"> 142<li class="blockList"> 143<h4>alwaysAsId</h4> 144<pre>public abstract boolean alwaysAsId</pre> 145<div class="block">Marker to indicate whether all referenced values are to 146 be serialized as ids (true); or by serializing the 147 first encountered reference as POJO and only then as id (false). 148<p> 149 Note that if value of 'true' is used, deserialization may require 150 additional contextual information, and possibly using a custom 151 id resolver -- the default handling may not be sufficient.</div> 152<dl><dt><span class="strong">Since:</span></dt> 153 <dd>2.1</dd></dl> 154<dl> 155<dt>Default:</dt> 156<dd>false</dd> 157</dl> 158</li> 159</ul> 160</li> 161</ul> 162</li> 163</ul> 164</div> 165</div> 166<!-- ========= END OF CLASS DATA ========= --> 167<!-- ======= START OF BOTTOM NAVBAR ====== --> 168<div class="bottomNav"><a name="navbar_bottom"> 169<!-- --> 170</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> 171<!-- --> 172</a> 173<ul class="navList" title="Navigation"> 174<li><a href="../../../../com/fasterxml/jackson/annotation/package-summary.html">Package</a></li> 175<li class="navBarCell1Rev">Class</li> 176<li><a href="class-use/JsonIdentityReference.html">Use</a></li> 177<li><a href="package-tree.html">Tree</a></li> 178<li><a href="../../../../deprecated-list.html">Deprecated</a></li> 179<li><a href="../../../../index-all.html">Index</a></li> 180<li><a href="../../../../help-doc.html">Help</a></li> 181</ul> 182</div> 183<div class="subNav"> 184<ul class="navList"> 185<li><a href="../../../../com/fasterxml/jackson/annotation/JsonIdentityInfo.html" title="annotation in com.fasterxml.jackson.annotation"><span class="strong">Prev Class</span></a></li> 186<li><a href="../../../../com/fasterxml/jackson/annotation/JsonIgnore.html" title="annotation in com.fasterxml.jackson.annotation"><span class="strong">Next Class</span></a></li> 187</ul> 188<ul class="navList"> 189<li><a href="../../../../index.html?com/fasterxml/jackson/annotation/JsonIdentityReference.html" target="_top">Frames</a></li> 190<li><a href="JsonIdentityReference.html" target="_top">No Frames</a></li> 191</ul> 192<ul class="navList" id="allclasses_navbar_bottom"> 193<li><a href="../../../../allclasses-noframe.html">All Classes</a></li> 194</ul> 195<div> 196<script type="text/javascript"><!-- 197 allClassesLink = document.getElementById("allclasses_navbar_bottom"); 198 if(window==top) { 199 allClassesLink.style.display = "block"; 200 } 201 else { 202 allClassesLink.style.display = "none"; 203 } 204 //--> 205</script> 206</div> 207<div> 208<ul class="subNavList"> 209<li>Summary: </li> 210<li>Required | </li> 211<li><a href="#annotation_type_optional_element_summary">Optional</a></li> 212</ul> 213<ul class="subNavList"> 214<li>Detail: </li> 215<li><a href="#annotation_type_element_detail">Element</a></li> 216</ul> 217</div> 218<a name="skip-navbar_bottom"> 219<!-- --> 220</a></div> 221<!-- ======== END OF BOTTOM NAVBAR ======= --> 222<p class="legalCopy"><small>Copyright © 2014–2015 <a href="http://fasterxml.com/">FasterXML</a>. All rights reserved.</small></p> 223</body> 224</html> 225