javax.xml.ws.spi
클래스 ServiceDelegate

java.lang.Object 
  javax.xml.ws.spi.ServiceDelegate

public abstract class ServiceDelegate
extends Object 

서비스의 위양은, 플러그 인 가능한 JAX-WS 구현을 허가하기 위해(때문에),Service 객체에 의해 내부적으로 사용됩니다.

모든 Service 객체에는, javax.xml.ws.Provider#createServiceDelegate 메소드를 사용해 작성된, 그것 자신의 위양이 있습니다. Service 객체는, 그것 자신의 모든 인스턴스 메소드를 그것의 위양에 위임합니다.

도입된 버젼:

JAX-WS 2.0

관련 항목:

Service , Provider

생성자 의 개요

protected

ServiceDelegate ()

메소드의 개요

abstract void	addPort (QName portName, String bindingId, String endpointAddress) 서비스의 새로운 포트를 작성합니다.
abstract <T> Dispatch <T>	createDispatch (QName portName, Class <T> type, Service.Mode mode) 사용자가 선택한 객체로 사용하는 Dispatch 인스턴스를 작성합니다.
abstract Dispatch <Object >	createDispatch (QName portName, JAXBContext context, Service.Mode mode) JAXB 생성 객체로 사용하는 Dispatch 인스턴스를 작성합니다.
abstract Executor	getExecutor () 이 Service 인스턴스의 Executor 를 돌려줍니다.
abstract HandlerResolver	getHandlerResolver () 설정 끝난 핸들러 리절버를 돌려줍니다.
abstract <T> T	getPort (Class <T> serviceEndpointInterface) getPort 메소드는 Stub를 돌려줍니다.
abstract <T> T	getPort (QName portName, Class <T> serviceEndpointInterface) getPort 메소드는 Stub를 돌려줍니다.
abstract Iterator <QName >	getPorts () 이 서비스에 의해 그룹화 된 서비스단점의 QName 리스트의 Iterator 를 돌려준다
abstract QName	getServiceName () 이 서비스의 이름을 가져옵니다.
abstract URL	getWSDLDocumentLocation () 이 서비스의 WSDL 문서의 위치를 가져옵니다.
abstract void	setExecutor (Executor executor) 이 Service 인스턴스의 executor 를 설정합니다.
abstract void	setHandlerResolver (HandlerResolver handlerResolver) 이 Service 인스턴스의 HandlerResolver 를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

ServiceDelegate

protected ServiceDelegate()

메소드의 상세

getPort

public abstract <T> T getPort(QName  portName,
                              Class <T> serviceEndpointInterface)

getPort 메소드는 Stub를 돌려줍니다. 서비스 클라이언트는, 이 Stub를 사용해 타겟 서비스단점의 조작을 호출합니다. serviceEndpointInterface 는, 작성된 동적 프록시 또는 Stub 인스턴스에 의해 지원되는 서비스단점인터페이스를 지정합니다.

파라미터:

portName - WSDL 서비스 기술내의 서비스단점의 수식명

serviceEndpointInterface - 동적 프록시 또는 Stub 인스턴스에 의해 지원되고 있는 서비스단점인터페이스

반환값:

지정된 서비스단점인터페이스를 지원하는 Object Proxy 인스턴스

예외:

WebServiceException - 이 예외는, 다음의 경우에 throw 된다

• 프록시의 작성으로 에러가 발생했을 경우
• 이 메소드가 필요로 하는 WSDL 메타데이타가 부족한 경우
• 옵션으로서 부정한 serviceEndpointInterface 또는 portName 가 지정되었을 경우

관련 항목:

Proxy , InvocationHandler

getPort

public abstract <T> T getPort(Class <T> serviceEndpointInterface)

getPort 메소드는 Stub를 돌려줍니다. 파라미터 serviceEndpointInterface 는, 반환값의 프록시에 의해 지원되는 서비스단점인터페이스를 지정합니다. 이 메소드의 구현에서는, JAX-WS 실행시 시스템이 프로토콜 바인딩 ( 및 포트)을 선택해, 거기에 따라서 프록시의 설정을 실시합니다. 반환값의 프록시를, 클라이언트가 다시 설정하지 않게 해 주세요.

파라미터:

serviceEndpointInterface - 서비스단점인터페이스

반환값:

지정된 서비스단점인터페이스를 지원하는 객체 인스턴스

예외:

WebServiceException -

• 프록시의 작성중에 에러가 있었을 경우
• 이 메소드가 필요로 하는 WSDL 메타데이타가 부족한 경우
• 옵션으로서 부정한 serviceEndpointInterface 가 지정되었을 경우

addPort

public abstract void addPort(QName  portName,
                             String  bindingId,
                             String  endpointAddress)

서비스의 새로운 포트를 작성합니다. 이 방법으로 작성된 포트는, WSDL 포트형 정보를 포함하지 않고,Dispatch 인스턴스를 작성하기 위해서 마셔 사용할 수 있습니다.

파라미터:

portName - 타겟 서비스단점의 수식명

bindingId - 바인딩의 URI 식별자

endpointAddress - 타겟 서비스단점의 URI 형식의 주소

예외:

WebServiceException - 포트의 작성으로 에러가 발생했을 경우

관련 항목:

SOAPBinding.SOAP11HTTP_BINDING , SOAPBinding.SOAP12HTTP_BINDING , HTTPBinding.HTTP_BINDING

createDispatch

public abstract <T> Dispatch <T> createDispatch(QName  portName,
                                               Class <T> type,
                                               Service.Mode  mode)

사용자가 선택한 객체로 사용하는 Dispatch 인스턴스를 작성합니다.

파라미터:

portName - 타겟 서비스단점의 수식명

type - 메세지 또는 메세지 유료 하중에 사용되는 객체의 클래스. 구현은, javax.xml.transform.Source 와 javax.xml.soap.SOAPMessage 를 지원할 필요가 있는

mode - 작성된 발송인스탄스가 메세지 지향일까 유료 하중 지향인지를 제어한다. 즉, 사용자가 완전한 프로토콜 메세지를 취급하는지, 메세지 유료 하중을 취급하는지를 제어한다. 예를 들어, SOAP 프로토콜을 사용하는 경우, 이 파라미터는, 사용자가 SOAP 메세지를 취급하는지, SOAP 본체의 컨텐츠를 취급하는지를 제어한다. 형태가 SOAPMessage 의 경우, Mode 는 MESSAGE 가 아니면 안된다

반환값:

Dispatch 인스턴스

예외:

WebServiceException - Dispatch 객체의 작성으로 에러가 발생했을 경우

관련 항목:

Source , SOAPMessage

createDispatch

public abstract Dispatch <Object > createDispatch(QName  portName,
                                                JAXBContext  context,
                                                Service.Mode  mode)

JAXB 생성 객체로 사용하는 Dispatch 인스턴스를 작성합니다.

파라미터:

portName - 타겟 서비스단점의 수식명

context - 메세지 또는 메세지 유료 하중의 정렬화와 비정렬화에 사용되는 JAXB 문맥

mode - 작성된 발송인스탄스가 메세지 지향일까 유료 하중 지향인지를 제어한다. 즉, 사용자가 완전한 프로토콜 메세지를 취급하는지, 메세지 유료 하중을 취급하는지를 제어한다. 예를 들어, SOAP 프로토콜을 사용하는 경우, 이 파라미터는, 사용자가 SOAP 메세지를 취급하는지, SOAP 본체의 컨텐츠를 취급할지 어떨지를 제어한다

반환값:

Dispatch 인스턴스

예외:

ServiceException - Dispatch 객체의 작성으로 에러가 발생했을 경우

관련 항목:

JAXBContext

getServiceName

public abstract QName  getServiceName()

이 서비스의 이름을 가져옵니다.

반환값:

이 서비스의 수식명

getPorts

public abstract Iterator <QName > getPorts()

이 서비스에 의해 그룹화 된 서비스단점의 QName 리스트의 Iterator 를 돌려준다

반환값:

javax.xml.namespace.QName 형의 요소를 포함한 java.util.Iterator 를 돌려준다

예외:

WebServiceException - 이 서비스 클래스가 필요한 WSDL 메타데이타에 액세스 할 수 없는 경우

getWSDLDocumentLocation

public abstract URL  getWSDLDocumentLocation()

이 서비스의 WSDL 문서의 위치를 가져옵니다.

반환값:

이 서비스의 WSDL 문서의 위치를 나타내는 URL

getHandlerResolver

public abstract HandlerResolver  getHandlerResolver()

설정 끝난 핸들러 리절버를 돌려줍니다.

반환값:

HandlerResolver 이 Service 인스턴스에 의해 사용되고 있는 HandlerResolver, 또는, 존재하지 않는 경우,null

setHandlerResolver

public abstract void setHandlerResolver(HandlerResolver  handlerResolver)

이 Service 인스턴스의 HandlerResolver 를 설정합니다.

핸들러 리절버가 존재하는 경우, 작성된 각 프록시 또는 발송인스탄스에 대해 한 번 핸들러 리절버가 불려 가 리절버에 의해 반환된 핸들러 체인이 인스턴스로 설정됩니다.

파라미터:

handlerResolver - 후에 작성되는 모든 프록시 또는 발송객체에 대해서 사용되는 HandlerResolver

관련 항목:

HandlerResolver

getExecutor

public abstract Executor  getExecutor()

이 Service 인스턴스의 Executor 를 돌려줍니다. Executor 는, 콜백을 필요로 하는 모든 비동기 호출에 사용됩니다.

반환값:

콜백을 호출하기 위해서(때문에) 사용된다 java.util.concurrent.Executor

관련 항목:

Executor

setExecutor

public abstract void setExecutor(Executor  executor)

이 Service 인스턴스의 executor 를 설정합니다. Executor 는, 콜백을 필요로 하는 모든 비동기 호출에 사용됩니다.

파라미터:

executor - 콜백을 호출하기 위해서(때문에) 사용된다 java.util.concurrent.Executor

예외:

SecurityException - 시큐리티상의 이유에 의해, 인스턴스가 executor 를 설정하는 것을 지원하고 있지 않는 경우 (예를 들어, 필요한 액세스권이 부족한 경우)

관련 항목:

Executor