Class AbstractRootElementJaxbProvider

java.lang.Object

org.glassfish.jersey.message.internal.AbstractMessageReaderWriterProvider<Object>

org.glassfish.jersey.jaxb.internal.AbstractJaxbProvider<Object>

org.glassfish.jersey.jaxb.internal.AbstractRootElementJaxbProvider

All Implemented Interfaces:

javax.ws.rs.ext.MessageBodyReader<Object>, javax.ws.rs.ext.MessageBodyWriter<Object>

Direct Known Subclasses:

XmlRootElementJaxbProvider

public abstract class AbstractRootElementJaxbProvider
extends AbstractJaxbProvider<Object>

An abstract provider for JAXB types that are annotated with XmlRootElement or XmlType.

Implementing classes may extend this class to provide specific marshalling and unmarshalling behaviour.

When unmarshalling a UnmarshalException will result in a WebApplicationException being thrown with a status of 400 (Client error), and a JAXBException will result in a WebApplicationException being thrown with a status of 500 (Internal Server error).

When marshalling a JAXBException will result in a WebApplicationException being thrown with a status of 500 (Internal Server error).

Field Summary

Fields inherited from class AbstractMessageReaderWriterProvider

UTF8

Constructor Summary

Constructors

Constructor	Description
AbstractRootElementJaxbProvider(javax.ws.rs.ext.Providers providers)	Inheritance constructor.
AbstractRootElementJaxbProvider(javax.ws.rs.ext.Providers providers, javax.ws.rs.core.MediaType resolverMediaType)	Inheritance constructor.

Method Summary

Modifier and Type	Method	Description
boolean	isReadable(Class<?> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType)
boolean	isWriteable(Class<?> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType)
final Object	readFrom(Class<Object> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType, javax.ws.rs.core.MultivaluedMap<String,String> httpHeaders, InputStream inputStream)
protected Object	readFrom(Class<Object> type, javax.ws.rs.core.MediaType mediaType, Unmarshaller u, InputStream entityStream)	Unmarshal a JAXB type.
final void	writeTo(Object t, Class<?> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType, javax.ws.rs.core.MultivaluedMap<String,Object> httpHeaders, OutputStream entityStream)
protected void	writeTo(Object t, javax.ws.rs.core.MediaType mediaType, Charset c, Marshaller m, OutputStream entityStream)	Marshal an instance of a JAXB type.

Methods inherited from class AbstractJaxbProvider

getMarshaller, getSAXSource, getStoredJaxbContext, getUnmarshaller, isFormattedOutput, isSupported, isXmlRootElementProcessing, setConfiguration, setHeader

Methods inherited from class AbstractMessageReaderWriterProvider

getCharset, getSize, readFromAsString, writeTo, writeTo, writeToAsString

Methods inherited from class Object

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

Constructor Details

AbstractRootElementJaxbProvider

public AbstractRootElementJaxbProvider(javax.ws.rs.ext.Providers providers)

Inheritance constructor.

Parameters:

providers - JAX-RS providers.

AbstractRootElementJaxbProvider

public AbstractRootElementJaxbProvider(javax.ws.rs.ext.Providers providers,
 javax.ws.rs.core.MediaType resolverMediaType)

Inheritance constructor.

Parameters:

providers - JAX-RS providers.

resolverMediaType - JAXB component context resolver media type to be used.

Method Details

isReadable

public boolean isReadable(Class<?> type,
 Type genericType,
 Annotation[] annotations,
 javax.ws.rs.core.MediaType mediaType)

isWriteable

public boolean isWriteable(Class<?> type,
 Type genericType,
 Annotation[] annotations,
 javax.ws.rs.core.MediaType mediaType)

readFrom

public final Object readFrom(Class<Object> type,
 Type genericType,
 Annotation[] annotations,
 javax.ws.rs.core.MediaType mediaType,
 javax.ws.rs.core.MultivaluedMap<String,String> httpHeaders,
 InputStream inputStream)
                      throws IOException

Throws:

IOException

readFrom

protected Object readFrom(Class<Object> type,
 javax.ws.rs.core.MediaType mediaType,
 Unmarshaller u,
 InputStream entityStream)
                   throws JAXBException

Unmarshal a JAXB type.

Implementing classes may override this method.

Parameters:

type - the JAXB type

mediaType - the media type

u - the unmarshaller to use for unmarshalling.

entityStream - the input stream to unmarshal from.

Returns:

an instance of the JAXB type.

Throws:

JAXBException - in case the JAXB unmarshalling fails.

writeTo

public final void writeTo(Object t,
 Class<?> type,
 Type genericType,
 Annotation[] annotations,
 javax.ws.rs.core.MediaType mediaType,
 javax.ws.rs.core.MultivaluedMap<String,Object> httpHeaders,
 OutputStream entityStream)
                   throws IOException

Throws:

IOException

writeTo

protected void writeTo(Object t,
 javax.ws.rs.core.MediaType mediaType,
 Charset c,
 Marshaller m,
 OutputStream entityStream)
                throws JAXBException

Marshal an instance of a JAXB type.

Implementing classes may override this method.

Parameters:

t - the instance of the JAXB type.

mediaType - the media type.

c - the character set to serialize characters to.

m - the marshaller to marshaller the instance of the JAXB type.

entityStream - the output stream to marshal to.

Throws:

JAXBException - in case the JAXB marshalling fails.