当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

SOAPConnection (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.xml.soap
类 SOAPConnection

java.lang.Object
  javax.xml.soap.SOAPConnection

---

public abstract class SOAPConnection
extends Object

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

SOAPConnection 类是可选的。某些实现可能无法实现此接口，在这种情况下，调用 SOAPConnectionFactory.newInstance()（参见以下内容）将抛出 UnsupportedOperationException。

客户端可以使用 SOAPConnectionFactory 对象获取 SOAPConnection 对象，如下例所示：

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

SOAPConnection 对象可用来将消息直接发送到请求/响应范例后面的 URL。也就是说，使用方法 call 来发送消息，该方法发送消息并等到收到应答为止。

---

构造方法摘要
SOAPConnection()

 

方法摘要
abstract  SOAPMessage	call(SOAPMessage request, Object to)           将给定消息发送到指定端点，在返回应答前将一直阻塞。
abstract  void	close()           关闭此 SOAPConnection 对象。
SOAPMessage	get(Object to)           从特定端点获取消息，在收到消息前将一直阻塞。

 

从类 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，以及 javax.xml.messaging.URLEndpoint 类型（JAXM 存在时）的 Object。

返回：

响应已发送消息的 SOAPMessage 对象

抛出：

SOAPException - 如果存在 SOAP 错误

---

get

public SOAPMessage get(Object to)
                throws SOAPException

从特定端点获取消息，在收到消息前将一直阻塞。

参数：

to - 标识请求发送目的地的 Object。必须支持 java.lang.String 和 java.net.URL 类型的 Object。

返回：

响应获取消息请求的 SOAPMessage 对象

抛出：

SOAPException - 如果存在 SOAP 错误

从以下版本开始：

SAAJ 1.3

---

close

public abstract void close()
                    throws SOAPException

关闭此 SOAPConnection 对象。

抛出：

SOAPException - 如果存在 SOAP 错误

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。