XStream

<h2 id="xstream-library">XStream library</h2>
<p>XStream uses <a href="/facts/Reflection_(computer_science)/Nj8stFfp">reflection</a> to discover the structure of the object graph to serialize at <a href="/facts/Run_time_(program_lifecycle_phase)/lCxKsrzB">run time</a>, and doesn't require modifications to objects. It can serialize internal fields, including private and final, and supports non-public and inner classes.<a class="footnote-ref" id="fnref:1" href="#fn:1"><sup>1</sup></a>
</p>
<h3>Object graph serialization</h3>
<p>When serializing an object it serializes the full object graph. Duplicate references encountered in the object-model will be maintained. For example, using the following class CD
</p>
package com.thoughtworks.xstream;
public class Cd {
	private String id;

private Cd bonusCd;

Cd(String id, Cd bonusCd) {
		this.id = id;
		this.bonusCd = bonusCd;
	}

Cd(String id) {
		this.id = id;
	}

public String getId() {
		return id;
	}

public Cd getBonusCd() {
		return bonusCd;
	}
}

<p>and add some of these object to a list
</p>
Cd bj = new Cd("basement_jaxx_singles");
Cd mr = new Cd("maria rita");
		
List<Cd> order = new ArrayList<>();
order.add(mr);
// adds the same cd twice (two references to the same object)
order.add(bj);
order.add(bj);

// adds itself (cycle)
order.add(order);

XStream xstream = new XStream();
xstream.alias("cd", Cd.class);
System.out.println(xstream.toXML(order));

<p>If the above code is executed with XStream's default relative references mode, it will generate the following XML:
</p>
<list>
  <cd>
    <id>maria rita</id>
  </cd>
  <cd>
    <id>basement_jaxx_singles</id>
  </cd>
  <cd reference="../cd[2]"/>
  <list reference=".."/>
</list>

<p>XStream is <a href="/facts/Free_software/IaoVtJXn">free software</a>, distributed under a permissive, <a href="/facts/Revised_BSD-style_licence/XLtmLp5x">revised BSD-style licence</a>.
</p>
<h2 id="usage">Usage</h2>
<ul><li><a href="/facts/Confluence_(software)/K4NKthwd">Confluence</a><a class="footnote-ref" id="fnref:2" href="#fn:2"><sup>2</sup></a></li></ul>

<h2 id="external-links">External links</h2>
<ul>
<li>Free and open-source software portal</li></ul>
<ul><li><a href="https://x-stream.github.io/">Library Home Page</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>"Use XStream to serialize Java objects into XML". Ibm.com. Archived from the original on February 19, 2009. Retrieved 2009-12-14. <a href="https://web.archive.org/web/20090219204439/http://www.ibm.com/developerworks/java/library/x-xstream/index.html?" target="_blank">https://web.archive.org/web/20090219204439/http://www.ibm.com/developerworks/java/library/x-xstream/index.html?</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>"XStream - References". Xstream.codehaus.org. Retrieved 2009-12-14. <a href="https://x-stream.github.io/references.html" target="_blank">https://x-stream.github.io/references.html</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
</ol>

XStream open-in-new

XStream