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:
- Клиент формирует запрос, который преобразуется в SOAP-сообщение и передаётся по сети.
- Сервер принимает сообщение, преобразует его в 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