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
определяется WebServiceFeature
public 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