javax.xml.ws
클래스 Service

java.lang.Object 
  javax.xml.ws.Service

public class Service
extends Object 

Service 객체는, Web 서비스의 클라이언트 뷰를 제공합니다.

Service 는, 다음의 팩토리로서 동작합니다.

• 타겟 서비스단점의 프록시.
• 원격 조작의 동적인 메세지 지향의 호출을 위한 javax.xml.ws.Dispatch 인스턴스.

서비스로 이용 가능한 포트는,getPorts 메소드를 사용해 열거할 수 있습니다. 혹은, 서비스단점인터페이스를 단항 getPort 메소드에 건네주어, 적합하는 포트를 실행시에 선택시킬 수가 있습니다.

Service 에 의해 작성되는 모든 객체의 핸들러 체인을 HandlerResolver 를 사용해 설정할 수가 있습니다.

비동기적 콜백을 발송 하기 위해서 사용되는 thread를 보다 강력하게 제어하기 위해(때문에),Executor 를 서비스로 설정할 수가 있습니다. 예를 들어,ThreadPoolExecutor 를 작성해, 서비스에 그것을 등록하는 것에 의해, 특정의 파라미터를 수반하는 thread 풀을 유효하게 할 수 있습니다.

도입된 버젼:

JAX-WS 2.0

관련 항목:

Provider , HandlerResolver , Executor

상자의 클래스의 개요

static class

Service.Mode 동적 클라이언트 또는 서비스의 방향입니다.

생성자 의 개요

protected

Service (URL wsdlDocumentLocation, QName serviceName)

메소드의 개요

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

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

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

생성자 의 상세

Service

protected Service(URL  wsdlDocumentLocation,
                  QName  serviceName)

메소드의 상세

getPort

public <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 <T> T getPort(Class <T> serviceEndpointInterface)

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

파라미터:

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

반환값:

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

예외:

WebServiceException -

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

addPort

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

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

파라미터:

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

bindingId - 바인딩의 캐릭터 라인 식별자

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

예외:

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

관련 항목:

SOAPBinding.SOAP11HTTP_BINDING , SOAPBinding.SOAP12HTTP_BINDING , HTTPBinding.HTTP_BINDING

createDispatch

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

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

파라미터:

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

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

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

반환값:

Dispatch 인스턴스

예외:

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

관련 항목:

Source , SOAPMessage

createDispatch

public 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 QName  getServiceName()

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

반환값:

이 서비스의 수식명

getPorts

public Iterator <QName > getPorts()

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

반환값:

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

예외:

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

getWSDLDocumentLocation

public URL  getWSDLDocumentLocation()

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

반환값:

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

getHandlerResolver

public HandlerResolver  getHandlerResolver()

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

반환값:

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

setHandlerResolver

public void setHandlerResolver(HandlerResolver  handlerResolver)

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

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

파라미터:

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

관련 항목:

HandlerResolver

getExecutor

public Executor  getExecutor()

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

반환값:

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

관련 항목:

Executor

setExecutor

public void setExecutor(Executor  executor)

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

파라미터:

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

예외:

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

관련 항목:

Executor

create

public static Service  create(URL  wsdlDocumentLocation,
                             QName  serviceName)

Service 인스턴스를 작성합니다. 지정된 WSDL 문서의 위치와 서비스 수식명은, 일의로 wsdl:service 요소를 식별할 필요가 있습니다.

파라미터:

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

serviceName - 서비스의 QName

예외:

WebServiceException - 지정한 서비스의 작성으로 에러가 발생했을 경우

create

public static Service  create(QName  serviceName)

Service 인스턴스를 작성합니다.

파라미터:

serviceName - 서비스의 QName

예외:

WebServiceException - 지정한 서비스의 작성으로 에러가 발생했을 경우