Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.xml.ws.EndpointReference
public abstract class EndpointReference
Этот class представляет Адресацию WS EndpointReference, который является удаленной ссылкой на конечную точку веб-сервиса. См.
Этот class является неизменным, поскольку типичный разработчик веб-сервиса не должен быть обеспокоен его содержанием. Разработчик веб-сервиса должен использовать этот class строго в качестве механизма, чтобы сослаться на удаленную конечную точку веб-сервиса. См. Service
API, которые клиенты могут использовать для этого, используют EndpointReference
. См. Endpoint
, и BindingProvider
API, на как EndpointReferences
может быть создан для опубликованных конечных точек.
Конкретные реализации этого class представят EndpointReference
для определенной версии Адресации. Например W3CEndpointReference
для использования с Веб-сервисами W3C, Адресуясь 1.0 - Базовая Рекомендация. Если конструкторы JAX-WS должны поддерживать различные версии адресации, они должны записать свое собственное EndpointReference
подкласс для той версии. Это позволит реализации JAX-WS создавать определенного поставщика EndpointReferences
то, что поставщик может использовать, чтобы отметить различную версию адресации.
Разработчики веб-сервиса, которые хотят передать или возвратиться EndpointReference
в методах Java в SEI должен использовать конкретные экземпляры EndpointReference
такой как W3CEndpointReference
. Этим путем схема, отображенная от SEI, будет более дескриптивной из типа ссылки конечной точки, которую передают.
Конструкторы JAX-WS, как ожидают, извлекут инфонабор XML из EndpointReferece
использование
метод. EndpointReference#writeTo
JAXB свяжет этот class с xs:anyType. Если лучшая привязка требуется, разработчики веб-сервисов должны использовать конкретный подкласс такой как W3CEndpointReference
.
W3CEndpointReference
, Service
Сводка конструктора | |
---|---|
protected |
EndpointReference()
|
Сводка метода | ||
---|---|---|
|
getPort(java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPort метод возвращает прокси. |
|
static EndpointReference |
readFrom(javax.xml.transform.Source eprInfoset)
Метод фабрики, чтобы считать EndpointReference из инфонабора, содержавшегося в eprInfoset . |
|
java.lang.String |
toString()
Дисплеи инфонабор EPR для того, чтобы отладить удобство. |
|
abstract void |
writeTo(javax.xml.transform.Result result)
запишите это EndpointReference к указанному формату инфонабора |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Деталь конструктора |
---|
protected EndpointReference()
Деталь метода |
---|
public static EndpointReference readFrom(javax.xml.transform.Source eprInfoset)
eprInfoset
. Этот метод делегирует поставщику определенную реализацию Provider.readEndpointReference(javax.xml.transform.Source)
метод.
eprInfoset
- EndpointReference infoset to be unmarshalled - Returns:
- the EndpointReference unmarshalled from
eprInfoset
never null
- Throws:
WebServiceException
- if an error occurs while creating the EndpointReference
from the eprInfoset
java.lang.IllegalArgumentException
- if the null
eprInfoset value is given.
public abstract void writeTo(javax.xml.transform.Result result)
EndpointReference
to the specified infoset format
result
- for writing infoset WebServiceException
- if there is an error writing the EndpointReference
to the specified result
. java.lang.IllegalArgumentException
- If the null
result
value is given.public <T> T getPort(java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features)
getPort
method returns a proxy. If there are any reference parameters in the EndpointReference
instance, then those reference parameters MUST appear as SOAP headers, indicating them to be reference parameters, on all messages sent to the endpoint. The parameter serviceEndpointInterface
specifies the service endpoint interface that is supported by the returned proxy. The EndpointReference
instance specifies the endpoint that will be invoked by the returned proxy. In the implementation of this method, the JAX-WS runtime system takes the responsibility of selecting a protocol binding (and a port) and configuring the proxy accordingly from the WSDL Metadata from this EndpointReference
or from annotations on the serviceEndpointInterface
. For this method to successfully return a proxy, WSDL metadata MUST be available and the EndpointReference
instance MUST contain an implementation understood serviceName
metadata. Because this port is not created from a Service
object, handlers will not automatically be configured, and the HandlerResolver
and Executor
cannot be get or set for this port. The BindingProvider().getBinding().setHandlerChain()
method can be used to manually configure handlers for this port.
serviceEndpointInterface
- Service endpoint interfacefeatures
- An array of WebServiceFeatures
to configure on the proxy. Supported features not in the features
parameter will have their default values. WebServiceException
- endpointReference
is invalid serviceEndpointInterface
is specified Proxy
, WebServiceFeature
public java.lang.String toString()
toString
in class java.lang.Object
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | МЕТОД | DETAIL: FIELD | CONSTR | МЕТОД |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to
Generated on 10-February-2011 12:41