javax.xml.ws

Class EndpointReference

java.lang.Object

javax.xml.ws.EndpointReference

Direct Known Subclasses:

W3CEndpointReference

public abstract class EndpointReference
extends Object

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 writeTo(javax.xml.transform.Result) method.

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.

Since:

JAX-WS 2.1

See Also:

W3CEndpointReference, Service

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EndpointReference()

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features) The getPort method returns a proxy.
static EndpointReference	readFrom(Source eprInfoset) Factory method to read an EndpointReference from the infoset contained in eprInfoset.
String	toString() Displays EPR infoset for debugging convenience.
abstract void	writeTo(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

EndpointReference

protected EndpointReference()

Method Detail

readFrom

public static EndpointReference readFrom(Source eprInfoset)

Factory method to read an EndpointReference from the infoset contained in eprInfoset. This method delegates to the vendor specific implementation of the Provider.readEndpointReference(javax.xml.transform.Source) method.

Parameters:

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

IllegalArgumentException - if the null eprInfoset value is given.

writeTo

public abstract void writeTo(