Технология создания веб-сервисов на базе стандарта JAX-WS & JAXB презентация

ноября 2007

данными в виде структурированного XML.
Название пошло от основного протокола передачи, использовавшегося на заре создания технологии – HTTP.
Сейчас в качестве протоколов передачи кроме HTTP, могут использоваться JMS (протокол передачи сообщений Java), SMTP, TCP…
Даже данные могут передаваться не в виде XML.
Так что понятие «веб-сервис» имеет очень расплывчатое значение на сегодняшний день и включает в себя огромное количество понятий.
Но разговор будет идти о стандарте описания веб-сервиса – о WSDL…

описать веб-сервис в языке независимом от платформы и от реализации.
Данная лекция описывает стандарт WSDL 1.1, который доступен по адресу [TODO].

-->

и быть скомпонованными в различной конфигурации в зависимости от потребностей авторов веб-сервиса.
Использование данной техники распространено в крупных проектах, многие веб-сервисы имеют общие типы данных и отличаются только в деталях реализации или привязки к протоколу.

name="sessionId" type="xs:string">



…..

в терминах, описанных в элементе Types.









…

message="tns:startSessionResponse"/>

…

и portType, привязываются к конкретному протоколу.

…

сервис.

{
// парсинг XML
// работа над данными
String result = результат работы
return result;
}
}

через клиента или другое средство. Например через XMLSpy:

информации о структуре передаваемого XML.
Информация о том, что передаётся и в каком виде, должна быть у пользователя веб-сервиса ЗАРАНЕЕ. Использовать веб-сервис без этого не предоставляется возможным.

описание веб-сервиса на уровне интерфейсов взаимодействия.
Возможность генерации клиента другим программистом независимо от автора.
Совместимость клиента и сервиса (изменении сервиса в рамках допустимого).
Возможность генерации специальных класса для указанных типов, облегчающих работу с XML.
Устранение необходимости работы экранирования строк, на наличие служебных символов.

partName = "response")
public AddRouteResponseType addRoute(@WebParam(name = "addRouteRequest", targetNamespace = "http://gpsmonitor.net.magnetosoft.ru/", partName = "request")
AddRouteRequestType request)
throws AddRouteFault;

@WebMethod
@WebResult(name = "getScaleResponse", targetNamespace = "http://gpsmonitor.net.magnetosoft.ru/", partName = "response")
public ScaleResponseType getScale(@WebParam ( name = "getScaleRequest", targetNamespace = "http://gpsmonitor.net.magnetosoft.ru/", partName = "request")
GetScaleRequest request)
throws GetScaleFault;

и возвращаемого результат сгенерированные классы, обрамлённые JAXB аннотациями.
При вызове метода классы с наполненными данными преобразуются в XML, а результат из XML разбирается в те же сгенерированные классы.
Как результат - необходимость работы с XML, переносящимся между веб-сервисами, отпадает полностью.

сгенерированного интерфейса сервиса

P.S.: Данный вариант детально не рассматривается, так как требует детального знания языка описания XML – «XML Schema». Именно на его основе сделаны модули «Search», «Catalogue» платформы MAGNET.

для обмена являются обычными JavaBean’ами, с аннотациями JAXB, которые определяют в какой XML они превратятся.

package edu.sefer.home.ws;
import java.math.BigDecimal;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
@XmlRootElement
public class XmlResult {
@XmlElement
int result;
@XmlElement
BigDecimal resultBD;
}

{
@XmlElement
String inputString;

@XmlElement
Date inputDate;

@XmlElement
int inputInt;
}

с входящими и выходящими параметрами в виде классов носителей-данных.

package edu.sefer.home.ws;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService
public class UsualWS {
@WebMethod
public XmlResult method01(XmlData data) {
return null;
}
}

подходу.

«javax.xml.ws.Provider» на серверной стороне
Использование интерфейса «javax.xml.ws.Dispatch» на клиентской стороне
Использование типа «xsd:anyType» для описания ЛЮБОГО XML, если его структура не зафиксирована.


P.S.: Данный вариант детально не рассматривается, так как требует детального знания языка описания XML – «XML Schema» и деталей работы соответствующих интерфейсов. Но именно на его основе сделан модуль «EntityManager» платформы MAGNET.

и устоялись.
Вариант же 3 позволяет передавать динамически компонуемый XML максимально быстро и использовать его максимально эффективно и гибко.
Хотя надо так же заметить, что при использовании некоторых подходов, передавать динамический XML можно и в вариантах 1 и 2. Но надо заметить, что дополнительная нагрузка (на обработку сообщений на уровне самой библиотеки) при этом возрастает многократно.