jenkins-xstream-1.4.4-jenkins-4/ 0000775 0001750 0001750 00000000000 12260544303 017115 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/ 0000775 0001750 0001750 00000000000 12206661545 023325 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/pom.xml 0000664 0001750 0001750 00000020745 12206661545 024652 0 ustar jamespage jamespage 4.0.0com.thoughtworks.xstreamxstream-parent1.4.4xstream-distributionpomXStream Distribution${project.groupId}xstream${project.version}runtime${project.groupId}xstream-hibernate${project.version}runtime${project.groupId}xstream-benchmark${project.version}runtimejdk15-ge[1.5,)org.codehaus.xsitexsite-maven-plugin${basedir}/srccontent/website.xmltemplates/skin.htmlxsite/xsite.xmlresources${project.build.directory}/xsitepackagerunorg.apache.maven.pluginsmaven-antrun-pluginpackagerun${project.groupId}xstream${project.version}javadocprovided${project.groupId}xstream-hibernate${project.version}javadocprovided${project.groupId}xstream-benchmark${project.version}javadocprovidedorg.apache.maven.pluginsmaven-dependency-plugincollect-xstream-artifactspackagecopy-dependenciestarget/libsruntimetrueunpack-corepackageunpack-dependencies${project.build.directory}/xsite/javadocfalsetruexstreamjavadocprovidedunpack-hibernatepackageunpack-dependencies${project.build.directory}/xsite/hibernate-javadocfalsetruexstream-hibernatejavadocprovidedunpack-benchmarkpackageunpack-dependencies${project.build.directory}/xsite/benchmark-javadocfalsetruexstream-benchmarkjavadocprovidedorg.apache.maven.pluginsmaven-assembly-pluginbinpackageattached${basedir}/src/assembly/assembly-bin.xmlxstream-${project.version}${project.build.directory}/assembly/binsrcpackageattached${basedir}/src/assembly/assembly-src.xmlxstream-${project.version}${project.build.directory}/assembly/src
jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/README.txt 0000664 0001750 0001750 00000005150 12206661545 025024 0 ustar jamespage jamespage ==========================================
Copyright (C) 2005, 2006 Joe Walnes.
Copyright (C) 2006, 2007 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
==========================================
(The XStream website is build using XSite - http://xsite.codehaus.org)
STRUCTURE
The directories should be self explanatory:
./src/templates: contains the skin HTML and style sheet. Other templates might go here.
./src/content: contains the content in simple HTML.
BUILDING SITE
Run the XSite builder using the Maven 2 plugin associated to the install goal:
mvn install
The new site will be deployed in target/xsite
Alternatively, download the standalone xsite distribution from http://xsite.codehaus.org/download
$XSITE_HOME/bin/xsite src/content/website.xml src/template/skin.html target/xsite
EDITING THE CONTENT OF THE SITE
1) Edit the files in ./src/content. These are plain HTML files and can be edited using any old HTML editor
(including Mozilla Composer or Word).
Supporting resources that are relevant to the content (such as images) can be placed in this directory.
2) If the structure of the navigation requires a change (necessary if adding a new page), update ./src/content/website.xml.
EDITING THE LOOK AND FEEL OF THE SITE
1) Edit the file ./src/templates/skin.html. This is a FreeMarker template that is applied to each page using SiteMesh.
Supporting resources that are relevant to the look and feel (such as images or CSS) can be placed in this directory.
DESIGN PRINCIPLES
The ideas behind site design are as follows:
1) It implements the design that resulted from the analysis of stereotypical users
The menu is designed to put what our users most want right up front. Other, less
important information can be linked from subpages.
2) It completely separates content, navigation and style
This makes it easy to change the "skin" of the site or the style of that skin.
3) The navigation "skin" is designed to be convenient in browsers that do not
process CSS.
The banner appears first, then the main page content, followed by any side panels on
the page. Thus, users of less capable browsers get the most important information
first and less important information later.
4) All content is simple HTML.
No styles required, although any styles and other media used by the content pages
get merged into the final site by the templater. This makes it easy to create
content in WYSIWYG editors.
jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/src/ 0000775 0001750 0001750 00000000000 12206661545 024114 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/src/templates/ 0000775 0001750 0001750 00000000000 12206661545 026112 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/src/templates/skin.html 0000664 0001750 0001750 00000003651 12206661545 027751 0 ustar jamespage jamespage
XStream - ${title}
${head}
${title}
${body}
<#list sitemap.sections as section>
${section.name}
<#list section.entries as entry>
<#if entry = page>
JIRA:XSTR-709: Locks up on Mac with Apple JVM due to unwanted initialization of AWT.
JIRA:XSTR-711: DateConverter cannot handle dates in different era.
JIRA:XSTR-712: HibernateMapper throws NPE if a collection contains null.
DateConverter supports now localized formats.
JIRA:XSTR-710: JsonWriter does not write BigInteger and BigDecimal as number values.
JIRA:XSTR-708: SqlTimestampConverter does not ignore timezone.
JIRA:XSTR-707: Creation of XmllPullParser with the XmlPullParserFactory may fail in OSGi environment.
JIRA:XSTR-705: Unnecessary synchronization accessing the field cache decreases performance.
JIRA:XSTR-714: Fields not found when XStream12FieldKeySorter used.
API changes
Deprecated method c.t.x.core.util.JVM.is14(), c.t.x.core.util.JVM.is15() and c.t.x.core.util.JVM.is16().
1.4.3
Released 17. July 2012.
Major changes
Support java.util.concurrent.ConcurrentHashMap with the MapConverter. This will also avoid a bug in JRockit
JDK reported in JIRA:XSTR-608.
JIRA:XSTR-699: Support for Hibernate 4 with XStream's Hibernate module as default for Java 6 or higher.
Minor changes
JVM.loadClass will now also initialize the loaded class and ignore any occurring LinkageError.
JIRA:XSTR-596: SubjectConverter will be no longer registered if initialization of javax.security.auth.Subject fails.
JIRA:XSTR-683: Inheritance of implicit collections, arrays or maps is dependent on declaration sequence.
Inherited implicit collections, arrays or maps can be overwritten with own definition in subtype.
JIRA:XSTR-688: Cannot omit XML elements from derived fields.
JIRA:XSTR-696: Ill-formed JSON generated, because JSON writer is fed with type of declaring field instead of
the real object's type.
JIRA:XSTR-685: Deserialization from file or URL keeps stream open.
JIRA:XSTR-684: XML 1.0 character validation fails for characters from 0x10 to 0x1f.
JavaBeanConverter supports now instantiation for a specific type and can therefore be used in
@XStreamConverter annotation.
SerializableConverter is broken if the serialized type is the default implementation.
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
JIRA:XSTR-695).
FieldDictionary may call sort of FieldKeySorter implementation with wrong type as key.
Sometimes DependencyInjectionFactory tries to instantiate objects with mismatching constructor arguments.
HSQLDB has to be a test dependency only for XStream's Hibernate module.
1.4.2
Released 3. November 2011.
Major changes
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.
JIRA:XSTR-675: New extended HierarchicalStreamReader interface with peekNextChild method. All XStream
readers implement the new interface (by Nikita Levyankov).
JIRA:XSTR-673: Collections.EMPTY_LIST, Collections.EMPTY_SET and Collections.EMPTY_MAP supported with own
alias and defined as immutable.
JIRA:XSTR-631: Collections.singletonList(), Collections.singletonSet() and Collections.singletonMap()
supported with own alias and own converters.
JIRA:XSTR-406 + JIRA:XSTR-663: Support additional parameters for XStreamConverter annotation (e.g. to declare a
ToAttributedValueConverter).
Minor changes
WstxDriver did not trigger Woodstox, but BEA StAX implementation.
JIRA:XSTR-260: PrettyPrintWriter does not handle tab and new line characters in attributes.
JIRA:XSTR-667: Cannot serialize empty list with JsonHierarchicalStreamDriver.
JIRA:XSTR-661: TreeMarshaller.CircularReference is not a ConversionException.
JIRA:XSTR-562: StAX: Namespace attribute is not written in non-repairing mode for second sibling.
JIRA:XSTR-664: ClassCastException in HibernatePersistentSortedSetConverter and
HibernatePersistentSortedMapConverter.
JIRA:XSTR-674: Recreate binary compatibility with 1.3.x series for method
CustomObjectInputStream.getInstance(...).
JIRA:XSTR-671: CannotResolveClassException should accept cause.
JIRA:XSTR-672: Collections.EMPTY_LIST, Collections.EMPTY_SET and Collections.EMPTY_MAP used for in implicit
collection should not throw ReferencedImplicitElementException.
JIRA:XSTR-676: Introduce MissingFieldException thrown at deserialization time indicating a missing field or
property (by Nikita Levyankov).
Add length limit for cached strings in StringConverter, 38 characters by default.
The JsonHierarchicalStreamDriver and the JsonWriter did not support the inherited NameCoder instance.
Add BinaryStreamDriver.
NPE in XppDomComparator.
Dom4JXmlWriter fails to flush the underlying writer.
Known control characters are not encoded with JsonWriter as proposed at json.org.
Detect duplicate property processing in JavaBeanConverter and throw DuplicatePropertyException instead of
clobbering silently.
Allow access to Mapper and JavaBeanProvider in derived instances of JavaBeanConverter.
DependencyInjectionFactory failed to create instance when a matching constructor was found, but a default
constructor was also present.
API changes
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.
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.
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().
JIRA:XSTR-659: 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.
Minor changes
Add utility class c.t.x.io.xml.xppdom.XppFactory and a path tracking comparator for XppDom.
1.4
Released 6. August 2011.
Major changes
Java 7 is detected and supported.
JIRA:XSTR-542: 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.
Additional explicit XPP drivers for the Xpp3 and kXML2 implementations.
Additional explicit XPP DOM drivers for the Xpp3 and kXML2 implementations.
kXML2 is now the preferred parser implementation, Xpp3 is optional.
Additional explicit StAX drivers for Woodstox, BEA StAX and SJSXP of the JDK 6 implementations.
JDK 1.3 is no longer officially supported.
JIRA:XSTR-377+JIRA:XSTR-226: New artifact xstream-hibernate with converters and mapper to process Hibernate
object graphs (by Costin Leau, Konstantin Pribluda and in special Jaime Metcher).
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.
JIRA:XSTR-553: Support annotations in Android.
JIRA:XSTR-556: 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.
The type java.lang.reflect.Field is now handled by an own converter, that can still read the old format.
JIRA:XSTR-490: Provide path in Converter for contexts that track the path.
JIRA:XSTR-592+JIRA:XSTR-579: OmitField respected at deserialization time even for existing fields.
JIRA:XSTR-593: Direct support for java.net.URI instances (by Carlos Roman).
JIRA:XSTR-615+JIRA:XSTR-580: Dynamic proxies cannot be referenced recursively.
JIRA:XSTR-547: Wrong class loader used for Serializable types deserialized with an ObjectInputStream.
JIRA:XSTR-341: Support of implicit arrays.
JIRA:XSTR-306+JIRA:XSTR-406: Support of implicit maps.
JIRA:XSTR-344: New ToAttributedValueConverter to allow conversion of an element with string body and
attributes.
JIRA:XSTR-573: SortedSet added with TreeSet as the default implementation.
JIRA:XSTR-576: TreeMap and TreeSet no longer add an element without comparator (by Jason Greanya),
solves also invalid format with JSON for such objects (JIRA:XSTR-640).
Minor changes
JIRA:XSTR-612: Improve extensibility of c.t.x.javabean.* package by reintroducing a PropertyDictionary with
the additional interface PropertySorter.
JIRA:XSTR-591: EnumSingleValueConverter did use toString() instead of name() to create the String
representation of an enum value.
JIRA:XSTR-618: Add Oracle as vendor used for recent JRockit versions and former Sun JDK.
JIRA:XSTR-656: DomReader and Dom4JReader do not escape attribute names retrieving their values.
JIRA:XSTR-604: StringConverter's cache may cause an OutOfMemoryException.
JIRA:XSTR-577: Skip UTF-8 BOM in XmlHeaderAwareReader.
The XppReader no longer uses a BufferedReader.
JIRA:XSTR-543: Better deserialization support of the defined-in system attribute in combination with field
aliases.
JIRA:XSTR-551: Deprecated XStream.InitializationException still thrown instead of InitializationException.
JIRA:XSTR-655: JsonWriter generates invalid JSON for Externalizable types.
JIRA:XSTR-540: Support Jettison-based configuration of JettisonMappedXmlDriver (by Doug Daniels).
JIRA:XSTR-633: JettisonMappedXmlDriver escaped property names according escape rules for XML tag names.
JIRA:XSTR-625: Optionally ignore XStream's hints for Jettison to generate JSON arrays (by Dejan Bosanac).
JIRA:XSTR-605: Upgrade to Jettison 1.2 (for Java 5 or higher).
New JsonWriter.EXPLICIT_MODE generating JSON that enforces property sequence.
JIRA:XSTR-552: Improve performance of ReflectionProvider (by Keith Kowalczykowski).
JIRA:XSTR-559: Improve performance of Sun14ReflectionProvider (by Keith Kowalczykowski).
JIRA:XSTR-564: Improve performance of AnnotationMapper (by Keith Kowalczykowski).
JIRA:XSTR-563: Use ReferenceQueue for cleaning-up WeakReferences in ObjectIdDictionary (by Keith
Kowalczykowski).
JIRA:XSTR-646: Cache of Sun14ReflectionProvider consumes more PermGen space than necessary.
JIRA:XSTR-636: Ineffective cache in FieldDictionary using WeakHashMap with WeakReference values.
Ineffective cache for SerializationMethodInvoker (related to JIRA:XSTR-636).
Introduction of Caching interface implemented by all types in XStream that create local caches that may
have to be flushed manually.
Avoid excessive creation of AbstractPullReader.Event objects by using a pool.
Possibility to generate XPath expressions that select always a single node instead of a node list.
Cannot reference replaced object using ID references.
Implicit collection functionality will no longer use custom collection converters that may write tags that are not
recognized at deserialization time again.
JIRA:XSTR-654: Unmarshal fails when an implicit collection is defined and an element is named equal to the field.
JIRA:XSTR-574: AbstractReferenceUnmarshaller cannot handle null values for references.
Improve exception output in case of a missing field.
JIRA:XSTR-555: StAX driver tests do not honor repairing mode.
JIRA:XSTR-570: The @XStreamConverter provides now also the current type as possible constructor argument.
JIRA:XSTR-629: Deserialization of Externalizable with non-accessible default constructor fails.
JIRA:XSTR-583: BinaryDriver fails to handle Strings with more than 64K bytes.
JIRA:XSTR-639: Cannot omit field at deserialization if the field has a class attribute.
JIRA:XSTR-599: EncodedByteArrayConverter should implement SingleValueConverter.
JIRA:XSTR-584: Race condition in XmlFriendlyReplacer.
JIRA:XSTR-623: XmlFriendlyReplacer may write illegal name characters (by Michael Schnell).
The ConversionException hides information if its ErrorWriter contains the added key already.
JIRA:XSTR-598: Attribute "defined-in" was wrongly evaluated for other attributes.
JIRA:XSTR-650: Possible NullPointerException at initialization on platforms like Android that do not
support all types of the JDK.
JIRA:XSTR-652: 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.
Constructor DocumentWriter(Element) forgets the provided element.
Introduce Caching interface to flush the internal cache of specific components.
Support JIRA:XSTR-407 also for IBM JRE 1.6 and greater.
java.nio.charset.Charset's converter was added as immutable type instead of the type itself.
java.util.Currency added as immutable type.
Fix selection of same parameter types in DependencyInjectionFactory.
Deprecation of c.t.x.javabean.PropertyDictionary has been countermanded.
API changes
Any deprecated stuff of the 1.2.x releases has been removed.
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 JIRA:XSTR-547).
Deprecated constructors of c.t.x.io.xml.XppReader, new versions take an additional argument for the XmlPullParser.
Deprecated c.t.x.io.xml.XppReader.createParser(), the XPP parser is now created by the driver.
Package c.t.x.io.xml.xppdom is now part of the official API.
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.
Deprecated c.t.x.mapper.XStream11XmlFriendlyMapper and c.t.x.mapper.AbstractXmlFriendlyMapper.
Added interface c.t.x.core.ReferencingMarshallingContext which is implemented by all referencing marshallers.
Added interface c.t.x.io.naming.NameCoder and implementations.
Deprecated c.t.x.io.xml.XmlFriendlyReplacer, c.t.x.io.xml.XmlFriendlyReader and c.t.x.io.xml.XmlFriendlyWriter.
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.
Deprecated all constructors of Driver, Reader and Writer implementations that take a XmlFriendlyReplacer as argument,
added constructors taking a NameCoder instead.
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.
1.3.1
Released 6 December 2008.
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 (JIRA:XSTR-469, JIRA:XSTR-513 and JIRA:XSTR-518).
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.
Major changes
JIRA:XSTR-515: CGLIB support is no longer activated automatically and has to be
explicitly turned on.
JIRA:XSTR-448: Separated system attributes and user defined attributes for aliases.
JIRA:XSTR-55: Ability to alias a package name.
JIRA:XSTR-434: New JsonWriter instead of JsonHierarchicalStreamWriter with mode to strip root node of generated JSON (by Paul Hammant).
Support for Diablo JDK on FreeBSD (by Reto Bachmann-Gmür).
JIRA:XSTR-495: New PersistenceStrategy instead of StreamStrategy (based on the code and comments by Alexander Radzin).
Minor changes
Support special Jettison functionality for JSON to detect collections or arrays with one element introduced with Jettison 1.0.
JIRA:XSTR-493: Using attributes for fields with XML-unfriendly names results in NPE at deserialization.
JIRA:XSTR-497: Unsafe operation with WeakHashMap can raise a NPE in Sun14ReflectionProvider.
JIRA:XSTR-423: Support of CGLIB enhanced proxies with multiple callbacks if the proxy uses a factory (CGLIB default).
JIRA:XSTR-503: Omitted properties in JavaBeans are requested at serialization (by Kevin Conaway).
Fix possible memory leak in ObjectIdMap for JVMs that provide real distinct identity hash codes (happened on amd64 system).
JIRA:XSTR-480: Aliasing of array types.
JIRA:XSTR-515: The SubjectConverter and DurationConverter are only registered if the converted class is part of the JDK,
otherwise they must be registered now explicitly.
JIRA:XSTR-504: XmlHeaderAwareReader fails with improper sized PushbackInputStream.
JIRA:XSTR-489: @XStreamConverter supports now also SingleValueConverter implementations.
JIRA:XSTR-481: @XStreamConverter and @XStreamAsAttribute can be used together (as a result of JIRA:XSTR-489).
JIRA:XSTR-519: New annotation @XStreamInclude to force annotation detection of included types (by Seven Sparling).
JIRA:XSTR-469: Support custom converters for enum types.
JIRA:XSTR-502: ClassNotFoundException even if writeReplace returns proper object.
JIRA:XSTR-529: NullPointerException for null elements in implicit lists.
JIRA:XSTR-517: Miscellaneous performance improvements (by Tatu Saloranta).
JIRA:XSTR-525: JsonHierarchicalStreamDriver writes invalid JSON in case of system attribute.
JIRA:XSTR-535: Mode to allow plain values as result for JSON without root node.
JIRA:XSTR-531: Possibility to omit system attributes.
JIRA:XSTR-508: Fix marshalling error for nested serializable objects with own writeReplace/readResolve methods.
JIRA:XSTR-507: Advanced ReferenceByIdMarshaller uses id of the current object if available.
JIRA:XSTR-485: Check reference for valid object when deserializing.
Fix classloader problem, Xpp3 parser cannot be loaded within a web application.
Dependencies have been updated to latest versions of JDOM, Jettison, Joda Time, and Woodstox. Note for Maven
builds that the groupId of JDOM has changed.
Fix possible IndexOutOfBoundsException creating returning the message for a ConversionException.
JIRA:XSTR-495: StreamStrategy cannot handle key with value null.
API changes
Deprecated c.t.x.io.json.JsonHierarchicalStreamWriter in favour of c.t.x.io.json.JsonWriter.
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.
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.
c.t.x.core.ReferenceByIdMarshaller.IdGenerator.next() has now the current object as argument.
New c.t.x.persistence.PersistenceStrategy and c.t.x.persistence.FilePersistenceStrategy.
Deprecated c.t.x.persistence.StreamStrategy and c.t.x.persistence.FileStreamStrategy.
1.3
Released 27 February 2008.
Major changes
ReflectionConverter writes now the fields of the parent classes first.
Support for Converter definition at field level.
Refactoring of Annotation support, invent auto-detection mode.
Annotated converters are no longer detected automatically, all annotations are now handled in the same way.
JIRA:XSTR-334: 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.
JIRA:XSTR-261: All c.t.x.io.HierarchicalStreamDriver implementations respect now the encoding of an XML header
if read from an InputStream.
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
JIRA:XSTR-415: JavaBeanConverter uses now BeanIntrospection (by Hinse ter Schuur).
JIRA:XSTR-424: DateConverter uses now by default SimpleDateFormat instances in non-lenient mode.
JIRA:XSTR-386: SingleValueConverter that utilizes PropertyEditor implementations (by Jukka Lindström).
JIRA:XSTR-427: Converter for javax.xml.datatype.Duration (by John Kristian).
JIRA:XSTR-305: Field alias inheritance (by David Blevins).
XStream failed to initialize in environments without AWT or SQL classes.
JIRA:XSTR-420: XPath of references are not XmlFriendly encoded.
JIRA:XSTR-473: String "\0" serialized as invalid XML, support compliant behaviour according XML version.
JIRA:XSTR-431: Direct support of enhanced mode for SAP JVM (thanks to Norbert Kuck by SAP).
JIRA:XSTR-437: Static cache in annotation processing causes failing OSGi bundles.
JIRA:XSTR-279+JIRA:XSTR-335: Annotations are not inherited from parent class.
Fix StringConverter using a WeakHashMap with strong references in its value.
JIRA:XSTR-403: Attributes are no longer written with JSONHierarchicalStreamDriver if current object is a collection.
JIRA:XSTR-456: New LookAndFeelConverter handling LookAndFeel implementations with reflection.
JIRA:XSTR-462: CachingMapper keeps direct class references.
JIRA:XSTR-411: JsonHierarchicalStreamDriver does not escape characters according RFC 4627.
JsonHierarchicalStreamDriver writes wrong brackets around complex Java types with a single value.
JsonHierarchicalStreamDriver writes attribute names with a leading '@'.
Added converter for java.lang.StringBuilder instances.
Added converter for java.util.UUID instances.
JIRA:XSTR-430: Fields written as attributes could not be omitted.
JIRA:XSTR-407: 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.
JIRA:XSTR-404, @XStreamImplicit() for ArrayList<ArrayList<Type>> throws ClassCastException.
@XStreamContainedType() for ArrayList<ArrayList<Type>> throws ClassCastException.
XStreamer did not persist a FieldKeySorter instance.
JIRA:XSTR-241: JavaBeanConverter now supports customized BeanProvider.
JIRA:XSTR-280: JavaBeanConverter now supports aliasField and omitField (by Hinse ter Schuur).
JIRA:XSTR-280: SerializationConverter now supports aliasField and omitField.
JIRA:XSTR-429: XmlFriendlyReplacer support for SaxWriter and TraxSource (by Adrian Wilkens).
JIRA:XSTR-421: Characters cannot be written as attribute.
JIRA:XSTR-426: java.swt.KeyStroke not properly serialized because of a character undefined in unicode.
JIRA:XSTR-352: Strings with arbitrary ISO control characters are not properly serialized.
JIRA:XSTR-428: An attribute named like a transient field did abort deserialization of following fields.
JIRA:XSTR-443: XStream.createObjectOutputStream does not use the given driver to create the HierarchicalStreamWriter.
JIRA:XSTR-440: Implicit collections can be declared for fields that are not of Collection type.
JIRA:XSTR-446: Handle all primitives and their boxed counterpart for JsonHierarchicalStreamDriver.
JIRA:XSTR-447: Fix deserialization of Array class types in JDK 6 (see JDK bug 6500212).
JIRA:XSTR-450: @XStreamAlias is ignored if attributes should be used for the field type.
JIRA:XSTR-418: Inherited @XStreamAlias is ignored if field should be rendered as attribute.
JIRA:XSTR-393: Annotation processing is not consistent.
JIRA:XSTR-412: @XStreamImplicit throws NPE for untyped collections.
JIRA:XSTR-463: Cannot provide own default Mapper chain.
JIRA:XSTR-464: Cannot provide a ClassLoader that is used in all cases.
JIRA:XSTR-394: Allow enums as attributes.
JIRA:XSTR-413: Support @XStreamAsAttribute for enums.
JIRA:XSTR-478: Cannot specify default implementation for polymorphic enum.
JIRA:XSTR-419: Treat enums as immutable types.
Update annotation tutorial, explain limitations of auto-detection mode.
Added copyright notices to all files.
StaxWriter.flush did close Stax' XMLStreamWriter instead of flushing it.
JIRA:XSTR-471: XStream POMs do no longer declare a repository at all.
Calendar object could not be rendered with JSONHierarchicalStreamDriver.
JIRA:XSTR-476: Properties can be sorted by key.
XStream.createObjectInputStream and XStream.createObjectOutputStream
overloaded to support a binary InputStream or OutputStream.
JIRA:XSTR-470: Allow transient fields to be optionally deserialized.
API changes
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().
New auto-detection mode for annotations, that can be turned on with c.t.x.XStream.autodetectAnnotations()
c.t.x.annotation.@XStreamContainedType deprecated, the behaviour is now always active and the annotation therefore superfluous.
Due to JIRA:XSTR-421 null characters are no longer written as tag with an attribute (<char null="true"/>),
but as empty tag. The old representation is still supported at deserialization.
Characters that are not defined in unicode or ISO control characters (expect TAB and LF) are written as numerical entity now.
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.
c.t.x.core.BaseException deprecated in favour of c.t.x.XStreamException as base exception for all exceptions XStream throws.
c.t.x.XStream.InitializerException deprecated in favour of c.t.x.InitializerException.
New methods get() and keys() in interface c.t.x.converter.ErrorWriter.
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.
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().
c.t.x.XStream(ReflectionProvider, Mapper, HierarchicalStreamDriver) deprecated, in favour of
c.t.x.XStream(ReflectionProvider, HierarchicalStreamDriver, Mapper, ClassLoader).
New interface c.t.x.converter.ConverterRegistry to express explicit functionality managing the converters.
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.
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.
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.
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.
Version 1.2.2
Released 24 May 2007.
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.
Major changes
JIRA:XSTR-391, Support for writing (and reading) JSON by the new JettisonMappedXmlDriver (by Dejan Bosanac).
New FieldKeySorter interface allows a custom sort order of the XML elements.
JIRA:XSTR-68 and JIRA:XSTR-210, OmitField is now respected at deserialization to ignore removed fields.
JIRA:XSTR-368, @XStreamConverter converters should be cached inside the AnnotationReflectionConverter.
JIRA:XSTR-392, @XStreamOmitField can be used to omit fields from the resulting XML (contributed by Chung-Onn Cheong).
JIRA:XSTR-371, Fix JSONWriter that omits a closing bracket for for fields with null value.
JIRA:XSTR-398, DomDriver ignores given XmlFriendlyReplacer.
JIRA:XSTR-370, Buildable with JDK 6, fix FontConverter for JDK 6.
JIRA:XSTR-382, Support hex and octal number values.
DateConverter did not respect change in TimeZone after first usage.
JIRA:XSTR-375, Support for aliasing native types.
JIRA:XSTR-243 again, XML elements for transient fields are now ignored completely at deserialization.
Release unused object references to keep memory print low.
Support for AWT and SQL is now optional: XStream now works on embedded virtual machines lacking such APIs (by Nicolas Gros d'Aillon).
Support raw bytes read from the ObjectInputStream.
JIRA:XSTR-373, Support for Hitachi JVM (tested by Yuji Yamano).
JIRA:XSTR-378 and JIRA:XSTR-379, Fix TextAttributeConverter and EnumSetConverter failing on Apache Harmony.
JIRA:XSTR-363, Support of native field order i.e. fields are processed in declaration order base classes first.
JIRA:XSTR-320, Static field in child may hide non-static field in parent.
API changes
JIRA:XSTR-365, Multiple implicit collections with annotations. Deprecated @XStreamImclicitCollection in favour of @XStreamImplicit
declared at field level.
Version 1.2.1
Released 11 November 2006.
Major changes
Introduced DocumentWriter interface and generalized functionality for all writer implementations
creating a DOM structure (DOM4J, DOM, JDom, Xom, Xpp3Dom).
Refactored build system to use Maven 2. Ant still supported on XStream Core.
Created separate XStream Benchmark module
Minor changes
JIRA:XSTR-346, XStream.getClassMapper() does not return a ClassMapper for the current Mapper.
Fix problem with fields containing a double underscore.
JIRA:XSTR-345, Dom4JWriter adds up attributes.
JIRA:XSTR-336, XStream fails to reference an implicit element.
JIRA:XSTR-337, Annotation cycle bug.
Fix packaging error for the resulting jar building with Maven2.
JIRA:XSTR-339, NPE for attribute null values.
JIRA:XSTR-338, NPE in JSON writer for converters using non-extended HierarchicalStreamWriter.
JIRA:XSTR-357, Fix escaping of values in JSON writer.
JIRA:XSTR-356, Fix unmarshaling error for fields containing proxies.
JIRA:XSTR-349, Fix backward compatibility of Dom4jWriter.
JIRA:XSTR-309, More versatile boolean conversion options (contributed by David Blevins).
Add XStream.getReflectionProvider() to retrieve ReflectionProvider in use.
JIRA:XSTR-358, @XStreamConverter annotation does not call converter constructor.
Unmarshalling context has now an overloaded version of the method convertAnother to provide the Converter directly.
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.
Deprecate c.t.x.alias.CannotResolveClassException for c.t.x.mapper.CannotResolveClassException.
Deprecate NameMapper (was not used within XStream anymore anyway).
Deprecate constructor of DefaultMapper taking an alternative name for the class attribute. Use the aliasAttribute method.
Deprecate attributeForImplementationClass, attributeForClassDefiningField, attributeForReadResolveField, and attributeForEnumType in favour of the generalized aliasForAttribute in the Mapper interface.
Removed all deprecated stuff from 1.1.x and 1.0.x
JIRA:XSTR-211, A lot of existing (basic) Converters have been refactored to use the new SingleValueConverter interface.
Dom4JWriter uses now a DocumentFactory and a XMLWriter as constructor arguments.
Version 1.1.3
Released 13 January 2006.
Major changes
Added XStream.toXML(OutputStream) and XStream.fromXML(InputStream).
Ability to prevent fields from being serialized by calling XStream.omitField() or by implementing Mapper.shouldSerializeMember().
Added Converter for Enum, EnumMap and EnumSet
JIRA:XSTR-186, Added BeanConverter (contributed by Andrea Aime)
JIRA:XSTR-246, Added ISO8601SqlTimestampConverter (contributed by Cheong, Chung-Onn)
Added ISO8601GregorianCaledarConverter
JIRA:XSTR-215, Fixed support for IBM JVM (contributed by Gabor Liptak)
Enhanced mode support for Blackdown JDK
JIRA:XSTR-265, support for javax.security.auth.Subject
JIRA:XSTR-233, support for Integer[] arrays
Minor changes
Remove unnecessary PrintWriter wrapper in default writers (pointed out by Mathieu Champlon)
Bugfix: EnumSet converter can now deal with empty sets (contributed by Baba Buehler)
Update ISO8601DateConverter to use Joda 1.0
JIRA:XSTR-242, GregorianCalenderConverter saves now the timezone
JIRA:XSTR-247, ISO8601DateConverter now independent on timezone
JIRA:XSTR-263, Circular references with Externalizable objects fail
API changes
None.
Version 1.1.2
Released Apr 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.
Major changes
JIRA:XSTR-186, Option to serialize JavaBeans using public accessors, rather than private fields (contributed by Andrea Aime).
Ability to alias fields as well as classes, using XStream.addFieldAlias().
JIRA:XSTR-70, JIRA:XSTR-204 Support for JDK 5 enums (contributed by Eric Snell and Bryan Coleman).
JIRA:XSTR-206 Clean representation of JDK 5 EnumMap and EnumSet.
XStream can now be built using JDK 1.3 (previously it required JDK 1.4 to compile, but 1.3 to run).
JIRA:XSTR-215, Enhanced mode is now supported on the IBM 1.4 JDK.
The default HierarchicalStreamWriter implementation is supplied by the HierarichicalStreamDriver (as well as the reader).
Minor changes
JIRA:XSTR-104 HierarchicalStreamReader now exposes all available attributes to the Converter implementations (contributed by Trygve Laugstol).
Bugfix: Externalizable deserialization supported for objects not at the root of tree.
JavaMethodConverter handles non public methods/constructors (contributed by Kevin Ring).
PropertiesConverter also serializes default properties, if present (contributed by Kevin Ring).
Bugfix: In some cases, XppReader and StaxReader would get confused when calling hasMoreChildren() and getValue() on the same node.
JIRA:XSTR-217, ISO8601DateConverter now requires joda-time-1.2.1
PrettyPrintWriter and CompactWriter may have their text/attribute escaping rules customized by overriding writeText() and writeAttributeValue().
API changes
HierarchicalStreamDriver implementations now require a createWriter() method. The simplest implementation is to return a new PrettyPrintWriter.
Introduced ReaderWrapper/WriterWrapper classes to make it easier to wrap (decorate) HierarchicalStreamReader/Writer instances.
Version 1.1.1
Released Mar 7, 2005. Mostly bugfixes and minor feature enhancements.
Major changes
Converters can be registered with a priority, allowing more generic filters to handle classes that don't have more specific converters.
Converters can now access underlying HierarchicalStreamReader/Writer implementations to make implementation specific calls.
Improved support for classes using ObjectInputFields to follow the serialization specification.
JIRA:XSTR-179 Support for ObjectInputStream.registerValidation(ObjectInputValidation).
JIRA:XSTR-178 Serialized inner class now maintains reference to outer class.
JIRA:XSTR-199 Default ClassLoader may be changed using XStream.setClassLoader().
Minor changes
Bugfix: Thread context classloader is loaded by the correct thread. (Thanks to Padraic Renaghan for pointing this out).
Bugfix: Default implementations of aliased classes were not being deserialized by SerializableConverter.
Bugfix: JIRA:XSTR-180 Serializable objects support defaultReadObject() even when no default fields available.
Bugfix: For serialized objects class hierarchy is serialized starting with superclass (as per Java Object Serialization).
Bugfix: readObject() is now called for classes containing only transient fields.
Bugfix: Order of fields are maintained when calling ObjectOutputStream.putFields().
Bugfix: FontConverter extended to support FontUIResource which does some awkward native calls.
Bugfix: Deserialization of very complicated graphs (such as Swing components) sometimes resulted in broken object references. Now fixed.
Bugfix: JIRA:XSTR-188 Classes that use readResolve()/writeReplace() can now return different types.
Bugfix: JIRA:XSTR-185, JIRA:XSTR-195 Support for loading of array classes for classes that have not yet been loaded. (Thanks to Henri Tremblay and Simon Daniel)
Bugfix: JIRA:XSTR-190 PrettyPrintWriter and CompactWriter escape characters in XML attributes.
Bugfix: JIRA:XSTR-176, JIRA:XSTR-196 The XStream ObjectInputStream and ObjectOutputStream implementations now propegate the flush() and close() events to the underlying streams.
Bugfix: JIRA:XSTR-192 Implicit collection mappings are now supported in inheritance hierarchies.
API changes
ClassMapper is now deprecated. Replaced with MapperWrapper.
HierarchicalStreamWriter implementations must now implement close(), flush() and underlyingWriter().
HierarchicalStreamReader implementations must now implement close() and underlyingReader().
Version 1.1
Released Jan 15, 2005. Focus on support for objects defining custom serialization using the standard
Java serialization mechanism.
Major changes
Provides drop in replacement for ObjectInputStream and ObjectOutputStream, using XStream.createObjectInputStream() and
XStream.createObjectOutputStream() and XStream.createObjectInputStream(). This provides support for streaming objects.
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().
Support for objects to serialize other objects to the stream by implementing writeReplace() (as in Java serialization spec).
Support for any object that performs custom serialization by implementing java.io.Externalizable (as in Java serialization spec).
Implicit collections can be specified for classes, allowing the element wrapping the collection to be skipped.
New writer implementations to allow XStream to serialize directly to a SAX stream or TrAX pipeline.
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.
Includes new DomWriter implementation to serialize directly to a W3C DOM tree (to complement the existing DomReader).
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.
DOM, DOM4J, JDOM, XOM, Electric-XML, SAX, STAX
Specific ClassLoaders can be passed into XStream, to allow for greater compatibility in J2EE containers.
Ability to change the default converter
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.
Enhanced mode is now supported on the Apple 1.4 JDK.
Minor changes
PrettyPrintWriter only flushes stream when necessary - large performance improvement for serialization.
Added XStream.fromXml(xml, root) convenience methods for deserializing into an existing root object.
JDK 1.3 compatibility: Added mechanism for accessing nested exception.
JDK 1.3 compatibility: GregorianCalendarConverter only calls Calendar.getTimeInMillis() the JDK supports it.
Bugfix: All caches are now synchronized - there were some thread safety issues.
Bugfix: Only immutable basic types will have references ignored in XML (for clarity).
Bugfix: Class names can contain underscores.
Bugfix: Support for '\0' char.
Bugfix: PropertyConverter no longer attempts to serialize subclasses of Properties.
Bugfix: JVM detection uses system properties, which is more accurate than searching the classpath.
API changes
XStream.addDefaultCollection() has been deprecated. Use XStream.addImplicitCollection() instead.
Version 1.0.2
Released Aug 7, 2004. Focus on improving the converters bundled with XStream to support a wider range of types.
Major changes
XML elements are written in order they are defined in class, rather than alphabetical.
Converters for java.io.File, java.sql.Timestamp, java.awt.Color, and dynamic proxies are now
registered by default.
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.
New converters for java.sql.Time, java.sql.Date, java.util.Locale, java.util.Currency, java.util.Calendar
and java.awt.Font.
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.
XStream will fail fast if a field value is defined more than once in XML when deserializing.
Minor changes
The <entry> element used in Maps can now be specified by creating an alias for java.util.Map.Entry.
Bugfix: Fields with characters that generate invalid XML (such as $ signs) are now escaped.
Bugfix: Pre-instantiated objects can be unmarshalled through multiple levels.
API changes
None.
Version 1.0.1
Released May 30, 2004. Misc features and bugfixes.
Major changes
Support for multidimensional arrays.
Object with readResolve() method will be treated the same way native serialization treats them.
Minor changes
New converters for Throwable and StackTraceElement that retain stack trace (JDK 1.4 only)
Bugfix: System.identityHashCode() is not guaranteed to be unique. Ensure reference checking is used as well.
Bugfix: Allows user classes to be defined in WEB-INF/classes in Servlet environments. Tries to use context classloader if available.
Support for java.util.Currency (through readResolve()).
Instances of Jakarta Commons Lang Enum are now reused (through readResolve()).
Bugfix: JavaClassConverter handles primitive type classes (contributed by Matthew Sandoz).
API changes
Additional method: ConverterLookup.defaultConverter(). Custom implementations of this class should implement
this new method.
Version 1.0
Released May 14, 2004. Focusses on finalizing the API for 1.0 release.
Major changes
Supports fields of same name, hidden by inheritance.
Minor changes
JavaDoc for most important parts of API.
API changes
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.
Version 1.0 (release candidate 1)
Released May 9, 2004. Focusses on finalizing the API for 1.0 release.
Major changes
JDK 1.3 compatibility.
Informative error messages.
Defaults to using faster XPP based parser.
Serializes final field under JDK 1.4.
Fail fast when trying to serialize final field if not Sun 1.4 JRE.
Minor changes
Misc performance improvements.
Converters for TreeMap and TreeSet that store the Comparator.
API changes
Default constructor for XStream class uses XppDriver instead of DomDriver.
To use DomDriver, explicitly pass it in to the constructor.
Exception is thrown if trying to serialize an object that contains a
final field if not Sun 1.4 JRE.
Sometimes it can get tedious to call all those XStream aliases/register converter methods or you might simply like
the new trend on configuring POJOs: Java annotations.
This tutorial will show you how to use some of the annotations provided by XStream in order to make configuration
easier. Let's start with a custom Message class:
package com.thoughtworks.xstream;
package com.thoughtworks.xstream;
public class RendezvousMessage {
private int messageType;
public RendezvousMessage(int messageType) {
this.messageType = messageType;
}
}
Let's code the XStream calls which generate the XML file:
package com.thoughtworks.xstream;
public class Tutorial {
public static void main(String[] args) {
XStream stream = new XStream();
RendezvousMessage msg = new RendezvousMessage(15);
System.out.println(stream.toXML(msg));
}
}
The most basic annotation is the one responsible for type and field aliasing: @XStreamAlias. Let's annotate both
our type and field and run the tutorial method again:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
public RendezvousMessage(int messageType) {
this.messageType = messageType;
}
}
In some strange way, the result is the same. What happened here? XStream does not read this annotation by default
as it would be impossible to deserialize the XML code. Therefore we need to tell XStream to read the annotations from
this type:
public static void main(String[] args) {
XStream stream = new XStream();
xstream.processAnnotations(RendezvousMessage.class);
RendezvousMessage msg = new RendezvousMessage(15);
System.out.println(stream.toXML(msg));
}
Note that we have called the processAnnotations method of XStream. This method registers all aliases annotations in
the XStream instance passed as first argument. You may also use the overloaded version of this method taking an array
of types. The resulting XML is now what we have expected:
<message>
<type>15</type>
</message>
If you let XStream process the annotations of a type, it will also process all annotations of the related types i.e.
all super types, implemented interfaces, the class types of the members and all their generic types.
Implicit Collections
Let's add a List of content to our RendezvousMessage. We desire the same functionality obtained with implicit
collections:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
private List<String> content;
public RendezvousMessage(int messageType, String ... content) {
this.messageType = messageType;
this.content = Arrays.asList(content);
}
}
public static void main(String[] args) {
XStream stream = new XStream();
xstream.processAnnotations(RendezvousMessage.class);
RendezvousMessage msg = new RendezvousMessage(15, "firstPart","secondPart");
System.out.println(stream.toXML(msg));
}
The resulting XML shows the collection name before its elements:
We are almost there... we still want to remove the 'a' tag, and define each content part with the tag 'part'. In
order to do so, let's add another attribute to our implicit collection annotation. The attribute field defines the
name of the tag used for data contained inside this collection:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
@XStreamImplicit(itemFieldName="part")
private List<String> content;
public RendezvousMessage(int messageType, String... content) {
this.messageType = messageType;
this.content = Arrays.asList(content);
}
}
The implicit annotation can also be used for arrays and maps. In the latter case you should provide the field name
of the values that are used as key of the map.
Local Converters
Let's create another attribute which defines the timestamp when the message was created and one to flag special
importance of the message:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
@XStreamImplicit(itemFieldName="part")
private List<String> content;
private boolean important;
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, boolean important, String... content) {
this.messageType = messageType;
this.important = important;
this.content = Arrays.asList(content);
}
}
Now we face the following problem: We want to use a custom converter locally for this Calendar, but only for this
Calendar, this exact field in this exact type. Easy... let's annotate it with the custom converter annotation:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
@XStreamImplicit(itemFieldName="part")
private List<String> content;
private boolean important;
@XStreamConverter(SingleValueCalendarConverter.class)
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, String... content) {
this.messageType = messageType;
this.content = Arrays.asList(content);
}
}
Let's create the custom converter:
public class SingleValueCalendarConverter implements Converter {
public void marshal(Object source, HierarchicalStreamWriter writer,
MarshallingContext context) {
Calendar calendar = (Calendar) source;
writer.setValue(String.valueOf(calendar.getTime().getTime()));
}
public Object unmarshal(HierarchicalStreamReader reader,
UnmarshallingContext context) {
GregorianCalendar calendar = new GregorianCalendar();
calendar.setTime(new Date(Long.parseLong(reader.getValue())));
return calendar;
}
public boolean canConvert(Class type) {
return type.equals(GregorianCalendar.class);
}
}
And we end up with the converter being used and generating the following XML:
Additionally we want to format the importance flag not with a technical true or false, but with a
natural yes or no. Fortunately the BooleanConverter supports alternate format styles, but how can we
use an annotation to register a new instance locally? The XStreamConverter annotation uses some lightweight dependency
injection mechanism to match given arguments with the parameters of available constructors. That way we can write now:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
@XStreamImplicit(itemFieldName="part")
private List<String> content;
@XStreamConverter(value=BooleanConverter.class, booleans={false}, strings={"yes", "no"})
private boolean important;
@XStreamConverter(SingleValueCalendarConverter.class)
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, boolean important, String... content) {
this.messageType = messageType;
this.important = important;
this.content = Arrays.asList(content);
}
}
The BooleanConverter has an additional constructor with two string values expressing true and
false and a third argument to ignore case of these values. Therefore we have added all 3 arguments to the
annotation. The sequence of the arguments is only important for same types. As result we have now:
All you need to do is add the @XStreamAsAttribute annotation:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamAlias("type")
@XStreamAsAttribute
private int messageType;
@XStreamImplicit(itemFieldName="part")
private List<String> content;
@XStreamAsAttribute
@XStreamConverter(value=BooleanConverter.class, booleans={false}, strings={"yes", "no"})
private boolean important;
@XStreamConverter(SingleValueCalendarConverter.class)
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, boolean important, String... content) {
this.messageType = messageType;
this.important = important;
this.content = Arrays.asList(content);
}
}
Field as Text Value
Sometimes it is desirable to use a single field as text value for a XML element and all other fields should be
written as attributes. XStream delivers the ToAttributedValueConverter, that will write a type with this form:
@XStreamAlias("message")
@XStreamConverter(value=ToAttributedValueConverter.class, strings={"content"})
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
private List<String> content;
@XStreamConverter(value=BooleanConverter.class, booleans={false}, strings={"yes", "no"})
private boolean important;
@XStreamConverter(SingleValueCalendarConverter.class)
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, boolean important, String... content) {
this.messageType = messageType;
this.important = important;
this.content = Arrays.asList(content);
}
}
Unfortunately our little example does not work! Although we register the converter with the
XStreamConverter annotation and provide with its arguments the field name, the conversion will fail later on. To use
this converter you have to respect the implicit requirement: Any field (derived or not) has to be expressed as a
single string i.e. technically XStream has to use a SingleValueConverter. In our case we have a list of strings that
prevent the conversion. Therefore we have to use either a custom converter that transforms this list into a single
string or we use for simplicity a simple string here:
@XStreamAlias("message")
@XStreamConverter(value=ToAttributedValueConverter.class, strings={"content"})
class RendezvousMessage {
@XStreamAlias("type")
private int messageType;
private String content;
@XStreamConverter(value=BooleanConverter.class, booleans={false}, strings={"yes", "no"})
private boolean important;
@XStreamConverter(SingleValueCalendarConverter.class)
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, boolean important, String content) {
this.messageType = messageType;
this.important = important;
this.content = content;
}
}
Now it is possible to generate this XML:
<message type="15" important="no" created="1154097812245">This is the message content.</message>
Note, that no XStreamAsAttribute annotations were necessary. The converter assumes it implicitly.
Omitting Fields
Sometimes a class may contain elements that should not be part of the resulting XML. In our case we may now drop
the 'messageType', since we are only interested at the content. This is easy using the @XStreamOmitField annotation:
@XStreamAlias("message")
class RendezvousMessage {
@XStreamOmitField
private int messageType;
@XStreamImplicit(itemFieldName="part")
private List<String> content;
@XStreamConverter(value=BooleanConverter.class, booleans={false}, strings={"yes", "no"})
private boolean important;
@XStreamConverter(SingleValueCalendarConverter.class)
private Calendar created = new GregorianCalendar();
public RendezvousMessage(int messageType, boolean important, String... content) {
this.messageType = messageType;
this.important = important;
this.content = Arrays.asList(content);
}
}
The resulting XML does not contain the type of the message anymore:
Until now we have always told you, that you have to call processAnnotation to configure the XStream instance with
the present annotations in the different classes. However, this is only half the truth. You can run XStream also in a
lazy mode, where it auto-detects the annotations while processing the object graph and configure the XStream instance
on-the-fly:
package com.thoughtworks.xstream;
public class Tutorial {
public static void main(String[] args) {
XStream stream = new XStream();
xstream.autodetectAnnotations(true);
RendezvousMessage msg = new RendezvousMessage(15);
System.out.println(stream.toXML(msg));
}
}
The resulting XML will look as expected! Nevertheless you have to understand the implications, therefore some words
of warning:
Chicken-and-egg problem
An XStream instance caches all class types processed for annotations. Every time XStream converts an object it will
in auto-detection mode first process the object's type and all the types related (as explained
above). Therefore it is no problem to serialize an object graph into XML, since XStream will
know of all types in advance. This is no longer true at deserialization time. XStream has to know the alias to turn
it into the proper type, but it can find the annotation for the alias only if it has processed the type in advance.
Therefore deserialization will fail if the type has not already been processed either by having called XStream's
processAnnotations method or by already having serialized this type. However, @XStreamAlias is the only annotation
that may fail in this case.
Concurrency
XStream is not thread-safe while it is configured, thread-safety is only guaranteed during marshalling and
unmarshalling. Unfortunately an annotation is defining a change in configuration that is now applied while object
marshalling is processed. Therefore will the auto-detection mode turn XStream's marshalling process in a thread-unsafe
operation. While XStream synchronizes the configuration modification, it cannot guard concurrent reads and you may run
under certain circumstances into concurrency problems.
Exceptions
XStream uses a well-defined exception hierarchy. Normally an InitializationException is only thrown while XStream
is configured. If annotations are processed on the fly they can be thrown obviously also in a marshalling process.
Performance
In auto-detection mode XStream will have to examine any unknown class type for annotations. This will slow down the
marshalling process until all processed types have been examined once.
Please note, that any call to XStream.processAnnotations will turn off the auto-detection mode.
Summing up
The XStream annotations support might help you configuring your class mappings in some ways, as the custom
configuration will appear in your types, but might not be the solution for other problems, i.e. when you need to map
the same type to two different XML 'standards'. Others might claim that the configuration should be clearly stated in
a Java class and not mixed with your model, its up to you to pick the best approach in your case: Annotations or
direct method calls to the XStream instance. Annotations do not provide more functionality, but may improve
convenience.
All dependencies are optional, XStream uses since version 1.4.1 by default xpp3:xpp3_min and xmlpull:xmlpull.
However it depends on the use case. XStream will run without dependencies using the DOM driver on all Java runtimes
or the StAX driver in combination with Java 6 or greater. See the list of optional dependencies.
Does XStream behave differently across different JVMs?
XStream has two modes of operation: Pure Java and Enhanced. In pure Java mode,
XStream behaves in the same way across different JVMs, however its features are limited to what
reflection allows, meaning it cannot serialize certain classes or fields. In enhanced mode,
XStream does not have these limitations, however this mode of operation is not available to all JVMs.
Which JVMs allow XStream to operate in enhanced mode?
Currently on the Sun, Apple, HP, IBM and Blackdown 1.4 JVMs and onwards.
Also for Hitachi, SAP and Diablo from 1.5 and onwards.
Support for BEA JRockit starting with R25.1.0.
OpenJDK 6 is also supported.
For all other JVMs, XStream should be used in pure Java mode.
What are the advantages of using enhanced mode over pure Java mode?
Feature
Pure Java
Enhanced Mode
Public classes
Yes
Yes
Non public classes
No
Yes
Static inner classes
Yes
Yes
Non-static inner classes
No
Yes
Anonymous inner classes
No
Yes
With default constructor
Yes
Yes
Without default constructor
No
Yes
Private fields
Yes
Yes
Final fields
Yes >= JDK 1.5
Yes
Why is my application not able to create a XmlPullParser with the XppDriver since XStream 1.4?
The XML Pull Parser API defines an own mechanism to load the factory for
the available XPP implementation. XStream's XppDriver never used this lookup mechanism automatically before version
1.4, now it will. Therefore you will have to add a dependency to xmlpull
if the XPP implementation does not deliver the classes on its own. This dependency is necessary for Xpp3 in
contrast to kXML2 that contains the classes. Use the Xpp3Driver or the KXml2Driver if you want to select one of the
directly supported XPP implementation on your own without using the XPP factory. Note, that the minimal version of
kXML2 does not support the XPP factory, but can be used by the KXml2Driver.
Can I use XStream in an Android application?
XStream does work in Android 1.0, but is reported to have limited capabilities. Since XStream 1.4 Android is
treated at least as JD 5 platform, but it e.g. does not include the java.beans package. Therefore you cannot use
the JavaBeanConverter. Note, that Android provides an XML Pull Parser, therefore XStream can work without
additional dependencies.
Why does XStream fail on Apache Harmony?
Since JDK 5 it is possible according the Java specification to write into final fields using reflection. This is not yet
supported by Harmony and therefore the PureJavaReflectionProvider fails. We have also already investigated into
enhanced mode in Harmony, but the Harmony JVM crashed running the unit tests. However, Harmony has been retired,
we will no longer make any efforts in this direction.
Are there plans to provide enhanced mode support to other JVMs?
Yes. Let us know which JVM you would like supported.
When should I use XStream not in enhanced mode?
Running XStream in a secured environment can prevent XStream from running in enhanced mode. This is
especially true when running XStream in an applet. You may also try to use the JavaBeanConverter as alternative to
the ReflectionConverter running in enhanced or pure Java mode.
Which permissions does XStream need when running with an active SecurityManager?
This depends on the mode XStream is running in. Refer to the
SecurityManagerTest
for details.
Why does XStream 1.2 no longer read XML generated with XStream 1.1.x?
The architecture in XStream has slightly changed. Starting with XStream 1.2 the
HierarchicalStreamDriver
implementation is responsible to ensure that XML tags and attributes are valid names in XML, in XStream 1.1.x
this responsibility was part of the ClassMapper implementations. Under some rare circumstances this will result in
an unreadable XML due to the different processing order in the workflow of such problematic tag names.
You can run XStream in 1.1 compatibility mode though:
XStream 1.3 ignores suddenly annotated converters (@XStreamConverter and @XStreamConverters)?
XStream treats now all annotations the same and therefore it no longer auto-detects any annotation by
default. You can configure XStream to run in auto-detection mode, but be aware if the
implications. As alternative you might register the
deprecated AnnotationReflectionConverter, that was used for XStream pre 1.3.x, but as drawback the functionality
to register a local converter with XStream.registerLocalConverter will no longer work.
XStream 1.3 suddenly has a different field order?
Yes. This was announced with the last 1.2.x release and was done to support the type inheritance of XML schemas. However, XStream is delivered with the
XStream12FieldKeySorter that can be used to
sort the fields according XStream 1.2.2.
Serialization
Which class types can be serialized by XStream?
In contrast to the JDK XStream is not tied to a marker interface to serialize a class. XStream ships with some specialized converters,
but will use reflection by default for "unknown" classes to examine, read and write the class' data. Therefore XStream can handle quite any class, especially
the ones referred as POJO (Plain Old Java Object).
However, some types of classes exist with typical characteristics, that cannot be handled - at least not out of the box:
Objects that are based on threads or thread local data: Thread, Timer, ThreadLocal and so on. These classes keep different data for different threads and there's
no possibility to recreate a thread in a generic way nor recreating thread specific data. There might be special use cases, but this will always involve a custom converter
where threads can be recreated in a specific way tied to that use case.
Class types that are based on generated classes. Such types have often names that are unique to the current process and will have no meaning
in a different process. A custom converter might help to write the appropriate data into the serializing stream to be able to recreate a equivalent class at deserialization
time.
Types that keep and use system resources like file handles, sockets, pipes and so on. ClassLoader, FileInputStream, FileOutputStream, Socket and so on. To
deserialize such a class the converter must be able to claim the appropriate resource from the system again. With the help of a custom converter this might be
possible, but with the reflection converter the deserialized class might refer a system resource that is no longer valid or belongs to somebody else. Behavior is
undefined then.
A very special case of such allocated system resources are those classes that keep handles to system memory directly, because they are partly implemented native.
It is known to be true for the Linux version of Sun's JDK that the BufferedImage references some system specific types of the JDK that themselves have member fields
with such memory handles. While it is possible at first sight to serialize and deserialize a BufferedImage, the reflection converter will also duplicate the memory handle.
As a result the JVM might crash easily because of freeing unallocated memory or freeing the same memory twice. It might be possible to create a custom converter,
but the data structure is really complex in this area and nobody has been investigating so far to such an extent. However, do not use the reflection converter
for these types! You have been warned!
Inner class types of the JDK can often vary in implementation details between JDK versions and vendors and are therefore only compatible for the same JDK. This
includes collection types returned by the methods of the Collections class that wrap another one (like unmodifiableList) or the collections that are returned by the
different Map implementations for the keySet(), entrySet() and values() methods.
How do I specify that a field should not be serialized?
Make it transient, specify it with XStream.omitField() or
annotate it with @XStreamOmitField
How do I initialize a transient field at deserialization?
XStream uses the same mechanism as the JDK serialization. Example:
Use the latter in class hierarchies, readResolve is not called for base classes.
XStream is not calling the default constructor during deserialization.
This is, in fact, the same case as above. XStream uses the same mechanism as the JDK serialization. When using
the enhanced mode with the optimized reflection API, it does not invoke the default constructor. The solution is to
implement the readResolve or readObject as demonstrated with the last question.
Note, that it is possible to configure XStream to omit the container element toys using implicit collections.
My implicit collection is suddenly null after deserialization instead of empty!
By declaring a collection as implicit, the result will have no direct representation of the collection container
itself anymore. Therefore, if the collection was empty at serialization time, the serialized result does not
contain a trace of the collection anymore. At deserialization time it will therefore not know anything about the
collection and will not initialize it. XStream cannot decide anyway at deserialization time, if the collection was
empty or null.
The type of my implicit collection is different after deserialization.
By declaring a collection as implicit, the result will have no direct representation of the collection container
itself anymore. Therefore XStream cannot track the original type of the collection. At deserialization time it will
therefore look at the declaration type of the field that holds the collection and use this type's default
implementation, e.g. for a List this is by default an ArrayList.
Beware, that this also means that collections with additional information (e.g. a TreeSet with a Comparator)
cannot be restored, since the comparator was already omitted at serialization time.
Do my classes have to implement Serializable if XStream is to serialize them?
No, but XStream respects the Java serialization methods even for types not declared as Serializable.
Can dynamic proxies be serialized?
Yes.
Can CGLIB proxies be serialized?
Only limitedly. A proxy generated with the CGLIB Enhancer is supported, if the proxy uses either a factory or
only one callback. Then it is possible to recreate the proxy instance at unmarshalling time. Starting with XStream 1.3.1
CGLIB support is no longer automatically installed because of possible classloader problems and side-effects,
because of incompatible ASM versions. You can enable CGLIB support with:
XStream xstream = new XStream() {
protected MapperWrapper wrapMapper(MapperWrapper next) {
return new CGLIBMapper(next);
}
};
xstream.registerConverter(new CGLIBEnhancedConverter(xstream.getMapper(), xstream.getReflectionProvider()));
CGLIBEnhancedConverter fails at initialization with ExceptionInInitializerError
This is not a problem of XStream. You have incompatible ASM versions in your classpath. CGLIB 2.1.x and below is based on
ASM 1.5.x which is incompatible to newer versions that are used by common packages like Hibernate, Groovy or Guice. Check
your dependencies and ensure that you are using either using cglib-nodep-2.x.jar instead of cglib-2.x.jar or update to
cglib-2.2.x that depends on ASM 3.1. However, the nodep version contains a copy of the ASM classes with private
packages and will therefore not raise class incompatibilities at all.
Serialization fails with NoSuchMethodError: net.sf.cglib.proxy.Enhancer.isEnhanced(Ljava/lang/Class;)Z
XStream uses this method to detect a CGLIB-enhanced proxy. Unfortunately the method is not available in the
cglib-2.0 version. Since this version is many years old and the method is available starting with cglib-2.0.1, please
consider an upgrade of the dependency, it works usually smoothly.
How do I use XStream's Hibernate package to serialize my objects?
Support of Hibernate enhanced collections and proxied types. To drop the internals of Hibernate when marshalling
such objects to XStream, all converters and the mapper has to be registered for the XStream instance:
final XStream xstream = new XStream() {
protected MapperWrapper wrapMapper(final MapperWrapper next) {
return new HibernateMapper(next);
}
};
xstream.registerConverter(new HibernateProxyConverter());
xstream.registerConverter(new HibernatePersistentCollectionConverter(xstream.getMapper()));
xstream.registerConverter(new HibernatePersistentMapConverter(xstream.getMapper()));
xstream.registerConverter(new HibernatePersistentSortedMapConverter(xstream.getMapper()));
xstream.registerConverter(new HibernatePersistentSortedSetConverter(xstream.getMapper()));
My attributes are interpreted by XStream itself and cause unexpected behavior
XStream's generic converters and the marshalling strategies use a number of attributes on their own. Especially the attributes named
id, class and reference are likely to cause such collisions. Main reason is XStream's history, because
originally user defined attributes were not supported and all attribute were system generated. Starting with XStream 1.3.1 you can redefine
those attributes to allow the names to be used for your own ones. The following snippet defines XStream to use different system attributes
for id and class while the field id of YourClass is written into the attribute class:
Can I select the field order in which XStream serializes objects?
Yes. XStream's ReflectionConverter uses the defined field order by default. You can override it by using an specific FieldKeySorter:
SortableFieldKeySorter sorter = new SortableFieldKeySorter();
sorter.registerFieldOrder(MyType.class, new String[] { "firstToSerialize", "secondToSerialize", "thirdToSerialize" });
xstream = new XStream(new Sun14ReflectionProvider(new FieldDictionary(sorter)));
How does XStream deal with newer versions of classes?
If a new field is added to the class, deserializing an old version will leave the field uninitialized.
If a field is removed from the class, deserializing an old version that contains the field will cause an exception.
Leaving the field in place but declaring it as transient will avoid the exception, but XStream will not try to deserialize it.
If a class is renamed, aliases can be used to create an abstraction between the name used in XML and the real class name.
If a field is renamed, this should be treated as adding a field and removing a field.
For more advanced class migrations, you may
have to do custom pre-processing of the XML before sending it to XStream (for example, with XSLT or DOM manipulations)
declare new fields as transient
implement your own converter, that can handle the situation
add a readResolve() method to your class, that initializes the object accordingly
implement a custom mapper to ignore unknown fields automatically
(see acceptance test CustomMapperTest.testCanBeUsedToOmitUnexpectedElements())
Future versions of XStream will include features to make these type of migrations easier.
How does XStream cope with isolated class loaders?
Serializing an object graph is never a problem, even if the classes of those objects have been loaded by
a different class loader. The situation changes completely at deserialization time. In this case you must set the
class loader to use with:
xstream.setClassLoader(yourClassLoader);
Although XStream caches a lot of type related information to gain speed, it keeps those information in
tables with weak references that should be cleaned by the garbage collector when the class loader is freed.
Note, that this call should be made quite immediately after creating the XStream and before any other
configuration is done. Otherwise configuration based on special types might refer classes loaded with the wrong
classloader.
XML specifics
Why does XStream not respect the encoding in the XML declaration?
XStream architecture is based on IO Readers and Writers, while the XML declaration is the responsibility of XML
parsers. All HierarchicalStreamDriver
implementations respect the encoding since version 1.3, but only if you provide an
InputStream. If XStream consumes a
Reader you have to initialize the reader with
the appropriate encoding yourself, since it is now the reader's task to perform the encoding and no XML parser can
change the encoding of a Reader and any encoding definition in the XML header will be ignored.
Why does XStream not write an XML declaration?
XStream is designed to write XML snippets, so you can embed its output into an existing stream or string.
You can write the XML declaration yourself into the Writer before using it to call XStream.toXML(writer).
Why does XStream not write XML in UTF-8?
XStream does no character encoding by itself, it relies on the configuration of the underlying XML writer.
By default it uses its own PrettyPrintWriter which writes into the default encoding of the current locale. To write
UTF-8 you have to provide a Writer
with the appropriate encoding yourself.
Why do field names suddenly have double underscores in the generated XML?
XStream maps Java class names and field names to XML tags or attributes. Unfortunately this mapping cannot
be 1:1, since some characters used for
identifiers in Java are invalid in XML names. Therefore
XStream uses an XmlFriendlyNameCoder
to replace these characters with a replacement. By default this
NameCoder uses an underscore as escape
character and has therefore to escape the underscore itself also. You may provide a different configured instance
of the XmlFriendlyNameCoder or a complete different implementation like the
NoNameCoder to prevent name coding
at all. However it is your responsibility then to ensure, that the resulting names are valid for XML.
XStream fails to unmarshal my given XML and I do not know why?
By default XStream is written for persistence i.e. it will read the XML it can write. If you have to transform
a given XML into an object graph, you should go the other way round. Use XStream to transfer your objects into XML.
If the written XML matches your schema, XStream is also able to read it. This way is much easier, since you can
spot the differences in the XML much more easy than to interpret the exceptions XStream will throw if it cannot
match the XML into your objects.
My parser claims the � character to be invalid, but it was written with XStream!
Your parser is basically right! A character of value 0 is not valid as part of XML according the XML specification (see
version 1.0 or
1.1), neither directly nor as character
entity nor within CDATA. But not every parser respects this part of the specification (e.g. Xpp3 will ignore it and read
character entities). If you expect such characters in your strings and you do not use the Xpp3 parser, you should consider
to use a converter that writes the string as byte array in Base64 code. As alternative you may force the
PrettyPrintWriter or derived writers
to be XML 1.0 or 1.1. compliant, i.e. in this mode a StreamException is thrown.
My parser claims a control character to be invalid, but it was written with XStream!
Your parser is probably right! Control characters are only valid as part of XML 1.1. You should add an XML header
declaring this version or use a parser that does not care about this part of the specification (e.g. Xpp3 parser).
Why is my element not written as XML attribute although I have configured it?
You can only write types as attributes that are represented as a single String value and are handled therefore
by SingleValueConverter implementations. If your type is handled by a Converter implementation, the configuration
of XStream to write an attribute (using XStream.useAttributeFor() or @XStreamAsAttribute) is simply ignored.
Why are whitespace characters wrong in my attribute values after deserialization?
This is part of the XML specification and a required functionality for any XML parser called
attribute value normalization. It cannot
be influenced by XStream. A compliant XML parser will replace by default real tab, carriage return and line feed
characters with normal spaces. If you want to keep these characters you will have to encode them with entities.
Why does XStream not have any namespace support?
Not every XML parser supports namespaces and not every XML parser that supports namespaces can be configured
within XStream to use those. Basically namespaces must be supported individually for the different XML parsers and the
only support for namespaces that has currently been implemented in XStream is for the StAX paser. Therefore use and
configure the StaxDriver of XStream to use namespaces.
My XML contains XPath expressions in the references, but they seem not to work?
XStream generates only XPath compliant expressions. These have a very limited syntax and they are the only ones
that can be interpreted at deserialization again, since XStream does not use an XPath interpreter. Therefore there
is no support for attribute selectors, qualified element access with axis names or functions. For real XPath
support you will have to implement your own MarshallingStrategy.
The XPath expressions in the references do select a list, but not a single node!
Yes, this is right. However, the result type of an
XPath expression
evaluation can be defined. A node result from a node list is the lists first node, therefore the XPath of XStream
is compliant. Since XStream does not use a real XPath engine, you do not have to worry about memory consumption or
wasted evaluation time, XStream will always operate on a single node anyway. Since XStream 1.4 you can force
XStream to write XPath expressions that select explicit the single node by using the new modes
XStream.SINGLE_NODE_XPATH_ABSOLUTE_REFERENCES or SINGLE_NODE_XPATH_RELATIVE_REFERENCES. Instead of generating a
path like "/doc/list/elem/field" XStream will then generate "/doc[1]/list[1]/elem[1]/field[1]". The two notations
are transparent at deserialization time.
JSON specifics
Why are there two JSON driver implementations?
As always, first for historical reasons! Main difference is that the
JettisonMappedXmlDriver is a
thin wrapper around Jettison in combination with the
StaxDriver, while the
JsonHierarchicalStreamDriver
uses an own more flexible implementation, but can only be used to generate JSON, deserialization is not implemented.
Which versions of Jettison are supported?
Users of Java 5 or higher can use Jettison 1.2 or higher, users of Java 1.4.2 have to use Jettison 1.0.1. Java
1.3 and Jettison 1.1 is not supported.
Why is it not possible to deserialize a JSON string starting with an array?
XStream's implementation to deserialize JSON is based on Jettison and StAX. Jettison implements a XMLStreamReader
of StaX and transforms the processed JSON virtually into XML first. However, if the JSON string starts with an array it is not
possible for Jettison to create a valid root element, since it has no name.
XStream fails to unmarshal my JSON string and I do not know why?
Deserialization of JSON is currently done by Jettison, that transforms the JSON string into a StAX stream.
XStream itself does nothing know about the JSON format here. If your JSON string reaches some kind of
complexity and you do not know how to design your Java objects and configure XStream to match those,
you should have a look at the intermediate XML that is processed by XStream in the end. This might help to
identify the problematic spots. Also consider then marshalling your Java
objects into XML first. You can use following code to generate the XML:
String json = "{\"string\": \"foo\"}";
HierarchicalStreamDriver driver = new JettisonMappedXmlDriver();
StringReader reader = new StringReader(json);
HierarchicalStreamReader hsr = driver.createReader(reader);
StringWriter writer = new StringWriter();
new HierarchicalStreamCopier().copy(hsr, new PrettyPrintWriter(writer));
writer.close();
System.out.println(writer.toString());
What limitations has XStream's JSON support?
JSON represents a very simple data model for easy data transfer. Especially it has no equivalent for XML
attributes. Those are written with a leading "@" character, but this is not always possible without
violating the syntax (e.g. for array types). Those may silently dropped (and makes it therefore difficult to
implement deserialization). References are another issue in the serialized object graph, since JSON has no
possibility to express such a construct. You should therefore always set the NO_REFERENCES mode of XStream.
Additionally you cannot use implicit collections, since the properties in a JSON object must have unique names.
Why are there invalid characters in my JSON representation?
The JSON spec requires any JSON string to be in UTF-8 encoding. However, XStream ensures this only if you
provide an InputStream or an OutputStream. If you provide a Reader or Writer you have to ensure this requirement
on your own.
The generated JSON is invalid, it contains a dash in the label!
Well, no, the JSON is valid! Please check yourself with the JSON syntax checker.
However, some JavaScript libraries silently assume that the JSON labels are valid JavaScript identifiers, because JavaScript
supports a convenient way to address an element, if the label is a valid JavaScript identifier:
var json = {"label": "foo", "label-with-dash": "bar"};
var fooVar = json.label; // works for labels that are JavaScript identifiers
var barVar = json["label-with-dash"]; // using an array index works always
As alternative you may wrap the JsonWriter and replace any dash with an underscore:
HierarchicalStreamDriver driver = new JsonHierarchicalStreamDriver() {
public HierarchicalStreamWriter createWriter(Writer out) {
return new WriterWrapper(super.createWriter(out)) {
public void startNode(String name) {
startNode(name, null);
}
public void startNode(String name, Class clazz) {
wrapped.startNode(name.replace('-', '_'), clazz);
}
}
}
};
XStream xstream = new XStream(driver);
Comparison to other products
How does XStream compare to java.beans.XMLEncoder?
XStream is designed for serializing objects using internal fields, whereas
XMLEncoder is designed for
serializing JavaBeans using public API methods (typically in the form
of getXXX(), setXXX(), addXXX() and removeXXX() methods.
How does XStream compare to JAXB (Java API for XML Binding)?
JAXB is a Java binding tool. It generates Java code from a schema and you are able to transform from those classes into
XML matching the processed schema and back. Note, that you cannot use your own objects, you have to use what is
generated.
Scalability
Is XStream thread safe?
Yes. Once the XStream instance has been created and configured, it may be shared across multiple threads
allowing objects to be serialized/deserialized concurrently (unless you enable the
auto-detection to process annotations on-the-fly). Actually the
creation and initialization of XStream is quite expensive, therefore it is recommended to keep the XStream instance
itself.
How much memory does XStream consume?
This cannot be answered in general, but following topics have impact on the memory:
XML parser technology in use: You should use a streaming parser like Xpp3 or StAX. DOM-based
parsers process the complete XML and create their document model in memory before the first converter of XStream
is called.
Your object model: Is it necessary to keep the complete object graph in memory at once. As alternative you might
use object streams or write custom converters that can load and save objects of your
object model on the fly without adding them to the object graph physically. As example see the implementation of the
XmlArrayList in combination with the
FileStreamStrategy to keep
parts of the object graph separate.
References: By default XStream supports references to the same object in an object graph. This implies that XStream
keeps track of all serialized and deserialized objects internally. These references are kept with WeakReferences, so that the
memory can be freed as soon as nobody references these objects anymore.
XML values: Any tag and attribute value that is converted into a Java String in the object graph will use by default the
same String instance unless it exceeds 38 characters (length of a UUID string representation).
XStream caches: To increase performance XStream caches quite a lot like classes, converters to use, aliasing, tag names.
All those caches make usage of WeakReferences or will exist only while marshalling one object graph resp. unmarshalling one
input stream.
Can the performance of XStream be increased?
XStream is a generalizing library, it inspects and handles your types on the fly. Therefore it will normally be slower than
a piece of optimized Java code generated out of a schema. However, it is possible to increase the performance anyway:
Write custom converters for those of your types that occur very often in your XML.
Keep a configured XStream instance for multiple usage. Creation and initialization is quite expensive compared to the
overhead of XStream when calling marshall or unmarshal.
Use Xpp3 or StAX parsers.
Note, you should never try to optimize code for performance simply because you believe that you
have detected a bottle neck. Always use proper tools like a profiler to verify where your hotspots are and whether your
optimization was really successful or not.
Uses of XStream
Is XStream a data binding tool?
No. It is a serialization tool.
Can XStream generate classes from XSD?
No. For this kind of work a data binding tool such as XMLBeans is appropriate.
Why is there no SaxReader?
XStream works on a stream-based parser model, while SAX is event-based. The stream based model implies, that the
caller consumes the individual tokens from the XML parser on demand, while in an event-based model the parser
controls the application flow on its own and will use callbacks to support client processing. The different
architecture makes it therefore impossible for XStream to use an event-driven XML parser.
The architecture of XStream consists of the four main components:
Converters
Drivers (Writer and Reader)
Context
Facade
Converters
Whenever XStream encounters an object that needs to be converted to/from XML, it delegates to a suitable
Converter implementation associated
with the class of that Object.
XStream comes bundled with many converters for common types, including primitives,
String, Collections, arrays, null, Date, etc.
XStream also has a default Converter, that is used when no other Converters match a type. This uses
reflection to automatically generate the XML for all the fields in an object.
If an object is composed of other objects, the Converter may delegate to other Converters.
To customize the XML for particular object type a new Converter should be implemented.
This abstraction allows XStream to read XML from direct streams using an XML parser or directly manipulate
existing structures (such as DOM). This prevents the overhead of having to reparse if XStream is working from
XML that has been partially processed by other libraries (for instance a SOAP library). It also avoids tying XStream
to a particular library.
Writer and Readers can be implemented allowing XStream to serialize to most XML APIs.
Writers and Readers can also be created around tree based non XML structures.
Context
When XStream serializes or deserializes some objects, it creates a
MarshallingContext or
UnmarshallingContext,
which handle the traversing of the data and delegation to the necessary Converters.
The MarshallingContext/UnmarshallingContext is made available to converters allowing them
to tell XStream to process objects contained within other objects.
XStream provides three pairs of context implementations that traverse the object graph with slightly
different behaviors. The default can be changed using
XStream.setMode(), passing in one of
the following parameters:
XStream.XPATH_RELATIVE_REFERENCES (Default) Uses relative XPath references to signify duplicate references. This produces XML with
the least clutter.
XStream.XPATH_ABSOLUTE_REFERENCES
Uses absolute XPath references to signify duplicate references. This might produce for some situations
better readable XML. Note, that XStream will read XML with relative paths as well as with absolute
paths independent of the XPATH mode.
XStream.ID_REFERENCES
Uses ID references to signify duplicate references. In some scenarios, such as when using hand-written
XML, this is easier to work with.
XStream.NO_REFERENCES
This disables object graph support and treats the object structure like a tree. Duplicate references are
treated as two separate objects and circular references cause an exception. This is slightly faster and
uses less memory than the other two modes.
A new context is created for each object graph that is serialized. Both the
MarshallingContext and
UnmarshallingContext
implement DataHolder,
a hash table passed around whilst processing the object graph that can be used as the user sees fit (in a similar
way that the HttpServletRequest attributes are used in a web-application).
XStream facade
The main XStream class is typically used as the
entry point. This assembles the necessary components of XStream (as described above; Context, Converter,
Writer/Reader and ClassMapper) and provides a simple to use API for common operations.
Remember, the XStream class is just a facade - it can always be bypassed for more advanced
operations.
XStream provides alternative implementations of java.io.ObjectInputStream and
java.io.ObjectOutputStream,
allowing streams of objects to be serialized or deserialized from XML.
This is useful when processing large sets of objects, as only one needs to be in memory
at a time.
Obviously you should use also a stream-based XML parser reading the XML. A DOM-based XML parser
will process the complete XML and build the object model before XStream is able to to handle the first
element.
Using the Object Streams
The interface to the object streaming capabilities of XStream is through the standard
java.io.ObjectOutputStream and java.io.ObjectInputStream objects.
ObjectInputStream in = xstream.createObjectInputStream(someReader);
Person a = (Person)in.readObject();
Person b = (Person)in.readObject();
String c = (String)in.readObject();
int d = in.readInt();
Considerations
Root node
Because an XML document can only have a single root node, all the serialized elements must be wrapped in an
additional root node. This root node defaults to <object-stream>, as shown in the example above.
This can be changed by using the overloaded method:
xstream.createObjectOutputStream(Writer writer, String rootNodeName);
Close the ObjectOutputStream
Remember to call ObjectOutputStream.close(), otherwise the stream will contain incomplete XML.
Detecting the end of the ObjectInputStream
When there are no more objects left to read in the stream, ObjectInputStream.readObject() (or primitive
equivalent) will throw java.io.EOFException.
References
Normally XStream will not know about references between the different objects that are written individually in the ObjectStream.
Nevertheless there is an example in the acceptance tests (MultipleObjectsInOneStreamTest) where such a functionality is realized with
the help of a custom MarshallingStrategy. Note, that this implementation is not for general use, since it will ignore some parameters at
second invocation, but they do not matter in the demonstrated use case. Additionally those references prevent the objects from being
garbage collected, which is a bit counter-productive for the use case of ObjectStreams as described above. So you have to know what
you do!
This is a very quick introduction to XStream.
Skim read it to get an idea of how simple it is to convert objects to XML and back again.
I'm sure you'll have questions afterwards.
Create classes to be serialized
Here's a couple of simple classes. XStream can convert instances of these to XML and back again.
public class Person {
private String firstname;
private String lastname;
private PhoneNumber phone;
private PhoneNumber fax;
// ... constructors and methods
}
public class PhoneNumber {
private int code;
private String number;
// ... constructors and methods
}
Note: Notice that the fields are private. XStream doesn't care about the
visibility of the fields. No getters or setters are needed. Also, XStream
does not limit you to having a default constructor.
Initializing XStream
To use XStream, simply instantiate the XStream class:
XStream xstream = new XStream();
You require xstream-[version].jar, xpp3-[version].jar and
xmlpull-[version].jar in the classpath. Xpp3
is a very fast XML pull-parser implementation. If you do not want to include these dependencies, you can use a standard
JAXP DOM parser or since Java 6 the integrated StAX parser instead:
XStream xstream = new XStream(new DomDriver()); // does not require XPP3 library
XStream xstream = new XStream(new StaxDriver()); // does not require XPP3 library starting with Java 6
Note: This class is a simple facade designed for common operations. For more flexibility you
may choose to create your own facade that behaves differently.
Now, to make the XML outputted by XStream more concise, you can create aliases for your custom class names
to XML element names. This is the only type of mapping required to use XStream and even this is optional.
Note: This is an optional step. Without it XStream would work fine, but the XML element names would
contain the fully qualified name of each class (including package) which would bulk up the XML a bit. See the
Alias Tutorial a more complete introduction.
Serializing an object to XML
Let's create an instance of Person and populate its fields:
Person joe = new Person("Joe", "Walnes");
joe.setPhone(new PhoneNumber(123, "1234-456"));
joe.setFax(new PhoneNumber(123, "9999-999"));
Now, to convert it to XML, all you have to do is make a simple call to XStream:
Create element name to class name aliases for any custom classes using xstream.alias(String elementName, Class cls);
Convert an object to XML using xstream.toXML(Object obj);
Convert XML back to an object using xstream.fromXML(String xml);
maybe you like to read the alias tutorial to see more possibilities how you can rename things using XStream.
Or look into the condensed overview how to configure XStream to tweak the output.
Out of the box, XStream is able to serialize most objects without the need for custom mappings to be setup.
The XML produced is clean, however sometimes it's desirable to make tweaks to it. The most common use for this is
when using XStream to read configuration files and some more human-friendly XML is needed.
Modification by configuration
A big part of the standard output of XStream can be configured. It is possible to set aliases for class types
and field names that are mapped to XML tag or attribute names. Objects that can be represented as simple string
value can be written as attributes. It is possible to omit fields or to flatten the structure for collections.
Aliases
Aliases offer a simple way to use different tag or attribute names in the XML. The simplest and most commonly
used tweak in XStream is to alias a fully qualified class to a shorter name. Another use case is a different field name
for a class member. Aliases can be set for following elements:
Class types mapped to XML tags
Package names mapped to XML tags
Field names mapped to XML tags
Internal attributes names of XStream
The bold elements in the following example are affected:
XML is quite clumsy to read for fields in separate tags that can represent their content in a short single
string value. In such a case attributes can help to shorten the XML and increase readability:
For a proper deserialization XStream has to write the complete object graph into XML that is referenced by a
single object. Therefore XStream has to find a representation that contains all aspects to recreate the
objects.
However, some parts might be superfluous e.g. if a member field is lazy initialized and its content
can be easily recreated. In such a case a field can be omitted using
XStream.omitField(Class, String).
Implicit Collections, Arrays and Maps
Another use case are collections, arrays and maps. If a class has a field that is a one of those types, by
default all of its elements are embedded in an element that represents the container object itself. By
configuring the XStream with the
XStream.addImplicitCollection(),
XStream.addImplicitArray(), and
XStream.addImplicitMap() methods it
is possible to keep the elements directly as child of the class and the surrounding tag for the container object
is omitted. It is even possible to declare more than one implicit collection, array or map for a class, but
the elements must then be distinguishable to populate the different containers correctly at deserialization.
In the following example the Java type representing the farm may have two containers, one for cats and one
for dogs:
The container might be a Collection, Array, or even a Map. In the latter case a member field of the value
must have been defined, that is used as key in the deserialized map.
Field order
XStream is delivered with a lot of converters for standard types.
Nevertheless most objects are processed by converters based on reflection. They will write the fields of a
class in the sequence they are defined. It is possible to implement an algorithm for a different sequence or
use an implementation that allows to define the sequence for each type separately using a
FieldKeySorter.
Similar functionality exists for Java Beans with the
PropertySorter.
Output Format
XStream writes and reads XML by default. However, the I/O layer is separated from the model and you can
use implementations for other formats as well. A reader/writer pair is typically managed by a HierarchicalStreamDriver. XStream
is delivering additional drivers for JSON and a compact binary format (see BinaryStreamDriver). There are
also drivers to write an object graph into a DOM structure instead of a text based stream (available for W3C
DOM, DOM4J, JDOM, XOM, and XPP DOM).
Enhancing XStream
Sometimes customization is simply not enough to tweak the output. Depending on the use case it is fortunate to
use specialized converters for own types, mapper implementations that control naming of things more globally or
use specialized writers to influence the complete output.
Specialized Converters
Not all converters that are part of the XStream package are automatically registered. Some will only make
sense for special types, others have parameters to tweak the behaviour. Most useful in the table of
converters are the JavaBeanConverter, ToStringConverter, and
ToAttributedValueConverter. Not to mention the separate Hibernate package of XStream.
As example can the ToAttributedValueConverter be used to define the owner's name directly as text value:
Sometimes the object to serialize contains fields or elements, that have no friendly representation for
human beings e.g. if a long value represents in reality a time stamp. In such cases XStream supports custom
converters for arbitrary types. Have a look at the Converter Tutorial
for advanced possibilities. Note, that a custom converter is not different to one that is delivered by
XStream. It's simply your code.
Custom Mappers
In case of global adjustments it can be helpful to implement an own mapper. A mapper is used to name things
and map between the name in the Java world to the name used in the XML representation. The alias mechanism
described above is implemented as such a mapper that can be configured. A typical use case is dropping all
prefixes for field names like underscores in the resulting XML or omitting the package part of class names.
However, keep in mind that the algorithm must work in both directions to support deserialization.
Custom Name Coders
Names used e.g. in XML for attributes and element tags might contain characters or character sequences that
violate the syntax of the output format. Instead of using different aliases for such names that depend on the
output format, you may use a NameCoder implementation that transforms an internally used name to an external
form. For XML we use e.g. a NameCoder that encodes '$' characters, while the one used in JSON performs no
operation at all.
Again, keep in mind that the algorithm of the name coder must support encoding and
decoding of the names.
Custom Writer
A custom writer can be used to affect the output completely. XStream itself delivers solutions for different
use cases like the CompactWriter
that does not insert any white spaces between the XML tags.
Another use case for such a writer is a wrapper to drop unwanted XML elements that XStream omits on its own.
Especially if the written XML is not used for deserialization it can be useful to ignore internal attributes by
a custom writer
Tweaking the own implementation
As shown, XStream can be configured and enhanced in multiple way, but sometimes it is easier to tweak the
implementation of the serialized classes:
Declaring a field transparent will omit it automatically from the processing
Implementing a readResolve method that can be used to initialize additional fields
Usage of annotations
Preprocessing or postprocessing
XML Transformations
Never forget, you're dealing with XML! It is easy to transform XML with an XSLT. XStream is delivered with a SAXSource
implementation, that allows an XStream instance to be the source of a XML transformer.
It is used here to remove the age of the cat on the fly (assuming XSLT is a string with the stylesheet above):
XStream xstream = new XStream();
xstream.alias("cat", Cat.class);
TraxSource traxSource = new TraxSource(new Cat(4, "Garfield"), xstream);
Writer buffer = new StringWriter();
Transformer transformer = TransformerFactory.newInstance().newTransformer(
new StreamSource(new StringReader(XSLT)));
transformer.transform(traxSource, new StreamResult(buffer));
The result in the buffer:
<cat>
<mName>Garfield</mName>
</cat>
Format Conversion
XStream is designed to transform Java objects into a specific format and recreate these objects again.
However, XStream's readers and writers are based on an event model that can be used easily to convert the pure
data between formats. XStream contains the HierarchicalStreamCopier
tool that utilizes a reader and a writer of XStream to perform the conversion:
HierarchicalStreamCopier copier = new HierarchicalStreramCopier();
HierarchicalStreamDriver binaryDriver = new BinaryDriver();
HierarchicalStreamDriver jsonDriver = new JettisonMappedXmlDriver();
// transform a org.dom4j.Document into a binary stream of XStream
ByteArrayOutputStream baos = new ByteArrayOutputStream();
copier.copy(new Dom4JDriver.createReader(dom4JDocument), binaryDriver.createWriter(baos));
byte[] data = baos.getBytes();
// transform binary XStream data into JSON
StringWriter strWriter = new StringWriter();
copier.copy(binaryDriver.createReader(data), jsonDriver.createWriter(strWriter));
String json = strWriter.toString();
// transform JSON into XML:
strWriter = new StringWriter();
copier.copy(jsonDriver.createReader(new StringReader(json)), new PrettyPrintWriter(strWriter));
String xml = strWriter.toString();
The core of XStream consists of a registry of
Converters. The responsibility of a Converter is to
provide a strategy for converting particular types of objects found in the object graph, to and from XML.
XStream is provided with Converters for common types such as primitives, String, File, Collections, arrays,
and Dates.
This is only available under Java 1.4 or greater. It retains the full stack trace, including that of any
nested exceptions. The stack trace elements are handled by the
StackTraceElementConverter.
Because the Properties class only accepts Strings for keys and values, the XML can be more concise.
If the Properties instance includes a set of default Properties, these are serialized in a nested <defaults> element.
This converter will look for the class in the ClassLoader of the current XStream instance. It is possible
to use another ClassLoader by re-registering a new instance of this converter that is wrapped around another
ClassLoader.
As with the JavaClassConverter, the converter will use the ClassLoader of the XStream instance to resolve classes
by default. This can be changed by specifying another ClassLoader when constructing this Converter.
The enclosing element for this tag will either by <method> or <constructor>. As with the JavaClassConverter, the converter
will use the ClassLoader of the XStream instance to resolve classes by default. This can be changed by specifying another ClassLoader when
constructing this Converter.
The dynamic proxy itself is not serialized, however the interfaces it implements and the actual InvocationHandler
instance are serialized. This allows the proxy to be reconstructed after deserialization.
Warning: The AWT toolkit is initialized when a Color is deserialized due to the internals of the Color class.
This should only be an issue if deserializing a Color on a headless server process.
Warning: The AWT toolkit is initialized when a Font is deserialized due to the internals of the Font class.
This should only be an issue if deserializing a Font on a headless server process.
Warning: The AWT toolkit is initialized when a TextAttribute is deserialized due to the internals of the TextAttribute class.
This should only be an issue if deserializing a TextAttribute on a headless server process.
Explicit mapping to the ReflectionConverter. Although the implementations of the LookAndFeel classes are serializable, they will
throw an exception executing writeObject(), therefore the SerializableConverter is not used.
The Converter is used as fallback. It uses reflection to examine the class and will serialize its fields and supports annotations for
local converters.
Needs JDK 1.5, default for JDK 1.5. Deprecated since XStream 1.3 and must be registered now explicitly.
The Converter must be initialized with a type, that provides a complete String representation with its toString() method
and is able to be recreated by a constructor taking a single String argument.
Must be registered explicitly for the appropriate type
The Converter can handles any type that provides a PropertyEditor implementation. The PropertyEditor's methods getAsText() and
setAsText() are used to convert between object and string representation.
Must be registered explicitly for the appropriate type.
The Converter handles proxies generated by the CGLIB Enhancer, if there were not multiple callbacks registered.
A proxy with multiple callbacks can currently not be handled at all.
Must be registered explicitly in combination with the CGLIBMapper. See FAQ.
Suppose that you need a easy way to persist some objects in the file system. Not just one, but a whole collection.
The real problem arrives when you start using java.io API in order to create one output stream for each object, showing
itself to be really painful - although simple.
Imagine that you have the following Java class, a basic Author class (stolen from some other tutorial):
package com.thoughtworks.xstream;
public class Author {
private String name;
public Author(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
By using the XmlArrayList implementation of java.util.List you get an easy way to write all authors to disk
The XmlArrayList (and related collections) receives a PersistenceStrategy during its construction. This Strategy decides
what to do with each of its elements. The basic implementation - our need - is the FilePersistenceStrategy, capable of
writing different files to a base directory.
// prepares the file strategy to directory /tmp
PersistenceStrategy strategy = new FilePersistenceStrategy(new File("/tmp"));
We can easily create an XmlArrayList from that strategy:
// prepares the file strategy to directory /tmp
PersistenceStrategy strategy = new FilePersistenceStrategy(new File("/tmp"));
// creates the list:
List list = new XmlArrayList(strategy);
Adding elements
Now that we have an XmlArrayList object in our hands, we are able to add, remove and search for objects as usual.
Let's add five authors and play around with our list:
package org.codehaus.xstream.examples;
public class AddAuthors {
public static void main(String[] args) {
// prepares the file strategy to directory /tmp
PersistenceStrategy strategy = new FilePersistenceStrategy(new File("/tmp"));
// creates the list:
List list = new XmlArrayList(strategy);
// adds four authors
list.add(new Author("joe walnes"));
list.add(new Author("joerg schaible"));
list.add(new Author("mauro talevi"));
list.add(new Author("guilherme silveira"));
// adding an extra author
Author mistake = new Author("mama");
list.add(mistake);
}
}
If we check the /tmp directory, there are five files: int@1.xml, int@2.xml, int@3.xml, int@4.xml, int@5.xml, each
one containing the XML serialized form of our authors.
Playing around
Let's remove mama from the list and iterate over all authors:
package org.codehaus.xstream.examples;
public class RemoveMama {
public static void main(String[] args) {
// prepares the file strategy to directory /tmp
PersistenceStrategy strategy = new FilePersistenceStrategy(new File("/tmp"));
// looks up the list:
List list = new XmlArrayList(strategy);
// remember the list is still there! the files int@[1-5].xml are still in /tmp!
// the list was persisted!
for(Iterator it = list.iterator(); it.hasNext(); ) {
Author author = (Author) it.next();
if(author.getName().equals("mama")) {
System.out.println("Removing mama...");
it.remove();
} else {
System.out.println("Keeping " + author.getName());
}
}
}
}
Another use case is to split the XML into master/detail documents by declaring a local converter for a collection
(or map) based on the collection types in XStream's persistence package. Think about a volume grouping different type of documents:
public abstract class AbstractDocument {
String title;
}
public class TextDocument extends AbstractDocument {
List chapters = new ArrayList();
}
public class ScannedDocument {
List images = new ArrayList();
}
public Volume {
List documents = new ArrayList();
}
The documents might be big (especially the ones with the scanned pages), therefore it might be nice to separate each
document into an own file. With the help of a local converter utilizing an XmlArrayList this is straight forward:
public final class PersistenceArrayListConverter implements Converter {
private XStream xstream;
public PersistenceArrayListConverter(XStream xstream) {
this.xstream = xstream;
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
File dir = new File(System.getProperty("user.home"), "documents");
XmlArrayList list = new XmlArrayList(new FilePersistenceStrategy(dir, xstream));
context.convertAnother(dir);
list.addAll((Collection)source); // generate the external files
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
File directory = (File)context.convertAnother(null, File.class);
XmlArrayList persistentList = new XmlArrayList(new FilePersistenceStrategy(directory, xstream));
ArrayList list = new ArrayList(persistentList); // read all files
persistentList.clear(); // remove files
return list;
}
public boolean canConvert(Class type) {
return type == ArrayList.class;
}
}
This converter will use a given XStream to store each element of an ArrayList into an own file located in the user's home
directory in the folder documents. The master XML will now contain the name of the target folder
instead of the marshalled documents. In our case those documents are destroyed if the volume is unmarshalled again. See the
initialization of the XStream:
XStream = new XStream();
xstream.alias("volume", Volume.class);
xstream.registerLocalConverter(Volume.class, "documents", new PersistenceArrayListConverter(xstream));
Volume volume = new Volume();
volume.documents.addAll(...); // add a lot of documents
String xml = xstream.toXML(volume);
The resulting XML will be very simple:
<volume>~/documents</volume>
The documents can be found in individual files in the target folder with names like int@<index>.xml.
Going further
From this point on, you can implement different PersistentStrategy algorithms in order to generate other behaviour (e.g.
persisting the objects in a database) using your XmlArrayList collection, or try the other implementations: XmlSet and XmlMap
and you may create your own local converters. As an alternative to a converter you might use the persistent collection type
directly as member instance, the effect is similar - give it a try!
See also XBird that makes usage of this XStream API to support object
persistence.
Benchmark results are always dependent on a very individual setup. Normally it is not useful to generalize such results
for every use case, but it can give you a hint. However, if you're really in the need of maximum performance, you should
probably create an own benchmark with your objects or even use a profiler to detect the real hot spots in your application.
Benchmark Values
Parser
Single Value Converters
Standard Converters
Reflection Converter
Serializable Converter
W3C DOM
1823.0
1495.0
1437.0
1758.0
JDOM
2620.0
1796.0
1776.0
2030.0
DOM4J
1824.0
1811.0
2636.0
2177.0
XOM
571.0
716.0
995.0
958.0
StAX (BEA)
430.0
359.0
531.0
737.0
StAX (Woodstox)
357.0
344.0
535.0
725.0
StAX (SJSXP)
332.0
445.0
491.0
667.0
XPP (Xpp3)
351.0
395.0
544.0
743.0
XPP (kXML2)
299.0
353.0
517.0
761.0
XppDom (Xpp3)
351.0
395.0
544.0
743.0
XppDom (kXML2)
299.0
353.0
517.0
761.0
Setup
The values have been generated running the ParserBenchmark harness of the XStream benchmark module's test code.
Single Value Converters
A list with a set of 10 objects of different types (like String, int, File, Locale, Double, ...) that will
be all handled by a SingleValueConverter.
Standard Converters
A list with a set of 6 objects of different types (like Properties, Color, Class, Method, ...) that will
be all handled by a specialized converter processing nested XML elements.
Reflection Converter
A list with a set of 6 objects of different types (One, Five of the XStream benchmark package) that will be
all handled by the ReflectionConverter.
Serializable Converter
A list with a set of 6 objects of different types (SerializableOne, SerializableFive of the XStream
benchmark package) that will be all handled by the SerializableConverter.
JavaBean Converter
A list with a set of 6 objects of different types (OneBean, FiveBean of the XStream benchmark package) that
will be all handled by the JavaBeanConverter. This converter has been registered especially for this two types.
Environment
The values above's unit is ms measured after 1000 unmarshalling operations with the object graphs described in
the setup using XStream 1.4. The benchmark was run on an AMD Athlon with 2.1GHz running a JVM of Sun JDK 1.6.0_13
(32-bit) in Gentoo Linux. Note again, that these values are no replacement for real profiler results and they may
vary from run to run for ~100ms due to this machine's background processes on a single CPU. However, it can give
you some idea of what you can expect using different parser technologies.
How does XStream deals with duplicate and circular references?
It depends on XStream's mode, the default is uses XPath to allow serialized objects to be treated as graphs instead of simple trees (typical XML usage).
Sometimes it's not desirable to work this way, let's take a look in a simple example in order to switch between XStream's modes and see what its capable of.
We start with a simple compact-disc class, with id and a bonus cd fields:
package com.thoughtworks.xstream;
public class Cd {
private String id;
private Cd bonusCd;
Cd(String id, Cd bonusCd) {
this.id = id;
this.bonusCd = bonusCd;
}
Cd(String id) {
this.id = id;
}
public String getId() {
return id;
}
public Cd getBonusCd() {
return bonusCd;
}
}
And let's create an order with the same cd twice and the order itself, so we can simulate
two references to the same object and a back-reference.
Cd bj = new Cd("basement_jaxx_singles");
List order = new ArrayList();
// adds the same cd twice (two references to the same object)
order.add(bj);
order.add(bj);
// adds itself (cycle)
order.add(order);
XStream xstream = new XStream();
xstream.alias("cd", Cd.class);
System.out.println(xstream.toXML(order));
If we execute the above code, XStream's uses its default mode called XPATH_RELATIVE_REFERENCES
based on the W3C XPath specification. Cross and back references are treated in a way that it's (almost) human
readable:
The second reference to the Basement Jaxx cd was serialized as "../cd[2]" while the order inside
itself used the ".." path. The XPath Relative mode allows any type of graphs to be used as both cross and
back-references are supported.
In order to make use of the XPath Relative mode one can implicitly call:
In some cases where the XML is used later on or is generated by someone else, the
XPath selectors can be forced to select always a single node instead of a node list where
the first element is taken. Therefore two more modes exist:
For XStream is the notation with the single node selectors absolutely equivalent to the
one without. These two notations are completely transparent at deserialization time.
Id mode
Both modes displayed until now are not so easy to write by hand. XStream has another
mode which makes it is easier to read/write by a human being:
xstream.setMode(XStream.ID_REFERENCES);
The result is a XML which generates an "id" attribute for each new object marshaled,
and whenever it finds back or cross-references, it uses a "reference" attribute to so
it doesn't copy the entire object.
In our example, the list has id 1, the Maria Rita cd 2, and the Basement Jaxx 3. Therefore
the cross-reference to our cd should contain a reference attribute to object number 2 and
the back-reference to our order a reference to object 1. The result is:
For some uses of XStream we do not desire any kind of back or cross references like a graph, but a simple
tree. The most famous example is when using XStream to generate XML for B2B services.
In such scenarios it's impossible to represent a graph cycle (remember: no tree contains such structure), therefore
we have to remove the last add call from our example:
Cd bj = new Cd("basement_jaxx_singles");
List order = new ArrayList();
// adds the same cd twice (two references to the same object)
order.add(bj);
order.add(bj);
XStream xstream = new XStream();
xstream.alias("cd", Cd.class);
System.out.println(xstream.toXML(order));
Now if we add the NO_REFERENCES option, every reference shall be completed serialized.
After reading from the above XML, you will get three different Cd instances.
Remember: it's impossible to support back-references (cycles) with NO_REFERENCES mode activated therefore
a CircularReferenceException is thrown if you ever try to do so.
Due to massive abuse by spammers the subscriptions is centralized for email lists of all projects hosted on Codehaus.
After following the link above just register with your email address and you can manage all subscriptions at once.
XStream is open source software, made available under a BSD license.
Copyright (c) 2003-2006, Joe Walnes
Copyright (c) 2006-2009, 2011 XStream Committers
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of
conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other materials provided
with the distribution.
3. Neither the name of XStream nor the names of its contributors may be used to endorse
or promote products derived from this software without specific prior written
permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.
jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/src/content/team.html 0000664 0001750 0001750 00000006234 12206661545 027407 0 ustar jamespage jamespage
Development Team
Project Founder
Joe Walnes
Project Lead
Jörg Schaible
Active Committers
Joe Walnes
Mauro Talevi
Jörg Schaible
Guilherme Silveira
Hibernating Committers
Jason van Zyl
Nat Pryce
Dan North
Contributors
List in sequence of first contribution to XStream.
Tim Mackinnon
James Strachan
Jon Tirsén
Marcos Tarruella
Khurram Chaudhary
Brock Bulger
Paul Hammant
Nicky Sandhu
J. Matthew Pryor
Aslak Hellesøy
Nick Pomfret
Brian Slesinsky
Konstantin Pribluda
Ben Smith
Brian Oxley
Chris Kelly
Matthew Sandoz
Veaceslav Chicu
Jose A. Illescas
Laurent Bihanic
Martin Weindel
Michael Kopp
Brian Selinsky
Daniel Sheppard
Chris Nokleberg
Henri Tremblay
Simon Daniel
Eric Snell
Andrea Aime
Bryan Coleman
Kevin Ring
Trygve Laugstøl
Hannes Havel
Gábor Lipták
Baba Buehler
Emil Kirschner
Chung-Onn Cheong
Ian Cartwright
Costin Leau
Stefano Girotti
David Blevins
Henrik Ståhl of BEA
Cyrille Le Clerc
John Kristian
Chris Winters
Lucio Benfante
Nicolas Gros d'Aillon
Dejan Bosanac
Rene Schwietzke
Hinse ter Schuur
Adrian Wilkens
Jukka Lindström
Kevin Conaway
Kevin Bowman
Tatu Saloranta
Jerome Lacoste
Reto Bachmann-Gmür
Steven Sparling
Alexander Radzin
Doug Daniels
Jason Greanya
Carlos Roman
Jaime Metcher
Michael Schnell
Nikita Levyankov
Please direct all correspondence about XStream to the users' mailing lists
rather than directly to one of the team.
XStream is used in a lot of commercial and open source projects and is used in production since years.
XStream used for Core Technology
Atlassian Bamboo
Bamboo is build server for continuous integration
and release management. Note, XStream itself uses Bamboo
at Codehaus for continuous integration.
Atlassian Confluence
Confluence is an enterprise wiki that makes it
easy for your team to collaborate and share knowledge.
Oracle Hudson CI
Hudson CI is also a build server for continuous
integration and release management.
Apache Muse
The Apache Muse Project is a Java-based implementation of the
WS-ResourceFramework (WSRF),
WS-BaseNotification (WSN), and
WS-DistributedManagement (WSDM) specifications.
It is a framework upon which users can build web service interfaces for manageable resources without having to
implement all of the "plumbing" described by the aforementioned standards. Applications built with Muse can be
deployed in both Apache Axis2 and OSGi environments, and the project includes a set of command line tools that
can generate the proper artifacts for your deployment scenario.
NanoContainer
The scope of the NanoContainer project is to complement the
PicoContainer project, providing it with additional functionality. The
project comprises of several components which can either be adoptions in various guises of PicoContainer (e.g.
composition by-class-name rather than by-class), or adaptations to external components bringing them closer to the
Dependency Injection ideal - particularly
Constructor Injection.
Murq
Murq is a persistence framework with an emphasis on simplicity.
It is also capable of storing binary data and meta data, supports search functionality and makes internationalization
seamless.
XBird
XBird is a light-weight XQuery processor and database system
written in Java. The light-weight means reasonably fast and embeddable. It uses the
XStream persistence API for
object persistence
EJOE
EJOE is a lightweight Java remoting framework built to send
and receive objects through pluggable (de)serialization mechanisms. XStream provides the
default (de)serialization mechanism.
OpenCraft
OpenCraft is an alternative/custom Minecraft server, written
in Java, compatible with the original protocol. XStream provides the persistence layer.
XStream Support
jBoss ESB
jBossESB is the next generation of EAI - better and without the
vendor-lockin characteristics of old. It uses a flexible architecture based on SOA principles such as loose-coupling
and asynchronous message passing, emphasizing an incremental approach to adopting and deploying an SOI. XStream
can be used as one possibility for the messaging part.
Restlet
Restlet is a lightweight REST framework for Java that lets you embrace
the architecture of the Web and benefit from its simplicity and scalability. By leveraging our innovative REST engine,
you can start blending your Web Sites and Web Services into uniform Web Applications!
The framework uses XStream as
extension for a representation of objects in XML or JSON and a ConverterService based on this functionality.
ActiveSOAP
ActiveSOAP is a lightweight & easily embeddable
REST and SOAP stack based on
StAX with support for
WS-Addressing and
WSIF. ActiveSOAP uses StAX (the Standard API for pull parsing)
to implement the SOAP protocols and then it delegates to plugin
Handler objects
for the heavy duty processing of the XML payloads. This means that you only need to pay for what you need; use fast
pull based event parsing or full data binding mechanisms like JAXB or XStream or DOMish APIs like XMLBeans when they
make sense.
Mule
Mule is the leading open source ESB (Enterprise Service Bus) and integration
platform. It is a scalable, highly distributable object broker that can seamlessly handle interactions with services and
applications using disparate transport and messaging technologies. Transformers are used to convert inbound data to an
object type required by the UMO Component or outbound to an object type required by the transport such as a JmsMessage.
Mule uses Transformers to convert event data between
the different endpoints. They can be configured on endpoints that receive data to ensure that the expected object type is
always received by a Mule Component. XStream is used for standard XML to Java object transformation.
Blojsom
Blojsom is Java-based, full-featured, multi-blog, multi-user software package
that was inspired by blosxom. blojsom aims to retain a simplicity in design while adding flexibility in areas such as the flavors,
templating, plugins, and the ability to run multiple blogs with a single blojsom installation. XStream is used for export.
FlatTree
FlatTree is a Java library for reading and
writing of flat files: CSV, FLR (fixed length record) or mixed structures. It features a tree-style processing API, adapters
for SAX, Stax and XStream for transformation,
data binding or serialization.
jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/src/content/how-to-contribute.html 0000664 0001750 0001750 00000006633 12206661545 032055 0 ustar jamespage jamespage
How to Contribute
XStream is nothing without contributions from the user community. There are many ways to
contribute. We are constantly working on the software and documentation, so it's a good
idea to contact the team on the
user or development mailing lists
to avoid duplicating effort.
Documentation
One of the traditional weak points of open source software is the documentation. Any
help with this aspect of the project will be welcomed with open arms, or at the very least
with open email clients!
Examples
We are working on one or two examples of using XStream, but we can always do with more.
Feature Requests
We eat our own dogfood, but we're also happy to feed other people's dogs (if you'll excuse
a stretched dachshund metaphor!). If you want to request a new feature you can either
make a request through the issue tracker or by sending a message to the
development mailing list. The benefit of any new features
will be discussed on the mailing list, so its a good idea to sign up so that you can stick your oar in.
Bug Reports
You can report bugs through the issue tracker interface or the
development mailing list. Additional brownie
points are awarded for bug reports that include a failing unit test.
Bug Fixes
If you want lots of brownie points, send a fix along with your bug report
and failing unit test. Bug fixes are best sent as patches that we can apply to the
codebase. Remember to tell us which version the patch should be applied against, or
we'll get very confused. To be accepted into the codebase, patches must be released
under the same license as XStream itself.
New Code
If you have a new feature request, then we'll listen extra hard if you show us how it
works. A new feature might be best implemented as a patch to an existing class
or as a new class. The XStream API contains many extension points that allow new functionality
to be integrated into the framework. We are rather anal about testing, so if you send us
some code without any tests we will probably ask you to write the tests tests as well
before we add it to the codebase.
Write Your Own XStream Extension
If you have a project that builds upon XStream we will be happy to announce your
project on the XStream site.
Become a Committer
We follow the Codehaus manifesto
when it comes to expanding the core team.
Due to massive abuse by spammers the subscriptions is centralized for email lists of all projects hosted on Codehaus.
After following the link above just register with your email address and you can manage all subscriptions at once.
This is the most basic converter... let's start with a simple Person:
package com.thoughtworks.xstream.examples;
public class Person {
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
So let's create a person and convert it to
XML...
package com.thoughtworks.xstream.examples;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.xml.DomDriver;
public class PersonTest {
public static void main(String[] args) {
Person person = new Person();
person.setName("Guilherme");
XStream xStream = new XStream(new DomDriver());
System.out.println(xStream.toXML(person));
}
}
This results in a really ugly XML code which contains the full
class name (including
package)...
public void marshal(Object value, HierarchicalStreamWriter writer,
MarshallingContext context) {
Person person = (Person) value;
writer.startNode("fullname");
writer.setValue(person.getName());
writer.endNode();
}
We could have called start/end node as many times as we would
like (but remember to close everything you open)... and conversion usually
takes place when calling the setValue method.
And now let's go to
the unmarshal. We use the moveDown and moveUp methods to move
in the tree hierarchy, so we can simply moveDown, read the value and
moveUp.
Person person = new Person();
reader.moveDown();
person.setName(reader.getValue());
reader.moveUp();
Which gives us the following
converter:
package com.thoughtworks.xstream.examples;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
public class PersonConverter implements Converter {
public boolean canConvert(Class clazz) {
return clazz.equals(Person.class);
}
public void marshal(Object value, HierarchicalStreamWriter writer,
MarshallingContext context) {
Person person = (Person) value;
writer.startNode("fullname");
writer.setValue(person.getName());
writer.endNode();
}
public Object unmarshal(HierarchicalStreamReader reader,
UnmarshallingContext context) {
Person person = new Person();
reader.moveDown();
person.setName(reader.getValue());
reader.moveUp();
return person;
}
}
Now let's register our converter and see how our application
main method looks
like:
package com.thoughtworks.xstream.examples;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.xml.DomDriver;
public class PersonTest {
public static void main(String[] args) {
Person person = new Person();
person.setName("Guilherme");
XStream xStream = new XStream(new DomDriver());
xStream.registerConverter(new PersonConverter());
xStream.alias("person", Person.class);
System.out.println(xStream.toXML(person));
}
}
Did you notice how we registered our converter? It's a simple
call to
registerConverter:
xStream.registerConverter(new PersonConverter());
The
final result
is:
<person>
<fullname>Guilherme</fullname>
</person>
So you might say... that only changed my tree, I
want to convert data!
Try using an attribute called fullname in
the person tag instead of creating a new child node.
An alternative for types with String representation
Let's enhance the Person with a String representation, that contains all necessary
text to recreate the instance:
package com.thoughtworks.xstream.examples;
public class Person {
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String toString() {
return getName();
}
}
In this case we can simplify our Converter to
package com.thoughtworks.xstream.examples;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
public class PersonConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class clazz) {
return clazz.equals(Person.class);
}
public Object fromString(String str) {
Person person = new Person();
person.setName(string);
return person;
}
}
But even nicer, our XML is also simplified (using the alias for the
Person class). Since the String representation is complete, a nested element is not
necessary anymore:
<person>Guilherme</person>
Date Converter
Now that we know how the Converter interface works, let's create a
simple calendar converter which uses the locale to convert the
information.
Our converter will receive the Locale in its constructor
and we will keep a reference to it in a member
variable:
Now let's convert anything which extends Calendar:
means if instances of class clazz can be assigned to the
Calendar class, they extends the abstract class
Calendar:
public boolean canConvert(Class clazz) {
return Calendar.class.isAssignableFrom(clazz);
}
Let's go for converting a Calendar in a localized
string... we first cast the object to Calendar, extract its Date
and then use a DateFormat factory method to get a date converter to our
localized
string.
public void marshal(Object value, HierarchicalStreamWriter writer,
MarshallingContext context) {
Calendar calendar = (Calendar) value;
// grabs the date
Date date = calendar.getTime();
// grabs the formatter
DateFormat formatter = DateFormat.getDateInstance(DateFormat.FULL,
this.locale);
// formats and sets the value
writer.setValue(formatter.format(date));
}
And the other way around... in order to unmarshall, we create
a GregorianCalendar, retrieves the localized DateFormat
instance, parses the string into a Date and puts this date in the
original
GregorianCalendar:
public Object unmarshal(HierarchicalStreamReader reader,
UnmarshallingContext context) {
// creates the calendar
GregorianCalendar calendar = new GregorianCalendar();
// grabs the converter
DateFormat formatter = DateFormat.getDateInstance(DateFormat.FULL,
this.locale);
// parses the string and sets the time
try {
calendar.setTime(formatter.parse(reader.getValue()));
} catch (ParseException e) {
throw new ConversionException(e.getMessage(), e);
}
// returns the new object
return calendar;
}
Note 1: remember that some DateFormat implementations
are not thread-safe, therefore don't put your formatter as a member of your
converter.
Note 2: this implementation will convert other types
of Calendar's to GregorianCalendar after save/load. If this is not what you
want, change your canConvert method to return true only if
class equals GregorianCalendar.
And let's try it out. We create a DateTest class with a
main method:
creates a calendar (current date)
creates the XStream object
registers the converter with a Brazilian Portuguese locale
translates the object in XML
Well, we already know how to do all those steps... so let's go:
package com.thoughtworks.xstream.examples;
import java.util.Calendar;
import java.util.GregorianCalendar;
import java.util.Locale;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.xml.DomDriver;
public class DateTest {
public static void main(String[] args) {
// grabs the current date from the virtual machine
Calendar calendar = new GregorianCalendar();
// creates the xstream
XStream xStream = new XStream(new DomDriver());
// brazilian portuguese locale
xStream.registerConverter(new DateConverter(new Locale("pt", "br")));
// prints the result
System.out.println(xStream.toXML(calendar));
}
}
The result? Well... it depends, but it will be something
like:
<gregorian-calendar>Sexta-feira, 10 de Fevereiro de 2006</gregorian-calendar>
Note:
we did not put any alias as gregorian-calendar is the default alias for
GregorianCalendar.
And now let's try to unmarshal the result
shown
above:
// loads the calendar from the string
Calendar loaded = (Calendar) xStream
.fromXML("<gregorian-calendar>Sexta-feira, 10 de Fevereiro de 2006</gregorian-calendar>");
And
print it using the system locale, short date
format:
// prints using the system defined locale
System.out.println(DateFormat.getDateInstance(DateFormat.SHORT).format(
loaded.getTime()));
The result might be
something like (if your system locale is American
English):
2/10/06
Complex Converter
Setting up another example
We already defined some classes, so let them glue together:
package com.thoughtworks.xstream.examples;
public class Birthday {
private Person person;
private Calendar date;
private char gender;
public Person getPerson() {
return person;
}
public void setPerson(Person person) {
this.person = person;
}
public Calendar getDate() {
return date;
}
public void setDate(Calendar date) {
this.date = date;
}
public char getGender() {
return gender;
}
public void setGenderMale() {
this.gender = 'm';
}
public void setGenderFemale() {
this.gender = 'f';
}
}
While XStream is capable of converting this class without any problem, we write our own custom converter
just for demonstration. This time we want to reuse our already written converters for the Person and the Calendar and add an
own attribute for the gender. The canConvert method is plain simple. We convert no derived classes this time,
since they might have additional fields. But we reuse the converters registered in XStream for our member fields and handle
null values:
package com.thoughtworks.xstream.examples;
import java.util.Calendar;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
public class BirthdayConverter implements Converter {
public boolean canConvert(Class clazz) {
return Birthday.class == clazz;
}
public void marshal(Object value, HierarchicalStreamWriter writer,
MarshallingContext context) {
Birthday birthday = (Birthday)value;
if (birthday.getGender() != '\0') {
writer.addAttribute("gender", Character.toString(birthday.getGender()));
}
if (birthday.getPerson() != null) {
writer.startNode("person");
context.convertAnother(birthday.getPerson());
writer.endNode();
}
if (birthday.getDate() != null) {
writer.startNode("birth");
context.convertAnother(birthday.getDate());
writer.endNode();
}
}
public Object unmarshal(HierarchicalStreamReader reader,
UnmarshallingContext context) {
Birthday birthday = new Birthday();
String gender = reader.getAttribute("gender");
if (gender != null) {
if (gender.length() > 0) {
if (gender.char(0) == 'f') {
birthday.setGenderFemale();
} else if (gender.char(0) == 'm') {
birthday.setFemale();
} else {
throw new ConversionException("Invalid gender value: " + gender);
}
} else {
throw new ConversionException("Empty string is invalid gender value");
}
}
while (reader.hasMoreChildren()) {
reader.moveDown();
if ("person".equals(reader.getNodeName())) {
Person person = (Person)context.convertAnother(birthday, Person.class);
birthday.setPerson(person);
} else if ("birth".equals(reader.getNodeName())) {
Calendar date = (Calendar)context.convertAnother(birthday, Calendar.class);
birthday.setDate(date);
}
reader.moveUp();
}
return birthday;
}
}
The unmarshal method ensures the valid value for the gender by throwing a
ConversionException for invalid entries.
Note, that attributes will always have to be written and read first. You work on a stream and
accessing the value of a tag or its members will close the surrounding tag (that is still active when the method is
called).
If the implementation of Birthday ensures, that none of its fields
could hold a null value and gender contains a valid value, then we could drop the
null condition in the marshal method and in unmarshal
we could omit the loop as well as the comparison of the tag names:
package com.thoughtworks.xstream.examples;
import java.util.Calendar;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
public class BirthdayConverter implements Converter {
public boolean canConvert(Class clazz) {
return Birthday.class == clazz;
}
public void marshal(Object value, HierarchicalStreamWriter writer,
MarshallingContext context) {
writer.addAttribute("gender", Character.toString(birthday.getGender()));
Birthday birthday = (Birthday)value;
writer.startNode("person");
context.convertAnother(birthday.getPerson());
writer.endNode();
writer.startNode("birth");
context.convertAnother(birthday.getDate());
writer.endNode();
}
public Object unmarshal(HierarchicalStreamReader reader,
UnmarshallingContext context) {
Birthday birthday = new Birthday();
if (reader.getAttribute("gender").charAt(0) == 'm') {
birthday.setGenderMale();
} else {
birthday.setGenderFemale();
}
reader.moveDown();
Person person = (Person)context.convertAnother(birthday, Person.class);
birthday.setPerson(person);
reader.moveUp();
reader.moveDown();
Calendar date = (Calendar)context.convertAnother(birthday, Calendar.class);
birthday.setDate(date);
reader.moveUp();
return birthday;
}
}
Due to XStream's flexible architecture, handling of JSON mappings is as easy as handling of XML documents. All you
have to do is to initialize XStream object with an appropriate driver and you are ready to serialize your objects to
(and from) JSON.
XStream currently delivers two drivers for JSON: The
JsonHierarchicalStreamDriver
and the JettisonMappedXmlDriver.
The first one does not have an additional dependency, but can only be used to write XML, while the second one is based
on Jettison and can also deserialize JSON to Java objects again. However, since the JettisonMappedXmlDriver transforms
plain XML into JSON, you might get better JSON strings with the JsonHierarchicalStreamDriver, because this driver knows
often about the type of the written data and can act properly.
One word of warning. JSON is made for an easy data transfer between systems and languages. It's
syntax offers much less possibilities to express certain data structures. It supports name/value pairs of primitive
data types, arrays and lists and allows to nest them - but that's it! No references, no possibility for meta data
(attributes), no properties with same names (as generated for implicit collections), etc. Therefore do not expect
wonders. XStream (and Jettison) try their best, but the procedure to convert any kind of object into JSON is a lossy
transformation and especially deserialization will not be possible for any construct. See also
FAQ.
Since JSON has no possibility to express references, you should always set the NO_REFERENCES mode writing JSON.
Jettison driver
Jettison driver uses Jettison StAX parser to read and write data in JSON
format. It is available in XStream since version 1.2.2 and is implemented in
com.thoughtworks.xstream.io.json.JettisonMappedXmlDriver class. To successfully use this driver you need
to have the Jettison project and StAX API in your classpath (see reference for
optional dependencies).
Alternatively you can download JARs manually.
Here are a few simple examples:
Write to JSON with the Jettison-based implementation
The following example:
package com.thoughtworks.xstream.json.test;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.json.JettisonMappedXmlDriver;
public class WriteTest {
public static void main(String[] args) {
Product product = new Product("Banana", "123", 23.00);
XStream xstream = new XStream(new JettisonMappedXmlDriver());
xstream.setMode(XStream.NO_REFERENCES);
xstream.alias("product", Product.class);
System.out.println(xstream.toXML(product));
}
}
As you can see, all standard XStream features (such as aliases) can be used with this driver.
Note that Jettison will try to detect numerical values and omit the quotes. Since Jettison
cannot know about the original data type, it has to guess. Hence it will therefore also write the value of the id
field as numeric value in future.
Write to JSON with the self-contained JSON driver
The only difference to the example above is the line with the initialization:
XStream xstream = new XStream(new JsonHierarchicalStreamDriver());
While the difference because of line feeds is immediately obvious, you have to note also the value of the
id element. This time the driver knew about the string value and therefore quotes were generated.
Write to JSON with the self-contained JSON driver dropping the root
Sometimes the root node in the generated JSON is superfluous, since its name is caused by the Java type
of the written object that has no meaning in JSON and increases only the nesting level of the structure. Therefore
it is possible to drop this root by initializing the internally used
JsonWriter in a different mode.
Again, the only difference to the example above is the line with the initialization:
XStream xstream = new XStream(new JsonHierarchicalStreamDriver() {
public HierarchicalStreamWriter createWriter(Writer writer) {
return new JsonWriter(writer, JsonWriter.DROP_ROOT_MODE);
}
});
The output is as follows:
{
"name": "Banana",
"id": "123",
"price": 23.0
}
Note, that it is now possible to create invalid JSON if XStream should marshal a single object
with a single value to JSON (like String, int, URL, ...). JSON requires that the root is actually an object, but by
dropping the root all that is generated is a single value. You can force the JsonWriter to throw a ConversionException
in this case, see Javadoc of the JsonWriter.
Read from JSON
The following code:
package com.thoughtworks.xstream.json.test;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.json.JettisonMappedXmlDriver;
public class ReadTest {
public static void main(String[] args) {
String json = "{\"product\":{\"name\":\"Banana\",\"id\":123"
+ ",\"price\":23.0}}";
XStream xstream = new XStream(new JettisonMappedXmlDriver());
xstream.alias("product", Product.class);
Product product = (Product)xstream.fromXML(json);
System.out.println(product.getName());
}
}
serializes JSON document created with preceding example back to Java object. It prints:
The XStream project follows strict rules that govern its use of version
numbers. The version number of a release indicates how that release
is compatible with previous and future releases.
Version numbers have the form
major.minor.patch. A major
version identifies the product stage of the project. Two libraries with
different major version are designed to work together in the same
application. This implies a major change in the API - either by not
sharing the same types or using a different package name.
The minor version number identifies the API version. A release that
changes the API in a way that breaks backwards compatibility will increment
the minor version number and reset the patch version to zero. The patch
version number identifies the backwards compatible revision of the API. A
change in the minor version will still be mostly backward compatible, but
may need some compatibility settings or slight migration adjustments. The
patch version number identifies revisions that do not change the API
although new API elements may occur or existing API may be deprecated to
prepare users for the next release with a change in the minor version. A
release that fixes bugs or refactors implementation details without changing
the API will have the same minor and major versions as the previous release
and increment the patch number.
A hypothetical example:
1.0.0
First release
1.0.1
Improves Javadoc comments, fixes bug
1.1.0
Adds new API elements, may cause some migration
1.1.1
Adds new API elements, deprecates some API elements
1.1.2
Fixes bugs
1.2.0
Adds new API, needs some migration effort and removes deprecated elements
2.0.0
Complete API redesign, can be used simultanly with 1.x series.
2.0.1
Deprecates API, fixes bugs
2.1.0
Adds new API elements
etc.
etc.
Release Candidates
Before a new major or minor release, XStream will make release
candidate (RC) packages available so that users can test them against
their own code. There will be one or more release candidates given the
version major.minor.0 RCn, where the
major and minor version numbers identify the upcoming release and RC1
identifies the first candidate release, RC2 the second, and so on.
A release candidate does not guarantee backward compatibility with
new API features introduced by any previous RC of the same upcoming
version.
A major version RC can change/remove API features introduced in a
previous RC for the same major version; a minor version RC can change
API features introduced by any previous RC of the same upcoming minor
version but guarantees backward compatibility with the previous minor
version.
Development Snapshots
During development, the the developers may publish snapshot packages
from time to time. These are not guaranteed to be complete:
Although the unit tests will all pass the snapshot will probably contain
failing acceptance tests that describe planned or requested features that
have not yet been implemented. Snapshots are identified by the UTC time
at which the package was built. The timestamp has the form
VERSION-YYYYMMDD.hhmmss-n, where VERSION is the upcoming
version, YYYY is the (four-digit) year, MM the month, DD the day, hh the
hour, mm the minute, ss the second and n a sequential number.
Internal Classes
Many classes are for internal use only and not designed to be used by
end users. These are exempt from the versioning rules above.
Such classes are clearly marked as internal in the source code
headers and are excluded from the published JavaDoc.
Versioning and Deprecation
A patch release might deprecate some API features. Deprecated features
will not actually be removed until the next minor release.
A release will never remove API features that have not been deprecated in
a previous release.
Suppose that our client has defined a base XML file that we should make XStream read/write:
<blog author="Guilherme Silveira">
<entry>
<title>first</title>
<description>My first blog entry.</description>
</entry>
<entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</entry>
</blog>
Based on the XML file above we shall create some model classes and configure XStream to write/read from this format.
The model
First things first, the classes which shall represent our xml files are shown next, beginning with a simple Blog:
package com.thoughtworks.xstream;
public class Blog {
private Author writer;
private List entries = new ArrayList();
public Blog(Author writer) {
this.writer = writer;
}
public void add(Entry entry) {
entries.add(entry);
}
public List getContent() {
return entries;
}
}
A basic author with name:
package com.thoughtworks.xstream;
public class Author {
private String name;
public Author(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
A blog entry contains a title and description:
package com.thoughtworks.xstream;
public class Entry {
private String title, description;
public Entry(String title, String description) {
this.title = title;
this.description = description;
}
}
Although we did not create many getters/setters its up to you to create those you wish or those which make sense.
A simple test
We can easily instantiate a new blog and use it with xstream:
public static void main(String[] args) {
Blog teamBlog = new Blog(new Author("Guilherme Silveira"));
teamBlog.add(new Entry("first","My first blog entry."));
teamBlog.add(new Entry("tutorial",
"Today we have developed a nice alias tutorial. Tell your friends! NOW!"));
XStream xstream = new XStream();
System.out.println(xstream.toXML(teamBlog));
}
And the resulting XML is not so nice as we would want it to be:
<com.thoughtworks.xstream.Blog>
<writer>
<name>Guilherme Silveira</name>
</writer>
<entries>
<com.thoughtworks.xstream.Entry>
<title>first</title>
<description>My first blog entry.</description>
</com.thoughtworks.xstream.Entry>
<com.thoughtworks.xstream.Entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</com.thoughtworks.xstream.Entry>
</entries>
</com.thoughtworks.xstream.Blog>
Class aliasing
The first thing we shall change is how XStream refers to the com.thoughtworks.xstream.Blog class.
We shall name it simply blog: let's create an alias called blog to the desired class:
xstream.alias("blog", Blog.class);
Using the same idea, we can alias the 'Entry' class to 'entry':
xstream.alias("entry", Entry.class);
The result now becomes:
<blog>
<writer>
<name>Guilherme Silveira</name>
</writer>
<entries>
<entry>
<title>first</title>
<description>My first blog entry.</description>
</entry>
<entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</entry>
</entries>
</blog>
Field aliasing
Next we will change the name of the writer tag, but this time we have to use a field alias:
<blog>
<author>
<name>Guilherme Silveira</name>
</author>
<entries>
<entry>
<title>first</title>
<description>My first blog entry.</description>
</entry>
<entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</entry>
</entries>
</blog>
Implicit Collections
Now let's implement what was called an implicit collection: whenever you have a collection which doesn't need
to display it's root tag, you can map it as an implicit collection.
In our example, we do not want to display the entries tag, but simply show the entry tags one after
another.
A simple call to the addImplicitCollection method shall configure XStream and let it know that we do not want to
write the entries tag as described above:
package com.thoughtworks.xstream;
import java.util.ArrayList;
import java.util.List;
public class Test {
public static void main(String[] args) {
Blog teamBlog = new Blog(new Author("Guilherme Silveira"));
teamBlog.add(new Entry("first","My first blog entry."));
teamBlog.add(new Entry("tutorial",
"Today we have developed a nice alias tutorial. Tell your friends! NOW!"));
XStream xstream = new XStream();
xstream.alias("blog", Blog.class);
xstream.alias("entry", Entry.class);
xstream.addImplicitCollection(Blog.class, "entries");
System.out.println(xstream.toXML(teamBlog));
}
}
Pay attention to the addImplicitCollection method call: it describes which class and which member variable
shall assume the behaviour we described.
The result is almost what we wanted:
<blog>
<author>
<name>Guilherme Silveira</name>
</author>
<entry>
<title>first</title>
<description>My first blog entry.</description>
</entry>
<entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</entry>
</blog>
Just as a side note: An array or a map can also be declared as implicit.
Attribute aliasing
The next step is to set the writer member variable as an XML attribute. In order to do this, we shall tell
XStream to alias the writer field of the Blog class as an "author" attribute:
And now it leaves us with one problem: how does XStream converts an Author in a String so it can be written as a
XML tag attribute?
Attributes cannot be written for types that are handled by Converter implementations, we have to use a
SingleValueConverter and implement our own converter for the Author:
class AuthorConverter implements SingleValueConverter {
}
The first method to implement tells XStream which types it can deal with:
public boolean canConvert(Class type) {
return type.equals(Author.class);
}
The second one is used to extract a String from an Author:
public String toString(Object obj) {
return ((Author) obj).getName();
}
And the third one does the opposite job: takes a String and returns an Author:
public Object fromString(String name) {
return new Author(name);
}
Finally, the entire single value converter, responsible for converting Strings to Objects (Authors in this case) is:
class AuthorConverter implements SingleValueConverter {
public String toString(Object obj) {
return ((Author) obj).getName();
}
public Object fromString(String name) {
return new Author(name);
}
public boolean canConvert(Class type) {
return type.equals(Author.class);
}
}
And let's register this converter:
public class Test {
public static void main(String[] args) {
Blog teamBlog = new Blog(new Author("Guilherme Silveira"));
teamBlog.add(new Entry("first","My first blog entry."));
teamBlog.add(new Entry("tutorial",
"Today we have developed a nice alias tutorial. Tell your friends! NOW!"));
XStream xstream = new XStream();
xstream.alias("blog", Blog.class);
xstream.alias("entry", Entry.class);
xstream.addImplicitCollection(Blog.class, "entries");
xstream.useAttributeFor(Blog.class, "author");
xstream.registerConverter(new AuthorConverter());
System.out.println(xstream.toXML(teamBlog));
}
}
The result?
<blog author="Guilherme Silveira">
<entry>
<title>first</title>
<description>My first blog entry.</description>
</entry>
<entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</entry>
</blog>
You have to be aware, that attribute values normally have to be normalized by the XML parser as
required by the W3C spec. Leading and trailing whitespaces
are normally removed as well as sequential ones! Therefore a deserialized string might differ from the value visible in
the XML representation.
Package aliasing
In the example above we have so far always used class aliases for the Blog and Entry type. Sometimes it is necessary to
map existing class types to others simply by changing the package name. Let us go back to the first attempt of our tutorial,
but this time we alias the package name instead of the individual classes:
public static void main(String[] args) {
Blog teamBlog = new Blog(new Author("Guilherme Silveira"));
teamBlog.add(new Entry("first","My first blog entry."));
teamBlog.add(new Entry("tutorial",
"Today we have developed a nice alias tutorial. Tell your friends! NOW!"));
XStream xstream = new XStream();
xstream.aliasPackage("my.company", "org.thoughtworks");
System.out.println(xstream.toXML(teamBlog));
}
And the resulting XML contains now the classes with the aliased package names:
<my.company.xstream.Blog>
<author>
<name>Guilherme Silveira</name>
</author>
<entries>
<my.company.xstream.Entry>
<title>first</title>
<description>My first blog entry.</description>
</my.company.xstream.Entry>
<my.company.xstream.Entry>
<title>tutorial</title>
<description>
Today we have developed a nice alias tutorial. Tell your friends! NOW!
</description>
</my.company.xstream.Entry>
</entries>
</my.company.xstream.Blog>
Please recognize that the package name alias works also for sub packages in this example.
Summing up
To recap:
You can use class aliases to change tag names
You can use field aliases to change tag names
You can use package aliases to change tag names
Fields can be written as attributes if the field type is handled by a SingleValueConverter
Don't forget to read the converter tutorial to see other type of converters that you can create using XStream.
Or look into the condensed overview how to configure XStream to tweak the output.
Maintenance release 1.4.2 of XStream with bug fixes and small improvements. Main changes:
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.
New extended HierarchicalStreamReader interface with peekNextChild method. All XStream readers implement the new
interface (by Nikita Levyankov).
Special support for Collections.EMPTY_LIST, Collections.EMPTY_SET and Collections.EMPTY_MAP and collections created
with Collections.singletonList(), Collections.singletonSet() and Collections.singletonMap().
Support additional parameters for XStreamConverter annotation (e.g. to declare a ToAttributedValueConverter).
Maintenance release 1.4.1 of XStream after turning out that it did not work in 1.4 with the new default
dependencies. Therefore XStream is back with Xpp3 as default parser and refers additionally the XmlPullParser
API to enable the XppDriver that is used by default.
Finally - XStream 1.4 is ready for delivery. A lot of things have changed and improved, new features added.
Nevertheless we have maintain compatibility to the old versions:
Detection of Java 7 and Android i.e. enabled enhanced mode and annotations for both environments out of the box
Direct support of XmlPullParser factory and alternate kXML2 implementation
Explicit drivers to select the StAX implementation
New separate Hibernate module to support those managed instances (special thanks to Jaime Metcher)
Support of implicit arrays and maps additionally to already existing implicit collection support
Performance improvements (special thanks to Keith Kowalczykowski)
Some new converters (for URI and one to write all fields but one as attributes)
Note, that with version 1.4 the default parser has been changed from
Xpp3 to kXML2.
Note, that JDK 1.3 support has been officially dropped. Nothing special has been done to
enforce this, but there is no longer any support.
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.
Dec 6, 2008 XStream 1.3.1 released
A new XStream maintenance version has been released. The release contains some
bug fixes, some minor enhancements and support of new JDKs:
Ability to alias package names
Converters are only registered by default for types delivered with the JDK in use preventing
unexpected incompatibilities
Separation between user defined attributes and XStream attributes
New mode for JSONWriter to drop JSON root node
Support for FreeBSD's Diablo JDK.
Enhanced persistence package and extended tutorial.
Note, that XStream really supports by default now only types of the JDK in use. Especially for
CGLIB this means that support of those proxies will have to be explicitly activated
first. However, support for CGLIB proxies has been enhanced.
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.
Feb 27, 2008 XStream 1.3 released
The XStream committers proudly present XStream 1.3. This release contains some major
refactorings concerning Java annotations, improved XML support regarding encoding and
character sets, some minor new features, deprecations and a lot of bug fixes:
Annotation support is now implemented as Mapper and Annotations can either be processed
in advance or on-the-fly (see Annotations tutorial
for limitations).
Improved encoding support for JSON and XML (including automated support for XML headers).
Enforceable check for valid XML characters in the written stream.
Dedicated converters can now be configured for individual fields also using the XStream facade.
New converters for java.lang.StringBuilder, java.util.UUID, javax.xml.datatype.Duration,
and javax.swing.LookAndFeel. New generic converter for types using a java.beans.PropertyEditor.
Auto-instantiated SingleValueConverter for Java enums to support enum values as attributes.
XML elements are now sorted by default according their declaration with the fields defined in parent
classes first to improve support for type hierarchies in XML schemata.
A lot of bug fixes to improve JSON support for arbitrary types. Added section in
FAQ for limitations and operation modes.
Native support for SAP VM.
All text-based files are now shipped with an appropriate license header to clean-up legal issues.
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.
May 24, 2007 XStream 1.2.2 released
A maintenance release of XStream that contains a lot of bug fixes and has some minor highlights:
JSON serialization and deserialization support with the help of the new JettisonMappedXmlDriver
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.
Nov 11, 2006 XStream 1.2.1 released
Introduced DocumentWriter interface and generalized functionality for all writer implementations
creating a DOM structure (DOM4J, DOM, JDom, Xom, Xpp3Dom).
Refactor of build system to use Maven 2. Ant still supported on XStream Core.
Oct 10, 2006Joe Walness announcing new XStream Project Lead
I have been the XStream project lead, since it was open sourced 3 years ago. In that time, it has attracted some
excellent developers who have formed the foundations of the user community, made all kinds of significant improvements
and pushed out new releases. It's now approaching its 1000th commit.
The development community that has formed around XStream has been outstanding - more than I could ever have
imagined. In particular, the following people have invested a lot of time into XStream, both from a technical and social point of
view:
Jörg Schaible
Mauro Talevi
Guilherme Silveira
Jason van Zyl
Me (well I have!)
Recently I have been turning my attention to other things and XStream has been very much a self sustaining project. I've
decided that the project would benefit from have a project lead who can invest a lot more time than I can currently offer.
So, the new XStream project lead will be Jörg Schaible, who along with Mauro Talevi and Guilherme Silveira will carry
XStream forward. This has been happening for a long while anyway, it's just none of us ever realised or acknowledged it.
Of course, I'll still be lurking around, helping the transition, having loud mouth opinions and generally annoying people in any
way I can... you haven't got rid of me that easily. ;)
I know Jörg, Mauro and Guilherme will be able carry XStream into the next generation (we have a lot of ambitious plans
for XStream 2).
I'd also like to thank the 45(!) other contributers to the XStream project, who have all helped
make it what it is today. Finally, thanks to Graham Glass, who's Electric XML library formed a lot of the inspiration for XStream.
Aug 18, 2006 XStream 1.2 released
Using attributes for fields (contributed by Paul Hammant and Ian Cartwright).
Aliasing of arbitrary attributes.
XStream can now serialize another XStream instance.
XStream has now the XStreamer, that serializes an object together with its XStream instance.
AnnotationConverter for fields (contributed by Guilherme Silveira).
PureJavaReflectionProvider supports now final fields starting with JDK 1.5
Any Collection type can now be declared implicit, the default implementation will be respected for unmarshalling.
XStream can now write all references as absolute XPath expression.
New SingeValueConverter allows light weight converters if the value can be represented by a unique string.
Aliasing of classes of a specific type.
Support for certain types of proxies generated with the CGLIB Enhancer.
Support for BEA JRockit starting with R25.1.0 (contributed by Henrik Ståhl of BEA).
Experimental binary reader and writer.
Experimental HierarichicalStreamCopier allows streams to be copied from one format to another without the overhead of serialization.
Experimental JSON support allows streams to be copied from one format to another without the overhead of serialization (contributed by Paul Hammant).
Improved support for serializing objects as per the Java Serialization Specification:
Calls custom serialization methods, readObject(), writeObject(), readResolve() and writeReplace() in class, if defined.
Supports ObjectInputStream.getFields() and ObjectOutputStream.putFields() in custom serialization.
Provides implementations of ObjectInputStream and ObjectOutputStream, allowing drop in replacements for standard serialization,
including support for streams of objects. [More...]
Reads and writes directly to most XML Java APIs: DOM, DOM4J, JDOM, XOM, Electric XML, StAX, Trax (write only), SAX (write only).
[More...]
XStream tracks and manages its issues in JIRA of Atlassian,
that is supported by the Codehaus infrastructure and is free for open source development.
JIRA Account
Before you can report, comment or vote for an issue you need an account in JIRA. You will find in the upper right corner of the
JIRA mask a Login link. Follow it and either login if you already have an account otherwise simply sign up. This is necessary
to reduce spam in the system and as benefit you can be notified if work is done on your reported issues.
Policy
Please, before opening a new issue look through the open or resolved ones, you may already find your problem. Also do not
use the system to ask questions, for that purpose we have a user list. We read the list continuously.
If you are unsure whether the problem is caused by a bug or your usage of XStream, use the user's list first. If we can confirm a bug,
you may still open an issue. Also do not report on the list that you have created a new issue, we are already notified by the system.
If you like to contribute code, we prefer a patch/diff in contrast to the complete modified file - unless the file itself is new. Please
provide also unit tests, XStream has a high test coverage and we like to keep this. Additionally, if you provide new files, please also add
a header with the copyright. It must be a BSD license, simply take the header of any other file in the distribution as template. Otherwise
we might not be able to add any code of you.
jenkins-xstream-1.4.4-jenkins-4/xstream-distribution/src/content/index.html 0000664 0001750 0001750 00000007442 12206661545 027572 0 ustar jamespage jamespage
Java to XML serialization, and back again
XStream is a simple library to serialize objects to XML and back again.
Features
Ease of use. A high level facade is supplied that simplifies common use cases.
No mappings required. Most objects can be serialized without need for specifying mappings.
Performance. Speed and low memory footprint are a crucial part of the design, making it suitable for
large object graphs or systems with high message throughput.
Clean XML. No information is duplicated that can be obtained via reflection. This results
in XML that is easier to read for humans and more compact than native Java serialization.
Requires no modifications to objects. Serializes internal fields, including private and
final. Supports non-public and inner classes. Classes are not required to have default constructor.
Full object graph support. Duplicate references encountered in the object-model will
be maintained. Supports circular references.
Integrates with other XML APIs. By implementing an interface, XStream can serialize
directly to/from any tree structure (not just XML).
Customizable conversion strategies. Strategies can be registered allowing customization of how
particular types are represented as XML.
Error messages. When an exception occurs due to malformed XML, detailed diagnostics are provided
to help isolate and fix the problem.
Alternative output format. The modular design allows other output formats. XStream ships currently
with JSON support and morphing.
Typical Uses
Transport
Persistence
Configuration
Unit Tests
Known Limitations
If using the enhanced mode, XStream can re-instantiate classes that do not have a default constructor.
However, if using a different JVM like an old JRockit version, a JDK 1.4 or you have restrictions because of a
SecurityManager, a default constructor is required.
The enhanced mode is also necessary to restore final fields for any JDK < 1.5. This implies deserialization of
instances of an inner class.
Auto-detection of annotations may cause race conditions. Preprocessing annotations is safe though.
jenkins-xstream-1.4.4-jenkins-4/svn-autoprops.config 0000664 0001750 0001750 00000011570 12206661545 023160 0 ustar jamespage jamespage [auto-props]
*.apt = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.c = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.c++ = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.cpp = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.cs = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.css = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.dtd = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.ent = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.fml = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.groovy = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.h = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.h++ = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.hpp = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.html = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.idl = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.include = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.java = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.js = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.jsp = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.ldf = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.ldif = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.mak = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.mdo = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.php = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.rb = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.rtf = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.sql = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.svg = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.t2t = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.vm = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.xhtml = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.xml = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.xsd = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.xsl = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.xslt = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
Makefile = svn:eol-style=native;svn:keywords=Author Date Id HeadURL Revision
*.launch = svn:eol-style=native
*.MF = svn:eol-style=native
*.properties = svn:eol-style=native
*.script = svn:eol-style=native
*.txt = svn:eol-style=native
*.dsp = svn:eol-style=CRLF
*.dsw = svn:eol-style=CRLF
*.iml = svn:eol-style=LF
*.bat = svn:eol-style=CRLF;svn:executable;svn:keywords=Author Date Id HeadURL Revision
*.cmd = svn:eol-style=CRLF;svn:executable;svn:keywords=Author Date Id HeadURL Revision
*.ksh = svn:eol-style=LF;svn:executable;svn:keywords=Author Date Id HeadURL Revision
*.sh = svn:eol-style=LF;svn:executable;svn:keywords=Author Date Id HeadURL Revision
*.pl = svn:eol-style=native;svn:executable;svn:keywords=Author Date Id HeadURL Revision
*.py = svn:eol-style=native;svn:executable;svn:keywords=Author Date Id HeadURL Revision
*.bmp = svn:mime-type=image/bmp;svn:needs-lock=*
*.gif = svn:mime-type=image/gif;svn:needs-lock=*
*.ico = svn:mime-type=image/x-icon;svn:needs-lock=*
*.jpeg = svn:mime-type=image/jpeg;svn:needs-lock=*
*.jpg = svn:mime-type=image/jpeg;svn:needs-lock=*
*.png = svn:mime-type=image/png;svn:needs-lock=*
*.tif = svn:mime-type=image/tiff;svn:needs-lock=*
*.tiff = svn:mime-type=image/tiff;svn:needs-lock=*
*.doc = svn:mime-type=application/msword;svn:needs-lock=*
*.jar = svn:mime-type=application/octet-stream;svn:needs-lock=*
*.odc = svn:mime-type=application/vnd.oasis.opendocument.chart;svn:needs-lock=*
*.odf = svn:mime-type=application/vnd.oasis.opendocument.formula;svn:needs-lock=*
*.odg = svn:mime-type=application/vnd.oasis.opendocument.graphics;svn:needs-lock=*
*.odi = svn:mime-type=application/vnd.oasis.opendocument.image;svn:needs-lock=*
*.odp = svn:mime-type=application/vnd.oasis.opendocument.presentation;svn:needs-lock=*
*.ods = svn:mime-type=application/vnd.oasis.opendocument.spreadsheet;svn:needs-lock=*
*.odt = svn:mime-type=application/vnd.oasis.opendocument.text;svn:needs-lock=*
*.pdf = svn:mime-type=application/pdf;svn:needs-lock=*
*.ppt = svn:mime-type=application/vnd.ms-powerpoint;svn:needs-lock=*
*.ser = svn:mime-type=application/octet-stream;svn:needs-lock=*
*.swf = svn:mime-type=application/x-shockwave-flash;svn:needs-lock=*
*.vsd = svn:mime-type=application/x-visio;svn:needs-lock=*
*.xls = svn:mime-type=application/vnd.ms-excel;svn:needs-lock=*
*.zip = svn:mime-type=application/zip;svn:needs-lock=*
jenkins-xstream-1.4.4-jenkins-4/xstream-builder/ 0000775 0001750 0001750 00000000000 12206661545 022234 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-builder/pom.xml 0000664 0001750 0001750 00000002227 12206661545 023554 0 ustar jamespage jamespage 4.0.0com.thoughtworks.xstreamxstream-parent1.4.2-SNAPSHOTxstream-builderjarXStream Builder${project.groupId}xstream${project.version}junitjunit
jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/ 0000775 0001750 0001750 00000000000 12206661545 023023 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/ 0000775 0001750 0001750 00000000000 12206661545 023744 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/ 0000775 0001750 0001750 00000000000 12206661545 024522 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/ 0000775 0001750 0001750 00000000000 12206661545 027272 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/xstream/ 0000775 0001750 0001750 00000000000 12206661545 030755 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/xstream/builder/ 0000775 0001750 0001750 00000000000 12206661545 032403 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/xstream/builder/FieldConfig.java jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/xstream/builder/FieldConfi0000664 0001750 0001750 00000003101 12206661545 034323 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 13. July 2007 by Guilherme Silveira
*/
package com.thoughtworks.xstream.builder;
import java.util.ArrayList;
import java.util.List;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.builder.processor.FieldConfigProcessor;
import com.thoughtworks.xstream.builder.processor.TypeConfigProcessor;
/**
* A field configuration.
*
* @author Guilherme Silveira
* @TODO gs: extract public interface, keep implementation hidden from the end user?
*/
public class FieldConfig implements TypeConfigProcessor {
private final String fieldName;
private final List processors;
public FieldConfig(String fieldName) {
this.fieldName = fieldName;
this.processors = new ArrayList();
}
public void process(XStream instance, Class type) {
for(int i=0;i < processors.size();i++) {
FieldConfigProcessor node = (FieldConfigProcessor) processors.get(i);
node.process(instance, type, fieldName);
}
}
public FieldConfig with(FieldConfigProcessor []processors) {
for (int i = 0; i < processors.length; i++) {
FieldConfigProcessor processor = processors[i];
this.processors.add(processor);
}
return this;
}
public FieldConfig with(FieldConfigProcessor processor) {
this.processors.add(processor);
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/xstream/builder/XStreamBuilder.java jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/java/com/thoughtworks/xstream/builder/XStreamBui0000664 0001750 0001750 00000007641 12206661545 034361 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 14. May 2007 by Guilherme Silveira
*/
package com.thoughtworks.xstream.builder;
import java.util.ArrayList;
import java.util.List;
import com.thoughtworks.xstream.ReadOnlyXStream;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.builder.processor.AbsoluteReferencesProcessor;
import com.thoughtworks.xstream.builder.processor.AliasFieldProcessor;
import com.thoughtworks.xstream.builder.processor.AliasTypeProcessor;
import com.thoughtworks.xstream.builder.processor.ConfigProcessor;
import com.thoughtworks.xstream.builder.processor.ConverterProcessor;
import com.thoughtworks.xstream.builder.processor.FieldConfigProcessor;
import com.thoughtworks.xstream.builder.processor.IdReferencesProcessor;
import com.thoughtworks.xstream.builder.processor.IgnoreFieldProcessor;
import com.thoughtworks.xstream.builder.processor.ImplementedByProcessor;
import com.thoughtworks.xstream.builder.processor.NoReferencesProcessor;
import com.thoughtworks.xstream.builder.processor.TypeConfigProcessor;
import com.thoughtworks.xstream.builder.processor.annotations.AnnotatedTypeProcessor;
import com.thoughtworks.xstream.converters.Converter;
/**
* The base xstream builder. This is xstream's new entrypoint. Instantiate a builder, configure it
* and invoke buildXStream at the end.
*
* @author Guilherme Silveira
* @since upcoming
*/
public class XStreamBuilder {
private final List childrenNodes = new ArrayList();
protected TypeConfig handle(Class type) {
TypeConfig classConfig = new TypeConfig(type);
childrenNodes.add(classConfig);
return classConfig;
}
public ReadOnlyXStream buildXStream() {
XStream instance = createBasicInstance();
for(int i=0;i\n";
assertBothWays(builder.buildXStream(), root, expected);
}
public void testHandleCorrectlyIdReferences() {
XStreamBuilder builder = new XStreamBuilder() {
{
with(idReferences());
handle(Home.class).with(alias("home"));
}
};
List root = new ArrayList();
root.add(new Home());
root.add(root.get(0));
String expected = "\n \n \n";
assertBothWays(builder.buildXStream(), root, expected);
}
public void testHandleCorrectlyNoReferences() {
XStreamBuilder builder = new XStreamBuilder() {
{
with(noReferences());
handle(Home.class).with(alias("home"));
}
};
List root = new ArrayList();
root.add(new Home());
root.add(root.get(0));
String expected = "\n \n \n";
assertBothWays(builder.buildXStream(), root, expected);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/test/com/thoughtworks/acceptance/annotations/ 0000775 0001750 0001750 00000000000 12206661545 033753 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000204 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/test/com/thoughtworks/acceptance/annotations/XStreamBuilderAnnotationsTest.java jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/test/com/thoughtworks/acceptance/annotations/XSt0000664 0001750 0001750 00000002053 12206661545 034414 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 07. October 2007 by Guilherme Silveira
*/
package com.thoughtworks.acceptance.annotations;
import com.thoughtworks.acceptance.AbstractBuilderAcceptanceTest;
import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.builder.XStreamBuilder;
public class XStreamBuilderAnnotationsTest extends AbstractBuilderAcceptanceTest {
@XStreamAlias("annotated")
public static class Annotated {
}
public void testHandleCorrectlyAnnotatedClasses() {
XStreamBuilder builder = new XStreamBuilder() {
{
handle(Annotated.class).with(annotated());
}
};
Annotated root = new Annotated();
String expected = "";
assertBothWays(builder.buildXStream(), root, expected);
}
}
././@LongLink 0000644 0000000 0000000 00000000170 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/test/com/thoughtworks/acceptance/AbstractBuilderAcceptanceTest.java jenkins-xstream-1.4.4-jenkins-4/xstream-builder/src/test/com/thoughtworks/acceptance/AbstractBuilder0000664 0001750 0001750 00000021457 12206661545 034424 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 14. May 2007 by Guilherme Silveira
*/
package com.thoughtworks.acceptance;
import java.lang.reflect.Array;
import java.io.ByteArrayOutputStream;
import java.io.ByteArrayInputStream;
import java.io.StringReader;
import java.io.StringWriter;
import junit.framework.AssertionFailedError;
import junit.framework.TestCase;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerException;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
import com.thoughtworks.xstream.ReadOnlyXStream;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.binary.BinaryStreamWriter;
import com.thoughtworks.xstream.io.binary.BinaryStreamReader;
import com.thoughtworks.xstream.io.xml.XppDriver;
public abstract class AbstractBuilderAcceptanceTest extends TestCase {
protected transient XStream xstream = createXStream();
protected XStream createXStream() {
return new XStream(createDriver());
}
protected HierarchicalStreamDriver createDriver() {
// if the system property is set, use it to load the driver
String driver = null;
try {
driver = System.getProperty("xstream.driver");
if (driver != null) {
System.out.println("Using driver: " + driver);
Class type = Class.forName(driver);
return (HierarchicalStreamDriver) type.newInstance();
}
}
catch (Exception e) {
throw new RuntimeException("Could not load driver: " + driver);
}
return new XppDriver();
}
protected Object assertBothWaysNormalized(Object root, String xml, final String match,
final String templateSelect, final String sortSelect) {
try {
// First, serialize the object to XML and check it matches the expected XML.
String resultXml = normalizedXML(
toXML(root), new String[]{match}, templateSelect, sortSelect);
assertEquals(
normalizedXML(xml, new String[]{match}, templateSelect, sortSelect), resultXml);
// Now deserialize the XML back into the object and check it equals the original
// object.
Object resultRoot = xstream.fromXML(resultXml);
assertObjectsEqual(root, resultRoot);
// While we're at it, let's check the binary serialization works...
assertBinarySerialization(root);
return resultRoot;
} catch (TransformerException e) {
throw new AssertionFailedError("Cannot normalize XML: " + e.getMessage());
// .initCause(e); ... still JDK 1.3
}
}
protected Object assertBothWays(Object root, String xml) {
// First, serialize the object to XML and check it matches the expected XML.
String resultXml = toXML(root);
assertEquals(xml, resultXml);
// Now deserialize the XML back into the object and check it equals the original object.
Object resultRoot = xstream.fromXML(resultXml);
assertObjectsEqual(root, resultRoot);
// While we're at it, let's check the binary serialization works...
assertBinarySerialization(root);
return resultRoot;
}
private void assertBinarySerialization(Object root) {
// Serialize as binary
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
xstream.marshal(root, new BinaryStreamWriter(outputStream));
// Deserialize the binary and check it equals the original object.
ByteArrayInputStream inputStream = new ByteArrayInputStream(outputStream.toByteArray());
Object binaryResult = xstream.unmarshal(new BinaryStreamReader(inputStream));
assertObjectsEqual(root, binaryResult);
}
protected Object assertWithAsymmetricalXml(Object root, String inXml, String outXml) {
String resultXml = toXML(root);
assertEquals(outXml, resultXml);
Object resultRoot = xstream.fromXML(inXml);
assertObjectsEqual(root, resultRoot);
return resultRoot;
}
/**
* Allow derived classes to decide how to turn the object into XML text
*/
protected String toXML(Object root) {
return xstream.toXML(root);
}
/**
* More descriptive version of assertEquals
*/
protected void assertObjectsEqual(Object expected, Object actual) {
if (expected == null) {
assertNull(actual);
} else {
assertNotNull("Should not be null", actual);
if (actual.getClass().isArray()) {
assertArrayEquals(expected, actual);
} else {
// assertEquals(expected.getClass(), actual.getClass());
if (!expected.equals(actual)) {
assertEquals("Object deserialization failed",
"DESERIALIZED OBJECT\n" + xstream.toXML(expected),
"DESERIALIZED OBJECT\n" + xstream.toXML(actual));
}
}
}
}
protected void assertArrayEquals(Object expected, Object actual) {
assertEquals(Array.getLength(expected), Array.getLength(actual));
for (int i = 0; i < Array.getLength(expected); i++) {
assertEquals(Array.get(expected, i), Array.get(actual, i));
}
}
protected void assertByteArrayEquals(byte expected[], byte actual[]) {
assertEquals(dumpBytes(expected), dumpBytes(actual));
}
private String dumpBytes(byte bytes[]) {
StringBuffer result = new StringBuffer();
for (int i = 0; i < bytes.length; i++) {
result.append(bytes[i]).append(' ');
if (bytes[i] < 100) result.append(' ');
if (bytes[i] < 10) result.append(' ');
if (bytes[i] >= 0) result.append(' ');
if (i % 16 == 15) result.append('\n');
}
return result.toString();
}
protected String normalizedXML(final String xml, final String[] matches,
final String templateSelect, final String sortSelect) throws TransformerException {
final StringBuffer match = new StringBuffer();
for (int i = 0; i < matches.length; i++) {
if (i > 0) {
match.append('|');
}
match.append(matches[i]);
}
final StringBuffer sort = new StringBuffer();
if (sortSelect != null) {
sort.append(" select=\"");
sort.append(sortSelect);
sort.append('"');
}
final TransformerFactory transformerFactory = TransformerFactory.newInstance();
final Transformer transformer = transformerFactory
.newTransformer(new StreamSource(
new StringReader(
""
+ "\n"
+ "\n"
+ "\n"
+ " \n"
+ " \n"
+ " \n"
+ " \n"
+ " \n"
+ "\n"
+ "\n"
+ " \n"
+ " \n"
+ " \n"
+ "\n"
+ "")));
final StringWriter writer = new StringWriter();
transformer
.transform(new StreamSource(new StringReader(xml)), new StreamResult(writer));
return writer.toString();
}
protected Object assertBothWays(ReadOnlyXStream xstream, Object root, String xml) {
// First, serialize the object to XML and check it matches the expected XML.
String resultXml = xstream.toXML(root);
assertEquals(xml, resultXml);
// Now deserialize the XML back into the object and check it equals the original object.
// We do not really care about arrays and so on, because the tests are related to xstreambuilder
Object resultRoot = xstream.fromXML(resultXml);
assertEquals(xml, xstream.toXML(resultRoot));
return resultRoot;
}
}
jenkins-xstream-1.4.4-jenkins-4/.gitignore 0000664 0001750 0001750 00000000007 12206661545 021112 0 ustar jamespage jamespage target
jenkins-xstream-1.4.4-jenkins-4/pom.xml 0000664 0001750 0001750 00000045340 12206661545 020450 0 ustar jamespage jamespage 4.0.0org.codehauscodehaus-parent3com.thoughtworks.xstreamxstream-parentpom1.4.4XStream Parent2004XStreamhttp://xstream.codehaus.orgjdk15-ge[1.5,)jdk151.51.8.0.103.3.2.GAjdk141.41.31.3http://docs.oracle.com/javase/1.4.2/docs/api/1.8.0.103.3.2.GAxstreamxstream-hibernatexstream-benchmarkxstream-distributionBSD stylehttp://xstream.codehaus.org/license.htmlrepocommons-iocommons-io${version.commons.io}commons-clicommons-cli${version.commons.cli}commons-langcommons-lang${version.commons.lang}cglibcglib-nodep${version.cglib.nodep}javassistjavassist${version.javaassist}dom4jdom4j${version.dom4j}xml-apisxml-apisorg.jdomjdom${version.org.jdom}joda-timejoda-time${version.joda-time}com.megginson.saxxml-writer${version.com.megginson.sax.xml-writer}xml-apisxml-apisstaxstax${version.stax}staxstax-api${version.stax.api}org.codehaus.woodstoxwstx-asl${version.org.codehaus.woodstox.asl}xomxom${version.xom}xercesxmlParserAPIsxercesxercesImplxalanxalanjaxenjaxenxpp3xpp3_min${version.xpp3}net.sf.kxmlkxml2-min${version.net.sf.kxml.kxml2}net.sf.kxmlkxml2${version.net.sf.kxml.kxml2}xmlpullxmlpull${version.xmlpull}orooro${version.oro}org.jsonjson${version.org.json}org.codehaus.jettisonjettison${version.org.codehaus.jettison}xml-apisxml-apis${version.xml-apis}xercesxercesImpl${version.xerces.impl}org.hibernatehibernate-core${version.org.hibernate.core}org.hsqldbhsqldb${version.hsqldb}org.slf4jslf4j-api${version.org.slf4j}runtimeorg.slf4jslf4j-simple${version.org.slf4j}runtimejunitjunit${version.junit}testjmockjmock${version.jmock}test${basedir}/src/java${basedir}/src/java**/*.properties**/*.xml${basedir}/src/test${basedir}/src/test**/*.xml**/*.xsl**/*.txtorg.apache.maven.pluginsmaven-antrun-plugin${version.plugin.maven.antrun}org.apache.maven.pluginsmaven-assembly-plugin${version.plugin.maven.assembly}org.apache.maven.pluginsmaven-clean-plugin${version.plugin.maven.clean}org.apache.maven.pluginsmaven-compiler-plugin${version.plugin.maven.compiler}${version.java.source}${version.java.target}org.apache.maven.pluginsmaven-dependency-plugin${version.plugin.maven.dependency}org.apache.maven.pluginsmaven-deploy-plugin${version.plugin.maven.deploy}org.apache.maven.pluginsmaven-eclipse-plugintrueorg.apache.maven.pluginsmaven-enforcer-plugin${version.plugin.maven.enforcer}org.apache.maven.pluginsmaven-install-plugin${version.plugin.maven.install}org.apache.maven.pluginsmaven-jar-plugin${version.plugin.maven.jar}org.apache.maven.pluginsmaven-javadoc-plugin${version.plugin.maven.javadoc}${version.java.source}
${link.javadoc.javase}
org.apache.maven.pluginsmaven-release-plugin${version.plugin.maven.release}deploytrueorg.apache.maven.pluginsmaven-resources-plugin${version.plugin.maven.resources}org.apache.maven.pluginsmaven-site-plugin${version.plugin.maven.site}org.apache.maven.pluginsmaven-source-plugin${version.plugin.maven.source}attach-sourcespackagejar-no-forkorg.apache.maven.pluginsmaven-surefire-plugin${version.plugin.maven.surefire}oncetruefalse**/*Test.java**/*TestSuite.java**/Abstract*Test.java**/*$*.javajava.awt.headlesstrueorg.apache.maven.pluginsmaven-surefire-report-plugin${version.plugin.maven.surefire}org.codehaus.mojocobertura-maven-plugin${version.plugin.mojo.cobertura}cleanorg.codehaus.mojojxr-maven-plugin${version.plugin.mojo.jxr}org.codehaus.xsitexsite-maven-plugin${version.plugin.codehaus.xsite}org.apache.maven.pluginsmaven-release-pluginhttps://svn.codehaus.org/xstream/tagsorg.apache.maven.wagonwagon-webdav${version.org.apache.maven.wagon.webdev}codehaus.orgCodehaus XStream Sitedav:https://dav.codehaus.org/xstreamscm:svn:http://svn.codehaus.org/xstream/tags/XSTREAM_1_4_4scm:svn:https://svn.codehaus.org/xstream/tags/XSTREAM_1_4_4http://fisheye.codehaus.org/browse/xstream/tags/XSTREAM_1_4_41.51.51.2.11.12.12.22.12.12.31.0-alpha-22.22.22.72.12.22.0-beta-62.1.22.4.32.02.0-beta-11.0-beta-22.20.21.11.42.41.6.12.2.83.12.1.GA1.0.11.63.8.12.3.01.23.2.74.1.4.Final1.1200807011.6.12.0.81.2.01.0.12.8.11.3.041.1.3.11.11.1.4chttp://docs.oracle.com/javase/7/docs/api/
jenkins-xstream-1.4.4-jenkins-4/README.txt 0000664 0001750 0001750 00000001776 12206661545 020636 0 ustar jamespage jamespage
***********
********************** XStream **********************
***********
"Java to XML Serialization, and back again"
--[ Binaries ]-----------------------------------------------
All binary artifacts are in the 'lib' directory. These include the
xstream jars and any other library used at build time,
or optional runtime extras. kXML2 is recommend for use as it will
greatly improve the performance of XStream.
--[ Documentation ]------------------------------------------
Documentation can be found in docs/index.html. This includes:
* Introduction and tutorial
* JavaDoc
* Change log
* Frequently asked questions
--[ Source ]-------------------------------------------------
The complete source for XStream is bundled. This includes:
* Main API [src/java]
* Unit tests [src/test]
* Maven build files [pom.xml]
* Dependencies [lib]
-------------------------------------------------------------
-XStream Ccommitters
http://xstream.codehaus.org/
jenkins-xstream-1.4.4-jenkins-4/settings-template.xml 0000664 0001750 0001750 00000001520 12206661545 023316 0 ustar jamespage jamespage
codehaus-nexus-snapshotsyour-xircles-idyour-xircles-pwdcodehaus-nexus-stagingyour-xircles-idyour-xircles-pwdcodehaus.org
jenkins-xstream-1.4.4-jenkins-4/BUILD.txt 0000664 0001750 0001750 00000000476 12206661545 020534 0 ustar jamespage jamespage For Java 5 or higher build with Maven 2.2 or 3
For Java 1.4 build with Maven 2.0.11
Before building:
To build:
mvn clean install
Before deploying:
copy settings-template.xml to ~/.m2/settings.xml adding your Codehaus DAV username and passwords.
To deploy (optionally adding sources and javadoc jars):
mvn deploy
jenkins-xstream-1.4.4-jenkins-4/xstream/ 0000775 0001750 0001750 00000000000 12206661545 020610 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/pom.xml 0000664 0001750 0001750 00000022376 12206661545 022137 0 ustar jamespage jamespage 4.0.0com.thoughtworks.xstreamxstream-parent1.4.4xstreamjarXStream Coreorg.jvnet.hudson1.4.4-jenkins-4dom4jdom4jtrueorg.jdomjdomtruejoda-timejoda-timetruestaxstaxtrueorg.codehaus.woodstoxwstx-asltruestaxstax-apitruexomxomtruexmlpullxmlpullnet.sf.kxmlkxml2-mintruenet.sf.kxmlkxml2truexpp3xpp3_mincglibcglib-nodeptrueorg.jsonjsontrueorg.codehaus.jettisonjettisontruejunitjunittestjmockjmocktestcom.megginson.saxxml-writertestoroorotestcommons-langcommons-langtestmaven-compiler-plugin1.51.5-XDiagnose.symbol.filemaven-source-pluginjarpackageorg.apache.maven.pluginsmaven-dependency-plugincomplete-test-classpathprocess-test-resourcescopytarget/libproxytoysproxytoys0.2.1collect-dependenciespackagecopy-dependenciestarget/dependenciesruntimeorg.apache.maven.pluginsmaven-jar-plugintest-jar**/AbstractAcceptanceTest.*maven.jenkins-ci.orghttp://maven.jenkins-ci.org:8081/content/repositories/releasesjdk15-ge[1.5,)org.apache.maven.pluginsmaven-javadoc-pluginattach-javadocpackagejarcom.thoughtworks.xstream.core.utilorg.apache.maven.pluginsmaven-source-pluginjdk141.4org.apache.maven.pluginsmaven-compiler-plugin**/annotations/***/AnnotationMapper***/EnumMapper***/enums/***/basic/StringBuilder***/basic/UUID***/annotations/***/enums/***/reflection/PureJavaReflectionProvider15Test***/acceptance/Basic15TypesTest***/acceptance/Concurrent15TypesTest*xml-apisxml-apisxercesxercesImpl1.0.1org.apache.maven.pluginsmaven-javadoc-plugin${version.plugin.maven.javadoc}com.thoughtworks.xstream.core.util${version.java.source}
${link.javadoc.javase}
org.apache.maven.pluginsmaven-surefire-report-plugin${version.plugin.maven.surefire}org.codehaus.mojocobertura-maven-plugin${version.plugin.mojo.cobertura}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/ 0000775 0001750 0001750 00000000000 12206661545 021377 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/ 0000775 0001750 0001750 00000000000 12206661545 022320 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/ 0000775 0001750 0001750 00000000000 12206661545 023076 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/ 0000775 0001750 0001750 00000000000 12206661545 025646 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/ 0000775 0001750 0001750 00000000000 12206661545 027331 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ 0000775 0001750 0001750 00000000000 12206661545 030261 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000146 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/SequenceGenerator.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/SequenceGenerator.jav0000664 0001750 0001750 00000001230 12206661545 034376 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2008 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 16. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
public class SequenceGenerator implements ReferenceByIdMarshaller.IDGenerator {
private int counter;
public SequenceGenerator(int startsAt) {
this.counter = startsAt;
}
public String next(Object item) {
return String.valueOf(counter++);
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/AbstractTreeMarshallingStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/AbstractTreeMarshalli0000664 0001750 0001750 00000003447 12206661545 034434 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2008, 2009 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 26.09.2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.MarshallingStrategy;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.DataHolder;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Basic functionality of a tree based marshalling strategy.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.3
*/
public abstract class AbstractTreeMarshallingStrategy implements MarshallingStrategy {
public Object unmarshal(Object root, HierarchicalStreamReader reader, DataHolder dataHolder, ConverterLookup converterLookup, Mapper mapper) {
TreeUnmarshaller context = createUnmarshallingContext(root, reader, converterLookup, mapper);
return context.start(dataHolder);
}
public void marshal(HierarchicalStreamWriter writer, Object obj, ConverterLookup converterLookup, Mapper mapper, DataHolder dataHolder) {
TreeMarshaller context = createMarshallingContext(writer, converterLookup, mapper);
context.start(obj, dataHolder);
}
protected abstract TreeUnmarshaller createUnmarshallingContext(Object root,
HierarchicalStreamReader reader, ConverterLookup converterLookup, Mapper mapper);
protected abstract TreeMarshaller createMarshallingContext(
HierarchicalStreamWriter writer, ConverterLookup converterLookup, Mapper mapper);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/TreeUnmarshaller.java0000664 0001750 0001750 00000012020 12206661545 034374 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 15. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import java.util.Iterator;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.DataHolder;
import com.thoughtworks.xstream.converters.ErrorReporter;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.core.util.PrioritizedList;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.mapper.Mapper;
public class TreeUnmarshaller implements UnmarshallingContext {
private Object root;
protected HierarchicalStreamReader reader;
private ConverterLookup converterLookup;
private Mapper mapper;
private FastStack types = new FastStack(16);
private DataHolder dataHolder;
private final PrioritizedList validationList = new PrioritizedList();
public TreeUnmarshaller(
Object root, HierarchicalStreamReader reader, ConverterLookup converterLookup,
Mapper mapper) {
this.root = root;
this.reader = reader;
this.converterLookup = converterLookup;
this.mapper = mapper;
}
public Object convertAnother(Object parent, Class type) {
return convertAnother(parent, type, null);
}
public Object convertAnother(Object parent, Class type, Converter converter) {
type = mapper.defaultImplementationOf(type);
if (converter == null) {
converter = converterLookup.lookupConverterForType(type);
} else {
if (!converter.canConvert(type)) {
ConversionException e = new ConversionException(
"Explicit selected converter cannot handle type");
e.add("item-type", type.getName());
e.add("converter-type", converter.getClass().getName());
throw e;
}
}
return convert(parent, type, converter);
}
protected Object convert(Object parent, Class type, Converter converter) {
try {
types.push(type);
Object result = converter.unmarshal(reader, this);
types.popSilently();
return result;
} catch (ConversionException conversionException) {
addInformationTo(conversionException, type, converter, parent);
throw conversionException;
} catch (RuntimeException e) {
ConversionException conversionException = new ConversionException(e);
addInformationTo(conversionException, type, converter, parent);
throw conversionException;
}
}
private void addInformationTo(ErrorWriter errorWriter, Class type, Converter converter, Object parent) {
errorWriter.add("class", type.getName());
errorWriter.add("required-type", getRequiredType().getName());
errorWriter.add("converter-type", converter.getClass().getName());
if (converter instanceof ErrorReporter) {
((ErrorReporter)converter).appendErrors(errorWriter);
}
if (parent instanceof ErrorReporter) {
((ErrorReporter)parent).appendErrors(errorWriter);
}
reader.appendErrors(errorWriter);
}
public void addCompletionCallback(Runnable work, int priority) {
validationList.add(work, priority);
}
public Object currentObject() {
return types.size() == 1 ? root : null;
}
public Class getRequiredType() {
return (Class)types.peek();
}
public Object get(Object key) {
lazilyCreateDataHolder();
return dataHolder.get(key);
}
public void put(Object key, Object value) {
lazilyCreateDataHolder();
dataHolder.put(key, value);
}
public Iterator keys() {
lazilyCreateDataHolder();
return dataHolder.keys();
}
private void lazilyCreateDataHolder() {
if (dataHolder == null) {
dataHolder = new MapBackedDataHolder();
}
}
public Object start(DataHolder dataHolder) {
this.dataHolder = dataHolder;
Class type = HierarchicalStreams.readClassType(reader, mapper);
Object result = convertAnother(null, type);
Iterator validations = validationList.iterator();
while (validations.hasNext()) {
Runnable runnable = (Runnable)validations.next();
runnable.run();
}
return result;
}
protected Mapper getMapper() {
return this.mapper;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/BaseException.java 0000664 0001750 0001750 00000001355 12206661545 033661 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 14. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.XStreamException;
/**
* JDK1.3 friendly exception that retains cause.
* @deprecated As of 1.3, use {@link XStreamException} instead
*/
public abstract class BaseException extends RuntimeException {
protected BaseException(String message) {
super(message);
}
public abstract Throwable getCause();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/JVM.java 0000664 0001750 0001750 00000027771 12206661545 031576 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010, 2011, 2012, 2013 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 09. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.reflection.PureJavaReflectionProvider;
import com.thoughtworks.xstream.converters.reflection.ReflectionProvider;
import com.thoughtworks.xstream.core.util.PresortedMap;
import com.thoughtworks.xstream.core.util.PresortedSet;
import com.thoughtworks.xstream.core.util.WeakCache;
import java.lang.reflect.Field;
import java.security.AccessControlException;
import java.text.AttributedString;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Map;
import java.util.SortedMap;
import java.util.SortedSet;
import java.util.TreeMap;
import java.util.TreeSet;
public class JVM implements Caching {
private ReflectionProvider reflectionProvider;
private transient Map loaderCache = new WeakCache(new HashMap());
private final boolean supportsAWT = loadClass("java.awt.Color", false) != null;
private final boolean supportsSwing = loadClass("javax.swing.LookAndFeel", false) != null;
private final boolean supportsSQL = loadClass("java.sql.Date") != null;
private static final boolean optimizedTreeSetAddAll;
private static final boolean optimizedTreeMapPutAll;
private static final boolean canParseUTCDateFormat;
private static final String vendor = System.getProperty("java.vm.vendor");
private static final String runtime = System.getProperty("java.runtime.name");
private static final float majorJavaVersion = getMajorJavaVersion();
private static final boolean reverseFieldOrder = isIBM() && !is15();
private static final float DEFAULT_JAVA_VERSION = 1.4f;
static {
Comparator comparator = new Comparator() {
public int compare(Object o1, Object o2) {
throw new RuntimeException();
}
};
boolean test = true;
SortedMap map = new PresortedMap(comparator);
map.put("one", null);
map.put("two", null);
try {
new TreeMap(comparator).putAll(map);
} catch (RuntimeException e) {
test = false;
}
optimizedTreeMapPutAll = test;
SortedSet set = new PresortedSet(comparator);
set.addAll(map.keySet());
try {
new TreeSet(comparator).addAll(set);
test = true;
} catch (RuntimeException e) {
test = false;
}
optimizedTreeSetAddAll = test;
try {
new SimpleDateFormat("z").parse("UTC");
test = true;
} catch (ParseException e) {
test = false;
}
canParseUTCDateFormat = test;
}
/**
* Parses the java version system property to determine the major java version,
* i.e. 1.x
*
* @return A float of the form 1.x
*/
private static final float getMajorJavaVersion() {
try {
return isAndroid() ? 1.5f : Float.parseFloat(System.getProperty("java.specification.version"));
} catch ( NumberFormatException e ){
// Some JVMs may not conform to the x.y.z java.version format
return DEFAULT_JAVA_VERSION;
}
}
/**
* @deprecated As of 1.4.4, minimal JDK version is 1.4 already
*/
public static boolean is14() {
return majorJavaVersion >= 1.4f;
}
/**
* @deprecated As of 1.4.4, minimal JDK version will be 1.6 for next major release
*/
public static boolean is15() {
return majorJavaVersion >= 1.5f;
}
/**
* @deprecated As of 1.4.4, minimal JDK version will be 1.6 for next major release
*/
public static boolean is16() {
return majorJavaVersion >= 1.6f;
}
private static boolean isIcedTea() {
return runtime.indexOf("IcedTea") != -1;
}
private static boolean isOpenJDK() {
return runtime.indexOf("OpenJDK") != -1;
}
/**
* @since 1.4
*/
public static boolean is17() {
return majorJavaVersion >= 1.7f;
}
/**
* @since 1.4
*/
public static boolean is18() {
return majorJavaVersion >= 1.8f;
}
private static boolean isSun() {
return vendor.indexOf("Sun") != -1;
}
private static boolean isOracle() {
return vendor.indexOf("Oracle") != -1;
}
private static boolean isApple() {
return vendor.indexOf("Apple") != -1;
}
private static boolean isHPUX() {
return vendor.indexOf("Hewlett-Packard Company") != -1;
}
private static boolean isIBM() {
return vendor.indexOf("IBM") != -1;
}
private static boolean isBlackdown() {
return vendor.indexOf("Blackdown") != -1;
}
private static boolean isDiablo() {
return vendor.indexOf("FreeBSD Foundation") != -1;
}
/**
* @since 1.4
*/
private static boolean isAndroid() {
return vendor.indexOf("Android") != -1;
}
/*
* Support for sun.misc.Unsafe and sun.reflect.ReflectionFactory is present
* in JRockit versions R25.1.0 and later, both 1.4.2 and 5.0 (and in future
* 6.0 builds).
*/
private static boolean isBEAWithUnsafeSupport() {
// This property should be "BEA Systems, Inc."
if (vendor.indexOf("BEA") != -1) {
/*
* Recent 1.4.2 and 5.0 versions of JRockit have a java.vm.version
* string starting with the "R" JVM version number, i.e.
* "R26.2.0-38-57237-1.5.0_06-20060209..."
*/
String vmVersion = System.getProperty("java.vm.version");
if (vmVersion.startsWith("R")) {
/*
* We *could* also check that it's R26 or later, but that is
* implicitly true
*/
return true;
}
/*
* For older JRockit versions we can check java.vm.info. JRockit
* 1.4.2 R24 -> "Native Threads, GC strategy: parallel" and JRockit
* 5.0 R25 -> "R25.2.0-28".
*/
String vmInfo = System.getProperty("java.vm.info");
if (vmInfo != null) {
// R25.1 or R25.2 supports Unsafe, other versions do not
return (vmInfo.startsWith("R25.1") || vmInfo
.startsWith("R25.2"));
}
}
// If non-BEA, or possibly some very old JRockit version
return false;
}
private static boolean isHitachi() {
return vendor.indexOf("Hitachi") != -1;
}
private static boolean isSAP() {
return vendor.indexOf("SAP AG") != -1;
}
public Class loadClass(String name) {
return loadClass(name, true);
}
/**
* @since 1.4.4
*/
public Class loadClass(String name, boolean initialize) {
Class cached = (Class) loaderCache.get(name);
if (cached != null) {
return cached;
}
try {
Class clazz = Class.forName(name, initialize, getClass().getClassLoader());
loaderCache.put(name, clazz);
return clazz;
} catch (LinkageError e) {
return null;
} catch (ClassNotFoundException e) {
return null;
}
}
public synchronized ReflectionProvider bestReflectionProvider() {
if (reflectionProvider == null) {
try {
String className = null;
if (canUseSun14ReflectionProvider()) {
className = "com.thoughtworks.xstream.converters.reflection.Sun14ReflectionProvider";
}
if (className != null) {
Class cls = loadClass(className);
if (cls != null) {
reflectionProvider = (ReflectionProvider) cls.newInstance();
}
}
if (reflectionProvider == null) {
reflectionProvider = new PureJavaReflectionProvider();
}
} catch (InstantiationException e) {
reflectionProvider = new PureJavaReflectionProvider();
} catch (IllegalAccessException e) {
reflectionProvider = new PureJavaReflectionProvider();
} catch (AccessControlException e) {
// thrown when trying to access sun.misc package in Applet context.
reflectionProvider = new PureJavaReflectionProvider();
}
}
return reflectionProvider;
}
private boolean canUseSun14ReflectionProvider() {
return (isSun()
|| isOpenJDK()
|| isIcedTea()
|| isOracle()
|| isApple()
|| isHPUX()
|| isIBM()
|| isBlackdown()
|| isBEAWithUnsafeSupport()
|| isHitachi()
|| isSAP()
|| isDiablo())
&& is14()
&& loadClass("sun.misc.Unsafe") != null;
}
public static boolean reverseFieldDefinition() {
return reverseFieldOrder;
}
/**
* Checks if the jvm supports awt.
*/
public boolean supportsAWT() {
return this.supportsAWT;
}
/**
* Checks if the jvm supports swing.
*/
public boolean supportsSwing() {
return this.supportsSwing;
}
/**
* Checks if the jvm supports sql.
*/
public boolean supportsSQL() {
return this.supportsSQL;
}
/**
* Checks if TreeSet.addAll is optimized for SortedSet argument.
*
* @since 1.4
*/
public static boolean hasOptimizedTreeSetAddAll() {
return optimizedTreeSetAddAll;
}
/**
* Checks if TreeMap.putAll is optimized for SortedMap argument.
*
* @since 1.4
*/
public static boolean hasOptimizedTreeMapPutAll() {
return optimizedTreeMapPutAll;
}
public static boolean canParseUTCDateFormat() {
return canParseUTCDateFormat;
}
public void flushCache() {
loaderCache.clear();
}
private Object readResolve() {
loaderCache = new WeakCache(new HashMap());
return this;
}
public static void main(String[] args) {
boolean reverse = false;
Field[] fields = AttributedString.class.getDeclaredFields();
for (int i = 0; i < fields.length; i++) {
if (fields[i].getName().equals("text")) {
reverse = i > 3;
break;
}
}
if (reverse) {
fields = JVM.class.getDeclaredFields();
for (int i = 0; i < fields.length; i++) {
if (fields[i].getName().equals("reflectionProvider")) {
reverse = i > 2;
break;
}
}
}
JVM jvm = new JVM();
System.out.println("XStream JVM diagnostics");
System.out.println("java.specification.version: " + System.getProperty("java.specification.version"));
System.out.println("java.vm.vendor: " + vendor);
System.out.println("Version: " + majorJavaVersion);
System.out.println("XStream support for enhanced Mode: " + jvm.canUseSun14ReflectionProvider());
System.out.println("Supports AWT: " + jvm.supportsAWT());
System.out.println("Supports Swing: " + jvm.supportsSwing());
System.out.println("Supports SQL: " + jvm.supportsSQL());
System.out.println("Optimized TreeSet.addAll: " + hasOptimizedTreeSetAddAll());
System.out.println("Optimized TreeMap.putAll: " + hasOptimizedTreeMapPutAll());
System.out.println("Can parse UTC date format: " + canParseUTCDateFormat());
System.out.println("Reverse field order detected (only if JVM class itself has been compiled): " + reverse);
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByIdMarshallingStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByIdMarshall0000664 0001750 0001750 00000002243 12206661545 034337 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 16. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReferenceByIdMarshallingStrategy extends AbstractTreeMarshallingStrategy {
protected TreeUnmarshaller createUnmarshallingContext(Object root,
HierarchicalStreamReader reader, ConverterLookup converterLookup, Mapper mapper) {
return new ReferenceByIdUnmarshaller(root, reader, converterLookup, mapper);
}
protected TreeMarshaller createMarshallingContext(
HierarchicalStreamWriter writer, ConverterLookup converterLookup, Mapper mapper) {
return new ReferenceByIdMarshaller(writer, converterLookup, mapper);
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByIdMarshaller.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByIdMarshall0000664 0001750 0001750 00000003641 12206661545 034342 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 15. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.path.Path;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReferenceByIdMarshaller extends AbstractReferenceMarshaller {
private final IDGenerator idGenerator;
public static interface IDGenerator {
String next(Object item);
}
public ReferenceByIdMarshaller(HierarchicalStreamWriter writer,
ConverterLookup converterLookup,
Mapper mapper,
IDGenerator idGenerator) {
super(writer, converterLookup, mapper);
this.idGenerator = idGenerator;
}
public ReferenceByIdMarshaller(HierarchicalStreamWriter writer,
ConverterLookup converterLookup,
Mapper mapper) {
this(writer, converterLookup, mapper, new SequenceGenerator(1));
}
protected String createReference(Path currentPath, Object existingReferenceKey) {
return existingReferenceKey.toString();
}
protected Object createReferenceKey(Path currentPath, Object item) {
return idGenerator.next(item);
}
protected void fireValidReference(Object referenceKey) {
String attributeName = getMapper().aliasForSystemAttribute("id");
if (attributeName != null) {
writer.addAttribute(attributeName, referenceKey.toString());
}
}
}
././@LongLink 0000644 0000000 0000000 00000000162 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferencingMarshallingContext.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferencingMarshallin0000664 0001750 0001750 00000003503 12206661545 034447 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 06. May 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.io.path.Path;
/**
* A {@link MarshallingContext} that manages references.
*
* @author Jörg Schaible
* @since 1.4
*/
public interface ReferencingMarshallingContext extends MarshallingContext {
/**
* Retrieve the current path.
*
* @return the current path
* @since 1.4
* @deprecated As of 1.4.2
*/
Path currentPath();
/**
* Request the reference key for the given item
*
* @param item the item to lookup
* @return the reference key or null
* @since 1.4
*/
Object lookupReference(Object item);
/**
* Replace the currently marshalled item.
*
*
Use this method only, if you know exactly what you do! It is a special solution for
* Serializable types that make usage of the writeReplace method where the replacing object itself is referenced.
*
* @param original the original item to convert
* @param replacement the replacement item that is converted instead
* @since 1.4
*/
void replace(Object original, Object replacement);
/**
* Register an implicit element. This is typically some kind of collection. Note, that this object may not be
* referenced anywhere else in the object stream.
*
* @param item the object that is implicit
* @since 1.4
*/
void registerImplicit(Object item);
}
././@LongLink 0000644 0000000 0000000 00000000162 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/AbstractReferenceUnmarshaller.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/AbstractReferenceUnma0000664 0001750 0001750 00000005652 12206661545 034417 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2008, 2011 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 15. March 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core;
import java.util.HashMap;
import java.util.Map;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Abstract base class for a TreeUnmarshaller, that resolves references.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Mauro Talevi
* @since 1.2
*/
public abstract class AbstractReferenceUnmarshaller extends TreeUnmarshaller {
private static final Object NULL = new Object();
private Map values = new HashMap();
private FastStack parentStack = new FastStack(16);
public AbstractReferenceUnmarshaller(Object root, HierarchicalStreamReader reader,
ConverterLookup converterLookup, Mapper mapper) {
super(root, reader, converterLookup, mapper);
}
protected Object convert(Object parent, Class type, Converter converter) {
if (parentStack.size() > 0) { // handles circular references
Object parentReferenceKey = parentStack.peek();
if (parentReferenceKey != null) {
if (!values.containsKey(parentReferenceKey)) { // see AbstractCircularReferenceTest.testWeirdCircularReference()
values.put(parentReferenceKey, parent);
}
}
}
final Object result;
String attributeName = getMapper().aliasForSystemAttribute("reference");
String reference = attributeName == null ? null : reader.getAttribute(attributeName);
if (reference != null) {
Object cache = values.get(getReferenceKey(reference));
if (cache == null) {
final ConversionException ex = new ConversionException("Invalid reference");
ex.add("reference", reference);
throw ex;
}
result = cache == NULL ? null : cache;
} else {
Object currentReferenceKey = getCurrentReferenceKey();
parentStack.push(currentReferenceKey);
result = super.convert(parent, type, converter);
if (currentReferenceKey != null) {
values.put(currentReferenceKey, result == null ? NULL : result);
}
parentStack.popSilently();
}
return result;
}
protected abstract Object getReferenceKey(String reference);
protected abstract Object getCurrentReferenceKey();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ 0000775 0001750 0001750 00000000000 12206661545 031236 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/FastField.java 0000664 0001750 0001750 00000003310 12206661545 033737 0 ustar jamespage jamespage /*
* Copyright (C) 2008, 2010 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 13. October 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
public final class FastField {
private final String name;
private final String declaringClass;
public FastField(String definedIn, String name) {
this.name = name;
this.declaringClass = definedIn;
}
public FastField(Class definedIn, String name) {
this(definedIn == null ? null : definedIn.getName(), name);
}
public String getName() {
return this.name;
}
public String getDeclaringClass() {
return this.declaringClass;
}
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (obj instanceof FastField) {
final FastField field = (FastField)obj;
if ((declaringClass == null && field.declaringClass != null)
|| (declaringClass != null && field.declaringClass == null)) {
return false;
}
return name.equals(field.getName())
&& (declaringClass == null || declaringClass.equals(field.getDeclaringClass()));
}
return false;
}
public int hashCode() {
return name.hashCode() ^ (declaringClass == null ? 0 : declaringClass.hashCode());
}
public String toString() {
return (declaringClass == null ? "" : declaringClass + ".") + name;
}
} ././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/CustomObjectInputStream.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/CustomObjectInpu0000664 0001750 0001750 00000021712 12206661545 034421 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2010, 2011 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 23. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.io.IOException;
import java.io.InvalidObjectException;
import java.io.NotActiveException;
import java.io.ObjectInputStream;
import java.io.ObjectInputValidation;
import java.io.ObjectStreamClass;
import java.io.StreamCorruptedException;
import java.util.Map;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.DataHolder;
public class CustomObjectInputStream extends ObjectInputStream {
private FastStack callbacks = new FastStack(1);
private final ClassLoader classLoader;
private static final String DATA_HOLDER_KEY = CustomObjectInputStream.class.getName();
public static interface StreamCallback {
Object readFromStream() throws IOException;
Map readFieldsFromStream() throws IOException;
void defaultReadObject() throws IOException;
void registerValidation(ObjectInputValidation validation, int priority) throws NotActiveException, InvalidObjectException;
void close() throws IOException;
}
/**
* @deprecated As of 1.4 use {@link #getInstance(DataHolder, StreamCallback, ClassLoader)}
*/
public static CustomObjectInputStream getInstance(DataHolder whereFrom, CustomObjectInputStream.StreamCallback callback) {
return getInstance(whereFrom, callback, null);
}
public static synchronized CustomObjectInputStream getInstance(DataHolder whereFrom, CustomObjectInputStream.StreamCallback callback, ClassLoader classLoaderReference) {
try {
CustomObjectInputStream result = (CustomObjectInputStream) whereFrom.get(DATA_HOLDER_KEY);
if (result == null) {
result = new CustomObjectInputStream(callback, classLoaderReference);
whereFrom.put(DATA_HOLDER_KEY, result);
} else {
result.pushCallback(callback);
}
return result;
} catch (IOException e) {
throw new ConversionException("Cannot create CustomObjectStream", e);
}
}
/**
* Warning, this object is expensive to create (due to functionality inherited from superclass).
* Use the static fetch() method instead, wherever possible.
*
* @see #getInstance(DataHolder, StreamCallback, ClassLoader)
*/
public CustomObjectInputStream(StreamCallback callback, ClassLoader classLoader) throws IOException, SecurityException {
super();
this.callbacks.push(callback);
this.classLoader = classLoader;
}
/**
* Allows the CustomObjectInputStream (which is expensive to create) to be reused.
*/
public void pushCallback(StreamCallback callback) {
this.callbacks.push(callback);
}
public StreamCallback popCallback(){
return (StreamCallback) this.callbacks.pop();
}
public StreamCallback peekCallback(){
return (StreamCallback) this.callbacks.peek();
}
protected Class resolveClass(ObjectStreamClass desc)
throws IOException, ClassNotFoundException {
if (classLoader == null) {
return super.resolveClass(desc);
} else {
return Class.forName(desc.getName(), false, classLoader);
}
}
public void defaultReadObject() throws IOException {
peekCallback().defaultReadObject();
}
protected Object readObjectOverride() throws IOException {
return peekCallback().readFromStream();
}
public Object readUnshared() throws IOException, ClassNotFoundException {
return readObject();
}
public boolean readBoolean() throws IOException {
return ((Boolean)peekCallback().readFromStream()).booleanValue();
}
public byte readByte() throws IOException {
return ((Byte)peekCallback().readFromStream()).byteValue();
}
public int readUnsignedByte() throws IOException {
int b = ((Byte)peekCallback().readFromStream()).byteValue();
if (b < 0) {
b += Byte.MAX_VALUE;
}
return b;
}
public int readInt() throws IOException {
return ((Integer)peekCallback().readFromStream()).intValue();
}
public char readChar() throws IOException {
return ((Character)peekCallback().readFromStream()).charValue();
}
public float readFloat() throws IOException {
return ((Float)peekCallback().readFromStream()).floatValue();
}
public double readDouble() throws IOException {
return ((Double)peekCallback().readFromStream()).doubleValue();
}
public long readLong() throws IOException {
return ((Long)peekCallback().readFromStream()).longValue();
}
public short readShort() throws IOException {
return ((Short)peekCallback().readFromStream()).shortValue();
}
public int readUnsignedShort() throws IOException {
int b = ((Short)peekCallback().readFromStream()).shortValue();
if (b < 0) {
b += Short.MAX_VALUE;
}
return b;
}
public String readUTF() throws IOException {
return (String)peekCallback().readFromStream();
}
public void readFully(byte[] buf) throws IOException {
readFully(buf, 0, buf.length);
}
public void readFully(byte[] buf, int off, int len) throws IOException {
byte[] b = (byte[])peekCallback().readFromStream();
System.arraycopy(b, 0, buf, off, len);
}
public int read() throws IOException {
return readUnsignedByte();
}
public int read(byte[] buf, int off, int len) throws IOException {
byte[] b = (byte[])peekCallback().readFromStream();
if (b.length != len) {
throw new StreamCorruptedException("Expected " + len + " bytes from stream, got " + b.length);
}
System.arraycopy(b, 0, buf, off, len);
return len;
}
public int read(byte b[]) throws IOException {
return read(b, 0, b.length);
}
public GetField readFields() throws IOException {
return new CustomGetField(peekCallback().readFieldsFromStream());
}
private class CustomGetField extends GetField {
private Map fields;
public CustomGetField(Map fields) {
this.fields = fields;
}
public ObjectStreamClass getObjectStreamClass() {
throw new UnsupportedOperationException();
}
private Object get(String name) {
return fields.get(name);
}
public boolean defaulted(String name) {
return !fields.containsKey(name);
}
public byte get(String name, byte val) {
return defaulted(name) ? val : ((Byte)get(name)).byteValue();
}
public char get(String name, char val) {
return defaulted(name) ? val : ((Character)get(name)).charValue();
}
public double get(String name, double val) {
return defaulted(name) ? val : ((Double)get(name)).doubleValue();
}
public float get(String name, float val) {
return defaulted(name) ? val : ((Float)get(name)).floatValue();
}
public int get(String name, int val) {
return defaulted(name) ? val : ((Integer)get(name)).intValue();
}
public long get(String name, long val) {
return defaulted(name) ? val : ((Long)get(name)).longValue();
}
public short get(String name, short val) {
return defaulted(name) ? val : ((Short)get(name)).shortValue();
}
public boolean get(String name, boolean val) {
return defaulted(name) ? val : ((Boolean)get(name)).booleanValue();
}
public Object get(String name, Object val) {
return defaulted(name) ? val : get(name);
}
}
public void registerValidation(ObjectInputValidation validation, int priority) throws NotActiveException, InvalidObjectException {
peekCallback().registerValidation(validation, priority);
}
public void close() throws IOException {
peekCallback().close();
}
/****** Unsupported methods ******/
public int available() {
throw new UnsupportedOperationException();
}
public String readLine() {
throw new UnsupportedOperationException();
}
public int skipBytes(int len) {
throw new UnsupportedOperationException();
}
public long skip(long n) {
throw new UnsupportedOperationException();
}
public void mark(int readlimit) {
throw new UnsupportedOperationException();
}
public void reset() {
throw new UnsupportedOperationException();
}
public boolean markSupported() {
return false;
}
}
././@LongLink 0000644 0000000 0000000 00000000162 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/CustomObjectOutputStream.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/CustomObjectOutp0000664 0001750 0001750 00000015410 12206661545 034433 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 23. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.io.IOException;
import java.io.ObjectOutput;
import java.io.ObjectOutputStream;
import java.util.Map;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.DataHolder;
public class CustomObjectOutputStream extends ObjectOutputStream {
private FastStack callbacks = new FastStack(1);
private FastStack customFields = new FastStack(1);
private static final String DATA_HOLDER_KEY = CustomObjectOutputStream.class.getName();
public static synchronized CustomObjectOutputStream getInstance(DataHolder whereFrom, StreamCallback callback) {
try {
CustomObjectOutputStream result = (CustomObjectOutputStream) whereFrom.get(DATA_HOLDER_KEY);
if (result == null) {
result = new CustomObjectOutputStream(callback);
whereFrom.put(DATA_HOLDER_KEY, result);
} else {
result.pushCallback(callback);
}
return result;
} catch (IOException e) {
throw new ConversionException("Cannot create CustomObjectStream", e);
}
}
public static interface StreamCallback {
void writeToStream(Object object) throws IOException;
void writeFieldsToStream(Map fields) throws IOException;
void defaultWriteObject() throws IOException;
void flush() throws IOException;
void close() throws IOException;
}
/**
* Warning, this object is expensive to create (due to functionality inherited from superclass).
* Use the static fetch() method instead, wherever possible.
*
* @see #getInstance(com.thoughtworks.xstream.converters.DataHolder, com.thoughtworks.xstream.core.util.CustomObjectOutputStream.StreamCallback)
*/
public CustomObjectOutputStream(StreamCallback callback) throws IOException, SecurityException {
this.callbacks.push(callback);
}
/**
* Allows the CustomObjectOutputStream (which is expensive to create) to be reused.
*/
public void pushCallback(StreamCallback callback) {
this.callbacks.push(callback);
}
public StreamCallback popCallback(){
return (StreamCallback) this.callbacks.pop();
}
public StreamCallback peekCallback(){
return (StreamCallback) this.callbacks.peek();
}
/*** Methods to delegate to callback ***/
public void defaultWriteObject() throws IOException {
peekCallback().defaultWriteObject();
}
protected void writeObjectOverride(Object obj) throws IOException {
peekCallback().writeToStream(obj);
}
public void writeBoolean(boolean val) throws IOException {
peekCallback().writeToStream(val ? Boolean.TRUE : Boolean.FALSE); // JDK 1.3 friendly
}
public void writeByte(int val) throws IOException {
peekCallback().writeToStream(new Byte((byte) val));
}
public void writeInt(int val) throws IOException {
peekCallback().writeToStream(new Integer(val));
}
public void writeChar(int val) throws IOException {
peekCallback().writeToStream(new Character((char)val));
}
public void writeDouble(double val) throws IOException {
peekCallback().writeToStream(new Double(val));
}
public void writeFloat(float val) throws IOException {
peekCallback().writeToStream(new Float(val));
}
public void writeLong(long val) throws IOException {
peekCallback().writeToStream(new Long(val));
}
public void writeShort(int val) throws IOException {
peekCallback().writeToStream(new Short((short) val));
}
public void write(byte[] buf) throws IOException {
peekCallback().writeToStream(buf);
}
public void writeChars(String str) throws IOException {
peekCallback().writeToStream(str.toCharArray());
}
public void writeUTF(String str) throws IOException {
peekCallback().writeToStream(str);
}
public void write(int val) throws IOException {
peekCallback().writeToStream(new Byte((byte) val));
}
public void write(byte[] buf, int off, int len) throws IOException {
byte[] b = new byte[len];
System.arraycopy(buf, off, b, 0, len);
peekCallback().writeToStream(b);
}
public void flush() throws IOException {
peekCallback().flush();
}
public void close() throws IOException {
peekCallback().close();
}
public PutField putFields() {
CustomPutField result = new CustomPutField();
customFields.push(result);
return result;
}
public void writeFields() throws IOException {
CustomPutField customPutField = (CustomPutField) customFields.pop();
peekCallback().writeFieldsToStream(customPutField.asMap());
}
private class CustomPutField extends PutField {
private final Map fields = new OrderRetainingMap();
public Map asMap() {
return fields;
}
public void write(ObjectOutput out) throws IOException {
peekCallback().writeToStream(asMap());
}
public void put(String name, Object val) {
fields.put(name, val);
}
public void put(String name, byte val) {
put(name, new Byte(val));
}
public void put(String name, char val) {
put(name, new Character(val));
}
public void put(String name, double val) {
put(name, new Double(val));
}
public void put(String name, float val) {
put(name, new Float(val));
}
public void put(String name, int val) {
put(name, new Integer(val));
}
public void put(String name, long val) {
put(name, new Long(val));
}
public void put(String name, short val) {
put(name, new Short(val));
}
public void put(String name, boolean val) {
put(name, val ? Boolean.TRUE : Boolean.FALSE); // JDK 1.3 friendly
}
}
/****** Unsupported methods ******/
public void reset() {
throw new UnsupportedOperationException();
}
public void useProtocolVersion(int version) {
throw new UnsupportedOperationException();
}
public void writeBytes(String str) {
throw new UnsupportedOperationException();
}
public void writeUnshared(Object obj) {
throw new UnsupportedOperationException();
}
}
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/HierarchicalStreams.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/HierarchicalStre0000664 0001750 0001750 00000003146 12206661545 034401 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 09. October 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Helper methods for {@link HierarchicalStreamReader} and {@link HierarchicalStreamWriter}.
*
* @author Jörg Schaible
* @since 1.3.1
*/
public class HierarchicalStreams {
public static Class readClassType(HierarchicalStreamReader reader, Mapper mapper) {
String classAttribute = readClassAttribute(reader, mapper);
Class type;
if (classAttribute == null) {
type = mapper.realClass(reader.getNodeName());
} else {
type = mapper.realClass(classAttribute);
}
return type;
}
public static String readClassAttribute(HierarchicalStreamReader reader, Mapper mapper) {
String attributeName = mapper.aliasForSystemAttribute("resolves-to");
String classAttribute = attributeName == null ? null : reader.getAttribute(attributeName);
if (classAttribute == null) {
attributeName = mapper.aliasForSystemAttribute("class");
if (attributeName != null) {
classAttribute = reader.getAttribute(attributeName);
}
}
return classAttribute;
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ClassLoaderReference.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ClassLoaderRefer0000664 0001750 0001750 00000002543 12206661545 034345 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. March 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
/**
* ClassLoader that refers to another ClassLoader, allowing a single instance to be passed around the codebase that
* can later have its destination changed.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.1.1
*/
public class ClassLoaderReference extends ClassLoader {
private transient ClassLoader reference;
public ClassLoaderReference(ClassLoader reference) {
this.reference = reference;
}
public Class loadClass(String name) throws ClassNotFoundException {
return reference.loadClass(name);
}
public ClassLoader getReference() {
return reference;
}
public void setReference(ClassLoader reference) {
this.reference = reference;
}
private Object writeReplace() {
return new Replacement();
}
static class Replacement {
private Object readResolve() {
return new ClassLoaderReference(new CompositeClassLoader());
}
};
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/Cloneables.java 0000664 0001750 0001750 00000004213 12206661545 034150 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2010, 2011 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. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import java.lang.reflect.Array;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
/**
* Utility functions for {@link Cloneable} objects.
*
* @author Jörg Schaible
* @since 1.4
*/
public class Cloneables {
public static Object clone(Object o) {
if (o instanceof Cloneable) {
if (o.getClass().isArray()) {
final Class componentType = o.getClass().getComponentType();
if (!componentType.isPrimitive()) {
return ((Object[])o).clone();
} else {
int length = Array.getLength(o);
final Object clone = Array.newInstance(componentType, length);
while (length-- > 0) {
Array.set(clone, length, Array.get(o, length));
}
return clone;
}
} else {
try {
Method clone = o.getClass().getMethod("clone", (Class[])null);
return clone.invoke(o, (Object[])null);
} catch (NoSuchMethodException e) {
throw new ObjectAccessException("Cloneable type has no clone method", e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Cannot clone Cloneable type", e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException("Exception cloning Cloneable type", e.getCause());
}
}
}
return null;
}
public static Object cloneIfPossible(Object o) {
Object clone = clone(o);
return clone == null ? o : clone;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/Primitives.java 0000664 0001750 0001750 00000006440 12206661545 034240 0 ustar jamespage jamespage /*
* Copyright (c) 2006, 2007, 2011 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 11. October 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import java.util.HashMap;
import java.util.Map;
/**
* Utility class for primitives.
*
* @author Jörg Schaible
* @since 1.2.1
*/
public final class Primitives {
private final static Map BOX = new HashMap();
private final static Map UNBOX = new HashMap();
private final static Map NAMED_PRIMITIVE = new HashMap();
private final static Map REPRESENTING_CHAR = new HashMap();
static {
final Class[][] boxing = new Class[][]{
{ Byte.TYPE, Byte.class},
{ Character.TYPE, Character.class},
{ Short.TYPE, Short.class},
{ Integer.TYPE, Integer.class},
{ Long.TYPE, Long.class},
{ Float.TYPE, Float.class},
{ Double.TYPE, Double.class},
{ Boolean.TYPE, Boolean.class},
{ Void.TYPE, Void.class},
};
final Character[] representingChars = {
new Character('B'),
new Character('C'),
new Character('S'),
new Character('I'),
new Character('J'),
new Character('F'),
new Character('D'),
new Character('Z'),
null
};
for (int i = 0; i < boxing.length; i++) {
final Class primitiveType = boxing[i][0];
final Class boxedType = boxing[i][1];
BOX.put(primitiveType, boxedType);
UNBOX.put(boxedType, primitiveType);
NAMED_PRIMITIVE.put(primitiveType.getName(), primitiveType);
REPRESENTING_CHAR.put(primitiveType, representingChars[i]);
}
}
/**
* Get the boxed type for a primitive.
*
* @param type the primitive type
* @return the boxed type or null
*/
static public Class box(final Class type) {
return (Class)BOX.get(type);
}
/**
* Get the primitive type for a boxed one.
*
* @param type the boxed type
* @return the primitive type or null
*/
static public Class unbox(final Class type) {
return (Class)UNBOX.get(type);
}
/**
* Check for a boxed type.
*
* @param type the type to check
* @return true if the type is boxed
* @since 1.4
*/
static public boolean isBoxed(final Class type) {
return UNBOX.containsKey(type);
}
/**
* Get the primitive type by name.
*
* @param name the name of the type
* @return the Java type or null
* @since 1.4
*/
static public Class primitiveType(final String name) {
return (Class)NAMED_PRIMITIVE.get(name);
}
/**
* Get the representing character of a primitive type.
*
* @param type the primitive type
* @return the representing character or 0
* @since 1.4
*/
static public char representingChar(final Class type) {
Character ch = (Character)REPRESENTING_CHAR.get(type);
return ch == null ? 0 : ch.charValue();
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ObjectIdDictionary.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ObjectIdDictiona0000664 0001750 0001750 00000005642 12206661545 034326 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010 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 09. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
import java.util.HashMap;
import java.util.Map;
/**
* Store IDs against given object references.
*
* Behaves similar to java.util.IdentityHashMap, but in JDK1.3 as well. Additionally the
* implementation keeps track of orphaned IDs by using a WeakReference to store the reference
* object.
*
*/
public class ObjectIdDictionary {
private final Map map = new HashMap();
private final ReferenceQueue queue = new ReferenceQueue();
private static interface Wrapper {
int hashCode();
boolean equals(Object obj);
String toString();
Object get();
}
private static class IdWrapper implements Wrapper {
private final Object obj;
private final int hashCode;
public IdWrapper(Object obj) {
hashCode = System.identityHashCode(obj);
this.obj = obj;
}
public int hashCode() {
return hashCode;
}
public boolean equals(Object other) {
return obj == ((Wrapper)other).get();
}
public String toString() {
return obj.toString();
}
public Object get() {
return obj;
}
}
private class WeakIdWrapper extends WeakReference implements Wrapper {
private final int hashCode;
public WeakIdWrapper(Object obj) {
super(obj, queue);
hashCode = System.identityHashCode(obj);
}
public int hashCode() {
return hashCode;
}
public boolean equals(Object other) {
return get() == ((Wrapper)other).get();
}
public String toString() {
Object obj = get();
return obj == null ? "(null)" : obj.toString();
}
}
public void associateId(Object obj, Object id) {
map.put(new WeakIdWrapper(obj), id);
cleanup();
}
public Object lookupId(Object obj) {
Object id = map.get(new IdWrapper(obj));
return id;
}
public boolean containsId(Object item) {
boolean b = map.containsKey(new IdWrapper(item));
return b;
}
public void removeId(Object item) {
map.remove(new IdWrapper(item));
cleanup();
}
public int size() {
cleanup();
return map.size();
}
private void cleanup() {
WeakIdWrapper wrapper;
while ((wrapper = (WeakIdWrapper)queue.poll()) != null)
{
map.remove(wrapper);
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/Pool.java 0000664 0001750 0001750 00000004175 12206661545 033021 0 ustar jamespage jamespage /*
* Copyright (c) 2007 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 10. May 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
/**
* A simple pool implementation.
*
* @author Jörg Schaible
* @author Joe Walnes
*/
public class Pool {
public interface Factory {
public Object newInstance();
}
private final int initialPoolSize;
private final int maxPoolSize;
private final Factory factory;
private transient Object[] pool;
private transient int nextAvailable;
private transient Object mutex = new Object();
public Pool(int initialPoolSize, int maxPoolSize, Factory factory) {
this.initialPoolSize = initialPoolSize;
this.maxPoolSize = maxPoolSize;
this.factory = factory;
}
public Object fetchFromPool() {
Object result;
synchronized (mutex) {
if (pool == null) {
pool = new Object[maxPoolSize];
for (nextAvailable = initialPoolSize; nextAvailable > 0; ) {
putInPool(factory.newInstance());
}
}
while (nextAvailable == maxPoolSize) {
try {
mutex.wait();
} catch (InterruptedException e) {
throw new RuntimeException("Interrupted whilst waiting " +
"for a free item in the pool : " + e.getMessage());
}
}
result = pool[nextAvailable++];
if (result == null) {
result = factory.newInstance();
putInPool(result);
++nextAvailable;
}
}
return result;
}
protected void putInPool(Object object) {
synchronized (mutex) {
pool[--nextAvailable] = object;
mutex.notify();
}
}
private Object readResolve() {
mutex = new Object();
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000151 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/PrioritizedList.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/PrioritizedList.0000664 0001750 0001750 00000005212 12206661545 034377 0 ustar jamespage jamespage /*
* Copyright (C) 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 06. February 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.util.Iterator;
import java.util.Set;
import java.util.TreeSet;
/**
* List that allows items to be added with a priority that will affect the order in which they are later iterated over.
* Objects with a high priority will appear before objects with a low priority in the list. If two objects of the same
* priority are added to the list, the most recently added one will be iterated over first. Implementation uses a
* TreeSet, which has a guaranteed add time of O(log(n)).
*
* @author Joe Walnes
* @author Guilherme Silveira
*/
public class PrioritizedList {
private final Set set = new TreeSet();
private int lowestPriority = Integer.MAX_VALUE;
private int lastId = 0;
public void add(Object item, int priority) {
if (this.lowestPriority > priority) {
this.lowestPriority = priority;
}
this.set.add(new PrioritizedItem(item, priority, ++lastId));
}
public Iterator iterator() {
return new PrioritizedItemIterator(this.set.iterator());
}
private static class PrioritizedItem implements Comparable {
final Object value;
final int priority;
final int id;
public PrioritizedItem(Object value, int priority, int id) {
this.value = value;
this.priority = priority;
this.id = id;
}
public int compareTo(Object o) {
PrioritizedItem other = (PrioritizedItem)o;
if (this.priority != other.priority) {
return (other.priority - this.priority);
}
return (other.id - this.id);
}
public boolean equals(Object obj) {
return this.id == ((PrioritizedItem)obj).id;
}
}
private static class PrioritizedItemIterator implements Iterator {
private Iterator iterator;
public PrioritizedItemIterator(Iterator iterator) {
this.iterator = iterator;
}
public void remove() {
// call iterator.remove()?
throw new UnsupportedOperationException();
}
public boolean hasNext() {
return iterator.hasNext();
}
public Object next() {
return ((PrioritizedItem)iterator.next()).value;
}
}
}
././@LongLink 0000644 0000000 0000000 00000000146 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/PresortedMap.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/PresortedMap.jav0000664 0001750 0001750 00000011002 12206661545 034337 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2010 XStream Committers.
* All rights reserved.
*
* Created on 12.10.2010 by Joerg Schaible, extracted from TreeMapConverter.
*/
package com.thoughtworks.xstream.core.util;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Comparator;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.SortedMap;
/**
* @author Jörg Schaible
*/
public class PresortedMap implements SortedMap {
private static class ArraySet extends ArrayList implements Set {
}
private final PresortedMap.ArraySet set;
private final Comparator comparator;
public PresortedMap() {
this(null, new ArraySet());
}
public PresortedMap(Comparator comparator) {
this(comparator, new ArraySet());
}
private PresortedMap(Comparator comparator, PresortedMap.ArraySet set) {
this.comparator = comparator != null ? comparator : new ArraySetComparator(set);
this.set = set;
}
public Comparator comparator() {
return comparator;
}
public Set entrySet() {
return set;
}
public Object firstKey() {
throw new UnsupportedOperationException();
}
public SortedMap headMap(Object toKey) {
throw new UnsupportedOperationException();
}
public Set keySet() {
Set keySet = new ArraySet();
for (final Iterator iterator = set.iterator(); iterator.hasNext();) {
final Entry entry = (Entry)iterator.next();
keySet.add(entry.getKey());
}
return keySet;
}
public Object lastKey() {
throw new UnsupportedOperationException();
}
public SortedMap subMap(Object fromKey, Object toKey) {
throw new UnsupportedOperationException();
}
public SortedMap tailMap(Object fromKey) {
throw new UnsupportedOperationException();
}
public Collection values() {
Set values = new ArraySet();
for (final Iterator iterator = set.iterator(); iterator.hasNext();) {
final Entry entry = (Entry)iterator.next();
values.add(entry.getValue());
}
return values;
}
public void clear() {
throw new UnsupportedOperationException();
}
public boolean containsKey(Object key) {
return false;
}
public boolean containsValue(Object value) {
throw new UnsupportedOperationException();
}
public Object get(Object key) {
throw new UnsupportedOperationException();
}
public boolean isEmpty() {
return set.isEmpty();
}
public Object put(final Object key, final Object value) {
set.add(new Entry(){
public Object getKey() {
return key;
}
public Object getValue() {
return value;
}
public Object setValue(Object value) {
throw new UnsupportedOperationException();
}});
return null;
}
public void putAll(Map m) {
for (final Iterator iter = m.entrySet().iterator(); iter.hasNext();) {
set.add(iter.next());
}
}
public Object remove(Object key) {
throw new UnsupportedOperationException();
}
public int size() {
return set.size();
}
private static class ArraySetComparator implements Comparator {
private final ArrayList list;
private Map.Entry[] array;
ArraySetComparator(ArrayList list) {
this.list = list;
}
public int compare(Object object1, Object object2) {
if (array == null || list.size() != array.length) {
Map.Entry[] a = new Map.Entry[list.size()];
if (array != null) {
System.arraycopy(array, 0, a, 0, array.length);
}
for (int i = array == null ? 0 : array.length; i < list.size(); ++i) {
a[i] = (Map.Entry)list.get(i);
}
array = a;
}
int idx1 = Integer.MAX_VALUE, idx2 = Integer.MAX_VALUE;
for(int i = 0; i < array.length && !(idx1 < Integer.MAX_VALUE && idx2 < Integer.MAX_VALUE); ++i) {
if (idx1 == Integer.MAX_VALUE && object1 == array[i].getKey()) {
idx1 = i;
}
if (idx2 == Integer.MAX_VALUE && object2 == array[i].getKey()) {
idx2 = i;
}
}
return idx1 - idx2;
}
}
} ././@LongLink 0000644 0000000 0000000 00000000147 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ArrayIterator.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ArrayIterator.ja0000664 0001750 0001750 00000001662 12206661545 034347 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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.07.2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import java.lang.reflect.Array;
import java.util.Iterator;
/**
* @author Jörg Schaible
*
* @since 1.4
*/
public class ArrayIterator implements Iterator {
private final Object array;
private int idx;
private int length;
public ArrayIterator(Object array) {
this.array = array;
length = Array.getLength(array);
}
public boolean hasNext() {
return idx < length;
}
public Object next() {
return Array.get(array, idx++);
}
public void remove() {
throw new UnsupportedOperationException("Remove from array");
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/WeakCache.java 0000664 0001750 0001750 00000011672 12206661545 033723 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 12. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import java.lang.ref.Reference;
import java.lang.ref.WeakReference;
import java.util.AbstractMap;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.WeakHashMap;
/**
* A HashMap implementation with weak references values and by default for the key. WHen the
* value is garbage collected, the key will also vanish from the map.
*
* @author Jörg Schaible
* @since 1.4
*/
public class WeakCache extends AbstractMap {
private final Map map;
/**
* Construct a WeakCache with weak keys.
*
* @param map the map to use
* @since 1.4
*/
public WeakCache() {
this(new WeakHashMap());
}
/**
* Construct a WeakCache.
*
* @param map the map to use
* @since 1.4
*/
public WeakCache(Map map) {
this.map = map;
}
public Object get(Object key) {
Reference reference = (Reference)map.get(key);
return reference != null ? reference.get() : null;
}
public Object put(Object key, Object value) {
Reference ref = (Reference)map.put(key, createReference(value));
return ref == null ? null : ref.get();
}
public Object remove(Object key) {
Reference ref = (Reference)map.remove(key);
return ref == null ? null : ref.get();
}
protected Reference createReference(Object value) {
return new WeakReference(value);
}
public boolean containsValue(final Object value) {
Boolean result = (Boolean)iterate(new Visitor() {
public Object visit(Object element) {
return element.equals(value) ? Boolean.TRUE : null;
}
}, 0);
return result == Boolean.TRUE;
}
public int size() {
if (map.size() == 0) {
return 0;
}
final int i[] = new int[1];
i[0] = 0;
iterate(new Visitor() {
public Object visit(Object element) {
++i[0];
return null;
}
}, 0);
return i[0];
}
public Collection values() {
final Collection collection = new ArrayList();
if (map.size() != 0) {
iterate(new Visitor() {
public Object visit(Object element) {
collection.add(element);
return null;
}
}, 0);
}
return collection;
}
public Set entrySet() {
final Set set = new HashSet();
if (map.size() != 0) {
iterate(new Visitor() {
public Object visit(Object element) {
final Map.Entry entry = (Map.Entry)element;
set.add(new Map.Entry() {
public Object getKey() {
return entry.getKey();
}
public Object getValue() {
return ((Reference)entry.getValue()).get();
}
public Object setValue(Object value) {
return entry.setValue(createReference(value));
}
});
return null;
}
}, 2);
}
return set;
}
private Object iterate(Visitor visitor, int type) {
Object result = null;
for (Iterator iter = map.entrySet().iterator(); result == null && iter.hasNext();) {
Map.Entry entry = (Map.Entry)iter.next();
Reference reference = (Reference)entry.getValue();
Object element = reference.get();
if (element == null) {
iter.remove();
continue;
}
switch (type) {
case 0:
result = visitor.visit(element);
break;
case 1:
result = visitor.visit(entry.getKey());
break;
case 2:
result = visitor.visit(entry);
break;
}
}
return result;
}
private interface Visitor {
Object visit(Object element);
}
public boolean containsKey(Object key) {
return map.containsKey(key);
}
public void clear() {
map.clear();
}
public Set keySet() {
return map.keySet();
}
public boolean equals(Object o) {
return map.equals(o);
}
public int hashCode() {
return map.hashCode();
}
public String toString() {
return map.toString();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/TypedNull.java 0000664 0001750 0001750 00000001206 12206661545 034020 0 ustar jamespage jamespage /*
* Copyright (c) 2007 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 30. March 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
/**
* A placeholder for a null value of a specific type.
*
* @author Jörg Schaible
* @since 1.2.2
*/
public class TypedNull
{
private final Class type;
public TypedNull(Class type)
{
super();
this.type = type;
}
public Class getType()
{
return this.type;
}
}
././@LongLink 0000644 0000000 0000000 00000000162 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ThreadSafePropertyEditor.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ThreadSafeProper0000664 0001750 0001750 00000005304 12206661545 034361 0 ustar jamespage jamespage /*
* Copyright (c) 2007, 2008 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 20. September 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
import java.beans.PropertyEditor;
/**
* Wrapper around {@link PropertyEditor} that can be called by multiple threads concurrently.
*
* A PropertyEditor is not thread safe. To make best use of resources, the PropertyEditor
* provides a dynamically sizing pool of instances, each of which will only be called by a
* single thread at a time.
*
*
* The pool has a maximum capacity, to limit overhead. If all instances in the pool are in use
* and another is required, it shall block until one becomes available.
*
*
* @author Jörg Schaible
* @since 1.3
*/
public class ThreadSafePropertyEditor {
private final Class editorType;
private final Pool pool;
public ThreadSafePropertyEditor(Class type, int initialPoolSize, int maxPoolSize) {
if (!PropertyEditor.class.isAssignableFrom(type)) {
throw new IllegalArgumentException(type.getName()
+ " is not a "
+ PropertyEditor.class.getName());
}
editorType = type;
pool = new Pool(initialPoolSize, maxPoolSize, new Pool.Factory() {
public Object newInstance() {
try {
return editorType.newInstance();
} catch (InstantiationException e) {
throw new ObjectAccessException("Could not call default constructor of "
+ editorType.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not call default constructor of "
+ editorType.getName(), e);
}
}
});
}
public String getAsText(Object object) {
PropertyEditor editor = fetchFromPool();
try {
editor.setValue(object);
return editor.getAsText();
} finally {
pool.putInPool(editor);
}
}
public Object setAsText(String str) {
PropertyEditor editor = fetchFromPool();
try {
editor.setAsText(str);
return editor.getValue();
} finally {
pool.putInPool(editor);
}
}
private PropertyEditor fetchFromPool() {
PropertyEditor editor = (PropertyEditor)pool.fetchFromPool();
return editor;
}
}
././@LongLink 0000644 0000000 0000000 00000000147 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/Base64Encoder.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/Base64Encoder.ja0000664 0001750 0001750 00000007300 12206661545 034076 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 06. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.Reader;
import java.io.StringReader;
/**
* Encodes binary data to plain text as Base64.
*
*
Despite there being a gazillion other Base64 implementations out there, this has been written as part of XStream as
* it forms a core part but is too trivial to warrant an extra dependency.
*
*
This meets the standard as described in RFC 1521, section 5.2 , allowing
* other Base64 tools to manipulate the data.
*
* @author Joe Walnes
*/
public class Base64Encoder {
// Here's how encoding works:
//
// 1) Incoming bytes are broken up into groups of 3 (each byte having 8 bits).
//
// 2) The combined 24 bits (3 * 8) are split into 4 groups of 6 bits.
//
// input |------||------||------| (3 values each with 8 bits)
// 101010101010101010101010
// output |----||----||----||----| (4 values each with 6 bits)
//
// 3) Each of these 4 groups of 6 bits are converted back to a number, which will fall in the range of 0 - 63.
//
// 4) Each of these 4 numbers are converted to an alphanumeric char in a specified mapping table, to create
// a 4 character string.
//
// 5) This is repeated for all groups of three bytes.
//
// 6) Special padding is done at the end of the stream using the '=' char.
private static final char[] SIXTY_FOUR_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".toCharArray();
private static final int[] REVERSE_MAPPING = new int[123];
static {
for (int i = 0; i < SIXTY_FOUR_CHARS.length; i++) REVERSE_MAPPING[SIXTY_FOUR_CHARS[i]] = i + 1;
}
public String encode(byte[] input) {
StringBuffer result = new StringBuffer();
int outputCharCount = 0;
for (int i = 0; i < input.length; i += 3) {
int remaining = Math.min(3, input.length - i);
int oneBigNumber = (input[i] & 0xff) << 16 | (remaining <= 1 ? 0 : input[i + 1] & 0xff) << 8 | (remaining <= 2 ? 0 : input[i + 2] & 0xff);
for (int j = 0; j < 4; j++) result.append(remaining + 1 > j ? SIXTY_FOUR_CHARS[0x3f & oneBigNumber >> 6 * (3 - j)] : '=');
if ((outputCharCount += 4) % 76 == 0) result.append('\n');
}
return result.toString();
}
public byte[] decode(String input) {
try {
ByteArrayOutputStream out = new ByteArrayOutputStream();
StringReader in = new StringReader(input);
for (int i = 0; i < input.length(); i += 4) {
int a[] = {mapCharToInt(in), mapCharToInt(in), mapCharToInt(in), mapCharToInt(in)};
int oneBigNumber = (a[0] & 0x3f) << 18 | (a[1] & 0x3f) << 12 | (a[2] & 0x3f) << 6 | (a[3] & 0x3f);
for (int j = 0; j < 3; j++) if (a[j + 1] >= 0) out.write(0xff & oneBigNumber >> 8 * (2 - j));
}
return out.toByteArray();
} catch (IOException e) {
throw new Error(e + ": " + e.getMessage());
}
}
private int mapCharToInt(Reader input) throws IOException {
int c;
while ((c = input.read()) != -1) {
int result = REVERSE_MAPPING[c];
if (result != 0) return result -1;
if (c == '=') return -1;
}
return -1;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/Fields.java 0000664 0001750 0001750 00000003525 12206661545 033314 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 06. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.lang.reflect.Field;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
/**
* Slightly nicer way to find, get and set fields in classes. Wraps standard java.lang.reflect.Field calls but wraps
* wraps exception in XStreamExceptions.
*
* @author Joe Walnes
*/
public class Fields {
public static Field find(Class type, String name) {
try {
Field result = type.getDeclaredField(name);
if (!result.isAccessible()) {
result.setAccessible(true);
}
return result;
} catch (NoSuchFieldException e) {
throw new IllegalArgumentException("Could not access "
+ type.getName()
+ "."
+ name
+ " field: "
+ e.getMessage());
}
}
public static void write(Field field, Object instance, Object value) {
try {
field.set(instance, value);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not write " + field.getType().getName() + "." + field.getName() + " field", e);
}
}
public static Object read(Field field, Object instance) {
try {
return field.get(instance);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not read " + field.getType().getName() + "." + field.getName() + " field", e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ThreadSafeSimpleDateFormat.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/ThreadSafeSimple0000664 0001750 0001750 00000005613 12206661545 034346 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011, 2012 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 06. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
import java.util.TimeZone;
/**
* Wrapper around java.text.SimpleDateFormat that can
* be called by multiple threads concurrently.
*
SimpleDateFormat has a high overhead in creating
* and is not thread safe. To make best use of resources,
* the ThreadSafeSimpleDateFormat provides a dynamically
* sizing pool of instances, each of which will only
* be called by a single thread at a time.
*
The pool has a maximum capacity, to limit overhead.
* If all instances in the pool are in use and another is
* required, it shall block until one becomes available.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class ThreadSafeSimpleDateFormat {
private final String formatString;
private final Pool pool;
private final TimeZone timeZone;
public ThreadSafeSimpleDateFormat(
String format, TimeZone timeZone, int initialPoolSize, int maxPoolSize,
final boolean lenient) {
this(format, timeZone, Locale.ENGLISH, initialPoolSize, maxPoolSize, lenient);
}
public ThreadSafeSimpleDateFormat(
String format, TimeZone timeZone, final Locale locale, int initialPoolSize,
int maxPoolSize, final boolean lenient) {
formatString = format;
this.timeZone = timeZone;
pool = new Pool(initialPoolSize, maxPoolSize, new Pool.Factory() {
public Object newInstance() {
SimpleDateFormat dateFormat = new SimpleDateFormat(formatString, locale);
dateFormat.setLenient(lenient);
return dateFormat;
}
});
}
public String format(Date date) {
DateFormat format = fetchFromPool();
try {
return format.format(date);
} finally {
pool.putInPool(format);
}
}
public Date parse(String date) throws ParseException {
DateFormat format = fetchFromPool();
try {
return format.parse(date);
} finally {
pool.putInPool(format);
}
}
private DateFormat fetchFromPool() {
DateFormat format = (DateFormat)pool.fetchFromPool();
TimeZone tz = timeZone != null ? timeZone : TimeZone.getDefault();
if (!tz.equals(format.getTimeZone())) {
format.setTimeZone(tz);
}
return format;
}
public String toString() {
return formatString;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/QuickWriter.java0000664 0001750 0001750 00000005041 12206661545 034352 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import com.thoughtworks.xstream.io.StreamException;
import java.io.IOException;
import java.io.Writer;
public class QuickWriter {
private final Writer writer;
private char[] buffer;
private int pointer;
public QuickWriter(Writer writer) {
this(writer, 1024);
}
public QuickWriter(Writer writer, int bufferSize) {
this.writer = writer;
buffer = new char[bufferSize];
}
public void write(String str) {
int len = str.length();
if (pointer + len >= buffer.length) {
flush();
if (len > buffer.length) {
raw(str.toCharArray());
return;
}
}
str.getChars(0, len, buffer, pointer);
pointer += len;
}
public void write(char c) {
if (pointer + 1 >= buffer.length) {
flush();
if (buffer.length == 0) {
raw(c);
return;
}
}
buffer[pointer++] = c;
}
public void write(char[] c) {
int len = c.length;
if (pointer + len >= buffer.length) {
flush();
if (len > buffer.length) {
raw(c);
return;
}
}
System.arraycopy(c, 0, buffer, pointer, len);
pointer += len;
}
public void flush() {
try {
writer.write(buffer, 0, pointer);
pointer = 0;
writer.flush();
} catch (IOException e) {
throw new StreamException(e);
}
}
public void close() {
try {
writer.write(buffer, 0, pointer);
pointer = 0;
writer.close();
} catch (IOException e) {
throw new StreamException(e);
}
}
private void raw(char[] c) {
try {
writer.write(c);
writer.flush();
} catch (IOException e) {
throw new StreamException(e);
}
}
private void raw(char c) {
try {
writer.write(c);
writer.flush();
} catch (IOException e) {
throw new StreamException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000146 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/PresortedSet.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/PresortedSet.jav0000664 0001750 0001750 00000005317 12206661545 034371 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2010 XStream Committers.
* All rights reserved.
*
* Created on 12.10.2010 by Joerg Schaible, extracted from TreeSetConverter.
*/
package com.thoughtworks.xstream.core.util;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Comparator;
import java.util.Iterator;
import java.util.List;
import java.util.SortedSet;
/**
* @author Jörg Schaible
*/
public class PresortedSet implements SortedSet {
private final List list = new ArrayList();
private final Comparator comparator;
public PresortedSet() {
this(null);
}
public PresortedSet(Comparator comparator) {
this(comparator, null);
}
public PresortedSet(Comparator comparator, Collection c) {
this.comparator = comparator;
if (c != null) {
addAll(c);
}
}
public boolean add(Object e) {
return this.list.add(e);
}
public boolean addAll(Collection c) {
return this.list.addAll(c);
}
public void clear() {
this.list.clear();
}
public boolean contains(Object o) {
return this.list.contains(o);
}
public boolean containsAll(Collection c) {
return this.list.containsAll(c);
}
public boolean equals(Object o) {
return this.list.equals(o);
}
public int hashCode() {
return this.list.hashCode();
}
public boolean isEmpty() {
return this.list.isEmpty();
}
public Iterator iterator() {
return this.list.iterator();
}
public boolean remove(Object o) {
return this.list.remove(o);
}
public boolean removeAll(Collection c) {
return this.list.removeAll(c);
}
public boolean retainAll(Collection c) {
return this.list.retainAll(c);
}
public int size() {
return this.list.size();
}
public List subList(int fromIndex, int toIndex) {
return this.list.subList(fromIndex, toIndex);
}
public Object[] toArray() {
return this.list.toArray();
}
public Object[] toArray(Object[] a) {
return this.list.toArray(a);
}
public Comparator comparator() {
return comparator;
}
public Object first() {
return list.isEmpty() ? null : list.get(0);
}
public SortedSet headSet(Object toElement) {
throw new UnsupportedOperationException();
}
public Object last() {
return list.isEmpty() ? null : list.get(list.size() - 1);
}
public SortedSet subSet(Object fromElement, Object toElement) {
throw new UnsupportedOperationException();
}
public SortedSet tailSet(Object fromElement) {
throw new UnsupportedOperationException();
}
} ././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/CompositeClassLoader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/CompositeClassLo0000664 0001750 0001750 00000011701 12206661545 034404 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 16. November 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
/**
* ClassLoader that is composed of other classloaders. Each loader will be used to try to load the particular class, until
* one of them succeeds. Note: The loaders will always be called in the REVERSE order they were added in.
*
*
The Composite class loader also has registered the classloader that loaded xstream.jar
* and (if available) the thread's context classloader.
The above code will attempt to load a class from the following classloaders (in order):
*
*
*
AnotherClassLoader (and all its parents)
*
The classloader for MyClas (and all its parents)
*
The thread's context classloader (and all its parents)
*
The classloader for XStream (and all its parents)
*
*
*
The added classloaders are kept with weak references to allow an application container to reload classes.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.0.3
*/
public class CompositeClassLoader extends ClassLoader {
private final ReferenceQueue queue = new ReferenceQueue();
private final List classLoaders = new ArrayList();
public CompositeClassLoader() {
addInternal(Object.class.getClassLoader()); // bootstrap loader.
addInternal(getClass().getClassLoader()); // whichever classloader loaded this jar.
}
/**
* Add a loader to the n
* @param classLoader
*/
public synchronized void add(ClassLoader classLoader) {
cleanup();
if (classLoader != null) {
addInternal(classLoader);
}
}
private void addInternal(ClassLoader classLoader) {
WeakReference refClassLoader = null;
for (Iterator iterator = classLoaders.iterator(); iterator.hasNext();) {
WeakReference ref = (WeakReference) iterator.next();
ClassLoader cl = (ClassLoader)ref.get();
if (cl == null) {
iterator.remove();
} else if (cl == classLoader) {
iterator.remove();
refClassLoader = ref;
}
}
classLoaders.add(0, refClassLoader != null ? refClassLoader : new WeakReference(classLoader, queue));
}
public Class loadClass(String name) throws ClassNotFoundException {
List copy = new ArrayList(classLoaders.size()) {
public boolean addAll(Collection c) {
boolean result = false;
for(Iterator iter = c.iterator(); iter.hasNext(); ) {
result |= add(iter.next());
}
return result;
}
public boolean add(Object ref) {
Object classLoader = ((WeakReference)ref).get();
if (classLoader != null) {
return super.add(classLoader);
}
return false;
}
};
synchronized(this) {
cleanup();
copy.addAll(classLoaders);
}
ClassLoader contextClassLoader = Thread.currentThread().getContextClassLoader();
for (Iterator iterator = copy.iterator(); iterator.hasNext();) {
ClassLoader classLoader = (ClassLoader) iterator.next();
if (classLoader == contextClassLoader) {
contextClassLoader = null;
}
try {
return classLoader.loadClass(name);
} catch (ClassNotFoundException notFound) {
// ok.. try another one
}
}
// One last try - the context class loader associated with the current thread. Often used in j2ee servers.
// Note: The contextClassLoader cannot be added to the classLoaders list up front as the thread that constructs
// XStream is potentially different to thread that uses it.
if (contextClassLoader != null) {
return contextClassLoader.loadClass(name);
} else {
throw new ClassNotFoundException(name);
}
}
private void cleanup() {
WeakReference ref;
while ((ref = (WeakReference)queue.poll()) != null)
{
classLoaders.remove(ref);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/OrderRetainingMap.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/OrderRetainingMa0000664 0001750 0001750 00000004260 12206661545 034355 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2013 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 06. February 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;
public class OrderRetainingMap extends HashMap {
private ArraySet keyOrder = new ArraySet();
private List valueOrder = new ArrayList();
public OrderRetainingMap() {
super();
}
public OrderRetainingMap(Map m) {
super();
putAll(m);
}
public Object put(Object key, Object value) {
int idx = keyOrder.lastIndexOf(key);
if (idx < 0) {
keyOrder.add(key);
valueOrder.add(value);
} else {
valueOrder.set(idx, value);
}
return super.put(key, value);
}
public Object remove(Object key) {
int idx = keyOrder.lastIndexOf(key);
if (idx != 0) {
keyOrder.remove(idx);
valueOrder.remove(idx);
}
return super.remove(key);
}
public void clear() {
keyOrder.clear();
valueOrder.clear();
super.clear();
}
public Collection values() {
return Collections.unmodifiableList(valueOrder);
}
public Set keySet() {
return Collections.unmodifiableSet(keyOrder);
}
public Set entrySet() {
Map.Entry[] entries = new Map.Entry[size()];
for (Iterator iter = super.entrySet().iterator(); iter.hasNext();) {
Map.Entry entry = (Map.Entry)iter.next();
entries[keyOrder.indexOf(entry.getKey())] = entry;
}
Set set = new ArraySet();
set.addAll(Arrays.asList(entries));
return Collections.unmodifiableSet(set);
}
private static class ArraySet extends ArrayList implements Set {
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/XmlHeaderAwareReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/XmlHeaderAwareRe0000664 0001750 0001750 00000020710 12206661545 034301 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008, 2010 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 13. September 2007 by Joerg Schaible.
*/
package com.thoughtworks.xstream.core.util;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.PushbackInputStream;
import java.io.Reader;
import java.io.UnsupportedEncodingException;
import java.util.HashMap;
import java.util.Map;
/**
* A {@link Reader} that evaluates the XML header. It selects its encoding based on the encoding read with the XML
* header of the provided {@link InputStream}. The default encoding is UTF-8 and the version is 1.0 if the
* stream does not contain an XML header or the attributes are not set within the header.
*
* @author Jörg Schaible
* @since 1.3
*/
public final class XmlHeaderAwareReader extends Reader {
private final InputStreamReader reader;
private final double version;
private static final String KEY_ENCODING = "encoding";
private static final String KEY_VERSION = "version";
private static final String XML_TOKEN = "?xml";
private static final int STATE_BOM = 0;
private static final int STATE_START = 1;
private static final int STATE_AWAIT_XML_HEADER = 2;
private static final int STATE_ATTR_NAME = 3;
private static final int STATE_ATTR_VALUE = 4;
/**
* Constructs an XmlHeaderAwareReader.
*
* @param in the {@link InputStream}
* @throws UnsupportedEncodingException if the encoding is not supported
* @throws IOException occurred while reading the XML header
* @since 1.3
*/
public XmlHeaderAwareReader(final InputStream in) throws UnsupportedEncodingException, IOException {
final PushbackInputStream[] pin = new PushbackInputStream[]{in instanceof PushbackInputStream
? (PushbackInputStream)in
: new PushbackInputStream(in, 64)};
final Map header = getHeader(pin);
version = Double.parseDouble((String)header.get(KEY_VERSION));
reader = new InputStreamReader(pin[0], (String)header.get(KEY_ENCODING));
}
private Map getHeader(final PushbackInputStream[] in) throws IOException {
final Map header = new HashMap();
header.put(KEY_ENCODING, "utf-8");
header.put(KEY_VERSION, "1.0");
int state = STATE_BOM;
final ByteArrayOutputStream out = new ByteArrayOutputStream(64);
int i = 0;
char ch = 0;
char valueEnd = 0;
final StringBuffer name = new StringBuffer();
final StringBuffer value = new StringBuffer();
boolean escape = false;
while (i != -1 && (i = in[0].read()) != -1) {
out.write(i);
ch = (char)i;
switch (state) {
case STATE_BOM:
if ((ch == 0xEF && out.size() == 1)
|| (ch == 0xBB && out.size() == 2)
|| (ch == 0xBF && out.size() == 3)) {
if (ch == 0xBF) {
out.reset();
state = STATE_START;
}
break;
} else if (out.size() > 1) {
i = -1;
break;
} else {
state = STATE_START;
}
// fall through
case STATE_START:
if (!Character.isWhitespace(ch)) {
if (ch == '<') {
state = STATE_AWAIT_XML_HEADER;
} else {
i = -1;
}
}
break;
case STATE_AWAIT_XML_HEADER:
if (!Character.isWhitespace(ch)) {
name.append(Character.toLowerCase(ch));
if (!XML_TOKEN.startsWith(name.substring(0))) {
i = -1;
}
} else {
if (name.toString().equals(XML_TOKEN)) {
state = STATE_ATTR_NAME;
name.setLength(0);
} else {
i = -1;
}
}
break;
case STATE_ATTR_NAME:
if (!Character.isWhitespace(ch)) {
if (ch == '=') {
state = STATE_ATTR_VALUE;
} else {
ch = Character.toLowerCase(ch);
if (Character.isLetter(ch)) {
name.append(ch);
} else {
i = -1;
}
}
} else if (name.length() > 0) {
i = -1;
}
break;
case STATE_ATTR_VALUE:
if (valueEnd == 0) {
if (ch == '"' || ch == '\'') {
valueEnd = ch;
} else {
i = -1;
}
} else {
if (ch == '\\' && !escape) {
escape = true;
break;
}
if (ch == valueEnd && !escape) {
valueEnd = 0;
state = STATE_ATTR_NAME;
header.put(name.toString(), value.toString());
name.setLength(0);
value.setLength(0);
} else {
escape = false;
if (ch != '\n') {
value.append(ch);
} else {
i = -1;
}
}
}
break;
}
}
byte[] pushbackData = out.toByteArray();
for (i = pushbackData.length; i-- > 0;) {
final byte b = pushbackData[i];
try {
in[0].unread(b);
} catch (IOException ex) {
in[0] = new PushbackInputStream(in[0], ++i);
}
}
return header;
}
/**
* @see InputStreamReader#getEncoding()
* @since 1.3
*/
public String getEncoding() {
return reader.getEncoding();
}
/**
* @see InputStreamReader#getEncoding()
* @since 1.3
*/
public double getVersion() {
return version;
}
/**
* @see java.io.Reader#mark(int)
*/
public void mark(final int readAheadLimit) throws IOException {
reader.mark(readAheadLimit);
}
/**
* @see java.io.Reader#markSupported()
*/
public boolean markSupported() {
return reader.markSupported();
}
/**
* @see java.io.Reader#read()
*/
public int read() throws IOException {
return reader.read();
}
/**
* @see java.io.Reader#read(char[], int, int)
*/
public int read(final char[] cbuf, final int offset, final int length) throws IOException {
return reader.read(cbuf, offset, length);
}
/**
* @see java.io.Reader#read(char[])
*/
public int read(final char[] cbuf) throws IOException {
return reader.read(cbuf);
}
// TODO: This is JDK 1.5
// public int read(final CharBuffer target) throws IOException {
// return reader.read(target);
// }
/**
* @see java.io.Reader#ready()
*/
public boolean ready() throws IOException {
return reader.ready();
}
/**
* @see java.io.Reader#reset()
*/
public void reset() throws IOException {
reader.reset();
}
/**
* @see java.io.Reader#skip(long)
*/
public long skip(final long n) throws IOException {
return reader.skip(n);
}
/**
* @see java.io.Reader#close()
*/
public void close() throws IOException {
reader.close();
}
/**
* @see java.lang.Object#equals(java.lang.Object)
*/
public boolean equals(final Object obj) {
return reader.equals(obj);
}
/**
* @see java.lang.Object#hashCode()
*/
public int hashCode() {
return reader.hashCode();
}
/**
* @see java.lang.Object#toString()
*/
public String toString() {
return reader.toString();
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/DependencyInjectionFactory.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/DependencyInject0000664 0001750 0001750 00000025010 12206661545 034372 0 ustar jamespage jamespage /*
* Copyright (c) 2007, 2009, 2010, 2011, 2012 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 30. March 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core.util;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.BitSet;
import java.util.Comparator;
import java.util.List;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
/**
* A dependency injection factory.
*
* @author Jörg Schaible
* @since 1.2.2
*/
public class DependencyInjectionFactory {
/**
* Create an instance with dependency injection. The given dependencies are used to match the parameters of the
* constructors of the type. Constructors with most parameters are examined first. A parameter type sequence
* matching the sequence of the dependencies' types match first. Otherwise all the types of the dependencies must
* match one of the the parameters although no dependency is used twice. Use a {@link TypedNull} instance to inject
* null as parameter.
*
* @param type the type to create an instance of
* @param dependencies the possible dependencies
* @return the instantiated object
* @throws ObjectAccessException if no instance can be generated
* @since 1.2.2
*/
public static Object newInstance(final Class type, final Object[] dependencies) {
return newInstance(type, dependencies, null);
}
/**
* Create an instance with dependency injection. The given dependencies are used to match the parameters of the
* constructors of the type. Constructors with most parameters are examined first. A parameter type sequence
* matching the sequence of the dependencies' types match first. Otherwise all the types of the dependencies must
* match one of the the parameters although no dependency is used twice. Use a {@link TypedNull} instance to inject
* null as parameter.
*
* @param type the type to create an instance of
* @param dependencies the possible dependencies
* @param usedDependencies bit mask set by the method for all used dependencies (may be null)
* @return the instantiated object
* @throws ObjectAccessException if no instance can be generated
* @since 1.4
*/
public static Object newInstance(final Class type, final Object[] dependencies, final BitSet usedDependencies) {
Constructor bestMatchingCtor = null;
final ArrayList matchingDependencies = new ArrayList();
List possibleMatchingDependencies = null;
BitSet possibleUsedDependencies = null;
if (dependencies != null && dependencies.length > 0) {
// sort available ctors according their arity
final Constructor[] ctors = type.getConstructors();
if (ctors.length > 1) {
Arrays.sort(ctors, new Comparator() {
public int compare(final Object o1, final Object o2) {
return ((Constructor)o2).getParameterTypes().length
- ((Constructor)o1).getParameterTypes().length;
}
});
}
final TypedValue[] typedDependencies = new TypedValue[dependencies.length];
for (int i = 0; i < dependencies.length; i++ ) {
Object dependency = dependencies[i];
Class depType = dependency.getClass();
if (depType.isPrimitive()) {
depType = Primitives.box(depType);
} else if (depType == TypedNull.class) {
depType = ((TypedNull)dependency).getType();
dependency = null;
}
typedDependencies[i] = new TypedValue(depType, dependency);
}
Constructor possibleCtor = null;
int arity = Integer.MAX_VALUE;
for (int i = 0; bestMatchingCtor == null && i < ctors.length; i++ ) {
final Constructor constructor = ctors[i];
final Class[] parameterTypes = constructor.getParameterTypes();
if (parameterTypes.length > dependencies.length) {
continue;
} else if (parameterTypes.length == 0) {
if (possibleCtor == null) {
bestMatchingCtor = constructor;
}
break;
}
if (arity > parameterTypes.length) {
if (possibleCtor != null) {
continue;
}
arity = parameterTypes.length;
}
for (int j = 0; j < parameterTypes.length; j++ ) {
if (parameterTypes[j].isPrimitive()) {
parameterTypes[j] = Primitives.box(parameterTypes[j]);
}
}
// first approach: test the ctor params against the dependencies in the sequence
// of the parameter
// declaration
matchingDependencies.clear();
clear(usedDependencies);
for (int j = 0, k = 0; j < parameterTypes.length
&& parameterTypes.length + k - j <= typedDependencies.length; k++ ) {
if (parameterTypes[j].isAssignableFrom(typedDependencies[k].type)) {
matchingDependencies.add(typedDependencies[k].value);
if (usedDependencies != null) {
usedDependencies.set(k);
}
if ( ++j == parameterTypes.length) {
bestMatchingCtor = constructor;
break;
}
}
}
if (bestMatchingCtor == null && possibleCtor == null) {
possibleCtor = constructor; // assumption
// try to match all dependencies in the sequence of the parameter
// declaration
final TypedValue[] deps = new TypedValue[typedDependencies.length];
System.arraycopy(typedDependencies, 0, deps, 0, deps.length);
matchingDependencies.clear();
clear(usedDependencies);
for (int j = 0; j < parameterTypes.length; j++ ) {
int assignable = -1;
for (int k = 0; k < deps.length; k++ ) {
if (deps[k] == null) {
continue;
}
if (deps[k].type == parameterTypes[j]) {
assignable = k;
// optimal match
break;
} else if (parameterTypes[j].isAssignableFrom(deps[k].type)) {
// use most specific type
if (assignable < 0
|| (deps[assignable].type != deps[k].type && deps[assignable].type
.isAssignableFrom(deps[k].type))) {
assignable = k;
}
}
}
if (assignable >= 0) {
matchingDependencies.add(deps[assignable].value);
if (usedDependencies != null) {
usedDependencies.set(assignable);
}
deps[assignable] = null; // do not match same dep twice
} else {
possibleCtor = null;
break;
}
}
if (possibleCtor != null) {
possibleMatchingDependencies = (List)matchingDependencies.clone();
if (usedDependencies != null) {
possibleUsedDependencies = (BitSet)usedDependencies.clone();
}
}
}
}
if (bestMatchingCtor == null) {
if (possibleCtor == null) {
clear(usedDependencies);
throw new ObjectAccessException("Cannot construct "
+ type.getName()
+ ", none of the dependencies match any constructor's parameters");
} else {
bestMatchingCtor = possibleCtor;
matchingDependencies.clear();
matchingDependencies.addAll(possibleMatchingDependencies);
if (usedDependencies != null) {
clear(usedDependencies);
usedDependencies.or(possibleUsedDependencies);
}
}
}
}
try {
final Object instance;
if (bestMatchingCtor == null) {
instance = type.newInstance();
} else {
instance = bestMatchingCtor.newInstance(matchingDependencies.toArray());
}
return instance;
} catch (final InstantiationException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (final IllegalAccessException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (final InvocationTargetException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
}
}
private static void clear(final BitSet usedDependencies) {
if (usedDependencies != null) {
for (int j = usedDependencies.length(); j-- > 0;) {
usedDependencies.clear(j); // JDK 1.3, BitSet.clear() is JDK 1.4
}
}
}
private static class TypedValue {
final Class type;
final Object value;
public TypedValue(final Class type, final Object value) {
super();
this.type = type;
this.value = value;
}
public String toString()
{
return type.getName() + ":" + value;
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/util/FastStack.java 0000664 0001750 0001750 00000004150 12206661545 033764 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 02. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core.util;
/**
* An array-based stack implementation.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public final class FastStack {
private Object[] stack;
private int pointer;
public FastStack(int initialCapacity) {
stack = new Object[initialCapacity];
}
public Object push(Object value) {
if (pointer + 1 >= stack.length) {
resizeStack(stack.length * 2);
}
stack[pointer++] = value;
return value;
}
public void popSilently() {
stack[--pointer] = null;
}
public Object pop() {
final Object result = stack[--pointer];
stack[pointer] = null;
return result;
}
public Object peek() {
return pointer == 0 ? null : stack[pointer - 1];
}
public Object replace(Object value) {
final Object result = stack[pointer - 1];
stack[pointer - 1] = value;
return result;
}
public void replaceSilently(Object value) {
stack[pointer - 1] = value;
}
public int size() {
return pointer;
}
public boolean hasStuff() {
return pointer > 0;
}
public Object get(int i) {
return stack[i];
}
private void resizeStack(int newCapacity) {
Object[] newStack = new Object[newCapacity];
System.arraycopy(stack, 0, newStack, 0, Math.min(pointer, newCapacity));
stack = newStack;
}
public String toString() {
StringBuffer result = new StringBuffer("[");
for (int i = 0; i < pointer; i++) {
if (i > 0) {
result.append(", ");
}
result.append(stack[i]);
}
result.append(']');
return result.toString();
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/DefaultConverterLookup.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/DefaultConverterLooku0000664 0001750 0001750 00000005766 12206661545 034510 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.ConverterRegistry;
import com.thoughtworks.xstream.core.util.PrioritizedList;
import com.thoughtworks.xstream.mapper.Mapper;
import java.util.Iterator;
import java.util.Map;
import java.util.WeakHashMap;
/**
* The default implementation of converters lookup.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Guilherme Silveira
*/
public class DefaultConverterLookup implements ConverterLookup, ConverterRegistry, Caching {
private final PrioritizedList converters = new PrioritizedList();
private transient Map typeToConverterMap;
public DefaultConverterLookup() {
}
/**
* @deprecated As of 1.3, use {@link #DefaultConverterLookup()}
*/
public DefaultConverterLookup(Mapper mapper) {
}
public synchronized Converter lookupConverterForType(Class type) {
if (typeToConverterMap == null) {
typeToConverterMap = new WeakHashMap();
}
Converter cachedConverter = (Converter) typeToConverterMap.get(type);
if (cachedConverter != null) {
return cachedConverter;
}
Iterator iterator = converters.iterator();
while (iterator.hasNext()) {
Converter converter = (Converter) iterator.next();
if (converter.canConvert(type)) {
typeToConverterMap.put(type, converter);
return converter;
}
}
throw new ConversionException("No converter specified for " + type);
}
public synchronized void registerConverter(Converter converter, int priority) {
if (typeToConverterMap == null) {
typeToConverterMap = new WeakHashMap();
}
converters.add(converter, priority);
for (Iterator iter = typeToConverterMap.keySet().iterator(); iter.hasNext();) {
Class type = (Class) iter.next();
if (converter.canConvert(type)) {
iter.remove();
}
}
}
public synchronized void flushCache() {
if (typeToConverterMap == null) {
typeToConverterMap = new WeakHashMap();
}
typeToConverterMap.clear();
Iterator iterator = converters.iterator();
while (iterator.hasNext()) {
Converter converter = (Converter) iterator.next();
if (converter instanceof Caching) {
((Caching)converter).flushCache();
}
}
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/MapBackedDataHolder.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/MapBackedDataHolder.j0000664 0001750 0001750 00000002017 12206661545 034173 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 04. October 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.DataHolder;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
public class MapBackedDataHolder implements DataHolder {
private final Map map;
public MapBackedDataHolder() {
this(new HashMap());
}
public MapBackedDataHolder(Map map) {
this.map = map;
}
public Object get(Object key) {
return map.get(key);
}
public void put(Object key, Object value) {
map.put(key, value);
}
public Iterator keys() {
return Collections.unmodifiableCollection(map.keySet()).iterator();
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByXPathUnmarshaller.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByXPathUnmar0000664 0001750 0001750 00000003366 12206661545 034355 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 03. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.AbstractReader;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.path.Path;
import com.thoughtworks.xstream.io.path.PathTracker;
import com.thoughtworks.xstream.io.path.PathTrackingReader;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReferenceByXPathUnmarshaller extends AbstractReferenceUnmarshaller {
private PathTracker pathTracker = new PathTracker();
protected boolean isNameEncoding;
public ReferenceByXPathUnmarshaller(Object root, HierarchicalStreamReader reader,
ConverterLookup converterLookup, Mapper mapper) {
super(root, reader, converterLookup, mapper);
this.reader = new PathTrackingReader(reader, pathTracker);
isNameEncoding = reader.underlyingReader() instanceof AbstractReader;
}
protected Object getReferenceKey(String reference) {
final Path path = new Path(isNameEncoding ? ((AbstractReader)reader.underlyingReader()).decodeNode(reference) : reference);
// We have absolute references, if path starts with '/'
return reference.charAt(0) != '/' ? pathTracker.getPath().apply(path) : path;
}
protected Object getCurrentReferenceKey() {
return pathTracker.getPath();
}
}
././@LongLink 0000644 0000000 0000000 00000000170 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByXPathMarshallingStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByXPathMarsh0000664 0001750 0001750 00000002640 12206661545 034337 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 03. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReferenceByXPathMarshallingStrategy extends AbstractTreeMarshallingStrategy {
public static int RELATIVE = 0;
public static int ABSOLUTE = 1;
public static int SINGLE_NODE = 2;
private final int mode;
public ReferenceByXPathMarshallingStrategy(int mode) {
this.mode = mode;
}
protected TreeUnmarshaller createUnmarshallingContext(Object root,
HierarchicalStreamReader reader, ConverterLookup converterLookup, Mapper mapper) {
return new ReferenceByXPathUnmarshaller(root, reader, converterLookup, mapper);
}
protected TreeMarshaller createMarshallingContext(
HierarchicalStreamWriter writer, ConverterLookup converterLookup, Mapper mapper) {
return new ReferenceByXPathMarshaller(writer, converterLookup, mapper, mode);
}
}
././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByXPathMarshaller.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByXPathMarsh0000664 0001750 0001750 00000003022 12206661545 034332 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 03. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.path.Path;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReferenceByXPathMarshaller extends AbstractReferenceMarshaller {
private final int mode;
public ReferenceByXPathMarshaller(HierarchicalStreamWriter writer, ConverterLookup converterLookup, Mapper mapper, int mode) {
super(writer, converterLookup, mapper);
this.mode = mode;
}
protected String createReference(Path currentPath, Object existingReferenceKey) {
Path existingPath = (Path)existingReferenceKey;
Path referencePath = (mode & ReferenceByXPathMarshallingStrategy.ABSOLUTE) > 0 ? existingPath : currentPath.relativeTo(existingPath);
return (mode & ReferenceByXPathMarshallingStrategy.SINGLE_NODE) > 0 ? referencePath.explicit() : referencePath.toString();
}
protected Object createReferenceKey(Path currentPath, Object item) {
return currentPath;
}
protected void fireValidReference(Object referenceKey) {
// nothing to do
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByIdUnmarshaller.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/ReferenceByIdUnmarsha0000664 0001750 0001750 00000002237 12206661545 034355 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 15. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReferenceByIdUnmarshaller extends AbstractReferenceUnmarshaller {
public ReferenceByIdUnmarshaller(Object root, HierarchicalStreamReader reader,
ConverterLookup converterLookup, Mapper mapper) {
super(root, reader, converterLookup, mapper);
}
protected Object getReferenceKey(String reference) {
return reference;
}
protected Object getCurrentReferenceKey() {
String attributeName = getMapper().aliasForSystemAttribute("id");
return attributeName == null ? null : reader.getAttribute(attributeName);
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/TreeMarshallingStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/TreeMarshallingStrate0000664 0001750 0001750 00000002210 12206661545 034443 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 16. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
public class TreeMarshallingStrategy extends AbstractTreeMarshallingStrategy {
protected TreeUnmarshaller createUnmarshallingContext(Object root,
HierarchicalStreamReader reader, ConverterLookup converterLookup, Mapper mapper) {
return new TreeUnmarshaller(root, reader, converterLookup, mapper);
}
protected TreeMarshaller createMarshallingContext(
HierarchicalStreamWriter writer, ConverterLookup converterLookup, Mapper mapper) {
return new TreeMarshaller(writer, converterLookup, mapper);
}
}
././@LongLink 0000644 0000000 0000000 00000000160 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/AbstractReferenceMarshaller.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/AbstractReferenceMars0000664 0001750 0001750 00000013731 12206661545 034416 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 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 15. March 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.core.util.ObjectIdDictionary;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.path.Path;
import com.thoughtworks.xstream.io.path.PathTracker;
import com.thoughtworks.xstream.io.path.PathTrackingWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import java.util.Iterator;
/**
* Abstract base class for a TreeMarshaller, that can build references.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Mauro Talevi
* @since 1.2
*/
public abstract class AbstractReferenceMarshaller extends TreeMarshaller implements MarshallingContext {
private ObjectIdDictionary references = new ObjectIdDictionary();
private ObjectIdDictionary implicitElements = new ObjectIdDictionary();
private PathTracker pathTracker = new PathTracker();
private Path lastPath;
public AbstractReferenceMarshaller(HierarchicalStreamWriter writer,
ConverterLookup converterLookup,
Mapper mapper) {
super(writer, converterLookup, mapper);
this.writer = new PathTrackingWriter(writer, pathTracker);
}
public void convert(Object item, Converter converter) {
if (getMapper().isImmutableValueType(item.getClass())) {
// strings, ints, dates, etc... don't bother using references.
converter.marshal(item, writer, this);
} else {
final Path currentPath = pathTracker.getPath();
Id existingReference = (Id)references.lookupId(item);
if (existingReference != null && existingReference.getPath() != currentPath) {
String attributeName = getMapper().aliasForSystemAttribute("reference");
if (attributeName != null) {
writer.addAttribute(attributeName, createReference(currentPath, existingReference.getItem()));
}
} else {
final Object newReferenceKey = existingReference == null
? createReferenceKey(currentPath, item)
: existingReference.getItem();
if (lastPath == null || !currentPath.isAncestor(lastPath)) {
fireValidReference(newReferenceKey);
lastPath = currentPath;
references.associateId(item, new Id(newReferenceKey, currentPath));
}
converter.marshal(item, writer, new ReferencingMarshallingContext() {
public void put(Object key, Object value) {
AbstractReferenceMarshaller.this.put(key, value);
}
public Iterator keys() {
return AbstractReferenceMarshaller.this.keys();
}
public Object get(Object key) {
return AbstractReferenceMarshaller.this.get(key);
}
public void convertAnother(Object nextItem, Converter converter) {
AbstractReferenceMarshaller.this.convertAnother(nextItem, converter);
}
public void convertAnother(Object nextItem) {
AbstractReferenceMarshaller.this.convertAnother(nextItem);
}
public void replace(Object original, Object replacement) {
references.associateId(replacement, new Id(newReferenceKey, currentPath));
}
public Object lookupReference(Object item) {
Id id = (Id)references.lookupId(item);
return id.getItem();
}
/**
* @deprecated As of 1.4.2
*/
public Path currentPath() {
return pathTracker.getPath();
}
public void registerImplicit(Object item) {
if (implicitElements.containsId(item)) {
throw new ReferencedImplicitElementException(item, currentPath);
}
implicitElements.associateId(item, newReferenceKey);
}
});
}
}
}
protected abstract String createReference(Path currentPath, Object existingReferenceKey);
protected abstract Object createReferenceKey(Path currentPath, Object item);
protected abstract void fireValidReference(Object referenceKey);
private static class Id {
private Object item;
private Path path;
public Id(Object item, Path path) {
this.item = item;
this.path = path;
}
protected Object getItem() {
return this.item;
}
protected Path getPath() {
return this.path;
}
}
public static class ReferencedImplicitElementException extends ConversionException {
public ReferencedImplicitElementException(final Object item, final Path path) {
super("Cannot reference implicit element");
add("implicit-element", item.toString());
add("referencing-element", path.toString());
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/Caching.java 0000664 0001750 0001750 00000000761 12206661545 032464 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 19. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.core;
/**
* Marker interface for caching implementations.
*
* @author Jörg Schaible
* @since 1.4
*/
public interface Caching {
void flushCache();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/core/TreeMarshaller.java 0000664 0001750 0001750 00000007533 12206661545 034046 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 15. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.core;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.DataHolder;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.core.util.ObjectIdDictionary;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.mapper.Mapper;
import java.util.Iterator;
public class TreeMarshaller implements MarshallingContext {
protected HierarchicalStreamWriter writer;
protected ConverterLookup converterLookup;
private Mapper mapper;
private ObjectIdDictionary parentObjects = new ObjectIdDictionary();
private DataHolder dataHolder;
public TreeMarshaller(
HierarchicalStreamWriter writer, ConverterLookup converterLookup, Mapper mapper) {
this.writer = writer;
this.converterLookup = converterLookup;
this.mapper = mapper;
}
public void convertAnother(Object item) {
convertAnother(item, null);
}
public void convertAnother(Object item, Converter converter) {
if (converter == null) {
converter = converterLookup.lookupConverterForType(item.getClass());
} else {
if (!converter.canConvert(item.getClass())) {
ConversionException e = new ConversionException(
"Explicit selected converter cannot handle item");
e.add("item-type", item.getClass().getName());
e.add("converter-type", converter.getClass().getName());
throw e;
}
}
convert(item, converter);
}
protected void convert(Object item, Converter converter) {
if (parentObjects.containsId(item)) {
ConversionException e = new CircularReferenceException(
"Recursive reference to parent object");
e.add("item-type", item.getClass().getName());
e.add("converter-type", converter.getClass().getName());
throw e;
}
parentObjects.associateId(item, "");
converter.marshal(item, writer, this);
parentObjects.removeId(item);
}
public void start(Object item, DataHolder dataHolder) {
this.dataHolder = dataHolder;
if (item == null) {
writer.startNode(mapper.serializedClass(null));
writer.endNode();
} else {
ExtendedHierarchicalStreamWriterHelper.startNode(writer, mapper
.serializedClass(item.getClass()), item.getClass());
convertAnother(item);
writer.endNode();
}
}
public Object get(Object key) {
lazilyCreateDataHolder();
return dataHolder.get(key);
}
public void put(Object key, Object value) {
lazilyCreateDataHolder();
dataHolder.put(key, value);
}
public Iterator keys() {
lazilyCreateDataHolder();
return dataHolder.keys();
}
private void lazilyCreateDataHolder() {
if (dataHolder == null) {
dataHolder = new MapBackedDataHolder();
}
}
protected Mapper getMapper() {
return this.mapper;
}
public static class CircularReferenceException extends ConversionException {
public CircularReferenceException(String msg) {
super(msg);
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/XStreamException.java 0000664 0001750 0001750 00000003172 12206661545 033441 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008 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 22. October 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream;
import com.thoughtworks.xstream.core.BaseException;
/**
* Base exception for all thrown exceptions with XStream. JDK 1.3 friendly cause handling.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.3
*/
public class XStreamException extends BaseException {
private Throwable cause;
/**
* Default constructor.
*
* @since 1.3
*/
protected XStreamException() {
this("", null);
}
/**
* Constructs an XStreamException with a message.
*
* @param message
* @since 1.3
*/
public XStreamException(String message) {
this(message, null);
}
/**
* Constructs an XStreamException as wrapper for a different causing {@link Throwable}.
*
* @param cause
* @since 1.3
*/
public XStreamException(Throwable cause) {
this("", cause);
}
/**
* Constructs an XStreamException with a message as wrapper for a different causing
* {@link Throwable}.
*
* @param message
* @param cause
* @since 1.3
*/
public XStreamException(String message, Throwable cause) {
super(message + (cause == null ? "" : " : " + cause.getMessage()));
this.cause = cause;
}
public Throwable getCause() {
return cause;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ 0000775 0001750 0001750 00000000000 12206661545 031523 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/ 0000775 0001750 0001750 00000000000 12206661545 034041 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/CharArrayConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Cha0000664 0001750 0001750 00000002464 12206661545 034465 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 06. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* Converts a char[] to XML, storing the contents as a single
* String.
*
* @author Joe Walnes
*/
public class CharArrayConverter implements Converter {
public boolean canConvert(Class type) {
return type.isArray() && type.getComponentType().equals(char.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
char[] chars = (char[]) source;
writer.setValue(new String(chars));
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
return reader.getValue().toCharArray();
}
}
././@LongLink 0000644 0000000 0000000 00000000167 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/TreeSetConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Tre0000664 0001750 0001750 00000013236 12206661545 034523 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2010, 2011 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 08. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.core.util.PresortedSet;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import java.lang.reflect.Field;
import java.util.AbstractList;
import java.util.Comparator;
import java.util.Map;
import java.util.SortedMap;
import java.util.SortedSet;
import java.util.TreeMap;
import java.util.TreeSet;
/**
* Converts a java.util.TreeSet to XML, and serializes
* the associated java.util.Comparator. The converter
* assumes that the elements in the XML are already sorted
* according the comparator.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class TreeSetConverter extends CollectionConverter {
private transient TreeMapConverter treeMapConverter;
private final static Field sortedMapField;
static {
Field smField = null;
if (!JVM.hasOptimizedTreeSetAddAll()) {
try {
Field[] fields = TreeSet.class.getDeclaredFields();
for (int i = 0; i < fields.length; i++ ) {
if (SortedMap.class.isAssignableFrom(fields[i].getType())) {
// take the fist member assignable to type "SortedMap"
smField = fields[i];
smField.setAccessible(true);
break;
}
}
if (smField == null) {
throw new ExceptionInInitializerError("Cannot detect field of backing map of TreeSet");
}
} catch (SecurityException ex) {
// ignore, no access possible with current SecurityManager
}
}
sortedMapField = smField;
}
public TreeSetConverter(Mapper mapper) {
super(mapper);
readResolve();
}
public boolean canConvert(Class type) {
return type.equals(TreeSet.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
SortedSet sortedSet = (SortedSet) source;
treeMapConverter.marshalComparator(sortedSet.comparator(), writer, context);
super.marshal(source, writer, context);
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
TreeSet result = null;
final TreeMap treeMap;
Comparator unmarshalledComparator = treeMapConverter.unmarshalComparator(reader, context, null);
boolean inFirstElement = unmarshalledComparator instanceof Mapper.Null;
Comparator comparator = inFirstElement ? null : unmarshalledComparator;
if (sortedMapField != null) {
TreeSet possibleResult = comparator == null ? new TreeSet() : new TreeSet(comparator);
Object backingMap = null;
try {
backingMap = sortedMapField.get(possibleResult);
} catch (IllegalAccessException e) {
throw new ConversionException("Cannot get backing map of TreeSet", e);
}
if (backingMap instanceof TreeMap) {
treeMap = (TreeMap)backingMap;
result = possibleResult;
} else {
treeMap = null;
}
} else {
treeMap = null;
}
if (treeMap == null) {
final PresortedSet set = new PresortedSet(comparator);
result = comparator == null ? new TreeSet() : new TreeSet(comparator);
if (inFirstElement) {
// we are already within the first element
addCurrentElementToCollection(reader, context, result, set);
reader.moveUp();
}
populateCollection(reader, context, result, set);
if (set.size() > 0) {
result.addAll(set); // comparator will not be called if internally optimized
}
} else {
treeMapConverter.populateTreeMap(reader, context, treeMap, unmarshalledComparator);
}
return result;
}
private Object readResolve() {
treeMapConverter = new TreeMapConverter(mapper()) {
protected void populateMap(HierarchicalStreamReader reader,
UnmarshallingContext context, Map map, final Map target) {
populateCollection(reader, context, new AbstractList() {
public boolean add(Object object) {
return target.put(object, object) != null;
}
public Object get(int location) {
return null;
}
public int size() {
return target.size();
}
});
}
protected void putCurrentEntryIntoMap(HierarchicalStreamReader reader, UnmarshallingContext context,
Map map, Map target) {
Object key = readItem(reader, context, map);
target.put(key, key);
}
};
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000202 12260544303 011633 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/AbstractCollectionConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Abs0000664 0001750 0001750 00000006333 12206661545 034476 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Base helper class for converters that need to handle
* collections of items (arrays, Lists, Maps, etc).
*
*
Typically, subclasses of this will converter the outer
* structure of the collection, loop through the contents and
* call readItem() or writeItem() for each item.
*
* @author Joe Walnes
*/
public abstract class AbstractCollectionConverter implements Converter {
private final Mapper mapper;
public abstract boolean canConvert(Class type);
public AbstractCollectionConverter(Mapper mapper) {
this.mapper = mapper;
}
protected Mapper mapper() {
return mapper;
}
public abstract void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context);
public abstract Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context);
protected void writeItem(Object item, MarshallingContext context, HierarchicalStreamWriter writer) {
// PUBLISHED API METHOD! If changing signature, ensure backwards compatibility.
if (item == null) {
// todo: this is duplicated in TreeMarshaller.start()
String name = mapper().serializedClass(null);
ExtendedHierarchicalStreamWriterHelper.startNode(writer, name, Mapper.Null.class);
writer.endNode();
} else {
String name = mapper().serializedClass(item.getClass());
ExtendedHierarchicalStreamWriterHelper.startNode(writer, name, item.getClass());
context.convertAnother(item);
writer.endNode();
}
}
protected Object readItem(HierarchicalStreamReader reader, UnmarshallingContext context, Object current) {
Class type = HierarchicalStreams.readClassType(reader, mapper());
return context.convertAnother(current, type);
}
protected Object createCollection(Class type) {
Class defaultType = mapper().defaultImplementationOf(type);
try {
return defaultType.newInstance();
} catch (InstantiationException e) {
throw new ConversionException("Cannot instantiate " + defaultType.getName(), e);
} catch (IllegalAccessException e) {
throw new ConversionException("Cannot instantiate " + defaultType.getName(), e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/ArrayConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Arr0000664 0001750 0001750 00000004472 12206661545 034517 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 03. October 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import java.lang.reflect.Array;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
/**
* Converts an array of objects or primitives to XML, using
* a nested child element for each item.
*
* @author Joe Walnes
*/
public class ArrayConverter extends AbstractCollectionConverter {
public ArrayConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return type.isArray();
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
int length = Array.getLength(source);
for (int i = 0; i < length; i++) {
Object item = Array.get(source, i);
writeItem(item, context, writer);
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
// read the items from xml into a list
List items = new ArrayList();
while (reader.hasMoreChildren()) {
reader.moveDown();
Object item = readItem(reader, context, null); // TODO: arg, what should replace null?
items.add(item);
reader.moveUp();
}
// now convertAnother the list into an array
// (this has to be done as a separate list as the array size is not
// known until all items have been read)
Object array = Array.newInstance(context.getRequiredType().getComponentType(), items.size());
int i = 0;
for (Iterator iterator = items.iterator(); iterator.hasNext();) {
Array.set(array, i++, iterator.next());
}
return array;
}
}
././@LongLink 0000644 0000000 0000000 00000000172 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/PropertiesConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Pro0000664 0001750 0001750 00000010075 12206661545 034527 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 23. February 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.util.Fields;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.lang.reflect.Field;
import java.util.Iterator;
import java.util.Map;
import java.util.Properties;
import java.util.TreeMap;
/**
* Special converter for java.util.Properties that stores properties in a more compact form than
* java.util.Map.
*
* Because all entries of a Properties instance are Strings, a single element is used for each
* property with two attributes; one for key and one for value.
*
*
* Additionally, default properties are also serialized, if they are present or if a
* SecurityManager is set, and it has permissions for SecurityManager.checkPackageAccess,
* SecurityManager.checkMemberAccess(this, EnumSet.MEMBER) and
* ReflectPermission("suppressAccessChecks").
*
*
* @author Joe Walnes
* @author Kevin Ring
*/
public class PropertiesConverter implements Converter {
private final static Field defaultsField;
static {
Field field = null;
try {
field = Fields.find(Properties.class, "defaults");
} catch (SecurityException ex) {
// ignore, no access possible with current SecurityManager
} catch (RuntimeException ex) {
throw new ExceptionInInitializerError("No field 'defaults' in type Properties found");
}
defaultsField = field;
}
private final boolean sort;
public PropertiesConverter() {
this(false);
}
public PropertiesConverter(boolean sort) {
this.sort = sort;
}
public boolean canConvert(Class type) {
return Properties.class == type;
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
final Properties properties = (Properties) source;
Map map = sort ? (Map)new TreeMap(properties) : (Map)properties;
for (Iterator iterator = map.entrySet().iterator(); iterator.hasNext();) {
Map.Entry entry = (Map.Entry) iterator.next();
writer.startNode("property");
writer.addAttribute("name", entry.getKey().toString());
writer.addAttribute("value", entry.getValue().toString());
writer.endNode();
}
if (defaultsField != null) {
Properties defaults = (Properties)Fields.read(defaultsField, properties);
if (defaults != null) {
writer.startNode("defaults");
marshal(defaults, writer, context);
writer.endNode();
}
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Properties properties = new Properties();
Properties defaults = null;
while (reader.hasMoreChildren()) {
reader.moveDown();
if (reader.getNodeName().equals("defaults")) {
defaults = (Properties) unmarshal(reader, context);
} else {
String name = reader.getAttribute("name");
String value = reader.getAttribute("value");
properties.setProperty(name, value);
}
reader.moveUp();
}
if (defaults == null) {
return properties;
} else {
Properties propertiesWithDefaults = new Properties(defaults);
propertiesWithDefaults.putAll(properties);
return propertiesWithDefaults;
}
}
}
././@LongLink 0000644 0000000 0000000 00000000172 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/CollectionConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Col0000664 0001750 0001750 00000006026 12206661545 034505 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2010, 2011 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 01. October 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashSet;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.Vector;
/**
* Converts most common Collections (Lists and Sets) to XML, specifying a nested
* element for each item.
*
*
Supports java.util.ArrayList, java.util.HashSet,
* java.util.LinkedList, java.util.Vector and java.util.LinkedHashSet.
*
* @author Joe Walnes
*/
public class CollectionConverter extends AbstractCollectionConverter {
public CollectionConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return type.equals(ArrayList.class)
|| type.equals(HashSet.class)
|| type.equals(LinkedList.class)
|| type.equals(Vector.class)
|| (JVM.is14() && type.getName().equals("java.util.LinkedHashSet"));
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Collection collection = (Collection) source;
for (Iterator iterator = collection.iterator(); iterator.hasNext();) {
Object item = iterator.next();
writeItem(item, context, writer);
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Collection collection = (Collection) createCollection(context.getRequiredType());
populateCollection(reader, context, collection);
return collection;
}
protected void populateCollection(HierarchicalStreamReader reader, UnmarshallingContext context, Collection collection) {
populateCollection(reader, context, collection, collection);
}
protected void populateCollection(HierarchicalStreamReader reader, UnmarshallingContext context, Collection collection, Collection target) {
while (reader.hasMoreChildren()) {
reader.moveDown();
addCurrentElementToCollection(reader, context, collection, target);
reader.moveUp();
}
}
protected void addCurrentElementToCollection(HierarchicalStreamReader reader, UnmarshallingContext context,
Collection collection, Collection target) {
Object item = readItem(reader, context, collection);
target.add(item);
}
}
././@LongLink 0000644 0000000 0000000 00000000203 12260544303 011634 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/SingletonCollectionConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Sin0000664 0001750 0001750 00000003314 12206661545 034516 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 11. October 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.collections;
import java.util.Collections;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Converts singleton collections (list and set) to XML, specifying a nested element for the
* item.
*
* Supports Collections.singleton(Object) and Collections.singletonList(Object).
*
*
* @author Jörg Schaible
* @since 1.4.2
*/
public class SingletonCollectionConverter extends CollectionConverter {
private static final Class LIST = Collections.singletonList(Boolean.TRUE).getClass();
private static final Class SET = Collections.singleton(Boolean.TRUE).getClass();
/**
* Construct a SingletonCollectionConverter.
*
* @param mapper the mapper
* @since 1.4.2
*/
public SingletonCollectionConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return LIST == type || SET == type;
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
reader.moveDown();
Object item = readItem(reader, context, null);
reader.moveUp();
return context.getRequiredType() == LIST
? (Object)Collections.singletonList(item)
: (Object)Collections.singleton(item);
}
}
././@LongLink 0000644 0000000 0000000 00000000167 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/TreeMapConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Tre0000664 0001750 0001750 00000014132 12206661545 034517 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2010, 2011 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 08. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.core.util.PresortedMap;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import java.lang.reflect.Field;
import java.util.Comparator;
import java.util.SortedMap;
import java.util.TreeMap;
/**
* Converts a java.util.TreeMap to XML, and serializes
* the associated java.util.Comparator. The converter
* assumes that the entries in the XML are already sorted
* according the comparator.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class TreeMapConverter extends MapConverter {
private static final class NullComparator extends Mapper.Null implements Comparator {
public int compare(Object o1, Object o2) {
Comparable c1 = (Comparable)o1;
Comparable c2 = (Comparable)o2;
return c1.compareTo(o2);
}
}
private final static Comparator NULL_MARKER = new NullComparator();
private final static Field comparatorField;
static {
Field cmpField = null;
try {
Field[] fields = TreeMap.class.getDeclaredFields();
for (int i = 0; i < fields.length; i++ ) {
if (fields[i].getType() == Comparator.class) {
// take the fist member of type "Comparator"
cmpField = fields[i];
cmpField.setAccessible(true);
break;
}
}
if (cmpField == null) {
throw new ExceptionInInitializerError("Cannot detect comparator field of TreeMap");
}
} catch (SecurityException ex) {
// ignore, no access possible with current SecurityManager
}
comparatorField = cmpField;
}
public TreeMapConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return type.equals(TreeMap.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
SortedMap sortedMap = (SortedMap) source;
marshalComparator(sortedMap.comparator(), writer, context);
super.marshal(source, writer, context);
}
protected void marshalComparator(Comparator comparator, HierarchicalStreamWriter writer,
MarshallingContext context) {
if (comparator != null) {
writer.startNode("comparator");
writer.addAttribute(mapper().aliasForSystemAttribute("class"),
mapper().serializedClass(comparator.getClass()));
context.convertAnother(comparator);
writer.endNode();
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
TreeMap result = comparatorField != null ? new TreeMap() : null;
final Comparator comparator = unmarshalComparator(reader, context, result);
if (result == null) {
result = comparator == null ? new TreeMap() : new TreeMap(comparator);
}
populateTreeMap(reader, context, result, comparator);
return result;
}
protected Comparator unmarshalComparator(HierarchicalStreamReader reader,
UnmarshallingContext context, TreeMap result) {
final Comparator comparator;
if (reader.hasMoreChildren()) {
reader.moveDown();
if (reader.getNodeName().equals("comparator")) {
Class comparatorClass = HierarchicalStreams.readClassType(reader, mapper());
comparator = (Comparator) context.convertAnother(result, comparatorClass);
} else if (reader.getNodeName().equals("no-comparator")) { // pre 1.4 format
comparator = null;
} else {
// we are already within the first entry
return NULL_MARKER;
}
reader.moveUp();
} else {
comparator = null;
}
return comparator;
}
protected void populateTreeMap(HierarchicalStreamReader reader, UnmarshallingContext context,
TreeMap result, Comparator comparator) {
boolean inFirstElement = comparator == NULL_MARKER;
if (inFirstElement) {
comparator = null;
}
SortedMap sortedMap = new PresortedMap(comparator != null && JVM.hasOptimizedTreeMapPutAll() ? comparator : null);
if (inFirstElement) {
// we are already within the first entry
putCurrentEntryIntoMap(reader, context, result, sortedMap);
reader.moveUp();
}
populateMap(reader, context, result, sortedMap);
try {
if (JVM.hasOptimizedTreeMapPutAll()) {
if (comparator != null && comparatorField != null) {
comparatorField.set(result, comparator);
}
result.putAll(sortedMap); // internal optimization will not call comparator
} else if (comparatorField != null) {
comparatorField.set(result, sortedMap.comparator());
result.putAll(sortedMap); // "sort" by index
comparatorField.set(result, comparator);
} else {
result.putAll(sortedMap); // will use comparator for already sorted map
}
} catch (final IllegalAccessException e) {
throw new ConversionException("Cannot set comparator of TreeMap", e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/package.html jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/pac0000664 0001750 0001750 00000001036 12206661545 034527 0 ustar jamespage jamespage
Converters for collection objects that write their items as
nested elements, such as arrays, Lists, Sets and Maps.
All the converters in this package are enabled by default.
././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/BitSetConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Bit0000664 0001750 0001750 00000003732 12206661545 034507 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.util.BitSet;
import java.util.StringTokenizer;
/**
* Converts a java.util.BitSet to XML, as a compact
* comma delimited list of ones and zeros.
*
* @author Joe Walnes
*/
public class BitSetConverter implements Converter {
public boolean canConvert(Class type) {
return type.equals(BitSet.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
BitSet bitSet = (BitSet) source;
StringBuffer buffer = new StringBuffer();
boolean seenFirst = false;
for (int i = 0; i < bitSet.length(); i++) {
if (bitSet.get(i)) {
if (seenFirst) {
buffer.append(',');
} else {
seenFirst = true;
}
buffer.append(i);
}
}
writer.setValue(buffer.toString());
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
BitSet result = new BitSet();
StringTokenizer tokenizer = new StringTokenizer(reader.getValue(), ",", false);
while (tokenizer.hasMoreTokens()) {
int index = Integer.parseInt(tokenizer.nextToken());
result.set(index);
}
return result;
}
}
././@LongLink 0000644 0000000 0000000 00000000163 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/MapConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Map0000664 0001750 0001750 00000006760 12206661545 034512 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010, 2011, 2012 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.collections;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import java.util.HashMap;
import java.util.Hashtable;
import java.util.Iterator;
import java.util.Map;
/**
* Converts a java.util.Map to XML, specifying an 'entry'
* element with 'key' and 'value' children.
*
Note: 'key' and 'value' is not the name of the generated tag. The
* children are serialized as normal elements and the implementation expects
* them in the order 'key'/'value'.
*
Supports java.util.HashMap, java.util.Hashtable,
* java.util.LinkedHashMap and java.util.concurrent.ConcurrentHashMap.
*
* @author Joe Walnes
*/
public class MapConverter extends AbstractCollectionConverter {
public MapConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return type.equals(HashMap.class)
|| type.equals(Hashtable.class)
|| type.getName().equals("java.util.LinkedHashMap")
|| type.getName().equals("java.util.concurrent.ConcurrentHashMap")
|| type.getName().equals("sun.font.AttributeMap") // Used by java.awt.Font in JDK 6
;
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Map map = (Map) source;
for (Iterator iterator = map.entrySet().iterator(); iterator.hasNext();) {
Map.Entry entry = (Map.Entry) iterator.next();
ExtendedHierarchicalStreamWriterHelper.startNode(writer, mapper().serializedClass(Map.Entry.class), entry.getClass());
writeItem(entry.getKey(), context, writer);
writeItem(entry.getValue(), context, writer);
writer.endNode();
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Map map = (Map) createCollection(context.getRequiredType());
populateMap(reader, context, map);
return map;
}
protected void populateMap(HierarchicalStreamReader reader, UnmarshallingContext context, Map map) {
populateMap(reader, context, map, map);
}
protected void populateMap(HierarchicalStreamReader reader, UnmarshallingContext context, Map map, Map target) {
while (reader.hasMoreChildren()) {
reader.moveDown();
putCurrentEntryIntoMap(reader, context, map, target);
reader.moveUp();
}
}
protected void putCurrentEntryIntoMap(HierarchicalStreamReader reader, UnmarshallingContext context,
Map map, Map target) {
reader.moveDown();
Object key = readItem(reader, context, map);
reader.moveUp();
reader.moveDown();
Object value = readItem(reader, context, map);
reader.moveUp();
target.put(key, value);
}
}
././@LongLink 0000644 0000000 0000000 00000000174 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/SingletonMapConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/collections/Sin0000664 0001750 0001750 00000003413 12206661545 034516 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 11. October 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.collections;
import java.util.Collections;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Converts a singleton map to XML, specifying an 'entry'
* element with 'key' and 'value' children.
*
Note: 'key' and 'value' is not the name of the generated tag. The
* children are serialized as normal elements and the implementation expects
* them in the order 'key'/'value'.
*
Supports Collections.singletonMap.
*
* @author Jörg Schaible
* @since 1.4.2
*/
public class SingletonMapConverter extends MapConverter {
private static final Class MAP = Collections.singletonMap(Boolean.TRUE, null).getClass();
/**
* Construct a SingletonMapConverter.
* @param mapper
* @since 1.4.2
*/
public SingletonMapConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return MAP == type;
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
reader.moveDown();
reader.moveDown();
Object key = readItem(reader, context, null);
reader.moveUp();
reader.moveDown();
Object value = readItem(reader, context, null);
reader.moveUp();
reader.moveUp();
return Collections.singletonMap(key, value);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/DataHolder.java0000664 0001750 0001750 00000001163 12206661545 034376 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 16. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
import java.util.Iterator;
/**
* Holds generic data, to be used as seen fit by the user.
*
* @author Joe Walnes
*/
public interface DataHolder {
Object get(Object key);
void put(Object key, Object value);
Iterator keys();
}
././@LongLink 0000644 0000000 0000000 00000000146 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ErrorWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ErrorWriter.jav0000664 0001750 0001750 00000003407 12206661545 034517 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 08. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
import java.util.Iterator;
/**
* To aid debugging, some components are passed an ErrorWriter
* when things go wrong, allowing them to add information
* to the error message that may be helpful to diagnose problems.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public interface ErrorWriter {
/**
* Add some information to the error message. The information will be added even
* if the identifier is already in use.
*
* @param name something to identify the type of information (e.g. 'XPath').
* @param information detail of the message (e.g. '/blah/moo[3]'
*/
void add(String name, String information);
/**
* Set some information to the error message. If the identifier is already in use, the
* new information will replace the old one.
*
* @param name something to identify the type of information (e.g. 'XPath').
* @param information detail of the message (e.g. '/blah/moo[3]'
* @since 1.4
*/
void set(String name, String information);
/**
* Retrieve information of the error message.
*
* @param errorKey the key of the message
* @return the value
* @since 1.3
*/
String get(String errorKey);
/**
* Retrieve an iterator over all keys of the error message.
*
* @return an Iterator
* @since 1.3
*/
Iterator keys();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/ 0000775 0001750 0001750 00000000000 12206661545 033272 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000173 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/ComparingPropertySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/Compar0000664 0001750 0001750 00000001721 12206661545 034437 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 16. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.javabean;
import java.util.Comparator;
import java.util.Map;
import java.util.TreeMap;
/**
* A sorter that uses a comparator to determine the order of the bean properties.
*
* @author Jörg Schaible
* @since 1.4
*/
public class ComparingPropertySorter implements PropertySorter {
private final Comparator comparator;
public ComparingPropertySorter(final Comparator propertyNameComparator) {
this.comparator = propertyNameComparator;
}
public Map sort(final Class type, final Map nameMap) {
TreeMap map = new TreeMap(comparator);
map.putAll(nameMap);
return map;
}
} ././@LongLink 0000644 0000000 0000000 00000000162 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/PropertySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/Proper0000664 0001750 0001750 00000002652 12206661545 034471 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 16. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.javabean;
import java.beans.PropertyDescriptor;
import java.util.Map;
/**
* An interface capable of sorting Java bean properties. Implement this interface if you
* want to customize the order in which XStream serializes the properties of a bean.
*
* @author Jörg Schaible
* @since 1.4
*/
public interface PropertySorter {
/**
* Sort the properties of a bean type. The method will be called with the class type
* that contains all the properties and a Map that retains the order in which the
* elements have been added. The sequence in which elements are returned by an iterator
* defines the processing order of the properties. An implementation may create a
* different Map with similar semantic, add all elements of the original map and return
* the new one.
*
* @param type the bean class that contains all the properties
* @param nameMap the map to sort, key is the property name, value the
* {@link PropertyDescriptor}
* @return the sorted nameMap
* @since 1.4
*/
Map sort(Class type, Map nameMap);
} ././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/PropertyDictionary.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/Proper0000664 0001750 0001750 00000010507 12206661545 034467 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 12. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.javabean;
import java.beans.BeanInfo;
import java.beans.IntrospectionException;
import java.beans.Introspector;
import java.beans.PropertyDescriptor;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import com.thoughtworks.xstream.converters.reflection.MissingFieldException;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
import com.thoughtworks.xstream.core.Caching;
import com.thoughtworks.xstream.core.util.OrderRetainingMap;
/**
* Builds the properties maps for each bean and caches them.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class PropertyDictionary implements Caching {
private transient Map propertyNameCache = Collections.synchronizedMap(new HashMap());
private final PropertySorter sorter;
public PropertyDictionary() {
this(new NativePropertySorter());
}
public PropertyDictionary(PropertySorter sorter) {
this.sorter = sorter;
}
/**
* @deprecated As of 1.3.1, use {@link #propertiesFor(Class)} instead
*/
public Iterator serializablePropertiesFor(Class type) {
Collection beanProperties = new ArrayList();
Collection descriptors = buildMap(type).values();
for (Iterator iter = descriptors.iterator(); iter.hasNext();) {
PropertyDescriptor descriptor = (PropertyDescriptor)iter.next();
if (descriptor.getReadMethod() != null && descriptor.getWriteMethod() != null) {
beanProperties.add(new BeanProperty(type, descriptor.getName(), descriptor
.getPropertyType()));
}
}
return beanProperties.iterator();
}
/**
* Locates a serializable property.
*
* @param cls
* @param name
* @deprecated As of 1.3.1, use {@link #propertyDescriptor(Class, String)} instead
*/
public BeanProperty property(Class cls, String name) {
BeanProperty beanProperty = null;
PropertyDescriptor descriptor = (PropertyDescriptor)buildMap(cls).get(name);
if (descriptor == null) {
throw new MissingFieldException(cls.getName(), name);
}
if (descriptor.getReadMethod() != null && descriptor.getWriteMethod() != null) {
beanProperty = new BeanProperty(
cls, descriptor.getName(), descriptor.getPropertyType());
}
return beanProperty;
}
public Iterator propertiesFor(Class type) {
return buildMap(type).values().iterator();
}
/**
* Locates a property descriptor.
*
* @param type
* @param name
*/
public PropertyDescriptor propertyDescriptor(Class type, String name) {
PropertyDescriptor descriptor = (PropertyDescriptor)buildMap(type).get(name);
if (descriptor == null) {
throw new MissingFieldException(type.getName(), name);
}
return descriptor;
}
private Map buildMap(Class type) {
Map nameMap = (Map)propertyNameCache.get(type);
if (nameMap == null) {
BeanInfo beanInfo;
try {
beanInfo = Introspector.getBeanInfo(type, Object.class);
} catch (IntrospectionException e) {
throw new ObjectAccessException(
"Cannot get BeanInfo of type " + type.getName(), e);
}
nameMap = new OrderRetainingMap();
PropertyDescriptor[] propertyDescriptors = beanInfo.getPropertyDescriptors();
for (int i = 0; i < propertyDescriptors.length; i++ ) {
PropertyDescriptor descriptor = propertyDescriptors[i];
nameMap.put(descriptor.getName(), descriptor);
}
nameMap = sorter.sort(type, nameMap);
propertyNameCache.put(type, nameMap);
}
return nameMap;
}
public void flushCache() {
propertyNameCache.clear();
}
}
././@LongLink 0000644 0000000 0000000 00000000160 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/BeanProvider.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/BeanPr0000664 0001750 0001750 00000016170 12206661545 034371 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010, 2011 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 12. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.javabean;
import java.beans.PropertyDescriptor;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.Iterator;
import java.util.List;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
public class BeanProvider implements JavaBeanProvider {
protected static final Object[] NO_PARAMS = new Object[0];
protected PropertyDictionary propertyDictionary;
/**
* Construct a BeanProvider that will process the bean properties in their natural order.
*/
public BeanProvider() {
this(new PropertyDictionary(new NativePropertySorter()));
}
/**
* Construct a BeanProvider with a comparator to sort the bean properties by name in the
* dictionary.
*
* @param propertyNameComparator the comparator
*/
public BeanProvider(final Comparator propertyNameComparator) {
this(new PropertyDictionary(new ComparingPropertySorter(propertyNameComparator)));
}
/**
* Construct a BeanProvider with a provided property dictionary.
*
* @param propertyDictionary the property dictionary to use
* @since 1.4
*/
public BeanProvider(final PropertyDictionary propertyDictionary) {
this.propertyDictionary = propertyDictionary;
}
public Object newInstance(Class type) {
try {
return getDefaultConstrutor(type).newInstance(NO_PARAMS);
} catch (InstantiationException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (InvocationTargetException e) {
if (e.getTargetException() instanceof RuntimeException) {
throw (RuntimeException)e.getTargetException();
} else if (e.getTargetException() instanceof Error) {
throw (Error)e.getTargetException();
} else {
throw new ObjectAccessException("Constructor for "
+ type.getName()
+ " threw an exception", e);
}
}
}
public void visitSerializableProperties(Object object, JavaBeanProvider.Visitor visitor) {
PropertyDescriptor[] propertyDescriptors = getSerializableProperties(object);
for (int i = 0; i < propertyDescriptors.length; i++ ) {
PropertyDescriptor property = propertyDescriptors[i];
try {
Method readMethod = property.getReadMethod();
String name = property.getName();
Class definedIn = readMethod.getDeclaringClass();
if (visitor.shouldVisit(name, definedIn)) {
Object value = readMethod.invoke(object, new Object[0]);
visitor.visit(name, property.getPropertyType(), definedIn, value);
}
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not get property "
+ object.getClass()
+ "."
+ property.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not get property "
+ object.getClass()
+ "."
+ property.getName(), e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException("Could not get property "
+ object.getClass()
+ "."
+ property.getName(), e);
}
}
}
public void writeProperty(Object object, String propertyName, Object value) {
PropertyDescriptor property = getProperty(propertyName, object.getClass());
try {
property.getWriteMethod().invoke(object, new Object[]{value});
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not set property "
+ object.getClass()
+ "."
+ property.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not set property "
+ object.getClass()
+ "."
+ property.getName(), e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException("Could not set property "
+ object.getClass()
+ "."
+ property.getName(), e);
}
}
public Class getPropertyType(Object object, String name) {
return getProperty(name, object.getClass()).getPropertyType();
}
public boolean propertyDefinedInClass(String name, Class type) {
return getProperty(name, type) != null;
}
/**
* Returns true if the Bean provider can instantiate the specified class
*/
public boolean canInstantiate(Class type) {
return getDefaultConstrutor(type) != null;
}
/**
* Returns the default constructor, or null if none is found
*
* @param type
*/
protected Constructor getDefaultConstrutor(Class type) {
Constructor[] constructors = type.getConstructors();
for (int i = 0; i < constructors.length; i++ ) {
Constructor c = constructors[i];
if (c.getParameterTypes().length == 0 && Modifier.isPublic(c.getModifiers()))
return c;
}
return null;
}
protected PropertyDescriptor[] getSerializableProperties(Object object) {
List result = new ArrayList();
for (final Iterator iter = propertyDictionary.propertiesFor(object.getClass()); iter.hasNext();) {
final PropertyDescriptor descriptor = (PropertyDescriptor)iter.next();
if (canStreamProperty(descriptor)) {
result.add(descriptor);
}
}
return (PropertyDescriptor[])result.toArray(new PropertyDescriptor[result.size()]);
}
protected boolean canStreamProperty(PropertyDescriptor descriptor) {
return descriptor.getReadMethod() != null && descriptor.getWriteMethod() != null;
}
public boolean propertyWriteable(String name, Class type) {
PropertyDescriptor property = getProperty(name, type);
return property.getWriteMethod() != null;
}
protected PropertyDescriptor getProperty(String name, Class type) {
return (PropertyDescriptor)propertyDictionary.propertyDescriptor(type, name);
}
/**
* @deprecated As of 1.4 use {@link JavaBeanProvider.Visitor}
*/
public interface Visitor extends JavaBeanProvider.Visitor {
}
}
././@LongLink 0000644 0000000 0000000 00000000170 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/NativePropertySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/Native0000664 0001750 0001750 00000001305 12206661545 034442 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 16. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.javabean;
import java.util.Map;
/**
* A sorter that keeps the natural order of the bean properties as they are returned by the
* JavaBean introspection.
*
* @author Jörg Schaible
* @since 1.4
*/
public class NativePropertySorter implements PropertySorter {
public Map sort(final Class type, final Map nameMap) {
return nameMap;
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/JavaBeanProvider.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/JavaBe0000664 0001750 0001750 00000002042 12206661545 034343 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 07. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.javabean;
/**
* @author Jörg Schaible
*
* @since 1.4
*/
public interface JavaBeanProvider {
Object newInstance(Class type);
void visitSerializableProperties(Object object, Visitor visitor);
void writeProperty(Object object, String propertyName, Object value);
Class getPropertyType(Object object, String name);
boolean propertyDefinedInClass(String name, Class type);
/**
* Returns true if the Bean provider can instantiate the specified class
*/
boolean canInstantiate(Class type);
public interface Visitor {
boolean shouldVisit(String name, Class definedIn);
void visit(String name, Class type, Class definedIn, Object value);
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/JavaBeanConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/JavaBe0000664 0001750 0001750 00000016375 12206661545 034361 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012 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 12. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.javabean;
import java.util.HashSet;
import java.util.Set;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.converters.reflection.MissingFieldException;
import com.thoughtworks.xstream.core.util.FastField;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Can convert any bean with a public default constructor. The {@link BeanProvider} used as
* default is based on {@link java.beans.BeanInfo}. Indexed properties are currently not supported.
*/
public class JavaBeanConverter implements Converter {
/*
* TODO:
* - support indexed properties
* - support attributes (XSTR-620)
* - support local converters (XSTR-601)
* Problem: Mappers take definitions based on reflection, they don't know about bean info
*/
protected final Mapper mapper;
protected final JavaBeanProvider beanProvider;
private final Class type;
/**
* @deprecated As of 1.3, no necessity for field anymore.
*/
private String classAttributeIdentifier;
public JavaBeanConverter(Mapper mapper) {
this(mapper, (Class)null);
}
public JavaBeanConverter(Mapper mapper, Class type) {
this(mapper, new BeanProvider(), type);
}
public JavaBeanConverter(Mapper mapper, JavaBeanProvider beanProvider) {
this(mapper,beanProvider, null);
}
public JavaBeanConverter(Mapper mapper, JavaBeanProvider beanProvider, Class type) {
this.mapper = mapper;
this.beanProvider = beanProvider;
this.type = type;
}
/**
* @deprecated As of 1.3, use {@link #JavaBeanConverter(Mapper)} and {@link com.thoughtworks.xstream.XStream#aliasAttribute(String, String)}
*/
public JavaBeanConverter(Mapper mapper, String classAttributeIdentifier) {
this(mapper, new BeanProvider());
this.classAttributeIdentifier = classAttributeIdentifier;
}
/**
* Only checks for the availability of a public default constructor.
* If you need stricter checks, subclass JavaBeanConverter
*/
public boolean canConvert(Class type) {
return (this.type == null || this.type==type) && beanProvider.canInstantiate(type);
}
public void marshal(final Object source, final HierarchicalStreamWriter writer, final MarshallingContext context) {
final String classAttributeName = classAttributeIdentifier != null ? classAttributeIdentifier : mapper.aliasForSystemAttribute("class");
beanProvider.visitSerializableProperties(source, new JavaBeanProvider.Visitor() {
public boolean shouldVisit(String name, Class definedIn) {
return mapper.shouldSerializeMember(definedIn, name);
}
public void visit(String propertyName, Class fieldType, Class definedIn, Object newObj) {
if (newObj != null) {
writeField(propertyName, fieldType, newObj, definedIn);
}
}
private void writeField(String propertyName, Class fieldType, Object newObj, Class definedIn) {
Class actualType = newObj.getClass();
Class defaultType = mapper.defaultImplementationOf(fieldType);
String serializedMember = mapper.serializedMember(source.getClass(), propertyName);
ExtendedHierarchicalStreamWriterHelper.startNode(writer, serializedMember, actualType);
if (!actualType.equals(defaultType) && classAttributeName != null) {
writer.addAttribute(classAttributeName, mapper.serializedClass(actualType));
}
context.convertAnother(newObj);
writer.endNode();
}
});
}
public Object unmarshal(final HierarchicalStreamReader reader, final UnmarshallingContext context) {
final Object result = instantiateNewInstance(context);
final Set seenProperties = new HashSet() {
public boolean add(Object e) {
if (!super.add(e)) {
throw new DuplicatePropertyException(((FastField)e).getName());
}
return true;
}
};
Class resultType = result.getClass();
while (reader.hasMoreChildren()) {
reader.moveDown();
String propertyName = mapper.realMember(resultType, reader.getNodeName());
if (mapper.shouldSerializeMember(resultType, propertyName)) {
boolean propertyExistsInClass = beanProvider.propertyDefinedInClass(propertyName, resultType);
if (propertyExistsInClass) {
Class type = determineType(reader, result, propertyName);
Object value = context.convertAnother(result, type);
beanProvider.writeProperty(result, propertyName, value);
seenProperties.add(new FastField(resultType, propertyName));
} else {
throw new MissingFieldException(resultType.getName(), propertyName);
}
}
reader.moveUp();
}
return result;
}
private Object instantiateNewInstance(UnmarshallingContext context) {
Object result = context.currentObject();
if (result == null) {
result = beanProvider.newInstance(context.getRequiredType());
}
return result;
}
private Class determineType(HierarchicalStreamReader reader, Object result, String fieldName) {
final String classAttributeName = classAttributeIdentifier != null ? classAttributeIdentifier : mapper.aliasForSystemAttribute("class");
String classAttribute = classAttributeName == null ? null : reader.getAttribute(classAttributeName);
if (classAttribute != null) {
return mapper.realClass(classAttribute);
} else {
return mapper.defaultImplementationOf(beanProvider.getPropertyType(result, fieldName));
}
}
/**
* @deprecated As of 1.3
*/
public static class DuplicateFieldException extends ConversionException {
public DuplicateFieldException(String msg) {
super(msg);
}
}
/**
* Exception to indicate double processing of a property to avoid silent clobbering.
*
* @author Jörg Schaible
* @since 1.4.2
*/
public static class DuplicatePropertyException extends ConversionException {
public DuplicatePropertyException(String msg) {
super("Duplicate property " + msg);
add("property", msg);
}
}
} ././@LongLink 0000644 0000000 0000000 00000000160 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/BeanProperty.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/javabean/BeanPr0000664 0001750 0001750 00000007032 12206661545 034366 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 12. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.javabean;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.lang.reflect.UndeclaredThrowableException;
/**
* Provide access to a bean property.
*
* @author Andrea Aime
* @deprecated As of 1.3.1, no longer in use
*/
public class BeanProperty {
/** the target class */
private Class memberClass;
/** the property name */
private String propertyName;
/** the property type */
private Class type;
/** the getter */
protected Method getter;
/** the setter */
private Method setter;
private static final Object[] EMPTY_ARGS = new Object[0];
/**
* Creates a new {@link BeanProperty}that gets the specified property from
* the specified class.
*/
public BeanProperty(Class memberClass, String propertyName, Class propertyType) {
this.memberClass = memberClass;
this.propertyName = propertyName;
this.type = propertyType;
}
/**
* Gets the base class that this getter accesses.
*/
public Class getBeanClass() {
return memberClass;
}
/**
* Returns the property type
*/
public Class getType() {
return type;
}
/**
* Gets the name of the property that this getter extracts.
*/
public String getName() {
return propertyName;
}
/**
* Gets whether this property can get get.
*/
public boolean isReadable() {
return (getter != null);
}
/**
* Gets whether this property can be set.
*/
public boolean isWritable() {
return (setter != null);
}
/**
* Gets the value of this property for the specified Object.
* @throws IllegalAccessException
* @throws IllegalArgumentException
*/
public Object get(Object member) throws IllegalArgumentException, IllegalAccessException {
if (!isReadable())
throw new IllegalStateException("Property " + propertyName + " of " + memberClass
+ " not readable");
try {
return getter.invoke(member, EMPTY_ARGS);
} catch (InvocationTargetException e) {
throw new UndeclaredThrowableException(e.getTargetException());
}
}
/**
* Sets the value of this property for the specified Object.
* @throws IllegalAccessException
* @throws IllegalArgumentException
*/
public Object set(Object member, Object newValue) throws IllegalArgumentException, IllegalAccessException {
if (!isWritable())
throw new IllegalStateException("Property " + propertyName + " of " + memberClass
+ " not writable");
try {
return setter.invoke(member, new Object[] { newValue });
} catch (InvocationTargetException e) {
throw new UndeclaredThrowableException(e.getTargetException());
}
}
/**
* @param method
*/
public void setGetterMethod(Method method) {
this.getter = method;
}
/**
* @param method
*/
public void setSetterMethod(Method method) {
this.setter = method;
}
} ././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ErrorReporter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ErrorReporter.j0000664 0001750 0001750 00000001374 12206661545 034517 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 15.02.2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters;
/**
* To aid debugging, some components expose themselves as ErrorReporter
* indicating that they can add information in case of an error..
*
* @author Joerg Schaible
*
* @since 1.4
*/
public interface ErrorReporter {
/**
* Append context information to an {@link ErrorWriter}.
*
* @param errorWriter the error writer
* @since 1.4
*/
void appendErrors(ErrorWriter errorWriter);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/Converter.java 0000664 0001750 0001750 00000005011 12206661545 034332 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* Converter implementations are responsible marshalling Java objects
* to/from textual data.
*
*
If an exception occurs during processing, a {@link ConversionException}
* should be thrown.
*
*
If working with the high level {@link com.thoughtworks.xstream.XStream} facade,
* you can register new converters using the XStream.registerConverter() method.
*
*
If working with the lower level API, the
* {@link com.thoughtworks.xstream.converters.ConverterLookup} implementation is
* responsible for looking up the appropriate converter.
*
*
Converters for object that can store all information in a single value
* should implement {@link com.thoughtworks.xstream.converters.SingleValueConverter}.
*
{@link com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter}
* provides a starting point.
*
*
{@link com.thoughtworks.xstream.converters.collections.AbstractCollectionConverter}
* provides a starting point for objects that hold a collection of other objects
* (such as Lists and Maps).
*
* @author Joe Walnes
* @see com.thoughtworks.xstream.XStream
* @see com.thoughtworks.xstream.converters.ConverterLookup
* @see com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter
* @see com.thoughtworks.xstream.converters.collections.AbstractCollectionConverter
*/
public interface Converter extends ConverterMatcher {
/**
* Convert an object to textual data.
*
* @param source The object to be marshalled.
* @param writer A stream to write to.
* @param context A context that allows nested objects to be processed by XStream.
*/
void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context);
/**
* Convert textual data back into an object.
*
* @param reader The stream to read the text from.
* @param context
* @return The resulting object.
*/
Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/ 0000775 0001750 0001750 00000000000 12206661545 032604 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/LongConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/LongConve0000664 0001750 0001750 00000001405 12206661545 034421 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts a long primitive or java.lang.Long wrapper to
* a String.
*
* @author Joe Walnes
*/
public class LongConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(long.class) || type.equals(Long.class);
}
public Object fromString(String str) {
return Long.decode(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/UUIDConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/UUIDConve0000664 0001750 0001750 00000001637 12206661545 034277 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 04. January 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.basic;
import com.thoughtworks.xstream.converters.ConversionException;
import java.util.UUID;
/**
* Converts a java.util.UUID to a string.
*
* @author Jörg Schaible
*/
public class UUIDConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(UUID.class);
}
public Object fromString(String str) {
try {
return UUID.fromString(str);
} catch(IllegalArgumentException e) {
throw new ConversionException("Cannot create UUID instance", e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/FloatConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/FloatConv0000664 0001750 0001750 00000001414 12206661545 034422 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts a float primitive or java.lang.Float wrapper to
* a String.
*
* @author Joe Walnes
*/
public class FloatConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(float.class) || type.equals(Float.class);
}
public Object fromString(String str) {
return Float.valueOf(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/ByteConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/ByteConve0000664 0001750 0001750 00000001713 12206661545 034427 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts a byte primitive or java.lang.Byte wrapper to
* a String.
*
* @author Joe Walnes
*/
public class ByteConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(byte.class) || type.equals(Byte.class);
}
public Object fromString(String str) {
int value = Integer.decode(str).intValue();
if(value < Byte.MIN_VALUE || value > 0xFF) {
throw new NumberFormatException("For input string: \"" + str + '"');
}
return new Byte((byte)value);
}
}
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/IntConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/IntConver0000664 0001750 0001750 00000001716 12206661545 034443 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts an int primitive or java.lang.Integer wrapper to
* a String.
*
* @author Joe Walnes
*/
public class IntConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(int.class) || type.equals(Integer.class);
}
public Object fromString(String str) {
long value = Long.decode(str).longValue();
if(value < Integer.MIN_VALUE || value > 0xFFFFFFFFl) {
throw new NumberFormatException("For input string: \"" + str + '"');
}
return new Integer((int)value);
}
}
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/URIConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/URIConver0000664 0001750 0001750 00000001610 12206661545 034341 0 ustar jamespage jamespage /*
* Copyright (C) 2010 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 3. August 2010 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.basic;
import java.net.URI;
import java.net.URISyntaxException;
import com.thoughtworks.xstream.converters.ConversionException;
/**
* Converts a java.net.URI to a string.
*
* @author Carlos Roman
*/
public class URIConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(URI.class);
}
public Object fromString(String str) {
try {
return new URI(str);
} catch (URISyntaxException e) {
throw new ConversionException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000167 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/StringBuilderConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/StringBui0000664 0001750 0001750 00000001312 12206661545 034432 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 04. January 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts the contents of a StringBuilder to XML.
*
* @author Jörg Schaible
*/
public class StringBuilderConverter extends AbstractSingleValueConverter {
public Object fromString(String str) {
return new StringBuilder(str);
}
public boolean canConvert(Class type) {
return type.equals(StringBuilder.class);
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/NullConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/NullConve0000664 0001750 0001750 00000002645 12206661545 034443 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2012 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 03. October 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Special converter to signify nulls at the root level.
*
* @author Joe Walnes
*/
public class NullConverter implements Converter {
public boolean canConvert(Class type) {
return type == null || Mapper.Null.class.isAssignableFrom(type);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
ExtendedHierarchicalStreamWriterHelper.startNode(writer, "null", Mapper.Null.class);
writer.endNode();
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
return null;
}
}
././@LongLink 0000644 0000000 0000000 00000000160 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/DoubleConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/DoubleCon0000664 0001750 0001750 00000001422 12206661545 034400 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts a double primitive or java.lang.Double wrapper to
* a String.
*
* @author Joe Walnes
*/
public class DoubleConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(double.class) || type.equals(Double.class);
}
public Object fromString(String str) {
return Double.valueOf(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/BigDecimalConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/BigDecima0000664 0001750 0001750 00000001420 12206661545 034330 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import java.math.BigDecimal;
/**
* Converts a java.math.BigDecimal to a String, retaining
* its precision.
*
* @author Joe Walnes
*/
public class BigDecimalConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(BigDecimal.class);
}
public Object fromString(String str) {
return new BigDecimal(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/StringBufferConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/StringBuf0000664 0001750 0001750 00000001352 12206661545 034433 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts the contents of a StringBuffer to XML.
*
* @author Joe Walnes
*/
public class StringBufferConverter extends AbstractSingleValueConverter {
public Object fromString(String str) {
return new StringBuffer(str);
}
public boolean canConvert(Class type) {
return type.equals(StringBuffer.class);
}
}
././@LongLink 0000644 0000000 0000000 00000000160 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/StringConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/StringCon0000664 0001750 0001750 00000006400 12206661545 034435 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import java.util.Collections;
import java.util.Map;
import com.thoughtworks.xstream.core.util.WeakCache;
/**
* Converts a String to a String ;).
*
* Well ok, it doesn't actually do any conversion. The converter uses by default a map
* with weak references to reuse instances of strings that do not exceed a length limit. This
* limit is by default 38 characters to cache typical strings containing UUIDs. Only shorter
* strings are typically repeated more often in XML values.
*
*
* @author Joe Walnes
* @author Rene Schwietzke
* @author Jörg Schaible
*/
public class StringConverter extends AbstractSingleValueConverter {
private static final int LENGTH_LIMIT = 38;
/**
* A Map to store strings as long as needed to map similar strings onto the same instance
* and conserve memory. The map can be set from the outside during construction, so it can
* be a LRU map or a weak map, synchronised or not.
*/
private final Map cache;
private final int lengthLimit;
/**
* Construct a StringConverter using a map-based cache for strings not exceeding the length limit.
*
* @param map the map to use for the instances to reuse (may be null to not cache at all)
* @param lengthLimit maximum string length of a cached string, -1 to cache all, 0 to turn off the cache
* @since 1.4.2
*/
public StringConverter(final Map map, int lengthLimit) {
cache = map;
this.lengthLimit = lengthLimit;
}
/**
* Construct a StringConverter using a map-based cache for strings not exceeding 38 characters.
*
* @param map the map to use for the instances to reuse (may be null to not cache at all)
*/
public StringConverter(final Map map) {
this(map, LENGTH_LIMIT);
}
/**
* Construct a StringConverter using a cache with weak references for strings not exceeding the length limit.
*
* @param lengthLimit maximum string length of a cached string, -1 to cache all, 0 to turn off the cache
* @since 1.4.2
*/
public StringConverter(int lengthLimit) {
this(Collections.synchronizedMap(new WeakCache()), lengthLimit);
}
/**
* Construct a StringConverter using a cache with weak references for strings not exceeding 38 characters.
*/
public StringConverter() {
this(LENGTH_LIMIT);
}
public boolean canConvert(final Class type) {
return type.equals(String.class);
}
public Object fromString(final String str) {
if (cache != null && str != null && (lengthLimit < 0 || str.length() <= lengthLimit)) {
String s = (String)cache.get(str);
if (s == null) {
// fill cache
cache.put(str, str);
s = str;
}
return s;
} else {
return str;
}
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/package.html jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/package.h0000664 0001750 0001750 00000001333 12206661545 034350 0 ustar jamespage jamespage
Converters for common basic types in Java. These include
primitives (int, boolean, etc), wrapper objects (Integer, Boolean, etc),
String, StringBuffer, java.util.Date, null, java.net.URL,
java.math.BigInteger and java.math.BigDecimal.
These converters are enabled by default.
All of the basic converters will convert the item
into a single String, with no nested elements.
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/URLConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/URLConver0000664 0001750 0001750 00000001665 12206661545 034356 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 25. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import com.thoughtworks.xstream.converters.ConversionException;
import java.net.MalformedURLException;
import java.net.URL;
/**
* Converts a java.net.URL to a string.
*
* @author J. Matthew Pryor
*/
public class URLConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(URL.class);
}
public Object fromString(String str) {
try {
return new URL(str);
} catch (MalformedURLException e) {
throw new ConversionException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/ShortConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/ShortConv0000664 0001750 0001750 00000001711 12206661545 034454 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts a short primitive or java.lang.Short wrapper to
* a String.
*
* @author Joe Walnes
*/
public class ShortConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(short.class) || type.equals(Short.class);
}
public Object fromString(String str) {
int value = Integer.decode(str).intValue();
if(value < Short.MIN_VALUE || value > 0xFFFF) {
throw new NumberFormatException("For input string: \"" + str + '"');
}
return new Short((short)value);
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/DateConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/DateConve0000664 0001750 0001750 00000022053 12206661545 034401 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011, 2012, 2013 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.ErrorReporter;
import com.thoughtworks.xstream.converters.ErrorWriter;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Calendar;
import java.util.Date;
import java.util.List;
import java.util.Locale;
import java.util.TimeZone;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.core.util.ThreadSafeSimpleDateFormat;
/**
* Converts a java.util.Date to a String as a date format, retaining precision down to
* milliseconds.
*
*
The formatted string is by default in UTC and English locale. You can provide
* a different {@link Locale} and {@link TimeZone} that are used for serialization or
* null to use always the current TimeZone. Note, that the default format uses
* 3-letter time zones that can be ambiguous and may cause wrong results at deserialization and
* is localized since Java 6.
*
*
Dates in a different era are using a special default pattern that contains the era itself.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class DateConverter extends AbstractSingleValueConverter implements ErrorReporter {
private static final String[] DEFAULT_ACCEPTABLE_FORMATS;
private static final String DEFAULT_PATTERN;
private static final String DEFAULT_ERA_PATTERN;
private static final TimeZone UTC;
private static final long ERA_START;
static {
UTC = TimeZone.getTimeZone("UTC");
final String defaultPattern = "yyyy-MM-dd HH:mm:ss.S z";
final String defaultEraPattern = "yyyy-MM-dd G HH:mm:ss.S z";
final List acceptablePatterns = new ArrayList();
final boolean utcSupported = JVM.canParseUTCDateFormat();
DEFAULT_PATTERN = utcSupported ? defaultPattern : "yyyy-MM-dd HH:mm:ss.S 'UTC'";
DEFAULT_ERA_PATTERN = utcSupported ? defaultEraPattern : "yyyy-MM-dd G HH:mm:ss.S 'UTC'";
acceptablePatterns.add("yyyy-MM-dd HH:mm:ss.S z");
if (!utcSupported) {
acceptablePatterns.add(defaultPattern);
}
acceptablePatterns.add("yyyy-MM-dd HH:mm:ss.S a");
// JDK 1.3 needs both versions
acceptablePatterns.add("yyyy-MM-dd HH:mm:ssz");
acceptablePatterns.add("yyyy-MM-dd HH:mm:ss z");
if (!utcSupported) {
acceptablePatterns.add("yyyy-MM-dd HH:mm:ss 'UTC'");
}
// backwards compatibility
acceptablePatterns.add("yyyy-MM-dd HH:mm:ssa");
DEFAULT_ACCEPTABLE_FORMATS = (String[]) acceptablePatterns.toArray(new String[acceptablePatterns.size()]);
final Calendar cal = Calendar.getInstance();
cal.setTimeZone(UTC);
cal.clear();
cal.set(1, Calendar.JANUARY, 1);
ERA_START = cal.getTime().getTime(); // calendar.getTimeInMillis() not available under JDK 1.3
}
private final ThreadSafeSimpleDateFormat defaultFormat;
private final ThreadSafeSimpleDateFormat defaultEraFormat;
private final ThreadSafeSimpleDateFormat[] acceptableFormats;
private final Locale locale;
/**
* Construct a DateConverter with standard formats and lenient set off.
*/
public DateConverter() {
this(false);
}
/**
* Construct a DateConverter with standard formats, lenient set off and uses a given
* TimeZone for serialization.
*
* @param timeZone the TimeZone used to serialize the Date
* @since 1.4
*/
public DateConverter(TimeZone timeZone) {
this(DEFAULT_PATTERN, DEFAULT_ACCEPTABLE_FORMATS, timeZone);
}
/**
* Construct a DateConverter with standard formats and using UTC.
*
* @param lenient the lenient setting of {@link SimpleDateFormat#setLenient(boolean)}
* @since 1.3
*/
public DateConverter(boolean lenient) {
this(DEFAULT_PATTERN, DEFAULT_ACCEPTABLE_FORMATS, lenient);
}
/**
* Construct a DateConverter with lenient set off using UTC.
*
* @param defaultFormat the default format
* @param acceptableFormats fallback formats
*/
public DateConverter(String defaultFormat, String[] acceptableFormats) {
this(defaultFormat, acceptableFormats, false);
}
/**
* Construct a DateConverter with a given TimeZone and lenient set off.
*
* @param defaultFormat the default format
* @param acceptableFormats fallback formats
* @since 1.4
*/
public DateConverter(String defaultFormat, String[] acceptableFormats, TimeZone timeZone) {
this(defaultFormat, acceptableFormats, timeZone, false);
}
/**
* Construct a DateConverter.
*
* @param defaultFormat the default format
* @param acceptableFormats fallback formats
* @param lenient the lenient setting of {@link SimpleDateFormat#setLenient(boolean)}
* @since 1.3
*/
public DateConverter(String defaultFormat, String[] acceptableFormats, boolean lenient) {
this(defaultFormat, acceptableFormats, UTC, lenient);
}
/**
* Construct a DateConverter.
*
* @param defaultFormat the default format
* @param acceptableFormats fallback formats
* @param timeZone the TimeZone used to serialize the Date
* @param lenient the lenient setting of {@link SimpleDateFormat#setLenient(boolean)}
* @since 1.4
*/
public DateConverter(
String defaultFormat, String[] acceptableFormats, TimeZone timeZone, boolean lenient) {
this(DEFAULT_ERA_PATTERN, defaultFormat, acceptableFormats, Locale.ENGLISH, timeZone, lenient);
}
/**
* Construct a DateConverter.
*
* @param defaultEraFormat the default format for dates in a different era (may be
* null to drop era support)
* @param defaultFormat the default format
* @param acceptableFormats fallback formats
* @param locale locale to use for the format
* @param timeZone the TimeZone used to serialize the Date
* @param lenient the lenient setting of {@link SimpleDateFormat#setLenient(boolean)}
* @since 1.4.4
*/
public DateConverter(
String defaultEraFormat, String defaultFormat, String[] acceptableFormats,
Locale locale, TimeZone timeZone, boolean lenient) {
this.locale = locale;
if (defaultEraFormat != null) {
this.defaultEraFormat = new ThreadSafeSimpleDateFormat(
defaultEraFormat, timeZone, locale, 4, 20, lenient);
} else {
this.defaultEraFormat = null;
}
this.defaultFormat = new ThreadSafeSimpleDateFormat(
defaultFormat, timeZone, locale, 4, 20, lenient);
this.acceptableFormats = acceptableFormats != null
? new ThreadSafeSimpleDateFormat[acceptableFormats.length]
: new ThreadSafeSimpleDateFormat[0];
for (int i = 0; i < this.acceptableFormats.length; i++ ) {
this.acceptableFormats[i] = new ThreadSafeSimpleDateFormat(
acceptableFormats[i], timeZone, 1, 20, lenient);
}
}
public boolean canConvert(Class type) {
return type.equals(Date.class);
}
public Object fromString(String str) {
if (defaultEraFormat != null) {
try {
return defaultEraFormat.parse(str);
} catch (ParseException e) {
// try next ...
}
}
if (defaultEraFormat != defaultFormat) {
try {
return defaultFormat.parse(str);
} catch (ParseException e) {
// try next ...
}
}
for (int i = 0; i < acceptableFormats.length; i++ ) {
try {
return acceptableFormats[i].parse(str);
} catch (ParseException e3) {
// no worries, let's try the next format.
}
}
// no dateFormats left to try
throw new ConversionException("Cannot parse date " + str);
}
public String toString(Object obj) {
final Date date = (Date)obj;
if (date.getTime() < ERA_START && defaultEraFormat != null) {
return defaultEraFormat.format(date);
} else {
return defaultFormat.format(date);
}
}
public void appendErrors(ErrorWriter errorWriter) {
errorWriter.add("Default date pattern", defaultFormat.toString());
if (defaultEraFormat != null) {
errorWriter.add("Default era date pattern", defaultEraFormat.toString());
}
for (int i = 0; i < acceptableFormats.length; i++ ) {
errorWriter.add("Alternative date pattern", acceptableFormats[i].toString());
}
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/BigIntegerConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/BigIntege0000664 0001750 0001750 00000001364 12206661545 034370 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import java.math.BigInteger;
/**
* Converts a java.math.BigInteger to a String.
*
* @author Joe Walnes
*/
public class BigIntegerConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(BigInteger.class);
}
public Object fromString(String str) {
return new BigInteger(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000175 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/AbstractSingleValueConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/AbstractS0000664 0001750 0001750 00000002100 12206661545 034406 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 15. February 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.converters.basic;
import com.thoughtworks.xstream.converters.SingleValueConverter;
/**
* Base abstract implementation of {@link com.thoughtworks.xstream.converters.SingleValueConverter}.
*
*
Subclasses should implement methods canConvert(Class) and fromString(String) for the conversion.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Mauro Talevi
* @see com.thoughtworks.xstream.converters.SingleValueConverter
*/
public abstract class AbstractSingleValueConverter implements SingleValueConverter {
public abstract boolean canConvert(Class type);
public String toString(Object obj) {
return obj == null ? null : obj.toString();
}
public abstract Object fromString(String str);
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/CharConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/CharConve0000664 0001750 0001750 00000003714 12206661545 034404 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* Converts a char primitive or java.lang.Character wrapper to
* a String. If char is \0 the representing String is empty.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class CharConverter implements Converter, SingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(char.class) || type.equals(Character.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
writer.setValue(toString(source));
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
String nullAttribute = reader.getAttribute("null");
if (nullAttribute != null && nullAttribute.equals("true")) {
return new Character('\0');
} else {
return fromString(reader.getValue());
}
}
public Object fromString(String str) {
if (str.length() == 0) {
return new Character('\0');
} else {
return new Character(str.charAt(0));
}
}
public String toString(Object obj) {
char ch = ((Character)obj).charValue();
return ch == '\0' ? "" : obj.toString();
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/BooleanConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/basic/BooleanCo0000664 0001750 0001750 00000003672 12206661545 034400 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.basic;
/**
* Converts a boolean primitive or java.lang.Boolean wrapper to
* a String.
*
* @author Joe Walnes
* @author David Blevins
*/
public class BooleanConverter extends AbstractSingleValueConverter {
public static final BooleanConverter TRUE_FALSE = new BooleanConverter("true", "false", false);
public static final BooleanConverter YES_NO = new BooleanConverter("yes", "no", false);
public static final BooleanConverter BINARY = new BooleanConverter("1", "0", true);
private final String positive;
private final String negative;
private final boolean caseSensitive;
public BooleanConverter(final String positive, final String negative, final boolean caseSensitive) {
this.positive = positive;
this.negative = negative;
this.caseSensitive = caseSensitive;
}
public BooleanConverter() {
this("true", "false", false);
}
public boolean shouldConvert(final Class type, final Object value) {
return true;
}
public boolean canConvert(final Class type) {
return type.equals(boolean.class) || type.equals(Boolean.class);
}
public Object fromString(final String str) {
if (caseSensitive) {
return positive.equals(str) ? Boolean.TRUE : Boolean.FALSE;
} else {
return positive.equalsIgnoreCase(str) ? Boolean.TRUE : Boolean.FALSE;
}
}
public String toString(final Object obj) {
final Boolean value = (Boolean) obj;
return obj == null ? null : value.booleanValue() ? positive : negative;
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConverterLookup.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConverterLookup0000664 0001750 0001750 00000001526 12206661545 034613 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
/**
* Responsible for looking up the correct Converter implementation for a specific type.
*
* @author Joe Walnes
* @see Converter
*/
public interface ConverterLookup {
/**
* Lookup a converter for a specific type.
*
* This type may be any Class, including primitive and array types. It may also be null, signifying
* the value to be converted is a null type.
*/
Converter lookupConverterForType(Class type);
}
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/MarshallingContext.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/MarshallingCont0000664 0001750 0001750 00000001535 12206661545 034537 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 06. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
public interface MarshallingContext extends DataHolder {
/**
* Converts another object searching for the default converter
* @param nextItem the next item to convert
*/
void convertAnother(Object nextItem);
/**
* Converts another object using the specified converter
* @param nextItem the next item to convert
* @param converter the Converter to use
* @since 1.2
*/
void convertAnother(Object nextItem, Converter converter);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ 0000775 0001750 0001750 00000000000 12206661545 033655 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000200 12260544303 011631 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/PureJavaReflectionProvider.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Pure0000664 0001750 0001750 00000021105 12206661545 034512 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.annotations.XStreamSerializable;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectStreamClass;
import java.io.ObjectStreamConstants;
import java.io.Serializable;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Modifier;
import java.util.Iterator;
import java.util.Map;
import java.util.WeakHashMap;
/**
* Pure Java ObjectFactory that instantiates objects using standard Java reflection, however the types of objects
* that can be constructed are limited.
*
* Can newInstance: classes with public visibility, outer classes, static inner classes, classes with default constructors
* and any class that implements java.io.Serializable.
* Cannot newInstance: classes without public visibility, non-static inner classes, classes without default constructors.
* Note that any code in the constructor of a class will be executed when the ObjectFactory instantiates the object.
*
* @author Joe Walnes
*/
public class PureJavaReflectionProvider implements ReflectionProvider {
private transient Map serializedDataCache = new WeakHashMap();
protected FieldDictionary fieldDictionary;
public PureJavaReflectionProvider() {
this(new FieldDictionary(new ImmutableFieldKeySorter()));
}
public PureJavaReflectionProvider(FieldDictionary fieldDictionary) {
this.fieldDictionary = fieldDictionary;
}
public Object newInstance(Class type) {
try {
Constructor[] constructors = type.getDeclaredConstructors();
for (int i = 0; i < constructors.length; i++) {
final Constructor constructor = constructors[i];
if (constructor.getParameterTypes().length == 0) {
if (!constructor.isAccessible()) {
constructor.setAccessible(true);
}
return constructor.newInstance(new Object[0]);
}
}
if (Serializable.class.isAssignableFrom(type)) {
return instantiateUsingSerialization(type);
} else {
throw new ObjectAccessException("Cannot construct " + type.getName()
+ " as it does not have a no-args constructor");
}
} catch (InstantiationException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (InvocationTargetException e) {
if (e.getTargetException() instanceof RuntimeException) {
throw (RuntimeException)e.getTargetException();
} else if (e.getTargetException() instanceof Error) {
throw (Error)e.getTargetException();
} else {
throw new ObjectAccessException("Constructor for " + type.getName() + " threw an exception", e.getTargetException());
}
}
}
private Object instantiateUsingSerialization(final Class type) {
try {
synchronized (serializedDataCache) {
byte[] data = (byte[]) serializedDataCache.get(type);
if (data == null) {
ByteArrayOutputStream bytes = new ByteArrayOutputStream();
DataOutputStream stream = new DataOutputStream(bytes);
stream.writeShort(ObjectStreamConstants.STREAM_MAGIC);
stream.writeShort(ObjectStreamConstants.STREAM_VERSION);
stream.writeByte(ObjectStreamConstants.TC_OBJECT);
stream.writeByte(ObjectStreamConstants.TC_CLASSDESC);
stream.writeUTF(type.getName());
stream.writeLong(ObjectStreamClass.lookup(type).getSerialVersionUID());
stream.writeByte(2); // classDescFlags (2 = Serializable)
stream.writeShort(0); // field count
stream.writeByte(ObjectStreamConstants.TC_ENDBLOCKDATA);
stream.writeByte(ObjectStreamConstants.TC_NULL);
data = bytes.toByteArray();
serializedDataCache.put(type, data);
}
ObjectInputStream in = new ObjectInputStream(new ByteArrayInputStream(data)) {
protected Class resolveClass(ObjectStreamClass desc)
throws IOException, ClassNotFoundException {
return Class.forName(desc.getName(), false, type.getClassLoader());
}
};
return in.readObject();
}
} catch (IOException e) {
throw new ObjectAccessException("Cannot create " + type.getName() + " by JDK serialization", e);
} catch (ClassNotFoundException e) {
throw new ObjectAccessException("Cannot find class " + e.getMessage(), e);
}
}
public void visitSerializableFields(Object object, ReflectionProvider.Visitor visitor) {
for (Iterator iterator = fieldDictionary.fieldsFor(object.getClass()); iterator.hasNext();) {
Field field = (Field) iterator.next();
if (!fieldModifiersSupported(field)) {
continue;
}
validateFieldAccess(field);
try {
Object value = field.get(object);
visitor.visit(field.getName(), field.getType(), field.getDeclaringClass(), value);
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
}
}
}
public void writeField(Object object, String fieldName, Object value, Class definedIn) {
Field field = fieldDictionary.field(object.getClass(), fieldName, definedIn);
validateFieldAccess(field);
try {
field.set(object, value);
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not set field " + object.getClass() + "." + field.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not set field " + object.getClass() + "." + field.getName(), e);
}
}
public Class getFieldType(Object object, String fieldName, Class definedIn) {
return fieldDictionary.field(object.getClass(), fieldName, definedIn).getType();
}
public boolean fieldDefinedInClass(String fieldName, Class type) {
Field field = fieldDictionary.fieldOrNull(type, fieldName, null);
return field != null && (fieldModifiersSupported(field) || Modifier.isTransient(field.getModifiers()));
}
protected boolean fieldModifiersSupported(Field field) {
int modifiers = field.getModifiers();
return !(Modifier.isStatic(modifiers) || (Modifier.isTransient(modifiers) && field.getAnnotation(XStreamSerializable.class)==null));
}
protected void validateFieldAccess(Field field) {
if (Modifier.isFinal(field.getModifiers())) {
if (JVM.is15()) {
field.setAccessible(true);
} else {
throw new ObjectAccessException("Invalid final field "
+ field.getDeclaringClass().getName() + "." + field.getName());
}
}
}
public Field getField(Class definedIn, String fieldName) {
return fieldDictionary.field(definedIn, fieldName, null);
}
public Field getFieldOrNull(Class definedIn, String fieldName) {
return fieldDictionary.fieldOrNull(definedIn, fieldName, null);
}
public void setFieldDictionary(FieldDictionary dictionary) {
this.fieldDictionary = dictionary;
}
protected Object readResolve() {
serializedDataCache = new WeakHashMap();
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000175 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Sun14ReflectionProvider.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Sun10000664 0001750 0001750 00000015112 12206661545 034426 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import sun.misc.Unsafe;
import sun.reflect.ReflectionFactory;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.util.HashMap;
import java.util.Map;
import java.util.WeakHashMap;
import java.util.concurrent.ConcurrentHashMap;
/**
* Instantiates a new object on the Sun JVM by bypassing the constructor (meaning code in the constructor
* will never be executed and parameters do not have to be known). This is the same method used by the internals of
* standard Java serialization, but relies on internal Sun code that may not be present on all JVMs.
*
* @author Joe Walnes
* @author Brian Slesinsky
*/
public class Sun14ReflectionProvider extends PureJavaReflectionProvider {
private final static Unsafe unsafe;
private final static Exception exception;
// references to the Field key are kept in the FieldDictionary
private transient Map fieldOffsetCache = new WeakHashMap();
static {
Unsafe u = null;
Exception ex = null;
try {
Class objectStreamClass = Class.forName("sun.misc.Unsafe");
Field unsafeField = objectStreamClass.getDeclaredField("theUnsafe");
unsafeField.setAccessible(true);
u = (Unsafe) unsafeField.get(null);
} catch (ClassNotFoundException e) {
ex = e;
} catch (SecurityException e) {
ex = e;
} catch (NoSuchFieldException e) {
ex = e;
} catch (IllegalArgumentException e) {
ex = e;
} catch (IllegalAccessException e) {
ex = e;
}
exception = ex;
unsafe = u;
}
private transient ReflectionFactory reflectionFactory = ReflectionFactory.getReflectionFactory();
private transient Map constructorCache =new ConcurrentHashMap();
public Sun14ReflectionProvider() {
super();
}
public Sun14ReflectionProvider(FieldDictionary dic) {
super(dic);
}
public Object newInstance(Class type) {
try {
Constructor customConstructor = getMungedConstructor(type);
return customConstructor.newInstance(new Object[0]);
} catch (NoSuchMethodException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (SecurityException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (InstantiationException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException("Cannot construct " + type.getName(), e);
}
}
private Constructor getMungedConstructor(Class type) throws NoSuchMethodException {
synchronized (constructorCache) {
Constructor ctor = (Constructor)constructorCache.get(type);
if (ctor == null) {
ctor = reflectionFactory.newConstructorForSerialization(type, Object.class.getDeclaredConstructor(new Class[0]));
constructorCache.put(type, ctor);
}
return ctor;
}
}
public void writeField(Object object, String fieldName, Object value, Class definedIn) {
write(fieldDictionary.field(object.getClass(), fieldName, definedIn), object, value);
}
private void write(Field field, Object object, Object value) {
if (exception != null) {
throw new ObjectAccessException("Could not set field " + object.getClass() + "." + field.getName(), exception);
}
try {
long offset = getFieldOffset(field);
Class type = field.getType();
if (type.isPrimitive()) {
if (type.equals(Integer.TYPE)) {
unsafe.putInt(object, offset, ((Integer) value).intValue());
} else if (type.equals(Long.TYPE)) {
unsafe.putLong(object, offset, ((Long) value).longValue());
} else if (type.equals(Short.TYPE)) {
unsafe.putShort(object, offset, ((Short) value).shortValue());
} else if (type.equals(Character.TYPE)) {
unsafe.putChar(object, offset, ((Character) value).charValue());
} else if (type.equals(Byte.TYPE)) {
unsafe.putByte(object, offset, ((Byte) value).byteValue());
} else if (type.equals(Float.TYPE)) {
unsafe.putFloat(object, offset, ((Float) value).floatValue());
} else if (type.equals(Double.TYPE)) {
unsafe.putDouble(object, offset, ((Double) value).doubleValue());
} else if (type.equals(Boolean.TYPE)) {
unsafe.putBoolean(object, offset, ((Boolean) value).booleanValue());
} else {
throw new ObjectAccessException("Could not set field " +
object.getClass() + "." + field.getName() +
": Unknown type " + type);
}
} else {
unsafe.putObject(object, offset, value);
}
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not set field " + object.getClass() + "." + field.getName(), e);
}
}
private synchronized long getFieldOffset(Field f)
{
Long l = (Long)fieldOffsetCache.get(f);
if (l == null)
{
l = new Long(unsafe.objectFieldOffset(f));
fieldOffsetCache.put(f, l);
}
return l.longValue();
}
protected void validateFieldAccess(Field field) {
// (overriden) don't mind final fields.
}
protected Object readResolve() {
super.readResolve();
constructorCache = new HashMap();
reflectionFactory = ReflectionFactory.getReflectionFactory();
fieldOffsetCache = new WeakHashMap();
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000173 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/MissingFieldException.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Miss0000664 0001750 0001750 00000002673 12206661545 034523 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 01. October 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
/**
* Indicates a missing field or property creating an object.
*
* @author Nikita Levyankov
* @author Joerg Schaible
* @since 1.4.2
*/
public class MissingFieldException extends ObjectAccessException {
private final String fieldName;
private final String className;
/**
* Construct a MissingFieldException.
* @param className the name of the class missing the field
* @param fieldName the name of the missed field
* @since 1.4.2
*/
public MissingFieldException(final String className, final String fieldName) {
super("No field '" + fieldName + "' found in class '" + className + "'");
this.className = className;
this.fieldName = fieldName;
}
/**
* Retrieve the name of the missing field.
* @return the field name
* @since 1.4.2
*/
public String getFieldName() {
return fieldName;
}
/**
* Retrieve the name of the class with the missing field.
* @return the class name
* @since 1.4.2
*/
protected String getClassName() {
return className;
}
}
././@LongLink 0000644 0000000 0000000 00000000172 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/NativeFieldKeySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Nati0000664 0001750 0001750 00000002406 12206661545 034475 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 17.05.2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import java.util.Comparator;
import java.util.Map;
import java.util.TreeMap;
/**
* Sort the fields in their natural order. Fields are returned in their declaration order,
* fields of base classes first.
*
* @author Jörg Schaible
* @since 1.2.2
*/
public class NativeFieldKeySorter implements FieldKeySorter {
public Map sort(final Class type, final Map keyedByFieldKey) {
final Map map = new TreeMap(new Comparator() {
public int compare(final Object o1, final Object o2) {
final FieldKey fieldKey1 = (FieldKey)o1;
final FieldKey fieldKey2 = (FieldKey)o2;
int i = fieldKey1.getDepth() - fieldKey2.getDepth();
if (i == 0) {
i = fieldKey1.getOrder() - fieldKey2.getOrder();
}
return i;
}
});
map.putAll(keyedByFieldKey);
return map;
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/FieldKey.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Fiel0000664 0001750 0001750 00000004331 12206661545 034460 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 10. April 2007 by Guilherme Silveira
*/
package com.thoughtworks.xstream.converters.reflection;
/**
* A field key.
*
* @author Guilherme Silveira
* @author Jörg Schaible
*/
public class FieldKey {
final private String fieldName;
final private Class declaringClass;
final private int depth;
final private int order;
public FieldKey(String fieldName, Class declaringClass, int order) {
if (fieldName == null || declaringClass == null) {
throw new IllegalArgumentException("fieldName or declaringClass is null");
}
this.fieldName = fieldName;
this.declaringClass = declaringClass;
this.order = order;
Class c = declaringClass;
int i = 0;
while (c.getSuperclass() != null) {
i++;
c = c.getSuperclass();
}
depth = i;
}
public String getFieldName() {
return this.fieldName;
}
public Class getDeclaringClass() {
return this.declaringClass;
}
public int getDepth() {
return this.depth;
}
public int getOrder() {
return this.order;
}
public boolean equals(Object o) {
if (this == o) return true;
if (!(o instanceof FieldKey)) return false;
final FieldKey fieldKey = (FieldKey)o;
if (!declaringClass.equals(fieldKey.declaringClass))
return false;
if (!fieldName.equals(fieldKey.fieldName))
return false;
return true;
}
public int hashCode() {
int result;
result = fieldName.hashCode();
result = 29 * result +declaringClass.hashCode();
return result;
}
public String toString() {
return "FieldKey{"
+ "order="
+ order
+ ", writer="
+ depth
+ ", declaringClass="
+ declaringClass
+ ", fieldName='"
+ fieldName
+ "'"
+ "}";
}
} ././@LongLink 0000644 0000000 0000000 00000000174 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/SortableFieldKeySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Sort0000664 0001750 0001750 00000006235 12206661545 034535 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2009, 2011 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 10. April 2007 by Guilherme Silveira
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.core.Caching;
import com.thoughtworks.xstream.core.util.OrderRetainingMap;
import com.thoughtworks.xstream.io.StreamException;
import java.util.Arrays;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Map;
/**
* The default implementation for sorting fields. Invoke registerFieldOrder in order to set the
* field order for an specific type.
*
* @author Guilherme Silveira
* @since 1.2.2
*/
public class SortableFieldKeySorter implements FieldKeySorter, Caching {
private final Map map = new HashMap();
public Map sort(Class type, Map keyedByFieldKey) {
if (map.containsKey(type)) {
Map result = new OrderRetainingMap();
FieldKey[] fieldKeys = (FieldKey[])keyedByFieldKey.keySet().toArray(
new FieldKey[keyedByFieldKey.size()]);
Arrays.sort(fieldKeys, (Comparator)map.get(type));
for (int i = 0; i < fieldKeys.length; i++ ) {
result.put(fieldKeys[i], keyedByFieldKey.get(fieldKeys[i]));
}
return result;
} else {
return keyedByFieldKey;
}
}
/**
* Registers the field order to use for a specific type. This will not affect any of the
* type's super or sub classes. If you skip a field which will be serialized, XStream will
* thrown an StreamException during the serialization process.
*
* @param type the type
* @param fields the field order
*/
public void registerFieldOrder(Class type, String[] fields) {
map.put(type, new FieldComparator(fields));
}
private class FieldComparator implements Comparator {
private final String[] fieldOrder;
public FieldComparator(String[] fields) {
this.fieldOrder = fields;
}
public int compare(String first, String second) {
int firstPosition = -1, secondPosition = -1;
for (int i = 0; i < fieldOrder.length; i++ ) {
if (fieldOrder[i].equals(first)) {
firstPosition = i;
}
if (fieldOrder[i].equals(second)) {
secondPosition = i;
}
}
if (firstPosition == -1 || secondPosition == -1) {
// field not defined!!!
throw new StreamException(
"You have not given XStream a list of all fields to be serialized.");
}
return firstPosition - secondPosition;
}
public int compare(Object firstObject, Object secondObject) {
FieldKey first = (FieldKey)firstObject, second = (FieldKey)secondObject;
return compare(first.getFieldName(), second.getFieldName());
}
}
public void flushCache() {
map.clear();
}
}
././@LongLink 0000644 0000000 0000000 00000000201 12260544303 011632 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/AbstractReflectionConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Abst0000664 0001750 0001750 00000067064 12206661545 034506 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012 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 02. March 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.Caching;
import com.thoughtworks.xstream.core.ReferencingMarshallingContext;
import com.thoughtworks.xstream.core.util.ArrayIterator;
import com.thoughtworks.xstream.core.util.FastField;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.core.util.Primitives;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.CannotResolveClassException;
import com.thoughtworks.xstream.mapper.Mapper;
import java.lang.reflect.Array;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.AbstractList;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;
public abstract class AbstractReflectionConverter implements Converter, Caching {
protected final ReflectionProvider reflectionProvider;
protected final Mapper mapper;
protected transient SerializationMethodInvoker serializationMethodInvoker;
private transient ReflectionProvider pureJavaReflectionProvider;
public AbstractReflectionConverter(Mapper mapper, ReflectionProvider reflectionProvider) {
this.mapper = mapper;
this.reflectionProvider = reflectionProvider;
serializationMethodInvoker = new SerializationMethodInvoker();
}
public void marshal(Object original, final HierarchicalStreamWriter writer,
final MarshallingContext context) {
final Object source = serializationMethodInvoker.callWriteReplace(original);
if (source != original && context instanceof ReferencingMarshallingContext) {
((ReferencingMarshallingContext)context).replace(original, source);
}
if (source.getClass() != original.getClass()) {
String attributeName = mapper.aliasForSystemAttribute("resolves-to");
if (attributeName != null) {
writer.addAttribute(attributeName, mapper.serializedClass(source.getClass()));
}
context.convertAnother(source);
} else {
doMarshal(source, writer, context);
}
}
protected void doMarshal(final Object source, final HierarchicalStreamWriter writer, final MarshallingContext context) {
final List fields = new ArrayList();
final Map defaultFieldDefinition = new HashMap();
// Attributes might be preferred to child elements ...
reflectionProvider.visitSerializableFields(source, new ReflectionProvider.Visitor() {
final Set writtenAttributes = new HashSet();
public void visit(String fieldName, Class type, Class definedIn, Object value) {
if (!mapper.shouldSerializeMember(definedIn, fieldName)) {
return;
}
if (!defaultFieldDefinition.containsKey(fieldName)) {
Class lookupType = source.getClass();
// See XSTR-457 and OmitFieldsTest
// if (definedIn != source.getClass() && !mapper.shouldSerializeMember(lookupType, fieldName)) {
// lookupType = definedIn;
// }
defaultFieldDefinition.put(fieldName, reflectionProvider.getField(lookupType, fieldName));
}
SingleValueConverter converter = mapper.getConverterFromItemType(fieldName, type, definedIn);
if (converter != null) {
final String attribute = mapper.aliasForAttribute(mapper.serializedMember(definedIn, fieldName));
if (value != null) {
if (writtenAttributes.contains(fieldName)) { // TODO: use attribute
throw new ConversionException("Cannot write field with name '" + fieldName
+ "' twice as attribute for object of type " + source.getClass().getName());
}
final String str = converter.toString(value);
if (str != null) {
writer.addAttribute(attribute, str);
}
}
writtenAttributes.add(fieldName); // TODO: use attribute
} else {
fields.add(new FieldInfo(fieldName, type, definedIn, value));
}
}
});
new Object() {
{
for (Iterator fieldIter = fields.iterator(); fieldIter.hasNext();) {
FieldInfo info = (FieldInfo)fieldIter.next();
if (info.value != null) {
Mapper.ImplicitCollectionMapping mapping = mapper
.getImplicitCollectionDefForFieldName(
source.getClass(), info.fieldName);
if (mapping != null) {
if (context instanceof ReferencingMarshallingContext) {
if (info.value != Collections.EMPTY_LIST
&& info.value != Collections.EMPTY_SET
&& info.value != Collections.EMPTY_MAP) {
ReferencingMarshallingContext refContext = (ReferencingMarshallingContext)context;
refContext.registerImplicit(info.value);
}
}
final boolean isCollection = info.value instanceof Collection;
final boolean isMap = info.value instanceof Map;
final boolean isEntry = isMap && mapping.getKeyFieldName() == null;
final boolean isArray = info.value.getClass().isArray();
for (Iterator iter = isArray
? new ArrayIterator(info.value)
: isCollection
? ((Collection)info.value).iterator()
: isEntry
? ((Map)info.value).entrySet().iterator()
: ((Map)info.value).values().iterator(); iter.hasNext();) {
Object obj = iter.next();
final String itemName;
final Class itemType;
if (obj == null) {
itemType = Object.class;
itemName = mapper.serializedClass(null);
} else if (isEntry) {
final String entryName = mapping.getItemFieldName() != null
? mapping.getItemFieldName()
: mapper.serializedClass(Map.Entry.class);
Map.Entry entry = (Map.Entry) obj;
ExtendedHierarchicalStreamWriterHelper.startNode(writer, entryName, entry.getClass());
writeItem(entry.getKey(), context, writer);
writeItem(entry.getValue(), context, writer);
writer.endNode();
continue;
} else if (mapping.getItemFieldName() != null) {
itemType = mapping.getItemType();
itemName = mapping.getItemFieldName();
} else {
itemType = obj.getClass();
itemName = mapper.serializedClass(itemType);
}
writeField(
info.fieldName, itemName, itemType, info.definedIn, obj);
}
} else {
writeField(
info.fieldName, null, info.type, info.definedIn, info.value);
}
}
}
}
void writeField(String fieldName, String aliasName, Class fieldType,
Class definedIn, Object newObj) {
Class actualType = newObj != null ? newObj.getClass() : fieldType;
ExtendedHierarchicalStreamWriterHelper.startNode(writer, aliasName != null
? aliasName
: mapper.serializedMember(source.getClass(), fieldName), actualType);
if (newObj != null) {
Class defaultType = mapper.defaultImplementationOf(fieldType);
if (!actualType.equals(defaultType)) {
String serializedClassName = mapper.serializedClass(actualType);
if (!serializedClassName.equals(mapper.serializedClass(defaultType))) {
String attributeName = mapper.aliasForSystemAttribute("class");
if (attributeName != null) {
writer.addAttribute(attributeName, serializedClassName);
}
}
}
final Field defaultField = (Field)defaultFieldDefinition.get(fieldName);
if (defaultField.getDeclaringClass() != definedIn) {
String attributeName = mapper.aliasForSystemAttribute("defined-in");
if (attributeName != null) {
writer.addAttribute(
attributeName, mapper.serializedClass(definedIn));
}
}
Field field = reflectionProvider.getField(definedIn, fieldName);
marshallField(context, newObj, field);
}
writer.endNode();
}
void writeItem(Object item, MarshallingContext context, HierarchicalStreamWriter writer) {
if (item == null) {
String name = mapper.serializedClass(null);
ExtendedHierarchicalStreamWriterHelper.startNode(writer, name, Mapper.Null.class);
writer.endNode();
} else {
String name = mapper.serializedClass(item.getClass());
ExtendedHierarchicalStreamWriterHelper.startNode(writer, name, item.getClass());
context.convertAnother(item);
writer.endNode();
}
}
};
}
protected void marshallField(final MarshallingContext context, Object newObj, Field field) {
context.convertAnother(newObj, mapper.getLocalConverter(field.getDeclaringClass(), field.getName()));
}
public Object unmarshal(final HierarchicalStreamReader reader, final UnmarshallingContext context) {
Object result = instantiateNewInstance(reader, context);
result = doUnmarshal(result, reader, context);
return serializationMethodInvoker.callReadResolve(result);
}
public Object doUnmarshal(final Object result, final HierarchicalStreamReader reader, final UnmarshallingContext context) {
final Set seenFields = new HashSet() {
public boolean add(Object e) {
if (!super.add(e)) {
throw new DuplicateFieldException(((FastField)e).getName());
}
return true;
}
};
Iterator it = reader.getAttributeNames();
// Process attributes before recursing into child elements.
while (it.hasNext()) {
String attrAlias = (String) it.next();
// TODO: realMember should return FastField
String attrName = mapper.realMember(result.getClass(), mapper.attributeForAlias(attrAlias));
boolean fieldExistsInClass = reflectionProvider.fieldDefinedInClass(attrName, result.getClass());
if (fieldExistsInClass) {
Field field = reflectionProvider.getField(result.getClass(), attrName);
if (Modifier.isTransient(field.getModifiers()) && !shouldUnmarshalTransientFields()) {
continue;
}
Class classDefiningField = field.getDeclaringClass();
if (!mapper.shouldSerializeMember(classDefiningField, attrName)) {
continue;
}
SingleValueConverter converter = mapper.getConverterFromAttribute(classDefiningField, attrName, field.getType());
Class type = field.getType();
if (converter != null) {
Object value = converter.fromString(reader.getAttribute(attrAlias));
if (type.isPrimitive()) {
type = Primitives.box(type);
}
if (value != null && !type.isAssignableFrom(value.getClass())) {
throw new ConversionException("Cannot convert type " + value.getClass().getName() + " to type " + type.getName());
}
seenFields.add(new FastField(classDefiningField, attrName));
reflectionProvider.writeField(result, attrName, value, classDefiningField);
}
}
}
Map implicitCollectionsForCurrentObject = null;
while (reader.hasMoreChildren()) {
reader.moveDown();
String originalNodeName = reader.getNodeName();
Class classDefiningField = determineWhichClassDefinesField(reader);
Class fieldDeclaringClass = classDefiningField == null
? result.getClass()
: classDefiningField;
String fieldName = mapper.realMember(fieldDeclaringClass, originalNodeName);
Mapper.ImplicitCollectionMapping implicitCollectionMapping = mapper
.getImplicitCollectionDefForFieldName(fieldDeclaringClass, fieldName);
boolean fieldExistsInClass = implicitCollectionMapping == null
&& reflectionProvider.fieldDefinedInClass(fieldName, fieldDeclaringClass);
Class type = implicitCollectionMapping == null || implicitCollectionMapping.getItemType() == null
? determineType(
reader, fieldExistsInClass, result, fieldName, classDefiningField)
: implicitCollectionMapping.getItemType();
final Object value;
if (fieldExistsInClass) {
Field field = reflectionProvider.getField(classDefiningField != null ? classDefiningField : result.getClass(), fieldName);
if ((Modifier.isTransient(field.getModifiers()) && !shouldUnmarshalTransientFields())
|| !mapper.shouldSerializeMember(field.getDeclaringClass(), fieldName)) {
reader.moveUp();
continue;
}
value = unmarshallField(context, result, type, field);
// TODO the reflection provider should have returned the proper field in first place ....
Class definedType = reflectionProvider.getFieldType(result, fieldName, classDefiningField);
if (!definedType.isPrimitive()) {
type = definedType;
}
} else {
if (Map.Entry.class.equals(type)) {
reader.moveDown();
final Object key = context.convertAnother(result, HierarchicalStreams.readClassType(reader, mapper));
reader.moveUp();
reader.moveDown();
final Object v = context.convertAnother(result, HierarchicalStreams.readClassType(reader, mapper));
reader.moveUp();
value = Collections.singletonMap(key, v).entrySet().iterator().next();
} else {
value = type != null ? context.convertAnother(result, type) : null;
}
}
if (value != null && !type.isAssignableFrom(value.getClass())) {
throw new ConversionException("Cannot convert type " + value.getClass().getName() + " to type " + type.getName());
}
if (fieldExistsInClass) {
reflectionProvider.writeField(result, fieldName, value, classDefiningField);
seenFields.add(new FastField(classDefiningField, fieldName));
} else if (type != null) {
implicitCollectionsForCurrentObject = writeValueToImplicitCollection(context, value, implicitCollectionsForCurrentObject, result, originalNodeName);
}
reader.moveUp();
}
if (implicitCollectionsForCurrentObject != null) {
for(Iterator iter = implicitCollectionsForCurrentObject.entrySet().iterator(); iter.hasNext();) {
Map.Entry entry = (Map.Entry)iter.next();
Object value = entry.getValue();
if (value instanceof ArraysList) {
Object array = ((ArraysList)value).toPhysicalArray();
reflectionProvider.writeField(result, (String)entry.getKey(), array, null);
}
}
}
return result;
}
protected Object unmarshallField(final UnmarshallingContext context, final Object result, Class type, Field field) {
return context.convertAnother(result, type, mapper.getLocalConverter(field.getDeclaringClass(), field.getName()));
}
protected boolean shouldUnmarshalTransientFields() {
return false;
}
private Map writeValueToImplicitCollection(UnmarshallingContext context, Object value,
Map implicitCollections, Object result, String itemFieldName) {
String fieldName = mapper.getFieldNameForItemTypeAndName(
context.getRequiredType(), value != null ? value.getClass() : Mapper.Null.class,
itemFieldName);
if (fieldName != null) {
if (implicitCollections == null) {
implicitCollections = new HashMap(); // lazy instantiation
}
Collection collection = (Collection)implicitCollections.get(fieldName);
if (collection == null) {
Class physicalFieldType = reflectionProvider.getFieldType(result, fieldName, null);
if (physicalFieldType.isArray()) {
collection = new ArraysList(physicalFieldType);
} else {
Class fieldType = mapper.defaultImplementationOf(physicalFieldType);
if (!(Collection.class.isAssignableFrom(fieldType) || Map.class.isAssignableFrom(fieldType))) {
throw new ObjectAccessException("Field "
+ fieldName
+ " of "
+ result.getClass().getName()
+ " is configured for an implicit Collection or Map, but field is of type "
+ fieldType.getName());
}
if (pureJavaReflectionProvider == null) {
pureJavaReflectionProvider = new PureJavaReflectionProvider();
}
Object instance = pureJavaReflectionProvider.newInstance(fieldType);
if (instance instanceof Collection) {
collection = (Collection)instance;
} else {
Mapper.ImplicitCollectionMapping implicitCollectionMapping = mapper
.getImplicitCollectionDefForFieldName(result.getClass(), fieldName);
collection = new MappingList((Map)instance, implicitCollectionMapping.getKeyFieldName());
}
reflectionProvider.writeField(result, fieldName, instance, null);
}
implicitCollections.put(fieldName, collection);
}
collection.add(value);
} else {
throw new ConversionException("Element "
+ itemFieldName
+ " of type "
+ value.getClass().getName()
+ " is not defined as field in type "
+ result.getClass().getName());
}
return implicitCollections;
}
private Class determineWhichClassDefinesField(HierarchicalStreamReader reader) {
String attributeName = mapper.aliasForSystemAttribute("defined-in");
String definedIn = attributeName == null ? null : reader.getAttribute(attributeName);
return definedIn == null ? null : mapper.realClass(definedIn);
}
protected Object instantiateNewInstance(HierarchicalStreamReader reader, UnmarshallingContext context) {
String attributeName = mapper.aliasForSystemAttribute("resolves-to");
String readResolveValue = attributeName == null ? null : reader.getAttribute(attributeName);
Object currentObject = context.currentObject();
if (currentObject != null) {
return currentObject;
} else if (readResolveValue != null) {
return reflectionProvider.newInstance(mapper.realClass(readResolveValue));
} else {
return reflectionProvider.newInstance(context.getRequiredType());
}
}
private Class determineType(HierarchicalStreamReader reader, boolean validField, Object result, String fieldName, Class definedInCls) {
String classAttribute = HierarchicalStreams.readClassAttribute(reader, mapper);
if (!validField) {
Class itemType = mapper.getItemTypeForItemFieldName(result.getClass(), fieldName);
if (itemType != null) {
if (classAttribute != null) {
return mapper.realClass(classAttribute);
}
return itemType;
} else {
String originalNodeName = reader.getNodeName();
if (definedInCls == null) {
for(definedInCls = result.getClass(); definedInCls != null; definedInCls = definedInCls.getSuperclass()) {
if (!mapper.shouldSerializeMember(definedInCls, originalNodeName)) {
return null;
}
}
}
try {
return mapper.realClass(originalNodeName);
} catch (CannotResolveClassException e) {
throw new UnknownFieldException(result.getClass().getName(), fieldName);
}
}
} else {
if (classAttribute != null) {
return mapper.realClass(classAttribute);
}
return mapper.defaultImplementationOf(reflectionProvider.getFieldType(result, fieldName, definedInCls));
}
}
public void flushCache() {
serializationMethodInvoker.flushCache();
}
private Object readResolve() {
serializationMethodInvoker = new SerializationMethodInvoker();
return this;
}
public static class DuplicateFieldException extends ConversionException {
public DuplicateFieldException(String msg) {
super("Duplicate field " + msg);
add("field", msg);
}
}
public static class UnknownFieldException extends ConversionException {
public UnknownFieldException(String type, String field) {
super("No such field " + type + "." + field);
add("field", field);
}
}
private static class FieldInfo {
final String fieldName;
final Class type;
final Class definedIn;
final Object value;
FieldInfo(String fieldName, Class type, Class definedIn, Object value) {
this.fieldName = fieldName;
this.type = type;
this.definedIn = definedIn;
this.value = value;
}
}
private static class ArraysList extends ArrayList {
final Class physicalFieldType;
ArraysList(Class physicalFieldType) {
this.physicalFieldType = physicalFieldType;
}
Object toPhysicalArray() {
Object[] objects = toArray();
Object array = Array.newInstance(physicalFieldType.getComponentType(), objects.length);
if (physicalFieldType.getComponentType().isPrimitive()) {
for (int i = 0; i < objects.length; ++i) {
Array.set(array, i, Array.get(objects, i));
}
} else {
System.arraycopy(objects, 0, array, 0, objects.length);
}
return array;
}
}
private class MappingList extends AbstractList {
private final Map map;
private final String keyFieldName;
private final Map fieldCache = new HashMap();
public MappingList(Map map, String keyFieldName) {
this.map = map;
this.keyFieldName = keyFieldName;
}
public boolean add(Object object) {
if (object == null) {
boolean containsNull = !map.containsKey(null);
map.put(null, null);
return containsNull;
}
Class itemType = object.getClass();
if (keyFieldName != null) {
Field field = (Field)fieldCache.get(itemType);
if (field == null) {
field = reflectionProvider.getField(itemType, keyFieldName);
fieldCache.put(itemType, field);
}
if (field != null) {
try {
Object key = field.get(object);
return map.put(key, object) == null;
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
}
}
} else if (object instanceof Map.Entry) {
final Map.Entry entry = (Map.Entry)object;
return map.put(entry.getKey(), entry.getValue()) == null;
}
throw new ConversionException("Element of type "
+ object.getClass().getName()
+ " is not defined as entry for map of type "
+ map.getClass().getName());
}
public Object get(int index) {
throw new UnsupportedOperationException();
}
public int size() {
return map.size();
}
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/FieldKeySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Fiel0000664 0001750 0001750 00000002632 12206661545 034462 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 10. April 2007 by Guilherme Silveira
*/
package com.thoughtworks.xstream.converters.reflection;
import java.util.Map;
/**
* An interface capable of sorting fields. Implement this interface if you want to customize the
* field order in which XStream serializes objects.
*
* @author Guilherme Silveira
* @since 1.2.2
*/
public interface FieldKeySorter {
/**
* Sort the fields of a type. The method will be called with the class type that contains
* all the fields and a Map that retains the order in which the elements have been added.
* The sequence in which elements are returned by an iterator defines the processing order
* of the fields. An implementation may create a different Map with similar semantic, add
* all elements of the original map and return the new one.
*
* @param type the class that contains all the fields
* @param keyedByFieldKey a Map containing a {@link FieldKey} as key element and a
* {@link java.lang.reflect.Field} as value.
* @return a Map with all the entries of the original Map
* @since 1.2.2
*/
Map sort(Class type, Map keyedByFieldKey);
}
././@LongLink 0000644 0000000 0000000 00000000233 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/AbstractAttributedCharacterIteratorAttributeConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Abst0000664 0001750 0001750 00000006401 12206661545 034472 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 01. February 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.text.AttributedCharacterIterator;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
/**
* An abstract converter implementation for constants of
* {@link AttributedCharacterIterator.Attribute} and derived types.
*
* @author Jörg Schaible
* @since 1.2.2
*/
public class AbstractAttributedCharacterIteratorAttributeConverter extends
AbstractSingleValueConverter {
private static final Method getName;
static {
try {
getName = AttributedCharacterIterator.Attribute.class.getDeclaredMethod(
"getName", (Class[])null);
} catch (NoSuchMethodException e) {
throw new ExceptionInInitializerError("Missing AttributedCharacterIterator.Attribute.getName()");
}
}
private final Class type;
private transient Map attributeMap;
private transient FieldDictionary fieldDictionary;
public AbstractAttributedCharacterIteratorAttributeConverter(final Class type) {
super();
this.type = type;
readResolve();
}
public boolean canConvert(final Class type) {
return type == this.type;
}
public String toString(final Object source) {
AttributedCharacterIterator.Attribute attribute = (AttributedCharacterIterator.Attribute)source;
try {
if (!getName.isAccessible()) {
getName.setAccessible(true);
}
return (String)getName.invoke(attribute, (Object[])null);
} catch (IllegalAccessException e) {
throw new ObjectAccessException(
"Cannot get name of AttributedCharacterIterator.Attribute", e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException(
"Cannot get name of AttributedCharacterIterator.Attribute", e
.getTargetException());
}
}
public Object fromString(final String str) {
return attributeMap.get(str);
}
private Object readResolve() {
fieldDictionary = new FieldDictionary();
attributeMap = new HashMap();
for (final Iterator iterator = fieldDictionary.fieldsFor(type); iterator
.hasNext();) {
final Field field = (Field)iterator.next();
if (field.getType() == type && Modifier.isStatic(field.getModifiers())) {
try {
final Object attribute = field.get(null);
attributeMap.put(toString(attribute), attribute);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Cannot get object of " + field, e);
}
}
}
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000202 12260544303 011633 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/SelfStreamingInstanceChecker.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Self0000664 0001750 0001750 00000003465 12206661545 034501 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 03. April 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* A special converter that prevents self-serialization. The serializing XStream instance
* adds a converter of this type to prevent self-serialization and will throw an
* exception instead.
*
* @author Jörg Schaible
* @since 1.2
*/
public class SelfStreamingInstanceChecker implements Converter {
private final Object self;
private Converter defaultConverter;
public SelfStreamingInstanceChecker(Converter defaultConverter, Object xstream) {
this.defaultConverter = defaultConverter;
this.self = xstream;
}
public boolean canConvert(Class type) {
return type == self.getClass();
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
if (source == self) {
throw new ConversionException("Cannot marshal the XStream instance in action");
}
defaultConverter.marshal(source, writer, context);
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
return defaultConverter.unmarshal(reader, context);
}
}
././@LongLink 0000644 0000000 0000000 00000000170 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ReflectionProvider.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Refl0000664 0001750 0001750 00000003640 12206661545 034473 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import java.lang.reflect.Field;
/**
* Provides core reflection services.
*
* @author Joe Walnes
*/
public interface ReflectionProvider {
/**
* Creates a new instance of the specified type. It is in the responsibility
* of the implementation how such an instance is created.
* @param type the type to instantiate
* @return a new instance of this type
*/
Object newInstance(Class type);
void visitSerializableFields(Object object, Visitor visitor);
void writeField(Object object, String fieldName, Object value, Class definedIn);
Class getFieldType(Object object, String fieldName, Class definedIn);
boolean fieldDefinedInClass(String fieldName, Class type);
/**
* A visitor interface for serializable fields defined in a class.
*
*/
interface Visitor {
/**
* Callback for each visit
* @param name field name
* @param type field type
* @param definedIn where the field was defined
* @param value field value
*/
void visit(String name, Class type, Class definedIn, Object value);
}
/**
* Returns a field defined in some class.
* @param definedIn class where the field was defined
* @param fieldName field name
* @return the field itself
*/
Field getField(Class definedIn, String fieldName);
/**
* Works like {@link #getField(Class, String)} but returns null
* instead of throwing {@link ObjectAccessException}.
*/
Field getFieldOrNull(Class definedIn, String fieldName);
}
././@LongLink 0000644 0000000 0000000 00000000174 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/CGLIBEnhancedConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/CGLI0000664 0001750 0001750 00000046267 12206661545 034335 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2008, 2010, 2011 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 13. April 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.CGLIBMapper;
import com.thoughtworks.xstream.mapper.Mapper;
import net.sf.cglib.proxy.Callback;
import net.sf.cglib.proxy.CallbackFilter;
import net.sf.cglib.proxy.Enhancer;
import net.sf.cglib.proxy.Factory;
import net.sf.cglib.proxy.MethodInterceptor;
import net.sf.cglib.proxy.NoOp;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.lang.reflect.Proxy;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;
/**
* Converts a proxy created by the CGLIB {@link Enhancer}. Such a proxy is recreated while
* deserializing the proxy. The converter does only work, if
*
*
the DefaultNamingPolicy is used for the proxy's name
*
the proxy uses a factory or only one Callback is registered
*
a possible super class has at least a protected default constructor
*
* Note, that the this converter relies on the CGLIBMapper.
*
* @author Jörg Schaible
* @since 1.2
*/
public class CGLIBEnhancedConverter extends SerializableConverter {
private static String DEFAULT_NAMING_MARKER = "$$EnhancerByCGLIB$$";
private static String CALLBACK_MARKER = "CGLIB$CALLBACK_";
private transient Map fieldCache;
public CGLIBEnhancedConverter(Mapper mapper, ReflectionProvider reflectionProvider, ClassLoader classLoader) {
super(mapper, new CGLIBFilteringReflectionProvider(reflectionProvider), classLoader);
this.fieldCache = new HashMap();
}
/**
* @deprecated As of 1.4 use {@link #CGLIBEnhancedConverter(Mapper, ReflectionProvider, ClassLoader)}
*/
public CGLIBEnhancedConverter(Mapper mapper, ReflectionProvider reflectionProvider) {
this(mapper, new CGLIBFilteringReflectionProvider(reflectionProvider), null);
}
public boolean canConvert(Class type) {
return (Enhancer.isEnhanced(type) && type.getName().indexOf(DEFAULT_NAMING_MARKER) > 0)
|| type == CGLIBMapper.Marker.class;
}
public void marshal(Object source, HierarchicalStreamWriter writer,
MarshallingContext context) {
Class type = source.getClass();
boolean hasFactory = Factory.class.isAssignableFrom(type);
ExtendedHierarchicalStreamWriterHelper.startNode(writer, "type", type);
context.convertAnother(type.getSuperclass());
writer.endNode();
writer.startNode("interfaces");
Class[] interfaces = type.getInterfaces();
for (int i = 0; i < interfaces.length; i++ ) {
if (interfaces[i] == Factory.class) {
continue;
}
ExtendedHierarchicalStreamWriterHelper.startNode(writer, mapper
.serializedClass(interfaces[i].getClass()), interfaces[i].getClass());
context.convertAnother(interfaces[i]);
writer.endNode();
}
writer.endNode();
writer.startNode("hasFactory");
writer.setValue(String.valueOf(hasFactory));
writer.endNode();
Map callbackIndexMap = null;
Callback[] callbacks = hasFactory
? ((Factory)source).getCallbacks()
: getCallbacks(source);
if (callbacks.length > 1) {
if (hasFactory) {
callbackIndexMap = createCallbackIndexMap((Factory)source);
} else {
ConversionException exception = new ConversionException(
"Cannot handle CGLIB enhanced proxies without factory that have multiple callbacks");
exception.add("proxy superclass", type.getSuperclass().getName());
exception.add("number of callbacks", String.valueOf(callbacks.length));
throw exception;
}
writer.startNode("callbacks");
writer.startNode("mapping");
context.convertAnother(callbackIndexMap);
writer.endNode();
}
boolean hasInterceptor = false;
for (int i = 0; i < callbacks.length; i++ ) {
final Callback callback = callbacks[i];
if (callback == null) {
String name = mapper.serializedClass(null);
writer.startNode(name);
writer.endNode();
} else {
hasInterceptor = hasInterceptor
|| MethodInterceptor.class.isAssignableFrom(callback.getClass());
ExtendedHierarchicalStreamWriterHelper.startNode(writer, mapper
.serializedClass(callback.getClass()), callback.getClass());
context.convertAnother(callback);
writer.endNode();
}
}
if (callbacks.length > 1) {
writer.endNode();
}
try {
final Field field = type.getDeclaredField("serialVersionUID");
field.setAccessible(true);
long serialVersionUID = field.getLong(null);
ExtendedHierarchicalStreamWriterHelper.startNode(
writer, "serialVersionUID", String.class);
writer.setValue(String.valueOf(serialVersionUID));
writer.endNode();
} catch (NoSuchFieldException e) {
// OK, ignore
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Access to serialVersionUID of "
+ type.getName()
+ " not allowed", e);
}
if (hasInterceptor) {
writer.startNode("instance");
super.doMarshalConditionally(source, writer, context);
writer.endNode();
}
}
private Callback[] getCallbacks(Object source) {
Class type = source.getClass();
List fields = (List)fieldCache.get(type.getName());
if (fields == null) {
fields = new ArrayList();
fieldCache.put(type.getName(), fields);
for (int i = 0; true; ++i) {
try {
Field field = type.getDeclaredField(CALLBACK_MARKER + i);
field.setAccessible(true);
fields.add(field);
} catch (NoSuchFieldException e) {
break;
}
}
}
List list = new ArrayList();
for (int i = 0; i < fields.size(); ++i) {
try {
Field field = (Field)fields.get(i);
Object callback = field.get(source);
list.add(callback);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Access to "
+ type.getName()
+ "."
+ CALLBACK_MARKER
+ i
+ " not allowed", e);
}
}
return (Callback[])list.toArray(new Callback[list.size()]);
}
private Map createCallbackIndexMap(Factory source) {
Callback[] originalCallbacks = source.getCallbacks();
Callback[] reverseEngineeringCallbacks = new Callback[originalCallbacks.length];
Map callbackIndexMap = new HashMap();
int idxNoOp = -1;
for (int i = 0; i < originalCallbacks.length; i++ ) {
Callback callback = originalCallbacks[i];
if (callback == null) {
reverseEngineeringCallbacks[i] = null;
} else if (NoOp.class.isAssignableFrom(callback.getClass())) {
reverseEngineeringCallbacks[i] = NoOp.INSTANCE;
idxNoOp = i;
} else {
reverseEngineeringCallbacks[i] = createReverseEngineeredCallbackOfProperType(
callback, i, callbackIndexMap);
}
}
try {
source.setCallbacks(reverseEngineeringCallbacks);
final Set interfaces = new HashSet();
final Set methods = new HashSet();
Class type = source.getClass();
do {
methods.addAll(Arrays.asList(type.getDeclaredMethods()));
methods.addAll(Arrays.asList(type.getMethods()));
Class[] implementedInterfaces = type.getInterfaces();
interfaces.addAll(Arrays.asList(implementedInterfaces));
type = type.getSuperclass();
} while (type != null);
for (final Iterator iterator = interfaces.iterator(); iterator.hasNext();) {
type = (Class)iterator.next();
methods.addAll(Arrays.asList(type.getDeclaredMethods()));
}
for (final Iterator iter = methods.iterator(); iter.hasNext();) {
final Method method = (Method)iter.next();
method.setAccessible(true);
if (Factory.class.isAssignableFrom(method.getDeclaringClass())
|| (method.getModifiers() & (Modifier.FINAL | Modifier.STATIC)) > 0) {
iter.remove();
continue;
}
Class[] parameterTypes = method.getParameterTypes();
Method calledMethod = method;
try {
if ((method.getModifiers() & Modifier.ABSTRACT) > 0) {
calledMethod = source.getClass().getMethod(
method.getName(), method.getParameterTypes());
}
callbackIndexMap.put(null, method);
calledMethod.invoke(source, parameterTypes == null
? (Object[])null
: createNullArguments(parameterTypes));
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Access to "
+ calledMethod
+ " not allowed", e);
} catch (InvocationTargetException e) {
// OK, ignore
} catch (NoSuchMethodException e) {
ConversionException exception = new ConversionException(
"CGLIB enhanced proxies wit abstract nethod that has not been implemented");
exception.add("proxy superclass", type.getSuperclass().getName());
exception.add("method", method.toString());
throw exception;
}
if (callbackIndexMap.containsKey(method)) {
iter.remove();
}
}
if (idxNoOp >= 0) {
Integer idx = new Integer(idxNoOp);
for (final Iterator iter = methods.iterator(); iter.hasNext();) {
callbackIndexMap.put(iter.next(), idx);
}
}
} finally {
source.setCallbacks(originalCallbacks);
}
callbackIndexMap.remove(null);
return callbackIndexMap;
}
private Object[] createNullArguments(Class[] parameterTypes) {
Object[] arguments = new Object[parameterTypes.length];
for (int i = 0; i < arguments.length; i++ ) {
Class type = parameterTypes[i];
if (type.isPrimitive()) {
if (type == byte.class) {
arguments[i] = new Byte((byte)0);
} else if (type == short.class) {
arguments[i] = new Short((short)0);
} else if (type == int.class) {
arguments[i] = new Integer(0);
} else if (type == long.class) {
arguments[i] = new Long(0);
} else if (type == float.class) {
arguments[i] = new Float(0);
} else if (type == double.class) {
arguments[i] = new Double(0);
} else if (type == char.class) {
arguments[i] = new Character('\0');
} else {
arguments[i] = Boolean.FALSE;
}
}
}
return arguments;
}
private Callback createReverseEngineeredCallbackOfProperType(Callback callback, int index,
Map callbackIndexMap) {
Class iface = null;
Class[] interfaces = callback.getClass().getInterfaces();
for (int i = 0; i < interfaces.length; i++ ) {
if (Callback.class.isAssignableFrom(interfaces[i])) {
iface = interfaces[i];
if (iface == Callback.class) {
ConversionException exception = new ConversionException(
"Cannot handle CGLIB callback");
exception.add("CGLIB callback type", callback.getClass().getName());
throw exception;
}
interfaces = iface.getInterfaces();
if (Arrays.asList(interfaces).contains(Callback.class)) {
break;
}
i = -1;
}
}
return (Callback)Proxy.newProxyInstance(
iface.getClassLoader(), new Class[]{iface},
new ReverseEngineeringInvocationHandler(index, callbackIndexMap));
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
final Enhancer enhancer = new Enhancer();
reader.moveDown();
enhancer.setSuperclass((Class)context.convertAnother(null, Class.class));
reader.moveUp();
reader.moveDown();
List interfaces = new ArrayList();
while (reader.hasMoreChildren()) {
reader.moveDown();
interfaces
.add(context.convertAnother(null, mapper.realClass(reader.getNodeName())));
reader.moveUp();
}
enhancer.setInterfaces((Class[])interfaces.toArray(new Class[interfaces.size()]));
reader.moveUp();
reader.moveDown();
boolean useFactory = Boolean.valueOf(reader.getValue()).booleanValue();
enhancer.setUseFactory(useFactory);
reader.moveUp();
List callbacksToEnhance = new ArrayList();
List callbacks = new ArrayList();
Map callbackIndexMap = null;
reader.moveDown();
if ("callbacks".equals(reader.getNodeName())) {
reader.moveDown();
callbackIndexMap = (Map)context.convertAnother(null, HashMap.class);
reader.moveUp();
while (reader.hasMoreChildren()) {
reader.moveDown();
readCallback(reader, context, callbacksToEnhance, callbacks);
reader.moveUp();
}
} else {
readCallback(reader, context, callbacksToEnhance, callbacks);
}
enhancer.setCallbacks((Callback[])callbacksToEnhance
.toArray(new Callback[callbacksToEnhance.size()]));
if (callbackIndexMap != null) {
enhancer.setCallbackFilter(new ReverseEngineeredCallbackFilter(callbackIndexMap));
}
reader.moveUp();
Object result = null;
while (reader.hasMoreChildren()) {
reader.moveDown();
if (reader.getNodeName().equals("serialVersionUID")) {
enhancer.setSerialVersionUID(Long.valueOf(reader.getValue()));
} else if (reader.getNodeName().equals("instance")) {
result = create(enhancer, callbacks, useFactory);
super.doUnmarshalConditionally(result, reader, context);
}
reader.moveUp();
}
if (result == null) {
result = create(enhancer, callbacks, useFactory);
}
return serializationMethodInvoker.callReadResolve(result);
}
private void readCallback(HierarchicalStreamReader reader, UnmarshallingContext context,
List callbacksToEnhance, List callbacks) {
Callback callback = (Callback)context.convertAnother(null, mapper.realClass(reader
.getNodeName()));
callbacks.add(callback);
if (callback == null) {
callbacksToEnhance.add(NoOp.INSTANCE);
} else {
callbacksToEnhance.add(callback);
}
}
private Object create(final Enhancer enhancer, List callbacks, boolean useFactory) {
Object result = enhancer.create();
if (useFactory) {
((Factory)result).setCallbacks((Callback[])callbacks.toArray(new Callback[callbacks
.size()]));
}
return result;
}
protected List hierarchyFor(Class type) {
List typeHierarchy = super.hierarchyFor(type);
// drop the CGLIB proxy
typeHierarchy.remove(typeHierarchy.size() - 1);
return typeHierarchy;
}
private Object readResolve() {
fieldCache = new HashMap();
return this;
}
private static class CGLIBFilteringReflectionProvider extends ReflectionProviderWrapper {
public CGLIBFilteringReflectionProvider(final ReflectionProvider reflectionProvider) {
super(reflectionProvider);
}
public void visitSerializableFields(final Object object, final Visitor visitor) {
wrapped.visitSerializableFields(object, new Visitor() {
public void visit(String name, Class type, Class definedIn, Object value) {
if (!name.startsWith("CGLIB$")) {
visitor.visit(name, type, definedIn, value);
}
}
});
}
}
private static final class ReverseEngineeringInvocationHandler implements InvocationHandler {
private final Integer index;
private final Map indexMap;
public ReverseEngineeringInvocationHandler(int index, Map indexMap) {
this.indexMap = indexMap;
this.index = new Integer(index);
}
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
indexMap.put(indexMap.get(null), index);
return null;
}
}
private static class ReverseEngineeredCallbackFilter implements CallbackFilter {
private final Map callbackIndexMap;
public ReverseEngineeredCallbackFilter(Map callbackIndexMap) {
this.callbackIndexMap = callbackIndexMap;
}
public int accept(Method method) {
if (!callbackIndexMap.containsKey(method)) {
ConversionException exception = new ConversionException(
"CGLIB callback not detected in reverse engineering");
exception.add("CGLIB callback", method.toString());
throw exception;
}
return ((Integer)callbackIndexMap.get(method)).intValue();
}
}
}
././@LongLink 0000644 0000000 0000000 00000000175 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ImmutableFieldKeySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Immu0000664 0001750 0001750 00000001174 12206661545 034512 0 ustar jamespage jamespage /*
* Copyright (C) 2007 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 10. April 2007 by Guilherme Silveira
*/
package com.thoughtworks.xstream.converters.reflection;
import java.util.Map;
/**
* Does not change the order of the fields.
*
* @author Guilherme Silveira
* @since 1.2.2
*/
public class ImmutableFieldKeySorter implements FieldKeySorter {
public Map sort(Class type, Map keyedByFieldKey) {
return keyedByFieldKey;
}
}
././@LongLink 0000644 0000000 0000000 00000000173 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/SerializableConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Seri0000664 0001750 0001750 00000054055 12206661545 034513 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010, 2011, 2012 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 21. December 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import java.io.IOException;
import java.io.InvalidObjectException;
import java.io.ObjectInputValidation;
import java.io.ObjectStreamClass;
import java.io.ObjectStreamField;
import java.io.Serializable;
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.util.CustomObjectInputStream;
import com.thoughtworks.xstream.core.util.CustomObjectOutputStream;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Emulates the mechanism used by standard Java Serialization for classes that implement java.io.Serializable AND
* implement or inherit a custom readObject()/writeObject() method.
*
*
Supported features of serialization
*
*
readObject(), writeObject()
*
class inheritance
*
readResolve(), writeReplace()
*
*
*
Currently unsupported features
*
*
putFields(), writeFields(), readFields()
*
ObjectStreamField[] serialPersistentFields
*
ObjectInputValidation
*
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class SerializableConverter extends AbstractReflectionConverter {
private static final String ELEMENT_NULL = "null";
private static final String ELEMENT_DEFAULT = "default";
private static final String ELEMENT_UNSERIALIZABLE_PARENTS = "unserializable-parents";
private static final String ATTRIBUTE_CLASS = "class";
private static final String ATTRIBUTE_SERIALIZATION = "serialization";
private static final String ATTRIBUTE_VALUE_CUSTOM = "custom";
private static final String ELEMENT_FIELDS = "fields";
private static final String ELEMENT_FIELD = "field";
private static final String ATTRIBUTE_NAME = "name";
private final ClassLoader classLoader;
public SerializableConverter(Mapper mapper, ReflectionProvider reflectionProvider, ClassLoader classLoader) {
super(mapper, new UnserializableParentsReflectionProvider(reflectionProvider));
this.classLoader = classLoader;
}
/**
* @deprecated As of 1.4 use {@link #SerializableConverter(Mapper, ReflectionProvider, ClassLoader)}
*/
public SerializableConverter(Mapper mapper, ReflectionProvider reflectionProvider) {
this(mapper, new UnserializableParentsReflectionProvider(reflectionProvider), null);
}
public boolean canConvert(Class type) {
return isSerializable(type);
}
private boolean isSerializable(Class type) {
return Serializable.class.isAssignableFrom(type)
&& ( serializationMethodInvoker.supportsReadObject(type, true)
|| serializationMethodInvoker.supportsWriteObject(type, true) );
}
public void doMarshal(final Object source, final HierarchicalStreamWriter writer, final MarshallingContext context) {
String attributeName = mapper.aliasForSystemAttribute(ATTRIBUTE_SERIALIZATION);
if (attributeName != null) {
writer.addAttribute(attributeName, ATTRIBUTE_VALUE_CUSTOM);
}
// this is an array as it's a non final value that's accessed from an anonymous inner class.
final Class[] currentType = new Class[1];
final boolean[] writtenClassWrapper = {false};
CustomObjectOutputStream.StreamCallback callback = new CustomObjectOutputStream.StreamCallback() {
public void writeToStream(Object object) {
if (object == null) {
writer.startNode(ELEMENT_NULL);
writer.endNode();
} else {
ExtendedHierarchicalStreamWriterHelper.startNode(writer, mapper.serializedClass(object.getClass()), object.getClass());
context.convertAnother(object);
writer.endNode();
}
}
public void writeFieldsToStream(Map fields) {
ObjectStreamClass objectStreamClass = ObjectStreamClass.lookup(currentType[0]);
writer.startNode(ELEMENT_DEFAULT);
for (Iterator iterator = fields.keySet().iterator(); iterator.hasNext();) {
String name = (String) iterator.next();
if (!mapper.shouldSerializeMember(currentType[0], name)) {
continue;
}
ObjectStreamField field = objectStreamClass.getField(name);
Object value = fields.get(name);
if (field == null) {
throw new ObjectAccessException("Class " + value.getClass().getName()
+ " may not write a field named '" + name + "'");
}
if (value != null) {
ExtendedHierarchicalStreamWriterHelper.startNode(
writer, mapper.serializedMember(source.getClass(), name),
value.getClass());
if (field.getType() != value.getClass() && !field.getType().isPrimitive()) {
String attributeName = mapper.aliasForSystemAttribute(ATTRIBUTE_CLASS);
if (attributeName != null) {
writer.addAttribute(attributeName, mapper.serializedClass(value.getClass()));
}
}
context.convertAnother(value);
writer.endNode();
}
}
writer.endNode();
}
public void defaultWriteObject() {
boolean writtenDefaultFields = false;
ObjectStreamClass objectStreamClass = ObjectStreamClass.lookup(currentType[0]);
if (objectStreamClass == null) {
return;
}
ObjectStreamField[] fields = objectStreamClass.getFields();
for (int i = 0; i < fields.length; i++) {
ObjectStreamField field = fields[i];
Object value = readField(field, currentType[0], source);
if (value != null) {
if (!writtenClassWrapper[0]) {
writer.startNode(mapper.serializedClass(currentType[0]));
writtenClassWrapper[0] = true;
}
if (!writtenDefaultFields) {
writer.startNode(ELEMENT_DEFAULT);
writtenDefaultFields = true;
}
if (!mapper.shouldSerializeMember(currentType[0], field.getName())) {
continue;
}
Class actualType = value.getClass();
ExtendedHierarchicalStreamWriterHelper.startNode(
writer, mapper.serializedMember(source.getClass(), field.getName()), actualType);
Class defaultType = mapper.defaultImplementationOf(field.getType());
if (!actualType.equals(defaultType)) {
String attributeName = mapper.aliasForSystemAttribute(ATTRIBUTE_CLASS);
if (attributeName != null) {
writer.addAttribute(attributeName, mapper.serializedClass(actualType));
}
}
context.convertAnother(value);
writer.endNode();
}
}
if (writtenClassWrapper[0] && !writtenDefaultFields) {
writer.startNode(ELEMENT_DEFAULT);
writer.endNode();
} else if (writtenDefaultFields) {
writer.endNode();
}
}
public void flush() {
writer.flush();
}
public void close() {
throw new UnsupportedOperationException("Objects are not allowed to call ObjectOutputStream.close() from writeObject()");
}
};
try {
boolean mustHandleUnserializableParent = false;
Iterator classHieararchy = hierarchyFor(source.getClass()).iterator();
while (classHieararchy.hasNext()) {
currentType[0] = (Class) classHieararchy.next();
if (!Serializable.class.isAssignableFrom(currentType[0])) {
mustHandleUnserializableParent = true;
continue;
} else {
if (mustHandleUnserializableParent) {
marshalUnserializableParent(writer, context, source);
mustHandleUnserializableParent = false;
}
if (serializationMethodInvoker.supportsWriteObject(currentType[0], false)) {
writtenClassWrapper[0] = true;
writer.startNode(mapper.serializedClass(currentType[0]));
if (currentType[0] != mapper.defaultImplementationOf(currentType[0])) {
String classAttributeName = mapper.aliasForSystemAttribute(ATTRIBUTE_CLASS);
if (classAttributeName != null) {
writer.addAttribute(classAttributeName, currentType[0].getName());
}
}
CustomObjectOutputStream objectOutputStream = CustomObjectOutputStream.getInstance(context, callback);
serializationMethodInvoker.callWriteObject(currentType[0], source, objectOutputStream);
objectOutputStream.popCallback();
writer.endNode();
} else if (serializationMethodInvoker.supportsReadObject(currentType[0], false)) {
// Special case for objects that have readObject(), but not writeObject().
// The class wrapper is always written, whether or not this class in the hierarchy has
// serializable fields. This guarantees that readObject() will be called upon deserialization.
writtenClassWrapper[0] = true;
writer.startNode(mapper.serializedClass(currentType[0]));
if (currentType[0] != mapper.defaultImplementationOf(currentType[0])) {
String classAttributeName = mapper.aliasForSystemAttribute(ATTRIBUTE_CLASS);
if (classAttributeName != null) {
writer.addAttribute(classAttributeName, currentType[0].getName());
}
}
callback.defaultWriteObject();
writer.endNode();
} else {
writtenClassWrapper[0] = false;
callback.defaultWriteObject();
if (writtenClassWrapper[0]) {
writer.endNode();
}
}
}
}
} catch (IOException e) {
throw new ObjectAccessException("Could not call defaultWriteObject()", e);
}
}
protected void marshalUnserializableParent(final HierarchicalStreamWriter writer, final MarshallingContext context, final Object replacedSource) {
writer.startNode(ELEMENT_UNSERIALIZABLE_PARENTS);
super.doMarshal(replacedSource, writer, context);
writer.endNode();
}
private Object readField(ObjectStreamField field, Class type, Object instance) {
try {
Field javaField = type.getDeclaredField(field.getName());
javaField.setAccessible(true);
return javaField.get(instance);
} catch (IllegalArgumentException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
} catch (NoSuchFieldException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
} catch (SecurityException e) {
throw new ObjectAccessException("Could not get field " + field.getClass() + "." + field.getName(), e);
}
}
protected List hierarchyFor(Class type) {
List result = new ArrayList();
while(type != Object.class) {
result.add(type);
type = type.getSuperclass();
}
// In Java Object Serialization, the classes are deserialized starting from parent class and moving down.
Collections.reverse(result);
return result;
}
public Object doUnmarshal(final Object result, final HierarchicalStreamReader reader, final UnmarshallingContext context) {
// this is an array as it's a non final value that's accessed from an anonymous inner class.
final Class[] currentType = new Class[1];
String attributeName = mapper.aliasForSystemAttribute(ATTRIBUTE_SERIALIZATION);
if (attributeName != null && !ATTRIBUTE_VALUE_CUSTOM.equals(reader.getAttribute(attributeName))) {
throw new ConversionException("Cannot deserialize object with new readObject()/writeObject() methods");
}
CustomObjectInputStream.StreamCallback callback = new CustomObjectInputStream.StreamCallback() {
public Object readFromStream() {
reader.moveDown();
Class type = HierarchicalStreams.readClassType(reader, mapper);
Object value = context.convertAnother(result, type);
reader.moveUp();
return value;
}
public Map readFieldsFromStream() {
final Map fields = new HashMap();
reader.moveDown();
if (reader.getNodeName().equals(ELEMENT_FIELDS)) {
// Maintain compatibility with XStream 1.1.0
while (reader.hasMoreChildren()) {
reader.moveDown();
if (!reader.getNodeName().equals(ELEMENT_FIELD)) {
throw new ConversionException("Expected <" + ELEMENT_FIELD + "/> element inside <" + ELEMENT_FIELD + "/>");
}
String name = reader.getAttribute(ATTRIBUTE_NAME);
Class type = mapper.realClass(reader.getAttribute(ATTRIBUTE_CLASS));
Object value = context.convertAnother(result, type);
fields.put(name, value);
reader.moveUp();
}
} else if (reader.getNodeName().equals(ELEMENT_DEFAULT)) {
// New format introduced in XStream 1.1.1
ObjectStreamClass objectStreamClass = ObjectStreamClass.lookup(currentType[0]);
while (reader.hasMoreChildren()) {
reader.moveDown();
String name = mapper.realMember(currentType[0], reader.getNodeName());
if (mapper.shouldSerializeMember(currentType[0], name)) {
String classAttribute = HierarchicalStreams.readClassAttribute(reader, mapper);
Class type;
if (classAttribute != null) {
type = mapper.realClass(classAttribute);
} else {
ObjectStreamField field = objectStreamClass.getField(name);
if (field == null) {
throw new MissingFieldException(currentType[0].getName(), name);
}
type = field.getType();
}
Object value = context.convertAnother(result, type);
fields.put(name, value);
}
reader.moveUp();
}
} else {
throw new ConversionException("Expected <" + ELEMENT_FIELDS + "/> or <" +
ELEMENT_DEFAULT + "/> element when calling ObjectInputStream.readFields()");
}
reader.moveUp();
return fields;
}
public void defaultReadObject() {
if (!reader.hasMoreChildren()) {
return;
}
reader.moveDown();
if (!reader.getNodeName().equals(ELEMENT_DEFAULT)) {
throw new ConversionException("Expected <" + ELEMENT_DEFAULT + "/> element in readObject() stream");
}
while (reader.hasMoreChildren()) {
reader.moveDown();
String fieldName = mapper.realMember(currentType[0], reader.getNodeName());
if (mapper.shouldSerializeMember(currentType[0], fieldName)) {
String classAttribute = HierarchicalStreams.readClassAttribute(reader, mapper);
final Class type;
if (classAttribute != null) {
type = mapper.realClass(classAttribute);
} else {
type = mapper.defaultImplementationOf(reflectionProvider.getFieldType(result, fieldName, currentType[0]));
}
Object value = context.convertAnother(result, type);
reflectionProvider.writeField(result, fieldName, value, currentType[0]);
}
reader.moveUp();
}
reader.moveUp();
}
public void registerValidation(final ObjectInputValidation validation, int priority) {
context.addCompletionCallback(new Runnable() {
public void run() {
try {
validation.validateObject();
} catch (InvalidObjectException e) {
throw new ObjectAccessException("Cannot validate object : " + e.getMessage(), e);
}
}
}, priority);
}
public void close() {
throw new UnsupportedOperationException("Objects are not allowed to call ObjectInputStream.close() from readObject()");
}
};
while (reader.hasMoreChildren()) {
reader.moveDown();
String nodeName = reader.getNodeName();
if (nodeName.equals(ELEMENT_UNSERIALIZABLE_PARENTS)) {
super.doUnmarshal(result, reader, context);
} else {
String classAttribute = HierarchicalStreams.readClassAttribute(reader, mapper);
if (classAttribute == null) {
currentType[0] = mapper.defaultImplementationOf(mapper.realClass(nodeName));
} else {
currentType[0] = mapper.realClass(classAttribute);
}
if (serializationMethodInvoker.supportsReadObject(currentType[0], false)) {
CustomObjectInputStream objectInputStream =
CustomObjectInputStream.getInstance(context, callback, classLoader);
serializationMethodInvoker.callReadObject(currentType[0], result, objectInputStream);
objectInputStream.popCallback();
} else {
try {
callback.defaultReadObject();
} catch (IOException e) {
throw new ObjectAccessException("Could not call defaultWriteObject()", e);
}
}
}
reader.moveUp();
}
return result;
}
protected void doMarshalConditionally(final Object source, final HierarchicalStreamWriter writer, final MarshallingContext context) {
if(isSerializable(source.getClass())) {
doMarshal(source, writer, context);
} else {
super.doMarshal(source, writer, context);
}
}
protected Object doUnmarshalConditionally(final Object result, final HierarchicalStreamReader reader, final UnmarshallingContext context) {
return isSerializable(result.getClass()) ? doUnmarshal(result, reader, context) : super.doUnmarshal(result, reader, context);
}
private static class UnserializableParentsReflectionProvider extends ReflectionProviderWrapper {
public UnserializableParentsReflectionProvider(final ReflectionProvider reflectionProvider) {
super(reflectionProvider);
}
public void visitSerializableFields(final Object object, final Visitor visitor) {
wrapped.visitSerializableFields(object, new Visitor() {
public void visit(String name, Class type, Class definedIn, Object value) {
if (!Serializable.class.isAssignableFrom(definedIn)) {
visitor.visit(name, type, definedIn, value);
}
}
});
}
}
}
././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ReflectionConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Refl0000664 0001750 0001750 00000001340 12206661545 034466 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.mapper.Mapper;
public class ReflectionConverter extends AbstractReflectionConverter {
public ReflectionConverter(Mapper mapper, ReflectionProvider reflectionProvider) {
super(mapper, reflectionProvider);
}
public boolean canConvert(Class type) {
return true;
}
}
././@LongLink 0000644 0000000 0000000 00000000175 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/XStream12FieldKeySorter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/XStr0000664 0001750 0001750 00000002553 12206661545 034505 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008, 2013 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 19.09.2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import java.util.Comparator;
import java.util.Map;
import java.util.TreeMap;
/**
* Sort the fields in the order of XStream 1.2.x. Fields are returned in their declaration order,
* fields of base classes last.
*
* @author Jörg Schaible
* @since 1.3
*/
public class XStream12FieldKeySorter implements FieldKeySorter {
public Map sort(final Class type, final Map keyedByFieldKey) {
final Map map = new TreeMap(new Comparator() {
public int compare(final Object o1, final Object o2) {
final FieldKey fieldKey1 = (FieldKey)o1;
final FieldKey fieldKey2 = (FieldKey)o2;
int i = fieldKey2.getDepth() - fieldKey1.getDepth();
if (i == 0) {
i = fieldKey1.getOrder() - fieldKey2.getOrder();
}
return i;
}
});
map.putAll(keyedByFieldKey);
keyedByFieldKey.clear();
keyedByFieldKey.putAll(map);
return keyedByFieldKey;
}
}
././@LongLink 0000644 0000000 0000000 00000000177 12260544303 011646 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ReflectionProviderWrapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Refl0000664 0001750 0001750 00000003276 12206661545 034500 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 13. April 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.reflection;
import java.lang.reflect.Field;
/**
* A wrapper implementation for the ReflectionProvider.
*
* @author Jörg Schaible
* @since 1.2
*/
public class ReflectionProviderWrapper implements ReflectionProvider {
final protected ReflectionProvider wrapped;
public ReflectionProviderWrapper(ReflectionProvider wrapper) {
this.wrapped = wrapper;
}
public boolean fieldDefinedInClass(String fieldName, Class type) {
return this.wrapped.fieldDefinedInClass(fieldName, type);
}
public Field getField(Class definedIn, String fieldName) {
return this.wrapped.getField(definedIn, fieldName);
}
public Field getFieldOrNull(Class definedIn, String fieldName) {
return this.wrapped.getFieldOrNull(definedIn, fieldName);
}
public Class getFieldType(Object object, String fieldName, Class definedIn) {
return this.wrapped.getFieldType(object, fieldName, definedIn);
}
public Object newInstance(Class type) {
return this.wrapped.newInstance(type);
}
public void visitSerializableFields(Object object, Visitor visitor) {
this.wrapped.visitSerializableFields(object, visitor);
}
public void writeField(Object object, String fieldName, Object value, Class definedIn) {
this.wrapped.writeField(object, fieldName, value, definedIn);
}
}
././@LongLink 0000644 0000000 0000000 00000000173 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ObjectAccessException.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Obje0000664 0001750 0001750 00000001270 12206661545 034457 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.XStreamException;
public class ObjectAccessException extends XStreamException {
public ObjectAccessException(String message) {
super(message);
}
public ObjectAccessException(String message, Throwable cause) {
super(message, cause);
}
}
././@LongLink 0000644 0000000 0000000 00000000175 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/ExternalizableConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Exte0000664 0001750 0001750 00000014763 12206661545 034520 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010, 2011 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 24. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.util.CustomObjectInputStream;
import com.thoughtworks.xstream.core.util.CustomObjectOutputStream;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.mapper.Mapper;
import java.io.Externalizable;
import java.io.IOException;
import java.io.NotActiveException;
import java.io.ObjectInputValidation;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.util.Map;
/**
* Converts any object that implements the java.io.Externalizable interface, allowing compatibility with native Java
* serialization.
*
* @author Joe Walnes
*/
public class ExternalizableConverter implements Converter {
private Mapper mapper;
private final ClassLoader classLoader;
public ExternalizableConverter(Mapper mapper, ClassLoader classLoader) {
this.mapper = mapper;
this.classLoader = classLoader;
}
/**
* @deprecated As of 1.4 use {@link #ExternalizableConverter(Mapper, ClassLoader)}
*/
public ExternalizableConverter(Mapper mapper) {
this(mapper, null);
}
public boolean canConvert(Class type) {
return Externalizable.class.isAssignableFrom(type);
}
public void marshal(Object source, final HierarchicalStreamWriter writer, final MarshallingContext context) {
try {
Externalizable externalizable = (Externalizable) source;
CustomObjectOutputStream.StreamCallback callback = new CustomObjectOutputStream.StreamCallback() {
public void writeToStream(Object object) {
if (object == null) {
writer.startNode("null");
writer.endNode();
} else {
ExtendedHierarchicalStreamWriterHelper.startNode(writer, mapper.serializedClass(object.getClass()), object.getClass());
context.convertAnother(object);
writer.endNode();
}
}
public void writeFieldsToStream(Map fields) {
throw new UnsupportedOperationException();
}
public void defaultWriteObject() {
throw new UnsupportedOperationException();
}
public void flush() {
writer.flush();
}
public void close() {
throw new UnsupportedOperationException("Objects are not allowed to call ObjectOutput.close() from writeExternal()");
}
};
CustomObjectOutputStream objectOutput = CustomObjectOutputStream.getInstance(context, callback);
externalizable.writeExternal(objectOutput);
objectOutput.popCallback();
} catch (IOException e) {
throw new ConversionException("Cannot serialize " + source.getClass().getName() + " using Externalization", e);
}
}
public Object unmarshal(final HierarchicalStreamReader reader, final UnmarshallingContext context) {
final Class type = context.getRequiredType();
final Constructor defaultConstructor;
try {
defaultConstructor = type.getDeclaredConstructor((Class[]) null);
if (!defaultConstructor.isAccessible()) {
defaultConstructor.setAccessible(true);
}
final Externalizable externalizable = (Externalizable) defaultConstructor.newInstance((Object[]) null);
CustomObjectInputStream.StreamCallback callback = new CustomObjectInputStream.StreamCallback() {
public Object readFromStream() {
reader.moveDown();
Class type = HierarchicalStreams.readClassType(reader, mapper);
Object streamItem = context.convertAnother(externalizable, type);
reader.moveUp();
return streamItem;
}
public Map readFieldsFromStream() {
throw new UnsupportedOperationException();
}
public void defaultReadObject() {
throw new UnsupportedOperationException();
}
public void registerValidation(ObjectInputValidation validation, int priority) throws NotActiveException {
throw new NotActiveException("stream inactive");
}
public void close() {
throw new UnsupportedOperationException("Objects are not allowed to call ObjectInput.close() from readExternal()");
}
};
CustomObjectInputStream objectInput = CustomObjectInputStream.getInstance(context, callback, classLoader);
externalizable.readExternal(objectInput);
objectInput.popCallback();
return externalizable;
} catch (NoSuchMethodException e) {
throw new ConversionException("Cannot construct " + type.getClass() + ", missing default constructor", e);
} catch (InvocationTargetException e) {
throw new ConversionException("Cannot construct " + type.getClass(), e);
} catch (InstantiationException e) {
throw new ConversionException("Cannot construct " + type.getClass(), e);
} catch (IllegalAccessException e) {
throw new ConversionException("Cannot construct " + type.getClass(), e);
} catch (IOException e) {
throw new ConversionException("Cannot externalize " + type.getClass(), e);
} catch (ClassNotFoundException e) {
throw new ConversionException("Cannot externalize " + type.getClass(), e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000200 12260544303 011631 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/SerializationMethodInvoker.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Seri0000664 0001750 0001750 00000015163 12206661545 034510 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010, 2011 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 23. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.core.Caching;
import com.thoughtworks.xstream.core.util.FastField;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
/**
* Convenience wrapper to invoke special serialization methods on objects (and perform
* reflection caching).
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class SerializationMethodInvoker implements Caching {
private static final Method NO_METHOD = (new Object() {
private void noMethod() {
}
}).getClass().getDeclaredMethods()[0];
private static final Object[] EMPTY_ARGS = new Object[0];
private static final FastField[] OBJECT_TYPE_FIELDS = new FastField[]{
new FastField(Object.class, "readResolve"),
new FastField(Object.class, "writeReplace"),
new FastField(Object.class, "readObject"),
new FastField(Object.class, "writeObject")
};
private Map cache = new ConcurrentHashMap();
{
for(int i = 0; i < OBJECT_TYPE_FIELDS.length; ++i) {
cache.put(OBJECT_TYPE_FIELDS[i], NO_METHOD);
}
}
/**
* Resolves an object as native serialization does by calling readResolve(), if available.
*/
public Object callReadResolve(Object result) {
if (result == null) {
return null;
} else {
Method readResolveMethod = getMethod(result.getClass(), "readResolve", null, true);
if (readResolveMethod != null) {
try {
return readResolveMethod.invoke(result, EMPTY_ARGS);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not call "
+ result.getClass().getName()
+ ".readResolve()", e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException("Could not call "
+ result.getClass().getName()
+ ".readResolve()", e.getTargetException());
}
} else {
return result;
}
}
}
public Object callWriteReplace(Object object) {
if (object == null) {
return null;
} else {
Method writeReplaceMethod = getMethod(object.getClass(), "writeReplace", null, true);
if (writeReplaceMethod != null) {
try {
return writeReplaceMethod.invoke(object, EMPTY_ARGS);
} catch (IllegalAccessException e) {
throw new ObjectAccessException("Could not call "
+ object.getClass().getName()
+ ".writeReplace()", e);
} catch (InvocationTargetException e) {
throw new ObjectAccessException("Could not call "
+ object.getClass().getName()
+ ".writeReplace()", e.getTargetException());
}
} else {
return object;
}
}
}
public boolean supportsReadObject(Class type, boolean includeBaseClasses) {
return getMethod(
type, "readObject", new Class[]{ObjectInputStream.class}, includeBaseClasses) != null;
}
public void callReadObject(Class type, Object object, ObjectInputStream stream) {
try {
Method readObjectMethod = getMethod(
type, "readObject", new Class[]{ObjectInputStream.class}, false);
readObjectMethod.invoke(object, new Object[]{stream});
} catch (IllegalAccessException e) {
throw new ConversionException("Could not call "
+ object.getClass().getName()
+ ".readObject()", e);
} catch (InvocationTargetException e) {
throw new ConversionException("Could not call "
+ object.getClass().getName()
+ ".readObject()", e.getTargetException());
}
}
public boolean supportsWriteObject(Class type, boolean includeBaseClasses) {
return getMethod(
type, "writeObject", new Class[]{ObjectOutputStream.class}, includeBaseClasses) != null;
}
public void callWriteObject(Class type, Object instance, ObjectOutputStream stream) {
try {
Method readObjectMethod = getMethod(
type, "writeObject", new Class[]{ObjectOutputStream.class}, false);
readObjectMethod.invoke(instance, new Object[]{stream});
} catch (IllegalAccessException e) {
throw new ConversionException("Could not call "
+ instance.getClass().getName()
+ ".writeObject()", e);
} catch (InvocationTargetException e) {
throw new ConversionException("Could not call "
+ instance.getClass().getName()
+ ".writeObject()", e.getTargetException());
}
}
private Method getMethod(Class type, String name, Class[] parameterTypes,
boolean includeBaseclasses) {
Method method = getMethod(type, name, parameterTypes);
return method == NO_METHOD
|| (!includeBaseclasses && !method.getDeclaringClass().equals(type))
? null
: method;
}
private Method getMethod(Class type, String name, Class[] parameterTypes) {
FastField method = new FastField(type, name);
Method result = (Method)cache.get(method);
if (result == null) {
try {
result = type.getDeclaredMethod(name, parameterTypes);
if (!result.isAccessible()) {
result.setAccessible(true);
}
} catch (NoSuchMethodException e) {
result = getMethod(type.getSuperclass(), name, parameterTypes);
}
cache.put(method, result);
}
return result;
}
public void flushCache() {
cache.keySet().retainAll(Arrays.asList(OBJECT_TYPE_FIELDS));
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/FieldDictionary.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/reflection/Fiel0000664 0001750 0001750 00000017323 12206661545 034465 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 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 14. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.reflection;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;
import com.thoughtworks.xstream.core.Caching;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.core.util.OrderRetainingMap;
/**
* A field dictionary instance caches information about classes fields.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Guilherme Silveira
*/
public class FieldDictionary implements Caching {
private transient Map keyedByFieldNameCache;
private transient Map keyedByFieldKeyCache;
private final FieldKeySorter sorter;
public FieldDictionary() {
this(new ImmutableFieldKeySorter());
}
public FieldDictionary(FieldKeySorter sorter) {
this.sorter = sorter;
init();
}
private void init() {
keyedByFieldNameCache = new HashMap();
keyedByFieldKeyCache = new HashMap();
keyedByFieldNameCache.put(Object.class, Collections.EMPTY_MAP);
keyedByFieldKeyCache.put(Object.class, Collections.EMPTY_MAP);
}
/**
* Returns an iterator for all fields for some class
*
* @param cls the class you are interested on
* @return an iterator for its fields
* @deprecated As of 1.3, use {@link #fieldsFor(Class)} instead
*/
public Iterator serializableFieldsFor(Class cls) {
return fieldsFor(cls);
}
/**
* Returns an iterator for all fields for some class
*
* @param cls the class you are interested on
* @return an iterator for its fields
*/
public Iterator fieldsFor(final Class cls) {
return buildMap(cls, true).values().iterator();
}
/**
* Returns an specific field of some class. If definedIn is null, it searches for the field
* named 'name' inside the class cls. If definedIn is different than null, tries to find the
* specified field name in the specified class cls which should be defined in class
* definedIn (either equals cls or a one of it's superclasses)
*
* @param cls the class where the field is to be searched
* @param name the field name
* @param definedIn the superclass (or the class itself) of cls where the field was defined
* @return the field itself
* @throws ObjectAccessException if no field can be found
*/
public Field field(Class cls, String name, Class definedIn) {
Field field = fieldOrNull(cls, name, definedIn);
if (field == null) {
throw new MissingFieldException(cls.getName(), name);
} else {
return field;
}
}
/**
* Returns an specific field of some class. If definedIn is null, it searches for the field
* named 'name' inside the class cls. If definedIn is different than null, tries to find the
* specified field name in the specified class cls which should be defined in class
* definedIn (either equals cls or a one of it's superclasses)
*
* @param cls the class where the field is to be searched
* @param name the field name
* @param definedIn the superclass (or the class itself) of cls where the field was defined
* @return the field itself or null
* @since 1.4
*/
public Field fieldOrNull(Class cls, String name, Class definedIn) {
Map fields = buildMap(cls, definedIn != null);
Field field = (Field)fields.get(definedIn != null
? (Object)new FieldKey(name, definedIn, -1)
: (Object)name);
return field;
}
private Map buildMap(final Class type, boolean tupleKeyed) {
Class cls = type;
synchronized (this) {
if (!keyedByFieldNameCache.containsKey(type)) {
final List superClasses = new ArrayList();
while (!Object.class.equals(cls)) {
superClasses.add(0, cls);
cls = cls.getSuperclass();
}
Map lastKeyedByFieldName = Collections.EMPTY_MAP;
Map lastKeyedByFieldKey = Collections.EMPTY_MAP;
for (final Iterator iter = superClasses.iterator(); iter.hasNext();) {
cls = (Class)iter.next();
if (!keyedByFieldNameCache.containsKey(cls)) {
final Map keyedByFieldName = new HashMap(lastKeyedByFieldName);
final Map keyedByFieldKey = new OrderRetainingMap(lastKeyedByFieldKey);
Field[] fields = cls.getDeclaredFields();
if (JVM.reverseFieldDefinition()) {
for (int i = fields.length >> 1; i-- > 0;) {
final int idx = fields.length - i - 1;
final Field field = fields[i];
fields[i] = fields[idx];
fields[idx] = field;
}
}
for (int i = 0; i < fields.length; i++ ) {
Field field = fields[i];
if (!field.isAccessible()) {
field.setAccessible(true);
}
FieldKey fieldKey = new FieldKey(
field.getName(), field.getDeclaringClass(), i);
Field existent = (Field)keyedByFieldName.get(field.getName());
if (existent == null
// do overwrite statics
|| ((existent.getModifiers() & Modifier.STATIC) != 0)
// overwrite non-statics with non-statics only
|| (existent != null && ((field.getModifiers() & Modifier.STATIC) == 0))) {
keyedByFieldName.put(field.getName(), field);
}
keyedByFieldKey.put(fieldKey, field);
}
final Map sortedFieldKeys = sorter.sort(cls, keyedByFieldKey);
keyedByFieldNameCache.put(cls, keyedByFieldName);
keyedByFieldKeyCache.put(cls, sortedFieldKeys);
lastKeyedByFieldName = keyedByFieldName;
lastKeyedByFieldKey = sortedFieldKeys;
} else {
lastKeyedByFieldName = (Map)keyedByFieldNameCache.get(cls);
lastKeyedByFieldKey = (Map)keyedByFieldKeyCache.get(cls);
}
}
return tupleKeyed ? lastKeyedByFieldKey : lastKeyedByFieldName;
}
}
return (Map)(tupleKeyed
? keyedByFieldKeyCache.get(type)
: keyedByFieldNameCache.get(type));
}
public synchronized void flushCache() {
Set objectTypeSet = Collections.singleton(Object.class);
keyedByFieldNameCache.keySet().retainAll(objectTypeSet);
keyedByFieldKeyCache.keySet().retainAll(objectTypeSet);
if (sorter instanceof Caching) {
((Caching)sorter).flushCache();
}
}
protected Object readResolve() {
init();
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/UnmarshallingContext.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/UnmarshallingCo0000664 0001750 0001750 00000001347 12206661545 034541 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 06. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
public interface UnmarshallingContext extends DataHolder {
Object convertAnother(Object current, Class type);
/**
* @since 1.2
*/
Object convertAnother(Object current, Class type, Converter converter);
Object currentObject();
Class getRequiredType();
void addCompletionCallback(Runnable work, int priority);
}
././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/SingleValueConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/SingleValueConv0000664 0001750 0001750 00000002606 12206661545 034516 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 15. February 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.converters;
/**
* SingleValueConverter implementations are marshallable to/from a single value String representation.
*
*
{@link com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter}
* provides a starting point for objects that can store all information in a single value String.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Mauro Talevi
* @see com.thoughtworks.xstream.converters.Converter
* @see com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter
* @since 1.2
*/
public interface SingleValueConverter extends ConverterMatcher {
/**
* Marshals an Object into a single value representation.
* @param obj the Object to be converted
* @return a String with the single value of the Object or null
*/
public String toString(Object obj);
/**
* Unmarshals an Object from its single value representation.
* @param str the String with the single value of the Object
* @return the Object
*/
public Object fromString(String str);
} ././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConverterMatcher.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConverterMatche0000664 0001750 0001750 00000001762 12206661545 034545 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 15. February 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.converters;
/**
* ConverterMatcher allows to match converters to classes by
* determining if a given type can be converted by the converter instance.
* ConverterMatcher is the base interface of any converter.
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Mauro Talevi
* @see com.thoughtworks.xstream.converters.Converter
* @see com.thoughtworks.xstream.converters.SingleValueConverter
* @since 1.2
*/
public interface ConverterMatcher {
/**
* Determines whether the converter can marshall a particular type.
* @param type the Class representing the object type to be converted
*/
boolean canConvert(Class type);
} jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ 0000775 0001750 0001750 00000000000 12206661545 033323 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/JavaClassConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/JavaCl0000664 0001750 0001750 00000004342 12206661545 034411 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 04. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import com.thoughtworks.xstream.core.util.Primitives;
/**
* Converts a java.lang.Class to XML.
*
* @author Aslak Hellesøy
* @author Joe Walnes
* @author Matthew Sandoz
* @author Jörg Schaible
*/
public class JavaClassConverter extends AbstractSingleValueConverter {
private ClassLoader classLoader;
public JavaClassConverter(ClassLoader classLoader) {
this.classLoader = classLoader;
}
public boolean canConvert(Class clazz) {
return Class.class.equals(clazz); // :)
}
public String toString(Object obj) {
return ((Class) obj).getName();
}
public Object fromString(String str) {
try {
return loadClass(str);
} catch (ClassNotFoundException e) {
throw new ConversionException("Cannot load java class " + str, e);
}
}
private Class loadClass(String className) throws ClassNotFoundException {
Class resultingClass = Primitives.primitiveType(className);
if( resultingClass != null ){
return resultingClass;
}
int dimension;
for(dimension = 0; className.charAt(dimension) == '['; ++dimension);
if (dimension > 0) {
final ClassLoader classLoaderToUse;
if (className.charAt(dimension) == 'L') {
String componentTypeName = className.substring(dimension + 1, className.length() - 1);
classLoaderToUse = classLoader.loadClass(componentTypeName).getClassLoader();
} else {
classLoaderToUse = null;
}
return Class.forName(className, false, classLoaderToUse);
}
return classLoader.loadClass(className);
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/FileConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/FileCo0000664 0001750 0001750 00000001756 12206661545 034420 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 13. January 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import java.io.File;
/**
* This converter will take care of storing and retrieving File with either
* an absolute path OR a relative path depending on how they were created.
*
* @author Joe Walnes
*/
public class FileConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(File.class);
}
public Object fromString(String str) {
return new File(str);
}
public String toString(Object obj) {
return ((File) obj).getPath();
}
} ././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ThrowableConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Throwa0000664 0001750 0001750 00000003677 12206661545 034527 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* Converter for Throwable (and Exception) that retains stack trace, for JDK1.4 only.
*
* @author B. K. Oxley (binkley)
* @author Joe Walnes
*/
public class ThrowableConverter implements Converter {
private Converter defaultConverter;
public ThrowableConverter(Converter defaultConverter) {
this.defaultConverter = defaultConverter;
}
public boolean canConvert(final Class type) {
return Throwable.class.isAssignableFrom(type);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Throwable throwable = (Throwable) source;
if (throwable.getCause() == null) {
try {
throwable.initCause(null);
} catch (IllegalStateException e) {
// ignore, initCause failed, cause was already set
}
}
throwable.getStackTrace(); // Force stackTrace field to be lazy loaded by special JVM native witchcraft (outside our control).
defaultConverter.marshal(throwable, writer, context);
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
return defaultConverter.unmarshal(reader, context);
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ToStringConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ToStri0000664 0001750 0001750 00000003702 12206661545 034474 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 07. July 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
/**
* Convenient converter for classes with natural string representation.
*
* Converter for classes that adopt the following convention:
* - a constructor that takes a single string parameter
* - a toString() that is overloaded to issue a string that is meaningful
*
* @author Paul Hammant
*/
public class ToStringConverter extends AbstractSingleValueConverter {
private final Class clazz;
private final Constructor ctor;
public ToStringConverter(Class clazz) throws NoSuchMethodException {
this.clazz = clazz;
ctor = clazz.getConstructor(new Class[] {String.class});
}
public boolean canConvert(Class type) {
return type.equals(clazz);
}
public String toString(Object obj) {
return obj == null ? null : obj.toString();
}
public Object fromString(String str) {
try {
return ctor.newInstance(new Object[] {str});
} catch (InstantiationException e) {
throw new ConversionException("Unable to instantiate single String param constructor", e);
} catch (IllegalAccessException e) {
throw new ConversionException("Unable to access single String param constructor", e);
} catch (InvocationTargetException e) {
throw new ConversionException("Unable to target single String param constructor", e.getTargetException());
}
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/DurationConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Durati0000664 0001750 0001750 00000003504 12206661545 034500 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008, 2011 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 21.09.2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import javax.xml.datatype.DatatypeConfigurationException;
import javax.xml.datatype.DatatypeFactory;
import javax.xml.datatype.Duration;
/**
* A Converter for the XML Schema datatype duration and the Java type
* {@link Duration}. The implementation uses a {@link DatatypeFactory} to create Duration
* objects. If no factory is provided and the instantiation of the internal factory fails with a
* {@link DatatypeConfigurationException}, the converter will not claim the responsibility for
* Duration objects.
*
* @author John Kristian
* @author Jörg Schaible
* @since 1.3
*/
public class DurationConverter extends AbstractSingleValueConverter {
private final DatatypeFactory factory;
public DurationConverter() {
this(new Object() {
DatatypeFactory getFactory() {
try {
return DatatypeFactory.newInstance();
} catch (final DatatypeConfigurationException e) {
return null;
}
}
}.getFactory());
}
public DurationConverter(DatatypeFactory factory) {
this.factory = factory;
}
public boolean canConvert(Class c) {
return factory != null && Duration.class.isAssignableFrom(c);
}
public Object fromString(String s) {
return factory.newDuration(s);
}
}
././@LongLink 0000644 0000000 0000000 00000000176 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ToAttributedValueConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ToAttr0000664 0001750 0001750 00000032071 12206661545 034466 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 30. July 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.DuplicateFieldException;
import com.thoughtworks.xstream.converters.reflection.ReflectionProvider;
import com.thoughtworks.xstream.core.util.FastField;
import com.thoughtworks.xstream.core.util.HierarchicalStreams;
import com.thoughtworks.xstream.core.util.Primitives;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* Converter that supports the definition of one field member that will be written as value and
* all other field members are written as attributes. The converter requires that all the field
* types (expect the one with the value) are handled by a {@link SingleValueConverter}. The
* value field is defined using the name of the type that declares the field and the field name
* itself. Therefore it is possible to define an inherited field as value. It is also possible
* to provide no value field at all, so that all fields are written as attributes.
*
* @author Jörg Schaible
* @since 1.4
*/
public class ToAttributedValueConverter implements Converter {
private final Class type;
private final Mapper mapper;
private final ReflectionProvider reflectionProvider;
private final ConverterLookup lookup;
private final Field valueField;
/**
* Creates a new ToAttributedValueConverter instance.
*
* @param mapper the mapper in use
* @param reflectionProvider the reflection provider in use
* @param lookup the converter lookup in use
* @param valueFieldName the field defining the tag's value (may be null)
*/
public ToAttributedValueConverter(
final Class type, final Mapper mapper, final ReflectionProvider reflectionProvider,
final ConverterLookup lookup, final String valueFieldName) {
this(type, mapper, reflectionProvider, lookup, valueFieldName, null);
}
/**
* Creates a new ToAttributedValueConverter instance.
*
* @param mapper the mapper in use
* @param reflectionProvider the reflection provider in use
* @param lookup the converter lookup in use
* @param valueFieldName the field defining the tag's value (may be null)
* @param valueDefinedIn the type defining the field
*/
public ToAttributedValueConverter(
final Class type, final Mapper mapper, final ReflectionProvider reflectionProvider,
final ConverterLookup lookup, final String valueFieldName, Class valueDefinedIn) {
this.type = type;
this.mapper = mapper;
this.reflectionProvider = reflectionProvider;
this.lookup = lookup;
if (valueFieldName == null) {
valueField = null;
} else {
Field field = null;
try {
field = (valueDefinedIn != null ? valueDefinedIn : type)
.getDeclaredField(valueFieldName);
if (!field.isAccessible()) {
field.setAccessible(true);
}
} catch (NoSuchFieldException e) {
throw new IllegalArgumentException(e.getMessage() + ": " + valueFieldName);
}
this.valueField = field;
}
}
public boolean canConvert(final Class type) {
return this.type == type;
}
public void marshal(final Object source, final HierarchicalStreamWriter writer,
final MarshallingContext context) {
final Class sourceType = source.getClass();
final Map defaultFieldDefinition = new HashMap();
final String[] tagValue = new String[1];
final Object[] realValue = new Object[1];
final Class[] fieldType = new Class[1];
final Class[] definingType = new Class[1];
reflectionProvider.visitSerializableFields(source, new ReflectionProvider.Visitor() {
public void visit(final String fieldName, final Class type, final Class definedIn,
final Object value) {
if (!mapper.shouldSerializeMember(definedIn, fieldName)) {
return;
}
final FastField field = new FastField(definedIn, fieldName);
final String alias = mapper.serializedMember(definedIn, fieldName);
if (!defaultFieldDefinition.containsKey(alias)) {
final Class lookupType = sourceType;
defaultFieldDefinition.put(
alias, reflectionProvider.getField(lookupType, fieldName));
} else if (!fieldIsEqual(field)) {
final ConversionException exception = new ConversionException(
"Cannot write attribute twice for object");
exception.add("alias", alias);
exception.add("type", sourceType.getName());
throw exception;
}
Converter converter = mapper.getLocalConverter(definedIn, fieldName);
if (converter == null) {
converter = lookup.lookupConverterForType(type);
}
if (value != null) {
if (converter instanceof SingleValueConverter) {
final String str = ((SingleValueConverter)converter).toString(value);
if (valueField != null && fieldIsEqual(field)) {
definingType[0] = definedIn;
fieldType[0] = type;
realValue[0] = value;
tagValue[0] = str;
} else {
if (str != null) {
writer.addAttribute(alias, str);
}
}
} else {
context.convertAnother(value);
}
}
}
});
if (tagValue[0] != null) {
final Class actualType = realValue[0].getClass();
final Class defaultType = mapper.defaultImplementationOf(fieldType[0]);
if (!actualType.equals(defaultType)) {
final String serializedClassName = mapper.serializedClass(actualType);
if (!serializedClassName.equals(mapper.serializedClass(defaultType))) {
final String attributeName = mapper.aliasForSystemAttribute("class");
if (attributeName != null) {
writer.addAttribute(attributeName, serializedClassName);
}
}
}
writer.setValue(tagValue[0]);
}
}
public Object unmarshal(final HierarchicalStreamReader reader,
final UnmarshallingContext context) {
final Object result = reflectionProvider.newInstance(context.getRequiredType());
final Class resultType = result.getClass();
final Set seenFields = new HashSet();
final Iterator it = reader.getAttributeNames();
final Set systemAttributes = new HashSet();
systemAttributes.add(mapper.aliasForSystemAttribute("class"));
// Process attributes before recursing into child elements.
while (it.hasNext()) {
final String attrName = (String)it.next();
if (systemAttributes.contains(attrName)) {
continue;
}
final String fieldName = mapper.realMember(resultType, attrName);
final boolean fieldExistsInClass = reflectionProvider.fieldDefinedInClass(
fieldName, resultType);
if (fieldExistsInClass) {
final Field field = reflectionProvider.getField(resultType, fieldName);
if (Modifier.isTransient(field.getModifiers())) {
continue;
}
Class type = field.getType();
final Class declaringClass = field.getDeclaringClass();
Converter converter = mapper.getLocalConverter(declaringClass, fieldName);
if (converter == null) {
converter = lookup.lookupConverterForType(type);
}
if (!(converter instanceof SingleValueConverter)) {
final ConversionException exception = new ConversionException(
"Cannot read field as a single value for object");
exception.add("field", fieldName);
exception.add("type", resultType.getName());
throw exception;
}
if (converter != null) {
final Object value = ((SingleValueConverter)converter).fromString(reader
.getAttribute(attrName));
if (type.isPrimitive()) {
type = Primitives.box(type);
}
if (value != null && !type.isAssignableFrom(value.getClass())) {
final ConversionException exception = new ConversionException(
"Cannot assign object to type");
exception.add("object type", value.getClass().getName());
exception.add("target type", type.getName());
throw exception;
}
reflectionProvider.writeField(result, fieldName, value, declaringClass);
if (!seenFields.add(new FastField(declaringClass, fieldName))) {
throw new DuplicateFieldException(fieldName
+ " ["
+ declaringClass.getName()
+ "]");
}
}
}
}
if (valueField != null) {
final Class classDefiningField = valueField.getDeclaringClass();
final String fieldName = valueField.getName();
if (fieldName == null
|| !reflectionProvider.fieldDefinedInClass(fieldName, resultType)) {
final ConversionException exception = new ConversionException(
"Cannot assign value to field of type");
exception.add("element", reader.getNodeName());
exception.add("field", fieldName);
exception.add("target type", context.getRequiredType().getName());
throw exception;
}
Class type;
final String classAttribute = HierarchicalStreams
.readClassAttribute(reader, mapper);
if (classAttribute != null) {
type = mapper.realClass(classAttribute);
} else {
type = mapper.defaultImplementationOf(reflectionProvider.getFieldType(
result, fieldName, classDefiningField));
}
final Field field = reflectionProvider.getField(classDefiningField, fieldName);
final Object value = context.convertAnother(
result, type,
mapper.getLocalConverter(field.getDeclaringClass(), field.getName()));
final Class definedType = reflectionProvider.getFieldType(
result, fieldName, classDefiningField);
if (!definedType.isPrimitive()) {
type = definedType;
}
if (value != null && !type.isAssignableFrom(value.getClass())) {
final ConversionException exception = new ConversionException(
"Cannot assign object to type");
exception.add("object type", value.getClass().getName());
exception.add("target type", type.getName());
throw exception;
}
reflectionProvider.writeField(result, fieldName, value, classDefiningField);
if (!seenFields.add(new FastField(classDefiningField, fieldName))) {
throw new DuplicateFieldException(fieldName
+ " ["
+ classDefiningField.getName()
+ "]");
}
}
return result;
}
private boolean fieldIsEqual(FastField field) {
return valueField.getName().equals(field.getName())
&& valueField.getDeclaringClass().getName().equals(field.getDeclaringClass());
}
}
././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/DynamicProxyConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Dynami0000664 0001750 0001750 00000011105 12206661545 034465 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2010 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 25. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.core.util.Fields;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.DynamicProxyMapper;
import com.thoughtworks.xstream.mapper.Mapper;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
import java.util.ArrayList;
import java.util.List;
/**
* Converts a dynamic proxy to XML, storing the implemented
* interfaces and handler.
*
* @author Joe Walnes
*/
public class DynamicProxyConverter implements Converter {
private ClassLoader classLoader;
private Mapper mapper;
private static final Field HANDLER;
private static final InvocationHandler DUMMY = new InvocationHandler() {
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
return null;
}
};
static {
Field field = null;
try {
field = Proxy.class.getDeclaredField("h");
field.setAccessible(true);
} catch (NoSuchFieldException e) {
throw new ExceptionInInitializerError(e);
}
HANDLER = field;
}
public DynamicProxyConverter(Mapper mapper) {
this(mapper, DynamicProxyConverter.class.getClassLoader());
}
public DynamicProxyConverter(Mapper mapper, ClassLoader classLoader) {
this.classLoader = classLoader;
this.mapper = mapper;
}
public boolean canConvert(Class type) {
return type.equals(DynamicProxyMapper.DynamicProxy.class) || Proxy.isProxyClass(type);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
InvocationHandler invocationHandler = Proxy.getInvocationHandler(source);
addInterfacesToXml(source, writer);
writer.startNode("handler");
String attributeName = mapper.aliasForSystemAttribute("class");
if (attributeName != null) {
writer.addAttribute(attributeName, mapper.serializedClass(invocationHandler.getClass()));
}
context.convertAnother(invocationHandler);
writer.endNode();
}
private void addInterfacesToXml(Object source, HierarchicalStreamWriter writer) {
Class[] interfaces = source.getClass().getInterfaces();
for (int i = 0; i < interfaces.length; i++) {
Class currentInterface = interfaces[i];
writer.startNode("interface");
writer.setValue(mapper.serializedClass(currentInterface));
writer.endNode();
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
List interfaces = new ArrayList();
InvocationHandler handler = null;
Class handlerType = null;
while (reader.hasMoreChildren()) {
reader.moveDown();
String elementName = reader.getNodeName();
if (elementName.equals("interface")) {
interfaces.add(mapper.realClass(reader.getValue()));
} else if (elementName.equals("handler")) {
String attributeName = mapper.aliasForSystemAttribute("class");
if (attributeName != null) {
handlerType = mapper.realClass(reader.getAttribute(attributeName));
break;
}
}
reader.moveUp();
}
if (handlerType == null) {
throw new ConversionException("No InvocationHandler specified for dynamic proxy");
}
Class[] interfacesAsArray = new Class[interfaces.size()];
interfaces.toArray(interfacesAsArray);
Object proxy = Proxy.newProxyInstance(classLoader, interfacesAsArray, DUMMY);
handler = (InvocationHandler) context.convertAnother(proxy, handlerType);
reader.moveUp();
Fields.write(HANDLER, proxy, handler);
return proxy;
}
}
././@LongLink 0000644 0000000 0000000 00000000205 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ISO8601GregorianCalendarConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ISO8600000664 0001750 0001750 00000011107 12206661545 034136 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 03. October 2005 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import org.joda.time.DateTime;
import org.joda.time.DateTimeZone;
import org.joda.time.format.DateTimeFormatter;
import org.joda.time.format.ISODateTimeFormat;
import java.util.Calendar;
import java.util.GregorianCalendar;
import java.util.Locale;
import java.util.TimeZone;
/**
* A GregorianCalendarConverter conforming to the ISO8601 standard. The converter will always
* serialize the calendar value in UTC and deserialize it to a value in the current default time
* zone.
*
* @author Mauro Talevi
* @author Jörg Schaible
* @see "http://www.iso.org/iso/catalogue_detail?csnumber=40874"
* @since 1.1.3
*/
public class ISO8601GregorianCalendarConverter extends AbstractSingleValueConverter {
private static final DateTimeFormatter[] formattersUTC = new DateTimeFormatter[]{
ISODateTimeFormat.dateTime(),
ISODateTimeFormat.dateTimeNoMillis(),
ISODateTimeFormat.basicDateTime(),
ISODateTimeFormat.basicOrdinalDateTime(),
ISODateTimeFormat.basicOrdinalDateTimeNoMillis(),
ISODateTimeFormat.basicTime(),
ISODateTimeFormat.basicTimeNoMillis(),
ISODateTimeFormat.basicTTime(),
ISODateTimeFormat.basicTTimeNoMillis(),
ISODateTimeFormat.basicWeekDateTime(),
ISODateTimeFormat.basicWeekDateTimeNoMillis(),
ISODateTimeFormat.ordinalDateTime(),
ISODateTimeFormat.ordinalDateTimeNoMillis(),
ISODateTimeFormat.time(),
ISODateTimeFormat.timeNoMillis(),
ISODateTimeFormat.tTime(),
ISODateTimeFormat.tTimeNoMillis(),
ISODateTimeFormat.weekDateTime(),
ISODateTimeFormat.weekDateTimeNoMillis()
};
private static final DateTimeFormatter[] formattersNoUTC = new DateTimeFormatter[]{
ISODateTimeFormat.basicDate(),
ISODateTimeFormat.basicOrdinalDate(),
ISODateTimeFormat.basicWeekDate(),
ISODateTimeFormat.date(),
ISODateTimeFormat.dateHour(),
ISODateTimeFormat.dateHourMinute(),
ISODateTimeFormat.dateHourMinuteSecond(),
ISODateTimeFormat.dateHourMinuteSecondFraction(),
ISODateTimeFormat.dateHourMinuteSecondMillis(),
ISODateTimeFormat.hour(),
ISODateTimeFormat.hourMinute(),
ISODateTimeFormat.hourMinuteSecond(),
ISODateTimeFormat.hourMinuteSecondFraction(),
ISODateTimeFormat.hourMinuteSecondMillis(),
ISODateTimeFormat.ordinalDate(),
ISODateTimeFormat.weekDate(),
ISODateTimeFormat.year(),
ISODateTimeFormat.yearMonth(),
ISODateTimeFormat.yearMonthDay(),
ISODateTimeFormat.weekyear(),
ISODateTimeFormat.weekyearWeek(),
ISODateTimeFormat.weekyearWeekDay()
};
public boolean canConvert(Class type) {
return type.equals(GregorianCalendar.class);
}
public Object fromString(String str) {
for (int i = 0; i < formattersUTC.length; i++ ) {
DateTimeFormatter formatter = formattersUTC[i];
try {
DateTime dt = formatter.parseDateTime(str);
Calendar calendar = dt.toCalendar(Locale.getDefault());
calendar.setTimeZone(TimeZone.getDefault());
return calendar;
} catch (IllegalArgumentException e) {
// try with next formatter
}
}
String timeZoneID = TimeZone.getDefault().getID();
for (int i = 0; i < formattersNoUTC.length; i++ ) {
try {
DateTimeFormatter formatter = formattersNoUTC[i].withZone(DateTimeZone.forID(timeZoneID));
DateTime dt = formatter.parseDateTime(str);
Calendar calendar = dt.toCalendar(Locale.getDefault());
calendar.setTimeZone(TimeZone.getDefault());
return calendar;
} catch (IllegalArgumentException e) {
// try with next formatter
}
}
throw new ConversionException("Cannot parse date " + str);
}
public String toString(Object obj) {
DateTime dt = new DateTime(obj);
return dt.toString(formattersUTC[0]);
}
}
././@LongLink 0000644 0000000 0000000 00000000163 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/LocaleConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Locale0000664 0001750 0001750 00000003551 12206661545 034451 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 24. Julyl 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import java.util.Locale;
/**
* Converts a java.util.Locale to a string.
*
* @author Jose A. Illescas
* @author Joe Walnes
*/
public class LocaleConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(Locale.class);
}
public Object fromString(String str) {
int[] underscorePositions = underscorePositions(str);
String language, country, variant;
if (underscorePositions[0] == -1) { // "language"
language = str;
country = "";
variant = "";
} else if (underscorePositions[1] == -1) { // "language_country"
language = str.substring(0, underscorePositions[0]);
country = str.substring(underscorePositions[0] + 1);
variant = "";
} else { // "language_country_variant"
language = str.substring(0, underscorePositions[0]);
country = str.substring(underscorePositions[0] + 1, underscorePositions[1]);
variant = str.substring(underscorePositions[1] + 1);
}
return new Locale(language, country, variant);
}
private int[] underscorePositions(String in) {
int[] result = new int[2];
for (int i = 0; i < result.length; i++) {
int last = i == 0 ? 0 : result[i - 1];
result[i] = in.indexOf('_', last + 1);
}
return result;
}
} ././@LongLink 0000644 0000000 0000000 00000000175 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/EncodedByteArrayConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Encode0000664 0001750 0001750 00000006034 12206661545 034446 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2010 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 03. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.converters.basic.ByteConverter;
import com.thoughtworks.xstream.core.util.Base64Encoder;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
/**
* Converts a byte array to a single Base64 encoding string.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class EncodedByteArrayConverter implements Converter, SingleValueConverter {
private static final Base64Encoder base64 = new Base64Encoder();
private static final ByteConverter byteConverter = new ByteConverter();
public boolean canConvert(Class type) {
return type.isArray() && type.getComponentType().equals(byte.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
writer.setValue(toString(source));
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
String data = reader.getValue(); // needs to be called before hasMoreChildren.
if (!reader.hasMoreChildren()) {
return fromString(data);
} else {
// backwards compatibility ... try to unmarshal byte arrays that haven't been encoded
return unmarshalIndividualByteElements(reader, context);
}
}
private Object unmarshalIndividualByteElements(HierarchicalStreamReader reader, UnmarshallingContext context) {
List bytes = new ArrayList(); // have to create a temporary list because don't know the size of the array
boolean firstIteration = true;
while (firstIteration || reader.hasMoreChildren()) { // hangover from previous hasMoreChildren
reader.moveDown();
bytes.add(byteConverter.fromString(reader.getValue()));
reader.moveUp();
firstIteration = false;
}
// copy into real array
byte[] result = new byte[bytes.size()];
int i = 0;
for (Iterator iterator = bytes.iterator(); iterator.hasNext();) {
Byte b = (Byte) iterator.next();
result[i] = b.byteValue();
i++;
}
return result;
}
public String toString(Object obj) {
return base64.encode((byte[]) obj);
}
public Object fromString(String str) {
return base64.decode(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/CharsetConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Charse0000664 0001750 0001750 00000001670 12206661545 034457 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 07. April 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import java.nio.charset.Charset;
/**
* Converts a java.nio.charset.Carset to a string.
*
* @author Jörg Schaible
* @since 1.2
*/
public class CharsetConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return Charset.class.isAssignableFrom(type);
}
public String toString(Object obj) {
return obj == null ? null : ((Charset)obj).name();
}
public Object fromString(String str) {
return Charset.forName(str);
}
} ././@LongLink 0000644 0000000 0000000 00000000170 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/LookAndFeelConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/LookAn0000664 0001750 0001750 00000002660 12206661545 034435 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008 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 08.12.2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.reflection.ReflectionConverter;
import com.thoughtworks.xstream.converters.reflection.ReflectionProvider;
import com.thoughtworks.xstream.mapper.Mapper;
import javax.swing.LookAndFeel;
import java.io.NotSerializableException;
/**
* A converter for Swing LookAndFeel implementations. The JDK's implementations are serializable
* for historical reasons but will throw a {@link NotSerializableException} in their writeObject
* method. Therefore XStream will use an implementation based on the ReflectionConverter.
*
* @author Jörg Schaible
* @since 1.3
*/
public class LookAndFeelConverter extends ReflectionConverter {
/**
* Constructs a LookAndFeelConverter.
*
* @param mapper the mapper
* @param reflectionProvider the reflection provider
* @since 1.3
*/
public LookAndFeelConverter(Mapper mapper, ReflectionProvider reflectionProvider) {
super(mapper, reflectionProvider);
}
public boolean canConvert(Class type) {
return LookAndFeel.class.isAssignableFrom(type);
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SqlDateConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SqlDat0000664 0001750 0001750 00000001462 12206661545 034441 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 24. July 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import java.sql.Date;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
/**
* Converts a java.sql.Date to text.
*
* @author Jose A. Illescas
*/
public class SqlDateConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(Date.class);
}
public Object fromString(String str) {
return Date.valueOf(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/package.html jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/packag0000664 0001750 0001750 00000000650 12206661545 034475 0 ustar jamespage jamespage
Extra converters that may not be enabled in XStream by default.
././@LongLink 0000644 0000000 0000000 00000000170 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ISO8601DateConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ISO8600000664 0001750 0001750 00000002132 12206661545 034134 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 22. November 2004 by Mauro Talevi
*/
package com.thoughtworks.xstream.converters.extended;
import java.util.Calendar;
import java.util.Date;
/**
* A DateConverter conforming to the ISO8601 standard.
* http://www.iso.ch/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=26780
*
* @author Mauro Talevi
* @author Jörg Schaible
*/
public class ISO8601DateConverter extends ISO8601GregorianCalendarConverter {
public boolean canConvert(Class type) {
return type.equals(Date.class);
}
public Object fromString(String str) {
return ((Calendar)super.fromString(str)).getTime();
}
public String toString(Object obj) {
Calendar calendar = Calendar.getInstance();
calendar.setTime((Date)obj);
return super.toString(calendar);
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SqlTimeConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SqlTim0000664 0001750 0001750 00000001550 12206661545 034460 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 24. July 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import java.sql.Time;
/**
* Converts a java.sql.Time to text. Warning: Any granularity smaller than seconds is lost.
*
* @author Jose A. Illescas
*/
public class SqlTimeConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(Time.class);
}
public Object fromString(String str) {
return Time.valueOf(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000176 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/GregorianCalendarConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Gregor0000664 0001750 0001750 00000005224 12206661545 034476 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008 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 24. July 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.TimeZone;
/**
* Converts a java.util.GregorianCalendar to XML. Note that although it currently only contains one field, it nests
* it inside a child element, to allow for other fields to be stored in the future.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class GregorianCalendarConverter implements Converter {
public boolean canConvert(Class type) {
return type.equals(GregorianCalendar.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
GregorianCalendar calendar = (GregorianCalendar) source;
ExtendedHierarchicalStreamWriterHelper.startNode(writer, "time", long.class);
long timeInMillis = calendar.getTime().getTime(); // calendar.getTimeInMillis() not available under JDK 1.3
writer.setValue(String.valueOf(timeInMillis));
writer.endNode();
ExtendedHierarchicalStreamWriterHelper.startNode(writer, "timezone", String.class);
writer.setValue(calendar.getTimeZone().getID());
writer.endNode();
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
reader.moveDown();
long timeInMillis = Long.parseLong(reader.getValue());
reader.moveUp();
final String timeZone;
if (reader.hasMoreChildren()) {
reader.moveDown();
timeZone = reader.getValue();
reader.moveUp();
} else { // backward compatibility to XStream 1.1.2 and below
timeZone = TimeZone.getDefault().getID();
}
GregorianCalendar result = new GregorianCalendar();
result.setTimeZone(TimeZone.getTimeZone(timeZone));
result.setTime(new Date(timeInMillis)); // calendar.setTimeInMillis() not available under JDK 1.3
return result;
}
}
././@LongLink 0000644 0000000 0000000 00000000165 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/CurrencyConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Curren0000664 0001750 0001750 00000001766 12206661545 034516 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 24. July 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import java.util.Currency;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
/**
* Converts a java.util.Currency to String. Despite the name of this class, it has nothing to do with converting
* currencies between exchange rates! It makes sense in the context of XStream.
*
* @author Jose A. Illescas
* @author Joe Walnes
*/
public class CurrencyConverter extends AbstractSingleValueConverter {
public boolean canConvert(Class type) {
return type.equals(Currency.class);
}
public Object fromString(String str) {
return Currency.getInstance(str);
}
}
././@LongLink 0000644 0000000 0000000 00000000200 12260544303 011631 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ISO8601SqlTimestampConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ISO8600000664 0001750 0001750 00000003713 12206661545 034142 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 03. October 2005 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import java.sql.Timestamp;
import java.util.Date;
/**
* A SqlTimestampConverter conforming to the ISO8601 standard.
* http://www.iso.ch/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=26780
*
* @author Jörg Schaible
* @since 1.1.3
*/
public class ISO8601SqlTimestampConverter extends ISO8601DateConverter {
private final static String PADDING = "000000000";
public boolean canConvert(Class type) {
return type.equals(Timestamp.class);
}
public Object fromString(String str) {
final int idxFraction = str.lastIndexOf('.');
int nanos = 0;
if (idxFraction > 0) {
int idx;
for (idx = idxFraction + 1; Character.isDigit(str.charAt(idx)); ++idx)
;
nanos = Integer.parseInt(str.substring(idxFraction + 1, idx));
str = str.substring(0, idxFraction) + str.substring(idx);
}
final Date date = (Date)super.fromString(str);
final Timestamp timestamp = new Timestamp(date.getTime());
timestamp.setNanos(nanos);
return timestamp;
}
public String toString(Object obj) {
final Timestamp timestamp = (Timestamp)obj;
String str = super.toString(new Date((timestamp.getTime() / 1000) * 1000));
final String nanos = String.valueOf(timestamp.getNanos());
final int idxFraction = str.lastIndexOf('.');
str = str.substring(0, idxFraction + 1)
+ PADDING.substring(nanos.length())
+ nanos
+ str.substring(idxFraction + 4);
return str;
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/FontConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/FontCo0000664 0001750 0001750 00000003667 12206661545 034452 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 08. July 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import javax.swing.plaf.FontUIResource;
import java.awt.Font;
import java.util.Map;
public class FontConverter implements Converter {
public boolean canConvert(Class type) {
// String comparison is used here because Font.class loads the class which in turns instantiates AWT,
// which is nasty if you don't want it.
return type.getName().equals("java.awt.Font") || type.getName().equals("javax.swing.plaf.FontUIResource");
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Font font = (Font) source;
Map attributes = font.getAttributes();
writer.startNode("attributes"); //
context.convertAnother(attributes);
writer.endNode(); //
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
reader.moveDown(); // into
Map attributes = (Map) context.convertAnother(null, Map.class);
reader.moveUp(); // out of
Font font = Font.getFont(attributes);
if (context.getRequiredType() == FontUIResource.class) {
return new FontUIResource(font);
} else {
return font;
}
}
}
././@LongLink 0000644 0000000 0000000 00000000172 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/TextAttributeConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/TextAt0000664 0001750 0001750 00000001575 12206661545 034467 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 25. March 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.reflection.AbstractAttributedCharacterIteratorAttributeConverter;
import java.awt.font.TextAttribute;
/**
* A converter for {@link TextAttribute} constants.
*
* @author Jörg Schaible
* @since 1.2
*/
public class TextAttributeConverter extends
AbstractAttributedCharacterIteratorAttributeConverter {
/**
* Constructs a TextAttributeConverter.
*
* @since 1.2.2
*/
public TextAttributeConverter() {
super(TextAttribute.class);
}
}
././@LongLink 0000644 0000000 0000000 00000000162 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ColorConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/ColorC0000664 0001750 0001750 00000004673 12206661545 034441 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 01. October 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriterHelper;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.awt.Color;
import java.util.HashMap;
import java.util.Map;
/**
* Converts a java.awt.Color to XML, using four nested elements:
* red, green, blue, alpha.
*
* @author Joe Walnes
*/
public class ColorConverter implements Converter {
public boolean canConvert(Class type) {
// String comparison is used here because Color.class loads the class which in turns instantiates AWT,
// which is nasty if you don't want it.
return type.getName().equals("java.awt.Color");
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Color color = (Color) source;
write("red", color.getRed(), writer);
write("green", color.getGreen(), writer);
write("blue", color.getBlue(), writer);
write("alpha", color.getAlpha(), writer);
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Map elements = new HashMap();
while (reader.hasMoreChildren()) {
reader.moveDown();
elements.put(reader.getNodeName(), Integer.valueOf(reader.getValue()));
reader.moveUp();
}
return new Color(((Integer) elements.get("red")).intValue(),
((Integer) elements.get("green")).intValue(),
((Integer) elements.get("blue")).intValue(),
((Integer) elements.get("alpha")).intValue());
}
private void write(String fieldName, int value, HierarchicalStreamWriter writer) {
ExtendedHierarchicalStreamWriterHelper.startNode(writer, fieldName, int.class);
writer.setValue(String.valueOf(value));
writer.endNode();
}
}
././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/RegexPatternConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/RegexP0000664 0001750 0001750 00000003033 12206661545 034437 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 31. July 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.util.regex.Pattern;
/**
* Ensures java.util.regex.Pattern is compiled upon deserialization.
*/
public class RegexPatternConverter implements Converter {
private Converter defaultConverter;
public RegexPatternConverter(Converter defaultConverter) {
this.defaultConverter = defaultConverter;
}
public boolean canConvert(final Class type) {
return type.equals(Pattern.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
defaultConverter.marshal(source, writer, context);
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Pattern notCompiled = (Pattern) defaultConverter.unmarshal(reader, context);
return Pattern.compile(notCompiled.pattern(), notCompiled.flags());
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SubjectConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Subjec0000664 0001750 0001750 00000010556 12206661545 034470 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 12. January 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.converters.collections.AbstractCollectionConverter;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import javax.security.auth.Subject;
import java.util.Collections;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Set;
/**
* Converts a {@link Subject} instance. Note, that this Converter does only convert the contained Principals as
* it is done by JDK serialization, but not any credentials. For other behaviour you can derive your own converter,
* overload the appropriate methods and register it in the {@link com.thoughtworks.xstream.XStream}.
*
* @author Jörg Schaible
* @since 1.1.3
*/
public class SubjectConverter extends AbstractCollectionConverter {
public SubjectConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return type.equals(Subject.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Subject subject = (Subject) source;
marshalPrincipals(subject.getPrincipals(), writer, context);
marshalPublicCredentials(subject.getPublicCredentials(), writer, context);
marshalPrivateCredentials(subject.getPrivateCredentials(), writer, context);
marshalReadOnly(subject.isReadOnly(), writer);
}
protected void marshalPrincipals(Set principals, HierarchicalStreamWriter writer, MarshallingContext context) {
writer.startNode("principals");
for (final Iterator iter = principals.iterator(); iter.hasNext();) {
final Object principal = iter.next(); // pre jdk 1.4 a Principal was also in javax.security
writeItem(principal, context, writer);
}
writer.endNode();
};
protected void marshalPublicCredentials(Set pubCredentials, HierarchicalStreamWriter writer, MarshallingContext context) {
};
protected void marshalPrivateCredentials(Set privCredentials, HierarchicalStreamWriter writer, MarshallingContext context) {
};
protected void marshalReadOnly(boolean readOnly, HierarchicalStreamWriter writer) {
writer.startNode("readOnly");
writer.setValue(String.valueOf(readOnly));
writer.endNode();
};
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Set principals = unmarshalPrincipals(reader, context);
Set publicCredentials = unmarshalPublicCredentials(reader, context);
Set privateCredentials = unmarshalPrivateCredentials(reader, context);
boolean readOnly = unmarshalReadOnly(reader);
return new Subject(readOnly, principals, publicCredentials, privateCredentials);
}
protected Set unmarshalPrincipals(HierarchicalStreamReader reader, UnmarshallingContext context) {
return populateSet(reader, context);
};
protected Set unmarshalPublicCredentials(HierarchicalStreamReader reader, UnmarshallingContext context) {
return Collections.EMPTY_SET;
};
protected Set unmarshalPrivateCredentials(HierarchicalStreamReader reader, UnmarshallingContext context) {
return Collections.EMPTY_SET;
};
protected boolean unmarshalReadOnly(HierarchicalStreamReader reader) {
reader.moveDown();
boolean readOnly = Boolean.getBoolean(reader.getValue());
reader.moveUp();
return readOnly;
};
protected Set populateSet(HierarchicalStreamReader reader, UnmarshallingContext context) {
Set set = new HashSet();
reader.moveDown();
while (reader.hasMoreChildren()) {
reader.moveDown();
Object elementl = readItem(reader, context, set);
reader.moveUp();
set.add(elementl);
}
reader.moveUp();
return set;
}
}
././@LongLink 0000644 0000000 0000000 00000000167 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/JavaMethodConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/JavaMe0000664 0001750 0001750 00000010360 12206661545 034411 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 04. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.List;
/**
* Converts a java.lang.reflect.Method to XML.
*
* @author Aslak Hellesøy
* @author Jörg Schaible
*/
public class JavaMethodConverter implements Converter {
private final SingleValueConverter javaClassConverter;
public JavaMethodConverter(ClassLoader classLoader) {
this.javaClassConverter = new JavaClassConverter(classLoader);
}
public boolean canConvert(Class type) {
return type.equals(Method.class) || type.equals(Constructor.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
if (source instanceof Method) {
Method method = (Method) source;
String declaringClassName = javaClassConverter.toString(method.getDeclaringClass());
marshalMethod(writer, declaringClassName, method.getName(), method.getParameterTypes());
} else {
Constructor method = (Constructor) source;
String declaringClassName = javaClassConverter.toString(method.getDeclaringClass());
marshalMethod(writer, declaringClassName, null, method.getParameterTypes());
}
}
private void marshalMethod(HierarchicalStreamWriter writer, String declaringClassName, String methodName, Class[] parameterTypes) {
writer.startNode("class");
writer.setValue(declaringClassName);
writer.endNode();
if (methodName != null) {
// it's a method and not a ctor
writer.startNode("name");
writer.setValue(methodName);
writer.endNode();
}
writer.startNode("parameter-types");
for (int i = 0; i < parameterTypes.length; i++) {
writer.startNode("class");
writer.setValue(javaClassConverter.toString(parameterTypes[i]));
writer.endNode();
}
writer.endNode();
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
try {
boolean isMethodNotConstructor = context.getRequiredType().equals(Method.class);
reader.moveDown();
String declaringClassName = reader.getValue();
Class declaringClass = (Class)javaClassConverter.fromString(declaringClassName);
reader.moveUp();
String methodName = null;
if (isMethodNotConstructor) {
reader.moveDown();
methodName = reader.getValue();
reader.moveUp();
}
reader.moveDown();
List parameterTypeList = new ArrayList();
while (reader.hasMoreChildren()) {
reader.moveDown();
String parameterTypeName = reader.getValue();
parameterTypeList.add(javaClassConverter.fromString(parameterTypeName));
reader.moveUp();
}
Class[] parameterTypes = (Class[]) parameterTypeList.toArray(new Class[parameterTypeList.size()]);
reader.moveUp();
if (isMethodNotConstructor) {
return declaringClass.getDeclaredMethod(methodName, parameterTypes);
} else {
return declaringClass.getDeclaredConstructor(parameterTypes);
}
} catch (NoSuchMethodException e) {
throw new ConversionException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SqlTimestampConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/SqlTim0000664 0001750 0001750 00000004675 12206661545 034473 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2012 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 01. October 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
import com.thoughtworks.xstream.core.util.ThreadSafeSimpleDateFormat;
import java.sql.Timestamp;
import java.text.ParseException;
import java.util.TimeZone;
/**
* Converts a java.sql.Timestamp to text.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class SqlTimestampConverter extends AbstractSingleValueConverter {
private final ThreadSafeSimpleDateFormat format = new ThreadSafeSimpleDateFormat(
"yyyy-MM-dd HH:mm:ss", TimeZone.getTimeZone("UTC"), 0, 5, false);
public boolean canConvert(Class type) {
return type.equals(Timestamp.class);
}
public String toString(Object obj) {
Timestamp timestamp = (Timestamp)obj;
StringBuffer buffer = new StringBuffer(format.format(timestamp)).append('.');
if (timestamp.getNanos() == 0) {
buffer.append('0');
} else {
String nanos = String.valueOf(timestamp.getNanos() + 1000000000);
int last = 10;
while (last > 2 && nanos.charAt(last-1) == '0')
--last;
buffer.append(nanos.subSequence(1, last));
}
return buffer.toString();
}
public Object fromString(String str) {
int idx = str.lastIndexOf('.');
if (idx < 0 || str.length() - idx < 2 || str.length() - idx > 10) {
throw new IllegalArgumentException(
"Timestamp format must be yyyy-mm-dd hh:mm:ss[.fffffffff]");
}
try {
Timestamp timestamp = new Timestamp(format.parse(str.substring(0, idx)).getTime());
StringBuffer buffer = new StringBuffer(str.substring(idx + 1));
while(buffer.length() != 9) {
buffer.append('0');
}
timestamp.setNanos(Integer.parseInt(buffer.toString()));
return timestamp;
} catch (ParseException e) {
throw new IllegalArgumentException(
"Timestamp format must be yyyy-mm-dd hh:mm:ss[.fffffffff]");
}
}
}
././@LongLink 0000644 0000000 0000000 00000000176 12260544303 011645 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/StackTraceElementConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/StackT0000664 0001750 0001750 00000005240 12206661545 034440 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
/**
* Converter for StackTraceElement (the lines of a stack trace) - JDK 1.4+ only.
*
* @author B. K. Oxley (binkley)
* @author Joe Walnes
*/
public class StackTraceElementConverter extends AbstractSingleValueConverter {
// Regular expression to parse a line of a stack trace. Returns 4 groups.
//
// Example: com.blah.MyClass.doStuff(MyClass.java:123)
// |-------1------| |--2--| |----3-----| |4|
// (Note group 4 is optional is optional and only present if a colon char exists.)
private static final Pattern PATTERN = Pattern.compile("^(.+)\\.([^\\(]+)\\(([^:]*)(:(\\d+))?\\)$");
private static final StackTraceElementFactory FACTORY = new StackTraceElementFactory();
public boolean canConvert(Class type) {
return StackTraceElement.class.equals(type);
}
public String toString(Object obj) {
String s = super.toString(obj);
// JRockit adds ":???" for invalid line number
return s.replaceFirst(":\\?\\?\\?", "");
}
public Object fromString(String str) {
Matcher matcher = PATTERN.matcher(str);
if (matcher.matches()) {
String declaringClass = matcher.group(1);
String methodName = matcher.group(2);
String fileName = matcher.group(3);
if (fileName.equals("Unknown Source")) {
return FACTORY.unknownSourceElement(declaringClass, methodName);
} else if (fileName.equals("Native Method")) {
return FACTORY.nativeMethodElement(declaringClass, methodName);
} else {
if (matcher.group(4) != null) {
int lineNumber = Integer.parseInt(matcher.group(5));
return FACTORY.element(declaringClass, methodName, fileName, lineNumber);
} else {
return FACTORY.element(declaringClass, methodName, fileName);
}
}
} else {
throw new ConversionException("Could not parse StackTraceElement : " + str);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000174 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/StackTraceElementFactory.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/StackT0000664 0001750 0001750 00000004277 12206661545 034451 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 30. May 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import java.lang.reflect.Field;
/**
* Factory for creating StackTraceElements.
* Factory for creating StackTraceElements.
*
* @author B. K. Oxley (binkley)
* @author Joe Walnes
*/
public class StackTraceElementFactory {
public StackTraceElement nativeMethodElement(String declaringClass, String methodName) {
return create(declaringClass, methodName, "Native Method", -2);
}
public StackTraceElement unknownSourceElement(String declaringClass, String methodName) {
return create(declaringClass, methodName, "Unknown Source", -1);
}
public StackTraceElement element(String declaringClass, String methodName, String fileName) {
return create(declaringClass, methodName, fileName, -1);
}
public StackTraceElement element(String declaringClass, String methodName, String fileName, int lineNumber) {
return create(declaringClass, methodName, fileName, lineNumber);
}
private StackTraceElement create(String declaringClass, String methodName, String fileName, int lineNumber) {
StackTraceElement result = new Throwable().getStackTrace()[0];
setField(result, "declaringClass", declaringClass);
setField(result, "methodName", methodName);
setField(result, "fileName", fileName);
setField(result, "lineNumber", new Integer(lineNumber));
return result;
}
private void setField(StackTraceElement element, String fieldName, Object value) {
try {
final Field field = StackTraceElement.class.getDeclaredField(fieldName);
field.setAccessible(true);
field.set(element, value);
} catch (Exception e) {
throw new ConversionException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/JavaFieldConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/JavaFi0000664 0001750 0001750 00000004733 12206661545 034415 0 ustar jamespage jamespage /*
* Copyright (C) 2009 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 17. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import java.lang.reflect.Field;
/**
* Converts a java.lang.reflect.Field to XML.
*
* @author Jörg Schaible
*/
public class JavaFieldConverter implements Converter {
private final SingleValueConverter javaClassConverter;
public JavaFieldConverter(ClassLoader classLoader) {
this.javaClassConverter = new JavaClassConverter(classLoader);
}
public boolean canConvert(Class type) {
return type.equals(Field.class);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Field field = (Field) source;
writer.startNode("name");
writer.setValue(field.getName());
writer.endNode();
writer.startNode("clazz");
writer.setValue(javaClassConverter.toString(field.getDeclaringClass()));
writer.endNode();
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
String methodName = null;
String declaringClassName = null;
while((methodName == null || declaringClassName == null) && reader.hasMoreChildren()) {
reader.moveDown();
if (reader.getNodeName().equals("name")) {
methodName = reader.getValue();
} else if (reader.getNodeName().equals("clazz")) {
declaringClassName = reader.getValue();
}
reader.moveUp();
}
Class declaringClass = (Class)javaClassConverter.fromString(declaringClassName);
try {
return declaringClass.getDeclaredField(methodName);
} catch (NoSuchFieldException e) {
throw new ConversionException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000202 12260544303 011633 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/PropertyEditorCapableConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/extended/Proper0000664 0001750 0001750 00000002631 12206661545 034517 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008 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 20.09.2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.extended;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.core.util.ThreadSafePropertyEditor;
import java.beans.PropertyEditor;
/**
* A SingleValueConverter that can utilize a {@link PropertyEditor} implementation used for a
* specific type. The converter ensures that the editors can be used concurrently.
*
* @author Jukka Lindström
* @author Jörg Schaible
* @since 1.3
*/
public class PropertyEditorCapableConverter implements SingleValueConverter {
private final ThreadSafePropertyEditor editor;
private final Class type;
public PropertyEditorCapableConverter(final Class propertyEditorType, final Class type) {
this.type = type;
editor = new ThreadSafePropertyEditor(propertyEditorType, 2, 5);
}
public boolean canConvert(final Class type) {
return this.type == type;
}
public Object fromString(final String str) {
return editor.setAsText(str);
}
public String toString(final Object obj) {
return editor.getAsText(obj);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/ 0000775 0001750 0001750 00000000000 12206661545 032652 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumConve0000664 0001750 0001750 00000004122 12206661545 034473 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 18. March 2005 by Joe Walnes
*/
// ***** READ THIS *****
// This class will only compile with JDK 1.5.0 or above as it test Java enums.
// If you are using an earlier version of Java, just don't try to build this class. XStream should work fine without it.
package com.thoughtworks.xstream.converters.enums;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
/**
* Converter for JDK 1.5 enums. Combined with EnumMapper this also deals with polymorphic enums.
*
* @author Eric Snell
* @author Bryan Coleman
*/
public class EnumConverter implements Converter {
public boolean canConvert(Class type) {
return type.isEnum() || Enum.class.isAssignableFrom(type);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
writer.setValue(((Enum) source).name());
}
@SuppressWarnings("unchecked")
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
Class type = context.getRequiredType();
if (type.getSuperclass() != Enum.class) {
type = type.getSuperclass(); // polymorphic enums
}
String name = reader.getValue();
try {
return Enum.valueOf(type, name);
} catch (IllegalArgumentException e) {
// failed to find it, do a case insensitive match
for (Enum c : (Enum[])type.getEnumConstants())
if (c.name().equalsIgnoreCase(name))
return c;
// all else failed
throw e;
}
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumMapConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumMapCo0000664 0001750 0001750 00000006772 12206661545 034435 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 06. April 2005 by Joe Walnes
*/
// ***** READ THIS *****
// This class will only compile with JDK 1.5.0 or above as it test Java enums.
// If you are using an earlier version of Java, just don't try to build this class. XStream should work fine without it.
package com.thoughtworks.xstream.converters.enums;
import com.thoughtworks.xstream.converters.collections.MapConverter;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.mapper.Mapper;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.core.util.Fields;
import java.util.EnumMap;
import java.lang.reflect.Field;
/**
* Serializes an Java 5 EnumMap, including the type of Enum it's for. If a SecurityManager is set, the converter will only work with permissions
* for SecurityManager.checkPackageAccess, SecurityManager.checkMemberAccess(this, EnumSet.MEMBER)
* and ReflectPermission("suppressAccessChecks").
*
* @author Joe Walnes
*/
public class EnumMapConverter extends MapConverter {
private final static Field typeField;
static {
// field name is "keyType" in Sun JDK, but different in IKVM
Field assumedTypeField = null;
try {
Field[] fields = EnumMap.class.getDeclaredFields();
for (int i = 0; i < fields.length; i++ ) {
if (fields[i].getType() == Class.class) {
// take the fist member of type "Class"
assumedTypeField = fields[i];
assumedTypeField.setAccessible(true);
break;
}
}
if (assumedTypeField == null) {
throw new ExceptionInInitializerError("Cannot detect key type of EnumMap");
}
} catch (SecurityException ex) {
// ignore, no access possible with current SecurityManager
}
typeField = assumedTypeField;
}
public EnumMapConverter(Mapper mapper) {
super(mapper);
}
public boolean canConvert(Class type) {
return typeField != null && type == EnumMap.class;
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
Class type = (Class) Fields.read(typeField, source);
String attributeName = mapper().aliasForSystemAttribute("enum-type");
if (attributeName != null) {
writer.addAttribute(attributeName, mapper().serializedClass(type));
}
super.marshal(source, writer, context);
}
@SuppressWarnings("unchecked")
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
String attributeName = mapper().aliasForSystemAttribute("enum-type");
if (attributeName == null) {
throw new ConversionException("No EnumType specified for EnumMap");
}
Class type = mapper().realClass(reader.getAttribute(attributeName));
EnumMap map = new EnumMap(type);
populateMap(reader, context, map);
return map;
}
}
././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumSingleValueConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumSingl0000664 0001750 0001750 00000002614 12206661545 034501 0 ustar jamespage jamespage /*
* Copyright (C) 2008, 2009, 2010 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 12. February 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters.enums;
import com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter;
/**
* A single value converter for arbitrary enums. Converter is internally automatically
* instantiated for enum types.
*
* @author Jörg Schaible
* @since 1.3
*/
public class EnumSingleValueConverter extends AbstractSingleValueConverter {
private final Class enumType;
public EnumSingleValueConverter(Class type) {
if (!Enum.class.isAssignableFrom(type) && type != Enum.class) {
throw new IllegalArgumentException("Converter can only handle defined enums");
}
enumType = type;
}
@Override
public boolean canConvert(Class type) {
return enumType.isAssignableFrom(type);
}
@Override
public String toString(Object obj) {
return Enum.class.cast(obj).name();
}
@Override
public Object fromString(String str) {
@SuppressWarnings("unchecked")
Enum result = Enum.valueOf(enumType, str);
return result;
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumSetConverter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/enums/EnumSetCo0000664 0001750 0001750 00000010547 12206661545 034446 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 06. April 2005 by Joe Walnes
*/
// ***** READ THIS *****
// This class will only compile with JDK 1.5.0 or above as it test Java enums.
// If you are using an earlier version of Java, just don't try to build this class. XStream should work fine without it.
package com.thoughtworks.xstream.converters.enums;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
import com.thoughtworks.xstream.core.util.Fields;
import java.lang.reflect.Field;
import java.util.EnumSet;
import java.util.Iterator;
/**
* Serializes a Java 5 EnumSet. If a SecurityManager is set, the converter will only work with permissions
* for SecurityManager.checkPackageAccess, SecurityManager.checkMemberAccess(this, EnumSet.MEMBER)
* and ReflectPermission("suppressAccessChecks").
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class EnumSetConverter implements Converter {
private final static Field typeField;
static {
// field name is "elementType" in Sun JDK, but different in Harmony
Field assumedTypeField = null;
try {
Field[] fields = EnumSet.class.getDeclaredFields();
for (int i = 0; i < fields.length; i++ ) {
if (fields[i].getType() == Class.class) {
// take the fist member of type "Class"
assumedTypeField = fields[i];
assumedTypeField.setAccessible(true);
break;
}
}
if (assumedTypeField == null) {
throw new ExceptionInInitializerError("Cannot detect element type of EnumSet");
}
} catch (SecurityException ex) {
// ignore, no access possible with current SecurityManager
}
typeField = assumedTypeField;
}
private final Mapper mapper;
public EnumSetConverter(Mapper mapper) {
this.mapper = mapper;
}
public boolean canConvert(Class type) {
return typeField != null && EnumSet.class.isAssignableFrom(type);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
EnumSet set = (EnumSet) source;
Class enumTypeForSet = (Class) Fields.read(typeField, set);
String attributeName = mapper.aliasForSystemAttribute("enum-type");
if (attributeName != null) {
writer.addAttribute(attributeName, mapper.serializedClass(enumTypeForSet));
}
writer.setValue(joinEnumValues(set));
}
private String joinEnumValues(EnumSet set) {
boolean seenFirst = false;
StringBuffer result = new StringBuffer();
for (Iterator iterator = set.iterator(); iterator.hasNext();) {
Enum value = (Enum) iterator.next();
if (seenFirst) {
result.append(',');
} else {
seenFirst = true;
}
result.append(value.name());
}
return result.toString();
}
@SuppressWarnings("unchecked")
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
String attributeName = mapper.aliasForSystemAttribute("enum-type");
if (attributeName == null) {
throw new ConversionException("No EnumType specified for EnumSet");
}
Class enumTypeForSet = mapper.realClass(reader.getAttribute(attributeName));
EnumSet set = EnumSet.noneOf(enumTypeForSet);
String[] enumValues = reader.getValue().split(",");
for (int i = 0; i < enumValues.length; i++) {
String enumValue = enumValues[i];
if(enumValue.length() > 0) {
set.add(Enum.valueOf(enumTypeForSet, enumValue));
}
}
return set;
}
}
././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/SingleValueConverterWrapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/SingleValueConv0000664 0001750 0001750 00000003537 12206661545 034522 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2011 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 20. February 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.converters;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* Wrapper to convert a {@link com.thoughtworks.xstream.converters.SingleValueConverter} into a
* {@link com.thoughtworks.xstream.converters.Converter}.
*
* @author Jörg Schaible
* @see com.thoughtworks.xstream.converters.Converter
* @see com.thoughtworks.xstream.converters.SingleValueConverter
*/
public class SingleValueConverterWrapper implements Converter, SingleValueConverter, ErrorReporter {
private final SingleValueConverter wrapped;
public SingleValueConverterWrapper(SingleValueConverter wrapped) {
this.wrapped = wrapped;
}
public boolean canConvert(Class type) {
return wrapped.canConvert(type);
}
public String toString(Object obj) {
return wrapped.toString(obj);
}
public Object fromString(String str) {
return wrapped.fromString(str);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
writer.setValue(toString(source));
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
return fromString(reader.getValue());
}
public void appendErrors(ErrorWriter errorWriter) {
errorWriter.add("wrapped-converter", wrapped.getClass().getName());
if (wrapped instanceof ErrorReporter) {
((ErrorReporter)wrapped).appendErrors(errorWriter);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConversionException.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConversionExcep0000664 0001750 0001750 00000006460 12206661545 034566 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream.converters;
import com.thoughtworks.xstream.XStreamException;
import com.thoughtworks.xstream.core.util.OrderRetainingMap;
import java.util.Iterator;
import java.util.Map;
/**
* Thrown by {@link Converter} implementations when they cannot convert an object
* to/from textual data.
*
* When this exception is thrown it can be passed around to things that accept an
* {@link ErrorWriter}, allowing them to add diagnostics to the stack trace.
*
* @author Joe Walnes
* @author Jörg Schaible
*
* @see ErrorWriter
*/
public class ConversionException extends XStreamException implements ErrorWriter {
private static final String SEPARATOR = "\n-------------------------------";
private Map stuff = new OrderRetainingMap();
public ConversionException(String msg, Throwable cause) {
super(msg, cause);
if (msg != null) {
add("message", msg);
}
if (cause != null) {
add("cause-exception", cause.getClass().getName());
add("cause-message", cause instanceof ConversionException ? ((ConversionException)cause).getShortMessage() : cause.getMessage());
}
}
public ConversionException(String msg) {
super(msg);
}
public ConversionException(Throwable cause) {
this(cause.getMessage(), cause);
}
public String get(String errorKey) {
return (String) stuff.get(errorKey);
}
public void add(String name, String information) {
String key = name;
int i = 0;
while (stuff.containsKey(key)) {
String value = (String)stuff.get(key);
if (information.equals(value))
return;
key = name + "[" + ++i +"]";
}
stuff.put(key, information);
}
public void set(String name, String information) {
String key = name;
int i = 0;
stuff.put(key, information); // keep order
while (stuff.containsKey(key)) {
if (i != 0) {
stuff.remove(key);
}
key = name + "[" + ++i +"]";
}
}
public Iterator keys() {
return stuff.keySet().iterator();
}
public String getMessage() {
StringBuffer result = new StringBuffer();
if (super.getMessage() != null) {
result.append(super.getMessage());
}
if (!result.toString().endsWith(SEPARATOR)) {
result.append("\n---- Debugging information ----");
}
for (Iterator iterator = keys(); iterator.hasNext();) {
String k = (String) iterator.next();
String v = get(k);
result.append('\n').append(k);
result.append(" ".substring(Math.min(20, k.length())));
result.append(": ").append(v);
}
result.append(SEPARATOR);
return result.toString();
}
public String getShortMessage() {
return super.getMessage();
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConverterRegistry.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/converters/ConverterRegist0000664 0001750 0001750 00000001053 12206661545 034572 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 01. January 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.converters;
/**
* An interface for the converter management.
*
* @author Jörg Schaible
* @since 1.3
*/
public interface ConverterRegistry {
void registerConverter(Converter converter, int priority);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ 0000775 0001750 0001750 00000000000 12206661545 027740 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/ 0000775 0001750 0001750 00000000000 12206661545 030674 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/PathTrackingWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/PathTrackingWriter0000664 0001750 0001750 00000003166 12206661545 034401 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.path;
import com.thoughtworks.xstream.io.AbstractWriter;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.WriterWrapper;
/**
* Wrapper for HierarchicalStreamWriter that tracks the path (a subset of XPath) of the current node that is being written.
*
* @see PathTracker
* @see Path
*
* @author Joe Walnes
*/
public class PathTrackingWriter extends WriterWrapper {
private final PathTracker pathTracker;
private final boolean isNameEncoding;
public PathTrackingWriter(HierarchicalStreamWriter writer, PathTracker pathTracker) {
super(writer);
this.isNameEncoding = writer.underlyingWriter() instanceof AbstractWriter;
this.pathTracker = pathTracker;
}
public void startNode(String name) {
pathTracker.pushElement(isNameEncoding ? ((AbstractWriter)wrapped.underlyingWriter()).encodeNode(name) : name);
super.startNode(name);
}
public void startNode(String name, Class clazz) {
pathTracker.pushElement(isNameEncoding ? ((AbstractWriter)wrapped.underlyingWriter()).encodeNode(name) : name);
super.startNode(name, clazz);
}
public void endNode() {
super.endNode();
pathTracker.popElement();
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/PathTrackingReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/PathTrackingReader0000664 0001750 0001750 00000002624 12206661545 034325 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 03. April 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.path;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.ReaderWrapper;
/**
* Wrapper for HierarchicalStreamReader that tracks the path (a subset of XPath) of the current node that is being read.
*
* @see PathTracker
* @see Path
*
* @author Joe Walnes
*/
public class PathTrackingReader extends ReaderWrapper {
private final PathTracker pathTracker;
public PathTrackingReader(HierarchicalStreamReader reader, PathTracker pathTracker) {
super(reader);
this.pathTracker = pathTracker;
pathTracker.pushElement(getNodeName());
}
public void moveDown() {
super.moveDown();
pathTracker.pushElement(getNodeName());
}
public void moveUp() {
super.moveUp();
pathTracker.popElement();
}
public void appendErrors(ErrorWriter errorWriter) {
errorWriter.add("path", pathTracker.getPath().toString());
super.appendErrors(errorWriter);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/PathTracker.java 0000664 0001750 0001750 00000012051 12206661545 033746 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.path;
import java.util.HashMap;
import java.util.Map;
/**
* Maintains the current {@link Path} as a stream is moved through.
*
*
Can be linked to a {@link com.thoughtworks.xstream.io.HierarchicalStreamWriter} or
* {@link com.thoughtworks.xstream.io.HierarchicalStreamReader} by wrapping them with a
* {@link PathTrackingWriter} or {@link PathTrackingReader}.
*
* @see Path
* @see PathTrackingReader
* @see PathTrackingWriter
*
* @author Joe Walnes
*/
public class PathTracker {
private int pointer;
private int capacity;
private String[] pathStack;
private Map[] indexMapStack;
private Path currentPath;
public PathTracker() {
this(16);
}
/**
* @param initialCapacity Size of the initial stack of nodes (one level per depth in the tree). Note that this is
* only for optimizations - the stack will resize itself if it exceeds its capacity. If in doubt,
* use the other constructor.
*/
public PathTracker(int initialCapacity) {
this.capacity = Math.max(1, initialCapacity);
pathStack = new String[capacity];
indexMapStack = new Map[capacity];
}
/**
* Notify the tracker that the stream has moved into a new element.
*
* @param name Name of the element
*/
public void pushElement(String name) {
if (pointer + 1 >= capacity) {
resizeStacks(capacity * 2);
}
pathStack[pointer] = name;
Map indexMap = indexMapStack[pointer];
if (indexMap == null) {
indexMap = new HashMap();
indexMapStack[pointer] = indexMap;
}
if (indexMap.containsKey(name)) {
indexMap.put(name, new Integer(((Integer) indexMap.get(name)).intValue() + 1));
} else {
indexMap.put(name, new Integer(1));
}
pointer++;
currentPath = null;
}
/**
* Notify the tracker that the stream has moved out of an element.
*/
public void popElement() {
indexMapStack[pointer] = null;
pathStack[pointer] = null;
currentPath = null;
pointer--;
}
/**
* Get the last path element from the stack.
*
* @return the name of the path element
* @since 1.4.2
*/
public String peekElement() {
return peekElement(0);
}
/**
* Get a path element from the stack.
*
* @param i path index
* @return the name of the path element
* @since 1.4.2
* @throws ArrayIndexOutOfBoundsException if the index is >= 0 or <= -depth()
*/
public String peekElement(int i) {
if (i < -pointer || i > 0) {
throw new ArrayIndexOutOfBoundsException(i);
}
int idx = pointer + i - 1;
final String name;
Integer integer = ((Integer) indexMapStack[idx].get(pathStack[idx]));
int index = integer.intValue();
if (index > 1) {
StringBuffer chunk = new StringBuffer(pathStack[idx].length() + 6);
chunk.append(pathStack[idx]).append('[').append(index).append(']');
name = chunk.toString();
} else {
name = pathStack[idx];
}
return name;
}
/**
* Get the depth of the stack.
*
* @return the stack depth
* @since 1.4.2
*/
public int depth() {
return pointer;
}
private void resizeStacks(int newCapacity) {
String[] newPathStack = new String[newCapacity];
Map[] newIndexMapStack = new Map[newCapacity];
int min = Math.min(capacity, newCapacity);
System.arraycopy(pathStack, 0, newPathStack, 0, min);
System.arraycopy(indexMapStack, 0, newIndexMapStack, 0, min);
pathStack = newPathStack;
indexMapStack = newIndexMapStack;
capacity = newCapacity;
}
/**
* Current Path in stream.
*/
public Path getPath() {
if (currentPath == null) {
String[] chunks = new String[pointer + 1];
chunks[0] = "";
for (int i = -pointer; ++i <= 0; ) {
final String name = peekElement(i);
chunks[i + pointer] = name;
}
currentPath = new Path(chunks);
}
return currentPath;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/package.html 0000664 0001750 0001750 00000003622 12206661545 033160 0 ustar jamespage jamespage
Library for tracking paths of nodes in documents using a subset of XPath. This subset of XPath is just enough
for XStream to be able to use XPath expressions to represent references across the object graph, while still remaining
very quick.
The Path class represents a path to a single node in the tree.
Two absolute paths can also be compared to calculate the relative path between them.
A relative path can be applied to an absolute path to calculate another absolute path.
Note that the paths produced are XPath compliant, so can be read by other XPath engines. The following are examples of path
expressions that the Path object supports:
/
/some/node
/a/b/c/b/a
/some[3]/node[2]/a
../../../another[3]/node
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/path/Path.java 0000664 0001750 0001750 00000016170 12206661545 032440 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 02. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.path;
import com.thoughtworks.xstream.core.util.FastStack;
import java.util.ArrayList;
import java.util.List;
/**
* Represents a path to a single node in the tree.
*
*
Two absolute paths can also be compared to calculate the relative path between them.
* A relative path can be applied to an absolute path to calculate another absolute path.
*
*
Note that the paths are normally XPath compliant, so can be read by other XPath engines.
* However, {@link #toString()} will select a node list while {@link #explicit()} will always select
* an individual node. If the return type of the XPath evaluation is a node, the result will be the same,
* because XPath will then use the first element of the list. The following are examples of path
* expressions that the Path object supports:
*
*
Note that the implementation does not take care if the paths are XPath compliant, it simply
* manages the values between the path separator. However, it normalizes the path if a path element
* ends with a selector for the first element (i.e. "[1]"). Those will be handled transparent i.e. two Paths
* are treated equal if one was created with path elements containing this selector and the other one
* without.
*
*
The following are examples of path expressions that the Path object supports:
*
*
/
*
/some/node
*
/a/b/c/b/a
*
/a/b[1]/c[1]/b[1]/a[1]
*
/some[3]/node[2]/a
*
../../../another[3]/node
*
*
*
Example
*
*
* Path a = new Path("/html/body/div[1]/table[2]/tr[3]/td/div");
* Path b = new Path("/html/body/div/table[2]/tr[6]/td/form");
*
* Path relativePath = a.relativeTo(b); // produces: "../../../tr[6]/td/form"
* Path c = a.apply(relativePath); // same as Path b.
*
*
* @see PathTracker
*
* @author Joe Walnes
*/
public class Path {
private final String[] chunks;
private transient String pathAsString;
private transient String pathExplicit;
private static final Path DOT = new Path(new String[] {"."});
public Path(String pathAsString) {
// String.split() too slow. StringTokenizer too crappy.
List result = new ArrayList();
int currentIndex = 0;
int nextSeparator;
this.pathAsString = pathAsString;
while ((nextSeparator = pathAsString.indexOf('/', currentIndex)) != -1) {
// normalize explicit paths
result.add(normalize(pathAsString, currentIndex, nextSeparator));
currentIndex = nextSeparator + 1;
}
result.add(normalize(pathAsString,currentIndex,pathAsString.length()));
String[] arr = new String[result.size()];
result.toArray(arr);
chunks = arr;
}
private String normalize(String s, int start, int end) {
if (end - start > 3
&& s.charAt(end-3) == '['
&& s.charAt(end-2) == '1'
&& s.charAt(end-1) == ']') {
this.pathAsString = null;
return s.substring(start, end-3);
} else {
return s.substring(start, end);
}
}
public Path(String[] chunks) {
this.chunks = chunks;
}
public String toString() {
if (pathAsString == null) {
StringBuffer buffer = new StringBuffer();
for (int i = 0; i < chunks.length; i++) {
if (i > 0) buffer.append('/');
buffer.append(chunks[i]);
}
pathAsString = buffer.toString();
}
return pathAsString;
}
public String explicit() {
if (pathExplicit == null) {
StringBuffer buffer = new StringBuffer();
for (int i = 0; i < chunks.length; i++) {
if (i > 0) buffer.append('/');
String chunk = chunks[i];
buffer.append(chunk);
int length = chunk.length();
if (length > 0) {
char c = chunk.charAt(length-1);
if (c != ']' && c != '.') {
buffer.append("[1]");
}
}
}
pathExplicit = buffer.toString();
}
return pathExplicit;
}
public boolean equals(Object o) {
if (this == o) return true;
if (!(o instanceof Path)) return false;
final Path other = (Path) o;
if (chunks.length != other.chunks.length) return false;
for (int i = 0; i < chunks.length; i++) {
if (!chunks[i].equals(other.chunks[i])) return false;
}
return true;
}
public int hashCode() {
int result = 543645643;
for (int i = 0; i < chunks.length; i++) {
result = 29 * result + chunks[i].hashCode();
}
return result;
}
public Path relativeTo(Path that) {
int depthOfPathDivergence = depthOfPathDivergence(chunks, that.chunks);
String[] result = new String[chunks.length + that.chunks.length - 2 * depthOfPathDivergence];
int count = 0;
for (int i = depthOfPathDivergence; i < chunks.length; i++) {
result[count++] = "..";
}
for (int j = depthOfPathDivergence; j < that.chunks.length; j++) {
result[count++] = that.chunks[j];
}
if (count == 0) {
return DOT;
} else {
return new Path(result);
}
}
private int depthOfPathDivergence(String[] path1, String[] path2) {
int minLength = Math.min(path1.length, path2.length);
for (int i = 0; i < minLength; i++) {
if (!path1[i].equals(path2[i])) {
return i;
}
}
return minLength;
}
public Path apply(Path relativePath) {
FastStack absoluteStack = new FastStack(16);
for (int i = 0; i < chunks.length; i++) {
absoluteStack.push(chunks[i]);
}
for (int i = 0; i < relativePath.chunks.length; i++) {
String relativeChunk = relativePath.chunks[i];
if (relativeChunk.equals("..")) {
absoluteStack.pop();
} else if (!relativeChunk.equals(".")) {
absoluteStack.push(relativeChunk);
}
}
String[] result = new String[absoluteStack.size()];
for (int i = 0; i < result.length; i++) {
result[i] = (String) absoluteStack.get(i);
}
return new Path(result);
}
public boolean isAncestor(Path child) {
if (child == null || child.chunks.length < chunks.length) {
return false;
}
for (int i = 0; i < chunks.length; i++) {
if (!chunks[i].equals(child.chunks[i])) {
return false;
}
}
return true;
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/HierarchicalStreamDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/HierarchicalStreamDrive0000664 0001750 0001750 00000005203 12206661545 034407 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
import java.io.File;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;
/**
* Provides implementation of stream parsers and writers to XStream.
*
* @author Joe Walnes
* @author James Strachan
*/
public interface HierarchicalStreamDriver {
/**
* Create the HierarchicalStreamReader with the stream parser reading from the IO reader.
*
* @param in the {@link Reader} with the data to parse
* @return the HierarchicalStreamReader
*/
HierarchicalStreamReader createReader(Reader in);
/**
* Create the HierarchicalStreamReader with the stream parser reading from the input stream.
*
* @param in the {@link InputStream} with the data to parse
* @since 1.1.3
*/
HierarchicalStreamReader createReader(InputStream in);
/**
* Create the HierarchicalStreamReader with the stream parser reading from a URL.
*
* Depending on the parser implementation, some might take the URL as SystemId to resolve
* additional references.
*
* @param in the {@link URL} defining the location with the data to parse
* @return the HierarchicalStreamReader
* @since 1.4
*/
HierarchicalStreamReader createReader(URL in);
/**
* Create the HierarchicalStreamReader with the stream parser reading from a File.
*
* Depending on the parser implementation, some might take the file path as SystemId to
* resolve additional references.
*
* @param in the {@link URL} defining the location with the data to parse
* @return the HierarchicalStreamReader
* @since 1.4
*/
HierarchicalStreamReader createReader(File in);
/**
* Create the HierarchicalStreamWriter with the formatted writer.
*
* @param out the {@link Writer} to receive the formatted data
* @return the HierarchicalStreamWriter
*/
HierarchicalStreamWriter createWriter(Writer out);
/**
* Create the HierarchicalStreamWriter with the formatted writer.
*
* @param out the {@link OutputStream} to receive the formatted data
* @return the HierarchicalStreamWriter
* @since 1.1.3
*/
HierarchicalStreamWriter createWriter(OutputStream out);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/StatefulWriter.java 0000664 0001750 0001750 00000011677 12206661545 033603 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 15. March 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.io;
import com.thoughtworks.xstream.core.util.FastStack;
import java.io.IOException;
import java.util.HashSet;
import java.util.Set;
/**
* An wrapper for all {@link HierarchicalStreamWriter} implementations, that keeps the state.
* Writing in a wrong state will throw a {@link StreamException}, that wraps either an
* {@link IOException} (writing to a closed writer) or an {@link IllegalStateException}. The
* implementation will also track unbalanced nodes or multiple attributes with the same name.
*
* @author Jörg Schaible
* @since 1.2
*/
public class StatefulWriter extends WriterWrapper {
/**
* STATE_OPEN is the initial value of the writer.
*
* @since 1.2
*/
public static int STATE_OPEN = 0;
/**
* STATE_NODE_START is the state of a new node has been started.
*
* @since 1.2
*/
public static int STATE_NODE_START = 1;
/**
* STATE_VALUE is the state if the value of a node has been written.
*
* @since 1.2
*/
public static int STATE_VALUE = 2;
/**
* STATE_NODE_END is the state if a node has ended
*
* @since 1.2
*/
public static int STATE_NODE_END = 3;
/**
* STATE_CLOSED is the state if the writer has been closed.
*
* @since 1.2
*/
public static int STATE_CLOSED = 4;
private transient int state = STATE_OPEN;
private transient int balance;
private transient FastStack attributes;
/**
* Constructs a StatefulWriter.
*
* @param wrapped the wrapped writer
* @since 1.2
*/
public StatefulWriter(final HierarchicalStreamWriter wrapped) {
super(wrapped);
attributes = new FastStack(16);
}
public void startNode(final String name) {
startNodeCommon();
super.startNode(name);
}
public void startNode(final String name, final Class clazz) {
startNodeCommon();
super.startNode(name, clazz);
}
private void startNodeCommon() {
checkClosed();
if (state == STATE_VALUE) {
// legal XML, but not in XStream ... ?
throw new StreamException(new IllegalStateException("Opening node after writing text"));
}
state = STATE_NODE_START;
++balance;
attributes.push(new HashSet());
}
public void addAttribute(String name, String value) {
checkClosed();
if (state != STATE_NODE_START) {
throw new StreamException(new IllegalStateException("Writing attribute '"
+ name
+ "' without an opened node"));
}
Set currentAttributes = (Set)attributes.peek();
if (currentAttributes.contains(name)) {
throw new StreamException(new IllegalStateException("Writing attribute '"
+ name
+ "' twice"));
}
currentAttributes.add(name);
super.addAttribute(name, value);
}
public void setValue(String text) {
checkClosed();
if (state != STATE_NODE_START) {
// STATE_NODE_END is legal XML, but not in XStream ... ?
throw new StreamException(new IllegalStateException(
"Writing text without an opened node"));
}
state = STATE_VALUE;
super.setValue(text);
}
public void endNode() {
checkClosed();
if (balance-- == 0) {
throw new StreamException(new IllegalStateException("Unbalanced node"));
}
attributes.popSilently();
state = STATE_NODE_END;
super.endNode();
}
public void flush() {
checkClosed();
super.flush();
}
public void close() {
if (state != STATE_NODE_END && state != STATE_OPEN) {
// calling close in a finally block should not throw again
// throw new StreamException(new IllegalStateException("Closing with unbalanced tag"));
}
state = STATE_CLOSED;
super.close();
}
private void checkClosed() {
if (state == STATE_CLOSED) {
throw new StreamException(new IOException("Writing on a closed stream"));
}
}
/**
* Retrieve the state of the writer.
*
* @return one of the states
* @see #STATE_OPEN
* @see #STATE_NODE_START
* @see #STATE_VALUE
* @see #STATE_NODE_END
* @see #STATE_CLOSED
* @since 1.2
*/
public int state() {
return state;
}
private Object readResolve() {
attributes = new FastStack(16);
return this;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/copy/ 0000775 0001750 0001750 00000000000 12206661545 030712 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000160 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/copy/HierarchicalStreamCopier.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/copy/HierarchicalStream0000664 0001750 0001750 00000003520 12206661545 034367 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008 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 04. June 2006 by Joe Walnes
*/
package com.thoughtworks.xstream.io.copy;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* Tool for copying the contents of one HierarichalStreamReader to a HierarichalStreamWriter.
*
* This is useful for transforming the output of one format to another (e.g. binary to XML)
* without needing to know details about the classes and avoiding the overhead of serialization.
*
*
Example
*
* HierarchicalStreamReader reader = new BinaryStreamReader(someBinaryInput);
* HierarchicalStreamWriter writer = new PrettyPrintWriter(someXmlOutput);
* HierarchicalStreamCopier copier = new HierarchicalStreamCopier();
* copier.copy(reader, writer);
*
*
* @author Joe Walnes
* @since 1.2
*/
public class HierarchicalStreamCopier {
public void copy(HierarchicalStreamReader source, HierarchicalStreamWriter destination) {
destination.startNode(source.getNodeName());
int attributeCount = source.getAttributeCount();
for (int i = 0; i < attributeCount; i++) {
destination.addAttribute(source.getAttributeName(i), source.getAttribute(i));
}
String value = source.getValue();
if (value != null && value.length() > 0) {
destination.setValue(value);
}
while (source.hasMoreChildren()) {
source.moveDown();
copy(source, destination);
source.moveUp();
}
destination.endNode();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/ 0000775 0001750 0001750 00000000000 12206661545 031211 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/NoNameCoder.java0000664 0001750 0001750 00000002357 12206661545 034215 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 15. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.naming;
/**
* A NameCoder that does nothing.
*
* The usage of this implementation implies that the names used for the objects can also be used
* in the target format without any change. This applies also for XML if the object graph
* contains no object that is an instance of an inner class type or is in the default package.
*
*
* @author Jörg Schaiblea
* @since 1.4
*/
public class NoNameCoder implements NameCoder {
/**
* {@inheritDoc}
*/
public String decodeAttribute(String attributeName) {
return attributeName;
}
/**
* {@inheritDoc}
*/
public String decodeNode(String nodeName) {
return nodeName;
}
/**
* {@inheritDoc}
*/
public String encodeAttribute(String name) {
return name;
}
/**
* {@inheritDoc}
*/
public String encodeNode(String name) {
return name;
}
}
././@LongLink 0000644 0000000 0000000 00000000151 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/StaticNameCoder.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/StaticNameCoder.0000664 0001750 0001750 00000006032 12206661545 034220 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 15. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.naming;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
/**
* A NameCoder that encodes and decodes names based on a map.
*
* The provided map should contain a mapping between the name of the Java type or field to the
* proper element in the target format. If a name cannot be found in the map, it is assumed not
* to be mapped at all. Note that the values of the map should be unique also, otherwise the
* decoding will produce wrong results.
*
*
* @author Jörg Schaible
* @since 1.4
*/
public class StaticNameCoder implements NameCoder {
private final Map java2Node;
private final Map java2Attribute;
private transient Map node2Java;
private transient Map attribute2Java;
/**
* Construct a StaticNameCoder.
*
* @param java2Node mapping of Java names to nodes
* @param java2Attribute mapping of Java names to attributes
* @since 1.4
*/
public StaticNameCoder(Map java2Node, Map java2Attribute) {
this.java2Node = new HashMap(java2Node);
if (java2Node == java2Attribute || java2Attribute == null) {
this.java2Attribute = this.java2Node;
} else {
this.java2Attribute = new HashMap(java2Attribute);
}
readResolve();
}
/**
* {@inheritDoc}
*/
public String decodeAttribute(String attributeName) {
String name = (String)attribute2Java.get(attributeName);
return name == null ? attributeName : name;
}
/**
* {@inheritDoc}
*/
public String decodeNode(String nodeName) {
String name = (String)node2Java.get(nodeName);
return name == null ? nodeName : name;
}
/**
* {@inheritDoc}
*/
public String encodeAttribute(String name) {
String friendlyName = (String)java2Attribute.get(name);
return friendlyName == null ? name : friendlyName;
}
/**
* {@inheritDoc}
*/
public String encodeNode(String name) {
String friendlyName = (String)java2Node.get(name);
return friendlyName == null ? name : friendlyName;
}
private Object readResolve() {
node2Java = invertMap(java2Node);
if (java2Node == java2Attribute) {
attribute2Java = node2Java;
} else {
attribute2Java = invertMap(java2Attribute);
}
return this;
}
private Map invertMap(Map map) {
Map inverseMap = new HashMap(map.size());
for (final Iterator iter = map.entrySet().iterator(); iter.hasNext();) {
final Map.Entry entry = (Map.Entry)iter.next();
inverseMap.put((String)entry.getValue(), (String)entry.getKey());
}
return inverseMap;
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/NameCoderWrapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/NameCoderWrapper0000664 0001750 0001750 00000002450 12206661545 034333 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 15. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.naming;
/**
* A wrapper for another NameCoder.
*
* @author Jörg Schaible
* @since 1.4
*/
public class NameCoderWrapper implements NameCoder {
private final NameCoder wrapped;
/**
* Construct a new wrapper for a NameCoder.
*
* @param inner the wrapped NameCoder
* @since 1.4
*/
public NameCoderWrapper(NameCoder inner) {
this.wrapped = inner;
}
/**
* {@inheritDoc}
*/
public String decodeAttribute(String attributeName) {
return wrapped.decodeAttribute(attributeName);
}
/**
* {@inheritDoc}
*/
public String decodeNode(String nodeName) {
return wrapped.decodeNode(nodeName);
}
/**
* {@inheritDoc}
*/
public String encodeAttribute(String name) {
return wrapped.encodeAttribute(name);
}
/**
* {@inheritDoc}
*/
public String encodeNode(String name) {
return wrapped.encodeNode(name);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/naming/NameCoder.java 0000664 0001750 0001750 00000005133 12206661545 033713 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 14. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.naming;
/**
* Coder between names in the object graph and names of a target format.
*
* The names form the object graph are typically names generated from Java identifiers (Java
* types or field members), but some names may also contain a minus sign. However, the original
* name might have already been aliased, so a wider range of characters can occur.
*
*
* The target names should satisfy the syntax of the target format. Transforming Java objects to
* XML this affects names that contain or even start with a dollar sign. Such names violate the
* XML specification.
*
*
* By default all names from the object graph are used as node names in the target format.
* Meta-data that is necessary to unmarshal the object again is typically written as attribute.
* Since such attributes might be represented differently in the target format, the NameCoder
* distinguishes between the names used for meta-data elements and the ones for the object data.
* The names in the target format might even have to follow a different syntax. Remember, that
* XStream can be easily configured to write also object data as attributes.
*
*
* Note that the instance of a NameCoder should be either thread-safe or implement {@link Cloneable}.
*
*
* @author Jörg Schaible
* @since 1.4
*/
public interface NameCoder {
/**
* Encode an object name for a node in the target format.
*
* @param name the name of the object data
* @return the node name in the target format
* @since 1.4
*/
String encodeNode(String name);
/**
* Encode a meta-data name for an attribute in the target format.
*
* @param name the name of the meta-data
* @return the attribute name in the target format
* @since 1.4
*/
String encodeAttribute(String name);
/**
* Decode a node name to an object name.
*
* @param nodeName the name of the node
* @return the name of the object
* @since 1.4
*/
String decodeNode(String nodeName);
/**
* Decode an attribute name to an object name.
*
* @param attributeName the name of the attribute
* @return the name of the meta-data
* @since 1.4
*/
String decodeAttribute(String attributeName);
}
././@LongLink 0000644 0000000 0000000 00000000163 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ExtendedHierarchicalStreamWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ExtendedHierarchicalStr0000664 0001750 0001750 00000001043 12206661545 034411 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 22. June 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io;
/**
* @author Paul Hammant
*/
public interface ExtendedHierarchicalStreamWriter extends HierarchicalStreamWriter {
void startNode(String name, Class clazz);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/AbstractWriter.java 0000664 0001750 0001750 00000004267 12206661545 033554 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 17. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io;
import com.thoughtworks.xstream.core.util.Cloneables;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.naming.NoNameCoder;
/**
* Abstract base class for all HierarchicalStreamWriter implementations. Implementations of
* {@link HierarchicalStreamWriter} should rather be derived from this class then implementing
* the interface directly.
*
* @author Jörg Schaible
* @since 1.4
*/
public abstract class AbstractWriter implements ExtendedHierarchicalStreamWriter {
private NameCoder nameCoder;
/**
* Creates an AbstractWriter with a NameCoder that does nothing.
*
* @since 1.4
*/
protected AbstractWriter() {
this(new NoNameCoder());
}
/**
* Creates an AbstractWriter with a provided {@link NameCoder}.
*
* @param nameCoder the name coder used to write names in the target format
* @since 1.4
*/
protected AbstractWriter(NameCoder nameCoder) {
this.nameCoder = (NameCoder)Cloneables.cloneIfPossible(nameCoder);
}
/**
* {@inheritDoc}
*/
public void startNode(String name, Class clazz) {
startNode(name);
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamWriter underlyingWriter() {
return this;
}
/**
* Encode the node name into the name of the target format.
*
* @param name the original name
* @return the name in the target format
* @since 1.4
*/
public String encodeNode(String name) {
return nameCoder.encodeNode(name);
}
/**
* Encode the attribute name into the name of the target format.
*
* @param name the original name
* @return the name in the target format
* @since 1.4
*/
public String encodeAttribute(String name) {
return nameCoder.encodeAttribute(name);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ReaderWrapper.java 0000664 0001750 0001750 00000004235 12206661545 033352 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 10. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
import com.thoughtworks.xstream.converters.ErrorWriter;
import java.util.Iterator;
/**
* Base class to make it easy to create wrappers (decorators) for HierarchicalStreamReader.
*
* @author Joe Walnes
*/
public abstract class ReaderWrapper implements ExtendedHierarchicalStreamReader {
protected HierarchicalStreamReader wrapped;
protected ReaderWrapper(HierarchicalStreamReader reader) {
this.wrapped = reader;
}
public boolean hasMoreChildren() {
return wrapped.hasMoreChildren();
}
public void moveDown() {
wrapped.moveDown();
}
public void moveUp() {
wrapped.moveUp();
}
public String getNodeName() {
return wrapped.getNodeName();
}
public String getValue() {
return wrapped.getValue();
}
public String getAttribute(String name) {
return wrapped.getAttribute(name);
}
public String getAttribute(int index) {
return wrapped.getAttribute(index);
}
public int getAttributeCount() {
return wrapped.getAttributeCount();
}
public String getAttributeName(int index) {
return wrapped.getAttributeName(index);
}
public Iterator getAttributeNames() {
return wrapped.getAttributeNames();
}
public void appendErrors(ErrorWriter errorWriter) {
wrapped.appendErrors(errorWriter);
}
public void close() {
wrapped.close();
}
public String peekNextChild() {
if (! (wrapped instanceof ExtendedHierarchicalStreamReader)) {
throw new UnsupportedOperationException("peekNextChild");
}
return ((ExtendedHierarchicalStreamReader)wrapped).peekNextChild();
}
public HierarchicalStreamReader underlyingReader() {
return wrapped.underlyingReader();
}
}
././@LongLink 0000644 0000000 0000000 00000000171 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ExtendedHierarchicalStreamWriterHelper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ExtendedHierarchicalStr0000664 0001750 0001750 00000001345 12206661545 034416 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 22. June 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io;
public class ExtendedHierarchicalStreamWriterHelper {
public static void startNode(HierarchicalStreamWriter writer, String name, Class clazz) {
if (writer instanceof ExtendedHierarchicalStreamWriter) {
((ExtendedHierarchicalStreamWriter) writer).startNode(name, clazz);
} else {
writer.startNode(name);
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/ 0000775 0001750 0001750 00000000000 12206661545 030540 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/StaxDriver.java 0000664 0001750 0001750 00000014220 12206661545 033475 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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. September 2004 by James Strachan
*/
package com.thoughtworks.xstream.io.xml;
import java.io.File;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLOutputFactory;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
import javax.xml.stream.XMLStreamWriter;
import javax.xml.transform.Source;
import javax.xml.transform.stream.StreamSource;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* A driver using the StAX API to create XML reader and writer.
*
* @author James Strachan
* @author Jörg Schaible
* @version $Revision: 1861 $
*/
public class StaxDriver extends AbstractXmlDriver {
private QNameMap qnameMap;
private XMLInputFactory inputFactory;
private XMLOutputFactory outputFactory;
public StaxDriver() {
this(new QNameMap());
}
public StaxDriver(QNameMap qnameMap) {
this(qnameMap, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public StaxDriver(QNameMap qnameMap, NameCoder nameCoder) {
super(nameCoder);
this.qnameMap = qnameMap;
}
/**
* @since 1.4
*/
public StaxDriver(NameCoder nameCoder) {
this(new QNameMap(), nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link StaxDriver#StaxDriver(QNameMap, NameCoder)} instead.
*/
public StaxDriver(QNameMap qnameMap, XmlFriendlyReplacer replacer) {
this(qnameMap, (NameCoder)replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link StaxDriver#StaxDriver(NameCoder)} instead.
*/
public StaxDriver(XmlFriendlyReplacer replacer) {
this(new QNameMap(), (NameCoder)replacer);
}
public HierarchicalStreamReader createReader(Reader xml) {
try {
return createStaxReader(createParser(xml));
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(InputStream in) {
try {
return createStaxReader(createParser(in));
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(URL in) {
try {
return createStaxReader(createParser(new StreamSource(in.toExternalForm())));
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(File in) {
try {
return createStaxReader(createParser(new StreamSource(in)));
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(Writer out) {
try {
return createStaxWriter(getOutputFactory().createXMLStreamWriter(out));
}
catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(OutputStream out) {
try {
return createStaxWriter(getOutputFactory().createXMLStreamWriter(out));
}
catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public AbstractPullReader createStaxReader(XMLStreamReader in) {
return new StaxReader(qnameMap, in, getNameCoder());
}
public StaxWriter createStaxWriter(XMLStreamWriter out, boolean writeStartEndDocument) throws XMLStreamException {
return new StaxWriter(qnameMap, out, writeStartEndDocument, isRepairingNamespace(), getNameCoder());
}
public StaxWriter createStaxWriter(XMLStreamWriter out) throws XMLStreamException {
return createStaxWriter(out, true);
}
// Properties
//-------------------------------------------------------------------------
public QNameMap getQnameMap() {
return qnameMap;
}
public void setQnameMap(QNameMap qnameMap) {
this.qnameMap = qnameMap;
}
public XMLInputFactory getInputFactory() {
if (inputFactory == null) {
inputFactory = createInputFactory();
}
return inputFactory;
}
public XMLOutputFactory getOutputFactory() {
if (outputFactory == null) {
outputFactory = createOutputFactory();
}
return outputFactory;
}
public boolean isRepairingNamespace() {
return Boolean.TRUE.equals(getOutputFactory().getProperty(
XMLOutputFactory.IS_REPAIRING_NAMESPACES));
}
/**
* @since 1.2
*/
public void setRepairingNamespace(boolean repairing) {
getOutputFactory().setProperty(XMLOutputFactory.IS_REPAIRING_NAMESPACES,
repairing ? Boolean.TRUE : Boolean.FALSE);
}
// Implementation methods
//-------------------------------------------------------------------------
protected XMLStreamReader createParser(Reader xml) throws XMLStreamException {
return getInputFactory().createXMLStreamReader(xml);
}
protected XMLStreamReader createParser(InputStream xml) throws XMLStreamException {
return getInputFactory().createXMLStreamReader(xml);
}
protected XMLStreamReader createParser(Source source) throws XMLStreamException {
return getInputFactory().createXMLStreamReader(source);
}
/**
* @since 1.4
*/
protected XMLInputFactory createInputFactory() {
return XMLInputFactory.newInstance();
}
/**
* @since 1.4
*/
protected XMLOutputFactory createOutputFactory() {
return XMLOutputFactory.newInstance();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/Dom4JDriver.java 0000664 0001750 0001750 00000011053 12206661545 033474 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import java.io.File;
import java.io.FilterWriter;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.DocumentFactory;
import org.dom4j.io.OutputFormat;
import org.dom4j.io.SAXReader;
import org.dom4j.io.XMLWriter;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
public class Dom4JDriver extends AbstractXmlDriver {
private DocumentFactory documentFactory;
private OutputFormat outputFormat;
public Dom4JDriver() {
this(new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public Dom4JDriver(NameCoder nameCoder) {
this(new DocumentFactory(), OutputFormat.createPrettyPrint(), nameCoder);
outputFormat.setTrimText(false);
}
public Dom4JDriver(DocumentFactory documentFactory, OutputFormat outputFormat) {
this(documentFactory, outputFormat, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public Dom4JDriver(DocumentFactory documentFactory, OutputFormat outputFormat, NameCoder nameCoder) {
super(nameCoder);
this.documentFactory = documentFactory;
this.outputFormat = outputFormat;
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link Dom4JDriver#Dom4JDriver(DocumentFactory, OutputFormat, NameCoder)} instead.
*/
public Dom4JDriver(DocumentFactory documentFactory, OutputFormat outputFormat, XmlFriendlyReplacer replacer) {
this(documentFactory, outputFormat, (NameCoder)replacer);
}
public DocumentFactory getDocumentFactory() {
return documentFactory;
}
public void setDocumentFactory(DocumentFactory documentFactory) {
this.documentFactory = documentFactory;
}
public OutputFormat getOutputFormat() {
return outputFormat;
}
public void setOutputFormat(OutputFormat outputFormat) {
this.outputFormat = outputFormat;
}
public HierarchicalStreamReader createReader(Reader text) {
try {
SAXReader reader = new SAXReader();
Document document = reader.read(text);
return new Dom4JReader(document, getNameCoder());
} catch (DocumentException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(InputStream in) {
try {
SAXReader reader = new SAXReader();
Document document = reader.read(in);
return new Dom4JReader(document, getNameCoder());
} catch (DocumentException e) {
throw new StreamException(e);
}
}
/**
* @since 1.4
*/
public HierarchicalStreamReader createReader(URL in) {
try {
SAXReader reader = new SAXReader();
Document document = reader.read(in);
return new Dom4JReader(document, getNameCoder());
} catch (DocumentException e) {
throw new StreamException(e);
}
}
/**
* @since 1.4
*/
public HierarchicalStreamReader createReader(File in) {
try {
SAXReader reader = new SAXReader();
Document document = reader.read(in);
return new Dom4JReader(document, getNameCoder());
} catch (DocumentException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(final Writer out) {
final HierarchicalStreamWriter[] writer = new HierarchicalStreamWriter[1];
final FilterWriter filter = new FilterWriter(out){
public void close() {
writer[0].close();
}
};
writer[0] = new Dom4JXmlWriter(new XMLWriter(filter, outputFormat), getNameCoder());
return writer[0];
}
public HierarchicalStreamWriter createWriter(final OutputStream out) {
final Writer writer = new OutputStreamWriter(out);
return createWriter(writer);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XomDriver.java 0000664 0001750 0001750 00000010025 12206661545 033320 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 12. April 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;
import nu.xom.Builder;
import nu.xom.Document;
import nu.xom.ParsingException;
import nu.xom.ValidityException;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
public class XomDriver extends AbstractXmlDriver {
private final Builder builder;
public XomDriver() {
this(new Builder());
}
public XomDriver(Builder builder) {
this(builder, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public XomDriver(NameCoder nameCoder) {
this(new Builder(), nameCoder);
}
/**
* @since 1.4
*/
public XomDriver(Builder builder, NameCoder nameCoder) {
super(nameCoder);
this.builder = builder;
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link #XomDriver(Builder, NameCoder)} instead
*/
public XomDriver(XmlFriendlyReplacer replacer) {
this(new Builder(), replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link #XomDriver(Builder, NameCoder)} instead
*/
public XomDriver(Builder builder, XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
protected Builder getBuilder() {
return this.builder;
}
public HierarchicalStreamReader createReader(Reader text) {
try {
Document document = builder.build(text);
return new XomReader(document, getNameCoder());
} catch (ValidityException e) {
throw new StreamException(e);
} catch (ParsingException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(InputStream in) {
try {
Document document = builder.build(in);
return new XomReader(document, getNameCoder());
} catch (ValidityException e) {
throw new StreamException(e);
} catch (ParsingException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(URL in) {
try {
Document document = builder.build(in.toExternalForm());
return new XomReader(document, getNameCoder());
} catch (ValidityException e) {
throw new StreamException(e);
} catch (ParsingException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(File in) {
try {
Document document = builder.build(in);
return new XomReader(document, getNameCoder());
} catch (ValidityException e) {
throw new StreamException(e);
} catch (ParsingException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(final Writer out) {
return new PrettyPrintWriter(out, getNameCoder());
}
public HierarchicalStreamWriter createWriter(final OutputStream out) {
return new PrettyPrintWriter(new OutputStreamWriter(out), getNameCoder());
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/TraxSource.java 0000664 0001750 0001750 00000024314 12206661545 033506 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 14. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.XStream;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.XMLFilter;
import org.xml.sax.XMLReader;
import javax.xml.transform.sax.SAXSource;
import java.util.ArrayList;
import java.util.List;
/**
* A {@link SAXSource JAXP TrAX Source} that enables using XStream object serialization as
* direct input for XSLT processors without resorting to an intermediate representation such as
* text XML, DOM or DOM4J. The following example shows how to apply an XSL Transformation
* to a set of Java objects gathered into a List (source):
*
*
*
* public static String transform(List source, String stylesheet) {
* try {
* Transformer transformer = TransformerFactory.newInstance().newTransformer(
* new StreamSource(stylesheet));
* TraxSource in = new TraxSource(source);
* Writer out = new StringWriter();
* transformer.transform(in, new StreamResult(out));
* return out.toString();
* } catch (TransformerException e) {
* throw new RuntimeException("XSLT Transformation failed", e);
* }
* }
*
*
* @author Laurent Bihanic
*/
public class TraxSource extends SAXSource {
/**
* If {@link javax.xml.transform.TransformerFactory#getFeature} returns true
* when passed this value as an argument, the Transformer natively supports XStream.
* Note: This implementation does not override the
* {@link SAXSource#FEATURE} value defined by its superclass to be considered as a SAXSource
* by Transformer implementations not natively supporting this XStream-specific source
*
*/
public final static String XSTREAM_FEATURE = "http://com.thoughtworks.xstream/XStreamSource/feature";
/**
* The XMLReader object associated to this source or null if no XMLReader has
* yet been requested.
*
* @see #getXMLReader
*/
private XMLReader xmlReader = null;
/**
* The configured XStream facade to use for serializing objects.
*/
private XStream xstream = null;
/**
* The list of Java objects to be serialized.
*/
private List source = null;
// -------------------------------------------------------------------------
// Constructors
// -------------------------------------------------------------------------
/**
* Creates a XStream TrAX source.
*/
public TraxSource() {
super(new InputSource());
}
/**
* Creates a XStream TrAX source, specifying the object to marshal.
*
* @param source the object to marshal.
* @throws IllegalArgumentException if source is null.
* @see #setSource(java.lang.Object)
*/
public TraxSource(Object source) {
super(new InputSource());
this.setSource(source);
}
/**
* Creates a XStream TrAX source, specifying the object to marshal and a configured (with
* aliases) XStream facade.
*
* @param source the object to marshal.
* @param xstream a configured XStream facade.
* @throws IllegalArgumentException if source or xstream is
* null.
* @see #setSource(java.lang.Object)
* @see #setXStream(com.thoughtworks.xstream.XStream)
*/
public TraxSource(Object source, XStream xstream) {
super(new InputSource());
this.setSource(source);
this.setXStream(xstream);
}
/**
* Creates a XStream TrAX source, setting the objects to marshal.
*
* @param source the list of objects to marshal.
* @throws IllegalArgumentException if source is null or
* empty.
* @see #setSourceAsList(java.util.List)
*/
public TraxSource(List source) {
super(new InputSource());
this.setSourceAsList(source);
}
/**
* Creates a XStream TrAX source, setting the objects to marshal and a configured (with
* aliases) XStream facade.
*
* @param source the list of objects to marshal.
* @param xstream a configured XStream facade.
* @throws IllegalArgumentException if source or xstream is
* null or source is empty.
* @see #setSourceAsList(java.util.List)
* @see #setXStream(com.thoughtworks.xstream.XStream)
*/
public TraxSource(List source, XStream xstream) {
super(new InputSource());
this.setSourceAsList(source);
this.setXStream(xstream);
}
// -------------------------------------------------------------------------
// SAXSource overwritten methods
// -------------------------------------------------------------------------
/**
* Sets the SAX InputSource to be used for the Source. As this implementation only
* supports object lists as data source, this method always throws an
* {@link UnsupportedOperationException}.
*
*
* @param inputSource a valid InputSource reference.
* @throws UnsupportedOperationException always!
*/
public void setInputSource(InputSource inputSource) {
throw new UnsupportedOperationException();
}
/**
* Set the XMLReader to be used for the Source. As this implementation only supports
* object lists as data source, this method throws an {@link UnsupportedOperationException}
* if the provided reader object does not implement the SAX {@link XMLFilter} interface.
* Otherwise, a {@link SaxWriter} instance will be attached as parent of the filter chain.
*
*
* @param reader a valid XMLReader or XMLFilter reference.
* @throws UnsupportedOperationException if reader is not a SAX
* {@link XMLFilter}.
* @see #getXMLReader
*/
public void setXMLReader(XMLReader reader) {
this.createXMLReader(reader);
}
/**
* Returns the XMLReader to be used for the Source. This implementation returns a
* specific XMLReader ({@link SaxWriter}) generating the XML from a list of input objects.
*
*
* @return an XMLReader generating the XML from a list of input objects.
*/
public XMLReader getXMLReader() {
if (this.xmlReader == null) {
this.createXMLReader(null);
}
return this.xmlReader;
}
// -------------------------------------------------------------------------
// Specific implementation
// -------------------------------------------------------------------------
/**
* Sets the XStream facade to use when marshalling objects.
*
* @param xstream a configured XStream facade.
* @throws IllegalArgumentException if xstream is null.
*/
public void setXStream(XStream xstream) {
if (xstream == null) {
throw new IllegalArgumentException("xstream");
}
this.xstream = xstream;
this.configureXMLReader();
}
/**
* Sets the object to marshal.
*
* @param obj the object to marshal.
* @throws IllegalArgumentException if source is null.
*/
public void setSource(Object obj) {
if (obj == null) {
throw new IllegalArgumentException("obj");
}
List list = new ArrayList(1);
list.add(obj);
this.setSourceAsList(list);
}
/**
* Sets the list of objects to marshal. When dealing with non-text input (such as SAX
* or DOM), XSLT processors support multiple root node children for the source tree (see section 3.1 of the "XSL
* Transformations (XSLT) Version 1.0" specification. Using a list of objects as source
* makes use of this feature and allows creating XML documents merging the XML serialization
* of several Java objects.
*
* @param list the list of objects to marshal.
* @throws IllegalArgumentException if source is null or
* empty.
*/
public void setSourceAsList(List list) {
if ((list == null) || (list.isEmpty())) {
throw new IllegalArgumentException("list");
}
this.source = list;
this.configureXMLReader();
}
private void createXMLReader(XMLReader filterChain) {
if (filterChain == null) {
this.xmlReader = new SaxWriter();
} else {
if (filterChain instanceof XMLFilter) {
// Connect the filter chain to a document reader.
XMLFilter filter = (XMLFilter)filterChain;
while (filter.getParent() instanceof XMLFilter) {
filter = (XMLFilter)(filter.getParent());
}
if (!(filter.getParent() instanceof SaxWriter)) {
filter.setParent(new SaxWriter());
}
// Read XML data from filter chain.
this.xmlReader = filterChain;
} else {
throw new UnsupportedOperationException();
}
}
this.configureXMLReader();
}
private void configureXMLReader() {
if (this.xmlReader != null) {
try {
if (this.xstream != null) {
this.xmlReader.setProperty(
SaxWriter.CONFIGURED_XSTREAM_PROPERTY, this.xstream);
}
if (this.source != null) {
this.xmlReader.setProperty(
SaxWriter.SOURCE_OBJECT_LIST_PROPERTY, this.source);
}
} catch (SAXException e) {
throw new IllegalArgumentException(e.getMessage());
}
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XppReader.java 0000664 0001750 0001750 00000011501 12206661545 033273 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 08. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import java.io.IOException;
import java.io.Reader;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* XStream reader that pulls directly from the stream using the XmlPullParser API.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class XppReader extends AbstractPullReader {
private final XmlPullParser parser;
private final Reader reader;
/**
* Construct an XppReader.
*
* @param reader the reader with the input data
* @param parser the XPP parser to use
* @since 1.4
*/
public XppReader(Reader reader, XmlPullParser parser) {
this(reader, parser, new XmlFriendlyNameCoder());
}
/**
* Construct an XppReader.
*
* @param reader the reader with the input data
* @param parser the XPP parser to use
* @param nameCoder the coder for XML friendly tag and attribute names
* @since 1.4
*/
public XppReader(Reader reader, XmlPullParser parser, NameCoder nameCoder) {
super(nameCoder);
this.parser = parser;
this.reader = reader;
try {
parser.setInput(this.reader);
} catch (XmlPullParserException e) {
throw new StreamException(e);
}
moveDown();
}
/**
* @deprecated As of 1.4, use {@link #XppReader(Reader, XmlPullParser)} instead
*/
public XppReader(Reader reader) {
this(reader, new XmlFriendlyReplacer());
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link #XppReader(Reader, XmlPullParser, NameCoder)} instead
*/
public XppReader(Reader reader, XmlFriendlyReplacer replacer) {
super(replacer);
try {
parser = createParser();
this.reader = reader;
parser.setInput(this.reader);
moveDown();
} catch (XmlPullParserException e) {
throw new StreamException(e);
}
}
/**
* To use another implementation of org.xmlpull.v1.XmlPullParser, override this method.
* @deprecated As of 1.4, use {@link #XppReader(Reader, XmlPullParser)} instead
*/
protected XmlPullParser createParser() {
Exception exception = null;
try {
return (XmlPullParser)Class.forName("org.xmlpull.mxp1.MXParser", true, XmlPullParser.class.getClassLoader()).newInstance();
} catch (InstantiationException e) {
exception = e;
} catch (IllegalAccessException e) {
exception = e;
} catch (ClassNotFoundException e) {
exception = e;
}
throw new StreamException("Cannot create Xpp3 parser instance.", exception);
}
protected int pullNextEvent() {
try {
switch(parser.next()) {
case XmlPullParser.START_DOCUMENT:
case XmlPullParser.START_TAG:
return START_NODE;
case XmlPullParser.END_DOCUMENT:
case XmlPullParser.END_TAG:
return END_NODE;
case XmlPullParser.TEXT:
return TEXT;
case XmlPullParser.COMMENT:
return COMMENT;
default:
return OTHER;
}
} catch (XmlPullParserException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
protected String pullElementName() {
return parser.getName();
}
protected String pullText() {
return parser.getText();
}
public String getAttribute(String name) {
return parser.getAttributeValue(null, encodeAttribute(name));
}
public String getAttribute(int index) {
return parser.getAttributeValue(index);
}
public int getAttributeCount() {
return parser.getAttributeCount();
}
public String getAttributeName(int index) {
return decodeAttribute(parser.getAttributeName(index));
}
public void appendErrors(ErrorWriter errorWriter) {
errorWriter.add("line number", String.valueOf(parser.getLineNumber()));
}
public void close() {
try {
reader.close();
} catch (IOException e) {
throw new StreamException(e);
}
}
} jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/DomDriver.java 0000664 0001750 0001750 00000007506 12206661545 033306 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.UnsupportedEncodingException;
import java.io.Writer;
import java.net.URL;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.FactoryConfigurationError;
import javax.xml.parsers.ParserConfigurationException;
import org.w3c.dom.Document;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
public class DomDriver extends AbstractXmlDriver {
private final String encoding;
private final DocumentBuilderFactory documentBuilderFactory;
/**
* Construct a DomDriver.
*/
public DomDriver() {
this(null);
}
/**
* Construct a DomDriver with a specified encoding. The created DomReader will ignore any
* encoding attribute of the XML header though.
*/
public DomDriver(String encoding) {
this(encoding, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public DomDriver(String encoding, NameCoder nameCoder) {
super(nameCoder);
documentBuilderFactory = DocumentBuilderFactory.newInstance();
this.encoding = encoding;
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link #DomDriver(String, NameCoder)} instead.
*/
public DomDriver(String encoding, XmlFriendlyReplacer replacer) {
this(encoding, (NameCoder)replacer);
}
public HierarchicalStreamReader createReader(Reader in) {
return createReader(new InputSource(in));
}
public HierarchicalStreamReader createReader(InputStream in) {
return createReader(new InputSource(in));
}
public HierarchicalStreamReader createReader(URL in) {
return createReader(new InputSource(in.toExternalForm()));
}
public HierarchicalStreamReader createReader(File in) {
return createReader(new InputSource(in.toURI().toASCIIString()));
}
private HierarchicalStreamReader createReader(InputSource source) {
try {
DocumentBuilder documentBuilder = documentBuilderFactory.newDocumentBuilder();
if (encoding != null) {
source.setEncoding(encoding);
}
Document document = documentBuilder.parse(source);
return new DomReader(document, getNameCoder());
} catch (FactoryConfigurationError e) {
throw new StreamException(e);
} catch (ParserConfigurationException e) {
throw new StreamException(e);
} catch (SAXException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(Writer out) {
return new PrettyPrintWriter(out, getNameCoder());
}
public HierarchicalStreamWriter createWriter(OutputStream out) {
try {
return createWriter(encoding != null
? new OutputStreamWriter(out, encoding)
: new OutputStreamWriter(out));
} catch (UnsupportedEncodingException e) {
throw new StreamException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXmlReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXmlReader.j0000664 0001750 0001750 00000003646 12206661545 034273 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 04. June 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.AbstractReader;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* Abstract base implementation of HierarchicalStreamReader that provides common functionality
* to all XML-based readers.
*
* @author Mauro Talevi
* @author Jörg Schaible
* @since 1.2
* @deprecated As of 1.4, use {@link AbstractReader} instead.
*/
public abstract class AbstractXmlReader extends AbstractReader /* implements XmlFriendlyReader */ {
protected AbstractXmlReader() {
this(new XmlFriendlyNameCoder());
}
/**
* @deprecated As of 1.4, use {@link AbstractReader} instead.
*/
protected AbstractXmlReader(XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
protected AbstractXmlReader(NameCoder nameCoder) {
super(nameCoder);
}
/**
* Unescapes XML-friendly name (node or attribute)
*
* @param name the escaped XML-friendly name
* @return An unescaped name with original characters
* @deprecated As of 1.4, use {@link #decodeNode(String)} or {@link #decodeAttribute(String)} instead.
*/
public String unescapeXmlName(String name) {
return decodeNode(name);
}
/**
* Escapes XML-unfriendly name (node or attribute)
*
* @param name the unescaped XML-unfriendly name
* @return An escaped name with original characters
* @deprecated As of 1.4, use {@link AbstractReader} instead.
*/
protected String escapeXmlName(String name) {
return encodeNode(name);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/SaxWriter.java 0000664 0001750 0001750 00000062745 12206661545 033351 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 14. August 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.xml.sax.ContentHandler;
import org.xml.sax.DTDHandler;
import org.xml.sax.EntityResolver;
import org.xml.sax.ErrorHandler;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.SAXNotRecognizedException;
import org.xml.sax.SAXNotSupportedException;
import org.xml.sax.XMLReader;
import org.xml.sax.helpers.AttributesImpl;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
/**
* A SAX {@link org.xml.sax.XMLReader parser} that acts as an XStream
* {@link com.thoughtworks.xstream.io.HierarchicalStreamWriter} to enable direct generation of a
* SAX event flow from the XStream serialization of a list of list of Java objects. As a
* custom SAX parser, this class ignores the arguments of the two standard parse methods ({@link #parse(java.lang.String)}
* and {@link #parse(org.xml.sax.InputSource)}) but relies on a proprietary SAX property
* {@link #SOURCE_OBJECT_LIST_PROPERTY} to define the list of objects to serialize.
*
* Configuration of this SAX parser is achieved through the standard
* {@link #setProperty SAX property mechanism}. While specific setter methods require direct
* access to the parser instance, SAX properties support configuration settings to be propagated
* through a chain of {@link org.xml.sax.XMLFilter filters} down to the underlying parser
* object.
*
* This mechanism shall be used to configure the
* {@link #SOURCE_OBJECT_LIST_PROPERTY objects to be serialized} as well as the
* {@link #CONFIGURED_XSTREAM_PROPERTY XStream facade}.
*
*
* @author Laurent Bihanic
*/
public final class SaxWriter extends AbstractXmlWriter implements XMLReader {
/**
* The {@link #setProperty SAX property} to configure the XStream
* facade to be used for object serialization. If the property
* is not set, a new XStream facade will be allocated for each
* parse.
*/
public final static String CONFIGURED_XSTREAM_PROPERTY =
"http://com.thoughtworks.xstream/sax/property/configured-xstream";
/**
* The {@link #setProperty SAX property} to configure the list of
* Java objects to serialize. Setting this property prior
* invoking one of the parse() methods is mandatory.
*
* @see #parse(java.lang.String)
* @see #parse(org.xml.sax.InputSource)
*/
public final static String SOURCE_OBJECT_LIST_PROPERTY =
"http://com.thoughtworks.xstream/sax/property/source-object-list";
//=========================================================================
// SAX XMLReader interface support
//=========================================================================
/**
* The SAX EntityResolver associated to this XMLReader.
*/
private EntityResolver entityResolver = null;
/**
* The SAX DTDHandler associated to this XMLReader.
*/
private DTDHandler dtdHandler = null;
/**
* The SAX ContentHandler associated to this XMLReader.
*/
private ContentHandler contentHandler = null;
/**
* The SAX ErrorHandler associated to this XMLReader.
*/
private ErrorHandler errorHandler = null;
/**
* The SAX features defined for this XMLReader.
*
* This class does not define any feature (yet) and ignores
* the SAX mandatory feature. Thus, this member is present
* only to support the mandatory feature setting and retrieval
* logic defined by SAX.
*/
private Map features = new HashMap();
/**
* The SAX properties defined for this XMLReader.
*/
private final Map properties = new HashMap();
private final boolean includeEnclosingDocument;
/**
* @since 1.4
*/
public SaxWriter(NameCoder nameCoder)
{
this(true, nameCoder);
}
/**
* @since 1.4
*/
public SaxWriter(boolean includeEnclosingDocument, NameCoder nameCoder)
{
super(nameCoder);
this.includeEnclosingDocument = includeEnclosingDocument;
}
/**
* @deprecated As of 1.4 use {@link SaxWriter#SaxWriter(NameCoder)} instead.
*/
public SaxWriter(XmlFriendlyReplacer replacer)
{
this(true, replacer);
}
/**
* @deprecated As of 1.4 use {@link SaxWriter#SaxWriter(boolean, NameCoder)} instead.
*/
public SaxWriter(boolean includeEnclosingDocument, XmlFriendlyReplacer replacer)
{
this(includeEnclosingDocument, (NameCoder)replacer);
}
public SaxWriter(boolean includeEnclosingDocument) {
this(includeEnclosingDocument, new XmlFriendlyNameCoder());
}
public SaxWriter() {
this(true);
}
//-------------------------------------------------------------------------
// Configuration
//-------------------------------------------------------------------------
/**
* Sets the state of a feature.
*
* The feature name is any fully-qualified URI.
*
* All XMLReaders are required to support setting
* http://xml.org/sax/features/namespaces to
* true and
* http://xml.org/sax/features/namespace-prefixes to
* false.
*
* Some feature values may be immutable or mutable only
* in specific contexts, such as before, during, or after
* a parse.
*
* Note: This implementation only supports the two
* mandatory SAX features.
*
* @param name the feature name, which is a fully-qualified URI.
* @param value the requested state of the feature (true or false).
* @throws SAXNotRecognizedException when the XMLReader does not
* recognize the feature name.
* @see #getFeature
*/
public void setFeature(String name, boolean value)
throws SAXNotRecognizedException {
if ((name.equals("http://xml.org/sax/features/namespaces")) ||
(name.equals("http://xml.org/sax/features/namespace-prefixes"))) {
this.features.put(name, value ? Boolean.TRUE : Boolean.FALSE); // JDK 1.3 friendly
} else {
throw new SAXNotRecognizedException(name);
}
}
/**
* Looks up the value of a feature.
*
* The feature name is any fully-qualified URI. It is
* possible for an XMLReader to recognize a feature name but
* to be unable to return its value; this is especially true
* in the case of an adapter for a SAX1 Parser, which has
* no way of knowing whether the underlying parser is
* performing validation or expanding external entities.
*
* All XMLReaders are required to recognize the
* http://xml.org/sax/features/namespaces and the
* http://xml.org/sax/features/namespace-prefixes feature
* names.
*
* Some feature values may be available only in specific
* contexts, such as before, during, or after a parse.
*
* Implementors are free (and encouraged) to invent their own
* features, using names built on their own URIs.
*
* @param name the feature name, which is a fully-qualified URI.
* @return the current state of the feature (true or false).
* @throws SAXNotRecognizedException when the XMLReader does not
* recognize the feature name.
* @see #setFeature
*/
public boolean getFeature(String name)
throws SAXNotRecognizedException {
if ((name.equals("http://xml.org/sax/features/namespaces")) ||
(name.equals("http://xml.org/sax/features/namespace-prefixes"))) {
Boolean value = (Boolean) (this.features.get(name));
if (value == null) {
value = Boolean.FALSE;
}
return value.booleanValue();
} else {
throw new SAXNotRecognizedException(name);
}
}
/**
* Sets the value of a property.
*
* The property name is any fully-qualified URI. It is
* possible for an XMLReader to recognize a property name but
* to be unable to set its value.
*
* XMLReaders are not required to recognize setting any
* specific property names, though a core set is provided with
* SAX2.
*
* Some property values may be immutable or mutable only
* in specific contexts, such as before, during, or after
* a parse.
*
* This method is also the standard mechanism for setting
* extended handlers.
*
* Note: This implementation only supports two
* (proprietary) properties: {@link #CONFIGURED_XSTREAM_PROPERTY}
* and {@link #SOURCE_OBJECT_LIST_PROPERTY}.
*
* @param name the property name, which is a fully-qualified URI.
* @param value the requested value for the property.
* @throws SAXNotRecognizedException when the XMLReader does not
* recognize the property name.
* @throws SAXNotSupportedException when the XMLReader recognizes
* the property name but cannot set
* the requested value.
* @see #getProperty
*/
public void setProperty(String name, Object value)
throws SAXNotRecognizedException,
SAXNotSupportedException {
if (name.equals(CONFIGURED_XSTREAM_PROPERTY)) {
if (!(value instanceof XStream)) {
throw new SAXNotSupportedException("Value for property \"" +
CONFIGURED_XSTREAM_PROPERTY +
"\" must be a non-null XStream object");
}
} else if (name.equals(SOURCE_OBJECT_LIST_PROPERTY)) {
if (value instanceof List) {
List list = (List) value;
if (list.isEmpty()) {
throw new SAXNotSupportedException("Value for property \"" +
SOURCE_OBJECT_LIST_PROPERTY +
"\" shall not be an empty list");
} else {
// Perform a copy of the list to prevent the application to
// modify its content while the parse is being performed.
value = Collections.unmodifiableList(new ArrayList(list));
}
} else {
throw new SAXNotSupportedException("Value for property \"" +
SOURCE_OBJECT_LIST_PROPERTY +
"\" must be a non-null List object");
}
} else {
throw new SAXNotRecognizedException(name);
}
this.properties.put(name, value);
}
/**
* Looks up the value of a property.
*
* The property name is any fully-qualified URI. It is
* possible for an XMLReader to recognize a property name but
* to be unable to return its state.
*
* XMLReaders are not required to recognize any specific
* property names, though an initial core set is documented for
* SAX2.
*
* Some property values may be available only in specific
* contexts, such as before, during, or after a parse.
*
* Implementors are free (and encouraged) to invent their own properties,
* using names built on their own URIs.
*
* @param name the property name, which is a fully-qualified URI.
* @return the current value of the property.
* @throws SAXNotRecognizedException when the XMLReader does not
* recognize the property name.
* @see #getProperty
*/
public Object getProperty(String name)
throws SAXNotRecognizedException {
if ((name.equals(CONFIGURED_XSTREAM_PROPERTY)) ||
(name.equals(SOURCE_OBJECT_LIST_PROPERTY))) {
return this.properties.get(name);
} else {
throw new SAXNotRecognizedException(name);
}
}
//---------------------------------------------------------------------
// Event handlers
//---------------------------------------------------------------------
/**
* Allows an application to register an entity resolver.
*
* If the application does not register an entity resolver,
* the XMLReader will perform its own default resolution.
*
* Applications may register a new or different resolver in the
* middle of a parse, and the SAX parser must begin using the new
* resolver immediately.
*
* @param resolver the entity resolver.
* @throws NullPointerException if the resolver argument is
* null.
* @see #getEntityResolver
*/
public void setEntityResolver(EntityResolver resolver) {
if (resolver == null) {
throw new NullPointerException("resolver");
}
this.entityResolver = resolver;
return;
}
/**
* Returns the current entity resolver.
*
* @return the current entity resolver, or null if none
* has been registered.
* @see #setEntityResolver
*/
public EntityResolver getEntityResolver() {
return this.entityResolver;
}
/**
* Allows an application to register a DTD event handler.
*
* If the application does not register a DTD handler, all DTD
* events reported by the SAX parser will be silently ignored.
*
* Applications may register a new or different handler in the
* middle of a parse, and the SAX parser must begin using the new
* handler immediately.
*
* @param handler the DTD handler.
* @throws NullPointerException if the handler argument is
* null.
* @see #getDTDHandler
*/
public void setDTDHandler(DTDHandler handler) {
if (handler == null) {
throw new NullPointerException("handler");
}
this.dtdHandler = handler;
return;
}
/**
* Returns the current DTD handler.
*
* @return the current DTD handler, or null if none
* has been registered.
* @see #setDTDHandler
*/
public DTDHandler getDTDHandler() {
return this.dtdHandler;
}
/**
* Allows an application to register a content event handler.
*
* If the application does not register a content handler, all
* content events reported by the SAX parser will be silently
* ignored.
*
* Applications may register a new or different handler in the
* middle of a parse, and the SAX parser must begin using the new
* handler immediately.
*
* @param handler the content handler.
* @throws NullPointerException if the handler argument is
* null.
* @see #getContentHandler
*/
public void setContentHandler(ContentHandler handler) {
if (handler == null) {
throw new NullPointerException("handler");
}
this.contentHandler = handler;
return;
}
/**
* Returns the current content handler.
*
* @return the current content handler, or null if none
* has been registered.
* @see #setContentHandler
*/
public ContentHandler getContentHandler() {
return this.contentHandler;
}
/**
* Allows an application to register an error event handler.
*
* If the application does not register an error handler, all
* error events reported by the SAX parser will be silently
* ignored; however, normal processing may not continue. It is
* highly recommended that all SAX applications implement an
* error handler to avoid unexpected bugs.
*
* Applications may register a new or different handler in the
* middle of a parse, and the SAX parser must begin using the new
* handler immediately.
*
* @param handler the error handler.
* @throws NullPointerException if the handler argument is
* null.
* @see #getErrorHandler
*/
public void setErrorHandler(ErrorHandler handler) {
if (handler == null) {
throw new NullPointerException("handler");
}
this.errorHandler = handler;
return;
}
/**
* Returns the current error handler.
*
* @return the current error handler, or null if none
* has been registered.
* @see #setErrorHandler
*/
public ErrorHandler getErrorHandler() {
return this.errorHandler;
}
//---------------------------------------------------------------------
// Parsing
//---------------------------------------------------------------------
/**
* Parses an XML document from a system identifier (URI).
*
* This method is a shortcut for the common case of reading a
* document from a system identifier. It is the exact
* equivalent of the following:
*
*
* parse(new InputSource(systemId));
*
*
*
* If the system identifier is a URL, it must be fully resolved
* by the application before it is passed to the parser.
*
* Note: As a custom SAX parser, this class
* ignores the systemId argument of this method
* and relies on the proprietary SAX property
* {@link #SOURCE_OBJECT_LIST_PROPERTY}) to define the list of
* objects to serialize.
*
* @param systemId the system identifier (URI).
* @throws SAXException Any SAX exception, possibly wrapping
* another exception.
* @see #parse(org.xml.sax.InputSource)
*/
public void parse(String systemId) throws SAXException {
this.parse();
}
/**
* Parse an XML document.
*
* The application can use this method to instruct the XML
* reader to begin parsing an XML document from any valid input
* source (a character stream, a byte stream, or a URI).
*
* Applications may not invoke this method while a parse is in
* progress (they should create a new XMLReader instead for each
* nested XML document). Once a parse is complete, an
* application may reuse the same XMLReader object, possibly
* with a different input source.
*
* During the parse, the XMLReader will provide information
* about the XML document through the registered event
* handlers.
*
* This method is synchronous: it will not return until parsing
* has ended. If a client application wants to terminate
* parsing early, it should throw an exception.
*
* Note: As a custom SAX parser, this class
* ignores the source argument of this method
* and relies on the proprietary SAX property
* {@link #SOURCE_OBJECT_LIST_PROPERTY}) to define the list of
* objects to serialize.
*
* @param input The input source for the top-level of the
* XML document.
* @throws SAXException Any SAX exception, possibly wrapping
* another exception.
* @see org.xml.sax.InputSource
* @see #parse(java.lang.String)
* @see #setEntityResolver
* @see #setDTDHandler
* @see #setContentHandler
* @see #setErrorHandler
*/
public void parse(InputSource input) throws SAXException {
this.parse();
}
/**
* Serializes the Java objects of the configured list into a flow
* of SAX events.
*
* @throws SAXException if the configured object list is invalid
* or object serialization failed.
*/
private void parse() throws SAXException {
XStream xstream = (XStream) (this.properties.get(CONFIGURED_XSTREAM_PROPERTY));
if (xstream == null) {
xstream = new XStream();
}
List source = (List) (this.properties.get(SOURCE_OBJECT_LIST_PROPERTY));
if ((source == null) || (source.isEmpty())) {
throw new SAXException("Missing or empty source object list. Setting property \"" +
SOURCE_OBJECT_LIST_PROPERTY + "\" is mandatory");
}
try {
this.startDocument(true);
for (Iterator i = source.iterator(); i.hasNext();) {
xstream.marshal(i.next(), this);
}
this.endDocument(true);
} catch (StreamException e) {
if (e.getCause() instanceof SAXException) {
throw (SAXException) (e.getCause());
} else {
throw new SAXException(e);
}
}
}
//=========================================================================
// XStream HierarchicalStreamWriter interface support
//=========================================================================
private int depth = 0;
private List elementStack = new LinkedList();
private char[] buffer = new char[128];
private boolean startTagInProgress = false;
private final AttributesImpl attributeList = new AttributesImpl();
public void startNode(String name) {
try {
if (this.depth != 0) {
this.flushStartTag();
} else if (includeEnclosingDocument) {
this.startDocument(false);
}
this.elementStack.add(0, escapeXmlName(name));
this.startTagInProgress = true;
this.depth++;
} catch (SAXException e) {
throw new StreamException(e);
}
}
public void addAttribute(String name, String value) {
if (this.startTagInProgress) {
String escapedName = escapeXmlName(name);
this.attributeList.addAttribute("", escapedName, escapedName, "CDATA", value);
} else {
throw new StreamException(new IllegalStateException("No startElement being processed"));
}
}
public void setValue(String text) {
try {
this.flushStartTag();
int lg = text.length();
if (lg > buffer.length) {
buffer = new char[lg];
}
text.getChars(0, lg, buffer, 0);
this.contentHandler.characters(buffer, 0, lg);
} catch (SAXException e) {
throw new StreamException(e);
}
}
public void endNode() {
try {
this.flushStartTag();
String tagName = (String) (this.elementStack.remove(0));
this.contentHandler.endElement("", tagName, tagName);
this.depth--;
if (this.depth == 0 && includeEnclosingDocument) {
this.endDocument(false);
}
} catch (SAXException e) {
throw new StreamException(e);
}
}
/**
* Fires the SAX startDocument event towards the configured
* ContentHandler.
*
* @param multiObjectMode whether serialization of several
* object will be merge into a single
* SAX document.
* @throws SAXException if thrown by the ContentHandler.
*/
private void startDocument(boolean multiObjectMode) throws SAXException {
if (this.depth == 0) {
// Notify contentHandler of document start.
this.contentHandler.startDocument();
if (multiObjectMode) {
// Prevent marshalling of each object to fire its own
// start/endDocument events.
this.depth++;
}
}
}
/**
* Fires the SAX endDocument event towards the configured
* ContentHandler.
*
* @param multiObjectMode whether serialization of several
* object will be merge into a single
* SAX document.
* @throws SAXException if thrown by the ContentHandler.
*/
private void endDocument(boolean multiObjectMode) throws SAXException {
if ((this.depth == 0) || ((this.depth == 1) && (multiObjectMode))) {
this.contentHandler.endDocument();
this.depth = 0;
}
}
/**
* Fires any pending SAX startElement event towards the
* configured ContentHandler.
*
* @throws SAXException if thrown by the ContentHandler.
*/
private void flushStartTag() throws SAXException {
if (this.startTagInProgress) {
String tagName = (String) (this.elementStack.get(0));
this.contentHandler.startElement("", tagName,
tagName, this.attributeList);
this.attributeList.clear();
this.startTagInProgress = false;
}
}
public void flush() {
// don't need to do anything
}
public void close() {
// don't need to do anything
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXppDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXppDriver.j0000664 0001750 0001750 00000005142 12206661545 034324 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.core.util.XmlHeaderAwareReader;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.UnsupportedEncodingException;
import java.io.Writer;
/**
* An abstract base class for a driver using an XPP implementation.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.4
*/
public abstract class AbstractXppDriver extends AbstractXmlDriver {
/**
* Construct an AbstractXppDriver.
*
* @param nameCoder the replacer for XML friendly tag and attribute names
* @since 1.4
*/
public AbstractXppDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader createReader(Reader in) {
try {
return new XppReader(in, createParser(), getNameCoder());
} catch (XmlPullParserException e) {
throw new StreamException("Cannot create XmlPullParser");
}
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader createReader(InputStream in) {
try {
return createReader(new XmlHeaderAwareReader(in));
} catch (UnsupportedEncodingException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamWriter createWriter(Writer out) {
return new PrettyPrintWriter(out, getNameCoder());
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamWriter createWriter(OutputStream out) {
return createWriter(new OutputStreamWriter(out));
}
/**
* Create the parser of the XPP implementation.
* @throws XmlPullParserException if the parser cannot be created
* @since 1.4
*/
protected abstract XmlPullParser createParser() throws XmlPullParserException;
}
././@LongLink 0000644 0000000 0000000 00000000163 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XStream11XmlFriendlyReplacer.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XStream11XmlFriendl0000664 0001750 0001750 00000003046 12206661545 034200 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 22. April 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.xml;
/**
* Allows replacement of Strings in xml-friendly drivers to provide compatibility with XStream
* 1.1 format
*
* @author Mauro Talevi
* @since 1.2
* @deprecated As of 1.4, use {@link XStream11NameCoder} instead
*/
public class XStream11XmlFriendlyReplacer extends XmlFriendlyReplacer {
/**
* Default constructor.
*
* @deprecated As of 1.4, use {@link XStream11NameCoder} instead
*/
public XStream11XmlFriendlyReplacer() {
}
/**
* {@inheritDoc} Noop implementation that does not decode. Used for XStream 1.1
* compatibility.
*/
public String decodeAttribute(String attributeName) {
return attributeName;
}
/**
* {@inheritDoc} Noop implementation that does not decode. Used for XStream 1.1
* compatibility.
*/
public String decodeNode(String elementName) {
return elementName;
}
/**
* Noop implementation that does not unescape name. Used for XStream 1.1 compatibility.
*
* @param name the name of attribute or node
* @return The String with unescaped name
*/
public String unescapeName(String name) {
return name;
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXmlWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXmlWriter.j0000664 0001750 0001750 00000003045 12206661545 034336 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 04. June 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.AbstractWriter;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* Abstract base implementation of HierarchicalStreamWriter that provides common functionality
* to all XML-based writers.
*
* @author Mauro Talevi
* @author Jörg Schaible
* @since 1.2
* @deprecated As of 1.4 use {@link AbstractWriter} instead
*/
public abstract class AbstractXmlWriter extends AbstractWriter implements XmlFriendlyWriter {
protected AbstractXmlWriter(){
this(new XmlFriendlyNameCoder());
}
/**
* @deprecated As of 1.4
*/
protected AbstractXmlWriter(XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
protected AbstractXmlWriter(NameCoder nameCoder) {
super(nameCoder);
}
/**
* Escapes XML name (node or attribute) to be XML-friendly
*
* @param name the unescaped XML name
* @return An escaped name with original characters replaced
* @deprecated As of 1.4 use {@link #encodeNode(String)} or {@link #encodeAttribute(String)} instead
*/
public String escapeXmlName(String name) {
return super.encodeNode(name);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/DomReader.java 0000664 0001750 0001750 00000010015 12206661545 033242 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.w3c.dom.Attr;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
import org.w3c.dom.Text;
import java.util.ArrayList;
import java.util.List;
public class DomReader extends AbstractDocumentReader {
private Element currentElement;
private StringBuffer textBuffer;
private List childElements;
public DomReader(Element rootElement) {
this(rootElement, new XmlFriendlyNameCoder());
}
public DomReader(Document document) {
this(document.getDocumentElement());
}
/**
* @since 1.4
*/
public DomReader(Element rootElement, NameCoder nameCoder) {
super(rootElement, nameCoder);
textBuffer = new StringBuffer();
}
/**
* @since 1.4
*/
public DomReader(Document document, NameCoder nameCoder) {
this(document.getDocumentElement(), nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link DomReader#DomReader(Element, NameCoder)} instead.
*/
public DomReader(Element rootElement, XmlFriendlyReplacer replacer) {
this(rootElement, (NameCoder)replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link DomReader#DomReader(Document, NameCoder)} instead.
*/
public DomReader(Document document, XmlFriendlyReplacer replacer) {
this(document.getDocumentElement(), (NameCoder)replacer);
}
public String getNodeName() {
return decodeNode(currentElement.getTagName());
}
public String getValue() {
NodeList childNodes = currentElement.getChildNodes();
textBuffer.setLength(0);
int length = childNodes.getLength();
for (int i = 0; i < length; i++) {
Node childNode = childNodes.item(i);
if (childNode instanceof Text) {
Text text = (Text) childNode;
textBuffer.append(text.getData());
}
}
return textBuffer.toString();
}
public String getAttribute(String name) {
Attr attribute = currentElement.getAttributeNode(encodeAttribute(name));
return attribute == null ? null : attribute.getValue();
}
public String getAttribute(int index) {
return ((Attr) currentElement.getAttributes().item(index)).getValue();
}
public int getAttributeCount() {
return currentElement.getAttributes().getLength();
}
public String getAttributeName(int index) {
return decodeAttribute(((Attr) currentElement.getAttributes().item(index)).getName());
}
protected Object getParent() {
return currentElement.getParentNode();
}
protected Object getChild(int index) {
return childElements.get(index);
}
protected int getChildCount() {
return childElements.size();
}
protected void reassignCurrentElement(Object current) {
currentElement = (Element) current;
NodeList childNodes = currentElement.getChildNodes();
childElements = new ArrayList();
for (int i = 0; i < childNodes.getLength(); i++) {
Node node = childNodes.item(i);
if (node instanceof Element) {
childElements.add(node);
}
}
}
public String peekNextChild() {
NodeList childNodes = currentElement.getChildNodes();
for (int i = 0; i < childNodes.getLength(); i++) {
Node node = childNodes.item(i);
if (node instanceof Element) {
return decodeNode(((Element) node).getTagName());
}
}
return null;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/Xpp3DomDriver.java 0000664 0001750 0001750 00000002301 12206661545 034045 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 03. May 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.xmlpull.mxp1.MXParser;
import org.xmlpull.v1.XmlPullParser;
/**
* A {@link HierarchicalStreamDriver} for XPP DOM using the Xpp3 parser.
*
* @author Jörg Schaible
* @since 1.4
*/
public class Xpp3DomDriver extends AbstractXppDomDriver {
/**
* Construct an Xpp3DomDriver.
*
* @since 1.4
*/
public Xpp3DomDriver() {
super(new XmlFriendlyNameCoder());
}
/**
* Construct an Xpp3DomDriver.
*
* @param nameCoder the replacer for XML friendly names
* @since 1.4
*/
public Xpp3DomDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* {@inheritDoc}
*/
protected XmlPullParser createParser() {
return new MXParser();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/DocumentWriter.java0000664 0001750 0001750 00000002407 12206661545 034361 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 18. October 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import java.util.List;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* A generic interface for all {@link HierarchicalStreamWriter} implementations generating a
* DOM.
*
* @author Jörg Schaible
* @since 1.2.1
*/
public interface DocumentWriter extends HierarchicalStreamWriter {
/**
* Retrieve a {@link List} with the top elements. In the standard use case this list will
* only contain a single element. Additional elements can only occur, if
* {@link HierarchicalStreamWriter#startNode(String)} of the implementing
* {@link HierarchicalStreamWriter} was called multiple times with an empty node stack. Such
* a situation occurs calling
* {@link com.thoughtworks.xstream.XStream#marshal(Object, HierarchicalStreamWriter)}
* multiple times directly.
*
* @return a {@link List} with top nodes
* @since 1.2.1
*/
List getTopLevelNodes();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/DocumentReader.java0000664 0001750 0001750 00000001440 12206661545 034303 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 18. October 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
/**
* A generic interface for all {@link HierarchicalStreamReader} implementations reading a DOM.
*
* @author Jörg Schaible
* @since 1.2.1
*/
public interface DocumentReader extends HierarchicalStreamReader {
/**
* Retrieve the current processed node of the DOM.
*
* @return the current node
* @since 1.2.1
*/
public Object getCurrent();
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/PrettyPrintWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/PrettyPrintWriter.j0000664 0001750 0001750 00000026147 12206661545 034426 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.core.util.QuickWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.io.Writer;
/**
* A simple writer that outputs XML in a pretty-printed indented stream.
*
* By default, the chars
* & < > " ' \r
*
are escaped and replaced with a suitable XML entity. To alter this behavior, override
* the the {@link #writeText(com.thoughtworks.xstream.core.util.QuickWriter, String)} and
* {@link #writeAttributeValue(com.thoughtworks.xstream.core.util.QuickWriter, String)} methods.
*
*
* Note: Depending on the XML version some characters cannot be written. Especially a 0
* character is never valid in XML, neither directly nor as entity nor within CDATA. However, this writer
* works by default in a quirks mode, where it will write any character at least as character entity (even
* a null character). You may switch into XML_1_1 mode (which supports most characters) or XML_1_0
* that does only support a very limited number of control characters. See XML specification for version
* 1.0 or
* 1.1. If a character is
* not supported, a {@link StreamException} is thrown. Select a proper parser implementation that
* respects the version in the XML header (the Xpp3 parser will also read character entities of normally
* invalid characters).
*
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class PrettyPrintWriter extends AbstractXmlWriter {
public static int XML_QUIRKS = -1;
public static int XML_1_0 = 0;
public static int XML_1_1 = 1;
private final QuickWriter writer;
private final FastStack elementStack = new FastStack(16);
private final char[] lineIndenter;
private final int mode;
private boolean tagInProgress;
protected int depth;
private boolean readyForNewLine;
private boolean tagIsEmpty;
private String newLine;
private static final char[] NULL = "�".toCharArray();
private static final char[] AMP = "&".toCharArray();
private static final char[] LT = "<".toCharArray();
private static final char[] GT = ">".toCharArray();
private static final char[] CR = "
".toCharArray();
private static final char[] QUOT = """.toCharArray();
private static final char[] APOS = "'".toCharArray();
private static final char[] CLOSE = " XML_1_1) {
throw new IllegalArgumentException("Not a valid XML mode");
}
}
/**
* @since 1.2
* @deprecated As of 1.3
*/
public PrettyPrintWriter(
Writer writer, char[] lineIndenter, String newLine, XmlFriendlyReplacer replacer) {
this(writer, XML_QUIRKS, lineIndenter, replacer, newLine);
}
/**
* @since 1.4
*/
public PrettyPrintWriter(
Writer writer, int mode, char[] lineIndenter, NameCoder nameCoder) {
this(writer, mode, lineIndenter, nameCoder, "\n");
}
/**
* @since 1.3
* @deprecated As of 1.4 use {@link PrettyPrintWriter#PrettyPrintWriter(Writer, int, char[], NameCoder)} instead
*/
public PrettyPrintWriter(
Writer writer, int mode, char[] lineIndenter, XmlFriendlyReplacer replacer) {
this(writer, mode, lineIndenter, replacer, "\n");
}
/**
* @deprecated As of 1.3
*/
public PrettyPrintWriter(Writer writer, char[] lineIndenter, String newLine) {
this(writer, lineIndenter, newLine, new XmlFriendlyReplacer());
}
/**
* @since 1.3
*/
public PrettyPrintWriter(Writer writer, int mode, char[] lineIndenter) {
this(writer, mode, lineIndenter, new XmlFriendlyNameCoder());
}
public PrettyPrintWriter(Writer writer, char[] lineIndenter) {
this(writer, XML_QUIRKS, lineIndenter);
}
/**
* @deprecated As of 1.3
*/
public PrettyPrintWriter(Writer writer, String lineIndenter, String newLine) {
this(writer, lineIndenter.toCharArray(), newLine);
}
/**
* @since 1.3
*/
public PrettyPrintWriter(Writer writer, int mode, String lineIndenter) {
this(writer, mode, lineIndenter.toCharArray());
}
public PrettyPrintWriter(Writer writer, String lineIndenter) {
this(writer, lineIndenter.toCharArray());
}
/**
* @since 1.4
*/
public PrettyPrintWriter(Writer writer, int mode, NameCoder nameCoder) {
this(writer, mode, new char[]{' ', ' '}, nameCoder);
}
/**
* @since 1.3
* @deprecated As of 1.4 use {@link PrettyPrintWriter#PrettyPrintWriter(Writer, int, NameCoder)} instead
*/
public PrettyPrintWriter(Writer writer, int mode, XmlFriendlyReplacer replacer) {
this(writer, mode, new char[]{' ', ' '}, replacer);
}
/**
* @since 1.4
*/
public PrettyPrintWriter(Writer writer, NameCoder nameCoder) {
this(writer, XML_QUIRKS, new char[]{' ', ' '}, nameCoder, "\n");
}
/**
* @deprecated As of 1.4 use {@link PrettyPrintWriter#PrettyPrintWriter(Writer, NameCoder)} instead.
*/
public PrettyPrintWriter(Writer writer, XmlFriendlyReplacer replacer) {
this(writer, new char[]{' ', ' '}, "\n", replacer);
}
/**
* @since 1.3
*/
public PrettyPrintWriter(Writer writer, int mode) {
this(writer, mode, new char[]{' ', ' '});
}
public PrettyPrintWriter(Writer writer) {
this(writer, new char[]{' ', ' '});
}
public void startNode(String name) {
String escapedName = encodeNode(name);
tagIsEmpty = false;
finishTag();
writer.write('<');
writer.write(escapedName);
elementStack.push(escapedName);
tagInProgress = true;
depth++ ;
readyForNewLine = true;
tagIsEmpty = true;
}
public void startNode(String name, Class clazz) {
startNode(name);
}
public void setValue(String text) {
readyForNewLine = false;
tagIsEmpty = false;
finishTag();
writeText(writer, text);
}
public void addAttribute(String key, String value) {
writer.write(' ');
writer.write(encodeAttribute(key));
writer.write('=');
writer.write('\"');
writeAttributeValue(writer, value);
writer.write('\"');
}
protected void writeAttributeValue(QuickWriter writer, String text) {
writeText(text, true);
}
protected void writeText(QuickWriter writer, String text) {
writeText(text, false);
}
private void writeText(String text, boolean isAttribute) {
int length = text.length();
for (int i = 0; i < length; i++ ) {
char c = text.charAt(i);
switch (c) {
case '\0':
if (mode == XML_QUIRKS) {
this.writer.write(NULL);
} else {
throw new StreamException("Invalid character 0x0 in XML stream");
}
break;
case '&':
this.writer.write(AMP);
break;
case '<':
this.writer.write(LT);
break;
case '>':
this.writer.write(GT);
break;
case '"':
this.writer.write(QUOT);
break;
case '\'':
this.writer.write(APOS);
break;
case '\r':
this.writer.write(CR);
break;
case '\t':
case '\n':
if (!isAttribute) {
this.writer.write(c);
break;
}
default:
if (Character.isDefined(c) && !Character.isISOControl(c)) {
if (mode != XML_QUIRKS) {
if (c > '\ud7ff' && c < '\ue000') {
throw new StreamException("Invalid character 0x"
+ Integer.toHexString(c)
+ " in XML stream");
}
}
this.writer.write(c);
} else {
if (mode == XML_1_0) {
if (c < 9
|| c == '\u000b'
|| c == '\u000c'
|| c == '\u000e'
|| (c >= '\u000f' && c <= '\u001f')) {
throw new StreamException("Invalid character 0x"
+ Integer.toHexString(c)
+ " in XML 1.0 stream");
}
}
if (mode != XML_QUIRKS) {
if (c == '\ufffe' || c == '\uffff') {
throw new StreamException("Invalid character 0x"
+ Integer.toHexString(c)
+ " in XML stream");
}
}
this.writer.write("&#x");
this.writer.write(Integer.toHexString(c));
this.writer.write(';');
}
}
}
}
public void endNode() {
depth-- ;
if (tagIsEmpty) {
writer.write('/');
readyForNewLine = false;
finishTag();
elementStack.popSilently();
} else {
finishTag();
writer.write(CLOSE);
writer.write((String)elementStack.pop());
writer.write('>');
}
readyForNewLine = true;
if (depth == 0) {
writer.flush();
}
}
private void finishTag() {
if (tagInProgress) {
writer.write('>');
}
tagInProgress = false;
if (readyForNewLine) {
endOfLine();
}
readyForNewLine = false;
tagIsEmpty = false;
}
protected void endOfLine() {
writer.write(getNewLine());
for (int i = 0; i < depth; i++ ) {
writer.write(lineIndenter);
}
}
public void flush() {
writer.flush();
}
public void close() {
writer.close();
}
protected String getNewLine() {
return newLine;
}
}
././@LongLink 0000644 0000000 0000000 00000000151 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractPullReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractPullReader.0000664 0001750 0001750 00000014500 12206661545 034264 0 ustar jamespage jamespage /*
* Copyright (C) 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2010, 2011 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 24. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import java.util.Iterator;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.io.AttributeNameIterator;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* Base class that contains common functionality across HierarchicalStreamReader implementations
* that need to read from a pull parser.
*
* @author Joe Walnes
* @author James Strachan
*/
public abstract class AbstractPullReader extends AbstractXmlReader {
protected static final int START_NODE = 1;
protected static final int END_NODE = 2;
protected static final int TEXT = 3;
protected static final int COMMENT = 4;
protected static final int OTHER = 0;
private final FastStack elementStack = new FastStack(16);
private final FastStack pool = new FastStack(16);
private final FastStack lookahead = new FastStack(4);
private final FastStack lookback = new FastStack(4);
private boolean marked;
private static class Event {
int type;
String value;
}
/**
* @since 1.4
*/
protected AbstractPullReader(NameCoder nameCoder) {
super(nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link AbstractPullReader#AbstractPullReader(NameCoder)} instead
*/
protected AbstractPullReader(XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
/**
* Pull the next event from the stream.
*
*
This MUST return {@link #START_NODE}, {@link #END_NODE}, {@link #TEXT}, {@link #COMMENT},
* {@link #OTHER} or throw {@link com.thoughtworks.xstream.io.StreamException}.
*
*
The underlying pull parser will most likely return its own event types. These must be
* mapped to the appropriate events.
*/
protected abstract int pullNextEvent();
/**
* Pull the name of the current element from the stream.
*/
protected abstract String pullElementName();
/**
* Pull the contents of the current text node from the stream.
*/
protected abstract String pullText();
public boolean hasMoreChildren() {
mark();
while (true) {
switch (readEvent().type) {
case START_NODE:
reset();
return true;
case END_NODE:
reset();
return false;
default:
continue;
}
}
}
public void moveDown() {
int currentDepth = elementStack.size();
while (elementStack.size() <= currentDepth) {
move();
if (elementStack.size() < currentDepth) {
throw new RuntimeException(); // sanity check
}
}
}
public void moveUp() {
int currentDepth = elementStack.size();
while (elementStack.size() >= currentDepth) {
move();
}
}
private void move() {
final Event event = readEvent();
pool.push(event);
switch (event.type) {
case START_NODE:
elementStack.push(pullElementName());
break;
case END_NODE:
elementStack.pop();
break;
}
}
private Event readEvent() {
if (marked) {
if (lookback.hasStuff()) {
return (Event) lookahead.push(lookback.pop());
} else {
return (Event) lookahead.push(readRealEvent());
}
} else {
if (lookback.hasStuff()) {
return (Event) lookback.pop();
} else {
return readRealEvent();
}
}
}
private Event readRealEvent() {
Event event = pool.hasStuff() ? (Event)pool.pop() : new Event();
event.type = pullNextEvent();
if (event.type == TEXT) {
event.value = pullText();
} else if (event.type == START_NODE) {
event.value = pullElementName();
} else {
event.value = null;
}
return event;
}
public void mark() {
marked = true;
}
public void reset() {
while(lookahead.hasStuff()) {
lookback.push(lookahead.pop());
}
marked = false;
}
public String getValue() {
// we should collapse together any text which
// contains comments
// lets only use a string buffer when we get 2 strings
// to avoid copying strings
String last = null;
StringBuffer buffer = null;
mark();
Event event = readEvent();
while (true) {
if (event.type == TEXT) {
String text = event.value;
if (text != null && text.length() > 0) {
if (last == null) {
last = text;
} else {
if (buffer == null) {
buffer = new StringBuffer(last);
}
buffer.append(text);
}
}
} else if (event.type != COMMENT) {
break;
}
event = readEvent();
}
reset();
if (buffer != null) {
return buffer.toString();
} else {
return (last == null) ? "" : last;
}
}
public Iterator getAttributeNames() {
return new AttributeNameIterator(this);
}
public String getNodeName() {
return unescapeXmlName((String) elementStack.peek());
}
public String peekNextChild() {
mark();
while (true) {
Event ev = readEvent();
switch (ev.type) {
case START_NODE:
reset();
return ev.value;
case END_NODE:
reset();
return null;
default:
continue;
}
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/DomWriter.java 0000664 0001750 0001750 00000006077 12206661545 033331 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 02. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
/**
* @author Michael Kopp
*/
public class DomWriter extends AbstractDocumentWriter {
private final Document document;
private boolean hasRootElement;
public DomWriter(final Document document) {
this(document, new XmlFriendlyNameCoder());
}
public DomWriter(final Element rootElement) {
this(rootElement, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public DomWriter(final Document document, final NameCoder nameCoder) {
this(document.getDocumentElement(), document, nameCoder);
}
/**
* @since 1.4
*/
public DomWriter(final Element element, final Document document, final NameCoder nameCoder) {
super(element, nameCoder);
this.document = document;
hasRootElement = document.getDocumentElement() != null;
}
/**
* @since 1.4
*/
public DomWriter(final Element rootElement, final NameCoder nameCoder) {
this(rootElement, rootElement.getOwnerDocument(), nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link DomWriter#DomWriter(Document, NameCoder)} instead.
*/
public DomWriter(final Document document, final XmlFriendlyReplacer replacer) {
this(document.getDocumentElement(), document, (NameCoder)replacer);
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link DomWriter#DomWriter(Element, Document, NameCoder)} instead.
*/
public DomWriter(final Element element, final Document document, final XmlFriendlyReplacer replacer) {
this(element, document, (NameCoder)replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link DomWriter#DomWriter(Element, NameCoder)} instead.
*/
public DomWriter(final Element rootElement, final XmlFriendlyReplacer replacer) {
this(rootElement, rootElement.getOwnerDocument(), (NameCoder)replacer);
}
protected Object createNode(final String name) {
final Element child = document.createElement(encodeNode(name));
final Element top = top();
if (top != null) {
top().appendChild(child);
} else if (!hasRootElement) {
document.appendChild(child);
hasRootElement = true;
}
return child;
}
public void addAttribute(final String name, final String value) {
top().setAttribute(encodeAttribute(name), value);
}
public void setValue(final String text) {
top().appendChild(document.createTextNode(text));
}
private Element top() {
return (Element)getCurrent();
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyNameCoder.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyNameCode0000664 0001750 0001750 00000024110 12206661545 034312 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 15. August 2009 by Joerg Schaible, copied from XmlFriendlyReplacer.
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.converters.reflection.ObjectAccessException;
import com.thoughtworks.xstream.core.util.WeakCache;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.util.ArrayList;
import java.util.Map;
/**
* Encode and decode tag and attribute names in XML drivers.
*
* This NameCoder is designed to ensure the correct encoding and decoding of names used for Java
* types and fields to XML tags and attribute names.
*
*
* The default replacements are:
*
*
*
$ (dollar) chars are replaced with _- (underscore dash) string.
*
_ (underscore) chars are replaced with __ (double underscore) string.
*
other characters that are invalid in XML names are encoded with _.XXXX (underscore
* dot followed by hex representation of character).
*
*
* @author Jörg Schaible
* @author Mauro Talevi
* @author Tatu Saloranta
* @author Michael Schnell
* @see XML 1.0 name definition
* @see XML 1.1 name definition
* @see Java
* identifier definition
* @since 1.4
*/
public class XmlFriendlyNameCoder implements NameCoder, Cloneable {
private static final IntPair[] XML_NAME_START_CHAR_BOUNDS;
private static final IntPair[] XML_NAME_CHAR_EXTRA_BOUNDS;
static {
class IntPairList extends ArrayList {
void add(int min, int max) {
super.add(new IntPair(min, max));
}
void add(char cp) {
super.add(new IntPair(cp, cp));
}
}
// legal characters in XML names according to
// http://www.w3.org/TR/REC-xml/#NT-Name and
// http://www.w3.org/TR/xml11/#NT-Name
IntPairList list = new IntPairList();
list.add(':');
list.add('A', 'Z');
list.add('a', 'z');
list.add('_');
list.add(0xC0, 0xD6);
list.add(0xD8, 0xF6);
list.add(0xF8, 0x2FF);
list.add(0x370, 0x37D);
list.add(0x37F, 0x1FFF);
list.add(0x200C, 0x200D);
list.add(0x2070, 0x218F);
list.add(0x2C00, 0x2FEF);
list.add(0x3001, 0xD7FF);
list.add(0xF900, 0xFDCF);
list.add(0xFDF0, 0xFFFD);
list.add(0x10000, 0xEFFFF);
XML_NAME_START_CHAR_BOUNDS = (IntPair[])list.toArray(new IntPair[list.size()]);
list.clear();
list.add('-');
list.add('.');
list.add('0', '9');
list.add('\u00b7');
list.add(0x0300, 0x036F);
list.add(0x203F, 0x2040);
XML_NAME_CHAR_EXTRA_BOUNDS = (IntPair[])list.toArray(new IntPair[list.size()]);
}
private final String dollarReplacement;
private final String escapeCharReplacement;
private transient Map escapeCache;
private transient Map unescapeCache;
private final String hexPrefix;
/**
* Construct a new XmlFriendlyNameCoder.
*
* @since 1.4
*/
public XmlFriendlyNameCoder() {
this("_-", "__");
}
/**
* Construct a new XmlFriendlyNameCoder with custom replacement strings for dollar and the
* escape character.
*
* @param dollarReplacement
* @param escapeCharReplacement
* @since 1.4
*/
public XmlFriendlyNameCoder(String dollarReplacement, String escapeCharReplacement) {
this(dollarReplacement, escapeCharReplacement, "_.");
}
/**
* Construct a new XmlFriendlyNameCoder with custom replacement strings for dollar, the
* escape character and the prefix for hexadecimal encoding of invalid characters in XML
* names.
*
* @param dollarReplacement
* @param escapeCharReplacement
* @since 1.4
*/
public XmlFriendlyNameCoder(
String dollarReplacement, String escapeCharReplacement, String hexPrefix) {
this.dollarReplacement = dollarReplacement;
this.escapeCharReplacement = escapeCharReplacement;
this.hexPrefix = hexPrefix;
readResolve();
}
/**
* {@inheritDoc}
*/
public String decodeAttribute(String attributeName) {
return decodeName(attributeName);
}
/**
* {@inheritDoc}
*/
public String decodeNode(String elementName) {
return decodeName(elementName);
}
/**
* {@inheritDoc}
*/
public String encodeAttribute(String name) {
return encodeName(name);
}
/**
* {@inheritDoc}
*/
public String encodeNode(String name) {
return encodeName(name);
}
private String encodeName(String name) {
String s = (String)escapeCache.get(name);
if (s == null) {
final int length = name.length();
// First, fast (common) case: nothing to escape
int i = 0;
for (; i < length; i++ ) {
char c = name.charAt(i);
if (c == '$' || c == '_' || c <= 27 || c >= 127) {
break;
}
}
if (i == length) {
return name;
}
// Otherwise full processing
final StringBuffer result = new StringBuffer(length + 8);
// We know first N chars are safe
if (i > 0) {
result.append(name.substring(0, i));
}
for (; i < length; i++ ) {
char c = name.charAt(i);
if (c == '$') {
result.append(dollarReplacement);
} else if (c == '_') {
result.append(escapeCharReplacement);
} else if ((i == 0 && !isXmlNameStartChar(c)) || (i > 0 && !isXmlNameChar(c))) {
result.append(hexPrefix);
if (c < 16) result.append("000");
else if (c < 256) result.append("00");
else if (c < 4096) result.append("0");
result.append(Integer.toHexString(c));
} else {
result.append(c);
}
}
s = result.toString();
escapeCache.put(name, s);
}
return s;
}
private String decodeName(String name) {
String s = (String)unescapeCache.get(name);
if (s == null) {
final char dollarReplacementFirstChar = dollarReplacement.charAt(0);
final char escapeReplacementFirstChar = escapeCharReplacement.charAt(0);
final char hexPrefixFirstChar = hexPrefix.charAt(0);
final int length = name.length();
// First, fast (common) case: nothing to decode
int i = 0;
for (; i < length; i++ ) {
char c = name.charAt(i);
// We'll do a quick check for potential match
if (c == dollarReplacementFirstChar
|| c == escapeReplacementFirstChar
|| c == hexPrefixFirstChar) {
// and if it might be a match, just quit, will check later on
break;
}
}
if (i == length) {
return name;
}
// Otherwise full processing
final StringBuffer result = new StringBuffer(length + 8);
// We know first N chars are safe
if (i > 0) {
result.append(name.substring(0, i));
}
for (; i < length; i++ ) {
char c = name.charAt(i);
if (c == dollarReplacementFirstChar && name.startsWith(dollarReplacement, i)) {
i += dollarReplacement.length() - 1;
result.append('$');
} else if (c == hexPrefixFirstChar && name.startsWith(hexPrefix, i)) {
i += hexPrefix.length();
c = (char)Integer.parseInt(name.substring(i, i + 4), 16);
i += 3;
result.append(c);
} else if (c == escapeReplacementFirstChar
&& name.startsWith(escapeCharReplacement, i)) {
i += escapeCharReplacement.length() - 1;
result.append('_');
} else {
result.append(c);
}
}
s = result.toString();
unescapeCache.put(name, s);
}
return s;
}
public Object clone() {
try {
XmlFriendlyNameCoder coder = (XmlFriendlyNameCoder)super.clone();
coder.readResolve();
return coder;
} catch (CloneNotSupportedException e) {
throw new ObjectAccessException("Cannot clone XmlFriendlyNameCoder", e);
}
}
private Object readResolve() {
escapeCache = new WeakCache();
unescapeCache = new WeakCache();
return this;
}
private static class IntPair {
int min;
int max;
public IntPair(int min, int max) {
this.min = min;
this.max = max;
}
}
private static boolean isXmlNameStartChar(int cp) {
return isInNameCharBounds(cp, XML_NAME_START_CHAR_BOUNDS);
}
private static boolean isXmlNameChar(int cp) {
if (isXmlNameStartChar(cp)) {
return true;
}
return isInNameCharBounds(cp, XML_NAME_CHAR_EXTRA_BOUNDS);
}
private static boolean isInNameCharBounds(int cp, IntPair[] nameCharBounds) {
for (int i = 0; i < nameCharBounds.length; ++i) {
IntPair p = nameCharBounds[i];
if (cp >= p.min && cp <= p.max) {
return true;
}
}
return false;
}
}
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractDocumentReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractDocumentRea0000664 0001750 0001750 00000005155 12206661545 034363 0 ustar jamespage jamespage /*
* Copyright (C) 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 24. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import java.util.Iterator;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.io.AttributeNameIterator;
import com.thoughtworks.xstream.io.naming.NameCoder;
public abstract class AbstractDocumentReader extends AbstractXmlReader implements DocumentReader {
private FastStack pointers = new FastStack(16);
private Object current;
protected AbstractDocumentReader(Object rootElement) {
this(rootElement, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
protected AbstractDocumentReader(Object rootElement, NameCoder nameCoder) {
super(nameCoder);
this.current = rootElement;
pointers.push(new Pointer());
reassignCurrentElement(current);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link AbstractDocumentReader#AbstractDocumentReader(Object, NameCoder)} instead.
*/
protected AbstractDocumentReader(Object rootElement, XmlFriendlyReplacer replacer) {
this(rootElement, (NameCoder)replacer);
}
protected abstract void reassignCurrentElement(Object current);
protected abstract Object getParent();
protected abstract Object getChild(int index);
protected abstract int getChildCount();
private static class Pointer {
public int v;
}
public boolean hasMoreChildren() {
Pointer pointer = (Pointer) pointers.peek();
if (pointer.v < getChildCount()) {
return true;
} else {
return false;
}
}
public void moveUp() {
current = getParent();
pointers.popSilently();
reassignCurrentElement(current);
}
public void moveDown() {
Pointer pointer = (Pointer) pointers.peek();
pointers.push(new Pointer());
current = getChild(pointer.v);
pointer.v++;
reassignCurrentElement(current);
}
public Iterator getAttributeNames() {
return new AttributeNameIterator(this);
}
public void appendErrors(ErrorWriter errorWriter) {
}
public Object getCurrent() {
return this.current;
}
public void close() {
// don't need to do anything
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/StaxWriter.java 0000664 0001750 0001750 00000017200 12206661545 033517 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 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. September 2004 by James Strachan
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamWriter;
/**
* A stream writing that outputs to a StAX stream writer
*
* @author James Strachan
* @version $Revision: 1906 $
*/
public class StaxWriter extends AbstractXmlWriter {
private final QNameMap qnameMap;
private final XMLStreamWriter out;
private final boolean writeEnclosingDocument;
private boolean namespaceRepairingMode;
private int tagDepth;
public StaxWriter(QNameMap qnameMap, XMLStreamWriter out) throws XMLStreamException {
this(qnameMap, out, true, true);
}
/**
* Allows a StaxWriter to be created for partial XML output
*
* @param qnameMap is the mapper of Java class names to QNames
* @param out the stream to output to
* @param nameCoder the xml-friendly replacer to escape Java names
* @throws XMLStreamException if the events could not be written to the output
* @since 1.4
*/
public StaxWriter(QNameMap qnameMap, XMLStreamWriter out, NameCoder nameCoder)
throws XMLStreamException {
this(qnameMap, out, true, true, nameCoder);
}
/**
* Allows a StaxWriter to be created for partial XML output
*
* @param qnameMap is the mapper of Java class names to QNames
* @param out the stream to output to
* @param writeEnclosingDocument a flag to indicate whether or not the start/end document
* events should be written
* @param namespaceRepairingMode a flag to enable StAX' namespace repairing mode
* @param nameCoder the xml-friendly replacer to escape Java names
* @throws XMLStreamException if the events could not be written to the output
* @since 1.4
*/
public StaxWriter(
QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument,
boolean namespaceRepairingMode, NameCoder nameCoder) throws XMLStreamException {
super(nameCoder);
this.qnameMap = qnameMap;
this.out = out;
this.writeEnclosingDocument = writeEnclosingDocument;
this.namespaceRepairingMode = namespaceRepairingMode;
if (writeEnclosingDocument) {
out.writeStartDocument();
}
}
/**
* Allows a StaxWriter to be created for partial XML output
*
* @param qnameMap is the mapper of Java class names to QNames
* @param out the stream to output to
* @param writeEnclosingDocument a flag to indicate whether or not the start/end document
* events should be written
* @throws XMLStreamException if the events could not be written to the output
*/
public StaxWriter(
QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument,
boolean namespaceRepairingMode) throws XMLStreamException {
this(
qnameMap, out, writeEnclosingDocument, namespaceRepairingMode,
new XmlFriendlyNameCoder());
}
/**
* Allows a StaxWriter to be created for partial XML output
*
* @param qnameMap is the mapper of Java class names to QNames
* @param out the stream to output to
* @param writeEnclosingDocument a flag to indicate whether or not the start/end document
* events should be written
* @param replacer the xml-friendly replacer to escape Java names
* @throws XMLStreamException if the events could not be written to the output
* @since 1.2
* @deprecated As of 1.4 use
* {@link StaxWriter#StaxWriter(QNameMap, XMLStreamWriter, boolean, boolean, NameCoder)}
* instead
*/
public StaxWriter(
QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument,
boolean namespaceRepairingMode, XmlFriendlyReplacer replacer) throws XMLStreamException {
this(qnameMap, out, writeEnclosingDocument, namespaceRepairingMode, (NameCoder)replacer);
}
public void flush() {
try {
out.flush();
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
/**
* Call this method when you're finished with me
*/
public void close() {
try {
out.close();
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public void addAttribute(String name, String value) {
try {
out.writeAttribute(encodeAttribute(name), value);
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public void endNode() {
try {
tagDepth-- ;
out.writeEndElement();
if (tagDepth == 0 && writeEnclosingDocument) {
out.writeEndDocument();
}
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public void setValue(String text) {
try {
out.writeCharacters(text);
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
public void startNode(String name) {
try {
QName qname = qnameMap.getQName(encodeNode(name));
String prefix = qname.getPrefix();
String uri = qname.getNamespaceURI();
// before you ask - yes it really is this complicated to output QNames to StAX
// handling both repair namespace modes :)
boolean hasPrefix = prefix != null && prefix.length() > 0;
boolean hasURI = uri != null && uri.length() > 0;
boolean writeNamespace = false;
if (hasURI) {
if (hasPrefix) {
String currentNamespace = out.getNamespaceContext().getNamespaceURI(prefix);
if (currentNamespace == null || !currentNamespace.equals(uri)) {
writeNamespace = true;
}
} else {
String defaultNamespace = out.getNamespaceContext().getNamespaceURI("");
if (defaultNamespace == null || !defaultNamespace.equals(uri)) {
writeNamespace = true;
}
}
}
out.writeStartElement(prefix, qname.getLocalPart(), uri);
if (hasPrefix) {
out.setPrefix(prefix, uri);
} else if (hasURI) {
if (writeNamespace) {
out.setDefaultNamespace(uri);
}
}
if (hasURI && writeNamespace && !isNamespaceRepairingMode()) {
if (hasPrefix) {
out.writeNamespace(prefix, uri);
} else {
out.writeDefaultNamespace(uri);
}
}
tagDepth++ ;
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
/**
* Is StAX namespace repairing mode on or off?
*/
public boolean isNamespaceRepairingMode() {
return namespaceRepairingMode;
}
protected QNameMap getQNameMap() {
return this.qnameMap;
}
protected XMLStreamWriter getXMLStreamWriter() {
return this.out;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/ 0000775 0001750 0001750 00000000000 12206661545 032047 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/Xpp3Dom.java0000664 0001750 0001750 00000001422 12206661545 034203 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml.xppdom;
/**
* Simple Document Object Model for XmlPullParser implementations.
*
* @author Jason van Zyl
* @author Joe Walnes
* @author Jörg Schaible
* @deprecated As of 1.4, use {@link XppDom} instead
*/
public class Xpp3Dom extends XppDom {
/**
* @deprecated As of 1.4, use {@link XppDom} instead
*/
public Xpp3Dom(String name) {
super(name);
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/XppFactory.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/XppFactory.j0000664 0001750 0001750 00000005341 12206661545 034324 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 11. August 2011 by Joerg Schaible, code from XppDom.
*/
package com.thoughtworks.xstream.io.xml.xppdom;
import java.io.IOException;
import java.io.InputStream;
import java.io.Reader;
import java.io.StringReader;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import org.xmlpull.v1.XmlPullParserFactory;
/**
* XmlPullParser utility methods.
*
* @author Jörg Schaible
* @since 1.4.1
*/
public class XppFactory {
/**
* Create a new XmlPullParser using the XPP factory.
*
* @return a new parser instance
* @throws XmlPullParserException if the factory fails
* @since 1.4.1
*/
public static XmlPullParser createDefaultParser() throws XmlPullParserException {
XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
return factory.newPullParser();
}
/**
* Build an XPP DOM hierarchy from a String.
*
* @param xml the XML data
* @throws XmlPullParserException if the default parser cannot be created or fails with invalid XML
* @throws IOException if the data cannot be read
* @see XppDom#build(XmlPullParser)
* @since 1.4.1
*/
public static XppDom buildDom(String xml) throws XmlPullParserException, IOException {
return buildDom(new StringReader(xml));
}
/**
* Build an XPP DOM hierarchy from a Reader.
*
* @param r the reader
* @throws XmlPullParserException if the default parser cannot be created or fails with invalid XML
* @throws IOException if the data cannot be read
* @see XppDom#build(XmlPullParser)
* @since 1.4.1
*/
public static XppDom buildDom(Reader r) throws XmlPullParserException, IOException {
XmlPullParser parser = createDefaultParser();
parser.setInput(r);
return XppDom.build(parser);
}
/**
* Build an XPP DOM hierarchy from an InputStream.
*
* @param in the input stream
* @param encoding the encoding of the input stream
* @throws XmlPullParserException if the default parser cannot be created or fails with invalid XML
* @throws IOException if the data cannot be read
* @see XppDom#build(XmlPullParser)
* @since 1.4.1
*/
public static XppDom buildDom(InputStream in, String encoding) throws XmlPullParserException, IOException {
XmlPullParser parser = createDefaultParser();
parser.setInput(in, encoding);
return XppDom.build(parser);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/XppDom.java 0000664 0001750 0001750 00000016377 12206661545 034137 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 02. May 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml.xppdom;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import java.io.IOException;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
/**
* Simple Document Object Model for XmlPullParser implementations.
*
* @author Jason van Zyl
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.4
*/
public class XppDom implements Serializable {
private static final long serialVersionUID = 1L;
private String name;
private String value;
private Map attributes;
private List childList;
transient private Map childMap;
private XppDom parent;
public XppDom(String name) {
this.name = name;
childList = new ArrayList();
childMap = new HashMap();
}
// ----------------------------------------------------------------------
// Name handling
// ----------------------------------------------------------------------
public String getName() {
return name;
}
// ----------------------------------------------------------------------
// Value handling
// ----------------------------------------------------------------------
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
// ----------------------------------------------------------------------
// Attribute handling
// ----------------------------------------------------------------------
public String[] getAttributeNames() {
if (null == attributes) {
return new String[0];
} else {
return (String[])attributes.keySet().toArray(new String[0]);
}
}
public String getAttribute(String name) {
return (null != attributes) ? (String)attributes.get(name) : null;
}
public void setAttribute(String name, String value) {
if (null == attributes) {
attributes = new HashMap();
}
attributes.put(name, value);
}
// ----------------------------------------------------------------------
// Child handling
// ----------------------------------------------------------------------
public XppDom getChild(int i) {
return (XppDom)childList.get(i);
}
public XppDom getChild(String name) {
return (XppDom)childMap.get(name);
}
public void addChild(XppDom xpp3Dom) {
xpp3Dom.setParent(this);
childList.add(xpp3Dom);
childMap.put(xpp3Dom.getName(), xpp3Dom);
}
public XppDom[] getChildren() {
if (null == childList) {
return new XppDom[0];
} else {
return (XppDom[])childList.toArray(new XppDom[0]);
}
}
public XppDom[] getChildren(String name) {
if (null == childList) {
return new XppDom[0];
} else {
ArrayList children = new ArrayList();
int size = this.childList.size();
for (int i = 0; i < size; i++ ) {
XppDom configuration = (XppDom)this.childList.get(i);
if (name.equals(configuration.getName())) {
children.add(configuration);
}
}
return (XppDom[])children.toArray(new XppDom[0]);
}
}
public int getChildCount() {
if (null == childList) {
return 0;
}
return childList.size();
}
// ----------------------------------------------------------------------
// Parent handling
// ----------------------------------------------------------------------
public XppDom getParent() {
return parent;
}
public void setParent(XppDom parent) {
this.parent = parent;
}
// ----------------------------------------------------------------------
// Serialization
// ----------------------------------------------------------------------
Object readResolve() {
childMap = new HashMap();
for (final Iterator iter = childList.iterator(); iter.hasNext();) {
final XppDom element = (XppDom)iter.next();
childMap.put(element.getName(), element);
}
return this;
}
// ----------------------------------------------------------------------
// DOM builder
// ----------------------------------------------------------------------
/**
* Build an XPP DOM hierarchy. The {@link java.io.InputStream} or {@link java.io.Reader}
* used by the parser must have already been set. The method does not close it after reading
* the document's end.
*
* @param parser the XPP instance
* @throws XmlPullParserException if the parser turns into an invalid state or reads invalid
* XML
* @throws IOException if the data cannot be read
*/
public static XppDom build(XmlPullParser parser) throws XmlPullParserException, IOException {
List elements = new ArrayList();
List values = new ArrayList();
XppDom node = null;
int eventType = parser.getEventType();
while (eventType != XmlPullParser.END_DOCUMENT) {
if (eventType == XmlPullParser.START_TAG) {
String rawName = parser.getName();
// Use XppDom when deprecated Xpp3Dom is removed
XppDom child = new Xpp3Dom(rawName);
int depth = elements.size();
if (depth > 0) {
XppDom parent = (XppDom)elements.get(depth - 1);
parent.addChild(child);
}
elements.add(child);
values.add(new StringBuffer());
int attributesSize = parser.getAttributeCount();
for (int i = 0; i < attributesSize; i++ ) {
String name = parser.getAttributeName(i);
String value = parser.getAttributeValue(i);
child.setAttribute(name, value);
}
} else if (eventType == XmlPullParser.TEXT) {
int depth = values.size() - 1;
StringBuffer valueBuffer = (StringBuffer)values.get(depth);
valueBuffer.append(parser.getText());
} else if (eventType == XmlPullParser.END_TAG) {
int depth = elements.size() - 1;
XppDom finalNode = (XppDom)elements.remove(depth);
String accumulatedValue = (values.remove(depth)).toString();
String finishedValue;
if (0 == accumulatedValue.length()) {
finishedValue = null;
} else {
finishedValue = accumulatedValue;
}
finalNode.setValue(finishedValue);
if (0 == depth) {
node = finalNode;
}
}
eventType = parser.next();
}
return node;
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/Xpp3DomBuilder.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/Xpp3DomBuild0000664 0001750 0001750 00000002044 12206661545 034244 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml.xppdom;
import org.xmlpull.mxp1.MXParser;
import org.xmlpull.v1.XmlPullParser;
import java.io.Reader;
/**
* @author Jason van Zyl
* @author Joe Walnes
* @author Jörg Schaible
* @deprecated As of 1.4, use {@link XppDom#build(XmlPullParser)} instead
*/
public class Xpp3DomBuilder {
/**
* @deprecated As of 1.4, use {@link XppDom#build(XmlPullParser)} instead
*/
public static Xpp3Dom build(Reader reader) throws Exception {
XmlPullParser parser = new MXParser();
parser.setInput(reader);
try {
return (Xpp3Dom)XppDom.build(parser);
} finally {
reader.close();
}
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/XppDomComparator.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/xppdom/XppDomCompar0000664 0001750 0001750 00000010520 12206661545 034341 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 11. August 2011 by Joerg Schaible.
*/
package com.thoughtworks.xstream.io.xml.xppdom;
import java.util.Arrays;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Map;
/**
* Comparator for {@link XppDom}. Comparator can trace the XPath where the comparison failed.
*
* @author Jörg Schaible
* @since 1.4.1
*/
public class XppDomComparator implements Comparator {
private final ThreadLocal xpath;
/**
* Creates a new Xpp3DomComparator object.
*
* @since 1.4.1
*/
public XppDomComparator() {
this(null);
}
/**
* Creates a new Xpp3DomComparator object with XPath identification.
*
* @param xpath the reference for the XPath
* @since 1.4.1
*/
public XppDomComparator(final ThreadLocal xpath) {
this.xpath = xpath;
}
public int compare(final Object dom1, final Object dom2) {
final StringBuffer xpath = new StringBuffer("/");
final int s = compareInternal((XppDom)dom1, (XppDom)dom2, xpath, -1);
if (this.xpath != null) {
if (s != 0) {
this.xpath.set(xpath.toString());
} else {
this.xpath.set(null);
}
}
return s;
}
private int compareInternal(final XppDom dom1, final XppDom dom2,
final StringBuffer xpath, final int count) {
final int pathlen = xpath.length();
final String name = dom1.getName();
int s = name.compareTo(dom2.getName());
xpath.append(name);
if (count >= 0) {
xpath.append('[').append(count).append(']');
}
if (s != 0) {
xpath.append('?');
return s;
}
final String[] attributes = dom1.getAttributeNames();
final String[] attributes2 = dom2.getAttributeNames();
final int len = attributes.length;
s = attributes2.length - len;
if (s != 0) {
xpath.append("::count(@*)");
return s < 0 ? 1 : -1;
}
Arrays.sort(attributes);
Arrays.sort(attributes2);
for (int i = 0; i < len; ++i) {
final String attribute = attributes[i];
s = attribute.compareTo(attributes2[i]);
if (s != 0) {
xpath.append("[@").append(attribute).append("?]");
return s;
}
s = dom1.getAttribute(attribute).compareTo(dom2.getAttribute(attribute));
if (s != 0) {
xpath.append("[@").append(attribute).append(']');
return s;
}
}
final int children = dom1.getChildCount();
s = dom2.getChildCount() - children;
if (s != 0) {
xpath.append("::count(*)");
return s < 0 ? 1 : -1;
}
if (children > 0) {
if (dom1.getValue() != null || dom2.getValue() != null) {
throw new IllegalArgumentException("XppDom cannot handle mixed mode at "
+ xpath
+ "::text()");
}
xpath.append('/');
final Map names = new HashMap();
for (int i = 0; i < children; ++i) {
final XppDom child1 = dom1.getChild(i);
final XppDom child2 = dom2.getChild(i);
final String child = child1.getName();
if (!names.containsKey(child)) {
names.put(child, new int[1]);
}
s = compareInternal(child1, child2, xpath, ((int[])names.get(child))[0]++);
if (s != 0) {
return s;
}
}
} else {
final String value2 = dom2.getValue();
final String value1 = dom1.getValue();
if (value1 == null) {
s = value2 == null ? 0 : -1;
} else {
s = value2 == null ? 1 : value1.compareTo(value2);
}
if (s != 0) {
xpath.append("::text()");
return s;
}
}
xpath.setLength(pathlen);
return s;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XppDomReader.java 0000664 0001750 0001750 00000004735 12206661545 033746 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.xml.xppdom.XppDom;
/**
* @author Jason van Zyl
*/
public class XppDomReader extends AbstractDocumentReader {
private XppDom currentElement;
public XppDomReader(XppDom xppDom) {
super(xppDom);
}
/**
* @since 1.4
*/
public XppDomReader(XppDom xppDom, NameCoder nameCoder) {
super(xppDom, nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link XppDomReader#XppDomReader(XppDom, NameCoder)} instead.
*/
public XppDomReader(XppDom xppDom, XmlFriendlyReplacer replacer) {
this(xppDom, (NameCoder)replacer);
}
public String getNodeName() {
return decodeNode(currentElement.getName());
}
public String getValue() {
String text = null;
try {
text = currentElement.getValue();
} catch (Exception e) {
// do nothing.
}
return text == null ? "" : text;
}
public String getAttribute(String attributeName) {
return currentElement.getAttribute(encodeAttribute(attributeName));
}
public String getAttribute(int index) {
return currentElement.getAttribute(currentElement.getAttributeNames()[index]);
}
public int getAttributeCount() {
return currentElement.getAttributeNames().length;
}
public String getAttributeName(int index) {
return decodeAttribute(currentElement.getAttributeNames()[index]);
}
protected Object getParent() {
return currentElement.getParent();
}
protected Object getChild(int index) {
return currentElement.getChild(index);
}
protected int getChildCount() {
return currentElement.getChildCount();
}
protected void reassignCurrentElement(Object current) {
this.currentElement = (XppDom) current;
}
public String peekNextChild() {
if (currentElement.getChildCount() == 0) {
return null;
}
return decodeNode(currentElement.getChild(0).getName());
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXmlDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXmlDriver.j0000664 0001750 0001750 00000003305 12206661545 034314 0 ustar jamespage jamespage /*
* Copyright (C) 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 28. May 2005 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.AbstractDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* Base class for HierarchicalStreamDrivers to use xml-based HierarchicalStreamReader and
* HierarchicalStreamWriter.
*
* @author Mauro Talevi
* @author Jörg Schaible
* @since 1.2
* @deprecated As of 1.4
*/
public abstract class AbstractXmlDriver extends AbstractDriver {
/**
* Creates a AbstractXmlFriendlyDriver with default XmlFriendlyReplacer
*
* @deprecated As of 1.4
*/
public AbstractXmlDriver() {
this(new XmlFriendlyNameCoder());
}
/**
* Creates a AbstractXmlFriendlyDriver with default XmlFriendlyReplacer
* @since 1.4
*/
public AbstractXmlDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* Creates a AbstractXmlFriendlyDriver with custom XmlFriendlyReplacer
*
* @param replacer the XmlFriendlyReplacer
* @deprecated As of 1.4
*/
public AbstractXmlDriver(XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
/**
* @deprecated As of 1.4
*/
protected XmlFriendlyReplacer xmlFriendlyReplacer() {
NameCoder nameCoder = getNameCoder();
return nameCoder instanceof XmlFriendlyReplacer ? (XmlFriendlyReplacer)nameCoder : null;
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyReader.j0000664 0001750 0001750 00000001564 12206661545 034301 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008, 2009, 2011 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 26. September 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
/**
* An interface for a {@link com.thoughtworks.xstream.io.HierarchicalStreamReader} supporting
* XML-friendly names.
*
* @author Jörg Schaible
* @author Mauro Talevi
* @since 1.3
* @deprecated As of 1.4
*/
public interface XmlFriendlyReader {
/**
* Unescapes XML-friendly name (node or attribute)
*
* @param name the escaped XML-friendly name
* @return An unescaped name with original characters
* @deprecated As of 1.4
*/
String unescapeXmlName(String name);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/Dom4JXmlWriter.java0000664 0001750 0001750 00000007660 12206661545 034207 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.dom4j.Element;
import org.dom4j.io.XMLWriter;
import org.dom4j.tree.DefaultElement;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.AttributesImpl;
import java.io.IOException;
public class Dom4JXmlWriter extends AbstractXmlWriter {
private final XMLWriter writer;
private final FastStack elementStack;
private AttributesImpl attributes;
private boolean started;
private boolean children;
public Dom4JXmlWriter(XMLWriter writer) {
this(writer, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public Dom4JXmlWriter(XMLWriter writer, NameCoder nameCoder) {
super(nameCoder);
this.writer = writer;
this.elementStack = new FastStack(16);
this.attributes = new AttributesImpl();
try {
writer.startDocument();
} catch (SAXException e) {
throw new StreamException(e);
}
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link Dom4JXmlWriter#Dom4JXmlWriter(XMLWriter, NameCoder)} instead.
*/
public Dom4JXmlWriter(XMLWriter writer, XmlFriendlyReplacer replacer) {
this(writer, (NameCoder)replacer);
}
public void startNode(String name) {
if (elementStack.size() > 0) {
try {
startElement();
} catch (SAXException e) {
throw new StreamException(e);
}
started = false;
}
elementStack.push(encodeNode(name));
children = false;
}
public void setValue(String text) {
char[] value = text.toCharArray();
if (value.length > 0) {
try {
startElement();
writer.characters(value, 0, value.length);
} catch (SAXException e) {
throw new StreamException(e);
}
children = true;
}
}
public void addAttribute(String key, String value) {
attributes.addAttribute("", "", encodeAttribute(key), "string", value);
}
public void endNode() {
try {
if (!children) {
Element element = new DefaultElement((String)elementStack.pop());
for (int i = 0; i < attributes.getLength(); ++i) {
element.addAttribute(attributes.getQName(i), attributes.getValue(i));
}
writer.write(element);
attributes.clear();
children = true; // node just closed is child of node on top of stack
started = true;
} else {
startElement();
writer.endElement("", "", (String)elementStack.pop());
}
} catch (SAXException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public void flush() {
try {
writer.flush();
} catch (IOException e) {
throw new StreamException(e);
}
}
public void close() {
try {
writer.endDocument();
} catch (SAXException e) {
throw new StreamException(e);
}
}
private void startElement() throws SAXException {
if (!started) {
writer.startElement("", "", (String)elementStack.peek(), attributes);
attributes.clear();
started = true;
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/WstxDriver.java 0000664 0001750 0001750 00000002272 12206661545 033527 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.ctc.wstx.stax.WstxInputFactory;
import com.ctc.wstx.stax.WstxOutputFactory;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLOutputFactory;
/**
* A driver using the Woodstox StAX implementation.
*
* @author Jörg Schaible
* @since 1.4
*/
public class WstxDriver extends StaxDriver {
public WstxDriver() {
super();
}
public WstxDriver(QNameMap qnameMap, XmlFriendlyNameCoder nameCoder) {
super(qnameMap, nameCoder);
}
public WstxDriver(QNameMap qnameMap) {
super(qnameMap);
}
public WstxDriver(XmlFriendlyNameCoder nameCoder) {
super(nameCoder);
}
protected XMLInputFactory createInputFactory() {
return new WstxInputFactory();
}
protected XMLOutputFactory createOutputFactory() {
return new WstxOutputFactory();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XppDomDriver.java 0000664 0001750 0001750 00000003133 12206661545 033766 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import org.xmlpull.v1.XmlPullParserFactory;
/**
* A {@link HierarchicalStreamDriver} for XPP DOM using the XmlPullParserFactory to locate an parser.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class XppDomDriver extends AbstractXppDomDriver {
private static XmlPullParserFactory factory;
public XppDomDriver() {
super(new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public XppDomDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link XppDomDriver#XppDomDriver(NameCoder)} instead.
*/
public XppDomDriver(XmlFriendlyReplacer replacer) {
super(replacer);
}
/**
* {@inheritDoc}
*/
protected synchronized XmlPullParser createParser() throws XmlPullParserException {
if (factory == null) {
factory = XmlPullParserFactory.newInstance(null, XppDomDriver.class);
}
return factory.newPullParser();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/JDomDriver.java 0000664 0001750 0001750 00000006425 12206661545 033417 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 03. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;
import org.jdom.Document;
import org.jdom.JDOMException;
import org.jdom.input.SAXBuilder;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
/**
* @author Laurent Bihanic
*/
public class JDomDriver extends AbstractXmlDriver {
public JDomDriver() {
super(new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public JDomDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link JDomDriver#JDomDriver(NameCoder)} instead.
*/
public JDomDriver(XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
public HierarchicalStreamReader createReader(Reader reader) {
try {
SAXBuilder builder = new SAXBuilder();
Document document = builder.build(reader);
return new JDomReader(document, getNameCoder());
} catch (IOException e) {
throw new StreamException(e);
} catch (JDOMException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(InputStream in) {
try {
SAXBuilder builder = new SAXBuilder();
Document document = builder.build(in);
return new JDomReader(document, getNameCoder());
} catch (IOException e) {
throw new StreamException(e);
} catch (JDOMException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(URL in) {
try {
SAXBuilder builder = new SAXBuilder();
Document document = builder.build(in);
return new JDomReader(document, getNameCoder());
} catch (IOException e) {
throw new StreamException(e);
} catch (JDOMException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(File in) {
try {
SAXBuilder builder = new SAXBuilder();
Document document = builder.build(in);
return new JDomReader(document, getNameCoder());
} catch (IOException e) {
throw new StreamException(e);
} catch (JDOMException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(Writer out) {
return new PrettyPrintWriter(out, getNameCoder());
}
public HierarchicalStreamWriter createWriter(OutputStream out) {
return new PrettyPrintWriter(new OutputStreamWriter(out));
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyWriter.j0000664 0001750 0001750 00000001571 12206661545 034351 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008, 2009, 2011 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 26. September 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
/**
* An interface for a {@link com.thoughtworks.xstream.io.HierarchicalStreamWriter} supporting
* XML-friendly names.
*
* @author Jörg Schaible
* @author Mauro Talevi
* @since 1.3
* @deprecated As of 1.4
*/
public interface XmlFriendlyWriter {
/**
* Escapes XML name (node or attribute) to be XML-friendly
*
* @param name the unescaped XML name
* @return An escaped name with original characters replaced
* @deprecated As of 1.4
*/
String escapeXmlName(String name);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/KXml2Driver.java 0000664 0001750 0001750 00000002253 12206661545 033516 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.kxml2.io.KXmlParser;
import org.xmlpull.v1.XmlPullParser;
/**
* A {@link HierarchicalStreamDriver} using the kXML2 parser.
*
* @author Jörg Schaible
* @since 1.4
*/
public class KXml2Driver extends AbstractXppDriver {
/**
* Construct a KXml2Driver.
*
* @since 1.4
*/
public KXml2Driver() {
super(new XmlFriendlyNameCoder());
}
/**
* Construct a KXml2Driver.
*
* @param nameCoder the replacer for XML friendly names
* @since 1.4
*/
public KXml2Driver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* {@inheritDoc}
*/
protected XmlPullParser createParser() {
return new KXmlParser();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/Dom4JReader.java 0000664 0001750 0001750 00000006046 12206661545 033451 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.util.List;
import org.dom4j.Document;
import org.dom4j.Element;
public class Dom4JReader extends AbstractDocumentReader {
private Element currentElement;
public Dom4JReader(Element rootElement) {
this(rootElement, new XmlFriendlyNameCoder());
}
public Dom4JReader(Document document) {
this(document.getRootElement());
}
/**
* @since 1.4
*/
public Dom4JReader(Element rootElement, NameCoder nameCoder) {
super(rootElement, nameCoder);
}
/**
* @since 1.4
*/
public Dom4JReader(Document document, NameCoder nameCoder) {
this(document.getRootElement(), nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link Dom4JReader#Dom4JReader(Element, NameCoder)} instead
*/
public Dom4JReader(Element rootElement, XmlFriendlyReplacer replacer) {
this(rootElement, (NameCoder)replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link Dom4JReader#Dom4JReader(Document, NameCoder)} instead
*/
public Dom4JReader(Document document, XmlFriendlyReplacer replacer) {
this(document.getRootElement(), (NameCoder)replacer);
}
public String getNodeName() {
return decodeNode(currentElement.getName());
}
public String getValue() {
return currentElement.getText();
}
public String getAttribute(String name) {
return currentElement.attributeValue(encodeAttribute(name));
}
public String getAttribute(int index) {
return currentElement.attribute(index).getValue();
}
public int getAttributeCount() {
return currentElement.attributeCount();
}
public String getAttributeName(int index) {
return decodeAttribute(currentElement.attribute(index).getQualifiedName());
}
protected Object getParent() {
return currentElement.getParent();
}
protected Object getChild(int index) {
return currentElement.elements().get(index);
}
protected int getChildCount() {
return currentElement.elements().size();
}
protected void reassignCurrentElement(Object current) {
currentElement = (Element) current;
}
public String peekNextChild() {
List list = currentElement.elements();
if (null == list || list.isEmpty()) {
return null;
}
return decodeNode(((Element) list.get(0)).getName());
}
public void appendErrors(ErrorWriter errorWriter) {
errorWriter.add("xpath", currentElement.getPath());
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XomWriter.java 0000664 0001750 0001750 00000003351 12206661545 033345 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 03. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import nu.xom.Attribute;
import nu.xom.Element;
public class XomWriter extends AbstractDocumentWriter {
/**
* @since 1.2.1
*/
public XomWriter() {
this(null);
}
public XomWriter(final Element parentElement) {
this(parentElement, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public XomWriter(final Element parentElement, final NameCoder nameCoder) {
super(parentElement, nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link XomWriter#XomWriter(Element, NameCoder)} instead
*/
public XomWriter(final Element parentElement, final XmlFriendlyReplacer replacer) {
this(parentElement, (NameCoder)replacer);
}
protected Object createNode(final String name) {
final Element newNode = new Element(encodeNode(name));
final Element top = top();
if (top != null){
top().appendChild(newNode);
}
return newNode;
}
public void addAttribute(final String name, final String value) {
top().addAttribute(new Attribute(encodeAttribute(name), value));
}
public void setValue(final String text) {
top().appendChild(text);
}
private Element top() {
return (Element)getCurrent();
}
}
././@LongLink 0000644 0000000 0000000 00000000151 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XStream11NameCoder.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XStream11NameCoder.0000664 0001750 0001750 00000001716 12206661545 034051 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 15. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
/**
* A XmlFriendlyNameCoder to support backward compatibility with XStream 1.1.
*
* @author Jörg Schaible
* @since 1.4
*/
public class XStream11NameCoder extends XmlFriendlyNameCoder {
/**
* {@inheritDoc} Noop implementation that does not decode. Used for XStream 1.1
* compatibility.
*/
public String decodeAttribute(String attributeName) {
return attributeName;
}
/**
* {@inheritDoc} Noop implementation that does not decode. Used for XStream 1.1
* compatibility.
*/
public String decodeNode(String elementName) {
return elementName;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XppDomWriter.java 0000664 0001750 0001750 00000004214 12206661545 034010 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.xml.xppdom.XppDom;
public class XppDomWriter extends AbstractDocumentWriter {
public XppDomWriter() {
this(null, new XmlFriendlyNameCoder());
}
/**
* @since 1.2.1
*/
public XppDomWriter(final XppDom parent) {
this(parent, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public XppDomWriter(final NameCoder nameCoder) {
this(null, nameCoder);
}
/**
* @since 1.4
*/
public XppDomWriter(final XppDom parent, final NameCoder nameCoder) {
super(parent, nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link XppDomWriter#XppDomWriter(NameCoder)} instead
*/
public XppDomWriter(final XmlFriendlyReplacer replacer) {
this(null, replacer);
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link XppDomWriter#XppDomWriter(XppDom, NameCoder)} instead.
*/
public XppDomWriter(final XppDom parent, final XmlFriendlyReplacer replacer) {
this(parent, (NameCoder)replacer);
}
public XppDom getConfiguration() {
return (XppDom)getTopLevelNodes().get(0);
}
protected Object createNode(final String name) {
final XppDom newNode = new XppDom(encodeNode(name));
final XppDom top = top();
if (top != null) {
top().addChild(newNode);
}
return newNode;
}
public void setValue(final String text) {
top().setValue(text);
}
public void addAttribute(final String key, final String value) {
top().setAttribute(encodeAttribute(key), value);
}
private XppDom top() {
return (XppDom)getCurrent();
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXppDomDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractXppDomDrive0000664 0001750 0001750 00000005432 12206661545 034354 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 03. May 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.core.util.XmlHeaderAwareReader;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.xml.xppdom.XppDom;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.UnsupportedEncodingException;
import java.io.Writer;
/**
* An abstract base class for a driver using an XPP DOM implementation.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.4
*/
public abstract class AbstractXppDomDriver extends AbstractXmlDriver {
/**
* Construct an AbstractXppDomDriver.
*
* @param nameCoder the replacer for XML friendly names
* @since 1.4
*/
public AbstractXppDomDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader createReader(Reader in) {
try {
XmlPullParser parser = createParser();
parser.setInput(in);
return new XppDomReader(XppDom.build(parser), getNameCoder());
} catch (XmlPullParserException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader createReader(InputStream in) {
try {
return createReader(new XmlHeaderAwareReader(in));
} catch (UnsupportedEncodingException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamWriter createWriter(Writer out) {
return new PrettyPrintWriter(out, getNameCoder());
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamWriter createWriter(OutputStream out) {
return createWriter(new OutputStreamWriter(out));
}
/**
* Create the parser of the XPP implementation.
* @throws XmlPullParserException if the parser cannot be created
* @since 1.4
*/
protected abstract XmlPullParser createParser() throws XmlPullParserException;
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/StaxReader.java 0000664 0001750 0001750 00000006424 12206661545 033453 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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. September 2004 by James Strachan
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamConstants;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
/**
* A reader using the StAX API.
*
* @author James Strachan
* @version $Revision: 1861 $
*/
public class StaxReader extends AbstractPullReader {
private final QNameMap qnameMap;
private final XMLStreamReader in;
public StaxReader(QNameMap qnameMap, XMLStreamReader in) {
this(qnameMap, in, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public StaxReader(QNameMap qnameMap, XMLStreamReader in, NameCoder replacer) {
super(replacer);
this.qnameMap = qnameMap;
this.in = in;
moveDown();
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link StaxReader#StaxReader(QNameMap, XMLStreamReader, NameCoder)} instead.
*/
public StaxReader(QNameMap qnameMap, XMLStreamReader in, XmlFriendlyReplacer replacer) {
this(qnameMap, in, (NameCoder)replacer);
}
protected int pullNextEvent() {
try {
switch(in.next()) {
case XMLStreamConstants.START_DOCUMENT:
case XMLStreamConstants.START_ELEMENT:
return START_NODE;
case XMLStreamConstants.END_DOCUMENT:
case XMLStreamConstants.END_ELEMENT:
return END_NODE;
case XMLStreamConstants.CHARACTERS:
return TEXT;
case XMLStreamConstants.COMMENT:
return COMMENT;
default:
return OTHER;
}
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
protected String pullElementName() {
// let the QNameMap handle any mapping of QNames to Java class names
QName qname = in.getName();
return qnameMap.getJavaClassName(qname);
}
protected String pullText() {
return in.getText();
}
public String getAttribute(String name) {
return in.getAttributeValue(null, encodeAttribute(name));
}
public String getAttribute(int index) {
return in.getAttributeValue(index);
}
public int getAttributeCount() {
return in.getAttributeCount();
}
public String getAttributeName(int index) {
return decodeAttribute(in.getAttributeLocalName(index));
}
public void appendErrors(ErrorWriter errorWriter) {
errorWriter.add("line number", String.valueOf(in.getLocation().getLineNumber()));
}
public void close() {
try {
in.close();
} catch (XMLStreamException e) {
throw new StreamException(e);
}
}
} jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/JDomReader.java 0000664 0001750 0001750 00000006252 12206661545 033364 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 03. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.util.List;
import org.jdom.Attribute;
import org.jdom.Document;
import org.jdom.Element;
/**
* @author Laurent Bihanic
*/
public class JDomReader extends AbstractDocumentReader {
private Element currentElement;
public JDomReader(Element root) {
super(root);
}
public JDomReader(Document document) {
super(document.getRootElement());
}
/**
* @since 1.4
*/
public JDomReader(Element root, NameCoder nameCoder) {
super(root, nameCoder);
}
/**
* @since 1.4
*/
public JDomReader(Document document, NameCoder nameCoder) {
super(document.getRootElement(), nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link JDomReader#JDomReader(Element, NameCoder)} instead.
*/
public JDomReader(Element root, XmlFriendlyReplacer replacer) {
this(root, (NameCoder)replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link JDomReader#JDomReader(Document, NameCoder)} instead.
*/
public JDomReader(Document document, XmlFriendlyReplacer replacer) {
this(document.getRootElement(), (NameCoder)replacer);
}
protected void reassignCurrentElement(Object current) {
currentElement = (Element) current;
}
protected Object getParent() {
// JDOM 1.0:
return currentElement.getParentElement();
// JDOM b10:
// Parent parent = currentElement.getParent();
// return (parent instanceof Element) ? (Element)parent : null;
// JDOM b9 and earlier:
// return currentElement.getParent();
}
protected Object getChild(int index) {
return currentElement.getChildren().get(index);
}
protected int getChildCount() {
return currentElement.getChildren().size();
}
public String getNodeName() {
return decodeNode(currentElement.getName());
}
public String getValue() {
return currentElement.getText();
}
public String getAttribute(String name) {
return currentElement.getAttributeValue(encodeAttribute(name));
}
public String getAttribute(int index) {
return ((Attribute) currentElement.getAttributes().get(index)).getValue();
}
public int getAttributeCount() {
return currentElement.getAttributes().size();
}
public String getAttributeName(int index) {
return decodeAttribute(((Attribute) currentElement.getAttributes().get(index)).getQualifiedName());
}
public String peekNextChild() {
List list = currentElement.getChildren();
if (null == list || list.isEmpty()) {
return null;
}
return decodeNode(((Element) list.get(0)).getName());
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/KXml2DomDriver.java0000664 0001750 0001750 00000002306 12206661545 034155 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 03. May 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.kxml2.io.KXmlParser;
import org.xmlpull.v1.XmlPullParser;
/**
* A {@link HierarchicalStreamDriver} for XPP DOM using the kXML2 parser.
*
* @author Jörg Schaible
* @since 1.4
*/
public class KXml2DomDriver extends AbstractXppDomDriver {
/**
* Construct an KXml2DomDriver.
*
* @since 1.4
*/
public KXml2DomDriver() {
super(new XmlFriendlyNameCoder());
}
/**
* Construct a KXml2DomDriver.
*
* @param nameCoder the replacer for XML friendly names
* @since 1.4
*/
public KXml2DomDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* {@inheritDoc}
*/
protected XmlPullParser createParser() {
return new KXmlParser();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/BEAStaxDriver.java 0000664 0001750 0001750 00000002312 12206661545 034004 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.bea.xml.stream.MXParserFactory;
import com.bea.xml.stream.XMLOutputFactoryBase;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLOutputFactory;
/**
* A driver using the BEA StAX implementation.
*
* @author Jörg Schaible
* @since 1.4
*/
public class BEAStaxDriver extends StaxDriver {
public BEAStaxDriver() {
super();
}
public BEAStaxDriver(QNameMap qnameMap, XmlFriendlyNameCoder nameCoder) {
super(qnameMap, nameCoder);
}
public BEAStaxDriver(QNameMap qnameMap) {
super(qnameMap);
}
public BEAStaxDriver(XmlFriendlyNameCoder nameCoder) {
super(nameCoder);
}
protected XMLInputFactory createInputFactory() {
return new MXParserFactory();
}
protected XMLOutputFactory createOutputFactory() {
return new XMLOutputFactoryBase();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/QNameMap.java 0000664 0001750 0001750 00000006004 12206661545 033042 0 ustar jamespage jamespage /*
* Copyright (C) 2004 Joe Walnes.
* Copyright (C) 2006, 2007 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 01. October 2004 by James Strachan
*/
package com.thoughtworks.xstream.io.xml;
import javax.xml.namespace.QName;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
/**
* Represents a mapping of {@link QName} instances to Java class names
* allowing class aliases and namespace aware mappings of QNames to class names.
*
* @author James Strachan
* @version $Revision: 1345 $
*/
public class QNameMap {
// lets make the mapping a no-op unless we specify some mapping
private Map qnameToJava;
private Map javaToQName;
private String defaultPrefix = "";
private String defaultNamespace = "";
/**
* Returns the Java class name that should be used for the given QName.
* If no explicit mapping has been made then the localPart of the QName is used
* which is the normal default in XStream.
*/
public String getJavaClassName(QName qname) {
if (qnameToJava != null) {
String answer = (String) qnameToJava.get(qname);
if (answer != null) {
return answer;
}
}
return qname.getLocalPart();
}
/**
* Returns the Java class name that should be used for the given QName.
* If no explicit mapping has been made then the localPart of the QName is used
* which is the normal default in XStream.
*/
public QName getQName(String javaClassName) {
if (javaToQName != null) {
QName answer = (QName) javaToQName.get(javaClassName);
if (answer != null) {
return answer;
}
}
return new QName(defaultNamespace, javaClassName, defaultPrefix);
}
/**
* Registers the mapping of the Java class name to the QName
*/
public synchronized void registerMapping(QName qname, String javaClassName) {
if (javaToQName == null) {
javaToQName = Collections.synchronizedMap(new HashMap());
}
if (qnameToJava == null) {
qnameToJava = Collections.synchronizedMap(new HashMap());
}
javaToQName.put(javaClassName, qname);
qnameToJava.put(qname, javaClassName);
}
/**
* Registers the mapping of the type to the QName
*/
public synchronized void registerMapping(QName qname, Class type) {
registerMapping(qname, type.getName());
}
public String getDefaultNamespace() {
return defaultNamespace;
}
public void setDefaultNamespace(String defaultNamespace) {
this.defaultNamespace = defaultNamespace;
}
public String getDefaultPrefix() {
return defaultPrefix;
}
public void setDefaultPrefix(String defaultPrefix) {
this.defaultPrefix = defaultPrefix;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XppDriver.java 0000664 0001750 0001750 00000003071 12206661545 033327 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011, 2012 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 08. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import org.xmlpull.v1.XmlPullParserFactory;
/**
* A {@link HierarchicalStreamDriver} using the XmlPullParserFactory to locate an XML Pull Parser.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class XppDriver extends AbstractXppDriver {
private static XmlPullParserFactory factory;
public XppDriver() {
super(new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public XppDriver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4, use {@link XppDriver#XppDriver(NameCoder)} instead.
*/
public XppDriver(XmlFriendlyReplacer replacer) {
this((NameCoder)replacer);
}
/**
* {@inheritDoc}
*/
protected synchronized XmlPullParser createParser() throws XmlPullParserException {
if (factory == null) {
factory = XmlPullParserFactory.newInstance();
}
return factory.newPullParser();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XomReader.java 0000664 0001750 0001750 00000006556 12206661545 033305 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 02. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import nu.xom.Document;
import nu.xom.Element;
import nu.xom.Elements;
import nu.xom.Node;
import nu.xom.Text;
public class XomReader extends AbstractDocumentReader {
private Element currentElement;
public XomReader(Element rootElement) {
super(rootElement);
}
public XomReader(Document document) {
super(document.getRootElement());
}
/**
* @since 1.4
*/
public XomReader(Element rootElement, NameCoder nameCoder) {
super(rootElement, nameCoder);
}
/**
* @since 1.4
*/
public XomReader(Document document, NameCoder nameCoder) {
super(document.getRootElement(), nameCoder);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link XomReader#XomReader(Element, NameCoder)} instead.
*/
public XomReader(Element rootElement, XmlFriendlyReplacer replacer) {
this(rootElement, (NameCoder)replacer);
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link XomReader#XomReader(Element, NameCoder)} instead.
*/
public XomReader(Document document, XmlFriendlyReplacer replacer) {
this(document.getRootElement(), (NameCoder)replacer);
}
public String getNodeName() {
return decodeNode(currentElement.getLocalName());
}
public String getValue() {
// currentElement.getValue() not used as this includes text of child elements, which we don't want.
StringBuffer result = new StringBuffer();
int childCount = currentElement.getChildCount();
for(int i = 0; i < childCount; i++) {
Node child = currentElement.getChild(i);
if (child instanceof Text) {
Text text = (Text) child;
result.append(text.getValue());
}
}
return result.toString();
}
public String getAttribute(String name) {
return currentElement.getAttributeValue(encodeAttribute(name));
}
public String getAttribute(int index) {
return currentElement.getAttribute(index).getValue();
}
public int getAttributeCount() {
return currentElement.getAttributeCount();
}
public String getAttributeName(int index) {
return decodeAttribute(currentElement.getAttribute(index).getQualifiedName());
}
protected int getChildCount() {
return currentElement.getChildElements().size();
}
protected Object getParent() {
return currentElement.getParent();
}
protected Object getChild(int index) {
return currentElement.getChildElements().get(index);
}
protected void reassignCurrentElement(Object current) {
currentElement = (Element) current;
}
public String peekNextChild() {
Elements children = currentElement.getChildElements();
if (null == children || children.size() == 0) {
return null;
}
return decodeNode(children.get(0).getLocalName());
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyReplacer.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/XmlFriendlyReplacer0000664 0001750 0001750 00000004350 12206661545 034400 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 17. April 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.xml;
/**
* Allows replacement of Strings in XML-friendly drivers. The default replacements are:
*
*
$ (dollar) chars are replaced with _- (underscore dash) string.
*
*
_ (underscore) chars are replaced with __ (double underscore) string.
*
*
*
* @author Mauro Talevi
* @author Jörg Schaible
* @author Tatu Saloranta
* @since 1.2
* @deprecated As of 1.4, use {@link XmlFriendlyNameCoder} instead
*/
public class XmlFriendlyReplacer extends XmlFriendlyNameCoder {
/**
* Default constructor.
*
* @deprecated As of 1.4, use {@link XmlFriendlyNameCoder} instead
*/
public XmlFriendlyReplacer() {
this("_-", "__");
}
/**
* Creates an XmlFriendlyReplacer with custom replacements
*
* @param dollarReplacement the replacement for '$'
* @param underscoreReplacement the replacement for '_'
* @deprecated As of 1.4, use {@link XmlFriendlyNameCoder} instead
*/
public XmlFriendlyReplacer(String dollarReplacement, String underscoreReplacement) {
super(dollarReplacement, underscoreReplacement);
}
/**
* Escapes name substituting '$' and '_' with replacement strings
*
* @param name the name of attribute or node
* @return The String with the escaped name
* @deprecated As of 1.4, use {@link XmlFriendlyNameCoder} instead
*/
public String escapeName(String name) {
return super.encodeNode(name);
}
/**
* Unescapes name re-enstating '$' and '_' when replacement strings are found
*
* @param name the name of attribute or node
* @return The String with unescaped name
* @deprecated As of 1.4, use {@link XmlFriendlyNameCoder} instead
*/
public String unescapeName(String name) {
return super.decodeNode(name);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/Xpp3Driver.java 0000664 0001750 0001750 00000002247 12206661545 033416 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.xmlpull.mxp1.MXParser;
import org.xmlpull.v1.XmlPullParser;
/**
* A {@link HierarchicalStreamDriver} using the Xpp3 parser.
*
* @author Jörg Schaible
* @since 1.4
*/
public class Xpp3Driver extends AbstractXppDriver {
/**
* Construct an Xpp3Driver.
*
* @since 1.4
*/
public Xpp3Driver() {
super(new XmlFriendlyNameCoder());
}
/**
* Construct an Xpp3Driver.
*
* @param nameCoder the replacer for XML friendly names
* @since 1.4
*/
public Xpp3Driver(NameCoder nameCoder) {
super(nameCoder);
}
/**
* {@inheritDoc}
*/
protected XmlPullParser createParser() {
return new MXParser();
}
}
././@LongLink 0000644 0000000 0000000 00000000155 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractDocumentWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/AbstractDocumentWri0000664 0001750 0001750 00000006475 12206661545 034423 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007, 2009, 2011 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 18. October 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.util.ArrayList;
import java.util.List;
/**
* A generic {@link com.thoughtworks.xstream.io.HierarchicalStreamWriter} for DOM writer
* implementations. The implementation manages a list of top level DOM nodes. Every time the
* last node is closed on the node stack, the next started node is added to the list. This list
* can be retrieved using the {@link DocumentWriter#getTopLevelNodes()} method.
*
* @author Laurent Bihanic
* @author Jörg Schaible
* @since 1.2.1
*/
public abstract class AbstractDocumentWriter extends AbstractXmlWriter implements
DocumentWriter {
private final List result = new ArrayList();
private final FastStack nodeStack = new FastStack(16);
/**
* Constructs an AbstractDocumentWriter.
*
* @param container the top level container for the nodes to create (may be
* null)
* @param nameCoder the object that creates XML-friendly names
* @since 1.4
*/
public AbstractDocumentWriter(final Object container, final NameCoder nameCoder) {
super(nameCoder);
if (container != null) {
nodeStack.push(container);
result.add(container);
}
}
/**
* Constructs an AbstractDocumentWriter.
*
* @param container the top level container for the nodes to create (may be
* null)
* @param replacer the object that creates XML-friendly names
* @since 1.2.1
* @deprecated As of 1.4 use
* {@link AbstractDocumentWriter#AbstractDocumentWriter(Object, NameCoder)}
* instead.
*/
public AbstractDocumentWriter(final Object container, final XmlFriendlyReplacer replacer) {
this(container, (NameCoder)replacer);
}
public final void startNode(final String name) {
final Object node = createNode(name);
nodeStack.push(node);
}
/**
* Create a node. The provided node name is not yet XML friendly. If {@link #getCurrent()}
* returns null the node is a top level node.
*
* @param name the node name
* @return the new node
* @since 1.2.1
*/
protected abstract Object createNode(String name);
public final void endNode() {
endNodeInternally();
final Object node = nodeStack.pop();
if (nodeStack.size() == 0) {
result.add(node);
}
}
/**
* Called when a node ends. Hook for derived implementations.
*
* @since 1.2.1
*/
public void endNodeInternally() {
}
/**
* @since 1.2.1
*/
protected final Object getCurrent() {
return nodeStack.peek();
}
public List getTopLevelNodes() {
return result;
}
public void flush() {
// don't need to do anything
}
public void close() {
// don't need to do anything
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/CompactWriter.java 0000664 0001750 0001750 00000003133 12206661545 034166 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.io.Writer;
public class CompactWriter extends PrettyPrintWriter {
public CompactWriter(Writer writer) {
super(writer);
}
/**
* @since 1.3
*/
public CompactWriter(Writer writer, int mode) {
super(writer, mode);
}
/**
* @since 1.4
*/
public CompactWriter(Writer writer, NameCoder nameCoder) {
super(writer, nameCoder);
}
/**
* @since 1.4
*/
public CompactWriter(Writer writer, int mode, NameCoder nameCoder) {
super(writer, mode, nameCoder);
}
/**
* @deprecated As of 1.4 use {@link CompactWriter#CompactWriter(Writer, NameCoder)} instead.
*/
public CompactWriter(Writer writer, XmlFriendlyReplacer replacer) {
super(writer, replacer);
}
/**
* @since 1.3
* @deprecated As of 1.4 use {@link CompactWriter#CompactWriter(Writer, int, NameCoder)} instead.
*/
public CompactWriter(Writer writer, int mode, XmlFriendlyReplacer replacer) {
super(writer, mode, replacer);
}
protected void endOfLine() {
// override parent: don't write anything at end of line
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/SjsxpDriver.java 0000664 0001750 0001750 00000004106 12206661545 033667 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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. April 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.StreamException;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLOutputFactory;
/**
* A driver using the JDK 6 StAX implementation of Sun.
*
* @author Jörg Schaible
* @since 1.4
*/
public class SjsxpDriver extends StaxDriver {
public SjsxpDriver() {
super();
}
public SjsxpDriver(QNameMap qnameMap, XmlFriendlyNameCoder nameCoder) {
super(qnameMap, nameCoder);
}
public SjsxpDriver(QNameMap qnameMap) {
super(qnameMap);
}
public SjsxpDriver(XmlFriendlyNameCoder nameCoder) {
super(nameCoder);
}
protected XMLInputFactory createInputFactory() {
Exception exception = null;
try {
return (XMLInputFactory)Class.forName("com.sun.xml.internal.stream.XMLInputFactoryImpl").newInstance();
} catch (InstantiationException e) {
exception = e;
} catch (IllegalAccessException e) {
exception = e;
} catch (ClassNotFoundException e) {
exception = e;
}
throw new StreamException("Cannot create SJSXP (Sun JDK 6 StAX) XMLInputFaqctory instance.", exception);
}
protected XMLOutputFactory createOutputFactory() {
Exception exception = null;
try {
return (XMLOutputFactory)Class.forName("com.sun.xml.internal.stream.XMLOutputFactoryImpl").newInstance();
} catch (InstantiationException e) {
exception = e;
} catch (IllegalAccessException e) {
exception = e;
} catch (ClassNotFoundException e) {
exception = e;
}
throw new StreamException("Cannot create SJSXP (Sun JDK 6 StAX) XMLOutputFaqctory instance.", exception);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/Dom4JWriter.java 0000664 0001750 0001750 00000006004 12206661545 033515 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.dom4j.Branch;
import org.dom4j.DocumentFactory;
import org.dom4j.Element;
public class Dom4JWriter extends AbstractDocumentWriter {
private final DocumentFactory documentFactory;
/**
* @since 1.4
*/
public Dom4JWriter(
final Branch root, final DocumentFactory factory, final NameCoder nameCoder) {
super(root, nameCoder);
documentFactory = factory;
}
/**
* @since 1.4
*/
public Dom4JWriter(final DocumentFactory factory, final NameCoder nameCoder) {
this(null, factory, nameCoder);
}
/**
* @since 1.4
*/
public Dom4JWriter(final Branch root, final NameCoder nameCoder) {
this(root, new DocumentFactory(), nameCoder);
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link Dom4JWriter#Dom4JWriter(Branch, DocumentFactory, NameCoder)} instead.
*/
public Dom4JWriter(
final Branch root, final DocumentFactory factory, final XmlFriendlyReplacer replacer) {
this(root, factory, (NameCoder)replacer);
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link Dom4JWriter#Dom4JWriter(DocumentFactory, NameCoder)} instead.
*/
public Dom4JWriter(final DocumentFactory factory, final XmlFriendlyReplacer replacer) {
this(null, factory, (NameCoder)replacer);
}
/**
* @since 1.2.1
*/
public Dom4JWriter(final DocumentFactory documentFactory) {
this(documentFactory, new XmlFriendlyNameCoder());
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link Dom4JWriter#Dom4JWriter(Branch, NameCoder)} instead
*/
public Dom4JWriter(final Branch root, final XmlFriendlyReplacer replacer) {
this(root, new DocumentFactory(), (NameCoder)replacer);
}
public Dom4JWriter(final Branch root) {
this(root, new DocumentFactory(), new XmlFriendlyNameCoder());
}
/**
* @since 1.2.1
*/
public Dom4JWriter() {
this(new DocumentFactory(), new XmlFriendlyNameCoder());
}
protected Object createNode(final String name) {
final Element element = documentFactory.createElement(encodeNode(name));
final Branch top = top();
if (top != null) {
top().add(element);
}
return element;
}
public void setValue(final String text) {
top().setText(text);
}
public void addAttribute(final String key, final String value) {
((Element)top()).addAttribute(encodeAttribute(key), value);
}
private Branch top() {
return (Branch)getCurrent();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/xml/JDomWriter.java 0000664 0001750 0001750 00000006261 12206661545 033436 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 03. September 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io.xml;
import com.thoughtworks.xstream.io.naming.NameCoder;
import org.jdom.DefaultJDOMFactory;
import org.jdom.Element;
import org.jdom.JDOMFactory;
/**
* @author Laurent Bihanic
*/
public class JDomWriter extends AbstractDocumentWriter {
private final JDOMFactory documentFactory;
/**
* @since 1.4
*/
public JDomWriter(
final Element container, final JDOMFactory factory,
final NameCoder nameCoder) {
super(container, nameCoder);
documentFactory = factory;
}
/**
* @since 1.2
* @deprecated As of 1.4 use {@link JDomWriter#JDomWriter(Element, JDOMFactory, NameCoder)} instead.
*/
public JDomWriter(
final Element container, final JDOMFactory factory,
final XmlFriendlyReplacer replacer) {
this(container, factory, (NameCoder)replacer);
}
public JDomWriter(final Element container, final JDOMFactory factory) {
this(container, factory, new XmlFriendlyNameCoder());
}
/**
* @since 1.4
*/
public JDomWriter(final JDOMFactory factory, final NameCoder nameCoder) {
this(null, factory, nameCoder);
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link JDomWriter#JDomWriter(JDOMFactory, NameCoder)} instead.
*/
public JDomWriter(final JDOMFactory factory, final XmlFriendlyReplacer replacer) {
this(null, factory, (NameCoder)replacer);
}
public JDomWriter(final JDOMFactory factory) {
this(null, factory);
}
/**
* @since 1.4
*/
public JDomWriter(final Element container, final NameCoder nameCoder) {
this(container, new DefaultJDOMFactory(), nameCoder);
}
/**
* @since 1.2.1
* @deprecated As of 1.4 use {@link JDomWriter#JDomWriter(Element, NameCoder)} instead.
*/
public JDomWriter(final Element container, final XmlFriendlyReplacer replacer) {
this(container, new DefaultJDOMFactory(), (NameCoder)replacer);
}
public JDomWriter(final Element container) {
this(container, new DefaultJDOMFactory());
}
public JDomWriter() {
this(new DefaultJDOMFactory());
}
protected Object createNode(final String name) {
final Element element = documentFactory.element(encodeNode(name));
final Element parent = top();
if (parent != null) {
parent.addContent(element);
}
return element;
}
public void setValue(final String text) {
top().addContent(documentFactory.text(text));
}
public void addAttribute(final String key, final String value) {
top().setAttribute(documentFactory.attribute(encodeAttribute(key), value));
}
private Element top() {
return (Element)getCurrent();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/AbstractDriver.java 0000664 0001750 0001750 00000004016 12206661545 033523 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 15. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.naming.NoNameCoder;
/**
* Abstract base class for all HierarchicalStreamDriver implementations. Implementations of
* {@link HierarchicalStreamDriver} should rather be derived from this class then implementing
* the interface directly.
*
* @author Jörg Schaible
* @since 1.4
*/
public abstract class AbstractDriver implements HierarchicalStreamDriver {
private NameCoder replacer;
/**
* Creates an AbstractDriver with a NameCoder that does nothing.
*/
public AbstractDriver() {
this(new NoNameCoder());
}
/**
* Creates an AbstractDriver with a provided {@link NameCoder}.
*
* @param nameCoder the name coder for the target format
*/
public AbstractDriver(NameCoder nameCoder) {
this.replacer = nameCoder;
}
protected NameCoder getNameCoder() {
return replacer;
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader createReader(URL in) {
InputStream stream = null;
try {
stream = in.openStream();
} catch (IOException e) {
throw new StreamException(e);
}
return createReader(stream);
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader createReader(File in) {
try {
return createReader(new FileInputStream(in));
} catch (FileNotFoundException e) {
throw new StreamException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/AttributeNameIterator.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/AttributeNameIterator.j0000664 0001750 0001750 00000002060 12206661545 034367 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 24. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
import java.util.Iterator;
/**
* Provide an iterator over the attribute names of the current node of a reader.
*
* @author Joe Walnes
*/
public class AttributeNameIterator implements Iterator {
private int current;
private final int count;
private final HierarchicalStreamReader reader;
public AttributeNameIterator(HierarchicalStreamReader reader) {
this.reader = reader;
count = reader.getAttributeCount();
}
public boolean hasNext() {
return current < count;
}
public Object next() {
return reader.getAttributeName(current++);
}
public void remove() {
throw new UnsupportedOperationException();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/AbstractReader.java 0000664 0001750 0001750 00000005410 12206661545 033471 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2011 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 16. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io;
import com.thoughtworks.xstream.core.util.Cloneables;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.naming.NoNameCoder;
/**
* Abstract base class for all HierarchicalStreamReader implementations. Implementations of
* {@link HierarchicalStreamReader} should rather be derived from this class then implementing
* the interface directly.
*
* @author Jörg Schaible
* @since 1.4
*/
public abstract class AbstractReader implements ExtendedHierarchicalStreamReader {
private NameCoder nameCoder;
/**
* Creates an AbstractReader with a NameCoder that does nothing.
*
* @since 1.4
*/
protected AbstractReader() {
this(new NoNameCoder());
}
/**
* Creates an AbstractReader with a provided {@link NameCoder}.
*
* @param nameCoder the name coder used to read names from the incoming format
* @since 1.4
*/
protected AbstractReader(NameCoder nameCoder) {
this.nameCoder = (NameCoder)Cloneables.cloneIfPossible(nameCoder);
}
/**
* {@inheritDoc}
*/
public HierarchicalStreamReader underlyingReader() {
return this;
}
/**
* Decode a node name from the target format.
*
* @param name the name in the target format
* @return the original name
* @since 1.4
*/
public String decodeNode(String name) {
return nameCoder.decodeNode(name);
}
/**
* Decode an attribute name from the target format.
*
* @param name the name in the target format
* @return the original name
* @since 1.4
*/
public String decodeAttribute(String name) {
return nameCoder.decodeAttribute(name);
}
/**
* Encode the node name again into the name of the target format. Internally used.
*
* @param name the original name
* @return the name in the target format
* @since 1.4
*/
protected String encodeNode(String name) {
return nameCoder.encodeNode(name);
}
/**
* Encode the attribute name again into the name of the target format. Internally used.
*
* @param name the original name
* @return the name in the target format
* @since 1.4
*/
protected String encodeAttribute(String name) {
return nameCoder.encodeAttribute(name);
}
public String peekNextChild() {
throw new UnsupportedOperationException("peekNextChild");
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/StreamException.java 0000664 0001750 0001750 00000001412 12206661545 033713 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
import com.thoughtworks.xstream.XStreamException;
public class StreamException extends XStreamException {
public StreamException(Throwable e) {
super(e);
}
public StreamException(String message) {
super(message);
}
/**
* @since 1.4
*/
public StreamException(String message, Throwable cause) {
super(message, cause);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/ 0000775 0001750 0001750 00000000000 12206661545 030711 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JettisonMappedXmlDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JettisonMappedXmlD0000664 0001750 0001750 00000012277 12206661545 034360 0 ustar jamespage jamespage /*
* Copyright (c) 2007, 2008, 2009, 2010, 2011 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 30. March 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.json;
import com.thoughtworks.xstream.io.AbstractDriver;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.xml.QNameMap;
import com.thoughtworks.xstream.io.xml.StaxReader;
import com.thoughtworks.xstream.io.xml.StaxWriter;
import org.codehaus.jettison.mapped.Configuration;
import org.codehaus.jettison.mapped.MappedNamespaceConvention;
import org.codehaus.jettison.mapped.MappedXMLInputFactory;
import org.codehaus.jettison.mapped.MappedXMLOutputFactory;
import javax.xml.stream.XMLStreamException;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.Reader;
import java.io.Writer;
import java.net.URL;
/**
* Simple XStream driver wrapping Jettison's Mapped reader and writer. Serializes object from
* and to JSON.
*
* @author Dejan Bosanac
*/
public class JettisonMappedXmlDriver extends AbstractDriver {
private final MappedXMLOutputFactory mof;
private final MappedXMLInputFactory mif;
private final MappedNamespaceConvention convention;
private boolean useSerializeAsArray = true;
/**
* Construct a JettisonMappedXmlDriver.
*/
public JettisonMappedXmlDriver() {
this(new Configuration());
}
/**
* Construct a JettisonMappedXmlDriver with configuration.
* @param config the Jettison configuration
*/
public JettisonMappedXmlDriver(final Configuration config) {
this(config, true);
}
/**
* Construct a JettisonMappedXmlDriver with configuration. This constructor has been added
* by special request of Jettison users to support JSON generated by older Jettison
* versions. if the driver is setup to ignore the XStream hints for JSON arrays, there is
* neither support from XStream's side nor are there any tests to ensure this mode.
*
* @param config the Jettison configuration
* @param useSerializeAsArray flag to use XStream's hints for collections and arrays
* @since 1.4
*/
public JettisonMappedXmlDriver(final Configuration config, final boolean useSerializeAsArray) {
mof = new MappedXMLOutputFactory(config);
mif = new MappedXMLInputFactory(config);
convention = new MappedNamespaceConvention(config);
this.useSerializeAsArray = useSerializeAsArray;
}
public HierarchicalStreamReader createReader(final Reader reader) {
try {
return new StaxReader(new QNameMap(), mif.createXMLStreamReader(reader), getNameCoder());
} catch (final XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(final InputStream input) {
try {
return new StaxReader(new QNameMap(), mif.createXMLStreamReader(input), getNameCoder());
} catch (final XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(URL in) {
try {
return new StaxReader(new QNameMap(), mif.createXMLStreamReader(
in.toExternalForm(), in.openStream()), getNameCoder());
} catch (final XMLStreamException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamReader createReader(File in) {
try {
return new StaxReader(new QNameMap(), mif.createXMLStreamReader(in
.toURI()
.toASCIIString(), new FileInputStream(in)), getNameCoder());
} catch (final XMLStreamException e) {
throw new StreamException(e);
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(final Writer writer) {
try {
if (useSerializeAsArray) {
return new JettisonStaxWriter(new QNameMap(), mof.createXMLStreamWriter(writer), getNameCoder(), convention);
} else {
return new StaxWriter(new QNameMap(), mof.createXMLStreamWriter(writer), getNameCoder());
}
} catch (final XMLStreamException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter createWriter(final OutputStream output) {
try {
if (useSerializeAsArray) {
return new JettisonStaxWriter(new QNameMap(), mof.createXMLStreamWriter(output), getNameCoder(), convention);
} else {
return new StaxWriter(new QNameMap(), mof.createXMLStreamWriter(output), getNameCoder());
}
} catch (final XMLStreamException e) {
throw new StreamException(e);
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JsonWriter.java 0000664 0001750 0001750 00000026500 12206661545 033665 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 28. November 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.json;
import java.io.Writer;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.core.util.QuickWriter;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.naming.NoNameCoder;
/**
* A simple writer that outputs JSON in a pretty-printed indented stream. Arrays, Lists and Sets
* rely on you NOT using XStream.addImplicitCollection(..).
*
* @author Paul Hammant
* @author Jörg Schaible
* @since 1.3.1
*/
public class JsonWriter extends AbstractJsonWriter {
protected final QuickWriter writer;
protected final Format format;
private int depth;
private boolean newLineProposed;
/**
* @deprecated As of 1.4 use {@link JsonWriter#JsonWriter(Writer, Format) instead}
*/
public JsonWriter(Writer writer, char[] lineIndenter, String newLine) {
this(writer, 0, new Format(
lineIndenter, newLine.toCharArray(), Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT));
}
/**
* @deprecated As of 1.4 use {@link JsonWriter#JsonWriter(Writer, Format) instead}
*/
public JsonWriter(Writer writer, char[] lineIndenter) {
this(writer, 0, new Format(lineIndenter, new char[]{'\n'}, Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT));
}
/**
* @deprecated As of 1.4 use {@link JsonWriter#JsonWriter(Writer, Format) instead}
*/
public JsonWriter(Writer writer, String lineIndenter, String newLine) {
this(writer, 0, new Format(
lineIndenter.toCharArray(), newLine.toCharArray(), Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT));
}
/**
* @deprecated As of 1.4 use {@link JsonWriter#JsonWriter(Writer, Format) instead}
*/
public JsonWriter(Writer writer, String lineIndenter) {
this(writer, 0, new Format(
lineIndenter.toCharArray(), new char[]{'\n'}, Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT));
}
public JsonWriter(Writer writer) {
this(writer, 0, new Format(
new char[]{' ', ' '}, new char[]{'\n'}, Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT));
}
/**
* @since 1.3.1
* @deprecated As of 1.4 use {@link JsonWriter#JsonWriter(Writer, int, Format) instead}
*/
public JsonWriter(Writer writer, char[] lineIndenter, String newLine, int mode) {
this(writer, mode, new Format(
lineIndenter, newLine.toCharArray(), Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT));
}
/**
* Create a JsonWriter where the writer mode can be chosen.
*
* @param writer the {@link Writer} where the JSON is written to
* @param mode the JsonWriter mode
* @since 1.3.1
* @see #JsonWriter(Writer, int, Format)
*/
public JsonWriter(Writer writer, int mode) {
this(writer, mode, new Format());
}
/**
* Create a JsonWriter where the format is provided.
*
* @param writer the {@link Writer} where the JSON is written to
* @param format the JSON format definition
* @since 1.4
* @see #JsonWriter(Writer, int, Format)
*/
public JsonWriter(Writer writer, Format format) {
this(writer, 0, format);
}
/**
* Create a JsonWriter where the writer mode can be chosen and the format definition is
* provided.
*
* Following constants can be used as bit mask for the mode:
*
*
{@link #DROP_ROOT_MODE}: drop the root node
*
{@link #STRICT_MODE}: do not throw {@link ConversionException}, if writer should
* generate invalid JSON
*
{@link #EXPLICIT_MODE}: ensure that all available data is explicitly written even if
* addition objects must be added
*
*
*
* @param writer the {@link Writer} where the JSON is written to
* @param mode the JsonWriter mode
* @param format the JSON format definition
* @since 1.4
*/
public JsonWriter(Writer writer, int mode, Format format) {
this(writer, mode, format, 1024);
}
/**
* Create a JsonWriter.
*
* @param writer the {@link Writer} where the JSON is written to
* @param mode the JsonWriter mode
* @param format the JSON format definition
* @param bufferSize the buffer size of the internally used QuickWriter
* @see JsonWriter#JsonWriter(Writer, int, Format)
* @since 1.4
*/
public JsonWriter(Writer writer, int mode, Format format, int bufferSize) {
super(mode, format.getNameCoder());
this.writer = new QuickWriter(writer, bufferSize);
this.format = format;
depth = (mode & DROP_ROOT_MODE) == 0 ? -1 : 0;
}
public void flush() {
writer.flush();
}
public void close() {
writer.close();
}
public HierarchicalStreamWriter underlyingWriter() {
return this;
}
/**
* {@inheritDoc}
*/
protected void startObject() {
if (newLineProposed) {
writeNewLine();
}
writer.write('{');
startNewLine();
}
/**
* {@inheritDoc}
*/
protected void addLabel(String name) {
if (newLineProposed) {
writeNewLine();
}
writer.write('"');
writeText(name);
writer.write("\":");
if ((format.mode() & Format.SPACE_AFTER_LABEL) != 0) {
writer.write(' ');
}
}
/**
* {@inheritDoc}
*/
protected void addValue(String value, Type type) {
if (newLineProposed) {
writeNewLine();
}
if (type == Type.STRING) {
writer.write('"');
}
writeText(value);
if (type == Type.STRING) {
writer.write('"');
}
}
/**
* {@inheritDoc}
*/
protected void startArray() {
if (newLineProposed) {
writeNewLine();
}
writer.write("[");
startNewLine();
}
/**
* {@inheritDoc}
*/
protected void nextElement() {
writer.write(",");
writeNewLine();
}
/**
* {@inheritDoc}
*/
protected void endArray() {
endNewLine();
writer.write("]");
}
/**
* {@inheritDoc}
*/
protected void endObject() {
endNewLine();
writer.write("}");
}
private void startNewLine() {
if ( ++depth > 0) {
newLineProposed = true;
}
}
private void endNewLine() {
if (depth-- > 0) {
if (((format.mode() & Format.COMPACT_EMPTY_ELEMENT) != 0) && newLineProposed) {
newLineProposed = false;
} else {
writeNewLine();
}
}
}
private void writeNewLine() {
int depth = this.depth;
writer.write(format.getNewLine());
while (depth-- > 0) {
writer.write(format.getLineIndenter());
}
newLineProposed = false;
}
private void writeText(String text) {
int length = text.length();
for (int i = 0; i < length; i++ ) {
char c = text.charAt(i);
switch (c) {
case '"':
this.writer.write("\\\"");
break;
case '\\':
this.writer.write("\\\\");
break;
// turn this off - it is no CTRL char anyway
// case '/':
// this.writer.write("\\/");
// break;
case '\b':
this.writer.write("\\b");
break;
case '\f':
this.writer.write("\\f");
break;
case '\n':
this.writer.write("\\n");
break;
case '\r':
this.writer.write("\\r");
break;
case '\t':
this.writer.write("\\t");
break;
default:
if (c > 0x1f) {
this.writer.write(c);
} else {
this.writer.write("\\u");
String hex = "000" + Integer.toHexString(c);
this.writer.write(hex.substring(hex.length() - 4));
}
}
}
}
/**
* Format definition for JSON.
*
* @author Jörg Schaible
* @since 1.4
*/
public static class Format {
public static int SPACE_AFTER_LABEL = 1;
public static int COMPACT_EMPTY_ELEMENT = 2;
private char[] lineIndenter;
private char[] newLine;
private final int mode;
private final NameCoder nameCoder;
/**
* Create a new default Formatter. The formatter uses two spaces, normal line feed
* character, adds a space after the label and will try to compact the output.
*
* @since 1.4.2
*/
public Format() {
this(new char[]{' ', ' '}, new char[]{'\n'}, Format.SPACE_AFTER_LABEL
| Format.COMPACT_EMPTY_ELEMENT);
}
/**
* Create a new Formatter.
*
* @param lineIndenter the characters used for indenting the line
* @param newLine the characters used to create a new line
* @param mode the flags for the format modes
* @since 1.4
*/
public Format(char[] lineIndenter, char[] newLine, int mode) {
this(lineIndenter, newLine, mode, new NoNameCoder());
}
/**
* Create a new Formatter.
*
* @param lineIndenter the characters used for indenting the line
* @param newLine the characters used to create a new line
* @param mode the flags for the format modes
* @param nameCoder the name encoder and decoder
* @since 1.4.2
*/
public Format(char[] lineIndenter, char[] newLine, int mode, NameCoder nameCoder) {
this.lineIndenter = lineIndenter;
this.newLine = newLine;
this.mode = mode;
this.nameCoder = nameCoder;
}
/**
* Retrieve the lineIndenter.
*
* @return the lineIndenter
* @since 1.4
*/
public char[] getLineIndenter() {
return this.lineIndenter;
}
/**
* Retrieve the newLine.
*
* @return the newLine
* @since 1.4
*/
public char[] getNewLine() {
return this.newLine;
}
/**
* Retrieve the mode flags of the formatter.
*
* @return the mode
* @since 1.4
*/
public int mode() {
return this.mode;
}
/**
* Retrieve the NameCoder.
*
* @return the name coder
* @since 1.4.2
*/
public NameCoder getNameCoder() {
return nameCoder;
}
}
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JsonHierarchicalStreamWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JsonHierarchicalSt0000664 0001750 0001750 00000003412 12206661545 034353 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009 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 22. June 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.json;
import java.io.Writer;
/**
* A simple writer that outputs JSON in a pretty-printed indented stream. Arrays, Lists and Sets
* rely on you NOT using XStream.addImplicitCollection(..)
*
* @author Paul Hammant
* @author Jörg Schaible
* @since 1.2
* @deprecated As of 1.3.1, use JsonWriter instead
*/
public class JsonHierarchicalStreamWriter extends JsonWriter {
/**
* @deprecated As of 1.3.1, use JsonWriter instead
*/
public JsonHierarchicalStreamWriter(Writer writer, char[] lineIndenter, String newLine) {
super(writer, lineIndenter, newLine);
}
/**
* @deprecated As of 1.3.1, use JsonWriter instead
*/
public JsonHierarchicalStreamWriter(Writer writer, char[] lineIndenter) {
this(writer, lineIndenter, "\n");
}
/**
* @deprecated As of 1.3.1, use JsonWriter instead
*/
public JsonHierarchicalStreamWriter(Writer writer, String lineIndenter, String newLine) {
this(writer, lineIndenter.toCharArray(), newLine);
}
/**
* @deprecated As of 1.3.1, use JsonWriter instead
*/
public JsonHierarchicalStreamWriter(Writer writer, String lineIndenter) {
this(writer, lineIndenter.toCharArray());
}
/**
* @deprecated As of 1.3.1, use JsonWriter instead
*/
public JsonHierarchicalStreamWriter(Writer writer) {
this(writer, new char[]{' ', ' '});
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JettisonStaxWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JettisonStaxWriter0000664 0001750 0001750 00000007466 12206661545 034505 0 ustar jamespage jamespage /*
* Copyright (c) 2008, 2009, 2010, 2011 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 17.04.2008 by Joerg Schaible.
*/
package com.thoughtworks.xstream.io.json;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.xml.QNameMap;
import com.thoughtworks.xstream.io.xml.StaxWriter;
import com.thoughtworks.xstream.io.xml.XmlFriendlyReplacer;
import org.codehaus.jettison.AbstractXMLStreamWriter;
import org.codehaus.jettison.mapped.MappedNamespaceConvention;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamWriter;
import java.util.Collection;
import java.util.Map;
/**
* A specialized {@link StaxWriter} that makes usage of internal functionality of Jettison.
*
* @author Jörg Schaible
* @since 1.3.1
*/
public class JettisonStaxWriter extends StaxWriter {
private final MappedNamespaceConvention convention;
/**
* @since 1.4
*/
public JettisonStaxWriter(
QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument,
boolean namespaceRepairingMode, NameCoder nameCoder,
MappedNamespaceConvention convention) throws XMLStreamException {
super(qnameMap, out, writeEnclosingDocument, namespaceRepairingMode, nameCoder);
this.convention = convention;
}
/**
* @deprecated As of 1.4 use
* {@link JettisonStaxWriter#JettisonStaxWriter(QNameMap, XMLStreamWriter, boolean, boolean, NameCoder, MappedNamespaceConvention)}
* instead
*/
public JettisonStaxWriter(
QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument,
boolean namespaceRepairingMode, XmlFriendlyReplacer replacer,
MappedNamespaceConvention convention) throws XMLStreamException {
this(qnameMap, out, writeEnclosingDocument, namespaceRepairingMode, (NameCoder) replacer, convention);
}
public JettisonStaxWriter(
QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument,
boolean namespaceRepairingMode, MappedNamespaceConvention convention)
throws XMLStreamException {
super(qnameMap, out, writeEnclosingDocument, namespaceRepairingMode);
this.convention = convention;
}
public JettisonStaxWriter(
QNameMap qnameMap, XMLStreamWriter out, MappedNamespaceConvention convention)
throws XMLStreamException {
super(qnameMap, out);
this.convention = convention;
}
/**
* @since 1.4
*/
public JettisonStaxWriter(
QNameMap qnameMap, XMLStreamWriter out, NameCoder nameCoder, MappedNamespaceConvention convention)
throws XMLStreamException {
super(qnameMap, out, nameCoder);
this.convention = convention;
}
public void startNode(String name, Class clazz) {
XMLStreamWriter out = getXMLStreamWriter();
if (clazz != null && out instanceof AbstractXMLStreamWriter) {
if (Collection.class.isAssignableFrom(clazz)
|| Map.class.isAssignableFrom(clazz)
|| clazz.isArray()) {
QName qname = getQNameMap().getQName(encodeNode(name));
String prefix = qname.getPrefix();
String uri = qname.getNamespaceURI();
String key = convention.createKey(prefix, uri, qname.getLocalPart());
if (!((AbstractXMLStreamWriter)out).getSerializedAsArrays().contains(key)) {
// Typo is in the API of Jettison ...
((AbstractXMLStreamWriter)out).seriliazeAsArray(key);
}
}
}
startNode(name);
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/AbstractJsonWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/AbstractJsonWriter0000664 0001750 0001750 00000060532 12206661545 034434 0 ustar jamespage jamespage /*
* Copyright (C) 2009, 2010, 2011, 2012 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 20. August 2009 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.json;
import java.io.Externalizable;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.util.Arrays;
import java.util.Collection;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.core.util.FastStack;
import com.thoughtworks.xstream.io.AbstractWriter;
import com.thoughtworks.xstream.io.naming.NameCoder;
import com.thoughtworks.xstream.io.naming.NoNameCoder;
import com.thoughtworks.xstream.mapper.Mapper;
/**
* An abstract implementation of a writer that calls abstract methods to build JSON structures.
* Note, that XStream's implicit collection feature is only compatible with the syntax in
* {@link #EXPLICIT_MODE}.
*
* @author Jörg Schaible
* @since 1.4
*/
public abstract class AbstractJsonWriter extends AbstractWriter {
/**
* DROP_ROOT_MODE drops the JSON root node.
*
* The root node is the first level of the JSON object i.e.
*
*
* { "person": {
* "name": "Joe"
* }}
*
*
* will be written without root simply as
*
*
* {
* "name": "Joe"
* }
*
*
* Without a root node, the top level element might now also be an array. However, it is
* possible to generate invalid JSON unless {@link #STRICT_MODE} is also set.
*
*
* @since 1.3.1
*/
public static final int DROP_ROOT_MODE = 1;
/**
* STRICT_MODE prevents invalid JSON for single value objects when dropping the root.
*
* The mode is only useful in combination with the {@link #DROP_ROOT_MODE}. An object with a
* single value as first node i.e.
*
*
* { "name": "Joe" }
*
*
* is simply written as
*
*
* "Joe"
*
*
* However, this is no longer valid JSON. Therefore you can activate {@link #STRICT_MODE}
* and a {@link ConversionException} is thrown instead.
*
*
* @since 1.3.1
*/
public static final int STRICT_MODE = 2;
/**
* EXPLICIT_MODE assures that all data has its explicit equivalent in the resulting JSON.
*
* XStream is normally using attributes in XML that have no real equivalent in JSON.
* Additionally it is essential in XML that the individual child elements of a tag keep
* order and may have the same tag name. XStream's model relies on both characteristics.
* However, properties of a JSON object do not have a defined order, but their names have to
* be unique. Only a JSON array defines the order of its elements.
*
*
* Therefore XStream uses in explicit mode a JSON format that supports the original
* requirements at the expense of the simplicity of the JSON objects and arrays. Each Java
* object will be represented by a JSON object with a single property representing the name
* of the object and an array as value that contains two more arrays. The first one contains
* a JSON object with all attributes, the second one the value of the Java object which can
* be null, a string or integer value or again a new JSON object representing a Java object.
* Here an example of an string array with one member, where the array and the string has an
* additional attribute 'id':
*
*
*
* This format can be used to always deserialize into Java again.
*
*
* This mode cannot be combined with one of the other modes.
*
*
* @since 1.4
*/
public static final int EXPLICIT_MODE = 4;
public static class Type {
public static Type NULL = new Type();
public static Type STRING = new Type();
public static Type NUMBER = new Type();
public static Type BOOLEAN = new Type();
}
private static class StackElement {
final Class type;
int status;
public StackElement(Class type, int status) {
this.type = type;
this.status = status;
}
}
private static class IllegalWriterStateException extends IllegalStateException {
public IllegalWriterStateException(int from, int to, String element) {
super("Cannot turn from state " + getState(from) + " into state " + getState(to)
+ (element == null ? "" : " for property " + element));
}
private static String getState(int state) {
switch (state) {
case STATE_ROOT: return "ROOT";
case STATE_END_OBJECT: return "END_OBJECT";
case STATE_START_OBJECT: return "START_OBJECT";
case STATE_START_ATTRIBUTES: return "START_ATTRIBUTES";
case STATE_NEXT_ATTRIBUTE: return "NEXT_ATTRIBUTE";
case STATE_END_ATTRIBUTES: return "END_ATTRIBUTES";
case STATE_START_ELEMENTS: return "START_ELEMENTS";
case STATE_NEXT_ELEMENT: return "NEXT_ELEMENT";
case STATE_END_ELEMENTS: return "END_ELEMENTS";
case STATE_SET_VALUE: return "SET_VALUE";
default: throw new IllegalArgumentException("Unknown state provided: " + state
+ ", cannot create message for IllegalWriterStateException");
}
}
}
private static final int STATE_ROOT = 1 << 0;
private static final int STATE_END_OBJECT = 1 << 1;
private static final int STATE_START_OBJECT = 1 << 2;
private static final int STATE_START_ATTRIBUTES = 1 << 3;
private static final int STATE_NEXT_ATTRIBUTE = 1 << 4;
private static final int STATE_END_ATTRIBUTES = 1 << 5;
private static final int STATE_START_ELEMENTS = 1 << 6;
private static final int STATE_NEXT_ELEMENT = 1 << 7;
private static final int STATE_END_ELEMENTS = 1 << 8;
private static final int STATE_SET_VALUE = 1 << 9;
private static final Set NUMBER_TYPES = new HashSet(Arrays.asList(new Class[]{
byte.class, Byte.class, short.class, Short.class, int.class, Integer.class, long.class,
Long.class, float.class, Float.class, double.class, Double.class, BigInteger.class,
BigDecimal.class}));
private int mode;
private FastStack stack = new FastStack(16);
private int expectedStates;
/**
* Construct a JSON writer.
*
* @since 1.4
*/
public AbstractJsonWriter() {
this(new NoNameCoder());
}
/**
* Construct a JSON writer with a special mode.
*
* @param mode a bit mask of the mode constants
* @since 1.4
*/
public AbstractJsonWriter(int mode) {
this(mode, new NoNameCoder());
}
/**
* Construct a JSON writer with a special name coder.
*
* @param nameCoder the name coder to use
* @since 1.4
*/
public AbstractJsonWriter(NameCoder nameCoder) {
this(0, nameCoder);
}
/**
* Construct a JSON writer with a special mode and name coder.
*
* @param mode a bit mask of the mode constants
* @param nameCoder the name coder to use
* @since 1.4
*/
public AbstractJsonWriter(int mode, NameCoder nameCoder) {
super(nameCoder);
this.mode = (mode & EXPLICIT_MODE) > 0 ? EXPLICIT_MODE : mode;
stack.push(new StackElement(null, STATE_ROOT));
expectedStates = STATE_START_OBJECT;
}
public void startNode(String name, Class clazz) {
if (name == null) {
throw new NullPointerException("name");
}
stack.push(new StackElement(clazz, ((StackElement)stack.peek()).status));
handleCheckedStateTransition(STATE_START_OBJECT, name, null);
expectedStates = STATE_SET_VALUE | STATE_NEXT_ATTRIBUTE | STATE_START_OBJECT | STATE_NEXT_ELEMENT | STATE_ROOT;
}
public void startNode(String name) {
startNode(name, null);
}
public void addAttribute(String name, String value) {
handleCheckedStateTransition(STATE_NEXT_ATTRIBUTE, name, value);
expectedStates = STATE_SET_VALUE | STATE_NEXT_ATTRIBUTE | STATE_START_OBJECT | STATE_NEXT_ELEMENT | STATE_ROOT;
}
public void setValue(String text) {
Class type = ((StackElement)stack.peek()).type;
if ((type == Character.class || type == Character.TYPE) && "".equals(text)) {
text = "\u0000";
}
handleCheckedStateTransition(STATE_SET_VALUE, null, text);
expectedStates = STATE_NEXT_ELEMENT | STATE_ROOT;
}
public void endNode() {
int size = stack.size();
int nextState = size > 2 ? STATE_NEXT_ELEMENT : STATE_ROOT;
handleCheckedStateTransition(nextState, null, null);
stack.pop();
((StackElement)stack.peek()).status = nextState;
expectedStates = STATE_START_OBJECT;
if (size > 2) {
expectedStates |= STATE_NEXT_ELEMENT | STATE_ROOT;
}
}
private void handleCheckedStateTransition(final int requiredState, final String elementToAdd, final String valueToAdd)
{
final StackElement stackElement = (StackElement)stack.peek();
if ((expectedStates & requiredState) == 0) {
throw new IllegalWriterStateException(stackElement.status, requiredState, elementToAdd);
}
int currentState = handleStateTransition(stackElement.status, requiredState, elementToAdd, valueToAdd);
stackElement.status = currentState;
}
private int handleStateTransition(int currentState, final int requiredState, final String elementToAdd, final String valueToAdd)
{
int size = stack.size();
Class currentType = ((StackElement)stack.peek()).type;
boolean isArray = size > 1 && isArray(currentType);
boolean isArrayElement = size > 1 && isArray(((StackElement)stack.get(size-2)).type);
switch(currentState) {
case STATE_ROOT:
if (requiredState == STATE_START_OBJECT) {
currentState = handleStateTransition(STATE_START_ELEMENTS, STATE_START_OBJECT, elementToAdd, null);
return requiredState;
}
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
case STATE_END_OBJECT:
switch(requiredState) {
case STATE_START_OBJECT:
currentState = handleStateTransition(currentState, STATE_NEXT_ELEMENT, null, null);
currentState = handleStateTransition(currentState, STATE_START_OBJECT, elementToAdd, null);
return requiredState;
case STATE_NEXT_ELEMENT:
nextElement();
return requiredState;
case STATE_ROOT:
if (((mode & DROP_ROOT_MODE) == 0 || size > 2) && (mode & EXPLICIT_MODE) == 0) {
endObject();
}
return requiredState;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
case STATE_START_OBJECT:
switch(requiredState) {
case STATE_SET_VALUE:
case STATE_START_OBJECT:
case STATE_ROOT:
case STATE_NEXT_ELEMENT:
if (!isArrayElement || (mode & EXPLICIT_MODE) != 0) {
currentState = handleStateTransition(currentState, STATE_START_ATTRIBUTES, null, null);
currentState = handleStateTransition(currentState, STATE_END_ATTRIBUTES, null, null);
}
currentState = STATE_START_ELEMENTS;
switch(requiredState) {
case STATE_SET_VALUE:
currentState = handleStateTransition(currentState, STATE_SET_VALUE, null, valueToAdd);
break;
case STATE_START_OBJECT:
currentState = handleStateTransition(currentState, STATE_START_OBJECT, elementToAdd, null);
break;
case STATE_ROOT:
case STATE_NEXT_ELEMENT:
currentState = handleStateTransition(currentState, STATE_SET_VALUE, null, null);
currentState = handleStateTransition(currentState, requiredState, null, null);
break;
}
return requiredState;
case STATE_START_ATTRIBUTES:
if ((mode & EXPLICIT_MODE) != 0) {
startArray();
}
return requiredState;
case STATE_NEXT_ATTRIBUTE:
if ((mode & EXPLICIT_MODE) != 0 || !isArray) {
currentState = handleStateTransition(currentState, STATE_START_ATTRIBUTES, null, null);
currentState = handleStateTransition(currentState, STATE_NEXT_ATTRIBUTE, elementToAdd, valueToAdd);
return requiredState;
} else {
return STATE_START_OBJECT;
}
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
case STATE_NEXT_ELEMENT:
switch(requiredState) {
case STATE_START_OBJECT:
nextElement();
if (!isArrayElement && (mode & EXPLICIT_MODE) == 0) {
addLabel(encodeNode(elementToAdd));
if ((mode & EXPLICIT_MODE) == 0 && isArray) {
startArray();
}
return requiredState;
}
break;
case STATE_ROOT:
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
currentState = handleStateTransition(currentState, STATE_ROOT, null, null);
return requiredState;
case STATE_NEXT_ELEMENT:
case STATE_END_OBJECT:
currentState = handleStateTransition(currentState, STATE_END_ELEMENTS, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
if ((mode & EXPLICIT_MODE) == 0 && !isArray) {
endObject();
}
return requiredState;
case STATE_END_ELEMENTS:
if ((mode & EXPLICIT_MODE) == 0 && isArray) {
endArray();
}
return requiredState;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
// fall through
case STATE_START_ELEMENTS:
switch(requiredState) {
case STATE_START_OBJECT:
if ((mode & DROP_ROOT_MODE) == 0 || size > 2) {
if (!isArrayElement || (mode & EXPLICIT_MODE) != 0) {
if (!"".equals(valueToAdd)) {
startObject();
}
addLabel(encodeNode(elementToAdd));
}
if ((mode & EXPLICIT_MODE) != 0) {
startArray();
}
}
if ((mode & EXPLICIT_MODE) == 0) {
if (isArray) {
startArray();
}
}
return requiredState;
case STATE_SET_VALUE:
if ((mode & STRICT_MODE) != 0 && size == 2) {
throw new ConversionException("Single value cannot be root element");
}
if (valueToAdd == null) {
if (currentType == Mapper.Null.class) {
addValue("null", Type.NULL);
} else if ((mode & EXPLICIT_MODE) == 0 && !isArray) {
startObject();
endObject();
}
} else {
addValue(valueToAdd, getType(currentType));
}
return requiredState;
case STATE_END_ELEMENTS:
case STATE_NEXT_ELEMENT:
if ((mode & EXPLICIT_MODE) == 0) {
if (isArray) {
endArray();
} else {
endObject();
}
}
return requiredState;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
case STATE_END_ELEMENTS:
switch(requiredState) {
case STATE_END_OBJECT:
if ((mode & EXPLICIT_MODE) != 0) {
endArray();
endArray();
endObject();
}
return requiredState;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
case STATE_START_ATTRIBUTES:
switch(requiredState) {
case STATE_NEXT_ATTRIBUTE:
if (elementToAdd != null) {
String name = ((mode & EXPLICIT_MODE) == 0 ? "@" : "" ) + elementToAdd;
startObject();
addLabel(encodeAttribute(name));
addValue(valueToAdd, Type.STRING);
}
return requiredState;
}
// fall through
case STATE_NEXT_ATTRIBUTE:
switch(requiredState) {
case STATE_END_ATTRIBUTES:
if ((mode & EXPLICIT_MODE) != 0) {
if (currentState == STATE_NEXT_ATTRIBUTE) {
endObject();
}
endArray();
nextElement();
startArray();
}
return requiredState;
case STATE_NEXT_ATTRIBUTE:
if (!isArray || (mode & EXPLICIT_MODE) != 0) {
nextElement();
String name = ((mode & EXPLICIT_MODE) == 0 ? "@" : "" ) + elementToAdd;
addLabel(encodeAttribute(name));
addValue(valueToAdd, Type.STRING);
}
return requiredState;
case STATE_SET_VALUE:
case STATE_START_OBJECT:
currentState = handleStateTransition(currentState, STATE_END_ATTRIBUTES, null, null);
currentState = handleStateTransition(currentState, STATE_START_ELEMENTS, null, null);
switch (requiredState) {
case STATE_SET_VALUE:
if ((mode & EXPLICIT_MODE) == 0) {
addLabel(encodeNode("$"));
}
currentState = handleStateTransition(currentState, STATE_SET_VALUE, null, valueToAdd);
if ((mode & EXPLICIT_MODE) == 0) {
endObject();
}
break;
case STATE_START_OBJECT:
currentState = handleStateTransition(currentState, STATE_START_OBJECT, elementToAdd, (mode & EXPLICIT_MODE) == 0 ? "" : null);
break;
case STATE_END_OBJECT:
currentState = handleStateTransition(currentState, STATE_SET_VALUE, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
break;
}
return requiredState;
case STATE_NEXT_ELEMENT:
currentState = handleStateTransition(currentState, STATE_END_ATTRIBUTES, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
return requiredState;
case STATE_ROOT:
currentState = handleStateTransition(currentState, STATE_END_ATTRIBUTES, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
currentState = handleStateTransition(currentState, STATE_ROOT, null, null);
return requiredState;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
case STATE_END_ATTRIBUTES:
switch(requiredState) {
case STATE_START_ELEMENTS:
if ((mode & EXPLICIT_MODE) == 0) {
nextElement();
}
break;
case STATE_END_OBJECT:
currentState = handleStateTransition(STATE_START_ELEMENTS, STATE_END_ELEMENTS, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
break;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
return requiredState;
case STATE_SET_VALUE:
switch(requiredState) {
case STATE_END_ELEMENTS:
if ((mode & EXPLICIT_MODE) == 0 && isArray) {
endArray();
}
return requiredState;
case STATE_NEXT_ELEMENT:
currentState = handleStateTransition(currentState, STATE_END_ELEMENTS, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
return requiredState;
case STATE_ROOT:
currentState = handleStateTransition(currentState, STATE_END_ELEMENTS, null, null);
currentState = handleStateTransition(currentState, STATE_END_OBJECT, null, null);
currentState = handleStateTransition(currentState, STATE_ROOT, null, null);
return requiredState;
default:
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
}
throw new IllegalWriterStateException(currentState, requiredState, elementToAdd);
}
/**
* Method to return the appropriate JSON type for a Java type.
*
* @param clazz the type
* @return One of the {@link Type} instances
* @since 1.4.4
*/
protected Type getType(Class clazz) {
return (clazz == Mapper.Null.class || clazz == null)
? Type.NULL
: (clazz == Boolean.class || clazz == Boolean.TYPE)
? Type.BOOLEAN
: NUMBER_TYPES.contains(clazz)
? Type.NUMBER
: Type.STRING;
}
/**
* Method to declare various Java types to be handles as JSON array.
*
* @param clazz the type
* @return true if handles as array
* @since 1.4
*/
protected boolean isArray(Class clazz) {
return clazz != null && (clazz.isArray()
|| Collection.class.isAssignableFrom(clazz)
|| Externalizable.class.isAssignableFrom(clazz)
|| Map.class.isAssignableFrom(clazz)
|| Map.Entry.class.isAssignableFrom(clazz));
}
/**
* Start a JSON object.
*
* @since 1.4
*/
protected abstract void startObject();
/**
* Add a label to a JSON object.
*
* @param name the label's name
* @since 1.4
*/
protected abstract void addLabel(String name);
/**
* Add a value to a JSON object's label or to an array.
*
* @param value the value itself
* @param type the JSON type
* @since 1.4
*/
protected abstract void addValue(String value, Type type);
/**
* Start a JSON array.
*
* @since 1.4
*/
protected abstract void startArray();
/**
* Prepare a JSON object or array for another element.
*
* @since 1.4
*/
protected abstract void nextElement();
/**
* End the JSON array.
*
* @since 1.4
*/
protected abstract void endArray();
/**
* End the JSON object.
*
* @since 1.4
*/
protected abstract void endObject();
}
././@LongLink 0000644 0000000 0000000 00000000164 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JsonHierarchicalStreamDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/json/JsonHierarchicalSt0000664 0001750 0001750 00000005225 12206661545 034357 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2011 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 22. June 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.io.json;
import com.thoughtworks.xstream.io.AbstractDriver;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.naming.NameCoder;
import java.io.File;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.UnsupportedEncodingException;
import java.io.Writer;
import java.net.URL;
/**
* A driver for JSON that writes optimized JSON format, but is not able to deserialize the result.
*
* @author Paul Hammant
* @since 1.2
*/
public class JsonHierarchicalStreamDriver extends AbstractDriver {
/**
* Construct a JsonHierarchicalStreamDriver.
*/
public JsonHierarchicalStreamDriver() {
super();
}
/**
* Construct a JsonHierarchicalStreamDriver with name coding.
*
* @param nameCoder the coder to encode and decode the JSON labels.
* @since 1.4.2
*/
public JsonHierarchicalStreamDriver(NameCoder nameCoder) {
super(nameCoder);
}
public HierarchicalStreamReader createReader(Reader in) {
throw new UnsupportedOperationException("The JsonHierarchicalStreamDriver can only write JSON");
}
public HierarchicalStreamReader createReader(InputStream in) {
throw new UnsupportedOperationException("The JsonHierarchicalStreamDriver can only write JSON");
}
public HierarchicalStreamReader createReader(URL in) {
throw new UnsupportedOperationException("The JsonHierarchicalStreamDriver can only write JSON");
}
public HierarchicalStreamReader createReader(File in) {
throw new UnsupportedOperationException("The JsonHierarchicalStreamDriver can only write JSON");
}
/**
* Create a HierarchicalStreamWriter that writes JSON.
*/
public HierarchicalStreamWriter createWriter(Writer out) {
return new JsonWriter(out);
}
public HierarchicalStreamWriter createWriter(OutputStream out) {
try {
// JSON spec requires UTF-8
return createWriter(new OutputStreamWriter(out, "UTF-8"));
} catch (UnsupportedEncodingException e) {
throw new StreamException(e);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000163 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ExtendedHierarchicalStreamReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/ExtendedHierarchicalStr0000664 0001750 0001750 00000001265 12206661545 034417 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 13. October 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.io;
/**
* @author Jörg Schaible
* @since 1.4.2
*/
public interface ExtendedHierarchicalStreamReader extends HierarchicalStreamReader {
/**
* Peek the name of the next child. In situation where {@link #hasMoreChildren()} returns
* true, peek the tag name of the child.
*
* @since 1.4.2
*/
String peekNextChild();
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/HierarchicalStreamWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/HierarchicalStreamWrite0000664 0001750 0001750 00000003556 12206661545 034441 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
/**
* @author Joe Walnes
*/
public interface HierarchicalStreamWriter {
void startNode(String name);
void addAttribute(String name, String value);
/**
* Write the value (text content) of the current node.
*/
void setValue(String text);
void endNode();
/**
* Flush the writer, if necessary.
*/
void flush();
/**
* Close the writer, if necessary.
*/
void close();
/**
* Return the underlying HierarchicalStreamWriter implementation.
*
*
If a Converter needs to access methods of a specific HierarchicalStreamWriter implementation that are not
* defined in the HierarchicalStreamWriter interface, it should call this method before casting. This is because
* the writer passed to the Converter is often wrapped/decorated by another implementation to provide additional
* functionality (such as XPath tracking).
Implementations of HierarchicalStreamWriter should return 'this', unless they are a decorator, in which case
* they should delegate to whatever they are wrapping.
*/
HierarchicalStreamWriter underlyingWriter();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/ 0000775 0001750 0001750 00000000000 12206661545 031224 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/ReaderDepthState.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/ReaderDepthState0000664 0001750 0001750 00000007573 12206661545 034353 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 04. June 2006 by Joe Walnes
*/
package com.thoughtworks.xstream.io.binary;
import java.util.List;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.Collections;
/**
* Maintains the state of a pull reader at various states in the document depth.
*
* Used by the {@link BinaryStreamReader}
*
* @author Joe Walnes
* @since 1.2
*/
class ReaderDepthState {
private static final String EMPTY_STRING = "";
private static class State {
String name;
String value;
List attributes;
boolean hasMoreChildren;
State parent;
}
private static class Attribute {
String name;
String value;
}
private State current;
public void push() {
State newState = new State();
newState.parent = current;
current = newState;
}
public void pop() {
current = current.parent;
}
public String getName() {
return current.name;
}
public void setName(String name) {
current.name = name;
}
public String getValue() {
return current.value == null ? EMPTY_STRING : current.value;
}
public void setValue(String value) {
current.value = value;
}
public boolean hasMoreChildren() {
return current.hasMoreChildren;
}
public void setHasMoreChildren(boolean hasMoreChildren) {
current.hasMoreChildren = hasMoreChildren;
}
public void addAttribute(String name, String value) {
Attribute attribute = new Attribute();
attribute.name = name;
attribute.value = value;
if (current.attributes == null) {
current.attributes = new ArrayList();
}
current.attributes.add(attribute);
}
public String getAttribute(String name) {
if (current.attributes == null) {
return null;
} else {
// For short maps, it's faster to iterate then do a hashlookup.
for (Iterator iterator = current.attributes.iterator(); iterator.hasNext();) {
Attribute attribute = (Attribute) iterator.next();
if (attribute.name.equals(name)) {
return attribute.value;
}
}
return null;
}
}
public String getAttribute(int index) {
if (current.attributes == null) {
return null;
} else {
Attribute attribute = (Attribute) current.attributes.get(index);
return attribute.value;
}
}
public String getAttributeName(int index) {
if (current.attributes == null) {
return null;
} else {
Attribute attribute = (Attribute) current.attributes.get(index);
return attribute.name;
}
}
public int getAttributeCount() {
return current.attributes == null ? 0 : current.attributes.size();
}
public Iterator getAttributeNames() {
if (current.attributes == null) {
return Collections.EMPTY_SET.iterator();
} else {
final Iterator attributeIterator = current.attributes.iterator();
return new Iterator() {
public boolean hasNext() {
return attributeIterator.hasNext();
}
public Object next() {
Attribute attribute = (Attribute) attributeIterator.next();
return attribute.name;
}
public void remove() {
throw new UnsupportedOperationException();
}
};
}
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/BinaryStreamReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/BinaryStreamRead0000664 0001750 0001750 00000014771 12206661545 034355 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 04. June 2006 by Joe Walnes
*/
package com.thoughtworks.xstream.io.binary;
import com.thoughtworks.xstream.converters.ErrorWriter;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.StreamException;
import java.io.DataInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
/**
* A HierarchicalStreamReader that reads from a binary stream created by
* {@link BinaryStreamWriter}.
*
*
This produces
*
* @author Joe Walnes
* @see BinaryStreamReader
* @since 1.2
*/
public class BinaryStreamReader implements ExtendedHierarchicalStreamReader {
private final DataInputStream in;
private final ReaderDepthState depthState = new ReaderDepthState();
private final IdRegistry idRegistry = new IdRegistry();
private Token pushback;
private final Token.Formatter tokenFormatter = new Token.Formatter();
public BinaryStreamReader(InputStream inputStream) {
in = new DataInputStream(inputStream);
moveDown();
}
public boolean hasMoreChildren() {
return depthState.hasMoreChildren();
}
public String getNodeName() {
return depthState.getName();
}
public String getValue() {
return depthState.getValue();
}
public String getAttribute(String name) {
return depthState.getAttribute(name);
}
public String getAttribute(int index) {
return depthState.getAttribute(index);
}
public int getAttributeCount() {
return depthState.getAttributeCount();
}
public String getAttributeName(int index) {
return depthState.getAttributeName(index);
}
public Iterator getAttributeNames() {
return depthState.getAttributeNames();
}
public void moveDown() {
depthState.push();
Token firstToken = readToken();
switch (firstToken.getType()) {
case Token.TYPE_START_NODE:
depthState.setName(idRegistry.get(firstToken.getId()));
break;
default:
throw new StreamException("Expected StartNode");
}
while (true) {
Token nextToken = readToken();
switch (nextToken.getType()) {
case Token.TYPE_ATTRIBUTE:
depthState.addAttribute(idRegistry.get(nextToken.getId()), nextToken.getValue());
break;
case Token.TYPE_VALUE:
depthState.setValue(nextToken.getValue());
break;
case Token.TYPE_END_NODE:
depthState.setHasMoreChildren(false);
pushBack(nextToken);
return;
case Token.TYPE_START_NODE:
depthState.setHasMoreChildren(true);
pushBack(nextToken);
return;
default:
throw new StreamException("Unexpected token " + nextToken);
}
}
}
public void moveUp() {
depthState.pop();
// We're done with this depth. Skip over all tokens until we get to the end.
int depth = 0;
slurp:
while (true) {
Token nextToken = readToken();
switch(nextToken.getType()) {
case Token.TYPE_END_NODE:
if (depth == 0) {
break slurp;
} else {
depth--;
}
break;
case Token.TYPE_START_NODE:
depth++;
break;
default:
// Ignore other tokens
}
}
// Peek ahead to determine if there are any more kids at this level.
Token nextToken = readToken();
switch(nextToken.getType()) {
case Token.TYPE_END_NODE:
depthState.setHasMoreChildren(false);
break;
case Token.TYPE_START_NODE:
depthState.setHasMoreChildren(true);
break;
default:
throw new StreamException("Unexpected token " + nextToken);
}
pushBack(nextToken);
}
private Token readToken() {
if (pushback == null) {
try {
Token token = tokenFormatter.read(in);
switch (token.getType()) {
case Token.TYPE_MAP_ID_TO_VALUE:
idRegistry.put(token.getId(), token.getValue());
return readToken(); // Next one please.
default:
return token;
}
} catch (IOException e) {
throw new StreamException(e);
}
} else {
Token result = pushback;
pushback = null;
return result;
}
}
public void pushBack(Token token) {
if (pushback == null) {
pushback = token;
} else {
// If this happens, I've messed up :( -joe.
throw new Error("Cannot push more than one token back");
}
}
public void close() {
try {
in.close();
} catch (IOException e) {
throw new StreamException(e);
}
}
public String peekNextChild() {
if (depthState.hasMoreChildren()) {
return idRegistry.get(pushback.getId());
}
return null;
}
public HierarchicalStreamReader underlyingReader() {
return this;
}
public void appendErrors(ErrorWriter errorWriter) {
// TODO: When things go bad, it would be good to know where!
}
private static class IdRegistry {
private Map map = new HashMap();
public void put(long id, String value) {
map.put(new Long(id), value);
}
public String get(long id) {
String result = (String) map.get(new Long(id));
if (result == null) {
throw new StreamException("Unknown ID : " + id);
} else {
return result;
}
}
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/BinaryStreamWriter.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/BinaryStreamWrit0000664 0001750 0001750 00000005060 12206661545 034416 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 04. June 2006 by Joe Walnes
*/
package com.thoughtworks.xstream.io.binary;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.ExtendedHierarchicalStreamWriter;
import java.io.DataOutputStream;
import java.io.OutputStream;
import java.io.IOException;
import java.util.Map;
import java.util.HashMap;
/**
* @since 1.2
*/
public class BinaryStreamWriter implements ExtendedHierarchicalStreamWriter {
private final IdRegistry idRegistry = new IdRegistry();
private final DataOutputStream out;
private final Token.Formatter tokenFormatter = new Token.Formatter();
public BinaryStreamWriter(OutputStream outputStream) {
out = new DataOutputStream(outputStream);
}
public void startNode(String name) {
write(new Token.StartNode(idRegistry.getId(name)));
}
public void startNode(String name, Class clazz) {
startNode(name);
}
public void addAttribute(String name, String value) {
write(new Token.Attribute(idRegistry.getId(name), value));
}
public void setValue(String text) {
write(new Token.Value(text));
}
public void endNode() {
write(new Token.EndNode());
}
public void flush() {
try {
out.flush();
} catch (IOException e) {
throw new StreamException(e);
}
}
public void close() {
try {
out.close();
} catch (IOException e) {
throw new StreamException(e);
}
}
public HierarchicalStreamWriter underlyingWriter() {
return this;
}
private void write(Token token) {
try {
tokenFormatter.write(out, token);
} catch (IOException e) {
throw new StreamException(e);
}
}
private class IdRegistry {
private long nextId = 0;
private Map ids = new HashMap();
public long getId(String value) {
Long id = (Long) ids.get(value);
if (id == null) {
id = new Long(++nextId);
ids.put(value, id);
write(new Token.MapIdToValue(id.longValue(), value));
}
return id.longValue();
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/Token.java 0000664 0001750 0001750 00000022054 12206661545 033152 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 04. June 2006 by Joe Walnes
*/
package com.thoughtworks.xstream.io.binary;
import com.thoughtworks.xstream.io.StreamException;
import java.io.DataOutput;
import java.io.IOException;
import java.io.DataInput;
/**
* Represents the Tokens stored in the binary stream used by
* {@link BinaryStreamReader} and {@link BinaryStreamWriter}.
*
*
A token consists of a type and (depending on this type)
* it may additionally have an ID (positive long number)
* and/or a value (String).
*
*
The first byte of the token represents how many subsequent
* bytes are used by the ID.
*
* @author Joe Walnes
* @see BinaryStreamReader
* @see BinaryStreamWriter
* @since 1.2
*/
public abstract class Token {
private static final byte TYPE_MASK = 0x7;
public static final byte TYPE_VERSION = 0x1;
public static final byte TYPE_MAP_ID_TO_VALUE = 0x2;
public static final byte TYPE_START_NODE = 0x3;
public static final byte TYPE_END_NODE = 0x4;
public static final byte TYPE_ATTRIBUTE = 0x5;
public static final byte TYPE_VALUE = 0x6;
private static final byte ID_MASK = 0x38;
private static final byte ID_ONE_BYTE = 0x08;
private static final byte ID_TWO_BYTES = 0x10;
private static final byte ID_FOUR_BYTES = 0x18;
private static final byte ID_EIGHT_BYTES = 0x20;
private static final String ID_SPLITTED = "\u0000\u2021\u0000";
private static final int MAX_UTF8_LENGTH = 0xffff;
private final byte type;
protected long id = -1;
protected String value;
public Token(byte type) {
this.type = type;
}
public byte getType() {
return type;
}
public long getId() {
return id;
}
public String getValue() {
return value;
}
public String toString() {
return getClass().getName() + " [id=" + id + ", value='" + value + "']";
}
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
final Token token = (Token) o;
if (id != token.id) return false;
if (type != token.type) return false;
return !(value != null ? !value.equals(token.value) : token.value != null);
}
public int hashCode() {
int result;
result = type;
result = 29 * result + (int) (id ^ (id >>> 32));
result = 29 * result + (value != null ? value.hashCode() : 0);
return result;
}
public abstract void writeTo(DataOutput out, byte idType) throws IOException;
public abstract void readFrom(DataInput in, byte idType) throws IOException;
protected void writeId(DataOutput out, long id, byte idType) throws IOException {
if (id < 0) {
throw new IOException("id must not be negative " + id);
}
switch (idType) {
case ID_ONE_BYTE:
out.writeByte((byte) id + Byte.MIN_VALUE);
break;
case ID_TWO_BYTES:
out.writeShort((short) id + Short.MIN_VALUE);
break;
case ID_FOUR_BYTES:
out.writeInt((int) id + Integer.MIN_VALUE);
break;
case ID_EIGHT_BYTES:
out.writeLong(id + Long.MIN_VALUE);
break;
default:
throw new Error("Unknown idType " + idType);
}
}
protected void writeString(DataOutput out, String string) throws IOException {
final byte[] bytes = (string.length() > MAX_UTF8_LENGTH / 4) ? string.getBytes("utf-8") : new byte[0];
int length = bytes.length;
if (length <= MAX_UTF8_LENGTH) {
out.writeUTF(string);
} else {
out.writeUTF(ID_SPLITTED);
out.writeInt(bytes.length);
out.write(bytes);
}
}
protected long readId(DataInput in, byte idType) throws IOException {
switch (idType) {
case ID_ONE_BYTE:
return in.readByte() - Byte.MIN_VALUE;
case ID_TWO_BYTES:
return in.readShort() - Short.MIN_VALUE;
case ID_FOUR_BYTES:
return in.readInt() - Integer.MIN_VALUE;
case ID_EIGHT_BYTES:
return in.readLong() - Long.MIN_VALUE;
default:
throw new Error("Unknown idType " + idType);
}
}
protected String readString(DataInput in) throws IOException {
final String string = in.readUTF();
if (!ID_SPLITTED.equals(string)) {
return string;
}
final int size = in.readInt();
final byte[] bytes = new byte[size];
in.readFully(bytes);
return new String(bytes, "utf-8");
}
public static class Formatter {
public void write(DataOutput out, Token token) throws IOException {
long id = token.getId();
byte idType;
if (id <= Byte.MAX_VALUE - Byte.MIN_VALUE) {
idType = ID_ONE_BYTE;
} else if (id <= Short.MAX_VALUE - Short.MIN_VALUE) {
idType = ID_TWO_BYTES;
} else if (id <= (long) Integer.MAX_VALUE - (long) Integer.MIN_VALUE) { // cast to long to prevent overflow
idType = ID_FOUR_BYTES;
} else {
idType = ID_EIGHT_BYTES;
}
out.write(token.getType() + idType);
token.writeTo(out, idType);
}
public Token read(DataInput in) throws IOException {
byte nextByte = in.readByte();
byte type = (byte) (nextByte & TYPE_MASK);
byte idType = (byte) (nextByte & ID_MASK);
Token token = contructToken(type);
token.readFrom(in, idType);
return token;
}
private Token contructToken(byte type) {
switch (type) {
case Token.TYPE_START_NODE:
return new StartNode();
case Token.TYPE_MAP_ID_TO_VALUE:
return new MapIdToValue();
case Token.TYPE_ATTRIBUTE:
return new Attribute();
case Token.TYPE_END_NODE:
return new EndNode();
case Token.TYPE_VALUE:
return new Value();
default:
throw new StreamException("Unknown token type");
}
}
}
public static class MapIdToValue extends Token {
public MapIdToValue(long id, String value) {
super(TYPE_MAP_ID_TO_VALUE);
this.id = id;
this.value = value;
}
public MapIdToValue() {
super(TYPE_MAP_ID_TO_VALUE);
}
public void writeTo(DataOutput out, byte idType) throws IOException {
writeId(out, id, idType);
writeString(out, value);
}
public void readFrom(DataInput in, byte idType) throws IOException {
id = readId(in, idType);
value = readString(in);
}
}
public static class StartNode extends Token {
public StartNode(long id) {
super(TYPE_START_NODE);
this.id = id;
}
public StartNode() {
super(TYPE_START_NODE);
}
public void writeTo(DataOutput out, byte idType) throws IOException {
writeId(out, id, idType);
}
public void readFrom(DataInput in, byte idType) throws IOException {
id = readId(in, idType);
}
}
public static class EndNode extends Token {
public EndNode() {
super(TYPE_END_NODE);
}
public void writeTo(DataOutput out, byte idType) {
}
public void readFrom(DataInput in, byte idType) {
}
}
public static class Attribute extends Token {
public Attribute(long id, String value) {
super(TYPE_ATTRIBUTE);
this.id = id;
this.value = value;
}
public Attribute() {
super(TYPE_ATTRIBUTE);
}
public void writeTo(DataOutput out, byte idType) throws IOException {
writeId(out, id, idType);
writeString(out, value);
}
public void readFrom(DataInput in, byte idType) throws IOException {
this.id = readId(in, idType);
this.value = readString(in);
}
}
public static class Value extends Token {
public Value(String value) {
super(TYPE_VALUE);
this.value = value;
}
public Value() {
super(TYPE_VALUE);
}
public void writeTo(DataOutput out, byte idType) throws IOException {
writeString(out, value);
}
public void readFrom(DataInput in, byte idType) throws IOException {
value = readString(in);
}
}
}
././@LongLink 0000644 0000000 0000000 00000000154 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/BinaryStreamDriver.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/binary/BinaryStreamDriv0000664 0001750 0001750 00000003504 12206661545 034376 0 ustar jamespage jamespage /*
* Copyright (C) 2011 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 14. October 2011 by Joerg Schaible
*/
package com.thoughtworks.xstream.io.binary;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.Reader;
import java.io.Writer;
import com.thoughtworks.xstream.io.AbstractDriver;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
/**
* HierarchicalStreamDriver for binary input and output. The driver uses an optimized binary
* format to store an object graph. The format is not as compact as Java serialization, but a
* lot more than typical text-based formats like XML. However, due to its nature it cannot use a
* {@link Reader} for input or a {@link Writer} for output.
*
* @author Jörg Schaible
* @since 1.4.2
*/
public class BinaryStreamDriver extends AbstractDriver {
/**
* @throws UnsupportedOperationException if called
*/
public HierarchicalStreamReader createReader(Reader in) {
throw new UnsupportedOperationException(
"The BinaryDriver cannot use character-oriented input streams.");
}
public HierarchicalStreamReader createReader(InputStream in) {
return new BinaryStreamReader(in);
}
/**
* @throws UnsupportedOperationException if called
*/
public HierarchicalStreamWriter createWriter(Writer out) {
throw new UnsupportedOperationException(
"The BinaryDriver cannot use character-oriented output streams.");
}
public HierarchicalStreamWriter createWriter(OutputStream out) {
return new BinaryStreamWriter(out);
}
}
././@LongLink 0000644 0000000 0000000 00000000153 12260544303 011640 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/HierarchicalStreamReader.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/HierarchicalStreamReade0000664 0001750 0001750 00000006574 12206661545 034372 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2011 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 07. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
import com.thoughtworks.xstream.converters.ErrorReporter;
import com.thoughtworks.xstream.converters.ErrorWriter;
import java.util.Iterator;
/**
* @author Joe Walnes
*/
public interface HierarchicalStreamReader extends ErrorReporter {
/**
* Does the node have any more children remaining that have not yet been read?
*/
boolean hasMoreChildren();
/**
* Select the current child as current node.
* A call to this function must be balanced with a call to {@link #moveUp()}.
*/
void moveDown();
/**
* Select the parent node as current node.
*/
void moveUp();
/**
* Get the name of the current node.
*/
String getNodeName();
/**
* Get the value (text content) of the current node.
*/
String getValue();
/**
* Get the value of an attribute of the current node.
*/
String getAttribute(String name);
/**
* Get the value of an attribute of the current node, by index.
*/
String getAttribute(int index);
/**
* Number of attributes in current node.
*/
int getAttributeCount();
/**
* Name of attribute in current node.
*/
String getAttributeName(int index);
/**
* Names of attributes (as Strings).
*/
Iterator getAttributeNames();
/**
* If any errors are detected, allow the reader to add any additional information that can aid debugging
* (such as line numbers, XPath expressions, etc).
*/
void appendErrors(ErrorWriter errorWriter);
/**
* Close the reader, if necessary.
*/
void close();
/**
* Return the underlying HierarchicalStreamReader implementation.
*
*
If a Converter needs to access methods of a specific HierarchicalStreamReader implementation that are not
* defined in the HierarchicalStreamReader interface, it should call this method before casting. This is because
* the reader passed to the Converter is often wrapped/decorated by another implementation to provide additional
* functionality (such as XPath tracking).
Implementations of HierarchicalStreamReader should return 'this', unless they are a decorator, in which case
* they should delegate to whatever they are wrapping.
*/
HierarchicalStreamReader underlyingReader();
/**
* Peek the name of the next child. In situation where {@link #hasMoreChildren()} returns
* true, peek the tag name of the child.
*/
// NOTE: this method was originally defined in our fork at HierarchicalStreamReader,
// but XStream subsequently defined this in ExtendedHierarchicalStreamReader
String peekNextChild();
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/io/WriterWrapper.java 0000664 0001750 0001750 00000002631 12206661545 033422 0 ustar jamespage jamespage /*
* Copyright (C) 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007 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 10. April 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.io;
/**
* Base class to make it easy to create wrappers (decorators) for HierarchicalStreamWriter.
*
* @author Joe Walnes
*/
public abstract class WriterWrapper implements ExtendedHierarchicalStreamWriter {
protected HierarchicalStreamWriter wrapped;
protected WriterWrapper(HierarchicalStreamWriter wrapped) {
this.wrapped = wrapped;
}
public void startNode(String name) {
wrapped.startNode(name);
}
public void startNode(String name, Class clazz) {
((ExtendedHierarchicalStreamWriter) wrapped).startNode(name, clazz);
}
public void endNode() {
wrapped.endNode();
}
public void addAttribute(String key, String value) {
wrapped.addAttribute(key, value);
}
public void setValue(String text) {
wrapped.setValue(text);
}
public void flush() {
wrapped.flush();
}
public void close() {
wrapped.close();
}
public HierarchicalStreamWriter underlyingWriter() {
return wrapped.underlyingWriter();
}
}
././@LongLink 0000644 0000000 0000000 00000000147 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/InitializationException.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/InitializationException.ja0000664 0001750 0001750 00000001353 12206661545 034515 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008 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 22. October 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream;
/**
* Exception thrown configuring an XStream instance.
*
* @author Joe Walnes
* @author Jörg Schaible
* @since 1.3
*/
public class InitializationException extends XStream.InitializationException {
public InitializationException(String message, Throwable cause) {
super(message, cause);
}
public InitializationException(String message) {
super(message);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/XStreamer.java 0000664 0001750 0001750 00000014604 12206661545 032113 0 ustar jamespage jamespage /*
* Copyright (C) 2006, 2007 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 13. April 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.xml.XppDriver;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.ObjectStreamException;
import java.io.Reader;
import java.io.StringReader;
import java.io.StringWriter;
import java.io.Writer;
/**
* Self-contained XStream generator. The class is a utility to write XML streams that contain
* additionally the XStream that was used to serialize the object graph. Such a stream can
* be unmarshalled using this embedded XStream instance, that kept any settings.
*
* @author Jörg Schaible
* @since 1.2
*/
public class XStreamer {
/**
* Serialize an object including the XStream to a pretty-printed XML String.
*
* @throws ObjectStreamException if the XML contains non-serializable elements
* @throws com.thoughtworks.xstream.XStreamException if the object cannot be serialized
* @since 1.2
* @see #toXML(XStream, Object, Writer)
*/
public String toXML(XStream xstream, Object obj) throws ObjectStreamException {
Writer writer = new StringWriter();
try {
toXML(xstream, obj, writer);
} catch (ObjectStreamException e) {
throw e;
} catch (IOException e) {
throw new ConversionException("Unexpeced IO error from a StringWriter", e);
}
return writer.toString();
}
/**
* Serialize an object including the XStream to the given Writer as pretty-printed XML.
*
* Warning: XStream will serialize itself into this XML stream. To read such an XML code, you
* should use {@link XStreamer#fromXML(Reader)} or one of the other overloaded
* methods. Since a lot of internals are written into the stream, you cannot expect to use such
* an XML to work with another XStream version or with XStream running on different JDKs and/or
* versions. We have currently no JDK 1.3 support, nor will the PureReflectionConverter work
* with a JDK less than 1.5.
*
*
* @throws IOException if an error occurs reading from the Writer.
* @throws com.thoughtworks.xstream.XStreamException if the object cannot be serialized
* @since 1.2
*/
public void toXML(XStream xstream, Object obj, Writer out)
throws IOException {
XStream outer = new XStream();
ObjectOutputStream oos = outer.createObjectOutputStream(out);
try {
oos.writeObject(xstream);
oos.flush();
xstream.toXML(obj, out);
} finally {
oos.close();
}
}
/**
* Deserialize a self-contained XStream with object from a String. The method will use
* internally an XppDriver to load the contained XStream instance.
*
* @throws ClassNotFoundException if a class in the XML stream cannot be found
* @throws ObjectStreamException if the XML contains non-deserializable elements
* @throws com.thoughtworks.xstream.XStreamException if the object cannot be deserialized
* @since 1.2
* @see #toXML(XStream, Object, Writer)
*/
public Object fromXML(String xml) throws ClassNotFoundException, ObjectStreamException {
try {
return fromXML(new StringReader(xml));
} catch (ObjectStreamException e) {
throw e;
} catch (IOException e) {
throw new ConversionException("Unexpeced IO error from a StringReader", e);
}
}
/**
* Deserialize a self-contained XStream with object from a String.
*
* @throws ClassNotFoundException if a class in the XML stream cannot be found
* @throws ObjectStreamException if the XML contains non-deserializable elements
* @throws com.thoughtworks.xstream.XStreamException if the object cannot be deserialized
* @since 1.2
* @see #toXML(XStream, Object, Writer)
*/
public Object fromXML(HierarchicalStreamDriver driver, String xml)
throws ClassNotFoundException, ObjectStreamException {
try {
return fromXML(driver, new StringReader(xml));
} catch (ObjectStreamException e) {
throw e;
} catch (IOException e) {
throw new ConversionException("Unexpeced IO error from a StringReader", e);
}
}
/**
* Deserialize a self-contained XStream with object from an XML Reader. The method will use
* internally an XppDriver to load the contained XStream instance.
*
* @throws IOException if an error occurs reading from the Reader.
* @throws ClassNotFoundException if a class in the XML stream cannot be found
* @throws com.thoughtworks.xstream.XStreamException if the object cannot be deserialized
* @since 1.2
* @see #toXML(XStream, Object, Writer)
*/
public Object fromXML(Reader xml)
throws IOException, ClassNotFoundException {
return fromXML(new XppDriver(), xml);
}
/**
* Deserialize a self-contained XStream with object from an XML Reader.
*
* @throws IOException if an error occurs reading from the Reader.
* @throws ClassNotFoundException if a class in the XML stream cannot be found
* @throws com.thoughtworks.xstream.XStreamException if the object cannot be deserialized
* @since 1.2
*/
public Object fromXML(HierarchicalStreamDriver driver, Reader xml)
throws IOException, ClassNotFoundException {
XStream outer = new XStream(driver);
HierarchicalStreamReader reader = driver.createReader(xml);
ObjectInputStream configIn = outer.createObjectInputStream(reader);
try {
XStream configured = (XStream)configIn.readObject();
ObjectInputStream in = configured.createObjectInputStream(reader);
try {
return in.readObject();
} finally {
in.close();
}
} finally {
configIn.close();
}
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/XStream.java 0000664 0001750 0001750 00000226220 12206661545 031563 0 ustar jamespage jamespage /*
* Copyright (C) 2003, 2004, 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 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 26. September 2003 by Joe Walnes
*/
package com.thoughtworks.xstream;
import java.io.EOFException;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.NotActiveException;
import java.io.ObjectInputStream;
import java.io.ObjectInputValidation;
import java.io.ObjectOutputStream;
import java.io.OutputStream;
import java.io.Reader;
import java.io.StringReader;
import java.io.StringWriter;
import java.io.Writer;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.net.URI;
import java.net.URL;
import java.util.ArrayList;
import java.util.BitSet;
import java.util.Calendar;
import java.util.Collections;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Hashtable;
import java.util.LinkedList;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Properties;
import java.util.Set;
import java.util.SortedSet;
import java.util.TreeMap;
import java.util.TreeSet;
import java.util.Vector;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.ConverterRegistry;
import com.thoughtworks.xstream.converters.DataHolder;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.SingleValueConverterWrapper;
import com.thoughtworks.xstream.converters.basic.BigDecimalConverter;
import com.thoughtworks.xstream.converters.basic.BigIntegerConverter;
import com.thoughtworks.xstream.converters.basic.BooleanConverter;
import com.thoughtworks.xstream.converters.basic.ByteConverter;
import com.thoughtworks.xstream.converters.basic.CharConverter;
import com.thoughtworks.xstream.converters.basic.DateConverter;
import com.thoughtworks.xstream.converters.basic.DoubleConverter;
import com.thoughtworks.xstream.converters.basic.FloatConverter;
import com.thoughtworks.xstream.converters.basic.IntConverter;
import com.thoughtworks.xstream.converters.basic.LongConverter;
import com.thoughtworks.xstream.converters.basic.NullConverter;
import com.thoughtworks.xstream.converters.basic.ShortConverter;
import com.thoughtworks.xstream.converters.basic.StringBufferConverter;
import com.thoughtworks.xstream.converters.basic.StringConverter;
import com.thoughtworks.xstream.converters.basic.URIConverter;
import com.thoughtworks.xstream.converters.basic.URLConverter;
import com.thoughtworks.xstream.converters.collections.ArrayConverter;
import com.thoughtworks.xstream.converters.collections.BitSetConverter;
import com.thoughtworks.xstream.converters.collections.CharArrayConverter;
import com.thoughtworks.xstream.converters.collections.CollectionConverter;
import com.thoughtworks.xstream.converters.collections.MapConverter;
import com.thoughtworks.xstream.converters.collections.PropertiesConverter;
import com.thoughtworks.xstream.converters.collections.SingletonCollectionConverter;
import com.thoughtworks.xstream.converters.collections.SingletonMapConverter;
import com.thoughtworks.xstream.converters.collections.TreeMapConverter;
import com.thoughtworks.xstream.converters.collections.TreeSetConverter;
import com.thoughtworks.xstream.converters.extended.ColorConverter;
import com.thoughtworks.xstream.converters.extended.DynamicProxyConverter;
import com.thoughtworks.xstream.converters.extended.EncodedByteArrayConverter;
import com.thoughtworks.xstream.converters.extended.FileConverter;
import com.thoughtworks.xstream.converters.extended.FontConverter;
import com.thoughtworks.xstream.converters.extended.GregorianCalendarConverter;
import com.thoughtworks.xstream.converters.extended.JavaClassConverter;
import com.thoughtworks.xstream.converters.extended.JavaFieldConverter;
import com.thoughtworks.xstream.converters.extended.JavaMethodConverter;
import com.thoughtworks.xstream.converters.extended.LocaleConverter;
import com.thoughtworks.xstream.converters.extended.LookAndFeelConverter;
import com.thoughtworks.xstream.converters.extended.SqlDateConverter;
import com.thoughtworks.xstream.converters.extended.SqlTimeConverter;
import com.thoughtworks.xstream.converters.extended.SqlTimestampConverter;
import com.thoughtworks.xstream.converters.extended.TextAttributeConverter;
import com.thoughtworks.xstream.converters.reflection.ExternalizableConverter;
import com.thoughtworks.xstream.converters.reflection.ReflectionConverter;
import com.thoughtworks.xstream.converters.reflection.ReflectionProvider;
import com.thoughtworks.xstream.converters.reflection.SelfStreamingInstanceChecker;
import com.thoughtworks.xstream.converters.reflection.SerializableConverter;
import com.thoughtworks.xstream.core.DefaultConverterLookup;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.core.MapBackedDataHolder;
import com.thoughtworks.xstream.core.ReferenceByIdMarshallingStrategy;
import com.thoughtworks.xstream.core.ReferenceByXPathMarshallingStrategy;
import com.thoughtworks.xstream.core.TreeMarshallingStrategy;
import com.thoughtworks.xstream.core.util.ClassLoaderReference;
import com.thoughtworks.xstream.core.util.CompositeClassLoader;
import com.thoughtworks.xstream.core.util.CustomObjectInputStream;
import com.thoughtworks.xstream.core.util.CustomObjectOutputStream;
import com.thoughtworks.xstream.io.HierarchicalStreamDriver;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.io.StatefulWriter;
import com.thoughtworks.xstream.io.xml.XppDriver;
import com.thoughtworks.xstream.mapper.AnnotationConfiguration;
import com.thoughtworks.xstream.mapper.ArrayMapper;
import com.thoughtworks.xstream.mapper.AttributeAliasingMapper;
import com.thoughtworks.xstream.mapper.AttributeMapper;
import com.thoughtworks.xstream.mapper.CachingMapper;
import com.thoughtworks.xstream.mapper.ClassAliasingMapper;
import com.thoughtworks.xstream.mapper.DefaultImplementationsMapper;
import com.thoughtworks.xstream.mapper.DefaultMapper;
import com.thoughtworks.xstream.mapper.DynamicProxyMapper;
import com.thoughtworks.xstream.mapper.FieldAliasingMapper;
import com.thoughtworks.xstream.mapper.ImmutableTypesMapper;
import com.thoughtworks.xstream.mapper.ImplicitCollectionMapper;
import com.thoughtworks.xstream.mapper.LocalConversionMapper;
import com.thoughtworks.xstream.mapper.Mapper;
import com.thoughtworks.xstream.mapper.MapperWrapper;
import com.thoughtworks.xstream.mapper.OuterClassMapper;
import com.thoughtworks.xstream.mapper.PackageAliasingMapper;
import com.thoughtworks.xstream.mapper.SystemAttributeAliasingMapper;
import com.thoughtworks.xstream.mapper.XStream11XmlFriendlyMapper;
/**
* Simple facade to XStream library, a Java-XML serialization tool.
*
*
* Example
*
*
* XStream xstream = new XStream();
* String xml = xstream.toXML(myObject); // serialize to XML
* Object myObject2 = xstream.fromXML(xml); // deserialize from XML
*
*
*
*
*
*
Aliasing classes
*
*
* To create shorter XML, you can specify aliases for classes using the alias()
* method. For example, you can shorten all occurrences of element
* <com.blah.MyThing> to <my-thing> by registering an
* alias for the class.
*
*
*
*
*
* xstream.alias("my-thing", MyThing.class);
*
*
*
*
*
*
Converters
*
*
* XStream contains a map of {@link com.thoughtworks.xstream.converters.Converter} instances, each
* of which acts as a strategy for converting a particular type of class to XML and back again. Out
* of the box, XStream contains converters for most basic types (String, Date, int, boolean, etc)
* and collections (Map, List, Set, Properties, etc). For other objects reflection is used to
* serialize each field recursively.
*
*
*
* Extra converters can be registered using the registerConverter() method. Some
* non-standard converters are supplied in the {@link com.thoughtworks.xstream.converters.extended}
* package and you can create your own by implementing the
* {@link com.thoughtworks.xstream.converters.Converter} interface.
*
* The converters can be registered with an explicit priority. By default they are registered with
* XStream.PRIORITY_NORMAL. Converters of same priority will be used in the reverse sequence
* they have been registered. The default converter, i.e. the converter which will be used if
* no other registered converter is suitable, can be registered with priority
* XStream.PRIORITY_VERY_LOW. XStream uses by default the
* {@link com.thoughtworks.xstream.converters.reflection.ReflectionConverter} as the fallback
* converter (override createDefaultConverter() to change this).
*
Uses XPath absolute references to signify duplicate references. The XPath expression ensures that
* a single node only is selected always.
*
*
*
xstream.setMode(XStream.ID_REFERENCES);
*
Uses ID references to signify duplicate references. In some scenarios, such as when using
* hand-written XML, this is easier to work with.
*
*
*
xstream.setMode(XStream.NO_REFERENCES);
*
This disables object graph support and treats the object structure like a tree. Duplicate
* references are treated as two separate objects and circular references cause an exception. This
* is slightly faster and uses less memory than the other two modes.
*
*
*
Thread safety
*
* The XStream instance is thread-safe. That is, once the XStream instance has been created and
* configured, it may be shared across multiple threads allowing objects to be
* serialized/deserialized concurrently. Note, that this only applies if annotations are not
* auto-detected on -the-fly.
*
*
Implicit collections
*
*
* To avoid the need for special tags for collections, you can define implicit collections using one
* of the addImplicitCollection methods.
*
*
* @author Joe Walnes
* @author Jörg Schaible
* @author Mauro Talevi
* @author Guilherme Silveira
*/
public class XStream {
// CAUTION: The sequence of the fields is intentional for an optimal XML output of a
// self-serialization!
private ReflectionProvider reflectionProvider;
private HierarchicalStreamDriver hierarchicalStreamDriver;
private ClassLoaderReference classLoaderReference;
private MarshallingStrategy marshallingStrategy;
private ConverterLookup converterLookup;
private ConverterRegistry converterRegistry;
private Mapper mapper;
private PackageAliasingMapper packageAliasingMapper;
private ClassAliasingMapper classAliasingMapper;
private FieldAliasingMapper fieldAliasingMapper;
private AttributeAliasingMapper attributeAliasingMapper;
private SystemAttributeAliasingMapper systemAttributeAliasingMapper;
private AttributeMapper attributeMapper;
private DefaultImplementationsMapper defaultImplementationsMapper;
private ImmutableTypesMapper immutableTypesMapper;
private ImplicitCollectionMapper implicitCollectionMapper;
private LocalConversionMapper localConversionMapper;
private AnnotationConfiguration annotationConfiguration;
private transient JVM jvm = new JVM();
public static final int NO_REFERENCES = 1001;
public static final int ID_REFERENCES = 1002;
public static final int XPATH_RELATIVE_REFERENCES = 1003;
public static final int XPATH_ABSOLUTE_REFERENCES = 1004;
public static final int SINGLE_NODE_XPATH_RELATIVE_REFERENCES = 1005;
public static final int SINGLE_NODE_XPATH_ABSOLUTE_REFERENCES = 1006;
public static final int PRIORITY_VERY_HIGH = 10000;
public static final int PRIORITY_NORMAL = 0;
public static final int PRIORITY_LOW = -10;
public static final int PRIORITY_VERY_LOW = -20;
private static final String ANNOTATION_MAPPER_TYPE = "com.thoughtworks.xstream.mapper.AnnotationMapper";
/**
* Constructs a default XStream. The instance will use the {@link XppDriver} as default and
* tries to determine the best match for the {@link ReflectionProvider} on its own.
*
* @throws InitializationException in case of an initialization problem
*/
public XStream() {
this(null, (Mapper)null, new XppDriver());
}
/**
* Constructs an XStream with a special {@link ReflectionProvider}. The instance will use
* the {@link XppDriver} as default.
*
* @throws InitializationException in case of an initialization problem
*/
public XStream(ReflectionProvider reflectionProvider) {
this(reflectionProvider, (Mapper)null, new XppDriver());
}
/**
* Constructs an XStream with a special {@link HierarchicalStreamDriver}. The instance will
* tries to determine the best match for the {@link ReflectionProvider} on its own.
*
* @throws InitializationException in case of an initialization problem
*/
public XStream(HierarchicalStreamDriver hierarchicalStreamDriver) {
this(null, (Mapper)null, hierarchicalStreamDriver);
}
/**
* Constructs an XStream with a special {@link HierarchicalStreamDriver} and
* {@link ReflectionProvider}.
*
* @throws InitializationException in case of an initialization problem
*/
public XStream(
ReflectionProvider reflectionProvider, HierarchicalStreamDriver hierarchicalStreamDriver) {
this(reflectionProvider, (Mapper)null, hierarchicalStreamDriver);
}
/**
* Constructs an XStream with a special {@link HierarchicalStreamDriver} and
* {@link ReflectionProvider} and additionally with a prepared {@link Mapper}.
*
* @throws InitializationException in case of an initialization problem
* @deprecated As of 1.3, use
* {@link #XStream(ReflectionProvider, HierarchicalStreamDriver, ClassLoader, Mapper)}
* instead
*/
public XStream(
ReflectionProvider reflectionProvider, Mapper mapper, HierarchicalStreamDriver driver) {
this(
reflectionProvider, driver, new ClassLoaderReference(new CompositeClassLoader()),
mapper, new DefaultConverterLookup(), null);
}
/**
* Constructs an XStream with a special {@link HierarchicalStreamDriver} and
* {@link ReflectionProvider} and additionally with a prepared {@link ClassLoader} to use.
*
* @throws InitializationException in case of an initialization problem
* @since 1.3
*/
public XStream(
ReflectionProvider reflectionProvider, HierarchicalStreamDriver driver,
ClassLoader classLoader) {
this(reflectionProvider, driver, classLoader, null);
}
/**
* Constructs an XStream with a special {@link HierarchicalStreamDriver} and
* {@link ReflectionProvider} and additionally with a prepared {@link Mapper} and the
* {@link ClassLoader} in use.
*
* Note, if the class loader should be changed later again, you should provide a
* {@link ClassLoaderReference} as {@link ClassLoader} that is also use in the
* {@link Mapper} chain.
*
*
* @throws InitializationException in case of an initialization problem
* @since 1.3
*/
public XStream(
ReflectionProvider reflectionProvider, HierarchicalStreamDriver driver,
ClassLoader classLoader, Mapper mapper) {
this(
reflectionProvider, driver, classLoader, mapper, new DefaultConverterLookup(), null);
}
/**
* Constructs an XStream with a special {@link HierarchicalStreamDriver},
* {@link ReflectionProvider}, a prepared {@link Mapper} and the {@link ClassLoader} in use
* and an own {@link ConverterRegistry}.
*
* Note, if the class loader should be changed later again, you should provide a
* {@link ClassLoaderReference} as {@link ClassLoader} that is also use in the
* {@link Mapper} chain.
*
*
* @throws InitializationException in case of an initialization problem
* @since 1.3
*/
public XStream(
ReflectionProvider reflectionProvider, HierarchicalStreamDriver driver,
ClassLoader classLoader, Mapper mapper, ConverterLookup converterLookup,
ConverterRegistry converterRegistry) {
jvm = new JVM();
if (reflectionProvider == null) {
reflectionProvider = jvm.bestReflectionProvider();
}
this.reflectionProvider = reflectionProvider;
this.hierarchicalStreamDriver = driver;
this.classLoaderReference = classLoader instanceof ClassLoaderReference
? (ClassLoaderReference)classLoader
: new ClassLoaderReference(classLoader);
this.converterLookup = converterLookup;
this.converterRegistry = converterRegistry != null
? converterRegistry
: (converterLookup instanceof ConverterRegistry
? (ConverterRegistry)converterLookup
: null);
this.mapper = mapper == null ? buildMapper() : mapper;
setupMappers();
setupAliases();
setupDefaultImplementations();
setupConverters();
setupImmutableTypes();
setMode(XPATH_RELATIVE_REFERENCES);
}
private Mapper buildMapper() {
Mapper mapper = new DefaultMapper(classLoaderReference);
if (useXStream11XmlFriendlyMapper()) {
mapper = new XStream11XmlFriendlyMapper(mapper);
}
mapper = new DynamicProxyMapper(mapper);
mapper = new PackageAliasingMapper(mapper);
mapper = new ClassAliasingMapper(mapper);
mapper = new FieldAliasingMapper(mapper);
mapper = new AttributeAliasingMapper(mapper);
mapper = new SystemAttributeAliasingMapper(mapper);
mapper = new ImplicitCollectionMapper(mapper);
mapper = new OuterClassMapper(mapper);
mapper = new ArrayMapper(mapper);
mapper = new DefaultImplementationsMapper(mapper);
mapper = new AttributeMapper(mapper, converterLookup, reflectionProvider);
if (JVM.is15()) {
mapper = buildMapperDynamically(
"com.thoughtworks.xstream.mapper.EnumMapper", new Class[]{Mapper.class},
new Object[]{mapper});
}
mapper = new LocalConversionMapper(mapper);
mapper = new ImmutableTypesMapper(mapper);
if (JVM.is15()) {
mapper = buildMapperDynamically(ANNOTATION_MAPPER_TYPE, new Class[]{
Mapper.class, ConverterRegistry.class, ConverterLookup.class,
ClassLoader.class, ReflectionProvider.class, JVM.class}, new Object[]{
mapper, converterLookup, converterLookup, classLoaderReference,
reflectionProvider, jvm});
}
mapper = wrapMapper((MapperWrapper)mapper);
mapper = new CachingMapper(mapper);
return mapper;
}
private Mapper buildMapperDynamically(String className, Class[] constructorParamTypes,
Object[] constructorParamValues) {
try {
Class type = Class.forName(className, false, classLoaderReference.getReference());
Constructor constructor = type.getConstructor(constructorParamTypes);
return (Mapper)constructor.newInstance(constructorParamValues);
} catch (Exception e) {
throw new com.thoughtworks.xstream.InitializationException(
"Could not instantiate mapper : " + className, e);
}
}
protected MapperWrapper wrapMapper(MapperWrapper next) {
return next;
}
protected boolean useXStream11XmlFriendlyMapper() {
return false;
}
private void setupMappers() {
packageAliasingMapper = (PackageAliasingMapper)this.mapper
.lookupMapperOfType(PackageAliasingMapper.class);
classAliasingMapper = (ClassAliasingMapper)this.mapper
.lookupMapperOfType(ClassAliasingMapper.class);
fieldAliasingMapper = (FieldAliasingMapper)this.mapper
.lookupMapperOfType(FieldAliasingMapper.class);
attributeMapper = (AttributeMapper)this.mapper
.lookupMapperOfType(AttributeMapper.class);
attributeAliasingMapper = (AttributeAliasingMapper)this.mapper
.lookupMapperOfType(AttributeAliasingMapper.class);
systemAttributeAliasingMapper = (SystemAttributeAliasingMapper)this.mapper
.lookupMapperOfType(SystemAttributeAliasingMapper.class);
implicitCollectionMapper = (ImplicitCollectionMapper)this.mapper
.lookupMapperOfType(ImplicitCollectionMapper.class);
defaultImplementationsMapper = (DefaultImplementationsMapper)this.mapper
.lookupMapperOfType(DefaultImplementationsMapper.class);
immutableTypesMapper = (ImmutableTypesMapper)this.mapper
.lookupMapperOfType(ImmutableTypesMapper.class);
localConversionMapper = (LocalConversionMapper)this.mapper
.lookupMapperOfType(LocalConversionMapper.class);
annotationConfiguration = (AnnotationConfiguration)this.mapper
.lookupMapperOfType(AnnotationConfiguration.class);
}
protected void setupAliases() {
if (classAliasingMapper == null) {
return;
}
alias("null", Mapper.Null.class);
alias("int", Integer.class);
alias("float", Float.class);
alias("double", Double.class);
alias("long", Long.class);
alias("short", Short.class);
alias("char", Character.class);
alias("byte", Byte.class);
alias("boolean", Boolean.class);
alias("number", Number.class);
alias("object", Object.class);
alias("big-int", BigInteger.class);
alias("big-decimal", BigDecimal.class);
alias("string-buffer", StringBuffer.class);
alias("string", String.class);
alias("java-class", Class.class);
alias("method", Method.class);
alias("constructor", Constructor.class);
alias("field", Field.class);
alias("date", Date.class);
alias("uri", URI.class);
alias("url", URL.class);
alias("bit-set", BitSet.class);
alias("map", Map.class);
alias("entry", Map.Entry.class);
alias("properties", Properties.class);
alias("list", List.class);
alias("set", Set.class);
alias("sorted-set", SortedSet.class);
alias("linked-list", LinkedList.class);
alias("vector", Vector.class);
alias("tree-map", TreeMap.class);
alias("tree-set", TreeSet.class);
alias("hashtable", Hashtable.class);
alias("empty-list", Collections.EMPTY_LIST.getClass());
alias("empty-map", Collections.EMPTY_MAP.getClass());
alias("empty-set", Collections.EMPTY_SET.getClass());
alias("singleton-list", Collections.singletonList(this).getClass());
alias("singleton-map", Collections.singletonMap(this, null).getClass());
alias("singleton-set", Collections.singleton(this).getClass());
if (jvm.supportsAWT()) {
// Instantiating these two classes starts the AWT system, which is undesirable.
// Calling loadClass ensures a reference to the class is found but they are not
// instantiated.
alias("awt-color", jvm.loadClass("java.awt.Color", false));
alias("awt-font", jvm.loadClass("java.awt.Font", false));
alias("awt-text-attribute", jvm.loadClass("java.awt.font.TextAttribute"));
}
if (jvm.supportsSQL()) {
alias("sql-timestamp", jvm.loadClass("java.sql.Timestamp"));
alias("sql-time", jvm.loadClass("java.sql.Time"));
alias("sql-date", jvm.loadClass("java.sql.Date"));
}
alias("file", File.class);
alias("locale", Locale.class);
alias("gregorian-calendar", Calendar.class);
if (JVM.is14()) {
aliasDynamically("auth-subject", "javax.security.auth.Subject");
alias("linked-hash-map", jvm.loadClass("java.util.LinkedHashMap"));
alias("linked-hash-set", jvm.loadClass("java.util.LinkedHashSet"));
alias("trace", jvm.loadClass("java.lang.StackTraceElement"));
alias("currency", jvm.loadClass("java.util.Currency"));
aliasType("charset", jvm.loadClass("java.nio.charset.Charset"));
}
if (JVM.is15()) {
aliasDynamically("duration", "javax.xml.datatype.Duration");
alias("concurrent-hash-map", jvm.loadClass("java.util.concurrent.ConcurrentHashMap"));
alias("enum-set", jvm.loadClass("java.util.EnumSet"));
alias("enum-map", jvm.loadClass("java.util.EnumMap"));
alias("string-builder", jvm.loadClass("java.lang.StringBuilder"));
alias("uuid", jvm.loadClass("java.util.UUID"));
}
}
private void aliasDynamically(String alias, String className) {
Class type = jvm.loadClass(className);
if (type != null) {
alias(alias, type);
}
}
protected void setupDefaultImplementations() {
if (defaultImplementationsMapper == null) {
return;
}
addDefaultImplementation(HashMap.class, Map.class);
addDefaultImplementation(ArrayList.class, List.class);
addDefaultImplementation(HashSet.class, Set.class);
addDefaultImplementation(TreeSet.class, SortedSet.class);
addDefaultImplementation(GregorianCalendar.class, Calendar.class);
}
protected Converter createDefaultConverter() {
return new ReflectionConverter(mapper, reflectionProvider);
}
protected void setupConverters() {
final Converter defaultConverter = createDefaultConverter();
registerConverter(defaultConverter, PRIORITY_VERY_LOW);
registerConverter(
new SerializableConverter(mapper, reflectionProvider, classLoaderReference), PRIORITY_LOW);
registerConverter(new ExternalizableConverter(mapper, classLoaderReference), PRIORITY_LOW);
registerConverter(new NullConverter(), PRIORITY_VERY_HIGH);
registerConverter(new IntConverter(), PRIORITY_NORMAL);
registerConverter(new FloatConverter(), PRIORITY_NORMAL);
registerConverter(new DoubleConverter(), PRIORITY_NORMAL);
registerConverter(new LongConverter(), PRIORITY_NORMAL);
registerConverter(new ShortConverter(), PRIORITY_NORMAL);
registerConverter((Converter)new CharConverter(), PRIORITY_NORMAL);
registerConverter(new BooleanConverter(), PRIORITY_NORMAL);
registerConverter(new ByteConverter(), PRIORITY_NORMAL);
registerConverter(new StringConverter(), PRIORITY_NORMAL);
registerConverter(new StringBufferConverter(), PRIORITY_NORMAL);
registerConverter(new DateConverter(), PRIORITY_NORMAL);
registerConverter(new BitSetConverter(), PRIORITY_NORMAL);
registerConverter(new URIConverter(), PRIORITY_NORMAL);
registerConverter(new URLConverter(), PRIORITY_NORMAL);
registerConverter(new BigIntegerConverter(), PRIORITY_NORMAL);
registerConverter(new BigDecimalConverter(), PRIORITY_NORMAL);
registerConverter(new ArrayConverter(mapper), PRIORITY_NORMAL);
registerConverter(new CharArrayConverter(), PRIORITY_NORMAL);
registerConverter(new CollectionConverter(mapper), PRIORITY_NORMAL);
registerConverter(new MapConverter(mapper), PRIORITY_NORMAL);
registerConverter(new TreeMapConverter(mapper), PRIORITY_NORMAL);
registerConverter(new TreeSetConverter(mapper), PRIORITY_NORMAL);
registerConverter(new SingletonCollectionConverter(mapper), PRIORITY_NORMAL);
registerConverter(new SingletonMapConverter(mapper), PRIORITY_NORMAL);
registerConverter(new PropertiesConverter(), PRIORITY_NORMAL);
registerConverter((Converter)new EncodedByteArrayConverter(), PRIORITY_NORMAL);
registerConverter(new FileConverter(), PRIORITY_NORMAL);
if (jvm.supportsSQL()) {
registerConverter(new SqlTimestampConverter(), PRIORITY_NORMAL);
registerConverter(new SqlTimeConverter(), PRIORITY_NORMAL);
registerConverter(new SqlDateConverter(), PRIORITY_NORMAL);
}
registerConverter(
new DynamicProxyConverter(mapper, classLoaderReference), PRIORITY_NORMAL);
registerConverter(new JavaClassConverter(classLoaderReference), PRIORITY_NORMAL);
registerConverter(new JavaMethodConverter(classLoaderReference), PRIORITY_NORMAL);
registerConverter(new JavaFieldConverter(classLoaderReference), PRIORITY_NORMAL);
if (jvm.supportsAWT()) {
registerConverter(new FontConverter(), PRIORITY_NORMAL);
registerConverter(new ColorConverter(), PRIORITY_NORMAL);
registerConverter(new TextAttributeConverter(), PRIORITY_NORMAL);
}
if (jvm.supportsSwing()) {
registerConverter(
new LookAndFeelConverter(mapper, reflectionProvider), PRIORITY_NORMAL);
}
registerConverter(new LocaleConverter(), PRIORITY_NORMAL);
registerConverter(new GregorianCalendarConverter(), PRIORITY_NORMAL);
if (JVM.is14()) {
// late bound converters - allows XStream to be compiled on earlier JDKs
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.SubjectConverter",
PRIORITY_NORMAL, new Class[]{Mapper.class}, new Object[]{mapper});
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.ThrowableConverter",
PRIORITY_NORMAL, new Class[]{Converter.class},
new Object[]{defaultConverter});
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.StackTraceElementConverter",
PRIORITY_NORMAL, null, null);
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.CurrencyConverter",
PRIORITY_NORMAL, null, null);
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.RegexPatternConverter",
PRIORITY_NORMAL, new Class[]{Converter.class},
new Object[]{defaultConverter});
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.CharsetConverter",
PRIORITY_NORMAL, null, null);
}
if (JVM.is15()) {
// late bound converters - allows XStream to be compiled on earlier JDKs
if (jvm.loadClass("javax.xml.datatype.Duration") != null) {
registerConverterDynamically(
"com.thoughtworks.xstream.converters.extended.DurationConverter",
PRIORITY_NORMAL, null, null);
}
registerConverterDynamically(
"com.thoughtworks.xstream.converters.enums.EnumConverter", PRIORITY_NORMAL,
null, null);
registerConverterDynamically(
"com.thoughtworks.xstream.converters.enums.EnumSetConverter", PRIORITY_NORMAL,
new Class[]{Mapper.class}, new Object[]{mapper});
registerConverterDynamically(
"com.thoughtworks.xstream.converters.enums.EnumMapConverter", PRIORITY_NORMAL,
new Class[]{Mapper.class}, new Object[]{mapper});
registerConverterDynamically(
"com.thoughtworks.xstream.converters.basic.StringBuilderConverter",
PRIORITY_NORMAL, null, null);
registerConverterDynamically(
"com.thoughtworks.xstream.converters.basic.UUIDConverter", PRIORITY_NORMAL,
null, null);
}
registerConverter(
new SelfStreamingInstanceChecker(defaultConverter, this), PRIORITY_NORMAL);
}
private void registerConverterDynamically(String className, int priority,
Class[] constructorParamTypes, Object[] constructorParamValues) {
try {
Class type = Class.forName(className, false, classLoaderReference.getReference());
Constructor constructor = type.getConstructor(constructorParamTypes);
Object instance = constructor.newInstance(constructorParamValues);
if (instance instanceof Converter) {
registerConverter((Converter)instance, priority);
} else if (instance instanceof SingleValueConverter) {
registerConverter((SingleValueConverter)instance, priority);
}
} catch (Exception e) {
throw new com.thoughtworks.xstream.InitializationException(
"Could not instantiate converter : " + className, e);
}
}
protected void setupImmutableTypes() {
if (immutableTypesMapper == null) {
return;
}
// primitives are always immutable
addImmutableType(boolean.class);
addImmutableType(Boolean.class);
addImmutableType(byte.class);
addImmutableType(Byte.class);
addImmutableType(char.class);
addImmutableType(Character.class);
addImmutableType(double.class);
addImmutableType(Double.class);
addImmutableType(float.class);
addImmutableType(Float.class);
addImmutableType(int.class);
addImmutableType(Integer.class);
addImmutableType(long.class);
addImmutableType(Long.class);
addImmutableType(short.class);
addImmutableType(Short.class);
// additional types
addImmutableType(Mapper.Null.class);
addImmutableType(BigDecimal.class);
addImmutableType(BigInteger.class);
addImmutableType(String.class);
addImmutableType(URI.class);
addImmutableType(URL.class);
addImmutableType(File.class);
addImmutableType(Class.class);
addImmutableType(Collections.EMPTY_LIST.getClass());
addImmutableType(Collections.EMPTY_SET.getClass());
addImmutableType(Collections.EMPTY_MAP.getClass());
if (jvm.supportsAWT()) {
addImmutableTypeDynamically("java.awt.font.TextAttribute");
}
if (JVM.is14()) {
// late bound types - allows XStream to be compiled on earlier JDKs
addImmutableTypeDynamically("java.nio.charset.Charset");
addImmutableTypeDynamically("java.util.Currency");
}
}
private void addImmutableTypeDynamically(String className) {
Class type = jvm.loadClass(className);
if (type != null) {
addImmutableType(type);
}
}
public void setMarshallingStrategy(MarshallingStrategy marshallingStrategy) {
this.marshallingStrategy = marshallingStrategy;
}
/**
* Serialize an object to a pretty-printed XML String.
*
* @throws XStreamException if the object cannot be serialized
*/
public String toXML(Object obj) {
Writer writer = new StringWriter();
toXML(obj, writer);
return writer.toString();
}
/**
* Serialize an object to the given Writer as pretty-printed XML. The Writer will be flushed
* afterwards and in case of an exception.
*
* @throws XStreamException if the object cannot be serialized
*/
public void toXML(Object obj, Writer out) {
HierarchicalStreamWriter writer = hierarchicalStreamDriver.createWriter(out);
try {
marshal(obj, writer);
} finally {
writer.flush();
}
}
/**
* Serialize an object to the given OutputStream as pretty-printed XML. The OutputStream
* will be flushed afterwards and in case of an exception.
*
* @throws XStreamException if the object cannot be serialized
*/
public void toXML(Object obj, OutputStream out) {
HierarchicalStreamWriter writer = hierarchicalStreamDriver.createWriter(out);
try {
marshal(obj, writer);
} finally {
writer.flush();
}
}
/**
* Serialize and object to a hierarchical data structure (such as XML).
*
* @throws XStreamException if the object cannot be serialized
*/
public void marshal(Object obj, HierarchicalStreamWriter writer) {
marshal(obj, writer, null);
}
/**
* Serialize and object to a hierarchical data structure (such as XML).
*
* @param dataHolder Extra data you can use to pass to your converters. Use this as you
* want. If not present, XStream shall create one lazily as needed.
* @throws XStreamException if the object cannot be serialized
*/
public void marshal(Object obj, HierarchicalStreamWriter writer, DataHolder dataHolder) {
marshallingStrategy.marshal(writer, obj, converterLookup, mapper, dataHolder);
}
/**
* Deserialize an object from an XML String.
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object fromXML(String xml) {
return fromXML(new StringReader(xml));
}
/**
* Deserialize an object from an XML Reader.
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object fromXML(Reader reader) {
return unmarshal(hierarchicalStreamDriver.createReader(reader), null);
}
/**
* Deserialize an object from an XML InputStream.
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object fromXML(InputStream input) {
return unmarshal(hierarchicalStreamDriver.createReader(input), null);
}
/**
* Deserialize an object from a URL.
*
* Depending on the parser implementation, some might take the file path as SystemId to
* resolve additional references.
*
* @throws XStreamException if the object cannot be deserialized
* @since 1.4
*/
public Object fromXML(URL url) {
return fromXML(url, null);
}
/**
* Deserialize an object from a file.
*
* Depending on the parser implementation, some might take the file path as SystemId to
* resolve additional references.
*
* @throws XStreamException if the object cannot be deserialized
* @since 1.4
*/
public Object fromXML(File file) {
return fromXML(file, null);
}
/**
* Deserialize an object from an XML String, populating the fields of the given root object
* instead of instantiating a new one. Note, that this is a special use case! With the
* ReflectionConverter XStream will write directly into the raw memory area of the existing
* object. Use with care!
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object fromXML(String xml, Object root) {
return fromXML(new StringReader(xml), root);
}
/**
* Deserialize an object from an XML Reader, populating the fields of the given root object
* instead of instantiating a new one. Note, that this is a special use case! With the
* ReflectionConverter XStream will write directly into the raw memory area of the existing
* object. Use with care!
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object fromXML(Reader xml, Object root) {
return unmarshal(hierarchicalStreamDriver.createReader(xml), root);
}
/**
* Deserialize an object from a URL, populating the fields of the given root
* object instead of instantiating a new one. Note, that this is a special use case! With
* the ReflectionConverter XStream will write directly into the raw memory area of the
* existing object. Use with care!
*
* Depending on the parser implementation, some might take the file path as SystemId to
* resolve additional references.
*
* @throws XStreamException if the object cannot be deserialized
* @since 1.4
*/
public Object fromXML(URL url, Object root) {
return unmarshal(hierarchicalStreamDriver.createReader(url), root);
}
/**
* Deserialize an object from a file, populating the fields of the given root
* object instead of instantiating a new one. Note, that this is a special use case! With
* the ReflectionConverter XStream will write directly into the raw memory area of the
* existing object. Use with care!
*
* Depending on the parser implementation, some might take the file path as SystemId to
* resolve additional references.
*
* @throws XStreamException if the object cannot be deserialized
* @since 1.4
*/
public Object fromXML(File file, Object root) {
HierarchicalStreamReader reader = hierarchicalStreamDriver.createReader(file);
try {
return unmarshal(reader, root);
} finally {
reader.close();
}
}
/**
* Deserialize an object from an XML InputStream, populating the fields of the given root
* object instead of instantiating a new one. Note, that this is a special use case! With
* the ReflectionConverter XStream will write directly into the raw memory area of the
* existing object. Use with care!
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object fromXML(InputStream input, Object root) {
return unmarshal(hierarchicalStreamDriver.createReader(input), root);
}
/**
* Deserialize an object from a hierarchical data structure (such as XML).
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object unmarshal(HierarchicalStreamReader reader) {
return unmarshal(reader, null, null);
}
/**
* Deserialize an object from a hierarchical data structure (such as XML), populating the
* fields of the given root object instead of instantiating a new one. Note, that this is a
* special use case! With the ReflectionConverter XStream will write directly into the raw
* memory area of the existing object. Use with care!
*
* @throws XStreamException if the object cannot be deserialized
*/
public Object unmarshal(HierarchicalStreamReader reader, Object root) {
return unmarshal(reader, root, null);
}
/**
* Deserialize an object from a hierarchical data structure (such as XML).
*
* @param root If present, the passed in object will have its fields populated, as opposed
* to XStream creating a new instance. Note, that this is a special use case!
* With the ReflectionConverter XStream will write directly into the raw memory
* area of the existing object. Use with care!
* @param dataHolder Extra data you can use to pass to your converters. Use this as you
* want. If not present, XStream shall create one lazily as needed.
* @throws XStreamException if the object cannot be deserialized
*/
public Object unmarshal(HierarchicalStreamReader reader, Object root, DataHolder dataHolder) {
try {
return marshallingStrategy.unmarshal(
root, reader, dataHolder, converterLookup, mapper);
} catch (ConversionException e) {
Package pkg = getClass().getPackage();
String version = pkg != null ? pkg.getImplementationVersion() : null;
e.add("version", version != null ? version : "not available");
throw e;
}
}
/**
* Alias a Class to a shorter name to be used in XML elements.
*
* @param name Short name
* @param type Type to be aliased
* @throws InitializationException if no {@link ClassAliasingMapper} is available
*/
public void alias(String name, Class type) {
if (classAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ ClassAliasingMapper.class.getName()
+ " available");
}
classAliasingMapper.addClassAlias(name, type);
}
/**
* Alias a type to a shorter name to be used in XML elements. Any class that is assignable
* to this type will be aliased to the same name.
*
* @param name Short name
* @param type Type to be aliased
* @since 1.2
* @throws InitializationException if no {@link ClassAliasingMapper} is available
*/
public void aliasType(String name, Class type) {
if (classAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ ClassAliasingMapper.class.getName()
+ " available");
}
classAliasingMapper.addTypeAlias(name, type);
}
/**
* Alias a Class to a shorter name to be used in XML elements.
*
* @param name Short name
* @param type Type to be aliased
* @param defaultImplementation Default implementation of type to use if no other specified.
* @throws InitializationException if no {@link DefaultImplementationsMapper} or no
* {@link ClassAliasingMapper} is available
*/
public void alias(String name, Class type, Class defaultImplementation) {
alias(name, type);
addDefaultImplementation(defaultImplementation, type);
}
/**
* Alias a package to a shorter name to be used in XML elements.
*
* @param name Short name
* @param pkgName package to be aliased
* @throws InitializationException if no {@link DefaultImplementationsMapper} or no
* {@link PackageAliasingMapper} is available
* @since 1.3.1
*/
public void aliasPackage(String name, String pkgName) {
if (packageAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ PackageAliasingMapper.class.getName()
+ " available");
}
packageAliasingMapper.addPackageAlias(name, pkgName);
}
/**
* Create an alias for a field name.
*
* @param alias the alias itself
* @param definedIn the type that declares the field
* @param fieldName the name of the field
* @throws InitializationException if no {@link FieldAliasingMapper} is available
*/
public void aliasField(String alias, Class definedIn, String fieldName) {
if (fieldAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ FieldAliasingMapper.class.getName()
+ " available");
}
fieldAliasingMapper.addFieldAlias(alias, definedIn, fieldName);
}
/**
* Create an alias for an attribute
*
* @param alias the alias itself
* @param attributeName the name of the attribute
* @throws InitializationException if no {@link AttributeAliasingMapper} is available
*/
public void aliasAttribute(String alias, String attributeName) {
if (attributeAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ AttributeAliasingMapper.class.getName()
+ " available");
}
attributeAliasingMapper.addAliasFor(attributeName, alias);
}
/**
* Create an alias for a system attribute. XStream will not write a system attribute if its
* alias is set to null. However, this is not reversible, i.e. deserialization
* of the result is likely to fail afterwards and will not produce an object equal to the
* originally written one.
*
* @param alias the alias itself (may be null)
* @param systemAttributeName the name of the system attribute
* @throws InitializationException if no {@link SystemAttributeAliasingMapper} is available
* @since 1.3.1
*/
public void aliasSystemAttribute(String alias, String systemAttributeName) {
if (systemAttributeAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ SystemAttributeAliasingMapper.class.getName()
+ " available");
}
systemAttributeAliasingMapper.addAliasFor(systemAttributeName, alias);
}
/**
* Create an alias for an attribute.
*
* @param definedIn the type where the attribute is defined
* @param attributeName the name of the attribute
* @param alias the alias itself
* @throws InitializationException if no {@link AttributeAliasingMapper} is available
* @since 1.2.2
*/
public void aliasAttribute(Class definedIn, String attributeName, String alias) {
aliasField(alias, definedIn, attributeName);
useAttributeFor(definedIn, attributeName);
}
/**
* Use an attribute for a field or a specific type.
*
* @param fieldName the name of the field
* @param type the Class of the type to be rendered as XML attribute
* @throws InitializationException if no {@link AttributeMapper} is available
* @since 1.2
*/
public void useAttributeFor(String fieldName, Class type) {
if (attributeMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ AttributeMapper.class.getName()
+ " available");
}
attributeMapper.addAttributeFor(fieldName, type);
}
/**
* Use an attribute for a field declared in a specific type.
*
* @param fieldName the name of the field
* @param definedIn the Class containing such field
* @throws InitializationException if no {@link AttributeMapper} is available
* @since 1.2.2
*/
public void useAttributeFor(Class definedIn, String fieldName) {
if (attributeMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ AttributeMapper.class.getName()
+ " available");
}
attributeMapper.addAttributeFor(definedIn, fieldName);
}
/**
* Use an attribute for an arbitrary type.
*
* @param type the Class of the type to be rendered as XML attribute
* @throws InitializationException if no {@link AttributeMapper} is available
* @since 1.2
*/
public void useAttributeFor(Class type) {
if (attributeMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ AttributeMapper.class.getName()
+ " available");
}
attributeMapper.addAttributeFor(type);
}
/**
* Associate a default implementation of a class with an object. Whenever XStream encounters
* an instance of this type, it will use the default implementation instead. For example,
* java.util.ArrayList is the default implementation of java.util.List.
*
* @param defaultImplementation
* @param ofType
* @throws InitializationException if no {@link DefaultImplementationsMapper} is available
*/
public void addDefaultImplementation(Class defaultImplementation, Class ofType) {
if (defaultImplementationsMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ DefaultImplementationsMapper.class.getName()
+ " available");
}
defaultImplementationsMapper.addDefaultImplementation(defaultImplementation, ofType);
}
/**
* Add immutable types. The value of the instances of these types will always be written
* into the stream even if they appear multiple times.
*
* @throws InitializationException if no {@link ImmutableTypesMapper} is available
*/
public void addImmutableType(Class type) {
if (immutableTypesMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ ImmutableTypesMapper.class.getName()
+ " available");
}
immutableTypesMapper.addImmutableType(type);
}
public void registerConverter(Converter converter) {
registerConverter(converter, PRIORITY_NORMAL);
}
public void registerConverter(Converter converter, int priority) {
if (converterRegistry != null) {
converterRegistry.registerConverter(converter, priority);
}
}
public void registerConverter(SingleValueConverter converter) {
registerConverter(converter, PRIORITY_NORMAL);
}
public void registerConverter(SingleValueConverter converter, int priority) {
if (converterRegistry != null) {
converterRegistry.registerConverter(
new SingleValueConverterWrapper(converter), priority);
}
}
/**
* Register a local {@link Converter} for a field.
*
* @param definedIn the class type the field is defined in
* @param fieldName the field name
* @param converter the converter to use
* @since 1.3
*/
public void registerLocalConverter(Class definedIn, String fieldName, Converter converter) {
if (localConversionMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ LocalConversionMapper.class.getName()
+ " available");
}
localConversionMapper.registerLocalConverter(definedIn, fieldName, converter);
}
/**
* Register a local {@link SingleValueConverter} for a field.
*
* @param definedIn the class type the field is defined in
* @param fieldName the field name
* @param converter the converter to use
* @since 1.3
*/
public void registerLocalConverter(Class definedIn, String fieldName,
SingleValueConverter converter) {
registerLocalConverter(
definedIn, fieldName, (Converter)new SingleValueConverterWrapper(converter));
}
/**
* Retrieve the {@link Mapper}. This is by default a chain of {@link MapperWrapper
* MapperWrappers}.
*
* @return the mapper
* @since 1.2
*/
public Mapper getMapper() {
return mapper;
}
/**
* Retrieve the {@link ReflectionProvider} in use.
*
* @return the mapper
* @since 1.2.1
*/
public ReflectionProvider getReflectionProvider() {
return reflectionProvider;
}
public ConverterLookup getConverterLookup() {
return converterLookup;
}
public ConverterRegistry getConverterRegistry() {
return converterRegistry;
}
public JVM getJvm() {
return jvm;
}
/**
* Change mode for dealing with duplicate references. Valid values are
* XPATH_ABSOLUTE_REFERENCES, XPATH_RELATIVE_REFERENCES,
* XStream.ID_REFERENCES and XStream.NO_REFERENCES.
*
* @throws IllegalArgumentException if the mode is not one of the declared types
* @see #XPATH_ABSOLUTE_REFERENCES
* @see #XPATH_RELATIVE_REFERENCES
* @see #ID_REFERENCES
* @see #NO_REFERENCES
*/
public void setMode(int mode) {
switch (mode) {
case NO_REFERENCES:
setMarshallingStrategy(new TreeMarshallingStrategy());
break;
case ID_REFERENCES:
setMarshallingStrategy(new ReferenceByIdMarshallingStrategy());
break;
case XPATH_RELATIVE_REFERENCES:
setMarshallingStrategy(new ReferenceByXPathMarshallingStrategy(
ReferenceByXPathMarshallingStrategy.RELATIVE));
break;
case XPATH_ABSOLUTE_REFERENCES:
setMarshallingStrategy(new ReferenceByXPathMarshallingStrategy(
ReferenceByXPathMarshallingStrategy.ABSOLUTE));
break;
case SINGLE_NODE_XPATH_RELATIVE_REFERENCES:
setMarshallingStrategy(new ReferenceByXPathMarshallingStrategy(
ReferenceByXPathMarshallingStrategy.RELATIVE
| ReferenceByXPathMarshallingStrategy.SINGLE_NODE));
break;
case SINGLE_NODE_XPATH_ABSOLUTE_REFERENCES:
setMarshallingStrategy(new ReferenceByXPathMarshallingStrategy(
ReferenceByXPathMarshallingStrategy.ABSOLUTE
| ReferenceByXPathMarshallingStrategy.SINGLE_NODE));
break;
default:
throw new IllegalArgumentException("Unknown mode : " + mode);
}
}
/**
* Adds a default implicit collection which is used for any unmapped XML tag.
*
* @param ownerType class owning the implicit collection
* @param fieldName name of the field in the ownerType. This field must be a concrete
* collection type or matching the default implementation type of the collection
* type.
*/
public void addImplicitCollection(Class ownerType, String fieldName) {
addImplicitCollection(ownerType, fieldName, null, null);
}
/**
* Adds implicit collection which is used for all items of the given itemType.
*
* @param ownerType class owning the implicit collection
* @param fieldName name of the field in the ownerType. This field must be a concrete
* collection type or matching the default implementation type of the collection
* type.
* @param itemType type of the items to be part of this collection
* @throws InitializationException if no {@link ImplicitCollectionMapper} is available
*/
public void addImplicitCollection(Class ownerType, String fieldName, Class itemType) {
addImplicitCollection(ownerType, fieldName, null, itemType);
}
/**
* Adds implicit collection which is used for all items of the given element name defined by
* itemFieldName.
*
* @param ownerType class owning the implicit collection
* @param fieldName name of the field in the ownerType. This field must be a concrete
* collection type or matching the default implementation type of the collection
* type.
* @param itemFieldName element name of the implicit collection
* @param itemType item type to be aliases be the itemFieldName
* @throws InitializationException if no {@link ImplicitCollectionMapper} is available
*/
public void addImplicitCollection(Class ownerType, String fieldName, String itemFieldName,
Class itemType) {
addImplicitMap(ownerType, fieldName, itemFieldName, itemType, null);
}
/**
* Adds an implicit array.
*
* @param ownerType class owning the implicit array
* @param fieldName name of the array field
* @since 1.4
*/
public void addImplicitArray(Class ownerType, String fieldName) {
addImplicitCollection(ownerType, fieldName);
}
/**
* Adds an implicit array which is used for all items of the given itemType when the array
* type matches.
*
* @param ownerType class owning the implicit array
* @param fieldName name of the array field in the ownerType
* @param itemType type of the items to be part of this array
* @throws InitializationException if no {@link ImplicitCollectionMapper} is available or the
* array type does not match the itemType
* @since 1.4
*/
public void addImplicitArray(Class ownerType, String fieldName, Class itemType) {
addImplicitCollection(ownerType, fieldName, itemType);
}
/**
* Adds an implicit array which is used for all items of the given element name defined by
* itemName.
*
* @param ownerType class owning the implicit array
* @param fieldName name of the array field in the ownerType
* @param itemName alias name of the items
* @throws InitializationException if no {@link ImplicitCollectionMapper} is available
* @since 1.4
*/
public void addImplicitArray(Class ownerType, String fieldName, String itemName) {
addImplicitCollection(ownerType, fieldName, itemName, null);
}
/**
* Adds an implicit map.
*
* @param ownerType class owning the implicit map
* @param fieldName name of the field in the ownerType. This field must be a concrete
* map type or matching the default implementation type of the map
* type.
* @param itemType type of the items to be part of this map as value
* @param keyFieldName the name of the field of the itemType that is used for the key in the map
* @since 1.4
*/
public void addImplicitMap(Class ownerType, String fieldName, Class itemType, String keyFieldName) {
addImplicitMap(ownerType, fieldName, null, itemType, keyFieldName);
}
/**
* Adds an implicit map.
*
* @param ownerType class owning the implicit map
* @param fieldName name of the field in the ownerType. This field must be a concrete
* map type or matching the default implementation type of the map
* type.
* @param itemName alias name of the items
* @param itemType type of the items to be part of this map as value
* @param keyFieldName the name of the field of the itemType that is used for the key in the map
* @since 1.4
*/
public void addImplicitMap(Class ownerType, String fieldName, String itemName,
Class itemType, String keyFieldName) {
if (implicitCollectionMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ ImplicitCollectionMapper.class.getName()
+ " available");
}
implicitCollectionMapper.add(ownerType, fieldName, itemName, itemType, keyFieldName);
}
/**
* Create a DataHolder that can be used to pass data to the converters. The DataHolder is
* provided with a call to {@link #marshal(Object, HierarchicalStreamWriter, DataHolder)} or
* {@link #unmarshal(HierarchicalStreamReader, Object, DataHolder)}.
*
* @return a new {@link DataHolder}
*/
public DataHolder newDataHolder() {
return new MapBackedDataHolder();
}
/**
* Creates an ObjectOutputStream that serializes a stream of objects to the writer using
* XStream.
*
* To change the name of the root element (from <object-stream>), use
* {@link #createObjectOutputStream(java.io.Writer, String)}.
*
*
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @since 1.0.3
*/
public ObjectOutputStream createObjectOutputStream(Writer writer) throws IOException {
return createObjectOutputStream(
hierarchicalStreamDriver.createWriter(writer), "object-stream");
}
/**
* Creates an ObjectOutputStream that serializes a stream of objects to the writer using
* XStream.
*
* To change the name of the root element (from <object-stream>), use
* {@link #createObjectOutputStream(java.io.Writer, String)}.
*
*
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @since 1.0.3
*/
public ObjectOutputStream createObjectOutputStream(HierarchicalStreamWriter writer)
throws IOException {
return createObjectOutputStream(writer, "object-stream");
}
/**
* Creates an ObjectOutputStream that serializes a stream of objects to the writer using
* XStream.
*
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @since 1.0.3
*/
public ObjectOutputStream createObjectOutputStream(Writer writer, String rootNodeName)
throws IOException {
return createObjectOutputStream(
hierarchicalStreamDriver.createWriter(writer), rootNodeName);
}
/**
* Creates an ObjectOutputStream that serializes a stream of objects to the OutputStream
* using XStream.
*
* To change the name of the root element (from <object-stream>), use
* {@link #createObjectOutputStream(java.io.Writer, String)}.
*
*
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @since 1.3
*/
public ObjectOutputStream createObjectOutputStream(OutputStream out) throws IOException {
return createObjectOutputStream(
hierarchicalStreamDriver.createWriter(out), "object-stream");
}
/**
* Creates an ObjectOutputStream that serializes a stream of objects to the OutputStream
* using XStream.
*
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @since 1.3
*/
public ObjectOutputStream createObjectOutputStream(OutputStream out, String rootNodeName)
throws IOException {
return createObjectOutputStream(
hierarchicalStreamDriver.createWriter(out), rootNodeName);
}
/**
* Creates an ObjectOutputStream that serializes a stream of objects to the writer using
* XStream.
*
* Because an ObjectOutputStream can contain multiple items and XML only allows a single
* root node, the stream must be written inside an enclosing node.
*
*
* It is necessary to call ObjectOutputStream.close() when done, otherwise the stream will
* be incomplete.
*
*
* @param writer The writer to serialize the objects to.
* @param rootNodeName The name of the root node enclosing the stream of objects.
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @since 1.0.3
*/
public ObjectOutputStream createObjectOutputStream(final HierarchicalStreamWriter writer,
String rootNodeName) throws IOException {
final StatefulWriter statefulWriter = new StatefulWriter(writer);
statefulWriter.startNode(rootNodeName, null);
return new CustomObjectOutputStream(new CustomObjectOutputStream.StreamCallback() {
public void writeToStream(Object object) {
marshal(object, statefulWriter);
}
public void writeFieldsToStream(Map fields) throws NotActiveException {
throw new NotActiveException("not in call to writeObject");
}
public void defaultWriteObject() throws NotActiveException {
throw new NotActiveException("not in call to writeObject");
}
public void flush() {
statefulWriter.flush();
}
public void close() {
if (statefulWriter.state() != StatefulWriter.STATE_CLOSED) {
statefulWriter.endNode();
statefulWriter.close();
}
}
});
}
/**
* Creates an ObjectInputStream that deserializes a stream of objects from a reader using
* XStream.
*
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @since 1.0.3
*/
public ObjectInputStream createObjectInputStream(Reader xmlReader) throws IOException {
return createObjectInputStream(hierarchicalStreamDriver.createReader(xmlReader));
}
/**
* Creates an ObjectInputStream that deserializes a stream of objects from an InputStream
* using XStream.
*
* @see #createObjectInputStream(com.thoughtworks.xstream.io.HierarchicalStreamReader)
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @since 1.3
*/
public ObjectInputStream createObjectInputStream(InputStream in) throws IOException {
return createObjectInputStream(hierarchicalStreamDriver.createReader(in));
}
/**
* Creates an ObjectInputStream that deserializes a stream of objects from a reader using
* XStream.
Example
*
*
* ObjectInputStream in = xstream.createObjectOutputStream(aReader);
* int a = out.readInt();
* Object b = out.readObject();
* Object c = out.readObject();
*
*
* @see #createObjectOutputStream(com.thoughtworks.xstream.io.HierarchicalStreamWriter,
* String)
* @since 1.0.3
*/
public ObjectInputStream createObjectInputStream(final HierarchicalStreamReader reader)
throws IOException {
return new CustomObjectInputStream(new CustomObjectInputStream.StreamCallback() {
public Object readFromStream() throws EOFException {
if (!reader.hasMoreChildren()) {
throw new EOFException();
}
reader.moveDown();
Object result = unmarshal(reader);
reader.moveUp();
return result;
}
public Map readFieldsFromStream() throws IOException {
throw new NotActiveException("not in call to readObject");
}
public void defaultReadObject() throws NotActiveException {
throw new NotActiveException("not in call to readObject");
}
public void registerValidation(ObjectInputValidation validation, int priority)
throws NotActiveException {
throw new NotActiveException("stream inactive");
}
public void close() {
reader.close();
}
}, classLoaderReference);
}
/**
* Change the ClassLoader XStream uses to load classes. Creating an XStream instance it will
* register for all kind of classes and types of the current JDK, but not for any 3rd party
* type. To ensure that all other types are loaded with your class loader, you should call
* this method as early as possible - or consider to provide the class loader directly in
* the constructor.
*
* @since 1.1.1
*/
public void setClassLoader(ClassLoader classLoader) {
classLoaderReference.setReference(classLoader);
}
/**
* Retrieve the ClassLoader XStream uses to load classes.
*
* @since 1.1.1
*/
public ClassLoader getClassLoader() {
return classLoaderReference.getReference();
}
/**
* Prevents a field from being serialized. To omit a field you must always provide the
* declaring type and not necessarily the type that is converted.
*
* @since 1.1.3
* @throws InitializationException if no {@link FieldAliasingMapper} is available
*/
public void omitField(Class definedIn, String fieldName) {
if (fieldAliasingMapper == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ FieldAliasingMapper.class.getName()
+ " available");
}
fieldAliasingMapper.omitField(definedIn, fieldName);
}
/**
* Process the annotations of the given types and configure the XStream.
*
* @param types the types with XStream annotations
* @since 1.3
*/
public void processAnnotations(final Class[] types) {
if (annotationConfiguration == null) {
throw new com.thoughtworks.xstream.InitializationException("No "
+ ANNOTATION_MAPPER_TYPE
+ " available");
}
annotationConfiguration.processAnnotations(types);
}
/**
* Process the annotations of the given type and configure the XStream. A call of this
* method will automatically turn the auto-detection mode for annotations off.
*
* @param type the type with XStream annotations
* @since 1.3
*/
public void processAnnotations(final Class type) {
processAnnotations(new Class[]{type});
}
/**
* Set the auto-detection mode of the AnnotationMapper. Note that auto-detection implies
* that the XStream is configured while it is processing the XML steams. This is a potential
* concurrency problem. Also is it technically not possible to detect all class aliases at
* deserialization. You have been warned!
*
* @param mode true if annotations are auto-detected
* @since 1.3
*/
public void autodetectAnnotations(boolean mode) {
if (annotationConfiguration != null) {
annotationConfiguration.autodetectAnnotations(mode);
}
}
/**
* @deprecated As of 1.3, use {@link InitializationException} instead
*/
public static class InitializationException extends XStreamException {
/**
* @deprecated As of 1.3, use {@link InitializationException} instead
*/
public InitializationException(String message, Throwable cause) {
super(message, cause);
}
/**
* @deprecated As of 1.3, use {@link InitializationException} instead
*/
public InitializationException(String message) {
super(message);
}
}
private Object readResolve() {
jvm = new JVM();
return this;
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/ 0000775 0001750 0001750 00000000000 12206661545 031655 5 ustar jamespage jamespage jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/XmlMap.java 0000664 0001750 0001750 00000003044 12206661545 033717 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2007, 2008 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 13. June 2006 by Guilherme Silveira
*/
package com.thoughtworks.xstream.persistence;
import java.util.AbstractMap;
import java.util.AbstractSet;
import java.util.Iterator;
import java.util.Set;
/**
* A persistent map. Its values are actually serialized as xml files. If you
* need an application-wide synchronized version of this map, try the respective
* Collections methods.
*
* @author Guilherme Silveira
*/
public class XmlMap extends AbstractMap {
private final PersistenceStrategy persistenceStrategy;
public XmlMap(PersistenceStrategy streamStrategy) {
this.persistenceStrategy = streamStrategy;
}
public int size() {
return persistenceStrategy.size();
}
public Object get(Object key) {
// faster lookup
return persistenceStrategy.get(key);
}
public Object put(Object key, Object value) {
return persistenceStrategy.put(key,value);
}
public Object remove(Object key) {
return persistenceStrategy.remove(key);
}
public Set entrySet() {
return new XmlMapEntries();
}
class XmlMapEntries extends AbstractSet {
public int size() {
return XmlMap.this.size();
}
public boolean isEmpty() {
return XmlMap.this.isEmpty();
}
public Iterator iterator() {
return persistenceStrategy.iterator();
}
}
} ././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/FileStreamStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/FileStreamStra0000664 0001750 0001750 00000007117 12206661545 034473 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2007, 2008, 2009 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 13. June 2006 by Guilherme Silveira
*/
package com.thoughtworks.xstream.persistence;
import com.thoughtworks.xstream.XStream;
import java.io.File;
/**
* PersistenceStrategy to assign string based keys to objects persisted in files. The file
* naming strategy is based on the key's type name and its toString method. It escapes non
* digit, non a-z and A-Z characters. In order to change the escaping/unescaping algorithm,
* simply extend this class and rewrite its getName/extractKey methods. Note, this
* implementation silently implies that the keys actually are Strings, since the keys will be
* turned into string keys at deserialization time.
*
* @author Guilherme Silveira
* @deprecated As of 1.3.1, use FilePersistenceStrategy
*/
public class FileStreamStrategy extends AbstractFilePersistenceStrategy implements
StreamStrategy {
public FileStreamStrategy(final File baseDirectory) {
this(baseDirectory, new XStream());
}
public FileStreamStrategy(final File baseDirectory, final XStream xstream) {
super(baseDirectory, xstream, null);
}
/**
* Given a filename, the unescape method returns the key which originated it.
*
* @param name the filename
* @return the original key
*/
protected Object extractKey(final String name) {
final String key = unescape(name.substring(0, name.length() - 4));
return key.equals("\0") ? null : key;
}
protected String unescape(final String name) {
final StringBuffer buffer = new StringBuffer();
char lastC = '\uffff';
int currentValue = -1;
// do we have a regex master to do it?
final char[] array = name.toCharArray();
for (int i = 0; i < array.length; i++ ) {
final char c = array[i];
if (c == '_' && currentValue != -1) {
if (lastC == '_') {
buffer.append('_');
} else {
buffer.append((char)currentValue);
}
currentValue = -1;
} else if (c == '_') {
currentValue = 0;
} else if (currentValue != -1) {
currentValue = currentValue * 16 + Integer.parseInt(String.valueOf(c), 16);
} else {
buffer.append(c);
}
lastC = c;
}
return buffer.toString();
}
/**
* Given a key, the escape method returns the filename which shall be used.
*
* @param key the key
* @return the desired and escaped filename
*/
protected String getName(final Object key) {
return escape(key == null ? "\0" : key.toString()) + ".xml";
}
protected String escape(final String key) {
// do we have a regex master to do it?
final StringBuffer buffer = new StringBuffer();
final char[] array = key.toCharArray();
for (int i = 0; i < array.length; i++ ) {
final char c = array[i];
if (Character.isDigit(c) || (c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z')) {
buffer.append(c);
} else if (c == '_') {
buffer.append("__");
} else {
buffer.append("_" + (Integer.toHexString(c)) + "_");
}
}
return buffer.toString();
}
}
././@LongLink 0000644 0000000 0000000 00000000173 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/AbstractFilePersistenceStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/AbstractFilePe0000664 0001750 0001750 00000014500 12206661545 034430 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 18. November 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.persistence;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.mapper.Mapper;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.FilenameFilter;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.util.Iterator;
import java.util.Map;
import java.util.Map.Entry;
/**
* Abstract base class for file based persistence strategies.
*
* @author Guilherme Silveira
* @author Joerg Schaible
* @since 1.3.1
*/
public abstract class AbstractFilePersistenceStrategy implements PersistenceStrategy {
private final FilenameFilter filter;
private final File baseDirectory;
private final String encoding;
private final transient XStream xstream;
public AbstractFilePersistenceStrategy(
final File baseDirectory, final XStream xstream, final String encoding) {
this.baseDirectory = baseDirectory;
this.xstream = xstream;
this.encoding = encoding;
filter = new ValidFilenameFilter();
}
protected ConverterLookup getConverterLookup() {
return xstream.getConverterLookup();
}
protected Mapper getMapper() {
return xstream.getMapper();
}
protected boolean isValid(final File dir, final String name) {
return name.endsWith(".xml");
}
/**
* Given a filename, the unescape method returns the key which originated it.
*
* @param name the filename
* @return the original key
*/
protected abstract Object extractKey(String name);
/**
* Given a key, the escape method returns the filename which shall be used.
*
* @param key the key
* @return the desired and escaped filename
*/
protected abstract String getName(Object key);
protected class ValidFilenameFilter implements FilenameFilter {
public boolean accept(final File dir, final String name) {
return new File(dir, name).isFile() && isValid(dir, name);
}
}
protected class XmlMapEntriesIterator implements Iterator {
private final File[] files = baseDirectory.listFiles(filter);
private int position = -1;
private File current = null;
public boolean hasNext() {
return position + 1 < files.length;
}
public void remove() {
if (current == null) {
throw new IllegalStateException();
}
// removes without loading
current.delete();
}
public Object next() {
return new Map.Entry() {
private final File file = current = files[ ++position];
private final Object key = extractKey(file.getName());
public Object getKey() {
return key;
}
public Object getValue() {
return readFile(file);
}
public Object setValue(final Object value) {
return put(key, value);
}
public boolean equals(final Object obj) {
if (!(obj instanceof Entry)) {
return false;
}
Object value = getValue();
final Entry e2 = (Entry)obj;
Object key2 = e2.getKey();
Object value2 = e2.getValue();
return (key == null ? key2 == null : key.equals(key2))
&& (value == null ? value2 == null : getValue().equals(e2.getValue()));
}
};
}
}
private void writeFile(final File file, final Object value) {
try {
final FileOutputStream out = new FileOutputStream(file);
final Writer writer = encoding != null
? new OutputStreamWriter(out, encoding)
: new OutputStreamWriter(out);
try {
xstream.toXML(value, writer);
} finally {
writer.close();
}
} catch (final IOException e) {
throw new StreamException(e);
}
}
private File getFile(final String filename) {
return new File(baseDirectory, filename);
}
private Object readFile(final File file) {
try {
final FileInputStream in = new FileInputStream(file);
final Reader reader = encoding != null
? new InputStreamReader(in, encoding)
: new InputStreamReader(in);
try {
return xstream.fromXML(reader);
} finally {
reader.close();
}
} catch (final FileNotFoundException e) {
// not found... file.exists might generate a sync problem
return null;
} catch (final IOException e) {
throw new StreamException(e);
}
}
public Object put(final Object key, final Object value) {
final Object oldValue = get(key);
final String filename = getName(key);
writeFile(new File(baseDirectory, filename), value);
return oldValue;
}
public Iterator iterator() {
return new XmlMapEntriesIterator();
}
public int size() {
return baseDirectory.list(filter).length;
}
public boolean containsKey(final Object key) {
// faster lookup
final File file = getFile(getName(key));
return file.isFile();
}
public Object get(final Object key) {
return readFile(getFile(getName(key)));
}
public Object remove(final Object key) {
// faster lookup
final File file = getFile(getName(key));
Object value = null;
if (file.isFile()) {
value = readFile(file);
file.delete();
}
return value;
}
}
././@LongLink 0000644 0000000 0000000 00000000152 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/StreamStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/StreamStrategy0000664 0001750 0001750 00000001162 12206661545 034556 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2007, 2008, 2009 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 13. June 2006 by Guilherme Silveira
*/
package com.thoughtworks.xstream.persistence;
/**
* A key to filename and vice-versa strategy interface.
*
* @author Guilherme Silveira
* @deprecated As of 1.3.1, use {@link PersistenceStrategy} instead
*/
public interface StreamStrategy extends PersistenceStrategy {
} ././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/XmlArrayList.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/XmlArrayList.j0000664 0001750 0001750 00000003515 12206661545 034427 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2007, 2008 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 06. July 2006 by Guilherme Silveira
*/
package com.thoughtworks.xstream.persistence;
import java.util.AbstractList;
/**
* A persistent list implementation backed on a XmlMap.
*
* @author Guilherme Silveira
*/
public class XmlArrayList extends AbstractList {
private final XmlMap map;
public XmlArrayList(PersistenceStrategy persistenceStrategy) {
this.map = new XmlMap(persistenceStrategy);
}
public int size() {
return map.size();
}
public Object set(int index, Object element) {
rangeCheck(index);
Object value = get(index);
map.put(new Integer(index), element);
return value;
}
public void add(int index, Object element) {
int size = size();
if (index >= (size + 1) || index < 0) {
throw new IndexOutOfBoundsException("Index: " + index + ", Size: "
+ size);
}
int to = index != size ? index - 1 : index;
for (int i = size; i > to; i--) {
map.put(new Integer(i + 1), map.get(new Integer(i)));
}
map.put(new Integer(index), element);
}
private void rangeCheck(int index) {
int size = size();
if (index >= size || index < 0) {
throw new IndexOutOfBoundsException("Index: " + index + ", Size: "
+ size);
}
}
public Object get(int index) {
rangeCheck(index);
return map.get(new Integer(index));
}
public Object remove(int index) {
int size = size();
rangeCheck(index);
Object value = map.get(new Integer(index));
for (int i = index; i < size - 1; i++) {
map.put(new Integer(i), map.get(new Integer(i + 1)));
}
map.remove(new Integer(size - 1));
return value;
}
}
././@LongLink 0000644 0000000 0000000 00000000157 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/PersistenceStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/PersistenceStr0000664 0001750 0001750 00000001267 12206661545 034563 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 20. November 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.persistence;
import java.util.Iterator;
/**
* A key to a persistent storage and vice-versa strategy interface.
*
* @author Guilherme Silveira
* @since 1.3.1
*/
public interface PersistenceStrategy {
Iterator iterator();
int size();
Object get(Object key);
Object put(Object key, Object value);
Object remove(Object key);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/XmlSet.java 0000664 0001750 0001750 00000002164 12206661545 033737 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2007, 2008 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 28. June 2006 by Guilherme Silveira
*/
package com.thoughtworks.xstream.persistence;
import java.util.AbstractSet;
import java.util.Iterator;
/**
* A persistent set implementation.
*
* @author Guilherme Silveira
*/
public class XmlSet extends AbstractSet {
private final XmlMap map;
public XmlSet(PersistenceStrategy persistenceStrategy) {
this.map = new XmlMap(persistenceStrategy);
}
public Iterator iterator() {
return map.values().iterator();
}
public int size() {
return map.size();
}
public boolean add(Object o) {
if (map.containsValue(o)) {
return false;
} else {
// not-synchronized!
map.put(findEmptyKey(), o);
return true;
}
}
private Long findEmptyKey() {
long i = System.currentTimeMillis();
while (map.containsKey(new Long(i))) {
i++;
}
return new Long(i);
}
}
././@LongLink 0000644 0000000 0000000 00000000163 12260544303 011641 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/FilePersistenceStrategy.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/persistence/FilePersistenc0000664 0001750 0001750 00000013457 12206661545 034531 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 20. November 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.persistence;
import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.io.StreamException;
import com.thoughtworks.xstream.io.xml.DomDriver;
import java.io.File;
/**
* PersistenceStrategy to assign keys with single value to objects persisted in files. The
* default naming strategy is based on the key's type and its {@link SingleValueConverter}. It
* escapes all characters that are normally illegal in the most common file systems. Such a
* character is escaped with percent escaping as it is done by URL encoding. The XStream used to
* marshal the values is also requested for the key's SingleValueConverter. A
* {@link StreamException} is thrown if no such converter is registered.
*
* @author Jörg Schaible
* @author Guilherme Silveira
* @since 1.3.1
*/
public class FilePersistenceStrategy extends AbstractFilePersistenceStrategy {
private final String illegalChars;
/**
* Create a new FilePersistenceStrategy. Use a standard XStream instance with a
* {@link DomDriver}.
*
* @param baseDirectory the directory for the serialized values
* @since 1.3.1
*/
public FilePersistenceStrategy(final File baseDirectory) {
this(baseDirectory, new XStream(new DomDriver()));
}
/**
* Create a new FilePersistenceStrategy with a provided XStream instance.
*
* @param baseDirectory the directory for the serialized values
* @param xstream the XStream instance to use for (de)serialization
* @since 1.3.1
*/
public FilePersistenceStrategy(final File baseDirectory, final XStream xstream) {
this(baseDirectory, xstream, "utf-8", "<>?:/\\\"|*%");
}
/**
* Create a new FilePersistenceStrategy with a provided XStream instance and the characters
* to encode.
*
* @param baseDirectory the directory for the serialized values
* @param xstream the XStream instance to use for (de)serialization
* @param encoding encoding used to write the files
* @param illegalChars illegal characters for file names (should always include '%' as long
* as you do not overwrite the (un)escape methods)
* @since 1.3.1
*/
public FilePersistenceStrategy(
final File baseDirectory, final XStream xstream, final String encoding,
final String illegalChars) {
super(baseDirectory, xstream, encoding);
this.illegalChars = illegalChars;
}
protected boolean isValid(final File dir, final String name) {
return super.isValid(dir, name) && name.indexOf('@') > 0;
}
/**
* Given a filename, the unescape method returns the key which originated it.
*
* @param name the filename
* @return the original key
*/
protected Object extractKey(final String name) {
final String key = unescape(name.substring(0, name.length() - 4));
if ("null@null".equals(key)) {
return null;
}
int idx = key.indexOf('@');
if (idx < 0) {
throw new StreamException("Not a valid key: " + key);
}
Class type = getMapper().realClass(key.substring(0, idx));
Converter converter = getConverterLookup().lookupConverterForType(type);
if (converter instanceof SingleValueConverter) {
final SingleValueConverter svConverter = (SingleValueConverter)converter;
return svConverter.fromString(key.substring(idx + 1));
} else {
throw new StreamException("No SingleValueConverter for type "
+ type.getName()
+ " available");
}
}
protected String unescape(String name) {
final StringBuffer buffer = new StringBuffer();
for (int idx = name.indexOf('%'); idx >= 0; idx = name.indexOf('%')) {
buffer.append(name.substring(0, idx));
int c = Integer.parseInt(name.substring(idx + 1, idx + 3), 16);
buffer.append((char)c);
name = name.substring(idx + 3);
}
buffer.append(name);
return buffer.toString();
}
/**
* Given a key, the escape method returns the filename which shall be used.
*
* @param key the key
* @return the desired and escaped filename
*/
protected String getName(final Object key) {
if (key == null) {
return "null@null.xml";
}
Class type = key.getClass();
Converter converter = getConverterLookup().lookupConverterForType(type);
if (converter instanceof SingleValueConverter) {
final SingleValueConverter svConverter = (SingleValueConverter)converter;
return getMapper().serializedClass(type)
+ '@'
+ escape(svConverter.toString(key))
+ ".xml";
} else {
throw new StreamException("No SingleValueConverter for type "
+ type.getName()
+ " available");
}
}
protected String escape(final String key) {
final StringBuffer buffer = new StringBuffer();
final char[] array = key.toCharArray();
for (int i = 0; i < array.length; i++ ) {
final char c = array[i];
if (c >= ' ' && illegalChars.indexOf(c) < 0) {
buffer.append(c);
} else {
buffer.append("%" + Integer.toHexString(c).toUpperCase());
}
}
return buffer.toString();
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/MarshallingStrategy.java 0000664 0001750 0001750 00000001722 12206661545 034162 0 ustar jamespage jamespage /*
* Copyright (C) 2004, 2006 Joe Walnes.
* Copyright (C) 2007, 2009 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 16. March 2004 by Joe Walnes
*/
package com.thoughtworks.xstream;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.DataHolder;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import com.thoughtworks.xstream.mapper.Mapper;
public interface MarshallingStrategy {
Object unmarshal(Object root, HierarchicalStreamReader reader, DataHolder dataHolder, ConverterLookup converterLookup, Mapper mapper);
void marshal(HierarchicalStreamWriter writer, Object obj, ConverterLookup converterLookup, Mapper mapper, DataHolder dataHolder);
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/ 0000775 0001750 0001750 00000000000 12206661545 030615 5 ustar jamespage jamespage ././@LongLink 0000644 0000000 0000000 00000000166 12260544303 011644 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AbstractAttributeAliasingMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AbstractAttributeAl0000664 0001750 0001750 00000002450 12206661545 034445 0 ustar jamespage jamespage /*
* Copyright (C) 2008 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 09. October 2008 by Joerg Schaible
*/
package com.thoughtworks.xstream.mapper;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
/**
* Abstract base class for AttributeAliassingMapper and its system version.
*
* @author Jörg Schaible
* @since 1.3.1
*/
public abstract class AbstractAttributeAliasingMapper extends MapperWrapper {
protected final Map aliasToName = new HashMap();
protected transient Map nameToAlias = new HashMap();
public AbstractAttributeAliasingMapper(Mapper wrapped) {
super(wrapped);
}
public void addAliasFor(final String attributeName, final String alias) {
aliasToName.put(alias, attributeName);
nameToAlias.put(attributeName, alias);
}
private Object readResolve() {
nameToAlias = new HashMap();
for (final Iterator iter = aliasToName.keySet().iterator(); iter.hasNext();) {
final Object alias = iter.next();
nameToAlias.put(aliasToName.get(alias), alias);
}
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000161 12260544303 011637 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/XStream11XmlFriendlyMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/XStream11XmlFriendl0000664 0001750 0001750 00000003316 12206661545 034255 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2009, 2011 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 03. May 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.mapper;
/**
* Mapper that ensures that all names in the serialization stream are read in an XML friendly way.
*
*
_ (underscore) chars appearing in class names are replaced with $ (dollar)
*
_DOLLAR_ string appearing in field names are replaced with $ (dollar)
*
__ string appearing in field names are replaced with _ (underscore)
*
default is the prefix for class names with no package.
*
*
* Note, this class is no longer in regular use for current XStream versions. It exists to provide backward compatibility
* to existing XML data written with older XStream versions (<= 1.1).
*
* @author Joe Walnes
* @author Mauro Talevi
* @deprecated As of 1.4 use {@link com.thoughtworks.xstream.io.xml.XmlFriendlyReader}
*/
public class XStream11XmlFriendlyMapper extends AbstractXmlFriendlyMapper {
public XStream11XmlFriendlyMapper(Mapper wrapped) {
super(wrapped);
}
public Class realClass(String elementName) {
return super.realClass(unescapeClassName(elementName));
}
public String realMember(Class type, String serialized) {
return unescapeFieldName(super.realMember(type, serialized));
}
public String mapNameFromXML(String xmlName) {
return unescapeFieldName(xmlName);
}
}
jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/EnumMapper.java 0000664 0001750 0001750 00000010524 12206661545 033533 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 20. March 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.mapper;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.enums.EnumSingleValueConverter;
import com.thoughtworks.xstream.core.Caching;
import java.util.EnumSet;
import java.util.HashMap;
import java.util.Map;
/**
* Mapper that handles the special case of polymorphic enums in Java 1.5. This renames MyEnum$1
* to MyEnum making it less bloaty in the XML and avoiding the need for an alias per enum value
* to be specified. Additionally every enum is treated automatically as immutable type and can
* be written as attribute.
*
* @author Joe Walnes
* @author Jörg Schaible
*/
public class EnumMapper extends MapperWrapper implements Caching {
private transient AttributeMapper attributeMapper;
private transient Map enumConverterMap;
/**
* @deprecated As of 1.3.1, use {@link #EnumMapper(Mapper)}
*/
@Deprecated
public EnumMapper(Mapper wrapped, ConverterLookup lookup) {
super(wrapped);
readResolve();
}
public EnumMapper(Mapper wrapped) {
super(wrapped);
readResolve();
}
@Override
public String serializedClass(Class type) {
if (type == null) {
return super.serializedClass(type);
}
if (Enum.class.isAssignableFrom(type) && type.getSuperclass() != Enum.class) {
return super.serializedClass(type.getSuperclass());
} else if (EnumSet.class.isAssignableFrom(type)) {
return super.serializedClass(EnumSet.class);
} else {
return super.serializedClass(type);
}
}
@Override
public boolean isImmutableValueType(Class type) {
return (Enum.class.isAssignableFrom(type)) || super.isImmutableValueType(type);
}
@Override
public SingleValueConverter getConverterFromItemType(String fieldName, Class type,
Class definedIn) {
SingleValueConverter converter = getLocalConverter(fieldName, type, definedIn);
return converter == null
? super.getConverterFromItemType(fieldName, type, definedIn)
: converter;
}
@Override
public SingleValueConverter getConverterFromAttribute(Class definedIn, String attribute,
Class type) {
SingleValueConverter converter = getLocalConverter(attribute, type, definedIn);
return converter == null
? super.getConverterFromAttribute(definedIn, attribute, type)
: converter;
}
private SingleValueConverter getLocalConverter(String fieldName, Class type, Class definedIn) {
if (attributeMapper != null
&& Enum.class.isAssignableFrom(type)
&& attributeMapper.shouldLookForSingleValueConverter(fieldName, type, definedIn)) {
synchronized (enumConverterMap) {
SingleValueConverter singleValueConverter = enumConverterMap.get(type);
if (singleValueConverter == null) {
singleValueConverter = super.getConverterFromItemType(fieldName, type, definedIn);
if (singleValueConverter == null) {
@SuppressWarnings("unchecked")
Class enumType = type;
singleValueConverter = new EnumSingleValueConverter(enumType);
}
enumConverterMap.put(type, singleValueConverter);
}
return singleValueConverter;
}
}
return null;
}
public void flushCache() {
if (enumConverterMap.size() > 0) {
synchronized (enumConverterMap) {
enumConverterMap.clear();
}
}
}
private Object readResolve() {
this.enumConverterMap = new HashMap();
this.attributeMapper = (AttributeMapper)lookupMapperOfType(AttributeMapper.class);
return this;
}
}
././@LongLink 0000644 0000000 0000000 00000000156 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AttributeAliasingMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AttributeAliasingMa0000664 0001750 0001750 00000002060 12206661545 034427 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008 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 27. March 2006 by Joerg Schaible
*/
package com.thoughtworks.xstream.mapper;
/**
* Mapper that allows aliasing of attribute names.
*
* @author Jörg Schaible
* @author Guilherme Silveira
* @since 1.2
*/
public class AttributeAliasingMapper extends AbstractAttributeAliasingMapper {
public AttributeAliasingMapper(Mapper wrapped) {
super(wrapped);
}
public String aliasForAttribute(String attribute) {
String alias = (String)nameToAlias.get(attribute);
return alias == null ? super.aliasForAttribute(attribute) : alias;
}
public String attributeForAlias(String alias) {
String name = (String)aliasToName.get(alias);
return name == null ? super.attributeForAlias(alias) : name;
}
}
././@LongLink 0000644 0000000 0000000 00000000146 12260544303 011642 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AttributeMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AttributeMapper.jav0000664 0001750 0001750 00000013511 12206661545 034430 0 ustar jamespage jamespage /*
* Copyright (C) 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2010 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 20. February 2006 by Mauro Talevi
*/
package com.thoughtworks.xstream.mapper;
import java.lang.reflect.Field;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.reflection.ReflectionProvider;
/**
* Mapper that allows the usage of attributes for fields and corresponding
* types or specified arbitrary types. It is responsible for the lookup of the
* {@link SingleValueConverter} for item types and attribute names.
*
* @author Paul Hammant
* @author Ian Cartwright
* @author Jörg Schaible
* @author Mauro Talevi
* @author Guilherme Silveira
* @since 1.2
*/
public class AttributeMapper extends MapperWrapper {
private final Map fieldNameToTypeMap = new HashMap();
private final Set typeSet = new HashSet();
private ConverterLookup converterLookup;
private ReflectionProvider reflectionProvider;
private final Set fieldToUseAsAttribute = new HashSet();
/**
* @deprecated As of 1.3
*/
public AttributeMapper(Mapper wrapped) {
this(wrapped, null, null);
}
public AttributeMapper(Mapper wrapped, ConverterLookup converterLookup, ReflectionProvider refProvider) {
super(wrapped);
this.converterLookup = converterLookup;
this.reflectionProvider = refProvider;
}
/**
* @deprecated As of 1.3
*/
public void setConverterLookup(ConverterLookup converterLookup) {
this.converterLookup = converterLookup;
}
public void addAttributeFor(final String fieldName, final Class type) {
fieldNameToTypeMap.put(fieldName, type);
}
public void addAttributeFor(final Class type) {
typeSet.add(type);
}
private SingleValueConverter getLocalConverterFromItemType(Class type) {
Converter converter = converterLookup.lookupConverterForType(type);
if (converter != null && converter instanceof SingleValueConverter) {
return (SingleValueConverter)converter;
} else {
return null;
}
}
/**
* @deprecated As of 1.3, use {@link #getConverterFromItemType(String, Class, Class)}
*/
public SingleValueConverter getConverterFromItemType(String fieldName, Class type) {
if (fieldNameToTypeMap.get(fieldName) == type) {
return getLocalConverterFromItemType(type);
} else {
return null;
}
}
public SingleValueConverter getConverterFromItemType(String fieldName, Class type,
Class definedIn) {
if (shouldLookForSingleValueConverter(fieldName, type, definedIn)) {
SingleValueConverter converter = getLocalConverterFromItemType(type);
if (converter != null) {
return converter;
}
}
return super.getConverterFromItemType(fieldName, type, definedIn);
}
public boolean shouldLookForSingleValueConverter(String fieldName, Class type, Class definedIn) {
Field field = reflectionProvider.getField(definedIn, fieldName);
return fieldToUseAsAttribute.contains(field) || fieldNameToTypeMap.get(fieldName) == type || typeSet.contains(type);
}
/**
* @deprecated As of 1.3, use {@link #getConverterFromItemType(String, Class, Class)}
*/
public SingleValueConverter getConverterFromItemType(Class type) {
if (typeSet.contains(type)) {
return getLocalConverterFromItemType(type);
} else {
return null;
}
}
/**
* @deprecated As of 1.3, use {@link #getConverterFromAttribute(Class, String, Class)}
*/
public SingleValueConverter getConverterFromAttribute(String attributeName) {
SingleValueConverter converter = null;
Class type = (Class)fieldNameToTypeMap.get(attributeName);
if (type != null) {
converter = getLocalConverterFromItemType(type);
}
return converter;
}
/**
* @deprecated As of 1.3.1, use {@link #getConverterFromAttribute(Class, String, Class)}
*/
public SingleValueConverter getConverterFromAttribute(Class definedIn, String attribute) {
Field field = reflectionProvider.getField(definedIn, attribute);
return getConverterFromAttribute(definedIn, attribute, field.getType());
}
public SingleValueConverter getConverterFromAttribute(Class definedIn, String attribute, Class type) {
if (shouldLookForSingleValueConverter(attribute, type, definedIn)) {
SingleValueConverter converter = getLocalConverterFromItemType(type);
if (converter != null) {
return converter;
}
}
return super.getConverterFromAttribute(definedIn, attribute, type);
}
/**
* Tells this mapper to use an attribute for this field.
*
* @param field the field itself
* @since 1.2.2
*/
public void addAttributeFor(Field field) {
fieldToUseAsAttribute.add(field);
}
/**
* Tells this mapper to use an attribute for this field.
*
* @param definedIn the declaring class of the field
* @param fieldName the name of the field
* @throws IllegalArgumentException if the field does not exist
* @since 1.3
*/
public void addAttributeFor(Class definedIn, String fieldName) {
fieldToUseAsAttribute.add(reflectionProvider.getField(definedIn, fieldName));
}
}
././@LongLink 0000644 0000000 0000000 00000000151 12260544303 011636 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/DynamicProxyMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/DynamicProxyMapper.0000664 0001750 0001750 00000003044 12206661545 034412 0 ustar jamespage jamespage /*
* Copyright (C) 2005 Joe Walnes.
* Copyright (C) 2006, 2007, 2009 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 22. January 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.mapper;
import java.lang.reflect.Proxy;
/**
* Mapper for handling special cases of aliasing dynamic proxies. The alias property specifies the name an instance
* of a dynamic proxy should be serialized with.
*
* @author Joe Walnes
*/
public class DynamicProxyMapper extends MapperWrapper {
private String alias;
public DynamicProxyMapper(Mapper wrapped) {
this(wrapped, "dynamic-proxy");
}
public DynamicProxyMapper(Mapper wrapped, String alias) {
super(wrapped);
this.alias = alias;
}
public String getAlias() {
return alias;
}
public void setAlias(String alias) {
this.alias = alias;
}
public String serializedClass(Class type) {
if (Proxy.isProxyClass(type)) {
return alias;
} else {
return super.serializedClass(type);
}
}
public Class realClass(String elementName) {
if (elementName.equals(alias)) {
return DynamicProxy.class;
} else {
return super.realClass(elementName);
}
}
/**
* Place holder type used for dynamic proxies.
*/
public static class DynamicProxy {}
}
././@LongLink 0000644 0000000 0000000 00000000150 12260544303 011635 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/XmlFriendlyMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/XmlFriendlyMapper.j0000664 0001750 0001750 00000004052 12206661545 034373 0 ustar jamespage jamespage /*
* Copyright (C) 2005, 2006 Joe Walnes.
* Copyright (C) 2006, 2007, 2008, 2009, 2011 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 22. January 2005 by Joe Walnes
*/
package com.thoughtworks.xstream.mapper;
/**
* Mapper that ensures that all names in the serialization stream are XML friendly.
* The replacement chars and strings are:
*
*
$ (dollar) chars appearing in class names are replaced with _ (underscore) chars.
*
$ (dollar) chars appearing in field names are replaced with _DOLLAR_ string.
*
_ (underscore) chars appearing in field names are replaced with __ (double underscore) string.
*
default as the prefix for class names with no package.
*
*
* @author Joe Walnes
* @author Mauro Talevi
* @deprecated As of 1.3 use {@link com.thoughtworks.xstream.io.xml.XmlFriendlyReader}
*/
public class XmlFriendlyMapper extends AbstractXmlFriendlyMapper {
/**
* @deprecated As of 1.3 use {@link com.thoughtworks.xstream.io.xml.XmlFriendlyReader}
*/
public XmlFriendlyMapper(Mapper wrapped) {
super(wrapped);
}
public String serializedClass(Class type) {
return escapeClassName(super.serializedClass(type));
}
public Class realClass(String elementName) {
return super.realClass(unescapeClassName(elementName));
}
public String serializedMember(Class type, String memberName) {
return escapeFieldName(super.serializedMember(type, memberName));
}
public String realMember(Class type, String serialized) {
return unescapeFieldName(super.realMember(type, serialized));
}
public String mapNameToXML(String javaName) {
return escapeFieldName(javaName);
}
public String mapNameFromXML(String xmlName) {
return unescapeFieldName(xmlName);
}
}
././@LongLink 0000644 0000000 0000000 00000000147 12260544303 011643 L ustar root root jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AnnotationMapper.java jenkins-xstream-1.4.4-jenkins-4/xstream/src/java/com/thoughtworks/xstream/mapper/AnnotationMapper.ja0000664 0001750 0001750 00000057336 12206661545 034426 0 ustar jamespage jamespage /*
* Copyright (C) 2007, 2008, 2009, 2011, 2012 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 07. November 2007 by Joerg Schaible
*/
package com.thoughtworks.xstream.mapper;
import java.lang.reflect.Array;
import java.lang.reflect.Field;
import java.lang.reflect.GenericArrayType;
import java.lang.reflect.Modifier;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.lang.reflect.TypeVariable;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import com.thoughtworks.xstream.InitializationException;
import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.annotations.XStreamAsAttribute;
import com.thoughtworks.xstream.annotations.XStreamConverter;
import com.thoughtworks.xstream.annotations.XStreamConverters;
import com.thoughtworks.xstream.annotations.XStreamImplicit;
import com.thoughtworks.xstream.annotations.XStreamImplicitCollection;
import com.thoughtworks.xstream.annotations.XStreamInclude;
import com.thoughtworks.xstream.annotations.XStreamOmitField;
import com.thoughtworks.xstream.annotations.XStreamSerializeAs;
import com.thoughtworks.xstream.converters.Converter;
import com.thoughtworks.xstream.converters.ConverterLookup;
import com.thoughtworks.xstream.converters.ConverterMatcher;
import com.thoughtworks.xstream.converters.ConverterRegistry;
import com.thoughtworks.xstream.converters.SingleValueConverter;
import com.thoughtworks.xstream.converters.SingleValueConverterWrapper;
import com.thoughtworks.xstream.converters.reflection.ReflectionProvider;
import com.thoughtworks.xstream.core.JVM;
import com.thoughtworks.xstream.core.util.DependencyInjectionFactory;
/**
* A mapper that uses annotations to prepare the remaining mappers in the chain.
*
* @author Jörg Schaible
* @since 1.3
*/
public class AnnotationMapper extends MapperWrapper implements AnnotationConfiguration {
private boolean locked;
private final Object[] arguments;
private final ConverterRegistry converterRegistry;
private final ClassAliasingMapper classAliasingMapper;
private final DefaultImplementationsMapper defaultImplementationsMapper;
private final ImplicitCollectionMapper implicitCollectionMapper;
private final FieldAliasingMapper fieldAliasingMapper;
private final AttributeMapper attributeMapper;
private final LocalConversionMapper localConversionMapper;
private final Map, Map, Converter>> converterCache =
new HashMap, Map, Converter>>();
private final Set> annotatedTypes = new HashSet>();
private final Map,Boolean> processedTypes = new ConcurrentHashMap,Boolean>(); // used like a set since there's no ConcurrentHashSet
private final Map serializedClass = new ConcurrentHashMap();
/**
* Construct an AnnotationMapper.
*
* @param wrapped the next {@link Mapper} in the chain
* @since 1.3
*/
public AnnotationMapper(
final Mapper wrapped, final ConverterRegistry converterRegistry, final ConverterLookup converterLookup,
final ClassLoader classLoader, final ReflectionProvider reflectionProvider,
final JVM jvm) {
super(wrapped);
this.converterRegistry = converterRegistry;
annotatedTypes.add(Object.class);
classAliasingMapper = (ClassAliasingMapper)lookupMapperOfType(ClassAliasingMapper.class);
defaultImplementationsMapper = (DefaultImplementationsMapper)lookupMapperOfType(DefaultImplementationsMapper.class);
implicitCollectionMapper = (ImplicitCollectionMapper)lookupMapperOfType(ImplicitCollectionMapper.class);
fieldAliasingMapper = (FieldAliasingMapper)lookupMapperOfType(FieldAliasingMapper.class);
attributeMapper = (AttributeMapper)lookupMapperOfType(AttributeMapper.class);
localConversionMapper = (LocalConversionMapper)lookupMapperOfType(LocalConversionMapper.class);
locked = true;
arguments = new Object[]{this, classLoader, reflectionProvider, jvm, converterLookup};
}
@Override
public String realMember(final Class type, final String serialized) {
if (!locked) {
processAnnotations(type);
}
return super.realMember(type, serialized);
}
@Override
public String serializedClass(final Class type) {
if (!locked) {
processAnnotations(type);
}
if (type!=null) {
String name = serializedClass.get(type);
if (name!=null) return name;
}
return super.serializedClass(type);
}
@Override
public Class defaultImplementationOf(final Class type) {
if (!locked) {
processAnnotations(type);
}
final Class defaultImplementation = super.defaultImplementationOf(type);
if (!locked) {
processAnnotations(defaultImplementation);
}
return defaultImplementation;
}
@Override
public Converter getLocalConverter(final Class definedIn, final String fieldName) {
if (!locked) {
processAnnotations(definedIn);
}
return super.getLocalConverter(definedIn, fieldName);
}
public void autodetectAnnotations(final boolean mode) {
locked = !mode;
}
public void processAnnotations(final Class[] initialTypes) {
if (initialTypes == null || initialTypes.length == 0) {
return;
}
locked = true;
synchronized (annotatedTypes) {
final Set> types = new UnprocessedTypesSet();
for (final Class initialType : initialTypes) {
types.add(initialType);
}
processTypes(types);
}
}
private void processAnnotations(final Class initialType) {
if (initialType == null) {
return;
}
if (processedTypes.containsKey(initialType)) return;
synchronized (annotatedTypes) {
final Set> types = new UnprocessedTypesSet();
if (types.add(initialType)) {
processTypes(types);
} else {
processedTypes.put(initialType, true);
}
}
}
private void processTypes(final Set> types) {
while (!types.isEmpty()) {
final Iterator> iter = types.iterator();
final Class type = iter.next();
iter.remove();
if (annotatedTypes.add(type)) {
try {
if (type.isPrimitive()) {
continue;
}
XStreamSerializeAs a = type.getAnnotation(XStreamSerializeAs.class);
if (a!=null && a.value()!=void.class)
serializedClass.put(type,a.value().getName());
addParametrizedTypes(type, types);
processConverterAnnotations(type);
processAliasAnnotation(type, types);
if (type.isInterface()) {
continue;
}
processImplicitCollectionAnnotation(type);
final Field[] fields = type.getDeclaredFields();
for (int i = 0; i < fields.length; i++ ) {
final Field field = fields[i];
if (field.isEnumConstant()
|| (field.getModifiers() & (Modifier.STATIC | Modifier.TRANSIENT)) > 0) {
continue;
}
addParametrizedTypes(field.getGenericType(), types);
if (field.isSynthetic()) {
continue;
}
processFieldAliasAnnotation(field);
processAsAttributeAnnotation(field);
processImplicitAnnotation(field);
processOmitFieldAnnotation(field);
processLocalConverterAnnotation(field);
}
} finally {
processedTypes.put(type, true);
}
}
}
}
private void addParametrizedTypes(Type type, final Set> types) {
final Set processedTypes = new HashSet();
final Set localTypes = new LinkedHashSet() {
@Override
public boolean add(final Type o) {
if (o instanceof Class) {
return types.add((Class)o);
}
return o == null || processedTypes.contains(o) ? false : super.add(o);
}
};
while (type != null) {
processedTypes.add(type);
if (type instanceof Class) {
final Class clazz = (Class)type;
types.add(clazz);
if (!clazz.isPrimitive()) {
final TypeVariable[] typeParameters = clazz.getTypeParameters();
for (final TypeVariable typeVariable : typeParameters) {
localTypes.add(typeVariable);
}
localTypes.add(clazz.getGenericSuperclass());
for (final Type iface : clazz.getGenericInterfaces()) {
localTypes.add(iface);
}
}
} else if (type instanceof TypeVariable) {
final TypeVariable typeVariable = (TypeVariable)type;
final Type[] bounds = typeVariable.getBounds();
for (final Type bound : bounds) {
localTypes.add(bound);
}
} else if (type instanceof ParameterizedType) {
final ParameterizedType parametrizedType = (ParameterizedType)type;
localTypes.add(parametrizedType.getRawType());
final Type[] actualArguments = parametrizedType.getActualTypeArguments();
for (final Type actualArgument : actualArguments) {
localTypes.add(actualArgument);
}
} else if (type instanceof GenericArrayType) {
final GenericArrayType arrayType = (GenericArrayType)type;
localTypes.add(arrayType.getGenericComponentType());
}
if (!localTypes.isEmpty()) {
final Iterator iter = localTypes.iterator();
type = iter.next();
iter.remove();
} else {
type = null;
}
}
}
private void processConverterAnnotations(final Class type) {
if (converterRegistry != null) {
final XStreamConverters convertersAnnotation = type
.getAnnotation(XStreamConverters.class);
final XStreamConverter converterAnnotation = type
.getAnnotation(XStreamConverter.class);
final List annotations = convertersAnnotation != null
? new ArrayList(Arrays.asList(convertersAnnotation.value()))
: new ArrayList();
if (converterAnnotation != null) {
annotations.add(converterAnnotation);
}
for (final XStreamConverter annotation : annotations) {
final Converter converter = cacheConverter(
annotation, converterAnnotation != null ? type : null);
if (converter != null) {
if (converterAnnotation != null || converter.canConvert(type)) {
converterRegistry.registerConverter(converter, annotation.priority());
} else {
throw new InitializationException("Converter "
+ annotation.value().getName()
+ " cannot handle annotated class "
+ type.getName());
}
}
}
}
}
private void processAliasAnnotation(final Class type, final Set> types) {
final XStreamAlias aliasAnnotation = type.getAnnotation(XStreamAlias.class);
if (aliasAnnotation != null) {
if (classAliasingMapper == null) {
throw new InitializationException("No "
+ ClassAliasingMapper.class.getName()
+ " available");
}
if (aliasAnnotation.impl() != Void.class) {
// Alias for Interface/Class with an impl
classAliasingMapper.addClassAlias(aliasAnnotation.value(), type);
defaultImplementationsMapper.addDefaultImplementation(
aliasAnnotation.impl(), type);
if (type.isInterface()) {
types.add(aliasAnnotation.impl()); // alias Interface's impl
}
} else {
classAliasingMapper.addClassAlias(aliasAnnotation.value(), type);
}
}
}
@Deprecated
private void processImplicitCollectionAnnotation(final Class type) {
final XStreamImplicitCollection implicitColAnnotation = type
.getAnnotation(XStreamImplicitCollection.class);
if (implicitColAnnotation != null) {
if (implicitCollectionMapper == null) {
throw new InitializationException("No "
+ ImplicitCollectionMapper.class.getName()
+ " available");
}
final String fieldName = implicitColAnnotation.value();
final String itemFieldName = implicitColAnnotation.item();
final Field field;
try {
field = type.getDeclaredField(fieldName);
} catch (final NoSuchFieldException e) {
throw new InitializationException(type.getName()
+ " does not have a field named '"
+ fieldName
+ "' as required by "
+ XStreamImplicitCollection.class.getName());
}
Class itemType = null;
final Type genericType = field.getGenericType();
if (genericType instanceof ParameterizedType) {
final Type typeArgument = ((ParameterizedType)genericType)
.getActualTypeArguments()[0];
itemType = getClass(typeArgument);
}
if (itemType == null) {
implicitCollectionMapper.add(type, fieldName, null, Object.class);
} else {
if (itemFieldName.equals("")) {
implicitCollectionMapper.add(type, fieldName, null, itemType);
} else {
implicitCollectionMapper.add(type, fieldName, itemFieldName, itemType);
}
}
}
}
private void processFieldAliasAnnotation(final Field field) {
final XStreamAlias aliasAnnotation = field.getAnnotation(XStreamAlias.class);
if (aliasAnnotation != null) {
if (fieldAliasingMapper == null) {
throw new InitializationException("No "
+ FieldAliasingMapper.class.getName()
+ " available");
}
fieldAliasingMapper.addFieldAlias(
aliasAnnotation.value(), field.getDeclaringClass(), field.getName());
}
}
private void processAsAttributeAnnotation(final Field field) {
final XStreamAsAttribute asAttributeAnnotation = field
.getAnnotation(XStreamAsAttribute.class);
if (asAttributeAnnotation != null) {
if (attributeMapper == null) {
throw new InitializationException("No "
+ AttributeMapper.class.getName()
+ " available");
}
attributeMapper.addAttributeFor(field);
}
}
private void processImplicitAnnotation(final Field field) {
final XStreamImplicit implicitAnnotation = field.getAnnotation(XStreamImplicit.class);
if (implicitAnnotation != null) {
if (implicitCollectionMapper == null) {
throw new InitializationException("No "
+ ImplicitCollectionMapper.class.getName()
+ " available");
}
final String fieldName = field.getName();
final String itemFieldName = implicitAnnotation.itemFieldName();
final String keyFieldName = implicitAnnotation.keyFieldName();
boolean isMap = Map.class.isAssignableFrom(field.getType());
Class itemType = null;
if (!field.getType().isArray()) {
final Type genericType = field.getGenericType();
if (genericType instanceof ParameterizedType) {
final Type[] actualTypeArguments = ((ParameterizedType)genericType)
.getActualTypeArguments();
final Type typeArgument = actualTypeArguments[isMap ? 1 : 0];
itemType = getClass(typeArgument);
}
}
if (isMap) {
implicitCollectionMapper.add(
field.getDeclaringClass(), fieldName,
itemFieldName != null && !"".equals(itemFieldName) ? itemFieldName : null,
itemType, keyFieldName != null && !"".equals(keyFieldName)
? keyFieldName
: null);
} else {
if (itemFieldName != null && !"".equals(itemFieldName)) {
implicitCollectionMapper.add(
field.getDeclaringClass(), fieldName, itemFieldName, itemType);
} else {
implicitCollectionMapper
.add(field.getDeclaringClass(), fieldName, itemType);
}
}
}
}
private void processOmitFieldAnnotation(final Field field) {
final XStreamOmitField omitFieldAnnotation = field
.getAnnotation(XStreamOmitField.class);
if (omitFieldAnnotation != null) {
if (fieldAliasingMapper == null) {
throw new InitializationException("No "
+ FieldAliasingMapper.class.getName()
+ " available");
}
fieldAliasingMapper.omitField(field.getDeclaringClass(), field.getName());
}
}
private void processLocalConverterAnnotation(final Field field) {
final XStreamConverter annotation = field.getAnnotation(XStreamConverter.class);
if (annotation != null) {
final Converter converter = cacheConverter(annotation, field.getType());
if (converter != null) {
if (localConversionMapper == null) {
throw new InitializationException("No "
+ LocalConversionMapper.class.getName()
+ " available");
}
localConversionMapper.registerLocalConverter(
field.getDeclaringClass(), field.getName(), converter);
}
}
}
private Converter cacheConverter(final XStreamConverter annotation,
final Class targetType) {
Converter result = null;
final Object[] args;
final List
