Spec-Zone .ru спецификации, руководства, описания, API

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

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

См.:
Описание

Сводка класса

HttpContext	HttpContext представляет отображение между корневым путем URI веб-сервиса к a HttpHandler который вызывается, чтобы обработать запросы, предназначенные для того пути на связанном контейнере.
HttpExchange	Этот class инкапсулирует полученный запрос HTTP и ответ, который будет сгенерирован в одном обмене.
HttpHandler	Обработчик, который вызывается, чтобы обработать запросы HTTP.

Пакет javax.xml.ws.spi.http Описание

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

Переносимое развертывание делается как указано ниже:

1. Контейнер создает Endpoint объекты для приложения. Необходимая информация, чтобы создать объекты Конечной точки может быть получена от файлов дескриптора развертывания веб-сервиса.
2. Контейнер должен создать HttpContext объекты для развертывания. Например, HttpContext мог быть создан, используя конфигурацию сервлета (для например, образца URL) для веб-сервиса в случае контейнера сервлета.
3. Затем публикует все использование конечных точек Endpoint.publish(HttpContext). Во время публикуют (), время выполнения JAX-WS регистрирует a 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
                                      <-- 5. Calls Invoker
  6. Invokes the actual instance
                                          7. Writes the response to HttpExchange
  

The portable undeployment is done as below:

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

Since:

JAX-WS 2.2

Author:

Jitendra Kotamraju