|
JavaTM 2 Platform Ent. Ed. v1.4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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 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.
Constructor Summary | |
SOAPConnection()
|
Method Summary | |
abstract SOAPMessage |
call(SOAPMessage request,
Object to)
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 |
Constructor Detail |
public SOAPConnection()
Method Detail |
public abstract SOAPMessage call(SOAPMessage request, Object to) throws SOAPException
request
- the SOAPMessage
object to be sentto
- 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
SOAPMessage
object that is the response to the
message that was sent
SOAPException
- if there is a SOAP errorpublic abstract void close() throws SOAPException
SOAPConnection
object.
SOAPException
- if there is a SOAP error
|
JavaTM 2 Platform Ent. Ed. v1.4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 2003 Sun Microsystems, Inc. All rights reserved.