com.sun.jersey.spi

Interface MessageBodyWorkers

All Known Implementing Classes:

MessageBodyFactory

public interface MessageBodyWorkers

An injectable interface providing lookup of MessageBodyReader and MessageBodyWriter instances.

Author:

Paul.Sandoz@Sun.Com

See Also:

Context, MessageBodyReader, MessageBodyWriter

Method Summary

Modifier and Type	Method and Description
<T> javax.ws.rs.ext.MessageBodyReader<T>	getMessageBodyReader(Class<T> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType) Get a message body reader that matches a set of criteria.
<T> javax.ws.rs.ext.MessageBodyWriter<T>	getMessageBodyWriter(Class<T> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType) Get a message body writer that matches a set of criteria.
<T> javax.ws.rs.core.MediaType	getMessageBodyWriterMediaType(Class<T> type, Type genericType, Annotation[] annotations, List<javax.ws.rs.core.MediaType> acceptableMediaTypes) Get the most acceptable media type supported for a Java type given a set of acceptable media types.
<T> List<javax.ws.rs.core.MediaType>	getMessageBodyWriterMediaTypes(Class<T> type, Type genericType, Annotation[] annotations) Get the list of media types supported for a Java type.
Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyReader>>	getReaders(javax.ws.rs.core.MediaType mediaType) Get the map of media type to list of message body writers that are compatible with a media type.
Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyWriter>>	getWriters(javax.ws.rs.core.MediaType mediaType) Get the map of media type to list of message body writers that are compatible with a media type.
String	readersToString(Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyReader>> readers) Convert a map media type to list of message body readers to a string.
String	writersToString(Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyWriter>> writers) Convert a map media type to list of message body writers to a string.

Method Detail

getReaders

Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyReader>> getReaders(javax.ws.rs.core.MediaType mediaType)

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

Parameters:

mediaType - the compatible media type.

Returns:

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

getWriters

Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyWriter>> getWriters(javax.ws.rs.core.MediaType mediaType)

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

Parameters:

mediaType - the compatible media type.

Returns:

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

readersToString

String readersToString(Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyReader>> readers)

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

Parameters:

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

Returns:

the string representation.

writersToString

String writersToString(Map<javax.ws.rs.core.MediaType,List<javax.ws.rs.ext.MessageBodyWriter>> writers)

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

Parameters:

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

Returns:

the string representation.

getMessageBodyReader

<T> javax.ws.rs.ext.MessageBodyReader<T> getMessageBodyReader(Class<T> type,
                                                              Type genericType,
                                                              Annotation[] annotations,
                                                              javax.ws.rs.core.MediaType mediaType)

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

Type Parameters:

T - the type of object to be read.

Parameters:

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.

type - the class of object to be read.

genericType - 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.

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 Class.getParameterAnnotations.

Returns:

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

getMessageBodyWriter

<T> javax.ws.rs.ext.MessageBodyWriter<T> getMessageBodyWriter(Class<T> type,
                                                              Type genericType,
                                                              Annotation[] annotations,
                                                              javax.ws.rs.core.MediaType mediaType)

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

Type Parameters:

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

Parameters:

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.

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

genericType - 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.

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

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

getMessageBodyWriterMediaTypes

<T> List<javax.ws.rs.core.MediaType> getMessageBodyWriterMediaTypes(Class<T> type,
                                                                    Type genericType,
                                                                    Annotation[] annotations)

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

Type Parameters:

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

Parameters:

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

genericType - 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.

annotations - 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

<T> javax.ws.rs.core.MediaType getMessageBodyWriterMediaType(Class<T> type,
                                                             Type genericType,
                                                             Annotation[] annotations,
                                                             List<javax.ws.rs.core.MediaType> acceptableMediaTypes)

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

Type Parameters:

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

Parameters:

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

genericType - 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.

annotations - 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