javax.xml.soap

Class SOAPConnection

Known Direct Subclasses:
SOAPConnectionImpl

public abstract class SOAPConnection
extends java.lang.Object

A point-to-point connection that a client can use for sending messages directly to a remote party (represented by a URL, for instance).

A client can obtain a SOAPConnection object simply by calling the following static method.


      SOAPConnection con = SOAPConnection.newInstance();
 
A SOAPConnection object can be used to send messages directly to a URL following the request/response paradigm. That is, messages are sent using the method call, which sends the message and then waits until it gets a reply.

Constructor Summary

SOAPConnection()

Method Summary

SOAPMessage
call(SOAPMessage request, Object endpoint)
Sends the given message to the specified endpoint and blocks until it has returned the response.
void
close()
Closes this SOAPConnection object.

Constructor Details

SOAPConnection

public SOAPConnection()

Method Details

call

public SOAPMessage call(SOAPMessage request,
                        Object endpoint)
            throws SOAPException
Sends the given message to the specified endpoint and blocks until it has returned the response.

Parameters:
request - the SOAPMessage object to be sent
endpoint - an Object that identifies where the message should be sent. It is required to support Objects of type java.lang.String, java.net.URL, and when JAXM is present javax.xml.messaging.URLEndpoint

Returns:
the SOAPMessage object that is the response to the message that was sent

Throws:
SOAPException - if there is a SOAP error


close

public void close()
            throws SOAPException
Closes this SOAPConnection object.

Throws:
SOAPException - if there is a SOAP error


Copyright B) 2005 Apache Web Services Project. All Rights Reserved.