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).
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.
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.
|
SOAPConnection
public SOAPConnection()
call
public abstract SOAPMessage call(SOAPMessage request,
Object endpoint)
throws SOAPException
Sends the given message to the specified endpoint and
blocks until it has returned the response.
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.URLEndpoint
- the
SOAPMessage
object that is the
response to the message that was sent
close
public abstract void close()
throws SOAPException
Closes this SOAPConnection
object.