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 メソッドを使用して送信されます。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、また 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 エラーが存在する場合

導入されたバージョン:

SAAJ 1.3

close

public abstract void close()
                    throws SOAPException

この SOAPConnection オブジェクトを閉じます。

例外:

SOAPException - SOAP エラーが存在する場合