public abstract class SOAPConnection extends 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 and Description |
|---|
SOAPConnection() |
| Modifier and Type | Method and Description |
|---|---|
abstract SOAPMessage |
call(SOAPMessage request,
Object endpoint)
Sends the given message to the specified endpoint and
blocks until it has returned the response.
|
abstract void |
close()
Closes this
SOAPConnection object. |
public abstract SOAPMessage call(SOAPMessage request, Object endpoint) throws SOAPException
request - the SOAPMessage
object to be sentendpoint - 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.URLEndpointSOAPMessage object that is the
response to the message that was sentSOAPException - if there is a SOAP errorpublic abstract void close()
throws SOAPException
SOAPConnection object.SOAPException - if there is a SOAP error