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.
Copyright B) 2005 Apache Web Services Project. All Rights Reserved.