javax.xml.ws
클래스 Endpoint

java.lang.Object 
  javax.xml.ws.Endpoint

public abstract class Endpoint
extends Object 

Web 서비스단점.

단 점은, 이 클래스에 정의된 static 메소드를 사용해 작성됩니다. 단 점은 항상 1 개의 Binding 와 1 개의 implementor 에 결합되어 단 점의 작성시에 이 양쪽 모두가 설정됩니다.

단 점은, 발행 또는 미발행의 몇개의 상태를 취합니다. publish 메소드는, 단 점의 발행을 개시하기 위해서 사용할 수 있습니다. 발행이 개시되면(자), 착신 요구의 수락이 개시됩니다. 반대로,stop 메소드를 사용하면(자), 착신 요구의 수락을 중지해, 단 점을 정지시킬 수가 있습니다. 정지 후, 단 점을 다시 발행할 수 없습니다.

착신 요구를 발송 하기 위해서 사용되는 thread를 보다 강력하게 제어하기 위해(때문에),Executor 가 단 점으로 설정되는 일도 있습니다. 예를 들어,ThreadPoolExecutor 를 작성해, 단 점에 그것을 등록하는 것에 의해, 특정의 파라미터를 가지는 thread 풀을 유효하게 할 수가 있습니다.

포함 하는 Binding 를 사용해, 핸들러 체인을 설정할 수가 있습니다.

단 점은, 거기에 바인드 되고 있는 메타데이타 문서 (WSDL, XMLSchema 문서등)의 리스트를 포함하는 일이 있습니다. 발행시에, JAX-WS 구현은, implementor 에 존재하는 주석에 근거해 신규 생성하는 것이 아니라, 메타데이타의 가능한 한 대부분을 재사용하려고 합니다.

도입된 버젼:

JAX-WS 2.0

관련 항목:

Binding , BindingType , SOAPBinding , Executor

필드의 개요

static String	WSDL_PORT 표준 프로퍼티 :WSDL 포트의 이름.
static String	WSDL_SERVICE 표준 프로퍼티 :WSDL 서비스의 이름.

생성자 의 개요

Endpoint ()

메소드의 개요

static Endpoint	create (Object implementor) 지정된 implementor 객체를 가지는 단 점을 작성합니다.
static Endpoint	create (String bindingId, Object implementor) 지정된 바인딩형과 implementor 객체를 사용해 단 점을 작성합니다.
abstract Binding	getBinding () 이 단 점의 바인딩을 돌려줍니다.
abstract Executor	getExecutor () 이 Endpoint 인스턴스의 Executor 를 돌려줍니다.
abstract Object	getImplementor () 이 단 점의 구현 객체를 돌려줍니다.
abstract List <Source >	getMetadata () 서비스의 메타데이타 문서 리스트를 돌려줍니다.
abstract Map <String ,Object >	getProperties () 이 Endpoint 인스턴스의 프로퍼티 가방을 돌려줍니다.
abstract boolean	isPublished () 단 점이 발행되고 있는 상태의 경우, true 를 돌려줍니다.
abstract void	publish (Object serverContext) 지정된 서버 문맥으로 이 단 점을 발행합니다.
abstract void	publish (String address) 지정된 주소로 이 단 점을 발행합니다.
static Endpoint	publish (String address, Object implementor) 지정된 주소로, 지정된 implementor 객체의 단 점을 작성 및 발행합니다.
abstract void	setExecutor (Executor executor) 이 Endpoint 인스턴스의 executor 를 설정합니다.
abstract void	setMetadata (List <Source > metadata) 이 단 점의 메타데이타를 설정합니다.
abstract void	setProperties (Map <String ,Object > properties) 이 Endpoint 인스턴스의 프로퍼티 가방을 설정합니다.
abstract void	stop () 발행중의 이 단 점을 정지합니다.

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

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

필드의 상세

WSDL_SERVICE

public static final String  WSDL_SERVICE

표준 프로퍼티 :WSDL 서비스의 이름.

형태 :javax.xml.namespace.QName

관련 항목:

정수 필드치

WSDL_PORT

public static final String  WSDL_PORT

표준 프로퍼티 :WSDL 포트의 이름.

형태 :javax.xml.namespace.QName

관련 항목:

정수 필드치

생성자 의 상세

Endpoint

public Endpoint()

메소드의 상세

create

public static Endpoint  create(Object  implementor)

지정된 implementor 객체를 가지는 단 점을 작성합니다. BindingType 주석을 개입시켜 지정된 바인딩이 있는 경우, 그것을 사용하지 않으면 안되어, 그렇지 않은 경우, 디폴트의 SOAP 1.1 / HTTP 바인딩을 사용하지 않으면 안됩니다.

새롭게 작성된 단 점은, javax.xml.ws.Endpoint#publish(String) 및 javax.xml.ws.Endpoint#publish(Object) 메소드의 어느쪽이든을 호출하는 것에 의해 발행할 수 있습니다.

파라미터:

implementor - 단 점의 implementor

반환값:

새롭게 작성된 단 점

create

public static Endpoint  create(String  bindingId,
                              Object  implementor)

지정된 바인딩형과 implementor 객체를 사용해 단 점을 작성합니다.

새롭게 작성된 단 점은, javax.xml.ws.Endpoint#publish(String) 및 javax.xml.ws.Endpoint#publish(Object) 메소드의 어느쪽이든을 호출하는 것에 의해 발행할 수 있습니다.

파라미터:

bindingId - 사용하는 바인딩을 지정하는 URI. bindingID 가 null 로, BindingType 주석을 개입시켜 바인딩이 지정되어 있지 않다 경우, 디폴트의 SOAP 1.1 / HTTP 바인딩을 사용할 필요가 있는

implementor - 단 점의 implementor

반환값:

새롭게 작성된 단 점

getBinding

public abstract Binding  getBinding()

이 단 점의 바인딩을 돌려줍니다.

반환값:

이 단 점의 바인딩

getImplementor

public abstract Object  getImplementor()

이 단 점의 구현 객체를 돌려줍니다.

반환값:

이 단 점의 implementor

publish

public abstract void publish(String  address)

지정된 주소로 이 단 점을 발행합니다. 필요한 서버 인프라스트럭쳐(infrastructure)는, JAX-WS 구현에 의해, 디폴트 설정을 사용해 작성 및 설정됩니다. 서버 설정을 보다 강력하게 제어하려면 , javax.xml.ws.Endpoint#publish(Object) 메소드를 대신에 사용해 주세요.

파라미터:

address - 사용하는 주소를 지정하는 URI. 이 주소는, 단 점작성시로 지정한 바인딩에 대응 하고 있지 않으면 안 된다

예외:

IllegalArgumentException - 지정한 주소 URI 를 단 점의 바인딩과 함께 사용할 수 없는 경우

IllegalStateException - 단 점이 이미 발행되고 있다, 또는, 이미 정지되고 있는 경우

publish

public static Endpoint  publish(String  address,
                               Object  implementor)

지정된 주소로, 지정된 implementor 객체의 단 점을 작성 및 발행합니다.

필요한 서버 인프라스트럭쳐(infrastructure)는, JAX-WS 구현에 의해, 디폴트 설정을 사용해 작성 및 설정됩니다. 서버 설정을 보다 강력하게 제어하려면 , javax.xml.ws.Endpoint#create(String, Object) 및 javax.xml.ws.Endpoint#publish(Object) 메소드를 대신에 사용해 주세요.

파라미터:

address - 사용하는 주소, 및, 트랜스폴트 또는 프로토콜을 지정하는 URI. http: URI 가, 사용되고 있는 SOAP 1.1/HTTP 바인딩 에 귀착할 필요가 있다. 구현이 그 외의 URI schema를 지원 하는 일도 가능한

implementor - 단 점의 implementor

반환값:

새롭게 작성된 단 점

publish

public abstract void publish(Object  serverContext)

지정된 서버 문맥으로 이 단 점을 발행합니다. 서버 문맥은, 서버 인프라스트럭쳐(infrastructure) 및 특정의 트랜스폴트의 애드레싱 정보를 캡슐화합니다. 이 메소드의 호출을 성공시키려면 , 거기에 인수로서 건네받는 서버 문맥이 단 점의 바인딩과 호환성이 없으면 안됩니다.

파라미터:

serverContext - 단 점을 발행하기 위해서 사용된다 서버 문맥을 나타내는 객체

예외:

IllegalArgumentException - 지정된 서버 문맥이 구현에 의해 지원되어 있지 않은, 또는, 단 점의 바인딩과 함께 사용할 수 없는 것이 판명되었을 경우

IllegalStateException - 단 점이 이미 발행되고 있다, 또는, 이미 정지되고 있는 경우

stop

public abstract void stop()

발행중의 이 단 점을 정지합니다. 단 점이 발행되어 있지 않은 경우, 이 메소드는 아무것도 하지 않습니다.

isPublished

public abstract boolean isPublished()

단 점이 발행되고 있는 상태의 경우, true 를 돌려줍니다.

반환값:

단 점이 발행되고 있는 상태의 경우,true

getMetadata

public abstract List <Source > getMetadata()

서비스의 메타데이타 문서 리스트를 돌려줍니다.

반환값:

List<javax.xml.transform.Source> 서비스의 메타데이타 문서의 리스트

setMetadata

public abstract void setMetadata(List <Source > metadata)

이 단 점의 메타데이타를 설정합니다.

파라미터:

metadata - 단 점의 메타데이타 정보를 포함한 XML 문서 소스 (WSDL 또는 XML Schema 문서 등) 의 리스트

예외:

IllegalStateException - 단 점이 이미 발행되고 있는 경우

getExecutor

public abstract Executor  getExecutor()

이 Endpoint 인스턴스의 Executor 를 돌려줍니다. Executor 는, 착신 요구를 implementor 객체에 발송 하기 위해서 사용됩니다.

반환값:

요구를 발송 하기 위해서 사용된다 java.util.concurrent.Executor

관련 항목:

Executor

setExecutor

public abstract void setExecutor(Executor  executor)

이 Endpoint 인스턴스의 executor 를 설정합니다. Executor 는, 착신 요구를 implementor 객체에 발송 하기 위해서 사용됩니다. 이 Endpoint 가 publish(Object) 메소드를 사용해 발행되어 지정한 서버 문맥이 그것 자신의 thread 처리 동작을 정의하고 있는 경우, Executor 는 무시되는 일이 있습니다.

파라미터:

executor - 요구를 발송 하기 위해서 사용된다 java.util.concurrent.Executor

예외:

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

관련 항목:

Executor

getProperties

public abstract Map <String ,Object > getProperties()

이 Endpoint 인스턴스의 프로퍼티 가방을 돌려줍니다.

반환값:

Map<String, Object>. 이 인스턴스에 관련지을 수 있고 있는 프로퍼티 가방

setProperties

public abstract void setProperties(Map <String ,Object > properties)

이 Endpoint 인스턴스의 프로퍼티 가방을 설정합니다.

파라미터:

properties - 이 인스턴스에 관련지을 수 있고 있다 프로퍼티 가방