com.sun.jersey.json.impl

Class BaseJSONUnmarshaller

java.lang.Object

com.sun.jersey.json.impl.BaseJSONUnmarshaller

All Implemented Interfaces:

JSONConfigurated, JSONUnmarshaller

Direct Known Subclasses:

JSONUnmarshallerImpl

public class BaseJSONUnmarshaller
extends Object
implements JSONUnmarshaller, JSONConfigurated

Author:

Jakub Podlesak (jakub.podlesak at oracle.com), Michal Gajdos (michal.gajdos at oracle.com)

Field Summary

Fields

Modifier and Type	Field and Description
protected Unmarshaller	jaxbUnmarshaller
protected JSONConfiguration	jsonConfig

Constructor Summary

Constructors

Constructor and Description
BaseJSONUnmarshaller(JAXBContext jaxbContext, JSONConfiguration jsonConfig)
BaseJSONUnmarshaller(Unmarshaller jaxbUnmarshaller, JAXBContext jaxbContext, JSONConfiguration jsonConfig)

Method Summary

Modifier and Type	Method and Description
JSONConfiguration	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 JSONConfiguration jsonConfig

Constructor Detail

BaseJSONUnmarshaller

public BaseJSONUnmarshaller(JAXBContext jaxbContext,
                            JSONConfiguration jsonConfig)
                     throws JAXBException

Throws:

JAXBException

BaseJSONUnmarshaller

public BaseJSONUnmarshaller(Unmarshaller jaxbUnmarshaller,
                            JAXBContext jaxbContext,
                            JSONConfiguration jsonConfig)

Method Detail

getJSONConfiguration

public JSONConfiguration getJSONConfiguration()

Description copied from interface: JSONConfigurated

Provides information on current JSON configuration options for this object.

Specified by:

getJSONConfiguration in interface JSONConfigurated

Returns:

a non-null JSONConfiguration instance.

unmarshalFromJSON

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

Description copied from interface: JSONUnmarshaller

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 JSONUnmarshaller

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: JSONUnmarshaller

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 JSONUnmarshaller

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: JSONUnmarshaller

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 JSONUnmarshaller

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: JSONUnmarshaller

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 JSONUnmarshaller

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.