| Java 2 Platform Ent. Ed. v1.4 | ||||||||||
java.lang.Objectjavax.xml.soap.SOAPConnection
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 toSOAPConnectionFactory.newInstance() (see below) will throw anUnsupportedOperationException.
A client can obtain aSOAPConnection object using aSOAPConnectionFactory 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 methodcall, which sends the message and then waits until it gets a reply.SOAPConnection() | |
call(SOAPMessage request,Object to)Sends the given message to the specified endpoint and blocks until it has returned the response. | |
close()Closes this SOAPConnection object. | |
| Methods inherited from class java.lang.Object |
clone,equals,finalize,getClass,hashCode,notify,notifyAll,toString,wait,wait,wait |
publicSOAPConnection()
public abstractSOAPMessagecall(SOAPMessage request,Object to) throwsSOAPException
request - theSOAPMessage object to be sentto - 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.URLEndpointSOAPMessage object that is the response to the message that was sentSOAPException - if there is a SOAP errorpublic abstract voidclose() throwsSOAPException
SOAPConnection object.SOAPException - if there is a SOAP error| Java 2 Platform Ent. Ed. v1.4 | ||||||||||