Package 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 aSOAPConnection
object simply by calling the following static method.SOAPConnection con = SOAPConnection.newInstance();
ASOAPConnection
object can be used to send messages directly to a URL following the request/response paradigm. That is, messages are sent using the methodcall
, which sends the message and then waits until it gets a reply.
-
-
Constructor Summary
Constructors Constructor Description SOAPConnection()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description 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 thisSOAPConnection
object.SOAPMessage
get(java.lang.Object obj)
Gets a message from a specific endpoint and blocks until it receives,
-
-
-
Method Detail
-
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
- theSOAPMessage
object to be sentendpoint
- anObject
that identifies where the message should be sent. It is required to support Objects of typejava.lang.String
,java.net.URL
, and when JAXM is presentjavax.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 thisSOAPConnection
object.- Throws:
SOAPException
- if there is a SOAP error
-
get
public SOAPMessage get(java.lang.Object obj) throws SOAPException
Gets a message from a specific endpoint and blocks until it receives,- Parameters:
to
- - an Object that identifies where the request should be sent. Objects of type java.lang.String and java.net.URL must be supported.- Returns:
- the SOAPMessage object that is the response to the get message request
- Throws:
SOAPException
- - if there is a SOAP error
-
-