javax.xml.ws
인터페이스 Dispatch<T>

모든 슈퍼 인터페이스:

BindingProvider

public interface Dispatch<T>
extends BindingProvider 

Dispatch 인터페이스는, 서비스단점조작의 동적인 호출의 지원를 제공합니다. javax.xml.ws.Service 인터페이스는,Dispatch 인스턴스를 작성하기 위한 팩토리로서 동작합니다.

도입된 버젼:

JAX-WS 2.0

필드의 개요

인터페이스 javax.xml.ws. BindingProvider 로부터 상속된 필드

ENDPOINT_ADDRESS_PROPERTY , PASSWORD_PROPERTY , SESSION_MAINTAIN_PROPERTY , SOAPACTION_URI_PROPERTY , SOAPACTION_USE_PROPERTY , USERNAME_PROPERTY

메소드의 개요

T	invoke (T msg) 서비스 조작을 동기적으로 호출합니다.
Response <T >	invokeAsync (T msg) 서비스 조작을 비동기적으로 호출합니다.
Future <? >	invokeAsync (T msg, AsyncHandler <T > handler) 서비스 조작을 비동기적으로 호출합니다.
void	invokeOneWay (T msg) 한방향 대화 모드를 사용해 서비스 조작을 호출합니다.

인터페이스 javax.xml.ws. BindingProvider 로부터 상속된 메소드

getBinding , getRequestContext , getResponseContext

메소드의 상세

invoke

T  invoke(T  msg)

서비스 조작을 동기적으로 호출합니다. 클라이언트는, 사용하고 있는 프로토콜 바인딩의 요건에 따라, 정렬화시에 msg 객체가 형성되는 것을 보증합니다.

파라미터:

msg - 조작을 호출하기 위해서(때문에) 사용되는 메세지 또는 메세지의 유료 하중을 형성하는 객체

반환값:

조작의 호출에 대한 응답 메세지 또는 메세지 유료 하중

예외:

WebServiceException - 서비스와의 통신중에 장해가 발생했을 경우

WebServiceException - Dispatch 인스턴스의 설정에 에러가 있었다 경우

invokeAsync

Response <T > invokeAsync(T  msg)

서비스 조작을 비동기적으로 호출합니다. 이 메소드는, 조작 호출에 대한 응답을 기다리는 일 없이 돌려주어, 조작의 결과는 반환값의 Response 를 폴링 하는 것에 의해 취득됩니다. 클라이언트는, 사용하고 있는 프로토콜 바인딩의 요건에 따라, 정렬화시에 msg 객체가 형성되는 것을 보증합니다.

파라미터:

msg - 조작을 호출하기 위해서(때문에) 사용되는 메세지 또는 메세지의 유료 하중을 형성하는 객체

반환값:

조작의 호출에 대한 응답 메세지 또는 메세지 유료 하중

예외:

WebServiceException - Dispatch 인스턴스의 설정에 에러가 있었다 경우

invokeAsync

Future <? > invokeAsync(T  msg,
                      AsyncHandler <T > handler)

서비스 조작을 비동기적으로 호출합니다. 이 메소드는, 조작 호출에 대한 응답을 기다리는 일 없이 돌려주어, 조작의 결과는 핸들러를 건네주는 것에 의해 클라이언트에 통지됩니다. 클라이언트는, 사용하고 있는 프로토콜 바인딩의 요건에 따라, 정렬화시에 msg 객체가 형성되는 것을 보증합니다.

파라미터:

msg - 조작을 호출하기 위해서(때문에) 사용되는 메세지 또는 메세지의 유료 하중을 형성하는 객체

handler - 조작의 호출에 대한 응답을 받아들인다 핸들러 객체

반환값:

조작 호출의 상태를 체크하기 위해서 사용될 가능성이 있다 Future 객체. 이 객체는, 조작의 결과의 취득을 시도하기 위해서(때문에) 사용해서는 안 된다. Future. get() 로부터 반환되는 객체는 구현 의존이며, 이것의 사용은 이식성이 없는 동작의 원인이 된다

예외:

WebServiceException - Dispatch 인스턴스의 설정에 에러가 있었다 경우

invokeOneWay

void invokeOneWay(T  msg)

한방향 대화 모드를 사용해 서비스 조작을 호출합니다. 조작의 호출은, 논리적으로 비블로킹이며, 기반 프로토콜의 기능에 의해 좌우되어 결과가 돌려주어지지 않습니다. 사용하는 프로토콜이 SOAP/HTTP 의 경우, HTTP 응답 코드의 수신이 완료할 때까지 이 메소드는 블록 할 필요가 있어, 그렇게 되지 않는 경우, 에러가 발생합니다. 클라이언트는, 사용하고 있는 프로토콜 바인딩의 요건에 따라, 정렬화시에 msg 객체가 형성되는 것을 보증합니다.

파라미터:

msg - 조작을 호출하기 위해서(때문에) 사용되는 메세지 또는 메세지의 유료 하중을 형성하는 객체

예외:

WebServiceException - Dispatch 인스턴스의 설정에 에러가 있었다 경우, 또는, 호출중에 에러가 발생했을 경우