javax.xml.soap
Class SOAPConnection
java.lang.Object
javax.xml.soap.SOAPConnection
- Direct Known Subclasses:
- SOAPConnectionImpl
- 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.
Method Summary |
abstract SOAPMessage |
call(SOAPMessage request,
java.lang.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. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
SOAPConnection
public SOAPConnection()
call
public abstract SOAPMessage call(SOAPMessage request,
java.lang.Object 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
- 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
close
public abstract void close()
throws SOAPException
- Closes this
SOAPConnection
object.
- Throws:
SOAPException
- if there is a SOAP error
Copyright © 2003 Apache Web Services Project. A ll Rights Reserved.