org.glassfish.jersey.jettison.internal
Class BaseJsonUnmarshaller

java.lang.Object
  org.glassfish.jersey.jettison.internal.BaseJsonUnmarshaller

All Implemented Interfaces:

JettisonConfigured, JettisonUnmarshaller

Direct Known Subclasses:

JettisonJaxbUnmarshaller

public class BaseJsonUnmarshaller
extends Object
implements JettisonUnmarshaller, JettisonConfigured

Base JSON marshaller implementation class.

Author:

Jakub Podlesak (jakub.podlesak at oracle.com)

Field Summary

protected Unmarshaller	jaxbUnmarshaller
protected JettisonConfig	jsonConfig

Constructor Summary

BaseJsonUnmarshaller(JAXBContext jaxbContext, JettisonConfig jsonConfig)

BaseJsonUnmarshaller(Unmarshaller jaxbUnmarshaller, JettisonConfig jsonConfig)

Method Summary

JettisonConfig	getJSONConfiguration() Provides information on current JSON configuration options for this object.
<T> T	unmarshalFromJSON(InputStream inputStream, Class<T> expectedType) Unmarshal JSON data from the specified InputStream and return the resulting Java content tree.
<T> T	unmarshalFromJSON(Reader reader, Class<T> expectedType) Unmarshal JSON data from the specified Reader and return the resulting Java content tree.
<T> JAXBElement<T>	unmarshalJAXBElementFromJSON(InputStream inputStream, Class<T> declaredType) Unmarshal JSON data from the InputStream by declaredType and return the resulting content tree.
<T> JAXBElement<T>	unmarshalJAXBElementFromJSON(Reader reader, Class<T> declaredType) Unmarshal JSON data from the Reader by declaredType and return the resulting content tree.

Methods inherited from class java.lang.Object

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

Field Detail

jaxbUnmarshaller

protected final Unmarshaller jaxbUnmarshaller

jsonConfig

protected final JettisonConfig jsonConfig

Constructor Detail

BaseJsonUnmarshaller

public BaseJsonUnmarshaller(JAXBContext jaxbContext,
                            JettisonConfig jsonConfig)
                     throws JAXBException

Throws:

JAXBException

BaseJsonUnmarshaller

public BaseJsonUnmarshaller(Unmarshaller jaxbUnmarshaller,
                            JettisonConfig jsonConfig)

Method Detail

getJSONConfiguration

public JettisonConfig getJSONConfiguration()

Description copied from interface: JettisonConfigured

Provides information on current JSON configuration options for this object.

Specified by:

getJSONConfiguration in interface JettisonConfigured

Returns:

a non-null JettisonConfig instance.

unmarshalFromJSON

public <T> T unmarshalFromJSON(InputStream inputStream,
                               Class<T> expectedType)
                    throws JAXBException

Description copied from interface: JettisonUnmarshaller

Unmarshal JSON data from the specified InputStream and return the resulting Java content tree.

The UTF-8 character encoding scheme will be used to decode the encoded characters of the JSON data.

Specified by:

unmarshalFromJSON in interface JettisonUnmarshaller

Type Parameters:

T - the type of the Java content tree.

Parameters:

inputStream - the InputStream to unmarshal JSON data from.

expectedType - the expected type of the Java content tree.

Returns:

the newly created root object of the Java content tree. The content tree may be an instance of a class that is mapped to a XML root element (for example, annotated with XmlRootElement) or mapped to an XML type (for example, annotated with XmlType).

Throws:

JAXBException - if any unexpected errors occur while unmarshalling.

UnmarshalException - if the JsonUnmarshaller is unable to perform the JSON to Java binding.

unmarshalFromJSON

public <T> T unmarshalFromJSON(Reader reader,
                               Class<T> expectedType)
                    throws JAXBException

Description copied from interface: JettisonUnmarshaller

Unmarshal JSON data from the specified Reader and return the resulting Java content tree.

The character encoding scheme of the reader will be used to encode the characters of the JSON data.

Specified by:

unmarshalFromJSON in interface JettisonUnmarshaller

Type Parameters:

T - the type of the Java content tree.

Parameters:

reader - the Reader to unmarshal JSON data from.

expectedType - the expected type of the Java content tree.

Returns:

the newly created root object of the Java content tree. The content tree may be an instance of a class that is mapped to a XML root element (for example, annotated with XmlRootElement) or mapped to an XML type (for example, annotated with XmlType).

Throws:

JAXBException - if any unexpected errors occur while unmarshalling.

UnmarshalException - if the JsonUnmarshaller is unable to perform the JSON to Java binding.

unmarshalJAXBElementFromJSON

public <T> JAXBElement<T> unmarshalJAXBElementFromJSON(InputStream inputStream,
                                                       Class<T> declaredType)
                                            throws JAXBException

Description copied from interface: JettisonUnmarshaller

Unmarshal JSON data from the InputStream by declaredType and return the resulting content tree.

The UTF-8 character encoding scheme will be used to decode the encoded characters of the JSON data.

Specified by:

unmarshalJAXBElementFromJSON in interface JettisonUnmarshaller

Type Parameters:

T - the type of the Java content tree.

Parameters:

inputStream - the InputStream to unmarshal JSON data from.

declaredType - a class that is mapped to a XML root element (for example, annotated with XmlRootElement) or mapped to an XML type (for example, annotated with XmlType).

Returns:

the newly created root object of the Java content tree, root by a JAXBElement instance.

Throws:

JAXBException - if any unexpected errors occur while unmarshalling.

UnmarshalException - if the JsonUnmarshaller is unable to perform the JSON to Java binding.

unmarshalJAXBElementFromJSON

public <T> JAXBElement<T> unmarshalJAXBElementFromJSON(Reader reader,
                                                       Class<T> declaredType)
                                            throws JAXBException

Description copied from interface: JettisonUnmarshaller

Unmarshal JSON data from the Reader by declaredType and return the resulting content tree.

The character encoding scheme of the reader will be used to encode the characters of the JSON data.

Specified by:

unmarshalJAXBElementFromJSON in interface JettisonUnmarshaller

Type Parameters:

T - the type of the Java content tree.

Parameters:

reader - the Reader to unmarshal JSON data from.

declaredType - a class that is mapped to a XML root element (for example, annotated with XmlRootElement) or mapped to an XML type (for example, annotated with XmlType).

Returns:

the newly created root object of the Java content tree, root by a JAXBElement instance.

Throws:

JAXBException - if any unexpected errors occur while unmarshalling.

UnmarshalException - if the JsonUnmarshaller is unable to perform the JSON to Java binding.