com.tangosol.coherence.rest.io

Class JaxbXmlMarshaller

java.lang.Object

com.tangosol.coherence.rest.io.AbstractMarshaller

com.tangosol.coherence.rest.io.JaxbXmlMarshaller

All Implemented Interfaces:

Marshaller

public class JaxbXmlMarshaller
extends AbstractMarshaller

JAXB-based marshaller that marshals object to/from XML.

Author:

as 2011.07.10

Field Summary

Fields inherited from interface com.tangosol.coherence.rest.io.Marshaller

FORMAT_OUTPUT

Constructor Summary

Constructors

Constructor and Description
JaxbXmlMarshaller(Class clzRoot) Construct an JaxbXmlMarshaller instance.

Method Summary

Modifier and Type	Method and Description
protected void	configureJaxbMarshaller(Marshaller marshaller) Configure a JAXB marshaller.
protected void	configureJaxbUnmarshaller(Unmarshaller unmarshaller) Configure a JAXB unmarshaller.
void	marshal(Object oValue, OutputStream out) Write the specified object into the given stream.
void	marshalAsFragment(Object oValue, OutputStream out) Write the specified object into the given stream as a fragment.
Object	unmarshal(InputStream in) Read an object from the specified stream.

Methods inherited from class com.tangosol.coherence.rest.io.AbstractMarshaller

getRootClass

Methods inherited from class java.lang.Object

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

Constructor Detail

JaxbXmlMarshaller

public JaxbXmlMarshaller(Class clzRoot)

Construct an JaxbXmlMarshaller instance.

Parameters:

clzRoot - class of the root object this marshaller is for

Method Detail

marshal

public void marshal(Object oValue,
                    OutputStream out)
             throws IOException

Write the specified object into the given stream.

Parameters:

oValue - object to marshall

out - stream to write to

Throws:

IOException - if an error occurs during marshalling

marshalAsFragment

public void marshalAsFragment(Object oValue,
                              OutputStream out)
                       throws IOException

Write the specified object into the given stream as a fragment.

This method is called when marshalling collections of objects, as marshalling behavior might differ when an object is serialized directly or as element of a collection.

For example, when marshalling a collection of objects into XML, you need to ensure that the XML declaration is emmitted only once, not for each object in the collection.

In cases where there is no difference in output between fragments and full objects (JSON, for example), this method could simply delegate to Marshaller.marshal(Object, OutputStream).

Specified by:

marshalAsFragment in interface Marshaller

Overrides:

marshalAsFragment in class AbstractMarshaller

Parameters:

oValue - object to marshall

out - stream to write to

Throws:

IOException - if an error occurs during marshalling

unmarshal

public Object unmarshal(InputStream in)
                 throws IOException

Read an object from the specified stream.

Parameters:

in - stream to read from

Returns:

unmarshalled object instance

Throws:

IOException - if an error occurs during unmarshalling

configureJaxbMarshaller

protected void configureJaxbMarshaller(Marshaller marshaller)
                                throws PropertyException

Configure a JAXB marshaller.

Parameters:

marshaller - marshaller to configure

Throws:

PropertyException - when there is an error processing a property or value

configureJaxbUnmarshaller

protected void configureJaxbUnmarshaller(Unmarshaller unmarshaller)
                                  throws PropertyException

Configure a JAXB unmarshaller.

Parameters:

unmarshaller - unmarshaller to configure

Throws:

PropertyException - when there is an error processing a property or value