- java.lang.Object
-
- javax.xml.soap.SOAPConnection
-
public abstract class SOAPConnection extends 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).The SOAPConnection class is optional. Some implementations may not implement this interface in which case the call to
SOAPConnectionFactory.newInstance()
(see below) will throw anUnsupportedOperationException
.A client can obtain a
SOAPConnection
object using aSOAPConnectionFactory
object as in the following example:SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance(); SOAPConnection con = factory.createConnection();
ASOAPConnection
object can be used to send messages directly to a URL following the request/response paradigm. That is, messages are sent using the methodcall
, which sends the message and then waits until it gets a reply.
-
-
Constructor Summary
Constructors Constructor and Description SOAPConnection()
-
Method Summary
Methods 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 thisSOAPConnection
object.SOAPMessage
get(Object to)
Gets a message from a specific endpoint and blocks until it receives,
-
-
-
Method Detail
-
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
- theSOAPMessage
object to be sentto
- anObject
that identifies where the message should be sent. It is required to support Objects of typejava.lang.String
,java.net.URL
, and when JAXM is presentjavax.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
-
get
public SOAPMessage get(Object to) throws SOAPException
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:
- SAAJ 1.3
-
close
public abstract void close() throws SOAPException
Closes thisSOAPConnection
object.- Throws:
SOAPException
- if there is a SOAP error
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
01/12/2024 01:19:22 Cette version de la page est en cache (à la date du 01/12/2024 01:19:22) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 11/06/2005, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/xml/soap/soapconnection.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.