| java.lang.Object
 javax.xml.soap.SOAPConnection
All known Subclasses: com.sun.xml.messaging.saaj.client.p2p.HttpSOAPConnection,
| SOAPConnection | | abstract public class SOAPConnection (Code) | | A point-to-point connection that a client can use for sending messages
directly to a remote party (represented by a URL, for instance).
The SOAPConnection class is optional. Some implementations may
not implement this interface in which case the call to
SOAPConnectionFactory.newInstance() (see below) will
throw an UnsupportedOperationException.
A client can obtain a SOAPConnection object using a
SOAPConnectionFactory object as in the following example:
SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance();
SOAPConnection con = factory.createConnection();
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.
|
| Method Summary | |
| abstract public SOAPMessage | call(SOAPMessage request, Object to)
Sends the given message to the specified endpoint and blocks until
it has returned the response.
Parameters:
request - the SOAPMessage object to be sent
Parameters:
to - an Object that identifieswhere the message should be sent. | | abstract public void | close()
Closes this SOAPConnection object. | | public SOAPMessage | get(Object to)
Gets a message from a specific endpoint and blocks until it receives,
Parameters:
to - an Object that identifies wherethe request should be sent. |
| call | | abstract public SOAPMessage call(SOAPMessage request, Object to) throws SOAPException(Code) | | Sends the given message to the specified endpoint and blocks until
it has returned the response.
Parameters:
request - the SOAPMessage object to be sent
Parameters:
to - an Object that identifieswhere the message should be sent. It is required tosupport Objects of typejava.lang.String,java.net.URL, and when JAXM is presentjavax.xml.messaging.URLEndpoint the SOAPMessage object that is the response to themessage that was sent
throws:
SOAPException - if there is a SOAP error |
| get | | public SOAPMessage get(Object to) throws SOAPException(Code) | | Gets a message from a specific endpoint and blocks until it receives,
Parameters:
to - an Object that identifies wherethe request should be sent. Objects of typejava.lang.String andjava.net.URL must be supported. the SOAPMessage object that is the response to theget message request
throws:
SOAPException - if there is a SOAP error
since:
SAAJ 1.3 |
|
|