changes.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<!--
 Copyright (C) 2005, 2006 Joe Walnes.
 Copyright (C) 2006, 2007, 2008, 2021 XStream committers.
 All rights reserved.
 
 The software in this package is published under the terms of the BSD
 style license a copy of which has been included with this distribution in
 the LICENSE.txt file.
 
 Created on 29. January 2005 by Joe Walnes
 -->
    <head>
        <title>XStream - Change History</title>
        <link rel="stylesheet" type="text/css" href="style.css"/>
        

        <!-- Google analytics -->
        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
        </script>
        <script type="text/javascript">
          _uacct = "UA-110973-2";
          urchinTracker();
        </script>

    </head>
    <body>

        <div id="banner">
            <a href="index.html"><img id="logo" src="logo.gif" alt="XStream"/></a>
        </div>

        <div id="center" class="Content2Column">  <!-- Content3Column for index -->
            <div id="content">
                <h1 class="FirstChild">Change History</h1>

                
	<p>Changes are split into following categories:</p>

	<ul>
		<li><b>Major changes</b>: The major new features that all users should know about.</li>
		<li><b>Minor changes</b>: Any smaller changes, including bugfixes.</li>
		<li><b>Stream Compatibility</b>: Changes affecting the persisted data.</li>
		<li><b>API changes</b>: Any changes to the API that could impact existing users.</li>
	</ul>

	<p>
		Full details can be found in GitHub's <a href="https://github.com/x-stream/xstream/issues?q=is%3Aissue+is%3Aclosed">Issues</a>,
		filter for the appropriate milestone.
	</p>

	<!--
	<h1 id="upcoming-1.4.x">Upcoming 1.4.x maintenance release</h1>

	<p>Not yet released.</p>
	-->

	<h1 id="1.4.21">1.4.21</h1>

	<p>Released November 7, 2024.</p>

	<p class="highlight">This maintenance release addresses the security vulnerability
	<a href="CVE-2024-47072.html">CVE-2024-47072</a>, when using the BinaryDriver to unmarshal a manipulated input
	stream causing a Denial of Service due to a stack overflow.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/pull/350">#350</a>: Optimize memory allocation (by Vladislav Rassokhin of JetBrains).</li>
		<li>Add a converter for the WeakHashMap which does not write any elements of the map.  Avoids also access to the
		ReentrantLock contained in the WeakHashMap since Java 19.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/pull/335">#335</a>: Allow PrettyPrintWriter to replace invalid XML characters when not running in quirks mode (by Basil Crow).</li>
		<li><a href="https://github.com/x-stream/xstream/pull/331">#331</a>, <a href="https://github.com/x-stream/xstream/issues/326">#326</a>: Fix handling of empty java.util.concurrent.atomic.AtomicReference (by Alex Blekhman of Atlassian).</li>
		<li><a href="https://github.com/x-stream/xstream/pull/334">#334</a>: Fix remaining buffer size calculation in QuickWriter (by Higuchi Yuta).</li>
		<li><a href="https://github.com/x-stream/xstream/issues/342">#342</a>: Optimize internal handling of children in DomReader avoiding O(n²) access times for siblings (by Shiang-Yun Yang).</li>
		<li><a href="https://github.com/x-stream/xstream/pull/349">#349</a>: Fix support of lambda objects for Java 21 and above (by Tobias Gierke).</li>
		<li><a href="https://github.com/x-stream/xstream/issues/359">#359</a>: Add KEYS file with public keys to verify signed artifacts.</li>
		<li>Detect input manipulation in c.t.x.io.binary.BinaryStreamReader.</li>
		<li>Use Jettison 1.5.4 by default for Java Runtimes version 8 or higher.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added constant c.t.x.io.xml.PrettyPrintWriter.XML_1_0_REPLACEMENT.</li>
		<li>Added constant c.t.x.io.xml.PrettyPrintWriter.XML_1_1_REPLACEMENT.</li>
		<li>Added c.t.x.converters.collections.WeakHashMapConverter.</li>
		<li>Protected field <i>fieldsToOmit</i> of c.t.x.mapper.ElementIgnoringMapper set to private.</li>
		<li>Protected field <i>unknownElementsToIgnore</i> of c.t.x.mapper.ElementIgnoringMapper set to private.</li>
	</ul>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The WeakHashMaps, that have been written with previous versions of XStream, can still be deserialized.</li>
	</ul>

	<h1 id="1.4.20">1.4.20</h1>

	<p>Released December 24, 2022.</p>

	<p class="highlight">This maintenance release addresses the security vulnerabilities
	<a href="CVE-2022-40151.html">CVE-2022-40151</a> and <a href="CVE-2022-41966.html">CVE-2022-41966</a>, causing a
	Denial of Service by raising a stack overflow.  It also provides new converters for Optional and Atomic types.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/308">#308</a>: Add converter for AtomicBoolean, AtomicInteger, AtomicLong, and AtomicReference of
		package java.util.concurrent.atomic.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/293">#293</a>: Add converter for Optional, OptionalDouble, OptionalInt, and OptionalLong of package
		java.util.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/pull/287">#287</a>: Close stream opened from provided URL.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/284">#284</a>: Fix disabling check against hash code attack with XStream.setCollectionUpdateLimit(0).</li>
	</ul>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The atomic types with new converters of package java.util.concurrent.atomic, that have been written with
		previous versions of XStream, can still be deserialized.</li>
		<li>The Optional types with new converters of package java.util, that have been written with previous versions
		of XStream, can still be deserialized.</li>
		<li>The WildcardTypePermission allows by default no longer anonymous class types.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.converters.extended.AtomicBooleanConverter.</li>
		<li>Added c.t.x.converters.extended.AtomicIntegerConverter.</li>
		<li>Added c.t.x.converters.extended.AtomicLongConverter.</li>
		<li>Added c.t.x.converters.extended.AtomicReferenceConverter.</li>
		<li>Added c.t.x.converters.extended.OptionalConverter.</li>
		<li>Added c.t.x.converters.extended.OptionalDoubleConverter.</li>
		<li>Added c.t.x.converters.extended.OptionalIntConverter.</li>
		<li>Added c.t.x.converters.extended.OptionalLongConverter.</li>
		<li>Added c.t.x.security.WildcardTypePermission.WildcardTypePermission(boolean,String[]).</li>
	</ul>

	<h1 id="1.4.19">1.4.19</h1>

	<p>Released January 29, 2022.</p>

	<p class="highlight">This maintenance release addresses the security vulnerability
	<a href="CVE-2021-43859.html">CVE-2021-43859</a>, when unmarshalling highly recursive collections or maps causing a
	Denial of Service.</p>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.XStream.COLLECTION_UPDATE_LIMIT and c.t.x.XStream.COLLECTION_UPDATE_SECONDS.</li>
		<li>Added c.t.x.XStream.setCollectionUpdateLimit(int).</li>
		<li>Added c.t.x.core.SecurityUtils.</li>
		<li>Added c.t.x.security.AbstractSecurityException and c.t.x.security.InputManipulationException.</li>
		<li>c.t.x.security.InputManipulationException derives now from c.t.x.security.AbstractSecurityException.</li>
	</ul>

	<h1 id="1.4.18">1.4.18</h1>

	<p>Released August 22, 2021.</p>

	<p class="highlight">This maintenance release addresses following security vulnerabilities, when unmarshalling with
	an XStream instance using the default blacklist of an uninitialized security framework.  XStream is therefore now
	using a whitelist by default.</p>

	<ul>
		<li><a href="CVE-2021-39139.html">CVE-2021-39139</a></li>
		<li><a href="CVE-2021-39140.html">CVE-2021-39140</a></li>
		<li><a href="CVE-2021-39141.html">CVE-2021-39141</a></li>
		<li><a href="CVE-2021-39144.html">CVE-2021-39144</a></li>
		<li><a href="CVE-2021-39145.html">CVE-2021-39145</a></li>
		<li><a href="CVE-2021-39146.html">CVE-2021-39146</a></li>
		<li><a href="CVE-2021-39147.html">CVE-2021-39147</a></li>
		<li><a href="CVE-2021-39148.html">CVE-2021-39148</a></li>
		<li><a href="CVE-2021-39149.html">CVE-2021-39149</a></li>
		<li><a href="CVE-2021-39150.html">CVE-2021-39150</a></li>
		<li><a href="CVE-2021-39151.html">CVE-2021-39151</a></li>
		<li><a href="CVE-2021-39152.html">CVE-2021-39152</a></li>
		<li><a href="CVE-2021-39153.html">CVE-2021-39153</a></li>
		<li><a href="CVE-2021-39154.html">CVE-2021-39154</a></li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/233">#233</a>: Support serializable types with non-serializable parent with PureJavaReflectionConverter.</li>
	</ul>

	<h2>Stream compatibility</h2>

	<p class="highlight">Starting with version 1.14.12 nine years ago, XStream contains a
	<a href="security.html#framework">Security Framework</a> to implement a black- or whitelist for the allowed types
	at deserialization time.  Until version 1.4.17, XStream kept a default blacklist in order to deny all types of the
	Java runtime, which are used for all kinds of <a href="security.html#CVEs">security attacks</a>, in order to
	guarantee optimal runtime compatibility for existing users.  However, this approach has failed.  The last months
	have shown, that the Java runtime alone contains dozens of types that can be used for an attack, not even looking
	at the 3rd party libraries on a classpath.  The new version of XStream uses therefore now by default a whitelist,
	which is recommended since nine years.  It also has been complaining on the console for a long time about an
	uninitialized security framework the first time it was run.  Anyone who has followed the advice and initialized the
	security framework for their own scenario can easily update to the new version without any problem. Everyone else
	will have to do a proper initialization now, otherwise the new version will fail with certainty at deserialization
	time.</p>

	<h1 id="1.4.17">1.4.17</h1>

	<p>Released May 13, 2021.</p>

	<p class="highlight">This maintenance release addresses the security vulnerability
	<a href="CVE-2021-29505.html">CVE-2021-29505</a>, when unmarshalling with XStream instance using an uninitialized
	security framework.</p>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The following types are now blacklisted by default and the deserialization
		of XML containing one of the two types will fail.  You will have to enable these types by explicit
		configuration, if you need them:<br>
			<ul>
				<li>any type in the java.rmi.* and sun.rmi.* package hierarchies</li>
				<li>the individual type com.sun.jndi.toolkit.dir.LazySearchEnumerationImpl</li>
			</ul>
		</li>
	</ul>

	<h1 id="1.4.16">1.4.16</h1>

	<p>Released March 13, 2021.</p>

	<p class="highlight">This maintenance release switches XStream's default parser and addresses following security
	vulnerabilities, when unmarshalling with an XStream instance using an uninitialized security framework.</p>

	<ul>
		<li><a href="CVE-2021-21341.html">CVE-2021-21341</a></li>
		<li><a href="CVE-2021-21342.html">CVE-2021-21342</a></li>
		<li><a href="CVE-2021-21343.html">CVE-2021-21343</a></li>
		<li><a href="CVE-2021-21344.html">CVE-2021-21344</a></li>
		<li><a href="CVE-2021-21345.html">CVE-2021-21345</a></li>
		<li><a href="CVE-2021-21346.html">CVE-2021-21346</a></li>
		<li><a href="CVE-2021-21347.html">CVE-2021-21347</a></li>
		<li><a href="CVE-2021-21348.html">CVE-2021-21348</a></li>
		<li><a href="CVE-2021-21349.html">CVE-2021-21349</a></li>
		<li><a href="CVE-2021-21350.html">CVE-2021-21350</a></li>
		<li><a href="CVE-2021-21351.html">CVE-2021-21351</a></li>
	</ul>

	<h2>Major changes</h2>

	<ul>
		<li>Switch from Xpp3 as default parser to MXParser, a fork of Xpp3.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/238">#238</a>: Fix possibility to process references on enum types at deserialization.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/237">#237</a>: Fix optimization in XmlFriendlyNameCoder.</li>
	</ul>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The following types are now blacklisted by default and the deserialization
		of XML containing one of the two types will fail.  You will have to enable these types by explicit
		configuration, if you need them:<br>
			<ul>
				<li>the type hierarchies for java.io.InputStream, java.nio.channels.Channel,
				javax.activation.DataSource and javax.sql.rowsel.BaseRowSet</li>
				<li>the individual types com.sun.corba.se.impl.activation.ServerTableEntry,
				com.sun.tools.javac.processing.JavacProcessingEnvironment$NameProcessIterator,
				sun.awt.datatransfer.DataTransferer$IndexOrderComparator, and sun.swing.SwingLazyValue</li>
				<li>the individual types com.sun.corba.se.impl.activation.ServerTableEntry,
				com.sun.tools.javac.processing.JavacProcessingEnvironment$NameProcessIterator,
				sun.awt.datatransfer.DataTransferer$IndexOrderComparator, and sun.swing.SwingLazyValue</li>
				<li>the internal type Accessor$GetterSetterReflection of JAXB, the internal types
				MethodGetter$PrivilegedGetter and ServiceFinder$ServiceNameIterator of JAX-WS</li>
				<li>all inner classes of javafx.collections.ObservableList</li>
				<li>an internal ClassLoader used in a private copy of BCEL within the Java runtime</li>
			</ul>
		</li>
	</ul>

	<h2>Dependencies</h2>
	
	<p>The default parser of XStream has changed from the Xpp3Parser in artifact xpp3:xpp3_min to MXParser, a fork of
	Xpp3 in the artifact io.github.x-stream:mxparser.  The Xpp3 is unmaintained for a long time, bugs have been fixed
	reported more than a decade ago, improvements by other forks have been incorporated and some endless loops have
	been fixed, that could have been utilized as DoS attack.</p>

	<p>XStream has therefore new default dependencies.  If you have used XStream with the default driver (i.e. Xpp3),
	you can still exchange the XStream library for a drop-in replacement, but you will also have to remove the Xpp3 and
	add the MXParser library instead.</p>

	<p>For build time you will have to add the Xpp3 library to your dependencies, if you made explicitly use of the
	Xpp3 driver.	If you did explicitly use a different driver than Xpp3 and had therefore excluded the Xpp3
	dependency, you might have to exclude now the new MXParser dependency instead to minimize your dependency list.</p>

	<h1 id="1.4.15">1.4.15</h1>

	<p>Released December 13, 2020.</p>

	<p class="highlight">This maintenance release addresses the security vulnerabilities
	<a href="CVE-2020-26258.html">CVE-2020-26258</a> and <a href="CVE-2020-26259.html">CVE-2020-26259</a>, when
	unmarshalling with XStream instance using an uninitialized security framework.</p>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/226">#226</a>: XmlFriendlyNameCoder does not accept '9' as valid character in an XML name.</li>
		<li><a href="https://github.com/x-stream/xstream/pull/228">#228</a>: DefaultMapper should handle IllegalArgumentException thrown by Class.forName().</li>
	</ul>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The type jdk.nashorn.internal.objects.NativeString and the internal JAX-WS type ReadAllStream.FileStream
		are now	part of the default blacklist and the deserialization of XML containing one of the two types will fail.
		You will have to enable these types by explicit configuration, if you need them.</li>
	</ul>

	<h2>Delivery</h2>

	<p>Any XStream release can run with a minimal Java runtime environment of Java 1.4 as long as this environment will
	process only requested classes of the jar file.  Until version 1.4.14 XStream was delivered also as special Java 7
	version for Android, because Dalvik scans all classes and fails at classes requiring a higher runtime version.  However, this
	special version will not work in a normal Java 8 environment or higher and was never meant do so.</p>

	<p>Unfortunately, this version has to be build always after the standard version due to the build sequence.  The
	latest version in Maven Central however is always the one that has been deployed last independently from the time
	of publishing.  This creates an annoyance now in GitHub for any project using the Dependabot service which creates
	automated pull requests with updates to the latest XStream version, because it injects now the special Java 7
	version that probably breaks these projects.</p>

	<p>Users who still require a special version for Java 7 will have to build this artifact now on their own.  Users
	for even older Java environments had always to do so anyway.</p>
	
	<h1 id="1.4.14">1.4.14</h1>

	<p>Released November 16, 2020.</p>

	<p class="highlight">This maintenance release addresses the security vulnerability
	<a href="CVE-2020-26217.html">CVE-2020-26217</a>, reported originally as CVE-2017-9805 for Struts' XStream Plugin,
	an arbitrary execution of commands when unmarshalling with XStream instances using an uninitialized security
	framework.</p>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The types java.lang.ProcessBuilder and javax.imageio.ImageIO$ContainsFilter are now part of the default
		blacklist and the deserialization of XML containing one of the two types will fail. You will have to enable
		these types by explicit configuration, if you need them.</li>
	</ul>

	<h1 id="1.4.13">1.4.13</h1>

	<p>Released September 6, 2020.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/pull/218">#218</a>: Defer reflective access to Java core modules.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/207">#207</a>: New predefined blacklist avoids vulnerability due to improper setup of the security framework.</li>
	</ul>

	<h1 id="1.4.12">1.4.12</h1>

	<p>Released April 12, 2020.</p>

	<h2>Minor changes</h2>

	<ul>
		<li>XmlFriendlyNameCoder supports now XML parsers implementing only 4th edition of XML 1.0 specification.</li>
		<li>Fix support of CDATA events in StAX.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/171">#171</a>: XStream.createObjectInputStream does not pass the DataHolder.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/151">#151</a>: Use of SPDX license identifier in POM and Manifest.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/152">#152</a>: Declare OSGi import of internal runtime packages as optional.</li>
		<li>Drop Require-Capability entry in manifest.</li>
	</ul>

	<h1 id="1.4.11.1">1.4.11.1</h1>

	<p>Released October 27, 2018.</p>

	<h2>Hot fix</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/133">#133</a>: XStream 1.4.11 fails to run on a Java Runtime &lt; 8.</li>
	</ul>

	<h1 id="1.4.11">1.4.11</h1>

	<p>Released October 23, 2018.</p>

	<p class="highlight">This maintenance release addresses again the security vulnerability <a href="CVE-2013-7285.html">
	    CVE-2013-7285</a>, an arbitrary execution of commands when unmarshalling with XStream instances using an
	    uninitialized security framework. Only 1.4.10 uninitialized security framework was affected.</p>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/pull/91">#91</a>, <a href="https://github.com/x-stream/xstream/pull/106">#106</a>: Clean-up data stacks in UnmarshallingContext implementations in case of exception (by
		M&auml;rt Bakhoff).</li>
		<li><a href="https://github.com/x-stream/xstream/issues/2">#2</a>: Unneeded contention in DefaultConverterLookup.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/94">#94</a>: Fix PathConverter containing absolute Windows paths.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/105">#105</a>: XStream's ObjectInputStream returns wrong values for readUnsignedByte and readUnsignedShort.</li>
		<li><a href="/jira/616">XSTR-616</a> and <a href="https://github.com/x-stream/xstream/pull/93">#93</a>: Introduce StringCodec interface to support arbitrary Base64 codec
		implementations for EncodedByteArrayConverter. Prefer Base64 codec implementations of the Java runtime over
		XStream's own one.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/97">#97</a>: Support to run out of the box in a Java 1.4 runtime is established again.</li>
		<li>Provide methods in AbstractCollectionConverter that read and write in a balanced way from and to the
		hierarchical stream.</li>
		<li>New future-proof method JVM.isVersion to detect major version of Java runtime (incl. Java 10) as
		replacement for individual JVM.isXY methods.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/115">#115</a>: Dom4JDriver ignores character set of Dom4J configuration creating a Writer.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/116">#116</a>: Make converters null safe.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/123">#123</a> and <a href="https://github.com/x-stream/xstream/pull/124">#124</a>: Declare XPP dependencies for OSGi as optional.</li>
		<li>Add XppDriver.createDefaultParser for a simpler access to the default XmlPullParserFactory.</li>
		<li>Old BEA reference implementation of StAX is outdated, unmaintained and has security issues, therefore
		XStream's driver has been deprecated.</li>
		<li>Support for JaCoCo: FieldDictionary ignores synthetic fields starting with <em>$jacoco</em> as name.</li>
		<li>Add integration test for OSGi (by Wes Wannemacher).</li>
	</ul>

	<h2>Stream compatibility</h2>

	<ul>
		<li>The EncodedByteArrayConverter will now use an encoder by default that does no longer add line breaks as
		normally required by the RFC 1521 after 76 characters, making it also easier to use the converter for
		attributes. This will not affect XStream's Base64 decoder.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.converters.collection.AbstractCollectionConverter.readBareItem(HierarchicalStreamReader, UnmarshallingContext, Object).</li>
		<li>Added c.t.x.converters.collection.AbstractCollectionConverter.readCompleteItem(HierarchicalStreamReader, UnarshallingContext, Object).</li>
		<li>Deprecated c.t.x.converters.collection.AbstractCollectionConverter.readItem(HierarchicalStreamReader, UnmarshallingContext, Object).</li>
		<li>Added c.t.x.converters.collection.AbstractCollectionConverter.writeBareItem(Object, MarshallingContext, HierarchicalStreamWriter).</li>
		<li>Added c.t.x.converters.collection.AbstractCollectionConverter.writeCompleteItem(Object, MarshallingContext, HierarchicalStreamWriter).</li>
		<li>Deprecated c.t.x.converters.collection.AbstractCollectionConverter.writeItem(Object, MarshallingContext, HierarchicalStreamWriter).</li>
		<li>Added c.t.x.converters.collection.AbstractCollectionConverter.writeNullItem(MarshallingContext, HierarchicalStreamWriter).</li>
		<li>Added c.t.x.converters.extended.EncodedByteArrayConverter(StingCodec).</li>
		<li>Added c.t.x.converters.extended.NamedCollectionConverter.readBareItem(HierarchicalStreamReader, UnmarshallingContext, Object).</li>
		<li>Deprecated c.t.x.converters.extended.NamedCollectionConverter.readItem(HierarchicalStreamReader, UnmarshallingContext, Object).</li>
		<li>Added c.t.x.converters.extended.NamedCollectionConverter.writeCompleteItem(Object, MarshallingContext, HierarchicalStreamWriter).</li>
		<li>Deprecated c.t.x.converters.extended.NamedCollectionConverter.writeItem(Object, MarshallingContext, HierarchicalStreamWriter).</li>
		<li>Added c.t.x.core.DefaultConverterLookup(Map).</li>
		<li>Added c.t.x.core.util.JVM.getBase64Codec().</li>
		<li>Added c.t.x.core.util.JVM.isVersion().</li>
		<li>Deprecated c.t.x.core.util.JVM.is18().</li>
		<li>Deprecated c.t.x.core.util.JVM.is9().</li>
		<li>Deprecated c.t.x.io.ExtendedHierarchicalStreamReader.</li>
		<li>Deprecated c.t.x.io.ExtendedHierarchicalStreamWriter.</li>
		<li>Deprecated c.t.x.io.ExtendedHierarchicalStreamWriterHelper.</li>
		<li>Deprecated c.t.x.io.xml.BEAStaxDriver.</li>
		<li>Added c.t.x.io.xml.Dom4JReader.Dom4JReader(Branch).</li>
		<li>Added c.t.x.io.xml.XppDriver.createDefaultParser().</li>
		<li>Added c.t.x.core.util.StingCodec.</li>
	</ul>

	<h1 id="1.4.10">1.4.10</h1>

	<p>Released May 23, 2017.</p>

	<p class="highlight">This maintenance release addresses also the security vulnerability <a href="CVE-2017-7957.html">
	    CVE-2017-7957</a>, used for a Denial of Service attack by crashing the Java runtime.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/84">#84</a>: New XStream artifact with <em>-java7</em> appended as version suffix for a library explicitly
		without the Java 8 stuff (lambda expression support, converters for java.time.* package).</li>
		<li>Fix PrimitiveTypePermission to reject type <em>void</em> to prevent CVE-2017-7957 with an initialized
		security framework.</li>
		<li>Improve performance by minimizing call stack of mapper chain.</li>
		<li><a href="https://github.com/x-stream/xstream/pull/82">#82</a>, <a href="/jira/774">XSTR-774</a>: Add converters for types of java.time, java.time.chrono, and java.time.temporal
			packages (converters for LocalDate, LocalDateTime, LocalTime, OffsetDateTime, and ZonedDateTime by Matej Cimbora).</li>
		<li><a href="https://github.com/x-stream/xstream/issues/29">#29</a>: JavaBeanConverter does not respect ignored unknown elements.</li>
		<li>Add XStream.setupDefaultSecurity to initialize security framework with defaults of XStream 1.5.x.</li>
		<li>Emit error warning if security framework has not been initialized and the XStream instance is vulnerable to
		known exploits.</li>
	</ul>

	<h2>Stream Compatibility</h2>

	<ul>
		<li>The alias <em>duration</em> for type <em>javax.xml.datatype.Duration</em> has changed to <em>xml-duration</em>
			due to the support of the classes in the java.time package. <em>duration</em> is now used for type <em>java.time.Duration</em>.
			Simply register the alias <em>duration</em> again for type <em>javax.xml.datatype.Duration</em> if backward
			compatibility is required for this type.
		</li>
		<li>All types of the java.time packages that have been written with previous versions of XStream can still be
			deserialized.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/54">#54</a>: Fix BeanProvider.canInstantiate(Class), method may not throw exception.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/76">#76</a> and <a href="https://github.com/x-stream/xstream/pull/77">#77</a>: Missing support for cascaded writeReplace calls.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/61">#61</a>: Regression in 1.4.9: Performance drop in ImplicitCollectionMapper.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/52">#52</a>: PathConverter fails for file paths with spaces.</li>
		<li>PathConverter uses always forward slashes as path separator.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/53">#53</a>: SqlTimestampConverter cannot parse values without fraction.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/45">#45</a>: Support different time zones for SqlTimestampConverter.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/67">#67</a> and <a href="https://github.com/x-stream/xstream/pull/68">#68</a>: Allow usage of DataHolder for createObjectInputStream and createObjectOutputStream.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/75">#75</a>: Use java.time.* package instead of Joda-Time.</li>
		<li>Dom4JXmlWriter does not flush writer at endDocument().</li>
		<li>Path is an immutable type.</li>
		<li><a href="https://github.com/x-stream/xstream/pull/65">#65</a>: Protect converter lookup against runtime errors.</li>
		<li>Current Java 9 implementation reports itself as version 9 now.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.util.JVM.is9().</li>
		<li>Added c.t.x.XStream.setupDefaultSecurity(XStream).</li>
		<li>Added c.t.x.XStream.createObjectInputStream(HierarchicalStreamReader, DataHolder) and
			c.t.x.XStream.createObjectOutputStream(HierarchicalStreamWriter, String, DataHolder).</li>
		<li>Added c.t.x.converters.javabean.PropertyDictionary.propertyDescriptorOrNull(Class, String).</li>
		<li>Added method c.t.x.mapper.Mapper.IsIgnoredElement(String)</li>
		<li>Added c.t.x.mapper.ElementIgnoringMapper.</li>
		<li>Deprecated method c.t.x.mapper.FieldAliasingMapper.addFieldsToIgnore(Pattern).</li>
		<li>Deprecated method c.t.x.mapper.FieldAliasingMapper.omitField(Class, String).</li>
		<li>Deprecated method c.t.x.core.util.JVM.is17().</li>
		<li>Deprecated method c.t.x.core.util.JVM.is19().</li>
	</ul>

	<h1 id="1.4.9">1.4.9</h1>

	<p>Released March 15, 2016.</p>

	<p class="highlight">This maintenance release addresses also the security vulnerability <a href="CVE-2016-3674.html">
	    CVE-2016-3674</a>, known as XXE vulnerability that can be used to expose arbitrary data from the file system
	    when unmarshalling.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/25">#25</a>: Fix <a href="https://www.owasp.org/index.php/XML_External_Entity_%28XXE%29_Processing">XXE
				vulnerability (CVE-2016-3674)</a>: Fixed affected drivers were Dom4JDriver, DomDriver, JDomDriver, JDom2Driver,
			SjsxpDriver, StandardStaxDriver and WstxDriver. Still vulnerable are BEAStaxDriver and XomDriver. Processing of
			(external) entities has been disabled. See <a href="faq.html#Security_XXEVulnerability">FAQ</a> for more information.
		</li>
		<li>Benchmark module has been deprecated in favor of <a href="http://openjdk.java.net/projects/code-tools/jmh/">
				JMH (Java Microbenchmarking Harness)</a>.
		</li>
		<li><a href="https://github.com/x-stream/xstream/issues/33">#33</a> and <a href="https://github.com/x-stream/xstream/pull/38">#38</a>: Add converter for java.nio.file.Path (by Aaron Jonson).</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="https://github.com/x-stream/xstream/issues/35">#35</a>: AnnotationMapper dropped silently constructor arguments for converters if they were equal.</li>
		<li>Fix: Possible concurrency problem with XomDriver.</li>
		<li><a href="/jira/773">XSTR-773</a>, <a href="https://github.com/x-stream/xstream/pull/3">#3</a>: Minimize memory footprint by not keeping internal references to instances of
			immutable types.</li>
		<li>Drop automatic reference support at deserialization time for immutable types before version 1.4 (primitive
			types and their boxed counterpart, java.lang.Class, java.lang.String, java.math.BigDecimal, java.math.BigInteger,
			java.io.File, java.net.URL, and java.awt.font.TextAttribute).</li>
		<li>Fix: Implicit collection declaration is erroneously inherited or propagated to hidden field of same name.</li>
		<li>XStreamConverter annotation supports null values as arguments for converter instantiation.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/5">#5</a>: Support null values for JavaBean properties.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/36">#36</a>: Fix NamedMapConverter, does not use SingleValueConverter of value if value is text of entry element.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/13">#13</a>: Own converter for javax.activation.ActivationDataFlavor, because ExternalizableConverter cannot
			handle a type that violates the Java specification.</li>
		<li><a href="https://github.com/x-stream/xstream/pull/18">#18</a>: Minimize synchronized block in FieldDictionary.</li>
		<li><a href="/jira/769">XSTR-769</a>: Synthetic fields with references to outer class use compiler dependent names.</li>
		<li><a href="/jira/771">XSTR-771</a>: UUID is an immutable type by default.</li>
		<li><a href="https://github.com/x-stream/xstream/pull/23">#23</a>: Constructor of AbstractXppDriver swallows causing exception.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/28">#28</a>: Fix functionality of ClassAliaslingMapper.itemTypeAsAttributes(Class).</li>
		<li><a href="https://github.com/x-stream/xstream/issues/37">#37</a>: Historical Java 1.3 support suppresses causing exception of a thrown InvocationTargetException.</li>
		<li><a href="https://github.com/x-stream/xstream/issues/41">#41</a>: Cannot instantiate ToAttributedValueConverter with null value for valueFieldName using
			XStreamConverter annotation.</li>
		<li>Fix example code in description of security framework.</li>
		<li>Clean-up usage of exceptions.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.XStream.addImmutableType(Class, boolean) and deprecated c.t.x.XStream.addImmutableType(Class).</li>
		<li>Added c.t.x.mapper.Mapper.isReferenceable(Class).</li>
		<li>Added c.t.x.mapper.ImmutableTypesMapper.addImmutableType(Class, boolean) and deprecated
			c.t.x.mapper.ImmutableTypesMapper.addImmutableType(Class).</li>
		<li>Added c.t.x.io.xml.Dom4JDriver.createReader().</li>
		<li>Added c.t.x.io.xml.DomDriver.createDocumentBuilderFactory().</li>
		<li>Added c.t.x.io.xml.JDomDriver.createBuilder().</li>
		<li>Added c.t.x.io.xml.JDom2Driver.createBuilder().</li>
		<li>Added c.t.x.io.xml.XomDriver.createBuilder().</li>
		<li>Added constructor c.t.x.converter.extended.ToAttributedValueConverter.ToAttributedValueConverter(Class,
			Mapper, ReflectionProvider, ConverterLookup).</li>
		<li>Added abstract c.t.x.converter.ErrorWritingException as common base for c.t.x.converter.ConversionException
			and c.t.x.converter.reflection.ObjectAccessException.</li>
		<li>Deprecated c.t.x.io.xml.XomDriver(Builder), c.t.x.io.xml.XomDriver(Builder, NameCoder) and
			c.t.x.io.xml.XomDriver.getBuilder().</li>
		<li>Deprecated c.t.x.mapper.ClassAliaslingMapper.itemTypeAsAttributes(Class) and
			c.t.x.mapper.ClassAliaslingMapper.aliasIsAttribute(String). Methods never called, left-over from old refactoring.</li>
	</ul>

	<h1 id="1.4.8">1.4.8</h1>

	<p>Released February 18, 2015.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Support for serializable lambda expressions and handling of non-serializable ones.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Detect Java 9 runtime.</li>
		<li><a href="/jira/767">XSTR-767</a>: Deserialization of referenced lambda expressions fail.</li>
		<li><a href="/jira/762">XSTR-762</a>: Private method readResolve() called on base classes.</li>
		<li><a href="/jira/761">XSTR-761</a>: Support ignored serialPersistentField at deserialization time.</li>
		<li><a href="/jira/755">XSTR-755</a>: ExternalizableConverter does not respect writeReplace and readResolve.</li>
		<li><a href="/jira/757">XSTR-757</a>: Deserialized TreeSet does not honor remove(Object) return value contract.</li>
		<li><a href="/jira/759">XSTR-759</a>: Support deserialization of <a href="http://www.w3.org/TR/NOTE-datetime">W3C datetime
				format</a> in DateConverter with Java 7 runtime.
		</li>
		<li>Fix: DateConverter ignores provided locale.</li>
		<li><a href="/jira/768">XSTR-768</a>: ISO8601GregorianCalendarConverter may set invalid time zone for Joda-Time.</li>
		<li>Fix: WeakCache.entrySet().iterator().next.setValue(value) returns the reference instead of the old value.</li>
		<li>Fix: SqlTimestampConverter throws IllegalArgumentException instead of ConversionException on fromString().</li>
		<li>Fix: CGLIBEnhancedConverter does not initialize transient members of parent after deserialization.</li>
		<li><a href="/jira/763">XSTR-763</a>: Set scope of org.json:json to test instead declaring the dependency as optional.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.util.JVM.is19().</li>
		<li>Added c.t.x.converter.reflection.LambdaConverter and c.t.x.mapper.LambdaMapper.</li>
		<li>Declare c.t.x.XStream.ignoreUnknownElements(Pattern) as public.</li>
		<li>c.t.x.converters.reflection.AbstractReflectionConverter.readResolve() is protected now.</li>
		<li>c.t.x.mapper.AbstractAttributeAliasingMapper.readResolve() is protected now.</li>
		<li>Deprecated c.t.x.converters.extended.StackTraceElementFactory, it is an internal helper class.</li>
		<li>Deprecated c.t.x.converters.reflection.SerializationMethodInvoker, it is an internal helper class.</li>
		<li>Deprecated c.t.x.io.AttributeNameIterator, it is an internal helper class.</li>
		<li>Deprecated c.t.x.XStream.useXStream11XmlFriendlyMapper(), corresponding
			c.t.x.mapper.XStream11XmlFriendlyMapper has been deprecated long ago.</li>
		<li>Deprecated c.t.x.converter.basic.BooleanConverter.shouldConvert(Class,Object), undetected remainder of
			ancient XStream version.</li>
	</ul>

	<h1 id="1.4.7">1.4.7</h1>

	<p>Released February 8, 2014.</p>

	<p class="highlight">This maintenance release addresses mainly the security vulnerability <a href="CVE-2013-7285.html">
	    CVE-2013-7285</a>, an arbitrary execution of commands when unmarshalling.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Add <a href="security.html#framework">security framework</a> to limit handled types while unmarshalling.
		</li>
		<li>java.bean.EventHandler no longer handled automatically because of severe security vulnerability.</li>
		<li><a href="/jira/751">XSTR-751</a>: New SunLimitedUnsafeReflectionProvider that uses undocumented features only to allocate new
			instances as required on Dalvik.</li>
		<li>Fix instantiation of AnnotationMapper that requires ConverterLookup and ConverterRegistry to be the same
			instance.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>XSTR-749: NPE if ReflectionConverter.canConvert(type) is called with null as argument.</li>
		<li>XSTR-753: NPE if SerializationConverter.canConvert(type) is called with an interface type as argument that
			extends Serializable.</li>
		<li>Add constructor to ReflectionConverter taking an additional type to create an instance that is dedicated to a
			specific type only.</li>
		<li>The ConverterLookup used by default cannot be casted to a ConverterRegistry anymore.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added package c.t.x.security with interface TypePermission, all its implementations and
			ForbiddenClassException.</li>
		<li>Added c.t.x.mapper.SecurityMapper handling the new type permissions.</li>
		<li>Added methods addPermission, denyPermission, allowTypesXXX and denyTypesXXX to c.t.x.XStream to setup
			security at unmarshalling time.</li>
		<li>Added c.t.x.converters.reflection.SunLimitedUnsafeReflectionProvider.</li>
		<li>Deprecated c.t.x.converters.reflection.Sun14ReflectionProvider in favor of new
			c.t.x.converters.reflection.SunUnsafeReflectionProvider.</li>
		<li>Added c.t.x.converters.reflection.ReflectionConverter(Mapper,ReflectionProvider,Class).</li>
	</ul>

	<h1 id="1.4.6">1.4.6</h1>

	<p>Released December 12, 2013.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/566">XSTR-566</a> and <a href="/jira/200">XSTR-200</a>: Better compatibility with GAE and environments with active SecurityManager
			(i.e. in an Applet). XStream converters try now to ensure already in the canConvert methods that they can handle the
			requested type in practice and not only theoretically. Additionally the implementations even better take care, that
			the initialization of a converter will not break the setup of XStream itself. Following modifications have been done
			for these topics:
			<ul>
				<li>ReflectionConverter, SerializationConverter and LookAndFieldConverter will check if they can access the
					fields by reflection for a requested type.</li>
				<li>SerializationConverter and ExternalizableConverter will check if they can create an instance of a derived
					OutputObjectStream first.</li>
				<li>BeanProvider does no longer use reflection to locate default constructor.</li>
				<li>AbstractAttributedCharacterIteratorAttributeConverter (and therefore TextAttributeConverter) will check
					first if it can access the possible constants of the type by reflection.</li>
				<li>NoClassDefFoundError raised in GAE accessing the fields of restricted types by reflection will be handled.</li>
				<li>StackTraceElementConverter uses constructor for StackTraceElement instances in Java 5 and GEA.</li>
			</ul>
		</li>
		<li><a href="/jira/739">XSTR-739</a> and <a href="/jira/746">XSTR-746</a>: OrderRetainingMap fails if HashMap.putAll(Map) of Java Runtime is not
			implemented calling put for every element within the map.</li>
		<li>New NamedArrayConverter to define names of inner elements.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/747">XSTR-747</a>: All constructors of StaxDriver derived classes take erroneously a XmlFriendlyNameCoder instead
			of a plain NameCoder.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.converters.extended.NamedArrayConverter for free element names in arrays.</li>
		<li>Added constructors to c.t.x.io.xml.StandardStaxDriver taking NameCoder instead of XmlFriendlyNameCoder.</li>
		<li>Deprecated constructors of c.t.x.io.xml.StandardStaxDriver taking a XmlFriendlyNameCoder.</li>
		<li>Added constructors to c.t.x.io.xml.BEAStaxDriver taking NameCoder instead of XmlFriendlyNameCoder.</li>
		<li>Deprecated constructors of c.t.x.io.xml.BEAStaxDriver taking a XmlFriendlyNameCoder.</li>
		<li>Added constructors to c.t.x.io.xml.WstxDriver taking NameCoder instead of XmlFriendlyNameCoder.</li>
		<li>Deprecated constructors of c.t.x.io.xml.WstxDriver taking a XmlFriendlyNameCoder.</li>
		<li>Added method canAccess to c.t.x.converter.reflection.AbstractReflectionConverter.</li>
		<li>Added static method canCreateDerivedObjectOutputStream to c.t.x.core.JVM.</li>
		<li>Deprecated unused member c.t.x.converter.javabean.BeanProvider.NO_PARAMS.</li>
		<li>Deprecated unused method c.t.x.converter.javabean.BeanProvider.getDefaultConstrutor(Class).</li>
	</ul>


	<h1 id="1.4.5">1.4.5</h1>

	<p>Released September 18, 2013.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/732">XSTR-732</a>: Use a referencing implementation for the ClassLoader to support environments where no new
			ClassLoader can be instantiated due to security restrictions.</li>
		<li><a href="/jira/691">XSTR-691</a>: Allow unknown XML elements to be ignored using new method XStream.ignoreUnknownElements.</li>
		<li><a href="/jira/728">XSTR-728</a>: XStream creates invalid JSON with JsonHierarchicalStreamDriver for custom converters since
			XStream 1.4.</li>
		<li><a href="/jira/300">XSTR-300</a>: New EnumToStringConverter to support custom string representations of Enum values.</li>
		<li><a href="/jira/292">XSTR-292</a> and <a href="/jira/405">XSTR-405</a>: New NamedMapConverter and NamedCollectionConverter to define names of inner
			elements.</li>
		<li><a href="/jira/726">XSTR-726</a>: New annotation XStreamAliasType to support declarative definition of XStream.aliasType().</li>
		<li><a href="/jira/735">XSTR-735</a>: Support for JDOM2 with JDom2Driver, JDom2Reader and JDom2Writer.</li>
		<li>Optimized XML structure for java.awt.Font.</li>
		<li>Fix: ToAttributedValueConverter silently appends fields without attribute support to the value producing
			mixed-mode XML.</li>
		<li><a href="/jira/566">XSTR-566</a> and <a href="/jira/249">XSTR-249</a>: Better compatibility with Google AppEngine and J2ME, setup no longer fails
			for unavailable converters.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Fix missing manifest information.</li>
		<li><a href="/jira/729">XSTR-729</a>: Add OSGi information to manifests.</li>
		<li><a href="/jira/723">XSTR-723</a>: XStream will now detect a working enhanced mode dynamically instead using lists of known
			vendors. This allows enhanced support for JamVM if it is bundled with OpenJDK. It will currently fail on a runtime
			based on GNU Classpath (at least up to version 0.98).</li>
		<li><a href="/jira/541">XSTR-541</a>: JavaScript compatibility problem with 64-bit integers in JSON.</li>
		<li><a href="/jira/719">XSTR-719</a>: Support replacement of default converter in any case.</li>
		<li><a href="/jira/725">XSTR-725</a>: processAnnotation performance improvement in concurrent situation.</li>
		<li><a href="/jira/721">XSTR-721</a>: EnumConverter is more lenient while parsing constants.</li>
		<li>New constructors for CollectionConverter and MapConverter to allow registration for an individual type.</li>
		<li><a href="/jira/724">XSTR-724</a>: Cache class name lookup failures.</li>
		<li>Current IBM JDK for Java 1.4.2 no longer has a reverse field ordering.</li>
		<li>LongConverter supports now positive hex and octal numbers over Long.MAX_VALUE within 64 bit.</li>
		<li>Fix: Sun14RefectionProvider ignores a provided FieldDictionary.</li>
		<li><a href="/jira/457">XSTR-457</a>: Do not write 'defined-in' attribute if not needed.</li>
		<li>JettisonMappedXmlDriver provides better support to overwrite its create methods.</li>
		<li><a href="/jira/685">XSTR-685</a>: StAX based drivers (StaxDriver and JettisonMappedXmlDriver) are not closing internal input
			stream reading from file or URL.</li>
		<li><a href="/jira/736">XSTR-736</a>: XStream.unmarshal may throw NPE if version info of manifest is missing.</li>
		<li><a href="/jira/733">XSTR-733</a>: Implicit elements that match multiple defined implicit collections will be assigned to the map
			with the nearest matching element type.</li>
		<li><a href="/jira/740">XSTR-740</a>: ISO8601GregorianCalendarConverter creates Calendar instance with wrong Locale in Java 7 if the
			Locale for the LocaleCategory.FORMAT is different to the global default Locale.</li>
		<li><a href="/jira/578">XSTR-578</a>: Implement support for aliasing in JavaClasConverter, JavaFieldConverter and
			JavaMethodConverter. While it is not possible to enable this in general, new constructors have been added to these
			converters and an example in the acceptance tests (AliasTest).</li>
		<li><a href="/jira/742">XSTR-742</a>: Register CompositeClassLoader in Java 7 as parallel capable.</li>
		<li><a href="/jira/743">XSTR-743</a>: Support proxy collections of Hibernate Envers.</li>
		<li>Fix NPE in AttributeMapper.shouldLookForSingleValueConverter if parameters fieldName and definedIn are null.</li>
		<li>Implicit type argument can be omitted when registering converters with @XStreamConverter annotation.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added c.t.x.converters.extended.NamedCollectionConverter for free element names in collections.</li>
		<li>Added c.t.x.converters.extended.NamedMapConverter for free element names in maps.</li>
		<li>Added c.t.x.io.xml.StandardStaxDriver to use the StAX implementation delivered with the Java 6 runtime.</li>
		<li>Deprecated c.t.x.io.xml.SjsxpStaxDriver to select the internal StAX implementation of Oracle.</li>
		<li>Added static methods getStaxInputFactory and getStaxOutputFactory to c.t.x.core.JVM as returning the
			implementations of javax.xml.stream.XMLInputFactory (resp. javax.xml.stream.XMLOutputFactory) delivered with the Java
			Runtime since Java 6.</li>
		<li>Added c.t.x.core.ClassLoaderReference.</li>
		<li>Added constructors taking an additional Class argument for c.t.x.converters.collections.CollectionConverter
			and c.t.x.converters.collections.MapConverter.</li>
		<li>Added constructors taking a ClassLoaderReference instead of a ClassLoader and deprecated the ones taking the
			ClassLoader:
			<ul>
				<li>c.t.x.XStream</li>
				<li>c.t.x.converters.extended.DynamicProxyConverter</li>
				<li>c.t.x.converters.extended.JavaClassConverter</li>
				<li>c.t.x.converters.extended.JavaFieldConverter</li>
				<li>c.t.x.converters.extended.JavaMethodConverter</li>
				<li>c.t.x.converters.reflection.CGLIBEnhancedConverter</li>
				<li>c.t.x.converters.reflection.ExternalizableConverter</li>
				<li>c.t.x.converters.reflection.SerializableConverter</li>
				<li>c.t.x.mapper.AnnotationMapper</li>
				<li>c.t.x.mapper.DefaultMapper</li>
			</ul>
		</li>
		<li>Added static methods newReflectionProvider, isAWTAvailable, isSQLAvailable and isSwingAvailable to
			c.t.x.core.JVM as replacement for the deprecated non-static methods.</li>
		<li>Deprecated c.t.x.core.JVM() and all non-static methods.</li>
		<li>Added method useImplicitType to c.t.x.annotations.XStreamConverter.</li>
		<li><a href="/jira/722">XSTR-722</a>: Added c.t.x.converters.reflection.ReflectionProvider.getFieldOrNull(Class, String).</li>
		<li>Deprecated c.t.x.converters.reflection.ReflectionProvider.fieldDefinedInClass(Class, String) in favor of new
			c.t.x.converters.reflection.ReflectionProvider.getFieldOrNull(Class, String).</li>
		<li>Deprecated constructor c.t.x.converters.extended.RegexPatternConverter(Converter) in favor of
			c.t.x.converters.extended.RegexPatternConverter().</li>
		<li>Deprecated default constructor of c.t.x.converters.extended.FontConverter in favor of
			c.t.x.converters.extended.FontConverter(Mapper).</li>
		<li>Deprecated constructor c.t.x.converters.extended.ThrowableConverter(Converter) in favor of
			c.t.x.converters.extended.ThrowableConverter(ConverterLookup).</li>
		<li>Deprecated class c.t.x.converters.reflection.SelfStreamingInstanceChecker and moved original implementation
			into c.t.x.core.util, since it is internal.</li>
		<li>Deprecated interface c.t.x.mapper.AnnotationConfiguration.</li>
	</ul>

	<h1 id="1.4.4">1.4.4</h1>

	<p>Released January 19, 2013.</p>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/709">XSTR-709</a>: Locks up on Mac with Apple JVM due to unwanted initialization of AWT.</li>
		<li><a href="/jira/711">XSTR-711</a>: DateConverter cannot handle dates in different era.</li>
		<li><a href="/jira/741">XSTR-741</a>: ToAttributedValueConverter fails to write enums as attributes.</li>
		<li><a href="/jira/712">XSTR-712</a>: HibernateMapper throws NPE if a collection contains null.</li>
		<li>DateConverter supports now localized formats.</li>
		<li><a href="/jira/710">XSTR-710</a>: JsonWriter does not write BigInteger and BigDecimal as number values.</li>
		<li><a href="/jira/708">XSTR-708</a>: SqlTimestampConverter does not ignore timezone.</li>
		<li><a href="/jira/707">XSTR-707</a>: Creation of XmllPullParser with the XmlPullParserFactory may fail in OSGi environment.</li>
		<li><a href="/jira/705">XSTR-705</a>: Unnecessary synchronization accessing the field cache decreases performance.</li>
		<li><a href="/jira/714">XSTR-714</a>: Fields not found when XStream12FieldKeySorter used.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Deprecated method c.t.x.core.util.JVM.is14(), c.t.x.core.util.JVM.is15() and c.t.x.core.util.JVM.is16().</li>
	</ul>

	<h1 id="1.4.3">1.4.3</h1>

	<p>Released July 17, 2012.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Support java.util.concurrent.ConcurrentHashMap with the MapConverter. This will also avoid a bug in JRockit
			JDK reported in <a href="/jira/608">XSTR-608</a>.</li>
		<li><a href="/jira/699">XSTR-699</a>: Support for Hibernate 4 with XStream's Hibernate module as default for Java 6 or higher.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>JVM.loadClass will now also initialize the loaded class and ignore any occurring LinkageError.</li>
		<li><a href="/jira/596">XSTR-596</a>: SubjectConverter will be no longer registered if initialization of javax.security.auth.Subject
			fails.</li>
		<li><a href="/jira/683">XSTR-683</a>: Inheritance of implicit collections, arrays or maps is dependent on declaration sequence.</li>
		<li>Inherited implicit collections, arrays or maps can be overwritten with own definition in subtype.</li>
		<li><a href="/jira/688">XSTR-688</a>: Cannot omit XML elements from derived fields.</li>
		<li><a href="/jira/696">XSTR-696</a>: Ill-formed JSON generated, because JSON writer is fed with type of declaring field instead of
			the real object's type.</li>
		<li><a href="/jira/685">XSTR-685</a>: Deserialization from file or URL keeps stream open.</li>
		<li><a href="/jira/684">XSTR-684</a>: XML 1.0 character validation fails for characters from 0x10 to 0x1f.</li>
		<li>JavaBeanConverter supports now instantiation for a specific type and can therefore be used in
			@XStreamConverter annotation.</li>
		<li>SerializableConverter is broken if the serialized type is the default implementation.</li>
		<li>Method marshalUnserializableParent of SerializableConverter is protected now to skip the default mechanism in
			a derived converter that uses the default constructor to create the original type (as an alternative for
			<a href="/jira/695">XSTR-695</a>).</li>
		<li>FieldDictionary may call sort of FieldKeySorter implementation with wrong type as key.</li>
		<li>Sometimes DependencyInjectionFactory tries to instantiate objects with mismatching constructor arguments.</li>
		<li>HSQLDB has to be a test dependency only for XStream's Hibernate module.</li>
	</ul>

	<h1 id="1.4.2">1.4.2</h1>

	<p>Released November 3, 2011.</p>

	<h2>Major changes</h2>

	<ul>
		<li>XStream libraries can be used now directly in Android, therefore support of Java 1.4.2 has been stopped with
			the delivery. Anyone who needs a version for Java 1.4.2 can build it easily from source, this build is still
			supported and part of CI.</li>
		<li><a href="/jira/675">XSTR-675</a>: New extended HierarchicalStreamReader interface with peekNextChild method. All XStream readers
			implement the new interface (by Nikita Levyankov).</li>
		<li><a href="/jira/673">XSTR-673</a>: Collections.EMPTY_LIST, Collections.EMPTY_SET and Collections.EMPTY_MAP supported with own
			alias and defined as immutable.</li>
		<li><a href="/jira/631">XSTR-631</a>: Collections.singletonList(), Collections.singletonSet() and Collections.singletonMap()
			supported with own alias and own converters.</li>
		<li><a href="/jira/406">XSTR-406</a> + <a href="/jira/663">XSTR-663</a>: Support additional parameters for XStreamConverter annotation (e.g. to declare
			a ToAttributedValueConverter).</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>WstxDriver did not trigger Woodstox, but BEA StAX implementation.</li>
		<li><a href="/jira/260">XSTR-260</a>: PrettyPrintWriter does not handle tab and new line characters in attributes.</li>
		<li><a href="/jira/667">XSTR-667</a>: Cannot serialize empty list with JsonHierarchicalStreamDriver.</li>
		<li><a href="/jira/661">XSTR-661</a>: TreeMarshaller.CircularReference is not a ConversionException.</li>
		<li><a href="/jira/562">XSTR-562</a>: StAX: Namespace attribute is not written in non-repairing mode for second sibling.</li>
		<li><a href="/jira/664">XSTR-664</a>: ClassCastException in HibernatePersistentSortedSetConverter and
			HibernatePersistentSortedMapConverter.</li>
		<li><a href="/jira/674">XSTR-674</a>: Recreate binary compatibility with 1.3.x series for method
			CustomObjectInputStream.getInstance(...).</li>
		<li><a href="/jira/671">XSTR-671</a>: CannotResolveClassException should accept cause.</li>
		<li><a href="/jira/672">XSTR-672</a>: Collections.EMPTY_LIST, Collections.EMPTY_SET and Collections.EMPTY_MAP used for in implicit
			collection should not throw ReferencedImplicitElementException.</li>
		<li><a href="/jira/676">XSTR-676</a>: Introduce MissingFieldException thrown at deserialization time indicating a missing field or
			property (by Nikita Levyankov).</li>
		<li>Add length limit for cached strings in StringConverter, 38 characters by default.</li>
		<li>The JsonHierarchicalStreamDriver and the JsonWriter did not support the inherited NameCoder instance.</li>
		<li>Add BinaryStreamDriver.</li>
		<li>NPE in XppDomComparator.</li>
		<li>Dom4JXmlWriter fails to flush the underlying writer.</li>
		<li>Known control characters are not encoded with JsonWriter as proposed at json.org.</li>
		<li>Detect duplicate property processing in JavaBeanConverter and throw DuplicatePropertyException instead of
			clobbering silently.</li>
		<li>Allow access to Mapper and JavaBeanProvider in derived instances of JavaBeanConverter.</li>
		<li>DependencyInjectionFactory failed to create instance when a matching constructor was found, but a default
			constructor was also present.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Added interface c.t.x.io.ExtendedHierarchicalStreamReader extending c.t.x.io.HierarchicalStreamReader. All
			implementations of c.t.x.io.HierarchicalStreamReader will implement also the extended interface.</li>
		<li>Added c.t.x.converters.reflection.MissingFieldException derived from
			c.t.x.converters.reflection.ObjectAccessException and used instead when the unmarshalling process should write a
			field or property that is missing and does not exist.</li>
		<li>Added methods c.t.x.io.path.PathTracker.peekElement(), c.t.x.io.path.PathTracker.peekElement(int), and
			c.t.x.io.path.PathTracker.depth().</li>
		<li>Deprecated method c.t.x.core.ReferencingMarshallingContext.currentPath(). Wrong approach.</li>
	</ul>

	<h1 id="1.4.1">1.4.1</h1>

	<p>Released August 11, 2011.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/659">XSTR-659</a>: Use again Xpp3 as default parser, now with additional XmlPullParser API as regular dependency
			for the XPP factory. Only standard kXML2 package contains the XPP factory, but not the minimal kXML2 version.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Add utility class c.t.x.io.xml.xppdom.XppFactory and a path tracking comparator for XppDom.</li>
	</ul>

	<h1 id="1.4">1.4</h1>

	<p>Released August 6, 2011.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Java 7 is detected and supported.</li>
		<li><a href="/jira/542">XSTR-542</a>: The XppDriver uses now the official XmlPullParser API to locate an available parser using the
			XmlPullParserFactory. This allows the usage of XPP technology with XStream in Android.</li>
		<li>Additional explicit XPP drivers for the Xpp3 and kXML2 implementations.</li>
		<li>Additional explicit XPP DOM drivers for the Xpp3 and kXML2 implementations.</li>
		<li>kXML2 is now the preferred parser implementation, Xpp3 is optional.</li>
		<li>Additional explicit StAX drivers for Woodstox, BEA StAX and SJSXP of the JDK 6 implementations.</li>
		<li>JDK 1.3 is no longer officially supported.</li>
		<li><a href="/jira/377">XSTR-377</a>+<a href="/jira/226">XSTR-226</a>: New artifact xstream-hibernate with converters and mapper to process Hibernate
			object graphs (by Costin Leau, Konstantin Pribluda and in special Jaime Metcher).</li>
		<li>New NameCoder interface and implementations to support a generic name translation between names from the
			object graph and a target format. The new XmlFriendlyNameCoder replaces the XmlFriendlyReplacer used for XML only.</li>
		<li><a href="/jira/553">XSTR-553</a>: Support annotations in Android.</li>
		<li><a href="/jira/556">XSTR-556</a>: DateConverter uses format with 3-letter time zones that are ambiguous. Therefore it will now
			always use UTC to write dates. Unmarshalled dates are not affected as long as they contain a time zone.</li>
		<li>The type java.lang.reflect.Field is now handled by an own converter, that can still read the old format.</li>
		<li><a href="/jira/490">XSTR-490</a>: Provide path in Converter for contexts that track the path.</li>
		<li><a href="/jira/592">XSTR-592</a>+<a href="/jira/579">XSTR-579</a>: OmitField respected at deserialization time even for existing fields.</li>
		<li><a href="/jira/593">XSTR-593</a>: Direct support for java.net.URI instances (by Carlos Roman).</li>
		<li><a href="/jira/615">XSTR-615</a>+<a href="/jira/580">XSTR-580</a>: Dynamic proxies cannot be referenced recursively.</li>
		<li><a href="/jira/547">XSTR-547</a>: Wrong class loader used for Serializable types deserialized with an ObjectInputStream.</li>
		<li><a href="/jira/341">XSTR-341</a>: Support of implicit arrays.</li>
		<li><a href="/jira/306">XSTR-306</a>+<a href="/jira/406">XSTR-406</a>: Support of implicit maps.</li>
		<li><a href="/jira/344">XSTR-344</a>: New ToAttributedValueConverter to allow conversion of an element with string body and
			attributes.</li>
		<li><a href="/jira/573">XSTR-573</a>: SortedSet added with TreeSet as the default implementation.</li>
		<li><a href="/jira/576">XSTR-576</a>: TreeMap and TreeSet no longer add an element without comparator (by Jason Greanya), solves
			also invalid format with JSON for such objects (<a href="/jira/640">XSTR-640</a>).</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/612">XSTR-612</a>: Improve extensibility of c.t.x.javabean.* package by reintroducing a PropertyDictionary with
			the additional interface PropertySorter.</li>
		<li><a href="/jira/591">XSTR-591</a>: EnumSingleValueConverter did use toString() instead of name() to create the String
			representation of an enum value.</li>
		<li><a href="/jira/618">XSTR-618</a>: Add Oracle as vendor used for recent JRockit versions and former Sun JDK.</li>
		<li><a href="/jira/656">XSTR-656</a>: DomReader and Dom4JReader do not escape attribute names retrieving their values.</li>
		<li><a href="/jira/604">XSTR-604</a>: StringConverter's cache may cause an OutOfMemoryException.</li>
		<li><a href="/jira/577">XSTR-577</a>: Skip UTF-8 BOM in XmlHeaderAwareReader.</li>
		<li>The XppReader no longer uses a BufferedReader.</li>
		<li><a href="/jira/543">XSTR-543</a>: Better deserialization support of the defined-in system attribute in combination with field
			aliases.</li>
		<li><a href="/jira/551">XSTR-551</a>: Deprecated XStream.InitializationException still thrown instead of InitializationException.</li>
		<li><a href="/jira/655">XSTR-655</a>: JsonWriter generates invalid JSON for Externalizable types.</li>
		<li><a href="/jira/540">XSTR-540</a>: Support Jettison-based configuration of JettisonMappedXmlDriver (by Doug Daniels).</li>
		<li><a href="/jira/633">XSTR-633</a>: JettisonMappedXmlDriver escaped property names according escape rules for XML tag names.</li>
		<li><a href="/jira/625">XSTR-625</a>: Optionally ignore XStream's hints for Jettison to generate JSON arrays (by Dejan Bosanac).</li>
		<li><a href="/jira/605">XSTR-605</a>: Upgrade to Jettison 1.2 (for Java 5 or higher).</li>
		<li>New JsonWriter.EXPLICIT_MODE generating JSON that enforces property sequence.</li>
		<li><a href="/jira/552">XSTR-552</a>: Improve performance of ReflectionProvider (by Keith Kowalczykowski).</li>
		<li><a href="/jira/559">XSTR-559</a>: Improve performance of Sun14ReflectionProvider (by Keith Kowalczykowski).</li>
		<li><a href="/jira/564">XSTR-564</a>: Improve performance of AnnotationMapper (by Keith Kowalczykowski).</li>
		<li><a href="/jira/563">XSTR-563</a>: Use ReferenceQueue for cleaning-up WeakReferences in ObjectIdDictionary (by Keith
			Kowalczykowski).</li>
		<li><a href="/jira/646">XSTR-646</a>: Cache of Sun14ReflectionProvider consumes more PermGen space than necessary.</li>
		<li><a href="/jira/636">XSTR-636</a>: Ineffective cache in FieldDictionary using WeakHashMap with WeakReference values.</li>
		<li>Ineffective cache for SerializationMethodInvoker (related to <a href="/jira/636">XSTR-636</a>).</li>
		<li>Introduction of Caching interface implemented by all types in XStream that create local caches that may have
			to be flushed manually.</li>
		<li>Avoid excessive creation of AbstractPullReader.Event objects by using a pool.</li>
		<li>Possibility to generate XPath expressions that select always a single node instead of a node list.</li>
		<li>Cannot reference replaced object using ID references.</li>
		<li>Implicit collection functionality will no longer use custom collection converters that may write tags that
			are not recognized at deserialization time again.</li>
		<li><a href="/jira/654">XSTR-654</a>: Unmarshal fails when an implicit collection is defined and an element is named equal to the
			field.</li>
		<li><a href="/jira/574">XSTR-574</a>: AbstractReferenceUnmarshaller cannot handle null values for references.</li>
		<li>Improve exception output in case of a missing field.</li>
		<li><a href="/jira/555">XSTR-555</a>: StAX driver tests do not honor repairing mode.</li>
		<li><a href="/jira/570">XSTR-570</a>: The @XStreamConverter provides now also the current type as possible constructor argument.</li>
		<li><a href="/jira/629">XSTR-629</a>: Deserialization of Externalizable with non-accessible default constructor fails.</li>
		<li><a href="/jira/571">XSTR-571</a>: Cannot serialize synchronized RandomAccessList types.</li>
		<li><a href="/jira/583">XSTR-583</a>: BinaryDriver fails to handle Strings with more than 64K bytes.</li>
		<li><a href="/jira/639">XSTR-639</a>: Cannot omit field at deserialization if the field has a class attribute.</li>
		<li><a href="/jira/599">XSTR-599</a>: EncodedByteArrayConverter should implement SingleValueConverter.</li>
		<li><a href="/jira/584">XSTR-584</a>: Race condition in XmlFriendlyReplacer.</li>
		<li><a href="/jira/623">XSTR-623</a>: XmlFriendlyReplacer may write illegal name characters (by Michael Schnell).</li>
		<li>The ConversionException hides information if its ErrorWriter contains the added key already.</li>
		<li><a href="/jira/598">XSTR-598</a>: Attribute &quot;defined-in&quot; was wrongly evaluated for other attributes.</li>
		<li><a href="/jira/650">XSTR-650</a>: Possible NullPointerException at initialization on platforms like Android that do not support
			all types of the JDK.</li>
		<li><a href="/jira/652">XSTR-652</a>: Initialization of XStream fails if DurationConverter constructor throws a
			javax.xml.datatype.DatatypeConfigurationException. Converter will no longer handle Duration types if no instance of
			the internal DatatypeFactory can be created.</li>
		<li>Constructor DocumentWriter(Element) forgets the provided element.</li>
		<li><a href="/jira/597">XSTR-597</a>: Optimize AbstractReflectionConverter.</li>
		<li>Introduce Caching interface to flush the internal cache of specific components.</li>
		<li>Support <a href="/jira/407">XSTR-407</a> also for IBM JRE 1.6 and greater.</li>
		<li>java.nio.charset.Charset's converter was added as immutable type instead of the type itself.</li>
		<li>java.util.Currency added as immutable type.</li>
		<li>Fix selection of same parameter types in DependencyInjectionFactory.</li>
		<li>Deprecation of c.t.x.javabean.PropertyDictionary has been countermanded.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Any deprecated stuff of the 1.2.x releases has been removed.</li>
		<li>Deprecated constructors of c.t.x.converters.reflection.SerializableConverter,
			c.t.x.converters.reflection.ExternalizableConverter and c.t.x.converters.reflection.CGLIBEnhancedConverter; new
			versions take an additional argument for class loader (as a result for <a href="/jira/547">XSTR-547</a>).</li>
		<li>Deprecated constructors of c.t.x.io.xml.XppReader, new versions take an additional argument for the
			XmlPullParser.</li>
		<li>Deprecated c.t.x.io.xml.XppReader.createParser(), the XPP parser is now created by the driver.</li>
		<li>Package c.t.x.io.xml.xppdom is now part of the official API.</li>
		<li>c.t.x.io.xml.xppdom.Xpp3Dom and c.t.x.io.xmlxpp.dom.Xpp3DomBuilder have been deprecated. Functionality is
			merged in c.t.x.io.xml.xppdom.XppDom.</li>
		<li>Deprecated c.t.x.mapper.XStream11XmlFriendlyMapper and c.t.x.mapper.AbstractXmlFriendlyMapper.</li>
		<li>Added interface c.t.x.core.ReferencingMarshallingContext which is implemented by all referencing marshallers.</li>
		<li>Added interface c.t.x.io.naming.NameCoder and implementations.</li>
		<li>Deprecated c.t.x.io.xml.XmlFriendlyReplacer, c.t.x.io.xml.XmlFriendlyReader and
			c.t.x.io.xml.XmlFriendlyWriter.</li>
		<li>Deprecated c.t.x.io.xml.AbstractXmlDriver, c.t.x.io.xml.AbstractXmlReader and c.t.x.io.xml.AbstractXmlWriter,
			added c.t.x.io.AbstractDriver, c.t.x.io.AbstractReader and c.t.x.io.AbstractWriter instead.</li>
		<li>Deprecated all constructors of Driver, Reader and Writer implementations that take a XmlFriendlyReplacer as
			argument, added constructors taking a NameCoder instead.</li>
		<li>Added interface com.thoughtworks.xstream.converters.ErrorReporter to allow other types to report also errors
			(apart from a HierarchicalStreamReader). Any converter and the parent object of the currently deserialized element
			may provide additional error information now.</li>
	</ul>

	<h1 id="1.3.1">1.3.1</h1>

	<p>Released December 6, 2008.</p>

	<p class="highlight">CGLIB support must be explicitly activated now. The decision has been made due to possible
		problems using an own classloader and because of ongoing complaints about occurring exceptions in the
		CGLIBEnhancedConverter at XStream initialization although they are caused by incompatible ASM versions on the user's
		classpath (<a href="/jira/469">XSTR-469</a>, <a href="/jira/513">XSTR-513</a> and <a href="/jira/518">XSTR-518</a>).</p>

	<p class="highlight">XStream uses some attributes on its own. Until now it was possible to use
		XStream.aliasAttribute to define a different name. This does still work but is deprecated for system attributes. Use
		the new call XStream.aliasSystemAttribute for such an alias.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/515">XSTR-515</a>: CGLIB support is no longer activated automatically and has to be <a
			href="faq.html#Serialization_CGLIB">explicitly turned on</a>.
		</li>
		<li><a href="/jira/448">XSTR-448</a>: Separated system attributes and user defined attributes for aliases.</li>
		<li><a href="/jira/55">XSTR-55</a>: Ability to alias a package name.</li>
		<li><a href="/jira/434">XSTR-434</a>: New JsonWriter instead of JsonHierarchicalStreamWriter with mode to strip root node of
			generated JSON (by Paul Hammant).</li>
		<li>Support for Diablo JDK on FreeBSD (by Reto Bachmann-Gm&uuml;r).</li>
		<li><a href="/jira/495">XSTR-495</a>: New PersistenceStrategy instead of StreamStrategy (based on the code and comments by Alexander
			Radzin).</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Support special Jettison functionality for JSON to detect collections or arrays with one element introduced
			with Jettison 1.0.</li>
		<li><a href="/jira/493">XSTR-493</a>: Using attributes for fields with XML-unfriendly names results in NPE at deserialization.</li>
		<li><a href="/jira/497">XSTR-497</a>: Unsafe operation with WeakHashMap can raise a NPE in Sun14ReflectionProvider.</li>
		<li><a href="/jira/423">XSTR-423</a>: Support of CGLIB enhanced proxies with multiple callbacks if the proxy uses a factory (CGLIB
			default).</li>
		<li><a href="/jira/536">XSTR-536</a>: XStream silently ignores unknown elements.</li>
		<li><a href="/jira/503">XSTR-503</a>: Omitted properties in JavaBeans are requested at serialization (by Kevin Conaway).</li>
		<li>Fix possible memory leak in ObjectIdMap for JVMs that provide real distinct identity hash codes (happened on
			amd64 system).</li>
		<li><a href="/jira/480">XSTR-480</a>: Aliasing of array types.</li>
		<li><a href="/jira/515">XSTR-515</a>: The SubjectConverter and DurationConverter are only registered if the converted class is part
			of the JDK, otherwise they must be registered now explicitly.</li>
		<li><a href="/jira/504">XSTR-504</a>: XmlHeaderAwareReader fails with improper sized PushbackInputStream.</li>
		<li><a href="/jira/489">XSTR-489</a>: @XStreamConverter supports now also SingleValueConverter implementations.</li>
		<li><a href="/jira/481">XSTR-481</a>: @XStreamConverter and @XStreamAsAttribute can be used together (as a result of <a href="/jira/489">XSTR-489</a>).</li>
		<li><a href="/jira/519">XSTR-519</a>: New annotation @XStreamInclude to force annotation detection of included types (by Seven
			Sparling).</li>
		<li><a href="/jira/469">XSTR-469</a>: Support custom converters for enum types.</li>
		<li><a href="/jira/502">XSTR-502</a>: ClassNotFoundException even if writeReplace returns proper object.</li>
		<li><a href="/jira/529">XSTR-529</a>: NullPointerException for null elements in implicit lists.</li>
		<li><a href="/jira/517">XSTR-517</a>: Miscellaneous performance improvements (by Tatu Saloranta).</li>
		<li><a href="/jira/525">XSTR-525</a>: JsonHierarchicalStreamDriver writes invalid JSON in case of system attribute.</li>
		<li><a href="/jira/535">XSTR-535</a>: Mode to allow plain values as result for JSON without root node.</li>
		<li><a href="/jira/531">XSTR-531</a>: Possibility to omit system attributes.</li>
		<li><a href="/jira/508">XSTR-508</a>: Fix marshalling error for nested serializable objects with own writeReplace/readResolve
			methods.</li>
		<li><a href="/jira/507">XSTR-507</a>: Advanced ReferenceByIdMarshaller uses id of the current object if available.</li>
		<li><a href="/jira/485">XSTR-485</a>: Check reference for valid object when deserializing.</li>
		<li>Fix classloader problem, Xpp3 parser cannot be loaded within a web application.</li>
		<li>Dependencies have been updated to latest versions of JDOM, Jettison, Joda Time, and Woodstox. Note for Maven
			builds that the <em>groupId</em> of JDOM has changed.
		</li>
		<li>Fix possible IndexOutOfBoundsException creating returning the message for a ConversionException.</li>
		<li><a href="/jira/495">XSTR-495</a>: StreamStrategy cannot handle key with value <em>null</em>.
		</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Deprecated c.t.x.io.json.JsonHierarchicalStreamWriter in favour of c.t.x.io.json.JsonWriter.</li>
		<li>c.t.x.mapper.EnumMapper no longer derives from the c.t.x.mapper.AttributeMapper as it has been before version
			1.3. Therefore the new constructor has been deprecated in favour of the old one.</li>
		<li>c.t.x.mapper.Mapper.getConverterFromAttribute(Class, String) has been deprecated in favour of
			c.t.x.mapper.Mapper.getConverterFromAttribute(Class, String, Class) taking the type as third argument that should be
			handled by the converter.</li>
		<li>c.t.x.core.ReferenceByIdMarshaller.IdGenerator.next() has now the current object as argument.</li>
		<li>New c.t.x.persistence.PersistenceStrategy and c.t.x.persistence.FilePersistenceStrategy.</li>
		<li>Deprecated c.t.x.persistence.StreamStrategy and c.t.x.persistence.FileStreamStrategy.</li>
	</ul>

	<h1 id="1.3">1.3</h1>

	<p>Released February 27, 2008.</p>

	<h2>Major changes</h2>

	<ul>
		<li>ReflectionConverter writes now the fields of the parent classes first.</li>
		<li>Support for Converter definition at field level.</li>
		<li>Refactoring of Annotation support, invent auto-detection mode.</li>
		<li>Annotated converters are no longer detected automatically, all annotations are now handled in the same way.</li>
		<li><a href="/jira/334">XSTR-334</a>: XStream will deserialize directly from a file or URL. Some parser take advantage of these
			objects to define a SystemId used to resolve further references in XML, schema or DTD. Appropriate createReader
			methods have been added to c.t.x.io.HierarchicalStreamDriver.</li>
		<li><a href="/jira/261">XSTR-261</a>: All c.t.x.io.HierarchicalStreamDriver implementations respect now the encoding of an XML
			header if read from an InputStream.</li>
		<li>DomDriver does no longer use explicitly UTF-8 by default, DomReader will therefore respect the encoding
			defined in the XML header or use native encoding</li>
		<li><a href="/jira/415">XSTR-415</a>: JavaBeanConverter uses now BeanIntrospection (by Hinse ter Schuur).</li>
		<li><a href="/jira/424">XSTR-424</a>: DateConverter uses now by default SimpleDateFormat instances in non-lenient mode.</li>
		<li><a href="/jira/386">XSTR-386</a>: SingleValueConverter that utilizes PropertyEditor implementations (by Jukka Lindstr&ouml;m).</li>
		<li><a href="/jira/427">XSTR-427</a>: Converter for javax.xml.datatype.Duration (by John Kristian).</li>
		<li><a href="/jira/305">XSTR-305</a>: Field alias inheritance (by David Blevins).</li>
		<li>XStream failed to initialize in environments without AWT or SQL classes.</li>
		<li><a href="/jira/420">XSTR-420</a>: XPath of references are not XmlFriendly encoded.</li>
		<li><a href="/jira/473">XSTR-473</a>: String &quot;\0&quot; serialized as invalid XML, support compliant behaviour according XML
			version.</li>
		<li><a href="/jira/431">XSTR-431</a>: Direct support of enhanced mode for SAP JVM (thanks to Norbert Kuck by SAP).</li>
		<li><a href="/jira/437">XSTR-437</a>: Static cache in annotation processing causes failing OSGi bundles.</li>
		<li><a href="/jira/279">XSTR-279</a>+<a href="/jira/335">XSTR-335</a>: Annotations are not inherited from parent class.</li>
		<li>Fix StringConverter using a WeakHashMap with strong references in its value.</li>
		<li><a href="/jira/403">XSTR-403</a>: Attributes are no longer written with JSONHierarchicalStreamDriver if current object is a
			collection.</li>
		<li><a href="/jira/456">XSTR-456</a>: New LookAndFeelConverter handling LookAndFeel implementations with reflection.</li>
		<li><a href="/jira/462">XSTR-462</a>: CachingMapper keeps direct class references.</li>
		<li><a href="/jira/411">XSTR-411</a>: JsonHierarchicalStreamDriver does not escape characters according RFC 4627.</li>
		<li>JsonHierarchicalStreamDriver writes wrong brackets around complex Java types with a single value.</li>
		<li>JsonHierarchicalStreamDriver writes attribute names with a leading '@'.</li>
		<li>JsonHierarchicalStreamDriver supports Map implementations.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Added converter for java.lang.StringBuilder instances.</li>
		<li>Added converter for java.util.UUID instances.</li>
		<li><a href="/jira/430">XSTR-430</a>: Fields written as attributes could not be omitted.</li>
		<li><a href="/jira/407">XSTR-407</a>: Comparator might access uninitialized elements for TreeSet and TreeMap. A deserialized
			Comparator is no longer called, the converters expect the elements now in a sorted order.</li>
		<li><a href="/jira/404">XSTR-404</a>, @XStreamImplicit() for ArrayList&lt;ArrayList&lt;Type&gt;&gt; throws ClassCastException.</li>
		<li>@XStreamContainedType() for ArrayList&lt;ArrayList&lt;Type&gt;&gt; throws ClassCastException.</li>
		<li>XStreamer did not persist a FieldKeySorter instance.</li>
		<li><a href="/jira/241">XSTR-241</a>: JavaBeanConverter now supports customized BeanProvider.</li>
		<li><a href="/jira/280">XSTR-280</a>: JavaBeanConverter now supports aliasField and omitField (by Hinse ter Schuur).</li>
		<li><a href="/jira/280">XSTR-280</a>: SerializationConverter now supports aliasField and omitField.</li>
		<li><a href="/jira/429">XSTR-429</a>: XmlFriendlyReplacer support for SaxWriter and TraxSource (by Adrian Wilkens).</li>
		<li><a href="/jira/421">XSTR-421</a>: Characters cannot be written as attribute.</li>
		<li><a href="/jira/426">XSTR-426</a>: java.swt.KeyStroke not properly serialized because of a character undefined in unicode.</li>
		<li><a href="/jira/352">XSTR-352</a>: Strings with arbitrary ISO control characters are not properly serialized.</li>
		<li><a href="/jira/428">XSTR-428</a>: An attribute named like a transient field did abort deserialization of following fields.</li>
		<li><a href="/jira/443">XSTR-443</a>: XStream.createObjectOutputStream does not use the given driver to create the
			HierarchicalStreamWriter.</li>
		<li><a href="/jira/440">XSTR-440</a>: Implicit collections can be declared for fields that are not of Collection type.</li>
		<li><a href="/jira/446">XSTR-446</a>: Handle all primitives and their boxed counterpart for JsonHierarchicalStreamDriver.</li>
		<li><a href="/jira/447">XSTR-447</a>: Fix deserialization of Array class types in JDK 6 (see JDK bug 6500212).</li>
		<li><a href="/jira/450">XSTR-450</a>: @XStreamAlias is ignored if attributes should be used for the field type.</li>
		<li><a href="/jira/418">XSTR-418</a>: Inherited @XStreamAlias is ignored if field should be rendered as attribute.</li>
		<li><a href="/jira/393">XSTR-393</a>: Annotation processing is not consistent.</li>
		<li><a href="/jira/412">XSTR-412</a>: @XStreamImplicit throws NPE for untyped collections.</li>
		<li><a href="/jira/463">XSTR-463</a>: Cannot provide own default Mapper chain.</li>
		<li><a href="/jira/464">XSTR-464</a>: Cannot provide a ClassLoader that is used in all cases.</li>
		<li><a href="/jira/394">XSTR-394</a>: Allow enums as attributes.</li>
		<li><a href="/jira/413">XSTR-413</a>: Support @XStreamAsAttribute for enums.</li>
		<li><a href="/jira/478">XSTR-478</a>: Cannot specify default implementation for polymorphic enum.</li>
		<li><a href="/jira/419">XSTR-419</a>: Treat enums as immutable types.</li>
		<li>Update annotation tutorial, explain limitations of auto-detection mode.</li>
		<li>Added copyright notices to all files.</li>
		<li>StaxWriter.flush did close Stax' XMLStreamWriter instead of flushing it.</li>
		<li><a href="/jira/471">XSTR-471</a>: XStream POMs do no longer declare a repository at all.</li>
		<li>Calendar object could not be rendered with JSONHierarchicalStreamDriver.</li>
		<li><a href="/jira/476">XSTR-476</a>: Properties can be sorted by key.</li>
		<li>XStream.createObjectInputStream and XStream.createObjectOutputStream overloaded to support a binary
			InputStream or OutputStream.</li>
		<li><a href="/jira/470">XSTR-470</a>: Allow transient fields to be optionally deserialized.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>c.t.x.annotation.Annotations, c.t.x.annotation.AnnotationReflectionConverter and
			c.t.x.annotation.AnnotationProvider deprecated. Functionality is integrated in new c.t.x.mapper.AnnotationMapper and
			accessible with new methods c.t.x.XStream.processAnnotations().</li>
		<li>New auto-detection mode for annotations, that can be turned on with c.t.x.XStream.autodetectAnnotations()</li>
		<li>c.t.x.annotation.@XStreamContainedType deprecated, the behaviour is now always active and the annotation
			therefore superfluous.</li>
		<li>Due to <a href="/jira/421">XSTR-421</a> null characters are no longer written as tag with an attribute (&lt;char
			null=&quot;true&quot;/&gt;), but as empty tag. The old representation is still supported at deserialization.</li>
		<li>Characters that are not defined in unicode or ISO control characters (expect TAB and LF) are written as
			numerical entity now.</li>
		<li>XPath references are now also XML-friendly encoded to match the path exactly. Unencoded references will
			normally work anyway, but in special cases the exact behaviour of XStream 1.2.x might be necessary. See acceptance
			tests for XStream 1.2.x compatibility.</li>
		<li>c.t.x.core.BaseException deprecated in favour of c.t.x.XStreamException as base exception for all exceptions
			XStream throws.</li>
		<li>c.t.x.XStream.InitializerException deprecated in favour of c.t.x.InitializerException.</li>
		<li>New methods get() and keys() in interface c.t.x.converter.ErrorWriter.</li>
		<li>c.t.x.mapper.XmlFriendlyMapper deprecated, technology is replaced since version 1.2 by
			c.t.x.io.xml.XmlFriendlyReplacer as part of the different XmlWriter implementations.</li>
		<li>c.t.x.mapper.Mapper.aliasForAttribute() and c.t.x.mapper.Mapper.attributeForAlias() deprecated, since it
			provided in reality the combined functionality of c.t.x.mapper.Mapper.serializedMember()/realMember() and
			c.t.x.mapper.Mapper.getConverterFromItemType().</li>
		<li>c.t.x.XStream(ReflectionProvider, Mapper, HierarchicalStreamDriver) deprecated, in favour of
			c.t.x.XStream(ReflectionProvider, HierarchicalStreamDriver, Mapper, ClassLoader).</li>
		<li>New interface c.t.x.converter.ConverterRegistry to express explicit functionality managing the converters.</li>
		<li>c.t.x.core.DefaultConverterLookup no longer uses a c.t.x.mapper.Mapper. Therefore the old constructor has
			been deprecated in favour of a default constructor.</li>
		<li>Overloaded methods of c.t.x.mapper.Mapper.getConverterFromItemType and
			c.t.x.mapper.Mapper.getConverterFromAttribute have been deprecated. Only one version has been kept, the
			implementation can handle all cases now at once and therefore multiple calls to the mapper chain are avoided.</li>
		<li>c.t.x.mapper.EnumMapper derives now from the c.t.x.mapper.AttributeMapper to support enums as attributes.
			Therefore the old constructor has been deprecated in favour of one taking an additional
			c.t.x.converters.ConverterLookup that has to be passed to the new parent.</li>
	</ul>

	<p class="highlight">Note, to support a representation of null values in some way, it is absolutely necessary that
		each converter can handle a null value in its marshalling methods. If you have implemented your own custom converters,
		try to handle such a case also to prevent incompatibilities in case XStream will provide such values with its next
		major version.</p>

	<h1 id="1.2.2">Version 1.2.2</h1>

	<p>Released May 24, 2007.</p>

	<p class="hightlight">Note, that next version of XStream will behave slightly different by default. XStream emits
		all fields in declaration order like Java serialization. But in contrast to Java it will omit the fields of parent
		classes last while Java serialization emits them first. This makes it difficult to match a given XML schema that
		defined inherited types or leads sometimes to obscure initialization problems. However, XStream itself will not be
		affected by the changed order of elements in the XML, any deserialization of current XML representations will work
		fine. Anyway we will provide with XStream 1.3 a FieldKeySorter implementation that mimics the old behaviour. In the
		meanwhile you can enforce the new field sorting by installing the NaturalFieldKeySorter.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/391">XSTR-391</a>, Support for writing (and reading) JSON by the new JettisonMappedXmlDriver (by Dejan Bosanac).</li>
		<li>New FieldKeySorter interface allows a custom sort order of the XML elements.</li>
		<li><a href="/jira/68">XSTR-68</a> and <a href="/jira/210">XSTR-210</a>, OmitField is now respected at deserialization to ignore removed fields.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/387">XSTR-387</a>, Fix aliasing of inherited fields.</li>
		<li><a href="/jira/395">XSTR-395</a>, Fix StringConverter allocating PermGen space.</li>
		<li><a href="/jira/368">XSTR-368</a>, @XStreamConverter converters should be cached inside the AnnotationReflectionConverter.</li>
		<li><a href="/jira/392">XSTR-392</a>, @XStreamOmitField can be used to omit fields from the resulting XML (contributed by Chung-Onn
			Cheong).</li>
		<li><a href="/jira/371">XSTR-371</a>, Fix JSONWriter that omits a closing bracket for for fields with null value.</li>
		<li><a href="/jira/398">XSTR-398</a>, DomDriver ignores given XmlFriendlyReplacer.</li>
		<li><a href="/jira/370">XSTR-370</a>, Buildable with JDK 6, fix FontConverter for JDK 6.</li>
		<li><a href="/jira/382">XSTR-382</a>, Support hex and octal number values.</li>
		<li>DateConverter did not respect change in TimeZone after first usage.</li>
		<li><a href="/jira/375">XSTR-375</a>, Support for aliasing native types.</li>
		<li><a href="/jira/243">XSTR-243</a> again, XML elements for transient fields are now ignored completely at deserialization.</li>
		<li>Release unused object references to keep memory print low.</li>
		<li>Support for AWT and SQL is now optional: XStream now works on embedded virtual machines lacking such APIs (by
			Nicolas Gros d'Aillon).</li>
		<li>Support raw bytes read from the ObjectInputStream.</li>
		<li><a href="/jira/373">XSTR-373</a>, Support for Hitachi JVM (tested by Yuji Yamano).</li>
		<li><a href="/jira/378">XSTR-378</a> and <a href="/jira/379">XSTR-379</a>, Fix TextAttributeConverter and EnumSetConverter failing on Apache Harmony.</li>
		<li><a href="/jira/363">XSTR-363</a>, Support of native field order i.e. fields are processed in declaration order base classes
			first.</li>
		<li><a href="/jira/320">XSTR-320</a>, Static field in child may hide non-static field in parent.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li><a href="/jira/365">XSTR-365</a>, Multiple implicit collections with annotations. Deprecated @XStreamImclicitCollection in
			favour of @XStreamImplicit declared at field level.</li>
	</ul>

	<h1 id="1.2.1">Version 1.2.1</h1>

	<p>Released November 11, 2006.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Introduced DocumentWriter interface and generalized functionality for all writer implementations creating a
			DOM structure (DOM4J, DOM, JDom, Xom, Xpp3Dom).</li>
		<li>Refactored build system to use Maven 2. Ant still supported on XStream Core.</li>
		<li>Created separate XStream Benchmark module</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/346">XSTR-346</a>, XStream.getClassMapper() does not return a ClassMapper for the current Mapper.</li>
		<li>Fix problem with fields containing a double underscore.</li>
		<li><a href="/jira/345">XSTR-345</a>, Dom4JWriter adds up attributes.</li>
		<li><a href="/jira/336">XSTR-336</a>, XStream fails to reference an implicit element.</li>
		<li><a href="/jira/337">XSTR-337</a>, Annotation cycle bug.</li>
		<li>Fix packaging error for the resulting jar building with Maven2.</li>
		<li><a href="/jira/339">XSTR-339</a>, NPE for attribute null values.</li>
		<li><a href="/jira/338">XSTR-338</a>, NPE in JSON writer for converters using non-extended HierarchicalStreamWriter.</li>
		<li><a href="/jira/357">XSTR-357</a>, Fix escaping of values in JSON writer.</li>
		<li><a href="/jira/356">XSTR-356</a>, Fix unmarshaling error for fields containing proxies.</li>
		<li><a href="/jira/349">XSTR-349</a>, Fix backward compatibility of Dom4jWriter.</li>
		<li><a href="/jira/309">XSTR-309</a>, More versatile boolean conversion options (contributed by David Blevins).</li>
		<li>Add XStream.getReflectionProvider() to retrieve ReflectionProvider in use.</li>
		<li><a href="/jira/358">XSTR-358</a>, @XStreamConverter annotation does not call converter constructor.</li>
		<li>Website generated using <a href="http://xsite.codehaus.org">XSite</a></li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Deprecate JDomWriter.getResult() in favour of DocumentWriter.getTopLevelNodes().</li>
		<li>Deprecate ThreadSafeSimpleDateFormat, since this is an internal helper and not part of XStream API.</li>
	</ul>

	<h1 id="1.2">Version 1.2</h1>

	<p>Released August 18, 2006.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/269">XSTR-269</a>, Using attributes for fields (contributed by Paul Hammant and Ian Cartwright).</li>
		<li>Aliasing of arbitrary attributes.</li>
		<li><a href="/jira/50">XSTR-50</a>, XStream can now serialize another XStream instance.</li>
		<li><a href="/jira/227">XSTR-227</a>, XStream has now the XStreamer, that serializes an object together with its XStream instance.</li>
		<li><a href="/jira/278">XSTR-278</a>, AnnotationConverter for fields (contributed by Guilherme Silveira).</li>
		<li><a href="/jira/256">XSTR-256</a>, PureJavaReflectionProvider supports now final fields starting with JDK 1.5</li>
		<li><a href="/jira/258">XSTR-258</a>, Any Collection type can now be declared implicit, the default implementation will be respected
			for unmarshaling.</li>
		<li><a href="/jira/88">XSTR-88</a>, XStream can now write all references as absolute XPath expression.</li>
		<li><a href="/jira/62">XSTR-62</a> and <a href="/jira/211">XSTR-211</a>, New SingeValueConverter allows light weight converters if the value can be
			represented by a unique string.</li>
		<li>Aliasing of classes of a specific type.</li>
		<li><a href="/jira/239">XSTR-239</a>, Support for certain types of proxies generated with the CGLIB Enhancer.</li>
		<li><a href="/jira/90">XSTR-90</a> and <a href="/jira/311">XSTR-311</a>, Support for BEA JRockit starting with R25.1.0 (contributed by Henrik
			St&aring;hl of BEA).</li>
	</ul>

	<h2>Technology preview</h2>

	<ul>
		<li>Experimental binary reader and writer.</li>
		<li>Experimental HierarichicalStreamCopier allows streams to be copied from one format to another without the
			overhead of serialization.</li>
		<li>Experimental JSON support allows streams to be copied from one format to another without the overhead of
			serialization (contributed by Paul Hammant).</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/266">XSTR-266</a>, XStream fails to serialize elements of a unserializable class, that is a base class of a
			derived class</li>
		<li><a href="/jira/236">XSTR-236</a>, Priority constants for converter registration are now public</li>
		<li><a href="/jira/215">XSTR-215</a>, XStream writes now fields in declaration order even for JVMs reporting them in reverse order
			like IBM JDK.</li>
		<li><a href="/jira/276">XSTR-276</a> and <a href="/jira/283">XSTR-283</a>, XStream does no longer attempt to create references to implicit element.</li>
		<li><a href="/jira/244">XSTR-244</a>, Closing a Writer can now be done twice, but any write attempt will later on fail.</li>
		<li><a href="/jira/243">XSTR-243</a>, Transient fields were unmarshalled from XML.</li>
		<li><a href="/jira/250">XSTR-250</a>, Providing a mapper to the XStream constructor will no longer result in a NPE.</li>
		<li><a href="/jira/281">XSTR-281</a>, After registering a new converter, the internal converter cache is now cleared.</li>
		<li><a href="/jira/284">XSTR-284</a>, XStream checks the object returned by a converter for compatibility.</li>
		<li>XStream no longer fails serializing a Throwable without cause when no references shall be written.</li>
		<li>Converter for java.awt.font.TextAttribute.</li>
		<li>Converter for java.nio.charset.Charset.</li>
		<li><a href="/jira/286">XSTR-286</a>, XStream detects impossible self serialization and throws now an appropriate
			ConversionException.</li>
		<li><a href="/jira/291">XSTR-291</a>, XomDriver implementation added.</li>
		<li><a href="/jira/299">XSTR-299</a>, Fix for implicit collections with items using the same name as the field name of the
			underlying collection.</li>
		<li><a href="/jira/245">XSTR-245</a>, Broken XML with custom serialization in certain cases (patch contributed by Cyrille Le Clerc).</li>
		<li><a href="/jira/304">XSTR-304</a>, Bad handling of repairing namespace flag for StaxDriver (patch contributed by John Kristian).</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li><a href="/jira/252">XSTR-252</a>, Refactored support for XML friendly character mapping.</li>
		<li><a href="/jira/69">XSTR-69</a>, Refactored ReflectionConverter allows simpler subclassing.</li>
		<li>Unmarshalling context has now an overloaded version of the method convertAnother to provide the Converter
			directly.</li>
		<li>Deprecate ClassMapper for Mapper. All methods with a ClassMapper parameter have now a duplicate taking only a
			Mapper. The variant with the ClassMapper is deprecated.</li>
		<li>Deprecate c.t.x.alias.CannotResolveClassException for c.t.x.mapper.CannotResolveClassException.</li>
		<li>Deprecate NameMapper (was not used within XStream anymore anyway).</li>
		<li>Deprecate constructor of DefaultMapper taking an alternative name for the class attribute. Use the
			aliasAttribute method.</li>
		<li>Deprecate attributeForImplementationClass, attributeForClassDefiningField, attributeForReadResolveField, and
			attributeForEnumType in favour of the generalized aliasForAttribute in the Mapper interface.</li>
		<li>Removed all deprecated stuff from 1.1.x and 1.0.x</li>
		<li><a href="/jira/211">XSTR-211</a>, A lot of existing (basic) Converters have been refactored to use the new SingleValueConverter
			interface.</li>
		<li>Dom4JWriter uses now a DocumentFactory and a XMLWriter as constructor arguments.</li>
	</ul>

	<h1 id="1.1.3">Version 1.1.3</h1>

	<p>Released January 13, 2006.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Added XStream.toXML(OutputStream) and XStream.fromXML(InputStream).</li>
		<li>Ability to prevent fields from being serialized by calling XStream.omitField() or by implementing
			Mapper.shouldSerializeMember().</li>
		<li>Added Converter for Enum, EnumMap and EnumSet</li>
		<li><a href="/jira/186">XSTR-186</a>, Added BeanConverter (contributed by Andrea Aime)</li>
		<li><a href="/jira/246">XSTR-246</a>, Added ISO8601SqlTimestampConverter (contributed by Cheong, Chung-Onn)</li>
		<li>Added ISO8601GregorianCaledarConverter</li>
		<li><a href="/jira/215">XSTR-215</a>, Fixed support for IBM JVM (contributed by Gabor Liptak)</li>
		<li>Enhanced mode support for Blackdown JDK</li>
		<li><a href="/jira/265">XSTR-265</a>, support for javax.security.auth.Subject</li>
		<li><a href="/jira/233">XSTR-233</a>, support for Integer[] arrays</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Remove unnecessary PrintWriter wrapper in default writers (pointed out by Mathieu Champlon)</li>
		<li>Bugfix: EnumSet converter can now deal with empty sets (contributed by Baba Buehler)</li>
		<li>Update ISO8601DateConverter to use Joda 1.0</li>
		<li><a href="/jira/242">XSTR-242</a>, GregorianCalenderConverter saves now the timezone</li>
		<li><a href="/jira/247">XSTR-247</a>, ISO8601DateConverter now independent on timezone</li>
		<li><a href="/jira/263">XSTR-263</a>, Circular references with Externalizable objects fail</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>None.</li>
	</ul>

	<h1 id="1.1.2">Version 1.1.2</h1>

	<p>Released April 30, 2005. Most popular feature requests implemented. Java 5 Enum support. Serialization of
		JavaBeans using accessors. Aliasing of fields. StAX integration, with namespaces. Improved support on JDK 1.3 and IBM
		JDK.</p>

	<h2>Major changes</h2>

	<ul>
		<li><a href="/jira/186">XSTR-186</a>, Option to serialize JavaBeans using public accessors, rather than private fields (contributed
			by Andrea Aime).</li>
		<li>Ability to alias fields as well as classes, using XStream.addFieldAlias().</li>
		<li><a href="/jira/70">XSTR-70</a>, <a href="/jira/204">XSTR-204</a> Support for JDK 5 enums (contributed by Eric Snell and Bryan Coleman).</li>
		<li><a href="/jira/206">XSTR-206</a> Clean representation of JDK 5 EnumMap and EnumSet.</li>
		<li>XStream can now be built using JDK 1.3 (previously it required JDK 1.4 to compile, but 1.3 to run).</li>
		<li><a href="/jira/215">XSTR-215</a>, Enhanced mode is now supported on the IBM 1.4 JDK.</li>
		<li>The default HierarchicalStreamWriter implementation is supplied by the HierarichicalStreamDriver (as well as
			the reader).</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li><a href="/jira/104">XSTR-104</a> HierarchicalStreamReader now exposes all available attributes to the Converter implementations
			(contributed by Trygve Laugstol).</li>
		<li>Bugfix: Externalizable deserialization supported for objects not at the root of tree.</li>
		<li>JavaMethodConverter handles non public methods/constructors (contributed by Kevin Ring).</li>
		<li>PropertiesConverter also serializes default properties, if present (contributed by Kevin Ring).</li>
		<li>Bugfix: In some cases, XppReader and StaxReader would get confused when calling hasMoreChildren() and
			getValue() on the same node.</li>
		<li><a href="/jira/217">XSTR-217</a>, ISO8601DateConverter now requires joda-time-1.2.1</li>
		<li>PrettyPrintWriter and CompactWriter may have their text/attribute escaping rules customized by overriding
			writeText() and writeAttributeValue().</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>HierarchicalStreamDriver implementations now require a createWriter() method. The simplest implementation is
			to return a new PrettyPrintWriter.</li>
		<li>Introduced ReaderWrapper/WriterWrapper classes to make it easier to wrap (decorate)
			HierarchicalStreamReader/Writer instances.</li>
	</ul>

	<h1 id="1.1.1">Version 1.1.1</h1>

	<p>Released March 7, 2005. Mostly bugfixes and minor feature enhancements.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Converters can be registered with a priority, allowing more <i>generic</i> filters to handle classes that
			don't have more specific converters.
		</li>
		<li>Converters can now access underlying HierarchicalStreamReader/Writer implementations to make implementation
			specific calls.</li>
		<li>Improved support for classes using ObjectInputFields to follow the serialization specification.</li>
		<li><a href="/jira/179">XSTR-179</a> Support for ObjectInputStream.registerValidation(ObjectInputValidation).</li>
		<li><a href="/jira/178">XSTR-178</a> Serialized inner class now maintains reference to outer class.</li>
		<li><a href="/jira/199">XSTR-199</a> Default ClassLoader may be changed using XStream.setClassLoader().</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Bugfix: Thread context classloader is loaded by the correct thread. (Thanks to Padraic Renaghan for pointing
			this out).</li>
		<li>Bugfix: Default implementations of aliased classes were not being deserialized by SerializableConverter.</li>
		<li>Bugfix: <a href="/jira/180">XSTR-180</a> Serializable objects support defaultReadObject() even when no default fields available.</li>
		<li>Bugfix: For serialized objects class hierarchy is serialized starting with superclass (as per Java Object
			Serialization).</li>
		<li>Bugfix: readObject() is now called for classes containing only transient fields.</li>
		<li>Bugfix: Order of fields are maintained when calling ObjectOutputStream.putFields().</li>
		<li>Bugfix: FontConverter extended to support FontUIResource which does some awkward native calls.</li>
		<li>Bugfix: Deserialization of very complicated graphs (such as Swing components) sometimes resulted in broken
			object references. Now fixed.</li>
		<li>Bugfix: <a href="/jira/188">XSTR-188</a> Classes that use readResolve()/writeReplace() can now return different types.</li>
		<li>Bugfix: <a href="/jira/185">XSTR-185</a>, <a href="/jira/195">XSTR-195</a> Support for loading of array classes for classes that have not yet been
			loaded. (Thanks to Henri Tremblay and Simon Daniel)</li>
		<li>Bugfix: <a href="/jira/190">XSTR-190</a> PrettyPrintWriter and CompactWriter escape characters in XML attributes.</li>
		<li>Bugfix: <a href="/jira/176">XSTR-176</a>, <a href="/jira/196">XSTR-196</a> The XStream ObjectInputStream and ObjectOutputStream implementations now
			propegate the flush() and close() events to the underlying streams.</li>
		<li>Bugfix: <a href="/jira/192">XSTR-192</a> Implicit collection mappings are now supported in inheritance hierarchies.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>ClassMapper is now deprecated. Replaced with MapperWrapper.</li>
		<li>HierarchicalStreamWriter implementations must now implement close(), flush() and underlyingWriter().</li>
		<li>HierarchicalStreamReader implementations must now implement close() and underlyingReader().</li>
	</ul>

	<h1 id="1.1">Version 1.1</h1>

	<p>
		Released January 15, 2005. Focus on support for objects defining custom serialization using the standard <a
			href="http://java.sun.com/j2se/1.4.2/docs/guide/serialization/spec/serialTOC.html">Java serialization</a> mechanism.
	</p>

	<h2>Major changes</h2>

	<ul>
		<li>Provides drop in replacement for ObjectInputStream and ObjectOutputStream, using
			XStream.createObjectInputStream() and XStream.createObjectOutputStream() and XStream.createObjectInputStream(). This
			provides support for streaming objects.</li>
		<li>Support for objects that specify their own serialization schemes by implementing readObject() and
			writeObject() (as in Java serialization spec). This includes support for ObjectInputStream.getFields() and
			ObjectOuputStream.putFields().</li>
		<li>Support for objects to serialize other objects to the stream by implementing writeReplace() (as in Java
			serialization spec).</li>
		<li>Support for any object that performs custom serialization by implementing java.io.Externalizable (as in Java
			serialization spec).</li>
		<li>Implicit collections can be specified for classes, allowing the element wrapping the collection to be
			skipped.</li>
		<li>New writer implementations to allow XStream to serialize directly to a SAX stream or TrAX pipeline.</li>
		<li>The MarshallingContext and UnmarshallingContext interfaces now extend DataHolder, allowing arbitrary data to
			be stored by the user whilst walking the object graph and passed around to Converters. DataHolders can also be passed
			into XStream from the outside.</li>
		<li>Includes new DomWriter implementation to serialize directly to a W3C DOM tree (to complement the existing
			DomReader).</li>
		<li>Better support for instantiating objects on non Sun 1.4+ JVMs, including non-public constructors, private
			static inner classes and ANY class that implements java.io.Serializable.</li>
		<li>DOM, DOM4J, JDOM, XOM, Electric-XML, SAX, STAX</li>
		<li>Specific ClassLoaders can be passed into XStream, to allow for greater compatibility in J2EE containers.</li>
		<li>Ability to change the default converter</li>
		<li>Added optional ISO8601DateConverter for full ISO8601 date format support. The converter is not registered by
			default as it requires the joda-time dependency (http://joda-time.sf.net). To use, ensure joda-time is in classpath
			and register explicitly.</li>
		<li>Enhanced mode is now supported on the Apple 1.4 JDK.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>PrettyPrintWriter only flushes stream when necessary - large performance improvement for serialization.</li>
		<li>Added XStream.fromXml(xml, root) convenience methods for deserializing into an existing root object.</li>
		<li>JDK 1.3 compatibility: Added mechanism for accessing nested exception.</li>
		<li>JDK 1.3 compatibility: GregorianCalendarConverter only calls Calendar.getTimeInMillis() the JDK supports it.</li>
		<li>Bugfix: All caches are now synchronized - there were some thread safety issues.</li>
		<li>Bugfix: Only <i>immutable</i> basic types will have references ignored in XML (for clarity).
		</li>
		<li>Bugfix: Class names can contain underscores.</li>
		<li>Bugfix: Support for '\0' char.</li>
		<li>Bugfix: PropertyConverter no longer attempts to serialize subclasses of Properties.</li>
		<li>Bugfix: JVM detection uses system properties, which is more accurate than searching the classpath.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>XStream.addDefaultCollection() has been deprecated. Use XStream.addImplicitCollection() instead.</li>
	</ul>

	<h1 id="1.0.2">Version 1.0.2</h1>

	<p>Released August 7, 2004. Focus on improving the converters bundled with XStream to support a wider range of
		types.</p>

	<h2>Major changes</h2>

	<ul>
		<li>XML elements are written in order they are defined in class, rather than alphabetical.</li>
		<li>Converters for java.io.File, java.sql.Timestamp, java.awt.Color, and dynamic proxies are now registered by
			default.</li>
		<li>EncodedByteArrayConverter is now registered by default and uses a single Base64 string to store the contents
			of a byte[]. This now works on all JVMs as it no longer relies on Sun specific classes. This converter will also
			unmarshal byte[] that have been serialized without it, for backwards compatability.</li>
		<li>New converters for java.sql.Time, java.sql.Date, java.util.Locale, java.util.Currency, java.util.Calendar and
			java.awt.Font.</li>
		<li>All caching is done in XStream instance instead of statics, allowing applications that use hot redeployment
			of classes to use XStream in a parent classloader.</li>
		<li>XStream will fail fast if a field value is defined more than once in XML when deserializing.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>The &lt;entry&gt; element used in Maps can now be specified by creating an alias for java.util.Map.Entry.</li>
		<li>Bugfix: Fields with characters that generate invalid XML (such as $ signs) are now escaped.</li>
		<li>Bugfix: Pre-instantiated objects can be unmarshalled through multiple levels.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>None.</li>
	</ul>

	<h1 id="1.0.1">Version 1.0.1</h1>

	<p>Released May 30, 2004. Misc features and bugfixes.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Support for multidimensional arrays.</li>
		<li>Object with readResolve() method will be treated the same way native serialization treats them.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>New converters for Throwable and StackTraceElement that retain stack trace (JDK 1.4 only)</li>
		<li>Bugfix: System.identityHashCode() is not guaranteed to be unique. Ensure reference checking is used as well.</li>
		<li>Bugfix: Allows user classes to be defined in WEB-INF/classes in Servlet environments. Tries to use context
			classloader if available.</li>
		<li>Support for java.util.Currency (through readResolve()).</li>
		<li>Instances of Jakarta Commons Lang Enum are now reused (through readResolve()).</li>
		<li>Bugfix: JavaClassConverter handles primitive type classes (contributed by Matthew Sandoz).</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Additional method: ConverterLookup.defaultConverter(). Custom implementations of this class should implement
			this new method.</li>
	</ul>

	<h1 id="1.0">Version 1.0</h1>

	<p>Released May 14, 2004. Focusses on finalizing the API for 1.0 release.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Supports fields of same name, hidden by inheritance.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>JavaDoc for most important parts of API.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>The ReflectionConverter and ReflectionProviders have had an overhaul to support hidden fields. Most methods
			now take an extra argument to specify which class a field is declared in.</li>
	</ul>

	<h1 id="1.0RC1">Version 1.0 (release candidate 1)</h1>

	<p>Released May 9, 2004. Focusses on finalizing the API for 1.0 release.</p>

	<h2>Major changes</h2>

	<ul>
		<li>JDK 1.3 compatibility.</li>
		<li>Informative error messages.</li>
		<li>Defaults to using faster XPP based parser.</li>
		<li>Serializes final field under JDK 1.4.</li>
		<li>Fail fast when trying to serialize final field if not Sun 1.4 JRE.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Misc performance improvements.</li>
		<li>Converters for TreeMap and TreeSet that store the Comparator.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Default constructor for XStream class uses XppDriver instead of DomDriver. To use DomDriver, explicitly pass
			it in to the constructor.</li>
		<li>Exception is thrown if trying to serialize an object that contains a final field if not Sun 1.4 JRE.</li>
	</ul>

	<p>
		<a href="versioning.html">About XStream version numbers...</a>
	</p>

	<h1 id="0.6">Version 0.6</h1>

	<p>Released May 7, 2004. Focusses on providing full object graph support.</p>

	<h2>Major changes</h2>

	<ul>
		<li>None.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Bugfix: Objects that had no children could not be derefenced properly (thanks to Brian Slesinsky and Nick
			Pomfret).</li>
		<li>Bugfix: DateConverter is now thread safe.</li>
		<li>Optimization: String instances are reused as much as possible.</li>
		<li>Converters for BigInteger and BigDecimal.</li>
		<li>IntConverter now recognises hexadecimal and octal notations (thanks to Konstantin Pribluda).</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>None.</li>
	</ul>

	<h1 id="0.6RC1">Version 0.6 (release candidate 1)</h1>

	<p>Released April 19, 2004. Focusses on providing full object graph support.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Full support for object graphs, including duplicate references of same object and circular references.</li>
		<li>References can be identified using XPath (default), unique-IDs or disabled.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Release includes Ant build file.</li>
		<li>Converters for non standard collections such as Collections.EMPTY_LIST, syncronizedList(), unmodifiableMap(),
			etc.</li>
		<li>Converter for nulls.</li>
		<li>Converter for dynamic proxies.</li>
		<li>Converter for java.net.URL.</li>
		<li>Converters for java.util.LinkedHashMap and java.util.LinkedHashSet.</li>
		<li>Converters for java.lang.reflect.Method and java.lang.reflect.Constructor.</li>
		<li>If duplicate reference support is disabled and a circular reference is encountered, an exception will be
			thrown.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>None.</li>
	</ul>

	<h1 id="0.5">Version 0.5</h1>

	<p>Released March 8, 2004. Focussed on performance.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Massive performance improvements. Up to 3 times faster for serialization and 22 times faster for
			deserialization!</li>
		<li>Non-DOM building pull parser based reader. Results in much smaller memory footprint, particularly when
			deserializing large object models.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Misc performance improvements.</li>
		<li>Misc bugfixes.</li>
		<li>Alternate encodings can be used with DomDriver.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Renamed XMLReader/Writer to HierarchicalStreamReader/Writer as XStream is not actually coupled to serializing
			just to XML.</li>
		<li>Cleaned up the public API.</li>
		<li>Moved internal XStream implementation classes to core package.</li>
		<li>Misc package/class renames to make more sense. Dumped lots of dead code.</li>
	</ul>

	<h1 id="0.4">Version 0.4</h1>

	<p>This version was never publicly released. All changes were made available in 0.5. Focussed on making it easier
		to create custom converters.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Overhaul of interface for Converters. Makes Converters much cleaner to write.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Added custom converters for java.io.File, java.util.Properties, java.util.Vector, java.util.Hashtable,
			java.util.BitSet byte[] (Base64 encoded), char[].</li>
		<li>Misc bugfixes.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>New interface to be implemented by custom converters.</li>
	</ul>

	<h1 id="0.3">Version 0.3</h1>

	<p>Released January 1, 2004.</p>

	<h2>Major changes</h2>

	<ul>
		<li>Added ElementMapper interface and default implementations to allow fine grained control over element name to
			class mapper operations.</li>
		<li>Added an XPP based reader and writer that uses a pull-parser to create a lightweight DOM tree.</li>
	</ul>

	<h2>Minor changes</h2>

	<ul>
		<li>Added XStream.fromXML(XMLReader xmlReader,Object root) method to allow the population of an object graph
			starting with a live object root.</li>
		<li>Added XMLReader.peek() method to allow access to the underlying hierarchical object being unmarshalled.</li>
	</ul>

	<h2>API changes</h2>

	<ul>
		<li>Aligned the the methods in XStream to use the specified ObjectFactory in the constructor instead of creating
			a SunReflectionObjectFactory.</li>
	</ul>

	<h1 id="older">Older versions</h1>

	<p>Changes in XStream prior to version 0.3 were not logged.</p>


                <br/>

            </div>
        </div>

        <div class="SidePanel" id="left">
                    <div class="MenuGroup">
                        <h1>Software</h1>
                        <ul>
                                    <li><a href="index.html">About XStream</a></li>
                                    <li><a href="news.html">News</a></li>
                                    <li class="currentLink">Change History</li>
                                    <li><a href="security.html">Security Aspects</a></li>
                                    <li><a href="versioning.html">About Versioning</a></li>
                        </ul>
                    </div>
                    <div class="MenuGroup">
                        <h1>Evaluating XStream</h1>
                        <ul>
                                    <li><a href="tutorial.html">Two Minute Tutorial</a></li>
                                    <li><a href="license.html">License</a></li>
                                    <li><a href="download.html">Download</a></li>
                                    <li><a href="references.html">References</a></li>
                                    <li><a href="benchmarks.html">Benchmarks</a></li>
                                    <li><a href="https://www.openhub.net/p/xstream">Code Statistics</a></li>
                        </ul>
                    </div>
                    <div class="MenuGroup">
                        <h1>Using XStream</h1>
                        <ul>
                                    <li><a href="architecture.html">Architecture Overview</a></li>
                                    <li><a href="graphs.html">Object references</a></li>
                                    <li><a href="manual-tweaking-output.html">Tweaking the Output</a></li>
                                    <li><a href="converters.html">Converters</a></li>
                                    <li><a href="faq.html">Frequently Asked Questions</a></li>
                                    <li><a href="mailing-lists.html">Mailing Lists</a></li>
                                    <li><a href="issues.html">Reporting Issues</a></li>
                        </ul>
                    </div>
                    <div class="MenuGroup">
                        <h1>Javadoc</h1>
                        <ul>
                                    <li><a href="javadoc/index.html">XStream Core</a></li>
                                    <li><a href="hibernate-javadoc/index.html">Hibernate Extensions</a></li>
                                    <li><a href="jmh-javadoc/index.html">JMH Module</a></li>
                        </ul>
                    </div>
                    <div class="MenuGroup">
                        <h1>Tutorials</h1>
                        <ul>
                                    <li><a href="tutorial.html">Two Minute Tutorial</a></li>
                                    <li><a href="alias-tutorial.html">Alias Tutorial</a></li>
                                    <li><a href="annotations-tutorial.html">Annotations Tutorial</a></li>
                                    <li><a href="converter-tutorial.html">Converter Tutorial</a></li>
                                    <li><a href="objectstream.html">Object Streams Tutorial</a></li>
                                    <li><a href="persistence-tutorial.html">Persistence API Tutorial</a></li>
                                    <li><a href="json-tutorial.html">JSON Tutorial</a></li>
                                    <li><a href="http://www.studytrails.com/java/xml/xstream/xstream-introduction.jsp">StudyTrails</a></li>
                        </ul>
                    </div>
                    <div class="MenuGroup">
                        <h1>Developing XStream</h1>
                        <ul>
                                    <li><a href="how-to-contribute.html">How to Contribute</a></li>
                                    <li><a href="team.html">Development Team</a></li>
                                    <li><a href="repository.html">Source Repository</a></li>
                                    <li><a href="https://travis-ci.org/x-stream/xstream/branches">Continuous Integration</a></li>
                        </ul>
                    </div>
        </div>

  </body>
</html>