org.restlet.ext.jaxb.internal

Class Unmarshaller<T>

java.lang.Object

org.restlet.ext.jaxb.internal.Unmarshaller<T>

public class Unmarshaller<T>
extends Object

This is a utility class to assist in unmarshaling XML into a new Java content tree. Each unmarshal method takes a different source for the XML. This class caches information to improve unmarshaling performance across calls using the same schema (package).

Author:

Overstock.com

Constructor Summary

Constructors

Constructor and Description
Unmarshaller(String contextPath, ClassLoader classloader) Constructor.

Method Summary

Modifier and Type	Method and Description
ClassLoader	getClassLoader() Returns the JAXB classloader.
String	getContextPath() Returns the JAXB context path.
void	setEventHandler(javax.xml.bind.ValidationEventHandler handler) Sets the validation handler for this unmarshaller.
Object	unmarshal(JaxbRepresentation<?> jaxbRep) Unmarshal XML data from the specified Restlet string representation and return the resulting Java content tree.
Object	unmarshal(JaxbRepresentation<?> jaxbRep, InputStream stream) Unmarshal XML data from the specified input stream and return the resulting Java content tree.
Object	unmarshal(JaxbRepresentation<?> jaxbRep, Reader reader) Unmarshal XML data from the specified reader and return the resulting Java content tree.

Methods inherited from class java.lang.Object

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

Constructor Detail

Unmarshaller

public Unmarshaller(String contextPath,
                    ClassLoader classloader)

Constructor.

Parameters:

contextPath - The JAXB context path.

classloader - The JAXB classloader.

Method Detail

getClassLoader

public ClassLoader getClassLoader()

Returns the JAXB classloader.

Returns:

The JAXB classloader.

getContextPath

public String getContextPath()

Returns the JAXB context path.

Returns:

The JAXB context path.

setEventHandler

public void setEventHandler(javax.xml.bind.ValidationEventHandler handler)
                     throws javax.xml.bind.JAXBException

Sets the validation handler for this unmarshaller.

Parameters:

handler - A validation handler.

Throws:

javax.xml.bind.JAXBException - If an error was encountered while setting the event handler.

unmarshal

public Object unmarshal(JaxbRepresentation<?> jaxbRep,
                        InputStream stream)
                 throws javax.xml.bind.JAXBException

Unmarshal XML data from the specified input stream and return the resulting Java content tree.

Parameters:

stream - The source input stream.

Returns:

The newly created root object of the Java content tree.

Throws:

javax.xml.bind.JAXBException - If any unexpected problem occurs during unmarshaling.

IOException - If an error occurs accessing the string representation.

unmarshal

public Object unmarshal(JaxbRepresentation<?> jaxbRep,
                        Reader reader)
                 throws javax.xml.bind.JAXBException

Unmarshal XML data from the specified reader and return the resulting Java content tree.

Parameters:

reader - The source reader.

Returns:

The newly created root object of the Java content tree.

Throws:

javax.xml.bind.JAXBException - If any unexpected problem occurs during unmarshaling.

IOException - If an error occurs accessing the string representation.

unmarshal

public Object unmarshal(JaxbRepresentation<?> jaxbRep)
                 throws javax.xml.bind.JAXBException,
                        IOException

Unmarshal XML data from the specified Restlet string representation and return the resulting Java content tree.

Parameters:

jaxbRep - The source JAXB representation.

Returns:

The newly created root object of the Java content tree.

Throws:

javax.xml.bind.JAXBException - If any unexpected problem occurs during unmarshaling.

IOException - If an error occurs accessing the string representation.