Spec-Zone .ru спецификации, руководства, описания, API

javax.ws.rs.ext
Провайдеры интерфейса

public interface Providers

Вводимый интерфейс, обеспечивающий поиск времени выполнения экземпляров провайдера.

См. Также:

Context, MessageBodyReader, MessageBodyWriter, ContextResolver, ExceptionMapper

Сводка метода

<T> ContextResolver<T>	getContextResolver(java.lang.Class<T> contextType, MediaType mediaType) Получите преобразователь контекста для определенного типа контекста и типа носителей.
<T extends java.lang.Throwable> ExceptionMapper<T>	getExceptionMapper(java.lang.Class<T> type) Получите провайдера отображения исключения для определенного class исключения.
<T> MessageBodyReader<T>	getMessageBodyReader(java.lang.Class<T> type, java.lang.reflect.Type genericType, java.lang.annotation.Annotation[] annotations, MediaType mediaType) Получите читателя текста сообщения, который соответствует ряд критериев.
<T> MessageBodyWriter<T>	getMessageBodyWriter(java.lang.Class<T> type, java.lang.reflect.Type genericType, java.lang.annotation.Annotation[] annotations, MediaType mediaType) Получите писателя текста сообщения, который соответствует ряд критериев.

Деталь метода

getMessageBodyReader

<T> MessageBodyReader<T> getMessageBodyReader(java.lang.Class<T> type,
                                              java.lang.reflect.Type genericType,
                                              java.lang.annotation.Annotation[] annotations,
                                              MediaType mediaType)

Получите читателя текста сообщения, который соответствует ряд критериев. Группа читателей сначала фильтруется, сравнивая предоставленное значение mediaType со значением каждого читателя Consumes, обеспечение предоставленного значения type присваиваемо универсальному типу читателя, и устраняющий тех, которые не соответствуют. Список соответствия читателей тогда упорядочивается с теми с лучшими совпадающими значениями Consumes (x/y> x/*> */*) сортированный сначала. Наконец, MessageBodyReader#isReadable метод вызывают на каждом читателе в порядке, используя предоставленные критерии и первого читателя, который возвращается true выбирается и возвращается.

Параметры:

type - class объекта, который должен быть считан.

genericType - тип объекта, который будет произведен. Например, если текст сообщения должен быть преобразован в параметр метода, это будет формальным типом параметра метода как возвращено Class.getGenericParameterTypes.

annotations - массив аннотаций на объявление артефакта, который будет инициализирован с произведенным экземпляром. Например, если текст сообщения должен быть преобразован в параметр метода, это будет аннотациями на тот параметр, возвращенный Class.getParameterAnnotations.

mediaType - тип носителей данных, которые будут считаны.

Возвраты:

MessageBodyReader, который соответствует предоставленные критерии или нуль, если ни один не находится.

getMessageBodyWriter

<T> MessageBodyWriter<T> getMessageBodyWriter(java.lang.Class<T> type,
                                              java.lang.reflect.Type genericType,
                                              java.lang.annotation.Annotation[] annotations,
                                              MediaType mediaType)

Получите писателя текста сообщения, который соответствует ряд критериев. Группа писателей сначала фильтруется, сравнивая предоставленное значение mediaType со значением каждого писателя Produces, обеспечение предоставленного значения type присваиваемо универсальному типу читателя, и устраняющий тех, которые не соответствуют. Список соответствия писателей тогда упорядочивается с теми с лучшими совпадающими значениями Produces (x/y> x/*> */*) сортированный сначала. Наконец, MessageBodyWriter#isWriteable метод вызывают на каждом писателе в порядке, используя предоставленные критерии и первого писателя, который возвращается true выбирается и возвращается.

Параметры:

type - class объекта, который должен быть записан.

genericType - тип объекта, который будет записан. Например, если текст сообщения должен быть произведен из поля, это будет объявленным типом поля как возвращено Field.getGenericType.

annotations - массив аннотаций на объявление артефакта, который будет записан. Например, если текст сообщения должен быть произведен из поля, это будет аннотациями на то поле, возвращенное Field.getDeclaredAnnotations.

mediaType - тип носителей данных, которые будут записаны.

Возвраты:

MessageBodyReader, который соответствует предоставленные критерии или нуль, если ни один не находится.

getExceptionMapper

<T extends java.lang.Throwable> ExceptionMapper<T> getExceptionMapper(java.lang.Class<T> type)

Получите провайдера отображения исключения для определенного class исключения. Возвращает провайдера, универсальный тип которого является самым близким суперклассом type.

Параметры:

type - class исключения

Возвраты:

ExceptionMapper для предоставленного типа или нуля, если ни один не находится.

getContextResolver

<T> ContextResolver<T> getContextResolver(java.lang.Class<T> contextType,
                                          MediaType mediaType)

Получите преобразователь контекста для определенного типа контекста и типа носителей. Набор преобразователей сначала фильтруется, сравнивая предоставленное значение mediaType со значением каждого преобразователя Produces, обеспечение универсального типа преобразователя контекста присваиваемо предоставленному значению contextType, и устранение тех, которые не соответствуют. Если только один преобразователь соответствует критерии тогда, он возвращается. Если больше чем один преобразователь соответствует тогда, список соответствия преобразователей упорядочивается с теми с лучшими совпадающими значениями Produces (x/y> x/*> */*) сортированный сначала. Прокси возвращается, который делегирует звонки ContextResolver#getContext(java.lang.Class) к каждому преобразователю контекста соответствия в порядке и возвратах первое ненулевое значение это получает или нуль, если все преобразователи контекста соответствия возвращают нуль.

Параметры:

contextType - class контекста требуется

mediaType - тип носителей данных, для которых требуется контекст.

Возвраты:

соответствующий экземпляр преобразователя контекста или нуль, если никакие провайдеры контекста соответствия не находятся.