public abstract class Provider extends Object
ServiceDelegate и Endpoint объекты. | Модификатор и Тип | Поле и Описание |
|---|---|
static String |
JAXWSPROVIDER_PROPERTY
Постоянное представление свойства, привыкшего к поиску имя a
Provider реализация class. |
| Модификатор | Конструктор и Описание |
|---|---|
protected |
Provider()
Создает новый экземпляр Провайдера
|
| Модификатор и Тип | Метод и Описание |
|---|---|
abstract Endpoint |
createAndPublishEndpoint(String address, Object implementor)
Создает и публикует объект конечной точки с указанным адресом и объект реализации.
|
Конечная точка |
createAndPublishEndpoint(String address, Object implementor, WebServiceFeature... features)
Создает и публикует объект конечной точки с указанным адресом, объект реализации и функции веб-сервиса.
|
Конечная точка |
createEndpoint(String bindingId, Class<?> implementorClass, Invoker invoker, WebServiceFeature... features)
Создает объект конечной точки с обеспеченной привязкой, реализацией class, invoker и функции веб-сервиса.
|
abstract Endpoint |
createEndpoint(String bindingId, Object implementor)
Создает объект конечной точки с обеспеченным объектом привязки и реализации.
|
Конечная точка |
createEndpoint(String bindingId, Object implementor, WebServiceFeature... features)
Создает объект конечной точки с обеспеченной привязкой, объект реализации и функции веб-сервиса.
|
abstract ServiceDelegate |
createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass)
Создает объект делегата службы.
|
ServiceDelegate |
createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass, WebServiceFeature... features)
Создает объект делегата службы.
|
abstract W3CEndpointReference |
createW3CEndpointReference(String address, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters)
Метод фабрики, чтобы создать a
W3CEndpointReference. |
W3CEndpointReference |
createW3CEndpointReference(String address, QName interfaceName, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters, List<Element> elements, Map<QName,String> attributes)
Метод фабрики, чтобы создать a
W3CEndpointReference. |
abstract <T> T |
getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPort метод возвращает прокси.
|
static Provider |
provider()
Создает новый объект провайдера.
|
abstract EndpointReference |
readEndpointReference(Source eprInfoset)
считайте EndpointReference из инфонабора, содержавшегося в
eprInfoset. |
public static final String JAXWSPROVIDER_PROPERTY
Provider реализация class.public static Provider provider()
Алгоритм, используемый, чтобы определить местоположение подкласса провайдера, чтобы использовать, состоит из следующих шагов:
META-INF/services/javax.xml.ws.spi.Provider существует, тогда его первая строка, если есть используется в качестве UTF-8 закодированное имя реализации class. java.util.Properties.load(InputStream) метод и это содержат запись, ключ которой javax.xml.ws.spi.Provider, тогда значение той записи используется в качестве имени реализации class. javax.xml.ws.spi.Provider определяется, тогда его значение используется в качестве имени реализации class. public abstract ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass)
wsdlDocumentLocation - URL, указывающий на документ WSDL для службы, или null если нет того.serviceName - Полностью определенное имя службы.serviceClass - class службы, который ДОЛЖЕН быть также javax.xml.ws.Service или подкласс этого.public ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass, WebServiceFeature... features)
wsdlDocumentLocation - URL, указывающий на документ WSDL для службы, или null если нет того.serviceName - Полностью определенное имя службы.serviceClass - class службы, который ДОЛЖЕН быть также javax.xml.ws.Service или подкласс этого.features - Функции Веб-сервиса, которые должны быть сконфигурированы на службе. Если провайдер не понимает функцию, он должен бросить WebServiceException.public abstract Endpoint createEndpoint(String bindingId, Object implementor)
bindingId - URI, определяющий требуемую привязку (например, SOAP/HTTP)implementor - Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.public abstract Endpoint createAndPublishEndpoint(String address, Object implementor)
address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.implementor - Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.public abstract EndpointReference readEndpointReference(Source eprInfoset)
eprInfoset.eprInfoset - инфонабор для EndpointReferenceEndpointReference неупорядоченный от eprInfoset. Этот метод никогда не возвращается null.WebServiceException - Если есть ошибка, создавая EndpointReference от указанного eprInfoset.NullPointerException - Если null
eprInfoset значение дается.public abstract <T> T getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features)
endpointReference, тогда те ссылочные параметры ДОЛЖНЫ появиться как заголовки SOAP, указывая на них, чтобы быть ссылочными параметрами, на всех сообщениях, отправленных конечной точке. Параметр serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается возвращенным прокси. Параметр endpointReference определяет конечную точку, которая будет вызвана возвращенным прокси. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование прокси соответственно от метаданных WSDL serviceEndpointInterface и EndpointReference. Для этого метода, чтобы успешно возвратить прокси, метаданные WSDL ДОЛЖНЫ быть доступными и endpointReference ДОЛЖЕН содержать понятую реализацию serviceName метаданные.endpointReference - EndpointReference, который будет вызван возвращенным прокси.serviceEndpointInterface - Интерфейс конечной точки службыfeatures - Список WebServiceFeatures, чтобы сконфигурировать на прокси. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.WebServiceException - endpointReference недопустимо serviceEndpointInterface определяется WebServiceFeaturepublic abstract W3CEndpointReference createW3CEndpointReference(String address, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters)
W3CEndpointReference. Этот метод может использоваться, чтобы создать a W3CEndpointReference для любой конечной точки, определяя address свойство наряду с любыми другими требуемыми свойствами. Этот метод может также использоваться, чтобы создать a W3CEndpointReference для конечной точки, которая публикуется тем же самым приложением EE Java. Сделать так address свойство может быть обеспечено, или этот метод может автоматически определить address из конечной точки, которая публикуется тем же самым приложением EE Java и идентифицируется serviceName и portName propeties. Если address null и serviceName и portName не идентифицируйте конечную точку, опубликованную тем же самым приложением EE Java, a javax.lang.IllegalStateException ДОЛЖЕН быть брошен.
address - Определяет адрес целевой конечной точкиserviceName - Полностью определенное имя службы в WSDL.portName - Полностью определенное имя конечной точки в WSDL.metadata - Список элементов, которые должны быть добавлены к W3CEndpointReference экземпляры wsa:metadata элемент.wsdlDocumentLocation - URL для расположения документа WSDL для службы.referenceParameters - Ссылочные параметры, которые будут связаны с возвращенным EndpointReference экземпляр.W3CEndpointReference создаваемый из serviceName, portName, metadata, wsdlDocumentLocation и referenceParameters. Этот метод никогда не возвращается null.IllegalStateException - address, serviceName и portName все null. serviceName служба null и portName не null. address свойство null и serviceName и portName не определяйте допустимую конечную точку, опубликованную тем же самым приложением EE Java. serviceNameне null и не присутствует в указанном WSDL. portName порт не null и это не присутствует в serviceName служба в WSDL. wsdlDocumentLocation не null и не представляет допустимый WSDL. WebServiceException - Если ошибка происходит, создавая W3CEndpointReference.public W3CEndpointReference createW3CEndpointReference(String address, QName interfaceName, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters, List<Element> elements, Map<QName,String> attributes)
W3CEndpointReference. Используя этот метод, a W3CEndpointReference экземпляр может быть создан с элементами расширения, и атрибутами. Provider реализации должны переопределить реализацию по умолчанию. Этот метод может использоваться, чтобы создать a W3CEndpointReference для любой конечной точки, определяя address свойство наряду с любыми другими требуемыми свойствами. Этот метод может также использоваться, чтобы создать a W3CEndpointReference для конечной точки, которая публикуется тем же самым приложением EE Java. Сделать так address свойство может быть обеспечено, или этот метод может автоматически определить address из конечной точки, которая публикуется тем же самым приложением EE Java и идентифицируется serviceName и portName propeties. Если address null и serviceName и portName не идентифицируйте конечную точку, опубликованную тем же самым приложением EE Java, a javax.lang.IllegalStateException ДОЛЖЕН быть брошен.
address - Определяет адрес целевой конечной точкиinterfaceName - wsam:InterfaceName элемент в wsa:Metadata элемент.serviceName - Полностью определенное имя службы в WSDL.portName - Полностью определенное имя конечной точки в WSDL.metadata - Список элементов, которые должны быть добавлены к W3CEndpointReference экземпляры wsa:metadata элемент.wsdlDocumentLocation - URL для расположения документа WSDL для службы.referenceParameters - Ссылочные параметры, которые будут связаны с возвращенным EndpointReference экземпляр.elements - элементы расширения, которые будут связаны с возвращенным EndpointReference экземпляр.attributes - атрибуты расширения, которые будут связаны с возвращенным EndpointReference экземпляр.W3CEndpointReference создаваемый из serviceName, portName, metadata, wsdlDocumentLocation и referenceParameters. Этот метод никогда не возвращается null.IllegalStateException - address, serviceName и portName все null. serviceName служба null и portName не null. address свойство null и serviceName и portName не определяйте допустимую конечную точку, опубликованную тем же самым приложением EE Java. serviceNameне null и не присутствует в указанном WSDL. portName порт не null и это не присутствует в serviceName служба в WSDL. wsdlDocumentLocation не null и не представляет допустимый WSDL. wsdlDocumentLocation не null но имя пространства имен wsdli:wsdlLocation's не может быть получено от доступных метаданных. WebServiceException - Если ошибка происходит, создавая W3CEndpointReference.public Endpoint createAndPublishEndpoint(String address, Object implementor, WebServiceFeature... features)
Provider реализации должны переопределить реализацию по умолчанию.address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.implementor - Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.features - Список WebServiceFeatures, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.public Endpoint createEndpoint(String bindingId, Object implementor, WebServiceFeature... features)
Provider реализации должны переопределить реализацию по умолчанию.bindingId - URI, определяющий требуемую привязку (например, SOAP/HTTP)implementor - Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.features - Список WebServiceFeatures, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.public Endpoint createEndpoint(String bindingId, Class<?> implementorClass, Invoker invoker, WebServiceFeature... features)
Provider реализации должны переопределить реализацию по умолчанию.bindingId - URI, определяющий требуемую привязку (например, SOAP/HTTP). Может быть нуль.implementorClass - class реализации службы, который ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.invoker - это делает фактический вызов на экземпляре службы.features - Список WebServiceFeatures, чтобы сконфигурировать на конечной точке. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92