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

javax.xml.ws
Конечная точка класса

java.lang.Object
  javax.xml.ws.Endpoint

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

Конечная точка Веб-сервиса.

Конечные точки создаются, используя статические методы, определенные в этом class. Конечная точка всегда связывается к одному Binding и один конструктор, оба набора во время создания конечной точки.

Конечная точка или в опубликованном или в неопубликованном состоянии. publish методы могут использоваться, чтобы начать публиковать конечную точку, в которой точке это начинает принимать входящие запросы. Наоборот, stop метод может использоваться, чтобы прекратить принять входящие запросы и приводить в нерабочее состояние конечную точку. После того, как остановленный, конечная точка не может быть опубликована снова.

Executor может быть установлен на конечной точке, чтобы получить лучший контроль над потоками, используемыми, чтобы диспетчеризировать входящие запросы. Например, объединение в пул потока с определенными параметрами может быть включено, создавая a ThreadPoolExecutor и регистрация этого с конечной точкой.

Цепочки обработчика могут быть установлены, используя содержавший Binding.

У конечной точки может быть список документов метаданных, таких как WSDL и документы XMLSchema, связанные с этим. При публикации времени реализация JAX-WS попытается снова использовать так много тех метаданных насколько возможно вместо того, чтобы генерировать новые, основанные на подарке аннотаций на конструкторе.

С тех пор:

JAX-WS 2.0

См. Также:

Binding, BindingType, SOAPBinding, Executor

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

static java.lang.String	WSDL_PORT Стандартное свойство: имя порта WSDL.
static java.lang.String	WSDL_SERVICE Стандартное свойство: имя службы WSDL.

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

Endpoint()

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

static Endpoint	create(java.lang.Object implementor) Создает конечную точку с указанным объектом конструктора.
static Endpoint	create(java.lang.Object implementor, WebServiceFeature... features) Создает конечную точку с указанным объектом конструктора и функциями веб-сервиса.
static Endpoint	create(java.lang.String bindingId, java.lang.Object implementor) Создает конечную точку с указанным обязательным типом и объектом конструктора.
static Endpoint	create(java.lang.String bindingId, java.lang.Object implementor, WebServiceFeature... features) Создает конечную точку с указанным обязательным типом, объектом конструктора, и функциями веб-сервиса.
abstract Binding	getBinding() Возвращает привязку для этой конечной точки.
abstract <T extends EndpointReference> T	getEndpointReference(java.lang.Class<T> clazz, org.w3c.dom.Element... referenceParameters) Возвраты EndpointReference связанный с этим Endpoint экземпляр.
abstract EndpointReference	getEndpointReference(org.w3c.dom.Element... referenceParameters) Возвраты EndpointReference связанный с этим Endpoint экземпляр.
abstract java.util.concurrent.Executor	getExecutor() Возвращает исполнителя для этого Endpointэкземпляр.
abstract java.lang.Object	getImplementor() Возвращает объект реализации для этой конечной точки.
abstract java.util.List<javax.xml.transform.Source>	getMetadata() Возвращает список документов метаданных для службы.
abstract java.util.Map<java.lang.String,java.lang.Object>	getProperties() Возвращает набор свойств для этого Endpoint экземпляр.
abstract boolean	isPublished() Возвращает true, если конечная точка находится в опубликованном состоянии.
void	publish(HttpContext serverContext) Публикует эту конечную точку в обеспеченном контексте сервера.
abstract void	publish(java.lang.Object serverContext) Публикует эту конечную точку в обеспеченном контексте сервера.
abstract void	publish(java.lang.String address) Публикует эту конечную точку в данном адресе.
static Endpoint	publish(java.lang.String address, java.lang.Object implementor) Создает и публикует конечную точку для указанного объекта конструктора в данном адресе.
static Endpoint	publish(java.lang.String address, java.lang.Object implementor, WebServiceFeature... features) Создает и публикует конечную точку для указанного объекта конструктора в данном адресе.
void	setEndpointContext(EndpointContext ctxt) settng a EndpointContext, Время выполнения JAX-WS знает об адресах других конечных точек в приложении.
abstract void	setExecutor(java.util.concurrent.Executor executor) Устанавливает исполнителя для этого Endpoint экземпляр.
abstract void	setMetadata(java.util.List<javax.xml.transform.Source> metadata) Устанавливает метаданные для этой конечной точки.
abstract void	setProperties(java.util.Map<java.lang.String,java.lang.Object> properties) Устанавливает набор свойств для этого Endpoint экземпляр.
abstract void	stop() Остановки, публикующие эту конечную точку.

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

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

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

WSDL_SERVICE

public static final java.lang.String WSDL_SERVICE

Стандартное свойство: имя службы WSDL.

Введите: javax.xml.namespace. QName

См. Также:

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

WSDL_PORT

public static final java.lang.String WSDL_PORT

Стандартное свойство: имя порта WSDL.

Введите: javax.xml.namespace. QName

См. Также:

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

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

Конечная точка

public Endpoint()

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

создать

public static Endpoint create(java.lang.Object implementor)

Создает конечную точку с указанным объектом конструктора. Если есть привязка, определенная через аннотацию BindingType тогда, она еще ДОЛЖНА использоваться значение по умолчанию SOAP 1.1 / HTTP-связывание ДОЛЖНО использоваться.

Недавно создаваемая конечная точка может быть опубликована, вызывая один из publish(String) и publish(Object) методы.

Параметры:

implementor - Конструктор конечной точки.

Возвраты:

Недавно создаваемая конечная точка.

создать

public static Endpoint create(java.lang.Object implementor,
                              WebServiceFeature... features)

Создает конечную точку с указанным объектом конструктора и функциями веб-сервиса. Если есть привязка, определенная через аннотацию BindingType тогда, она еще ДОЛЖНА использоваться значение по умолчанию SOAP 1.1 / HTTP-связывание ДОЛЖНО использоваться.

Недавно создаваемая конечная точка может быть опубликована, вызывая один из publish(String) и publish(Object) методы.

Параметры:

implementor - Конструктор конечной точки.

features - Список WebServiceFeature, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.

Возвраты:

Недавно создаваемая конечная точка.

С тех пор:

JAX-WS 2.2

создать

public static Endpoint create(java.lang.String bindingId,
                              java.lang.Object implementor)

Создает конечную точку с указанным обязательным типом и объектом конструктора.

Недавно создаваемая конечная точка может быть опубликована, вызывая один из publish(String) и publish(Object) методы.

Параметры:

bindingId - URI, определяющий привязку, чтобы использовать. Если bindingID null и никакая привязка не определяется через аннотацию BindingType тогда значение по умолчанию SOAP 1.1 / HTTP-связывание ДОЛЖНО использоваться.

implementor - Конструктор конечной точки.

Возвраты:

Недавно создаваемая конечная точка.

создать

public static Endpoint create(java.lang.String bindingId,
                              java.lang.Object implementor,
                              WebServiceFeature... features)

Создает конечную точку с указанным обязательным типом, объектом конструктора, и функциями веб-сервиса.

Недавно создаваемая конечная точка может быть опубликована, вызывая один из publish(String) и publish(Object) методы.

Параметры:

bindingId - URI, определяющий привязку, чтобы использовать. Если bindingID null и никакая привязка не определяется через аннотацию BindingType тогда значение по умолчанию SOAP 1.1 / HTTP-связывание ДОЛЖНО использоваться.

implementor - Конструктор конечной точки.

features - Список WebServiceFeature, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.

Возвраты:

Недавно создаваемая конечная точка.

С тех пор:

JAX-WS 2.2

getBinding

public abstract Binding getBinding()

Возвращает привязку для этой конечной точки.

Возвраты:

Привязка для этой конечной точки

getImplementor

public abstract java.lang.Object getImplementor()

Возвращает объект реализации для этой конечной точки.

Возвраты:

Конструктор для этой конечной точки

опубликовать

public abstract void publish(java.lang.String address)

Публикует эту конечную точку в данном адресе. Необходимая инфраструктура сервера будет создаваться и конфигурироваться реализацией JAX-WS, используя некоторую конфигурацию значения по умолчанию. Чтобы получить больше контроля над конфигурацией сервера, пожалуйста, используйте publish(Object) метод вместо этого.

Параметры:

address - URI, определяющий адрес, чтобы использовать. Адрес ДОЛЖЕН быть совместимым с привязкой, определенной в то время, когда конечная точка создавалась.

Броски:

java.lang.IllegalArgumentException - Если обеспеченный URI адреса не применим в соединении с обязательной конечной точкой.

java.lang.IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.

java.lang.SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.

опубликовать

public static Endpoint publish(java.lang.String address,
                               java.lang.Object implementor)

Создает и публикует конечную точку для указанного объекта конструктора в данном адресе.

Необходимая инфраструктура сервера будет создаваться и конфигурироваться реализацией JAX-WS, используя некоторую конфигурацию значения по умолчанию. Чтобы получить больше контроля над конфигурацией сервера, пожалуйста, используйте create(String,Object) и publish(Object) методы вместо этого.

Параметры:

address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.

implementor - Конструктор конечной точки.

Возвраты:

Недавно создаваемая конечная точка.

Броски:

java.lang.SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.

опубликовать

public static Endpoint publish(java.lang.String address,
                               java.lang.Object implementor,
                               WebServiceFeature... features)

Создает и публикует конечную точку для указанного объекта конструктора в данном адресе. Создаваемая конечная точка конфигурируется с функциями веб-сервиса.

Необходимая инфраструктура сервера будет создаваться и конфигурироваться реализацией JAX-WS, используя некоторую конфигурацию значения по умолчанию. Чтобы получить больше контроля над конфигурацией сервера, пожалуйста, используйте create(String,Object) и publish(Object) методы вместо этого.

Параметры:

address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.

implementor - Конструктор конечной точки.

features - Список WebServiceFeature, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.

Возвраты:

Недавно создаваемая конечная точка.

Броски:

java.lang.SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.

С тех пор:

JAX-WS 2.2

опубликовать

public abstract void publish(java.lang.Object serverContext)

Публикует эту конечную точку в обеспеченном контексте сервера. Контекст сервера инкапсулирует инфраструктуру сервера и адресную информацию для определенного транспорта. Для звонка в этот метод, чтобы успешно выполниться, контекст сервера, который передают, поскольку, параметр этому ДОЛЖЕН быть совместимым с обязательной конечной точкой.

Параметры:

serverContext - Объект, представляющий контекст сервера, который будет использоваться для того, чтобы опубликовать конечную точку.

Броски:

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

java.lang.IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.

java.lang.SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.

опубликовать

public void publish(HttpContext serverContext)

Публикует эту конечную точку в обеспеченном контексте сервера. Контекст сервера инкапсулирует инфраструктуру сервера и адресную информацию для определенного транспорта. Для звонка в этот метод, чтобы успешно выполниться, контекст сервера, который передают, поскольку, параметр этому ДОЛЖЕН быть совместимым с обязательной конечной точкой.

Это предназначается для контейнерных разработчиков, чтобы опубликовать конечные точки портативно и не предназначенное для разработчиков конца.

Параметры:

serverContext - Объект, представляющий контекст сервера, который будет использоваться для того, чтобы опубликовать конечную точку.

Броски:

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

java.lang.IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.

java.lang.SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.

С тех пор:

JAX-WS 2.2

остановиться

public abstract void stop()

Остановки, публикующие эту конечную точку. Если конечная точка не находится в опубликованном состоянии, этот метод не имеет никакого эффекта.

isPublished

public abstract boolean isPublished()

Возвращает true, если конечная точка находится в опубликованном состоянии.

Возвраты:

true если конечная точка находится в опубликованном состоянии.

getMetadata

public abstract java.util.List<javax.xml.transform.Source> getMetadata()

Возвращает список документов метаданных для службы.

Возвраты:

List<javax.xml.transform.Source> Список документов метаданных для службы

setMetadata

public abstract void setMetadata(java.util.List<javax.xml.transform.Source> metadata)

Устанавливает метаданные для этой конечной точки.

Параметры:

metadata - Список источников XML-документа, содержащих информацию о метаданных для конечной точки (например, WSDL или документы XML-схемы)

Броски:

java.lang.IllegalStateException - Если конечная точка была уже опубликована.

getExecutor

public abstract java.util.concurrent.Executor getExecutor()

Возвращает исполнителя для этого Endpointэкземпляр. Исполнитель используется, чтобы диспетчеризировать входящий запрос объекту конструктора.

Возвраты:

java.util.concurrent.Executor использоваться, чтобы диспетчеризировать запрос.

См. Также:

Executor

setExecutor

public abstract void setExecutor(java.util.concurrent.Executor executor)

Устанавливает исполнителя для этого Endpoint экземпляр. Исполнитель используется, чтобы диспетчеризировать входящий запрос объекту конструктора. Если это Endpoint публикуется, используя publish(Object) метод и указанный контекст сервера определяют свое собственное поведение поточной обработки, исполнитель может быть проигнорирован.

Параметры:

executor - java.util.concurrent.Executor использоваться, чтобы диспетчеризировать запрос.

Броски:

SecurityException - Если экземпляр не поддерживает установку исполнителя для соображений безопасности (например, необходимые полномочия отсутствуют).

См. Также:

Executor

getProperties

public abstract java.util.Map<java.lang.String,java.lang.Object> getProperties()

Возвращает набор свойств для этого Endpoint экземпляр.

Возвраты:

Карта <Строка, Объект> набор свойств связался с этим экземпляром.

setProperties

public abstract void setProperties(java.util.Map<java.lang.String,java.lang.Object> properties)

Устанавливает набор свойств для этого Endpoint экземпляр.

Параметры:

properties - Набор свойств связался с этим экземпляром.

getEndpointReference

public abstract EndpointReference getEndpointReference(org.w3c.dom.Element... referenceParameters)

Возвраты EndpointReference связанный с этим Endpoint экземпляр.

Если Привязка для этого bindingProvider или SOAP1.1/HTTP или SOAP1.2/HTTP, тогда a W3CEndpointReference ДОЛЖЕН быть возвращен.

Параметры:

referenceParameters - Ссылочные параметры, которые будут связаны с возвращенным EndpointReference экземпляр.

Возвраты:

EndpointReference этого Endpoint экземпляр. Если возвращенный EndpointReference имеет тип W3CEndpointReference тогда это ДОЛЖНО содержать указанное referenceParameters.

Броски:

WebServiceException - Если любая ошибка в создании EndpointReference или если Endpoint не находится в опубликованном состоянии.

UnsupportedOperationException - Если это BindingProvider использует XML/HTTP-срязыр¦ние.

С тех пор:

JAX-WS 2.1

См. Также:

W3CEndpointReference

getEndpointReference

public abstract <T extends EndpointReference> T getEndpointReference(java.lang.Class<T> clazz,
                                                                     org.w3c.dom.Element... referenceParameters)

Возвраты EndpointReference связанный с этим Endpoint экземпляр.

Параметры:

clazz - Определяет тип EndpointReference, который ДОЛЖЕН быть возвращен.

referenceParameters - Ссылочные параметры, которые будут связаны с возвращенным EndpointReference экземпляр.

Возвраты:

EndpointReference типа clazz из этого Endpoint instance. If the returned EndpointReference is of type W3CEndpointReference then it MUST contain the the specified referenceParameters.

Throws:

WebServiceException - If any error in the creation of the EndpointReference or if the Endpoint is not in the published state or if the clazz is not a supported EndpointReference type.

UnsupportedOperationException - If this BindingProvider uses the XML/HTTP binding.

Since:

JAX-WS 2.1

setEndpointContext

public void setEndpointContext(EndpointContext ctxt)

By settng a EndpointContext, JAX-WS runtime knows about addresses of other endpoints in an application. If multiple endpoints share different ports of a WSDL, then the multiple port addresses are patched when the WSDL is accessed.

This needs to be set before publishing the endpoints.

Parameters:

ctxt - that is shared for multiple endpoints

Throws:

java.lang.IllegalStateException - If the endpoint has been published already or it has been stopped.

Since:

JAX-WS 2.2