Package org.apache.xmlbeans.impl.soap

Class 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 a SOAPConnection object simply by calling the following static method. 

    
      SOAPConnection con = SOAPConnection.newInstance();
    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

      Constructors 
      Constructor Description
      SOAPConnection()  

    • Method Summary

      All Methods Instance Methods Abstract 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 this SOAPConnection object.

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • SOAPConnection

        public SOAPConnection()

    • 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 - the SOAPMessage object to be sent
        endpoint - 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
        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 this SOAPConnection object.
        Throws:
        SOAPException - if there is a SOAP error