Конечная точка (Платформа Java SE 7)

java.lang. Объект
- javax.xml.ws. Конечная точка

```
public abstract class Endpoint
extends Object
```
Конечная точка Веб-сервиса.
Конечные точки создаются, используя статические методы, определенные в этом классе. Конечная точка всегда связывается к одному Binding и один конструктор, оба набора во время создания конечной точки.
Конечная точка или в опубликованном или в неопубликованном состоянии. publish методы могут использоваться, чтобы начать публиковать конечную точку, в которой точке это начинает принимать входящие запросы. Наоборот, stop метод может использоваться, чтобы прекратить принять входящие запросы и приводить в нерабочее состояние конечную точку. После того, как остановленный, конечная точка не может быть опубликована снова.
Executor может быть установлен на конечной точке, чтобы получить лучший контроль над потоками, используемыми, чтобы диспетчеризировать входящие запросы. Например, объединение в пул потока с определенными параметрами может быть включено, создавая a ThreadPoolExecutor и регистрация этого с конечной точкой.
Цепочки обработчика могут быть установлены, используя содержавший Binding.
У конечной точки может быть список документов метаданных, таких как WSDL и документы XMLSchema, связанные с этим. При публикации времени реализация JAX-WS попытается снова использовать так много тех метаданных насколько возможно вместо того, чтобы генерировать новые, основанные на подарке аннотаций на конструкторе.

С тех пор:

JAX-WS 2.0

См. Также:
Binding, BindingType, SOAPBinding, Executor

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

Поля
Модификатор и Тип	Поле и Описание
`static String`	`WSDL_PORT` Стандартное свойство: имя порта WSDL.
`static String`	`WSDL_SERVICE` Стандартное свойство: имя службы WSDL.

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

Конструкторы
Конструктор и Описание

Endpoint()

Конструкторы
Конструктор и Описание
`Endpoint()`

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

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

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - WSDL_SERVICE
```
public static final String WSDL_SERVICE
```
    Стандартное свойство: имя службы WSDL.
    Введите: javax.xml.namespace. QName
    
    См. Также:
    Постоянные Значения полей
  - WSDL_PORT
```
public static final String WSDL_PORT
```
    Стандартное свойство: имя порта WSDL.
    Введите: javax.xml.namespace. QName
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - Конечная точка
```
public Endpoint()
```
- Деталь метода
  - создать
```
public static Endpoint create(Object implementor)
```
    Создает конечную точку с указанным объектом конструктора. Если есть привязка, определенная через аннотацию BindingType тогда, она еще ДОЛЖНА использоваться значение по умолчанию SOAP 1.1 / HTTP-связывание ДОЛЖНО использоваться.
    Недавно создаваемая конечная точка может быть опубликована, вызывая один из publish(String) и publish(Object) методы.
    
    Параметры:
    implementor - Конструктор конечной точки.
    
    Возвраты:
    Недавно создаваемая конечная точка.
  - создать
```
public static Endpoint create(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(String bindingId,
              Object implementor)
```
    Создает конечную точку с указанным обязательным типом и объектом конструктора.
    Недавно создаваемая конечная точка может быть опубликована, вызывая один из publish(String) и publish(Object) методы.
    
    Параметры:
    bindingId - URI, определяющий привязку, чтобы использовать. Если bindingID null и никакая привязка не определяется через аннотацию BindingType тогда SOAP по умолчанию 1.1 / HTTP-связывание ДОЛЖНО использоваться.
    implementor - Конструктор конечной точки.
    
    Возвраты:
    Недавно создаваемая конечная точка.
  - создать
```
public static Endpoint create(String bindingId,
              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 Object getImplementor()
```
    Возвращает объект реализации для этой конечной точки.
    
    Возвраты:
    Конструктор для этой конечной точки
  - опубликовать
```
public abstract void publish(String address)
```
    Публикует эту конечную точку в данном адресе. Необходимая инфраструктура сервера будет создаваться и конфигурироваться реализацией JAX-WS, используя некоторую конфигурацию по умолчанию. Чтобы получить больше контроля над конфигурацией сервера, пожалуйста, используйте publish(Object) метод вместо этого.
    
    Параметры:
    address - URI, определяющий адрес, чтобы использовать. Адрес ДОЛЖЕН быть совместимым с привязкой, определенной в то время, когда конечная точка создавалась.
    
    Броски:
    
    IllegalArgumentException - Если обеспеченный URI адреса не применим в соединении с обязательной конечной точкой.
    
    IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.
    
    SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.
  - опубликовать
```
public static Endpoint publish(String address,
               Object implementor)
```
    Создает и публикует конечную точку для указанного объекта конструктора в данном адресе.
    Необходимая инфраструктура сервера будет создаваться и конфигурироваться реализацией JAX-WS, используя некоторую конфигурацию по умолчанию. Чтобы получить больше контроля над конфигурацией сервера, пожалуйста, используйте create(String,Object) и publish(Object) методы вместо этого.
    
    Параметры:
    address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.
    implementor - Конструктор конечной точки.
    
    Возвраты:
    Недавно создаваемая конечная точка.
    
    Броски:
    
    SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.
  - опубликовать
```
public static Endpoint publish(String address,
               Object implementor,
               WebServiceFeature... features)
```
    Создает и публикует конечную точку для указанного объекта конструктора в данном адресе. Создаваемая конечная точка конфигурируется с функциями веб-сервиса.
    Необходимая инфраструктура сервера будет создаваться и конфигурироваться реализацией JAX-WS, используя некоторую конфигурацию по умолчанию. Чтобы получить больше контроля над конфигурацией сервера, пожалуйста, используйте create(String,Object) и publish(Object) методы вместо этого.
    
    Параметры:
    address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.
    implementor - Конструктор конечной точки.
    features - Список WebServiceFeature, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.
    
    Возвраты:
    Недавно создаваемая конечная точка.
    
    Броски:
    
    SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.
    С тех пор:
    
    JAX-WS 2.2
  - опубликовать
```
public abstract void publish(Object serverContext)
```
    Публикует эту конечную точку в обеспеченном контексте сервера. Контекст сервера инкапсулирует инфраструктуру сервера и адресацию информации для определенного транспорта. Для звонка в этот метод, чтобы успешно выполниться, контекст сервера, который передают, поскольку, параметр этому ДОЛЖЕН быть совместимым с обязательной конечной точкой.
    
    Параметры:
    serverContext - Объект, представляющий контекст сервера, который будет использоваться для того, чтобы опубликовать конечную точку.
    
    Броски:
    
    IllegalArgumentException - Если обеспеченный контекст сервера не поддерживается реализацией или, оказывается, неприменим в соединении с обязательной конечной точкой.
    
    IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.
    
    SecurityException - Если a java.lang.SecurityManger используется и приложение не имеет WebServicePermission("publishEndpoint") разрешение.
  - опубликовать
```
public void publish(HttpContext serverContext)
```
    Публикует эту конечную точку в обеспеченном контексте сервера. Контекст сервера инкапсулирует инфраструктуру сервера и адресацию информации для определенного транспорта. Для звонка в этот метод, чтобы успешно выполниться, контекст сервера, который передают, поскольку, параметр этому ДОЛЖЕН быть совместимым с обязательной конечной точкой.
    Это предназначается для контейнерных разработчиков, чтобы опубликовать конечные точки портативно и не предназначенное для разработчиков конца.
    
    Параметры:
    serverContext - Объект, представляющий контекст сервера, который будет использоваться для того, чтобы опубликовать конечную точку.
    
    Броски:
    
    IllegalArgumentException - Если обеспеченный контекст сервера не поддерживается реализацией или, оказывается, неприменим в соединении с обязательной конечной точкой.
    
    IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.
    
    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 List<Source> getMetadata()
```
    Возвращает список документов метаданных для службы.
    
    Возвраты:
    List<javax.xml.transform.Source> Список документов метаданных для службы
  - setMetadata
```
public abstract void setMetadata(List<Source> metadata)
```
    Устанавливает метаданные для этой конечной точки.
    
    Параметры:
    metadata - Список источников XML-документа, содержащих информацию о метаданных для конечной точки (например, WSDL или документы XML-схемы)
    
    Броски:
    
    IllegalStateException - Если конечная точка была уже опубликована.
  - getExecutor
```
public abstract Executor getExecutor()
```
    Возвращает исполнителя для этого Endpointэкземпляр. Исполнитель используется, чтобы диспетчеризировать входящий запрос объекту конструктора.
    
    Возвраты:
    java.util.concurrent.Executor использоваться, чтобы диспетчеризировать запрос.
    См. Также:
    Executor
  - setExecutor
```
public abstract void setExecutor(Executor executor)
```
    Устанавливает исполнителя для этого Endpoint экземпляр. Исполнитель используется, чтобы диспетчеризировать входящий запрос объекту конструктора. Если это Endpoint публикуется, используя publish(Object) метод и указанный контекст сервера определяют свое собственное поведение поточной обработки, исполнитель может быть проигнорирован.
    
    Параметры:
    executor - java.util.concurrent.Executor использоваться, чтобы диспетчеризировать запрос.
    
    Броски:
    
    SecurityException - Если экземпляр не поддерживает установку исполнителя для соображений безопасности (например, необходимые полномочия отсутствуют).
    См. Также:
    Executor
  - getProperties
```
public abstract Map<String,Object> getProperties()
```
    Возвращает набор свойств для этого Endpoint экземпляр.
    
    Возвраты:
    Карта <Строка, Объект> набор свойств связался с этим экземпляром.
  - setProperties
```
public abstract void setProperties(Map<String,Object> properties)
```
    Устанавливает набор свойств для этого Endpoint экземпляр.
    
    Параметры:
    properties - Набор свойств связался с этим экземпляром.
  - getEndpointReference
```
public abstract EndpointReference getEndpointReference(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(Class<T> clazz,
                                                   Element... referenceParameters)
```
    Возвраты EndpointReference связанный с этим Endpoint экземпляр.
    
    Параметры:
    clazz - Определяет тип EndpointReference, который ДОЛЖЕН быть возвращен.
    referenceParameters - Ссылочные параметры, которые будут связаны с возвращенным EndpointReference экземпляр.
    
    Возвраты:
    EndpointReference типа clazz из этого Endpoint экземпляр. Если возвращенный EndpointReference имеет тип W3CEndpointReference тогда это ДОЛЖНО содержать указанное referenceParameters.
    
    Броски:
    
    WebServiceException - Если любая ошибка в создании EndpointReference или если Endpoint не находится в опубликованном состоянии или если clazz не поддерживаемый EndpointReference ввести.
    
    UnsupportedOperationException - Если это BindingProvider использует XML/HTTP-срязыр¦ние.
    С тех пор:
    
    JAX-WS 2.1
  - setEndpointContext
```
public void setEndpointContext(EndpointContext ctxt)
```
    settng a EndpointContext, Время выполнения JAX-WS знает об адресах других конечных точек в приложении. Если многократные конечные точки совместно используют различные порты WSDL, то многократные адреса порта исправляются, когда к WSDL получают доступ.
    Это должно быть установлено прежде, чем опубликовать конечные точки.
    
    Параметры:
    ctxt - это совместно используется для многократных конечных точек
    
    Броски:
    
    IllegalStateException - Если конечная точка уже была опубликована, или она была остановлена.
    С тех пор:
    
    JAX-WS 2.2

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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

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

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

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

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

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

WSDL_SERVICE

WSDL_PORT

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

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

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

создать

создать

создать

создать

getBinding

getImplementor

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

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

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

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

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

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

isPublished

getMetadata

setMetadata

getExecutor

setExecutor

getProperties

setProperties

getEndpointReference

getEndpointReference

setEndpointContext