javax.xml.soap
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 Summary | |
---|---|
SOAPConnection() |
Method Summary | |
---|---|
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. |
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
SOAPConnection
object.Throws: SOAPException if there is a SOAP error