Package com.adaptris.core

Class AbstractMarshaller

java.lang.Object

com.adaptris.core.AbstractMarshaller

All Implemented Interfaces:

AdaptrisMarshaller

Direct Known Subclasses:

StatisticMarshaller, XStreamMarshallerImpl

public abstract class AbstractMarshaller
extends Object
implements AdaptrisMarshaller

Abstract implementation of AdaptrisMarshaller.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	AbstractMarshaller.Deserializer
protected static interface	AbstractMarshaller.Serializer

Nested classes/interfaces inherited from interface com.adaptris.core.AdaptrisMarshaller

AdaptrisMarshaller.MarshalInputStream, AdaptrisMarshaller.MarshalOutputStream

Constructor Summary

Constructors

Constructor	Description
AbstractMarshaller()

Method Summary

Modifier and Type	Method	Description
protected static Object	invokeDeserialize(AbstractMarshaller.Deserializer u)	Wrap the unmarshalling sequence by catching exceptions and re-throwing as CoreExceptions.
protected static void	invokeSerialize(AbstractMarshaller.Serializer m)	Wrap the marshalling sequence by catching exceptions and re-throwing as CoreExceptions.
void	marshal(Object obj, File fileName)	Marshalls an object to XML.
void	marshal(Object obj, OutputStream outputStream)	Marshalls an object to XML.
void	marshal(Object obj, String fileName)	Marshalls an object to XML.
void	marshal(Object obj, URL fileUrl)	Marshalls an XML representation of the passed Object to the file sytem location denoted by the passed URL.
Object	unmarshal(URLString loc)	Unmarshals an Object from the passed URLString location.
Object	unmarshal(File file)	Unmarshalls an Object based on the passed file.
Object	unmarshal(InputStream stream)	Unmarshals an Object based on the passed InputStream.
Object	unmarshal(String xml)	Unmarshalls an Object from the passed XML.
Object	unmarshal(URL url)	Unmarshalls an Object based on the passed file system URL.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.adaptris.core.AdaptrisMarshaller

marshal, marshal, unmarshal

Constructor Details

AbstractMarshaller

public AbstractMarshaller()

Method Details

marshal

public void marshal(Object obj,
 String fileName)
             throws CoreException

Description copied from interface: AdaptrisMarshaller

Marshalls an object to XML.

Specified by:

marshal in interface AdaptrisMarshaller

Parameters:

obj - the Object to marshall to XML

fileName - the name of the file to write to

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.marshal(java.lang.Object, java.lang.String)

marshal

public void marshal(Object obj,
 File fileName)
             throws CoreException

Description copied from interface: AdaptrisMarshaller

Marshalls an object to XML.

Specified by:

marshal in interface AdaptrisMarshaller

Parameters:

obj - the Object to marshall to XML

fileName - the file to write to

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.marshal(java.lang.Object, File)

marshal

public void marshal(Object obj,
 OutputStream outputStream)
             throws CoreException

Description copied from interface: AdaptrisMarshaller

Marshalls an object to XML.

Specified by:

marshal in interface AdaptrisMarshaller

Parameters:

obj - the object to marshall to XML

outputStream - the OutputStream to write to

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.marshal(java.lang.Object, OutputStream)

marshal

public void marshal(Object obj,
 URL fileUrl)
             throws CoreException

Description copied from interface: AdaptrisMarshaller

Marshalls an XML representation of the passed Object to the file sytem location denoted by the passed URL.

Specified by:

marshal in interface AdaptrisMarshaller

Parameters:

obj - the Object to marshall to XML

fileUrl - the file system location to write to

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.marshal(java.lang.Object, java.net.URL)

unmarshal

public Object unmarshal(String xml)
                 throws CoreException

Description copied from interface: AdaptrisMarshaller

Unmarshalls an Object from the passed XML.

Specified by:

unmarshal in interface AdaptrisMarshaller

Parameters:

xml - the String to unmarshal

Returns:

an Object

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.unmarshal(java.lang.String)

unmarshal

public Object unmarshal(File file)
                 throws CoreException

Description copied from interface: AdaptrisMarshaller

Unmarshalls an Object based on the passed file.

Specified by:

unmarshal in interface AdaptrisMarshaller

Parameters:

file - a file containing XML to unmarshal

Returns:

an Object

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.unmarshal(java.io.File)

unmarshal

public Object unmarshal(URL url)
                 throws CoreException

Description copied from interface: AdaptrisMarshaller

Unmarshalls an Object based on the passed file system URL.

Specified by:

unmarshal in interface AdaptrisMarshaller

Parameters:

url - the file system location to read from

Returns:

an Object

Throws:

CoreException - wrapping any underlying Exception

See Also:

• AdaptrisMarshaller.unmarshal(java.net.URL)

unmarshal

public Object unmarshal(URLString loc)
                 throws CoreException

Description copied from interface: AdaptrisMarshaller

Unmarshals an Object from the passed URLString location.

Specified by:

unmarshal in interface AdaptrisMarshaller

Parameters:

loc - the location to unmarshal from

Returns:

the unmarshalled Object

Throws:

CoreException - wrapping any underlying Exceptions

unmarshal

public Object unmarshal(InputStream stream)
                 throws CoreException

Description copied from interface: AdaptrisMarshaller

Unmarshals an Object based on the passed InputStream.

Specified by:

unmarshal in interface AdaptrisMarshaller

Parameters:

stream - an InputStream of XML to unmarshal

Returns:

an Object

Throws:

CoreException - wrapping any underlying Exception

invokeDeserialize

protected static Object invokeDeserialize(AbstractMarshaller.Deserializer u)
                                   throws CoreException

Wrap the unmarshalling sequence by catching exceptions and re-throwing as CoreExceptions.

Throws:

CoreException

invokeSerialize

protected static void invokeSerialize(AbstractMarshaller.Serializer m)
                               throws CoreException

Wrap the marshalling sequence by catching exceptions and re-throwing as CoreExceptions.

Throws:

CoreException