org.axonframework.serialization

Class AbstractXStreamSerializer.Builder

java.lang.Object

org.axonframework.serialization.AbstractXStreamSerializer.Builder

Direct Known Subclasses:

XStreamSerializer.Builder

Enclosing class:

AbstractXStreamSerializer

public abstract static class AbstractXStreamSerializer.Builder
extends Object

Abstract Builder class to instantiate AbstractXStreamSerializer.

The Charset is defaulted to a Charset.forName(String) using the UTF-8 character set, the RevisionResolver defaults to an AnnotationRevisionResolver and the Converter defaults to a ChainingConverter. The XStream is a hard requirement and as such should be provided.

Upon instantiation, several defaults aliases are added to the XStream instance, for example for the GenericDomainEventMessage, the GenericCommandMessage and the MetaData objects among others. Additionally, a MetaDataConverter is registered too. Lastly, if the provided Converter instance is of type ChainingConverter, then the AbstractXStreamSerializer.registerConverters(ChainingConverter) function will be called. Depending on the AbstractXStreamSerializer, this will add a number of Converter instances to the chain.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
AbstractXStreamSerializer.Builder	charset(Charset charset) Sets the Charset used for the in- and output streams required by XStream for the to and from xml function calls.
AbstractXStreamSerializer.Builder	converter(Converter converter) Sets the Converter used as a converter factory providing converter instances utilized by upcasters to convert between different content types.
AbstractXStreamSerializer.Builder	revisionResolver(RevisionResolver revisionResolver) Sets the RevisionResolver used to resolve the revision from an object to be serialized.
protected void	validate() Validates whether the fields contained in this Builder are set accordingly.
AbstractXStreamSerializer.Builder	xStream(com.thoughtworks.xstream.XStream xStream) Sets the XStream used to perform the serialization of objects to XML, and vice versa.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

xStream

public AbstractXStreamSerializer.Builder xStream(com.thoughtworks.xstream.XStream xStream)

Sets the XStream used to perform the serialization of objects to XML, and vice versa.

Parameters:

xStream - the XStream used to perform the serialization of objects to XML, and vice versa

Returns:

the current Builder instance, for fluent interfacing

charset

public AbstractXStreamSerializer.Builder charset(Charset charset)

Sets the Charset used for the in- and output streams required by XStream for the to and from xml function calls. Defaults to a Charset.forName(String) using the UTF-8 character set.

Parameters:

charset - the Charset used for the in- and output streams required by XStream

Returns:

the current Builder instance, for fluent interfacing

revisionResolver

public AbstractXStreamSerializer.Builder revisionResolver(RevisionResolver revisionResolver)

Sets the RevisionResolver used to resolve the revision from an object to be serialized. Defaults to an AnnotationRevisionResolver which resolves the revision based on the contents of the Revision annotation on the serialized classes.

Parameters:

revisionResolver - a RevisionResolver used to resolve the revision from an object to be serialized

Returns:

the current Builder instance, for fluent interfacing

converter

public AbstractXStreamSerializer.Builder converter(Converter converter)

Sets the Converter used as a converter factory providing converter instances utilized by upcasters to convert between different content types. Defaults to a ChainingConverter.

Parameters:

converter - a Converter used as a converter factory providing converter instances utilized by upcasters to convert between different content types

Returns:

the current Builder instance, for fluent interfacing

validate

protected void validate()
                 throws AxonConfigurationException

Validates whether the fields contained in this Builder are set accordingly.

Throws:

AxonConfigurationException - if one field is asserted to be incorrect according to the Builder's specifications