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 錯誤