SOAP. Java. (Лекция 22)

SOAP

Интернет объединяет в себе много различных платформ, а информация содержится в

Основные положения модели веб-сервисов
Веб-сервисы являются концепцией создания таких приложений, функции которых

XML является фундаментом для создания большинства технологий, связанных с веб-сервисами.
Для удаленного

Согласно определению W3C, веб-сервисы это приложения, которые доступны по протоколам, которые

Веб-сервисы позиционируются как программное обеспечение промежуточного слоя.
Использовать веб-сервисы могут как

2. Веб-сервисы как средство интеграции.
То есть, использование веб-сервиса как

Рассмотрим пример создания и развертывания Веб –сервиса.
Пусть Веб-сервис возвращает строку

Таким образом, логика Веб-сервиса заключена в методе myMethod.
Клиент, вызывающий данный Веб-сервис

//Создаем клиента для использование Web-сервиса
Service service = new Service();

//Определяем тип возвращаемого методом значения,в XML формате
call.setReturnType(org.apache.axis.encoding.
XMLType.XSD_STRING);
//Вызываем

Рассмотрим процедуру развертывания данного Веб-сервиса.
Для использования данного Веб-сервиса необходимы:
Apache Tomcat
Apache axis(axis2)
Пакет

2. Копируем папку axis из директории c:\axis\webapp в директорию c:\tomcat\webapp
3. Копируем

5. Создаем папку c:\axis\samples\mysimple\ и копируем туда файлы Client.java и HelloService.java
6.

Файл deploy.wsdd имеет вид:

Файл undeploy.wsdd имеет вид:
xmlns="http://xml.apache.org/axis/wsdd/">


8. Создаем папку mysimple

11. Развертываем Веб-сервис
c:\axis\samples\mysimple\>java –cp “все необходимые jar файлы из папки c:\tomcat\webapps\axis\WEB-INF\lib\”

12. Запускаем клиент
>java –cp “все необходимые jar файлы из папки c:\tomcat\webapps\axis\WEB-INF\lib\”

Пример SOAP сообщения:
xmlns:t="www.example.com">



2011
February

Конверт (SOAP Envelope)
SOAP Envelope является самым «верхним» элементом SOAP сообщения.
Содержит

Envelope может иметь необязательный дочерний элемент Header c тем же пространством

Заголовок SOAP (SOAP Header)
Первый прямой дочерний элемент конверта.
Не обязательный.
Заголовок кроме

Атрибут encodingStyle
В SOAP-сообщениях могут передаваться данные различных типов (числа, даты, массивы,

Атрибут actor
Тип данных URI.
Задает адрес конкретного SOAP-сервера, которому предназначено сообщение.

В версии 1.2 атрибут actor заменен атрибутом role, потому что в

Роль http://www.w3.org/2003/05/soap-envelope/role/none не должен играть ни один SOAP-узел.
Атрибут mustUnderstand
Тип данных —

Атрибут relay
Тип данных — boolean.
Показывает, что заголовочный блок, адресованный SOAP-

Рассмотрим пример:

env:role="http://www.w3.org/2003/05/
soapenvelope/role/ultimateReceiver"
env:mustUnderstand="true">
5

SOAP-сообщения с вложениями
Существуют ситуации, когда клиент и сервер должны обмениваться данными

Этот протокол определяет пересылку SOAP-сообщения внутри MIME-сообщения, состоящего из нескольких частей.

Рассмотрим пример:
MIME-Version: 1.0
Content-Type: Multipart/Related;
boundary=MIME_boundary;
type="application/xop+xml";
start="";
start-info="text/xml"
Content-Description: An XML document with
binary

Content-Type: application/xop+xml;
charset=UTF-8;
type="text/xml"
Content-Transfer-Encoding: 8bit
Content-ID: soapmsg.xml@daily-moon.com


. .

--MIME_boundary
Content-Type: image/jpg
Content-Transfer-Encoding: binary
Content-ID:
// двоичное представление файла изображения
--MIME_boundary--

Axis2

В основе инфраструктуры Web-сервисов Apache Axis2 лежит новая модель XML документов

API модели AXIOM ближе всего к DOM по общим свойствам, но

Такое структурирование методов доступа и навигации отвечает работе по построению дерева

Естественно, можно использовать SAX и DOM для взаимодействия с AXIOM.
AXIOM использует

Eran Chinthaka
Axis2

Предположим пользователь хочет получить проект первого служащего.
Таким образом, в памяти достаточно

import org.apache.axiom.om.*;
import org.apache.axiom.om.impl.builder
.StAXOMBuilder;
import java.io.*;
import javax.xml.stream.*;
import java.util.*;
public class Main {
public

//Получаем дочерние элементы у первого Employees
OMElement employeesChild=childElement.getFirstElement();
int i=0;
for (Iterator iter =

Одним из наиболее интересных свойств AXIOM является его встроенная поддержка стандартов

XOP работает с данными, представленными в системе кодировки символов с основанием

Язык WSDL
Для описания интерфейса программной компоненты, включая спецификацию корректных сообщений, был

Описание типов передаваемых данных.
При использовании кодирования SOAP
Document

Описание типов портов (идентификаторов программных компонент), с каждым из которых связывается

Рассмотрим описание на языке WSDL интерфейса компоненты, которое содержит два сервиса

В элементе wsdl:types описываются все типы данных.
Тип Add будет связан

name="a" type="s:int"

Типы SumList и SumListResponse предназначены для сообщений сервиса сложения списка чисел.

name="int"

В элементах wsdl:message типы данных связываются с идентификаторами сообщений.

В элементе wsdl:portType описываются абстрактные операции и используемые ими сообщения.

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
Операция SumList складывает несколько
чисел

В элементе wsdl:binding операции связываются с транспортным протоколом (HTTP), версией протокола

В элементе wsdl:service интерфейс программной компоненты связывается с типом порта, с

Стоит заметить, что в настоящий момент существует два различных способа представления

Получение кода из WSDL
В состав Axis2 входит инструмент WSDL2Java, служащий

-o path — Определяет директорию, в которой будут создаваться классы и

Формирование WSDL из кода
В состав Axis2 также входит инструмент Java2WSDL,

В Axis2 (начиная с версии 1.2) реализована полная поддержка нескольких вариантов

В WSDL2Java реализована полная поддержка формирования кода ADB, в том числе

Создадим абстрактный класс, в котором определена операция сложения
package hello;
public abstract

package hello;
public class Result{
private int res;
public void setRes(int r){

Как результат получим следующий wsdl файл:


elementFormDefault="qualified"

elementFormDefault="qualified" targetNamespace="http://hello">

element="ns:addResponse"/>

type="ns:HelloPortType">
transport="http://schemas.xmlsoap.org/soap/http"
style="document"/>

type="ns:HelloPortType">
transport="http://schemas.xmlsoap.org/soap/http"
style="document"/>

type="ns:HelloPortType">

binding="ns:HelloSoap11Binding">
location="http://localhost:8080/axis2/services/Hello"/>

5. Создаем скелет Web сервиса на основе wsdl файла Hello.wsdl, созданного

7. Компилируем и создаем пакет Hello.aar, используя ant. build.xml создается автоматически.
8.

11.Разворачиваем Web сервис, заходя по ссылке
http://localhost:8086/axis2/axis2-admin/upload
и выбирая файл

HelloStub.AddResponse resp=stub.add(add);
System.out.println(resp.get_return().getRes()); } catch (org.apache.axis2.AxisFault e) {
e.printStackTrace
}catch(java.rmi.RemoteException

XMLBeans
XMLBeans - это общая среда обработки XML, в состав которой

XMLBeans отличается от ADB тем, что в ней добавляется класс для

Рассмотрим тот же пример с сложением двух целых чисел, что и

package hello;
public class HelloSkeleton{
public hello.AddResponseDocument add(
hello.AddDocument add )

Шаг 7. Компилируем и создаем пакет Hello.aar, используя ant. build.xml создается

Шаг 9-11 аналогичны ADB.
Шаг 12. Клиент, обращающийся к Web сервису будет

hello.AddResponseDocument resp= stub.add(adds);
System.out.println(resp.getAddResponse()
.getReturn().getRes());
}catch (org.apache.axis2.AxisFault e) {
e.printStackTrace();

Restful services

Архитектура REST отличается своей простотой, требуя от приложений обеспечить только

JAX-RS задает унифицированный способ описания ресурсов на основе своей модели программирования.

Корневые ресурсы
Корневыми ресурсами являются Java-классы, отмеченные аннотацией @Path.
Эта аннотация включает

Дочерние ресурсы
Дочерними ресурсами (subresources) являются Java-классы, полученные в результате вызова локатора.

Пример дочернего ресурса в JAX-RS
import javax.ws.rs.GET;
public class Department {

Пример метода ресурса в JAX-RS
import java.util.List;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
@Path(value="/contacts")

Методы дочерних ресурсов
Методы дочерних ресурсов аналогичны методам ресурсов за тем исключением,

Локаторы дочерних ресурсов
Локаторы дочерних ресурсов представляют собой методы, служащие для уточнения

Пример локатора дочернего ресурса в JAX-RS
@Path(value="/contacts")
public class ContactsResource {
@GET

Аннотации
Рассмотрим основные аннотации и варианты их применения.
Аннотация @Path
Аннотация @Path используется для

@Path(value="/contacts")
public class ContactsResource {
@GET @Path(value="/{emailAddress:.+@.+\\.[a-z]+}")
public ContactInfo

Аннотации @GET, @POST, @PUT, @DELETE, @HEAD
Аннотации @GET, @POST, @PUT, @DELETE и

Объявление новой аннотации, соответствующей HTTP-запросам типа GET
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import

Аннотации @Consumes и @Produces
Аннотация @Consumes задает типы содержимого MIME, принимаемые ресурсом,

Примеры использования аннотаций @Consumes/@Produces
@Path(value="/contacts")
public class ContactsResource {
@GET

Методы getByEmailAddress и addContactInfo, могут обрабатывать запросы с типом содержимого text/xml

Провайдеры
Провайдерами в JAX-RS называются компоненты, определяющие три ключевых аспекта в поведении

Провайдер MessageBodyWriter
Экземпляры этого класса используются средой выполнения JAX-RS для сериализации представления

@Provider
@Produces("text/xml")
public class ContactInfoWriter implements MessageBodyWriter {
public long

Класс ContactInfoWriter будет вызываться средой JAX-RS перед сериализацией возвращаемых клиенту ресурсов.
Если

Провайдер MessageBodyReader
Провайдеры MessageBodyReaders выполняют функцию, обратную по отношению к MessageBodyWriter.
Реализации

@Provider
@Consumes("text/xml")
public class ContactInfoReader implements
MessageBodyReader {
public

Подобно методу MessageBodyWriter.isWriteable, метод isReadable класса ContactInfoReader будет вызываться средой JAX-RS

Классы, описывающие конфигурацию
Выше были рассмотрены классы ресурсов JAX-RS, а также некоторые

public class ContactInfoApplicaiton extends Application {
public Set> getClasses() {

Среда выполнения JAX-RS вызывает метод getClasses для получения списка классов, предоставляющих

Рассмотрим пример простейшего Rest сервиса(используется jersey 2.0)
package ua.rest;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import

Web.xml для этого сервиса имеет вид

FirstRestFulApplication

Rest
org.glassfish.jersey.servlet.ServletContainer

WebSockets

Метод WebSockets, который появился в HTML5.
WebSockets создает двунаправленные, дуплексные каналы

Временная диаграмма на иллюстрирует связь с использованием WebSockets

JavaScript позволяет использовать WebSockets, если эту возможность поддерживает браузер.
var ws =

Отправляемые и получаемые данные могут быть любого типа. WebSockets можно рассматривать

Response Headers
Connection:Upgrade
Sec-WebSocket-Location:ws://127.0.0.1:8080/async
Sec-WebSocket-Origin:http://localhost:8080
Upgrade:WebSocket
(Challenge
Response):AC:23:A5:7E:5D:E5:04:6A:B5:F8:CC:E7:AB:6D:1A:39
Все заголовки используются процессом

На стороне сервера получим(используются WebSockets Tomcat):
@ServerEndpoint("/ws")
public class WebSocket {
@OnOpen

@OnMessage
public void onMessage(String message, Session session, boolean last){
System.out.println("Message from

Клиент может иметь следующий вид: