Класс SOAPConnection

public abstract class SOAPConnection
extends Object

Точечное соединение, которое клиент может использовать для отправки сообщений непосредственно удалённой стороне (например, представленной URL-адресом).

Класс SOAPConnection является необязательным. Некоторые реализации могут не реализовывать этот интерфейс, в этом случае вызов SOAPConnectionFactory.newInstance() (см. ниже) выбросит UnsupportedOperationException.

Клиент может получить объект SOAPConnection с помощью объекта SOAPConnectionFactory, как в следующем примере:

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

Объект SOAPConnection может быть использован для отправки сообщений непосредственно на URL, следуя парадигме «запрос/ответ». То есть сообщения отправляются с помощью метода call, который отправляет сообщение и затем ждёт ответа.

Конструкторы

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