Module java.xml.ws

软件包 javax.xml.soap

Class SOAPConnection

java.lang.Object

javax.xml.soap.SOAPConnection

public abstract class SOAPConnection
extends Object

客户端可以将消息直接发送到远程方（例如由URL表示）的点对点连接。

SOAPConnection类是可选的。 一些实现可能不实现此接口，在这种情况下，对SOAPConnectionFactory.newInstance() （见下文）的调用将抛出一个UnsupportedOperationException 。

客户端可以得到SOAPConnection使用对象SOAPConnectionFactory对象如下面的例子：

   SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance(); SOAPConnection con = factory.createConnection();  

可以使用SOAPConnection对象将消息直接发送到请求/响应范例之后的URL。 也就是说，使用方法call发送消息，该方法发送消息，然后等待直到它得到回复。

从以下版本开始：

1.6

构造方法摘要

构造方法

Constructor	描述
SOAPConnection()

方法摘要

Modifier and Type	方法	描述
abstract SOAPMessage	call(SOAPMessage request, Object to)	将给定的消息发送到指定的端点并阻塞，直到它返回响应。
abstract void	close()	关闭此 SOAPConnection对象。
SOAPMessage	get(Object to)	从特定端点获取消息，并阻塞，直到收到，

Methods inherited from class java.lang.Object

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

构造方法详细信息

SOAPConnection

public SOAPConnection()

方法详细信息

call

public abstract SOAPMessage call(SOAPMessage request,
                                 Object to)
                          throws SOAPException

将给定的消息发送到指定的端点并阻塞，直到它返回响应。

参数

request - 要发送的 SOAPMessage对象

to - 一个Object ，标识消息应在哪里发送。 它需要支持类型的对象java.lang.String ， java.net.URL ，并且当JAXM存在javax.xml.messaging.URLEndpoint

结果

SOAPMessage对象是对发送的消息的响应

异常

SOAPException - 如果存在SOAP错误

get

public SOAPMessage get(Object to)
                throws SOAPException

从特定端点获取消息，并阻塞，直到收到，

参数

to - 一个Object ，用于标识发送请求的位置。 必须支持java.lang.String和java.net.URL类型的对象。

结果

SOAPMessage对象是对get消息请求的响应

异常

SOAPException - 如果存在SOAP错误

从以下版本开始：

1.6，SAAJ 1.3

close

public abstract void close()
                    throws SOAPException

关闭此 SOAPConnection对象。

异常

SOAPException - 如果存在SOAP错误