File Doc Category Size Date Package
SOAPConnection.java API Doc Apache Axis 1.4 2351 Sat Apr 22 18:57:28 BST 2006 javax.xml.soap

SOAPConnection

java.lang.Object

public abstract class SOAPConnection extends 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.

Fields Summary
Constructors Summary
public SOAPConnection()
Methods Summary
public abstract javax.xml.soap.SOAPMessage call(javax.xml.soap.SOAPMessage request, java.lang.Object endpoint)
Sends the given message to the specified endpoint and blocks until it has returned the response.
param
request the SOAPMessage object to be sent
param
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
return
the SOAPMessage object that is the response to the message that was sent
throws
SOAPException if there is a SOAP error
public abstract void close()
Closes this SOAPConnection object.
throws
SOAPException if there is a SOAP error