Class SOAPConnection

java.lang.Object
jakarta.xml.soap.SOAPConnection
All Implemented Interfaces:
AutoCloseable

public abstract class SOAPConnection extends Object implements AutoCloseable
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.
Since:
1.6
  • Constructor Details

    • SOAPConnection

      protected SOAPConnection()
      Default constructor.
  • Method Details

    • call

      public abstract SOAPMessage call(SOAPMessage request, Object to) 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
      to - an Object that identifies where the message should be sent. It is required to support Objects of type java.lang.String and java.net.URL
      Returns:
      the SOAPMessage object that is the response to the message that was sent
      Throws:
      SOAPException - if there is a SOAP error
    • get

      public SOAPMessage get(Object to) throws SOAPException
      Gets a message from a specific endpoint and blocks until it receives,
      Parameters:
      to - an Object that identifies where the request should be sent. Objects of type java.lang.String and java.net.URL must be supported.
      Returns:
      the SOAPMessage object that is the response to the get message request
      Throws:
      SOAPException - if there is a SOAP error
      Since:
      1.6, SAAJ 1.3
    • setConnectTimeout

      public void setConnectTimeout(int timeout)
      Sets the read timeout to a specified timeout, in milliseconds. A timeout of zero is interpreted as an infinite timeout.
      Parameters:
      timeout - an int that specifies the timeout value to be used in milliseconds
      Throws:
      IllegalArgumentException - if the timeout parameter is negative
      Since:
      3.0
    • getConnectTimeout

      public int getConnectTimeout()
      Returns setting for connect timeout. 0 implies infinite timeout
      Returns:
      an int that indicates the connect timeout value in milliseconds
      Since:
      3.0
    • setReadTimeout

      public void setReadTimeout(int timeout)
      Sets the read timeout to a specified timeout, in milliseconds. A timeout of zero is interpreted as an infinite timeout.
      Parameters:
      timeout - an int that specifies the timeout value to be used in milliseconds
      Throws:
      IllegalArgumentException - if the timeout parameter is negative
      Since:
      3.0
    • getReadTimeout

      public int getReadTimeout()
      Returns setting for read timeout. 0 implies infinite timeout
      Returns:
      an int that indicates the read timeout value in milliseconds
      Since:
      3.0
    • close

      public abstract void close() throws SOAPException
      Closes this SOAPConnection object.
      Specified by:
      close in interface AutoCloseable
      Throws:
      SOAPException - if there is a SOAP error