- 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
メソッドを使用して送信されます。callはメッセージを送信した後、応答が返るまで待機します。- 導入されたバージョン:
- 1.6
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 SOAPConnection()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 abstract SOAPMessage
call(SOAPMessage request, Object to)
指定のメッセージを指定の端点に送信し、応答が返るまでブロックします。abstract void
close()
このSOAPConnection
オブジェクトを閉じます。SOAPMessage
get(Object to)
特定の端点からメッセージを取得し、受信するまでブロックします。
-
-
-
メソッドの詳細
-
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
の型のObjectをサポートする必要がある- 戻り値:
- 送信したメッセージに対する応答の
SOAPMessage
オブジェクト - 例外:
SOAPException
- SOAPエラーが存在する場合
-
get
public SOAPMessage get(Object to) throws SOAPException
特定の端点からメッセージを取得し、受信するまでブロックします。- パラメータ:
to
- 要求を送信する場所を特定するObject
。java.lang.String
型とjava.net.URL
型のオブジェクトをサポートする必要がある。- 戻り値:
- メッセージ取得要求に対する応答の
SOAPMessage
オブジェクト - 例外:
SOAPException
- SOAPエラーが存在する場合- 導入されたバージョン:
- 1.6, SAAJ 1.3
-
close
public abstract void close() throws SOAPException
このSOAPConnection
オブジェクトを閉じます。- 例外:
SOAPException
- SOAPエラーが存在する場合
-
-