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) without using a messaging provider. A
standalone client uses a SOAPConnection
object
rather than a ProviderConnection
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.
Method Summary |
abstract SOAPMessage |
call(SOAPMessage request,
Endpoint endpoint)
Sends the given message to the specified endpoint and
blocks until it has returned the response. |
abstract void |
close()
Closes this SOAPConnection object. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
SOAPConnection
public SOAPConnection()
call
public abstract SOAPMessage call(SOAPMessage request,
Endpoint endpoint)
throws SOAPException
- Sends the given message to the specified endpoint and
blocks until it has returned the response.
- Parameters:
request
- the SOAPMessage
object to be sentendpoint
- a URLEndpoint
object giving the URL to which the message should be
sent- Returns:
- the
SOAPMessage
object that is the
response to the message that was sent - Throws:
SOAPException
- if there is a SOAP error
close
public abstract void close()
throws SOAPException
- Closes this
SOAPConnection
object.
- Throws:
SOAPException
- if there is a SOAP error
Copyright © 2001 Apache XML Project. All Rights Reserved.