public abstract class SOAPConnection extends Object
 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 and Description | 
|---|
| SOAPConnection() | 
| Modifier and Type | Method and Description | 
|---|---|
| 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  SOAPConnectionobject. | 
| SOAPMessage | get(Object to)Gets a message from a specific endpoint and blocks until it receives, | 
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.URLEndpointSOAPMessage object that is the response to the
         message that was sentSOAPException - if there is a SOAP errorpublic SOAPMessage get(Object to) throws SOAPException
to - an Object that identifies where
                  the request should be sent. Objects of type
                 java.lang.String and
                 java.net.URL must be supported.SOAPMessage object that is the response to the
                  get message requestSOAPException - if there is a SOAP errorpublic abstract void close()
                    throws SOAPException
SOAPConnection object.SOAPException - if there is a SOAP error Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2025, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.