| 
 | J2EE1.4 SDK | |||||||||
| 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,
     java.lang.Object to)Sends the given message to the specified endpoint and blocks until it has returned the response. | 
| abstract  void | close()Closes this SOAPConnectionobject. | 
| 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,
                                 java.lang.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 error
public abstract void close()
                    throws SOAPException
SOAPConnection object.
SOAPException - if there is a SOAP error| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.