Java Web Services in a Nutshell

Name

Endpoint

Synopsis

public class Endpoint {
// Public Constructors
       public Endpoint( String uri); 
// Public Methods Overriding Object
       public String toString(  ); 
// Protected Instance Fields
       protected String id; 
}

The Endpoint class encapsulates the concept of a JAXM endpoint, which is the point of communication between a JAXM application client and its local messaging provider. A JAXM client typically builds a SOAP message containing source and destination Endpoint addresses, and delivers it to its local provider, which is responsible for delivering it. Similarly, a JAXM receiver will register with its local provider and supply the Endpoint for which it wishes to receive inbound messages.

An Endpoint is constructed from a URI, which is essentially an arbitrary string that represents a message destination. Here’s an example of the construction of an Endpoint:

Endpoint endpoint = new Endpoint("urn:SOAPRPecho");

When a message addressed to this endpoint is sent, the messaging provider is expected to convert the logical address urn:SOAPRPecho to the real address of the receiving JAXM messaging provider using configuration information supplied in an implementation-dependent manner. The actual endpoint address is typically carried in the message as part of a SOAP message header so that it can be interpreted by the receiving provider and used to locate the intended recipient. Both the WS-Routing and ebXML profiles include headers that carry this information.

Subclasses

URLEndpoint