javax.xml.soap
클래스 SOAPConnection

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

public abstract class SOAPConnection
extends Object 

클라이언트가 원격 측에 직접 메세지를 송신하는데 사용하는 point-to-point 접속입니다 (URL 등으로 표시).

SOAPConnection 클래스는 옵션입니다. 구현에 따라서는, 이 인터페이스를 구현하고 있지 않는 것도 있습니다. 그 경우,SOAPConnectionFactory.newInstance() 에의 호출은 UnsupportedOperationException 를 throw 합니다 (이하 참조).

클라이언트는 다음의 예의 같게 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 - 메세지를 송신하는 장소를 특정한다 Objectjava.lang.String, java.net.URL, 또, JAXM 가 존재하는 경우는 javax.xml.messaging.URLEndpoint 등, 각종 Object 를 지원할 필요가 있다

반환값:

송신된 메세지에 대한 응답의 SOAPMessage 객체

예외:

SOAPException - SOAP 에러가 발생했을 경우

get

public SOAPMessage  get(Object  to)
                throws SOAPException 

특정의 단 점으로부터 메세지를 취득해, 수신할 때까지 블록 합니다.

파라미터:

to - 요구가 송신되는 장소를 특정한다 Objectjava.lang.String 나 java.net.URL 를 지원할 필요가 있다

반환값:

취득한 메세지 요구에 대한 응답의 SOAPMessage 객체

예외:

SOAPException - SOAP 에러가 발생했을 경우

도입된 버젼:

SAAJ 1.3

close

public abstract void close()
                    throws SOAPException 

이 SOAPConnection 객체를 닫습니다.

예외:

SOAPException - SOAP 에러가 발생했을 경우