javax.xml.soap
Class SOAPConnection

java.lang.Object
  |
  +--javax.xml.soap.SOAPConnection

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) without using a messaging provider. A standalone client uses a SOAPConnection object rather than a ProviderConnection object.

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

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SOAPConnection

public SOAPConnection()

Method Detail

call

public abstract SOAPMessage call(SOAPMessage request,
                                 Endpoint 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 - a URLEndpoint object giving the URL to which the message should be sent

Returns:

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

Throws:

SOAPException - is there is a SOAP error

close

public abstract void close()
                    throws SOAPException

Closes this SOAPConnection object.

Throws:

SOAPException - is there is a SOAP error