31.2. 서비스 게시에 사용되는 API
31.2.1. 개요
javax.xml.ws.Enddpoint 클래스는 Cryostat-WS 서비스 공급자를 게시하는 작업을 수행합니다. 끝점을 게시하려면 다음을 수행합니다.
-
서비스 공급자에
대한끝점 오브젝트를 생성합니다. - 엔드포인트를 게시합니다.
- 애플리케이션이 종료되면 끝점을 중지합니다.
Endpoint 클래스는 서비스 공급자를 생성하고 게시하는 방법을 제공합니다. 또한 단일 메서드 호출에서 서비스 공급자를 생성하고 게시할 수 있는 메서드를 제공합니다.
31.2.2. 서비스 공급자 인스턴스화
서비스 공급자는 끝점 오브젝트를 사용하여 인스턴스화됩니다. 다음 방법 중 하나를 사용하여 서비스 공급자에 대한 끝점 오브젝트를 인스턴스화합니다.
-
static
EndpointcreateObjectimplementor이create()메서드는 지정된 서비스 구현에 대한 끝점을 반환합니다.Endpoint오브젝트는 구현 클래스의javax.xml.ws.BindingType주석에서 제공하는 정보를 사용하여 생성됩니다. 주석이 없으면 끝점에서 기본 Cryostat1.1/HTTP 바인딩을 사용합니다. -
static
EndpointcreateURIbindingIDObjectimplementorThiscreate()메서드는 지정된 바인딩을 사용하여 지정된 구현 오브젝트에 대한Endpoint오브젝트를 반환합니다. 이 메서드는javax.xml.ws.BindingType주석에서 제공하는 바인딩 정보가 있는 경우 재정의합니다.bindingID를 확인할 수 없거나null인 경우javax.xml.ws.BindingType에 지정된 바인딩이 끝점을 생성하는 데사용됩니다.bindingID또는javax.xml.ws.BindingType을 모두 사용할 수 없는 경우 끝점은 기본 Cryostat 1.1/HTTP 바인딩을 사용하여 생성됩니다. static
EndpointpublishStringaddressObjectimplementorpublish()메서드는 지정된 구현을 위해Endpoint개체를 생성하고 게시합니다.Endpoint오브젝트에 사용되는 바인딩은 제공된주소의 URL 체계에 따라 결정됩니다. 구현에 사용할 수 있는 바인딩 목록은 URL 스키마를 지원하는 바인딩에 대해 스캔됩니다. 하나가 발견되면Endpoint개체가 생성되고 게시됩니다. 하나를 찾을 수 없으면 메서드가 실패합니다.publish()를 사용하는 것은create()메서드 중 하나를 호출한 다음 ???TITLE??? 에서 사용되는publish()메서드를 호출하는 것과 동일합니다.
Endpoint 생성 메서드에 전달된 구현 오브젝트는 javax.jws.WebService 로 주석이 달린 클래스의 인스턴스여야 하며 SEI 구현 요구사항을 충족해야 합니다. 그렇지 않으면 javax.xml.ws.WebServiceProvider 로 주석이 달린 클래스의 인스턴스이고 공급자 인터페이스를 구현해야 합니다.
31.2.3. 서비스 공급자 게시
다음 끝점 방법 중 하나를 사용하여 서비스 공급자를 게시할 수 있습니다.
publishStringaddress이publish()메서드는 지정된 주소에 서비스 공급자를 게시합니다.중요주소의 URL 스키마는 서비스 공급자의 바인딩 중 하나와 호환되어야 합니다.-
publishObjectserverContext이publish()메서드는 지정된 서버 컨텍스트에 제공된 정보를 기반으로 서비스 공급자를 게시합니다. 서버 컨텍스트는 끝점의 주소를 정의해야 하며 컨텍스트는 서비스 공급자의 사용 가능한 바인딩 중 하나와도 호환되어야 합니다.
31.2.4. 게시된 서비스 공급자 중지
서비스 공급자가 더 이상 필요하지 않으면 stop() 메서드를 사용하여 중지해야 합니다. 예 31.1. “게시 끝점을 중지하는 방법” 에 표시된 stop() 메서드는 끝점을 종료하고 사용 중인 모든 리소스를 정리합니다.
예 31.1. 게시 끝점을 중지하는 방법
중지
끝점이 중지되면 다시 게시할 수 없습니다.
