javax.xml.soap

Class SOAPConnection

java.lang.Object

javax.xml.soap.SOAPConnection

public abstract class SOAPConnection
extends Object

客户端可以直接向远程方发送消息的点对点连接（例如，由一个链接表示）。

SOAPConnection级是可选的。一些实现可能无法实现，在这种情况下，调用SOAPConnectionFactory.newInstance()这个接口（见下图）将抛出一个UnsupportedOperationException。

客户端可以使用SOAPConnectionFactory对象作为在下面的例子中得到SOAPConnection对象：

soapconnectionfactory厂= soapconnectionfactory。newinstance()；createconnection() SOAPConnection CON =工厂；

一 SOAPConnection对象可以直接发送消息到一个URL的请求/响应模式。即使用方法 call发送消息，发送消息，然后等待，直到它得到一个答复。

构造方法摘要

构造方法

Constructor and Description
SOAPConnection()

方法摘要

Modifier and Type	Method and Description
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

Constructor Detail

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对象

异常

SOAPException -如果有一个SOAP错误

从以下版本开始：

SAAJ 1.3

close

public abstract void close()
                    throws SOAPException

关闭 SOAPConnection对象。

异常

SOAPException -如果有一个SOAP错误