Найти

Вы здесь:

JAX-WS (Java API for XML Web Services) — это прикладной программный интерфейс языка Java для создания веб-служб на основе XML. Технология входит в состав Jakarta EE (ранее Java EE) и представляет собой эволюцию предыдущего стандарта JAX-RPC.

Цель JAX-WS — упростить процесс создания и использования веб-сервисов путём автоматизации большинства низкоуровневых задач.

Ключевые компоненты архитектуры

  • Endpoint — точка доступа, опубликованная сервером, доступная клиентам по URL;
  • Service — абстракция на стороне клиента, представляющая удалённый сервис;
  • Port — конкретная реализация сервиса;
  • WSDL — описание сервиса на языке XML, определяющее интерфейс;
  • SOAP — протокол обмена сообщениями, основанный на XML.

Технология JAX-WS — стандарт, описан в JSR 224.

Принцип работы

Работа JAX-WS строится на концепции «контракта» — формализованного описания интерфейса сервиса, выраженного в WSDL-документе. Этот документ содержит полную информацию о доступных операциях, типах данных и протоколе взаимодействия.

Процесс взаимодействия в JAX-WS:

  1. Клиент формирует запрос, который преобразуется в SOAP-сообщение и передаётся по сети.
  2. Сервер принимает сообщение, преобразует его в Java-объекты, обрабатывает и формирует ответ, который также передаётся клиенту в виде SOAP-сообщения.

Особенности JAX-WS

  • Возможность выбора между двумя путями разработки: «снизу вверх» (программист разрабатывает endpoint-классы сам) и «сверху вниз» (Java-классы генерируются по WSDL).
  • Поддержка стандартов WS-* (например, WS-Security, WS-ReliableMessaging).

Аннотации

JAX-WS использует аннотации, описанные в JSR 181, для отображения POJO-классов на WSDL. Некоторые из них:

  • @WebService — указывает на то, что Java-класс (или интерфейс) является веб-службой;
  • @WebMethod — позволяет настроить, как будет отображаться метод класса на операцию веб-службы;
  • @WebParam — позволяет настроить, как будет отображаться конкретный параметр операции на WSDL-часть и XML-элемент;
  • @WebResult — позволяет настроить, как будет отображаться возвращаемое значение операции на WSDL-часть и XML-элемент;
  • @Oneway — указывает на то, что операция является односторонней, то есть не имеет выходных параметров;
  • @SOAPBinding — позволяет настроить, как будет отображаться веб-служба на протокол SOAP.

Пример: https://github.com/cherepakhin/soap-producer-web-service