java.lang.Object
jakarta.xml.soap.SOAPConnection
- All Implemented Interfaces:
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).
A
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();
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 Summary
-
Method Summary
Modifier and TypeMethodDescriptionabstract 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 thisSOAPConnection
object.Gets a message from a specific endpoint and blocks until it receives,int
Returns setting for connect timeout.int
Returns setting for read timeout.void
setConnectTimeout
(int timeout) Sets the read timeout to a specified timeout, in milliseconds.void
setReadTimeout
(int timeout) Sets the read timeout to a specified timeout, in milliseconds.
-
Constructor Details
-
SOAPConnection
protected SOAPConnection()Default constructor.
-
-
Method Details
-
call
Sends the given message to the specified endpoint and blocks until it has returned the response.- Parameters:
request
- theSOAPMessage
object to be sentto
- anObject
that identifies where the message should be sent. It is required to support Objects of typejava.lang.String
andjava.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
Gets a message from a specific endpoint and blocks until it receives,- Parameters:
to
- anObject
that identifies where the request should be sent. Objects of typejava.lang.String
andjava.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
- anint
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
- anint
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
Closes thisSOAPConnection
object.- Specified by:
close
in interfaceAutoCloseable
- Throws:
SOAPException
- if there is a SOAP error
-