- 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
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/xml/soap/soapconnection.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.