Пакет javax.xml.ws.spi.http

Предоставляет HTTP SPI, используемый для портативного развертывания веб-служб JAX-WS в контейнерах (например, контейнерах сервлетов). Этот SPI предназначен не для конечных разработчиков, а предоставляет способ для разработчиков контейнеров портативно развертывать службы JAX-WS.

Портативное развертывание выполняется следующим образом:

1. Контейнер создает объекты Endpoint для приложения. Необходимая информация для создания объектов Endpoint может быть получена из файлов описания развертывания веб-службы.
2. Контейнеру необходимо создать объекты HttpContext для развертывания. Например, HttpContext можно создать, используя конфигурацию сервлета (например, url-шаблон) для веб-службы в случае контейнера сервлетов.
3. Затем публикует все конечные точки, используя Endpoint.publish(HttpContext). Во время publish(), среда выполнения JAX-WS регистрирует обратный вызов HttpHandler для обработки входящих запросов или объектов HttpExchange. Объект HttpExchange инкапсулирует HTTP-запрос и ответ.

Container                               JAX-WS runtime
  ---------                               --------------
  1. Creates Invoker1, ... InvokerN
  2. Provider.createEndpoint(...)     --> 3. creates Endpoint1
     configures Endpoint1
     ...
  4. Provider.createEndpoint(...)     --> 5. creates EndpointN
     configures EndpointN
  6. Creates ApplicationContext
  7. creates HttpContext1, ... HttpContextN
  8. Endpoint1.publish(HttpContext1)  --> 9. creates HttpHandler1
                                          HttpContext1.setHandler(HttpHandler1)
     ...
 10. EndpointN.publish(HttpContextN)  --> 11. creates HttpHandlerN
                                         HttpContextN.setHandler(HttpHandlerN)

Обработка запросов выполняется следующим образом (для каждого запроса):

Container                               JAX-WS runtime
  ---------                               --------------
  1. Creates a HttpExchange
  2. Gets handler from HttpContext
  3. HttpHandler.handle(HttpExchange) --> 4. reads request from HttpExchange



  The portable undeployment is done as below:

  Container
  ---------
  1. @preDestroy on instances
  2. Endpoint1.stop()
  ...
  3. EndpointN.stop()