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

javax.ws.rs.ext
Класс RuntimeDelegate

java.lang.Object
  javax.ws.rs.ext.RuntimeDelegate

public abstract class RuntimeDelegate
расширяет java.lang. Объект

Реализации JAX-РТС обеспечивают конкретный подкласс RuntimeDelegate, и различные методы API JAX-РТС подчиняются методам RuntimeDelegate для их функциональности. Обычные пользователи JAX-РТС, как ожидают, не будут использовать этот class непосредственно и переопределение реализации этого class с пользователем, предоставленный подкласс может вызвать неожиданное поведение.

Вложенная Сводка Класса

static interface

RuntimeDelegate.HeaderDelegate<T> Определяет контракт для делегата, который ответственен за преобразование между Строковой формой HTTP-заголовка и соответствующим типом JAX-РТС T.

Полевая Сводка

static java.lang.String

JAXRS_RUNTIME_DELEGATE_PROPERTY

Сводка конструктора

protected

RuntimeDelegate()

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

abstract <T> T	createEndpoint(Application application, java.lang.Class<T> endpointType) Создайте сконфигурированный экземпляр предоставленного типа конечной точки.
abstract <T> RuntimeDelegate.HeaderDelegate<T>	createHeaderDelegate(java.lang.Class<T> type) Получите экземпляр HeaderDelegate для предоставленного class.
abstract Response.ResponseBuilder	createResponseBuilder() Создайте новый экземпляр a Response.ResponseBuilder.
abstract UriBuilder	createUriBuilder() Создайте новый экземпляр a UriBuilder.
abstract Variant.VariantListBuilder	createVariantListBuilder() Создайте новый экземпляр a Variant.VariantListBuilder.
static RuntimeDelegate	getInstance() Получите экземпляр RuntimeDelegate.
static void	setInstance(RuntimeDelegate rd) Установите делегата времени выполнения, который будет использоваться классами JAX-РТС.

Методы, наследованные от class java.lang. Объект

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

Полевая Деталь

JAXRS_RUNTIME_DELEGATE_PROPERTY

public static final java.lang.String JAXRS_RUNTIME_DELEGATE_PROPERTY

См. Также:

Постоянные Значения полей

Деталь конструктора

RuntimeDelegate

protected RuntimeDelegate()

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

getInstance

public static RuntimeDelegate getInstance()

Получите экземпляр RuntimeDelegate. Если экземпляр не был уже создан и установлен через setInstance(javax.ws.rs.ext.RuntimeDelegate), первый вызов создаст экземпляр, который будет тогда кэшироваться для будущего использования.

Алгоритм, используемый, чтобы определить местоположение подкласса RuntimeDelegate, чтобы использовать, состоит из следующих шагов:

• Если ресурс с именем META-INF/services/javax.ws.rs.ext.RuntimeDelegate существует, тогда его первая строка, если есть используется в качестве UTF-8 закодированное имя реализации class.
• Если файл $java.home/lib/jaxrs.properties существует, и это читаемо java.util.Properties.load(InputStream) метод и это содержат запись, ключ которой javax.ws.rs.ext.RuntimeDelegate, тогда значение той записи используется в качестве имени реализации class.
• Если системное свойство с именем javax.ws.rs.ext.RuntimeDelegate определяется, тогда его значение используется в качестве имени реализации class.
• Наконец, реализация по умолчанию имя class используется.

Возвраты:

экземпляр RuntimeDelegate

setInstance

public static void setInstance(RuntimeDelegate rd)
                        throws java.lang.SecurityException

Установите делегата времени выполнения, который будет использоваться классами JAX-РТС. Если до этого метода не вызывают getInstance() тогда реализация будет разыскиваться как описано в getInstance().

Параметры:

rd - экземпляр делегата времени выполнения

Броски:

SecurityException - если есть менеджер безопасности и разрешение, ReflectPermission ("suppressAccessChecks") не предоставили.

createUriBuilder

public abstract UriBuilder createUriBuilder()

Создайте новый экземпляр a UriBuilder.

Возвраты:

новый экземпляр UriBuilder

См. Также:

UriBuilder

createResponseBuilder

public abstract Response.ResponseBuilder createResponseBuilder()

Создайте новый экземпляр a Response.ResponseBuilder.

Возвраты:

новый экземпляр ResponseBuilder

См. Также:

Response.ResponseBuilder

createVariantListBuilder

public abstract Variant.VariantListBuilder createVariantListBuilder()

Создайте новый экземпляр a Variant.VariantListBuilder.

Возвраты:

новый экземпляр VariantListBuilder

См. Также:

Variant.VariantListBuilder

createEndpoint

public abstract <T> T createEndpoint(Application application,
                                     java.lang.Class<T> endpointType)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.UnsupportedOperationException

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

Параметры:

application - конфигурация приложения

endpointType - тип экземпляра конечной точки, который будет создан.

Возвраты:

сконфигурированный экземпляр требуемого типа.

Броски:

java.lang.IllegalArgumentException - если приложение является нулем, или требуемый тип конечной точки не поддерживается.

java.lang.UnsupportedOperationException - если реализация не поддерживает типов конечной точки.

createHeaderDelegate

public abstract <T> RuntimeDelegate.HeaderDelegate<T> createHeaderDelegate(java.lang.Class<T> type)

Получите экземпляр HeaderDelegate для предоставленного class. Реализация обязана поддерживать следующие значения для типа: Cookie, CacheControl, EntityTag, NewCookie, MediaType и java.util.Date.

Параметры:

type - class заголовка

Возвраты:

экземпляр HeaderDelegate для предоставленного типа

Броски:

java.lang.IllegalArgumentException - если тип является нулем