W3CEndpointReferenceBuilder (Платформа Java SE 7)

java.lang. Объект
- javax.xml.ws.wsaddressing.W3CEndpointReferenceBuilder

```
public final class W3CEndpointReferenceBuilder
extends Object
```
Этот класс используется, чтобы создать W3CEndpointReference экземпляры. Намеченное использование этого clsss для компонента приложения, например компонент фабрики, чтобы создать W3CEndpointReference для конечной точки веб-сервиса, опубликованной тем же самым приложением EE Java. Это может также использоваться, чтобы создать W3CEndpointReferences для Java SE базируемая конечная точка, обеспечивая address свойство.
Создавая a W3CEndpointReference для конечной точки, которая не публикуется тем же самым приложением EE Java, address свойство MUST быть определенным.
Создавая a W3CEndpointReference для конечной точки, опубликованной тем же самым приложением EE Java, address свойство MAY быть null но тогда serviceName и endpointName ДОЛЖЕН определить конечную точку, опубликованную тем же самым приложением EE Java.
Когда wsdlDocumentLocation определяется это ДОЛЖНО сослаться на допустимый документ WSDL и serviceName и endpointName (если определено), ДОЛЖЕН соответствовать службу и порт в документе WSDL.

С тех пор:

JAX-WS 2.1

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

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

W3CEndpointReferenceBuilder()
Создает новое W3CEndpointReferenceBuilder экземпляр.

Конструкторы
Конструктор и Описание
`W3CEndpointReferenceBuilder()` Создает новое `W3CEndpointReferenceBuilder` экземпляр.

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

Методы
Модификатор и Тип	Метод и Описание
`W3CEndpointReferenceBuilder`	`address(String address)` Наборы `address` к `W3CEndpointReference` экземпляр `wsa:Address`.
`W3CEndpointReferenceBuilder`	`attribute(QName name, String value)` Добавляет, что расширение приписывает `W3CEndpointReference` экземпляр `wsa:EndpointReference` элемент.
`W3CEndpointReference`	`build()` Сборки a `W3CEndpointReference` от накопленного набора свойств на этом `W3CEndpointReferenceBuilder` экземпляр.
`W3CEndpointReferenceBuilder`	`element(Element element)` Добавляет элемент расширения к `W3CEndpointReference` экземпляр `wsa:EndpointReference` элемент.
`W3CEndpointReferenceBuilder`	`endpointName(QName endpointName)` Наборы `endpointName` как `wsam:ServiceName/@EndpointName` в `wsa:Metadata` элемент.
`W3CEndpointReferenceBuilder`	`interfaceName(QName interfaceName)` Наборы `interfaceName` как `wsam:InterfaceName` элемент в `wsa:Metadata` элемент.
`W3CEndpointReferenceBuilder`	`metadata(Element metadataElement)` Добавляет `metadataElement` к `W3CEndpointReference` экземпляр `wsa:Metadata` элемент.
`W3CEndpointReferenceBuilder`	`referenceParameter(Element referenceParameter)` Добавляет `referenceParameter` к `W3CEndpointReference` экземпляр `wsa:ReferenceParameters` элемент.
`W3CEndpointReferenceBuilder`	`serviceName(QName serviceName)` Наборы `serviceName` как `wsam:ServiceName` элемент в `wsa:Metadata` элемент.
`W3CEndpointReferenceBuilder`	`wsdlDocumentLocation(String wsdlDocumentLocation)` Наборы `wsdlDocumentLocation` на это сошлются как `wsa:Metadata/@wsdli:wsdlLocation`.

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

- Деталь конструктора
  - W3CEndpointReferenceBuilder
```
public W3CEndpointReferenceBuilder()
```
    Создает новое W3CEndpointReferenceBuilder экземпляр.
- Деталь метода
  - адрес
```
public W3CEndpointReferenceBuilder address(String address)
```
    Наборы address к W3CEndpointReference экземпляр wsa:Address.
    address ДОЛЖЕН быть установлен в не -null оцените, создавая a W3CEndpointReference для конечной точки веб-сервиса, которая не публикуется тем же самым приложением EE Java или работая на Java SE.
    
    Параметры:
    address - Адрес конечной точки, которая будет предназначена возвращенным W3CEndpointReference.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с address набор к wsa:Address.
  - interfaceName
```
public W3CEndpointReferenceBuilder interfaceName(QName interfaceName)
```
    Наборы interfaceName как wsam:InterfaceName элемент в wsa:Metadata элемент. См. 2.1 Ссылаться на Метаданные WSDL от EPR для большего количества деталей.
    
    Параметры:
    interfaceName - Имя типа порта конечной точки, которая будет предназначена возвращенным W3CEndpointReference.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с interfaceName как wsam:InterfaceName элемент, добавленный к wsa:Metadata элемент
  - serviceName
```
public W3CEndpointReferenceBuilder serviceName(QName serviceName)
```
    Наборы serviceName как wsam:ServiceName элемент в wsa:Metadata элемент. См. 2.1 Ссылаться на Метаданные WSDL от EPR для большего количества деталей.
    
    Параметры:
    serviceName - Имя службы конечной точки, которая будет предназначена возвращенным W3CEndpointReference. Это свойство может также использоваться с endpointName (portName) свойство к поиску address из конечной точки веб-сервиса, которая публикуется тем же самым приложением EE Java.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с serviceName как wsam:ServiceName элемент, добавленный к wsa:Metadata элемент
  - endpointName
```
public W3CEndpointReferenceBuilder endpointName(QName endpointName)
```
    Наборы endpointName как wsam:ServiceName/@EndpointName в wsa:Metadata элемент. Этот метод можно только вызвать после serviceName метод вызвали.
    См. 2.1 Ссылаться на Метаданные WSDL от EPR для большего количества деталей.
    
    Параметры:
    endpointName - Имя конечной точки, которая будет предназначена возвращенным W3CEndpointReference. endpointName (portName) свойство может также использоваться с serviceName свойство к поиску address из конечной точки веб-сервиса, опубликованной тем же самым приложением EE Java.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с endpointName как wsam:ServiceName/@EndpointName в wsa:Metadata элемент.
    
    Броски:
    
    IllegalStateException, - если serviceName не был установлен.
    
    IllegalArgumentException, - если endpointName's URI Пространства имен не соответствует serviceName's URI Пространства имен
  - wsdlDocumentLocation
```
public W3CEndpointReferenceBuilder wsdlDocumentLocation(String wsdlDocumentLocation)
```
    Наборы wsdlDocumentLocation на это сошлются как wsa:Metadata/@wsdli:wsdlLocation. Имя пространства имен для значения wsdli:wsdlLocation's может быть взято от WSDL непосредственно.
    См. 2.1 Ссылаться на Метаданные WSDL от EPR для большего количества деталей.
    
    Параметры:
    wsdlDocumentLocation - Расположение документа WSDL, который будет сослан в wsa:Metadata из W3CEndpointReference.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с wsdlDocumentLocation на это нужно сослаться.
  - referenceParameter
```
public W3CEndpointReferenceBuilder referenceParameter(Element referenceParameter)
```
    Добавляет referenceParameter к W3CEndpointReference экземпляр wsa:ReferenceParameters элемент.
    
    Параметры:
    referenceParameter - Элемент, который будет добавлен к wsa:ReferenceParameters элемент.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с referenceParameter добавленный к wsa:ReferenceParameters элемент.
    
    Броски:
    
    IllegalArgumentException - если referenceParameter null.
  - метаданные
```
public W3CEndpointReferenceBuilder metadata(Element metadataElement)
```
    Добавляет metadataElement к W3CEndpointReference экземпляр wsa:Metadata элемент.
    
    Параметры:
    metadataElement - Элемент, который будет добавлен к wsa:Metadata элемент.
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с metadataElement добавленный к wsa:Metadata элемент.
    
    Броски:
    
    IllegalArgumentException - если metadataElement null.
  - элемент
```
public W3CEndpointReferenceBuilder element(Element element)
```
    Добавляет элемент расширения к W3CEndpointReference экземпляр wsa:EndpointReference элемент.
    
    Параметры:
    element - Элемент расширения, который будет добавлен к W3CEndpointReference
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с расширением element добавленный к W3CEndpointReference экземпляр.
    
    Броски:
    
    IllegalArgumentException - если element null.
    С тех пор:
    
    JAX-WS 2.2
  - атрибут
```
public W3CEndpointReferenceBuilder attribute(QName name,
                                    String value)
```
    Добавляет, что расширение приписывает W3CEndpointReference экземпляр wsa:EndpointReference элемент.
    
    Параметры:
    name - Имя атрибута расширения, который будет добавлен к W3CEndpointReference
    value - значение атрибута расширения
    
    Возвраты:
    A W3CEndpointReferenceBuilder экземпляр с атрибутом расширения, добавленным к W3CEndpointReference экземпляр.
    
    Броски:
    
    IllegalArgumentException - если name или value null.
    С тех пор:
    
    JAX-WS 2.2
  - сборка
```
public W3CEndpointReference build()
```
    Сборки a W3CEndpointReference от накопленного набора свойств на этом W3CEndpointReferenceBuilder экземпляр.
    Этот метод может использоваться, чтобы создать a W3CEndpointReference для любой конечной точки, определяя address свойство наряду с любыми другими требуемыми свойствами. Этот метод может также использоваться, чтобы создать a W3CEndpointReference для конечной точки, которая публикуется тем же самым приложением EE Java. Этот метод может автоматически определить address из конечной точки, опубликованной тем же самым приложением EE Java, которое идентифицируется serviceName и endpointName свойства. Если address null и serviceName и endpointName не идентифицируйте конечную точку, опубликованную тем же самым приложением EE Java, a java.lang.IllegalStateException ДОЛЖЕН быть брошен.
    Возвраты:
    W3CEndpointReference от накопленного набора свойств на этом W3CEndpointReferenceBuilder экземпляр. Этот метод никогда не возвращается null.
    
    Броски:
    IllegalStateException -
    
    Если address, serviceName и endpointName все null.
    Если serviceName служба null и endpointName не null.
    Если address свойство null и serviceName и endpointName не определяйте допустимую конечную точку, опубликованную тем же самым приложением EE Java.
    Если serviceName не null и не присутствует в указанном WSDL.
    Если endpointName порт не null и это не присутствует в serviceName служба в WSDL.
    Если wsdlDocumentLocation не null и не представляет допустимый WSDL.
    WebServiceException - Если ошибка происходит, создавая W3CEndpointReference.

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

Класс W3CEndpointReferenceBuilder

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

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

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

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

W3CEndpointReferenceBuilder

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

адрес

interfaceName

serviceName

endpointName

wsdlDocumentLocation

referenceParameter

метаданные

элемент

атрибут

сборка