org.glassfish.jersey.message.internal
Class MessageBodyFactory

java.lang.Object
  org.glassfish.jersey.message.internal.MessageBodyFactory

All Implemented Interfaces:

MessageBodyWorkers

public class MessageBodyFactory
extends java.lang.Object
implements MessageBodyWorkers

A factory for managing MessageBodyReader and MessageBodyWriter instances.

Note: MessageBodyReader and MessageBodyWriter implementation must not inject the instance of this type directly, e.g. @Inject MessageBodyWorkers w;. Instead a Factory-based injection should be used to prevent cycles in the injection framework caused by the eager initialization of the providers in the current factory implementation: @Inject Factory<MessageBodyWorkers> w;

Author:

Paul Sandoz, Marek Potociar (marek.potociar at oracle.com), Jakub Podlesak (jakub.podlesak at oracle.com)

Nested Class Summary

static class

MessageBodyFactory.Module

Nested classes/interfaces inherited from interface org.glassfish.jersey.message.MessageBodyWorkers

MessageBodyWorkers.MessageBodySizeCallback

Field Summary

static KeyComparator<MediaType>

MEDIA_TYPE_COMPARATOR

Constructor Summary

MessageBodyFactory(ServiceProviders serviceProviders)

Method Summary

<T> MessageBodyReader<T>	getMessageBodyReader(java.lang.Class<T> c, java.lang.reflect.Type t, java.lang.annotation.Annotation[] as, MediaType mediaType) Get a message body reader that matches a set of criteria.
<T> java.util.List<MediaType>	getMessageBodyReaderMediaTypes(java.lang.Class<T> type, java.lang.reflect.Type genericType, java.lang.annotation.Annotation[] annotations) Get the list of media types supported for a Java type.
<T> MessageBodyWriter<T>	getMessageBodyWriter(java.lang.Class<T> c, java.lang.reflect.Type t, java.lang.annotation.Annotation[] as, MediaType mediaType) Get a message body writer that matches a set of criteria.
<T> MediaType	getMessageBodyWriterMediaType(java.lang.Class<T> c, java.lang.reflect.Type t, java.lang.annotation.Annotation[] as, java.util.List<MediaType> acceptableMediaTypes) Get the most acceptable media type supported for a Java type given a set of acceptable media types.
<T> java.util.List<MediaType>	getMessageBodyWriterMediaTypes(java.lang.Class<T> c, java.lang.reflect.Type t, java.lang.annotation.Annotation[] as) Get the list of media types supported for a Java type.
java.util.Set<ReaderInterceptor>	getReaderInterceptors() Returns global reader interceptors.
java.util.Map<MediaType,java.util.List<MessageBodyReader>>	getReaders(MediaType mediaType) Get the map of media type to list of message body writers that are compatible with a media type.
java.util.Set<WriterInterceptor>	getWriterInterceptors() Returns global writer interceptors.
java.util.Map<MediaType,java.util.List<MessageBodyWriter>>	getWriters(MediaType mediaType) Get the map of media type to list of message body writers that are compatible with a media type.
java.lang.String	readersToString(java.util.Map<MediaType,java.util.List<MessageBodyReader>> readers) Convert a map media type to list of message body readers to a string.
<T> java.lang.Object	readFrom(GenericType<T> genericType, java.lang.annotation.Annotation[] annotations, MediaType mediaType, MultivaluedMap<java.lang.String,java.lang.String> httpHeaders, java.util.Map<java.lang.String,java.lang.Object> properties, java.io.InputStream entityStream, boolean intercept) Reads a type from the entityStream using interceptors.
java.lang.String	writersToString(java.util.Map<MediaType,java.util.List<MessageBodyWriter>> writers) Convert a map media type to list of message body writers to a string.
<T> void	writeTo(java.lang.Object t, GenericType<T> genericType, java.lang.annotation.Annotation[] annotations, MediaType mediaType, MultivaluedMap<java.lang.String,java.lang.Object> httpHeaders, java.util.Map<java.lang.String,java.lang.Object> properties, java.io.OutputStream entityStream, MessageBodyWorkers.MessageBodySizeCallback sizeCallback, boolean intercept) Writers a type to the entityStream using interceptors.
<T> void	writeTo(java.lang.Object t, GenericType<T> genericType, java.lang.annotation.Annotation[] annotations, MediaType mediaType, MultivaluedMap<java.lang.String,java.lang.Object> httpHeaders, java.util.Map<java.lang.String,java.lang.Object> properties, java.io.OutputStream entityStream, MessageBodyWorkers.MessageBodySizeCallback sizeCallback, boolean intercept, boolean writeEntity) Writers a type to the entityStream using interceptors.

Methods inherited from class java.lang.Object

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

Field Detail

MEDIA_TYPE_COMPARATOR

public static final KeyComparator<MediaType> MEDIA_TYPE_COMPARATOR

Constructor Detail

MessageBodyFactory

public MessageBodyFactory(ServiceProviders serviceProviders)

Method Detail

getReaderInterceptors

public java.util.Set<ReaderInterceptor> getReaderInterceptors()

Description copied from interface: MessageBodyWorkers

Returns global reader interceptors.

Specified by:

getReaderInterceptors in interface MessageBodyWorkers

Returns:

Reader interceptors.

getWriterInterceptors

public java.util.Set<WriterInterceptor> getWriterInterceptors()

Description copied from interface: MessageBodyWorkers

Returns global writer interceptors.

Specified by:

getWriterInterceptors in interface MessageBodyWorkers

Returns:

Writer interceptors.

getReaders

public java.util.Map<MediaType,java.util.List<MessageBodyReader>> getReaders(MediaType mediaType)

Description copied from interface: MessageBodyWorkers

Get the map of media type to list of message body writers that are compatible with a media type.

Specified by:

getReaders in interface MessageBodyWorkers

Parameters:

mediaType - the compatible media type.

Returns:

the map of media type to list of message body writers.

getWriters

public java.util.Map<MediaType,java.util.List<MessageBodyWriter>> getWriters(MediaType mediaType)

Description copied from interface: MessageBodyWorkers

Get the map of media type to list of message body writers that are compatible with a media type.

Specified by:

getWriters in interface MessageBodyWorkers

Parameters:

mediaType - the compatible media type.

Returns:

the map of media type to list of message body writers.

readersToString

public java.lang.String readersToString(java.util.Map<MediaType,java.util.List<MessageBodyReader>> readers)

Description copied from interface: MessageBodyWorkers

Convert a map media type to list of message body readers to a string.

Specified by:

readersToString in interface MessageBodyWorkers

Parameters:

readers - the map media type to list of message body readers

Returns:

the string representation.

writersToString

public java.lang.String writersToString(java.util.Map<MediaType,java.util.List<MessageBodyWriter>> writers)

Description copied from interface: MessageBodyWorkers

Convert a map media type to list of message body writers to a string.

Specified by:

writersToString in interface MessageBodyWorkers

Parameters:

writers - the map media type to list of message body readers

Returns:

the string representation.

getMessageBodyReader

public <T> MessageBodyReader<T> getMessageBodyReader(java.lang.Class<T> c,
                                                     java.lang.reflect.Type t,
                                                     java.lang.annotation.Annotation[] as,
                                                     MediaType mediaType)

Description copied from interface: MessageBodyWorkers

Get a message body reader that matches a set of criteria.

Specified by:

getMessageBodyReader in interface MessageBodyWorkers

Type Parameters:

T - the type of object to be read.

Parameters:

c - the class of object to be read.

t - the type of object to be produced. E.g. if the message body is to be converted into a method parameter, this will be the formal type of the method parameter as returned by Class.getGenericParameterTypes.

as - an array of the annotations on the declaration of the artifact that will be initialized with the produced instance. E.g. if the message body is to be converted into a method parameter, this will be the annotations on that parameter returned by Class.getParameterAnnotations.

mediaType - the media type of the data that will be read, this will be compared to the values of Consumes for each candidate reader and only matching readers will be queried.

Returns:

a MessageBodyReader that matches the supplied criteria or null if none is found.

getMessageBodyReaderMediaTypes

public <T> java.util.List<MediaType> getMessageBodyReaderMediaTypes(java.lang.Class<T> type,
                                                                    java.lang.reflect.Type genericType,
                                                                    java.lang.annotation.Annotation[] annotations)

Description copied from interface: MessageBodyWorkers

Get the list of media types supported for a Java type.

Specified by:

getMessageBodyReaderMediaTypes in interface MessageBodyWorkers

Type Parameters:

T - the type of object that is to be read.

Parameters:

type - the class of object that is to be read.

genericType - the type of object to be read. E.g. if the message body is to be read as a method parameter, this will be the declared type of the parameter as returned by Method.getGenericParameterTypes.

annotations - an array of the annotations on the declaration of the artifact that will be read. E.g. if the message body is to be consumed as a method parameter, this will be the annotations on that parameter returned by Method.getParameterAnnotations.

Returns:

the list of supported media types, the list is ordered as follows: a/b < a/* < \*\/*

getMessageBodyWriter

public <T> MessageBodyWriter<T> getMessageBodyWriter(java.lang.Class<T> c,
                                                     java.lang.reflect.Type t,
                                                     java.lang.annotation.Annotation[] as,
                                                     MediaType mediaType)

Description copied from interface: MessageBodyWorkers

Get a message body writer that matches a set of criteria.

Specified by:

getMessageBodyWriter in interface MessageBodyWorkers

Type Parameters:

T - the type of the object that is to be written.

Parameters:

c - the class of object that is to be written.

t - the type of object to be written. E.g. if the message body is to be produced from a field, this will be the declared type of the field as returned by Field.getGenericType.

as - an array of the annotations on the declaration of the artifact that will be written. E.g. if the message body is to be produced from a field, this will be the annotations on that field returned by Field.getDeclaredAnnotations.

mediaType - the media type of the data that will be written, this will be compared to the values of Produces for each candidate writer and only matching writers will be queried.

Returns:

a MessageBodyReader that matches the supplied criteria or null if none is found.

getMessageBodyWriterMediaTypes

public <T> java.util.List<MediaType> getMessageBodyWriterMediaTypes(java.lang.Class<T> c,
                                                                    java.lang.reflect.Type t,
                                                                    java.lang.annotation.Annotation[] as)

Description copied from interface: MessageBodyWorkers

Get the list of media types supported for a Java type.

Specified by:

getMessageBodyWriterMediaTypes in interface MessageBodyWorkers

Type Parameters:

T - the type of object that is to be written.

Parameters:

c - the class of object that is to be written.

t - the type of object to be written. E.g. if the message body is to be produced from a field, this will be the declared type of the field as returned by Field.getGenericType.

as - an array of the annotations on the declaration of the artifact that will be written. E.g. if the message body is to be produced from a field, this will be the annotations on that field returned by Field.getDeclaredAnnotations.

Returns:

the list of supported media types, the list is ordered as follows: a/b < a/* < \*\/*

getMessageBodyWriterMediaType

public <T> MediaType getMessageBodyWriterMediaType(java.lang.Class<T> c,
                                                   java.lang.reflect.Type t,
                                                   java.lang.annotation.Annotation[] as,
                                                   java.util.List<MediaType> acceptableMediaTypes)

Description copied from interface: MessageBodyWorkers

Get the most acceptable media type supported for a Java type given a set of acceptable media types.

Specified by:

getMessageBodyWriterMediaType in interface MessageBodyWorkers

Type Parameters:

T - the type of object that is to be written.

Parameters:

c - the class of object that is to be written.

t - the type of object to be written. E.g. if the message body is to be produced from a field, this will be the declared type of the field as returned by Field.getGenericType.

as - an array of the annotations on the declaration of the artifact that will be written. E.g. if the message body is to be produced from a field, this will be the annotations on that field returned by Field.getDeclaredAnnotations.

acceptableMediaTypes - the list of acceptable media types, sorted according to the quality with the media type of highest quality occurring first first.

Returns:

the best media types

readFrom

public <T> java.lang.Object readFrom(GenericType<T> genericType,
                                     java.lang.annotation.Annotation[] annotations,
                                     MediaType mediaType,
                                     MultivaluedMap<java.lang.String,java.lang.String> httpHeaders,
                                     java.util.Map<java.lang.String,java.lang.Object> properties,
                                     java.io.InputStream entityStream,
                                     boolean intercept)
                          throws WebApplicationException,
                                 java.io.IOException

Description copied from interface: MessageBodyWorkers

Reads a type from the entityStream using interceptors. If the parameter intercept is true then reader interceptors are excecuted before calling the message body reader. The appropriate message body reader is choosen after the interceptor execution based on parameter passed to this method and modified by the interceptors.

Specified by:

readFrom in interface MessageBodyWorkers

Parameters:

genericType - the generic type that is to be read from the input stream.

annotations - an array of the annotations on the declaration of the artifact that will be initialized with the produced instance. E.g. if the message body is to be converted into a method parameter, this will be the annotations on that parameter returned by Method.getParameterAnnotations.

mediaType - the media type of the HTTP entity.

httpHeaders - the mutable HTTP headers associated with HTTP entity.

properties - the mutable map of request-scoped properties.

entityStream - the InputStream of the HTTP entity. The stream is not closed after reading the entity.

intercept - true if the user interceptors should be executed. Otherwise only exception wrapping interceptor will be executed in the client.

Returns:

the entity that was read from the entityStream.

Throws:

WebApplicationException - Thrown when message body reader fails.

java.io.IOException - Thrown when reading from the entityStream fails.

writeTo

public <T> void writeTo(java.lang.Object t,
                        GenericType<T> genericType,
                        java.lang.annotation.Annotation[] annotations,
                        MediaType mediaType,
                        MultivaluedMap<java.lang.String,java.lang.Object> httpHeaders,
                        java.util.Map<java.lang.String,java.lang.Object> properties,
                        java.io.OutputStream entityStream,
                        MessageBodyWorkers.MessageBodySizeCallback sizeCallback,
                        boolean intercept)
             throws java.io.IOException,
                    WebApplicationException

Description copied from interface: MessageBodyWorkers

Writers a type to the entityStream using interceptors. If the parameter intercept is true then writer interceptors are excecuted before calling the message body writer. The appropriate message body writer is choosen after the interceptor execution based on parameter passed to this method and modified by the interceptors.

Specified by:

writeTo in interface MessageBodyWorkers

Parameters:

t - Entity to be written to the entityStream

genericType - the generic type to be written into the entityStream.

annotations - an array of the annotations on the resource method that returns the object.

mediaType - the media type of the HTTP entity.

httpHeaders - the mutable HTTP headers associated with HTTP entity.

properties - the mutable map of request-scoped properties.

entityStream - the OutputStream for the HTTP entity.

sizeCallback - the MessageBodyWorkers.MessageBodySizeCallback which will be invoked to pass the size of the written entity. The callback will be invoked before the first byte is written to the entityStream.

intercept - true if the user interceptors should be executed. Otherwise only exception wrapping interceptor will be executed in the client.

Throws:

java.io.IOException - Thrown when reading from the entityStream fails.

WebApplicationException - Thrown when message body reader fails.

writeTo

public <T> void writeTo(java.lang.Object t,
                        GenericType<T> genericType,
                        java.lang.annotation.Annotation[] annotations,
                        MediaType mediaType,
                        MultivaluedMap<java.lang.String,java.lang.Object> httpHeaders,
                        java.util.Map<java.lang.String,java.lang.Object> properties,
                        java.io.OutputStream entityStream,
                        MessageBodyWorkers.MessageBodySizeCallback sizeCallback,
                        boolean intercept,
                        boolean writeEntity)
             throws java.io.IOException,
                    WebApplicationException

Description copied from interface: MessageBodyWorkers

Writers a type to the entityStream using interceptors. If the parameter intercept is true then writer interceptors are excecuted before calling the message body writer. The appropriate message body writer is choosen after the interceptor execution based on parameter passed to this method and modified by the interceptors.

Specified by:

writeTo in interface MessageBodyWorkers

Parameters:

t - Entity to be written to the entityStream

genericType - the generic type to be written into the entityStream.

annotations - an array of the annotations on the resource method that returns the object.

mediaType - the media type of the HTTP entity.

httpHeaders - the mutable HTTP headers associated with HTTP entity.

properties - the mutable map of request-scoped properties.

entityStream - the OutputStream for the HTTP entity.

sizeCallback - the MessageBodyWorkers.MessageBodySizeCallback which will be invoked to pass the size of the written entity. The callback will be invoked before the first byte is written to the entityStream.

intercept - true if the user interceptors should be executed. Otherwise only exception wrapping interceptor will be executed in the client.

writeEntity - true if the entity should be written. Otherwise only headers will be written to underlying OutputStream.

Throws:

java.io.IOException - Thrown when reading from the entityStream fails.

WebApplicationException - Thrown when message body reader fails.