|
JAX-WS v2.2 |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectjavax.xml.ws.EndpointReference
public abstract class EndpointReference
This class represents an WS-Addressing EndpointReference which is a remote reference to a web service endpoint. See Web Services Addressing 1.0 - Core for more information on WS-Addressing EndpointReferences.
This class is immutable as the typical web service developer
need not be concerned with its contents. The web service
developer should use this class strictly as a mechanism to
reference a remote web service endpoint. See the Service APIs
that clients can use to that utilize an EndpointReference.
See the Endpoint, and
BindingProvider APIs on how
EndpointReferences can be created for published
endpoints.
Concrete implementations of this class will represent
an EndpointReference for a particular version of Addressing.
For example the W3CEndpointReference is for use
with W3C Web Services Addressing 1.0 - Core Recommendation.
If JAX-WS implementors need to support different versions
of addressing, they should write their own
EndpointReference subclass for that version.
This will allow a JAX-WS implementation to create
a vendor specific EndpointReferences that the
vendor can use to flag a different version of
addressing.
Web service developers that wish to pass or return
EndpointReference in Java methods in an
SEI should use
concrete instances of an EndpointReference such
as the W3CEndpointReference. This way the
schema mapped from the SEI will be more descriptive of the
type of endpoint reference being passed.
JAX-WS implementors are expected to extract the XML infoset
from an EndpointReferece using the
method.
writeTo(javax.xml.transform.Result)
JAXB will bind this class to xs:anyType. If a better binding
is desired, web services developers should use a concrete
subclass such as W3CEndpointReference.
W3CEndpointReference,
Service| Constructor Summary | |
|---|---|
protected |
EndpointReference()
|
| Method Summary | ||
|---|---|---|
|
getPort(java.lang.Class<T> serviceEndpointInterface,
WebServiceFeature... features)
The getPort method returns a proxy. |
|
static EndpointReference |
readFrom(javax.xml.transform.Source eprInfoset)
Factory method to read an EndpointReference from the infoset contained in eprInfoset. |
|
java.lang.String |
toString()
Displays EPR infoset for debugging convenience. |
|
abstract void |
writeTo(javax.xml.transform.Result result)
write this EndpointReference to the specified infoset format |
|
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Constructor Detail |
|---|
protected EndpointReference()
| Method Detail |
|---|
public static EndpointReference readFrom(javax.xml.transform.Source eprInfoset)
eprInfoset. This method delegates to the vendor specific
implementation of the Provider.readEndpointReference(javax.xml.transform.Source) method.
eprInfoset - The 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,
WebServiceFeaturepublic java.lang.String toString()
toString in class java.lang.Object
|
JAX-WS v2.2 |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright © 2007 by Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A. All Rights Reserved.