- •Введение
- •1 Тема 1. Предметная область и терминология РСОС
- •1.1 Этапы развития распределенных систем
- •1.1.1 Классификация систем обработки данных
- •1.1.2 Распределенные вычислительные сети
- •1.1.3 Объектные распределенные системы
- •1.2 Становление систем с сервис-ориентированной архитектурой
- •1.2.1 Развитие web-технологий
- •1.2.2 Развитие концепции SOA
- •1.3 Современные парадигмы сервис-ориентированных архитектур
- •1.3.1 Эталонная модель SOA
- •1.3.2 Модель Захмана
- •1.3.3 Концепция среды открытой системы
- •1.3.4 Бизнес-парадигма модели SOA
- •1.4 Программная платформа Java Enterprise Edition
- •1.4.1 Контейнеры и компоненты Java EE
- •1.4.2 Служебные сервисы контейнеров
- •1.4.3 Артефакты контейнеров
- •1.4.4 Аннотации и дескрипторы развертывания
- •1.4.5 Управляемые компоненты платформы Java EE
- •1.5 Инструментальные средства реализации РСОС
- •1.5.1 Сервера приложений
- •1.5.2 Микросервисы
- •1.5.3 Apache Maven — сетевая сборка приложений
- •1.5.4 Eclipse Enterprise Edition
- •1.5.5 Тестовый пример
- •1.6 Заключение по первой главе
- •1.6.1 Итоги теоретических построений первой главы
- •1.6.2 Тематический план последующих глав
- •Вопросы для самопроверки
- •2 Тема 2. Использование компоненты JSF контейнера Web
- •2.1.1 Языки HTML, JavaScript и протокол HTTP
- •2.1.2 Серверные технологии PHP и HttpServlet
- •2.1.3 Технология AJAX и компонента JavaServer Faces
- •2.2 Шаблон проектирования MVC
- •2.2.1 Контроллер FacesServlet и жизненный цикл запроса
- •2.2.2 Контекст состояния запроса FacesContext
- •2.2.3 Модель в виде компонентов-подложек
- •2.2.4 Представление (View) средствами Facelets
- •2.2.5 JSF OmniFaces
- •2.3 Реализация тестового примера средствами JSF
- •2.3.1 Создание Facelets-шаблона изучаемой дисциплины
- •2.3.2 Прямая реализация тестового примера
- •2.4 Реализация уровня интерфейса сервисов
- •2.4.2 Компонента Users с ЖЦ @ApplicationScoped
- •2.4.3 Компонента RSOS с ЖЦ @SessionScoped
- •2.4.4 Компоненты-подложки с ЖЦ @RequestScoped
- •2.4.5 Приложение авторизации пользователя
- •2.4.6 Компонента подзаголовка проекта
- •2.4.7 Компонента меню лабораторных работ
- •2.4.8 Второй вариант меню лабораторных работ
- •Вопросы для самопроверки
- •3 Тема 3. Современные способы доступа к данным
- •3.1 Учебная инфраструктура темы
- •3.1.1 Учебная задача Letters (Письма)
- •3.1.2 Корпоратиные EJB-компоненты
- •3.1.3 Тестовый HttpServlet проекта lab4
- •3.1.4 Инфраструктура сервера TomEE и СУБД Derby
- •3.2 Технология JPA
- •3.2.1 Сущности
- •3.2.2 Объектно-реляционное отображение
- •3.2.3 Манеджер сущностей
- •3.2.4 Пример использования не-JTA-типа транзакций
- •3.3 Транзакции управляемые контейнером
- •3.3.1 Объектно-ориентированные запросы Criteria API
- •3.3.2 Реализация EJB-компонента с JTA-типом транзакций
- •3.3.3 Реализация JPA-сервлета
- •Вопросы для самопроверки
- •4 Тема 4. Обработка документов XML и JSON
- •4.1 Технология JAXB
- •4.1.1 Программное обеспечение технологии JAXB
- •4.1.2 Аннотации для связывания объектов Java
- •4.1.3 Преобразование объекта Java в документ XML
- •4.2 Технология JSON
- •4.2.1 Программное обеспечение технологии JSON
- •4.2.2 Преобразование объекта Java в документ JSON
- •4.2.3 Пример представления JSON на уровне классов
- •4.2.4 Выводы по результатам изучения главы 4
- •Вопросы для самопроверки
- •5 Тема 5. Web-службы SOAP
- •5.1.1 Протоколы и языки Web-служб
- •5.1.2 Краткое описание языка WSDL
- •5.1.3 Краткое описание протокола SOAP
- •5.1.4 Необязательный реестр Web-служб — UDDI
- •5.1.5 Программные пакеты Java EE, обслуживающие SOAP
- •5.2 Создание Web-служб SOAP
- •5.2.1 Подготовка проекта lab7
- •5.2.2 Аннотации поставщика Web-сервиса
- •5.2.3 Обработка исключений поставщика Web-сервиса
- •5.2.4 Обработка контекста Web-сервиса
- •5.3 Создание потребителя Web-службы SOAP
- •5.3.1 Аннотации для потребителей сервиса
- •5.3.2 Использование утилиты wsimport
- •5.3.3 Реализация тестового примера
- •5.3.4 Выводы по результатам изучения главы 5
- •Вопросы для самопроверки
- •6 Тема 6. Web-службы в стиле REST
- •6.1 Основные положения технологии RESTful
- •6.1.1 Ресурсы, URI, представления и адресуемость
- •6.1.2 Протокол HTTP
- •6.1.3 Языки WADL и HAL
- •6.1.4 Технология JAX-RS
- •6.2 Реализация Web-службы в стиле REST
- •6.2.1 Преобразование сущности Letter
- •6.2.2 Реализация EJB-компоненты Lets9
- •6.2.3 Получение списка записей в формате XML
- •6.2.4 Получение записи по номеру индентификатора
- •6.2.5 Добавление новой записи
- •6.3 Вызов Web-служб в стиле REST
- •6.3.1 Инструментальные средства потребителя сервиса
- •6.3.2 Полная реализация RESTfull-сервиса
- •6.3.3 Шаблон реализации потребителя сервиса
- •6.3.4 Клиент, реализующий методы GET и POST
- •6.3.6 Клиент, реализующий методы DELETE и PUT
- •Вопросы для самопроверки
- •Заключение
- •Список использованных источников
- •Алфавитный указатель
Хотя этот пример во многом является надуманным, он правильно отображает технологию применения исключений на стороне поставщиков сервисов.
5.2.4 Обработка контекста Web-сервиса
Как и большинство из изученных нами технологий платформы Java EE, Web-службы SOAP имеют свой контекст среды. Доступ к этому контексту осуществляется с помощью ссылки на javax.xml.ws.WebServiceContext с аннотацией @Resource.
Если мы хотим в классе Lets7 использовать ссылку на контекст созданной Web-службы SOAP, то начальная часть этого класса должна выглядеть так, как это показано на листинге 5.11.
Листинг 5.11 — Обеспечение доступа к контексту среды в классе Lets7.java
package rsos.lab7; import java.util.List;
import javax.annotation.Resource; import javax.ejb.LocalBean; import javax.ejb.Stateless; import javax.jws.WebService;
import javax.persistence.EntityManager; import javax.persistence.PersistenceContext; import javax.persistence.TypedQuery;
import javax.persistence.criteria.CriteriaBuilder; import javax.persistence.criteria.CriteriaQuery; import javax.persistence.criteria.Root;
import javax.xml.ws.WebServiceContext;
@WebService
@Stateless
@LocalBean
public class Lets7 implements RemoteLets
{
//Доступ к контексту менеджера сущностей @PersistenceContext(name = "lab4-unit2") private EntityManager em;
//Доступ к контексту среды Web-службы SOAP @Resource
private WebServiceContext context;
//Остальные определения методов класса Lets7
}
Объект контекста имеет множество разных методов. Наиболее важные из них представлены в таблице 5.3.
219
Таблица 5.3. - Методы объектов типа WebServiceContext [17]
Метод |
Описание метода |
|
|
getMessageContext |
Возвращает MessageContext для запроса, который обслуживается |
||
|
на момент вызова метода. Он может быть использован для |
||
|
доступа к различным частям сообщения SOAP. |
|
|
getUserPrincipal |
Возвращает Principal, идентифицирующий отправителя запроса. |
||
isUserInRole |
Возвращает двоичное значение, указывающее, является ли |
||
|
аутентифицированный |
пользователь |
представителем |
|
определенной логической роли. |
|
|
getEndpointReference |
Возвращает EndpointReference, связанный с заданной конечной |
||
|
точкой. |
|
|
В качестве примера использования контекста, потребуем, чтобы метод getDeleteLetter(...) мог применяться только пользователем с ролью Admin, что соответственно показано на листинге 5.12.
Листинг 5.12 — Новая реализация метода getDeleteLetter() класса Lets7.java
// Удалить объект из базы данных по ключу
public void deleteLetter(int id) throws Lets7Exception
{
// Проверка на наличие контекста if (context == null)
throw new Lets7Exception(
"Lets7: Контекст среды - недоступен!");
// Проверка роли клиента
if (!context.isUserInRole("Admin")) throw new Lets7Exception(
"Только администратор может удалять письма!");
// Проверка наличия аргумента вызова Letter letter =
em.find(Letter.class, new Integer(id)); if(letter == null)
return;
// Непосредственное обращение на удаление объекта em.remove(letter);
}
Следует обратить внимание, что новая реализация метода не обрабатывает используемое исключение LetsException, поэтому соответствующие изменения должны вноситься в интерфейс RemoteLets.
Конечно, провайдер сервиса может использовать множество других технологических возможностей, предоставляемых сервисами контейнеров сервлетов и EJB-компонент. Мы ограничемся только приведенными примерами и перейдем к реализации потребителя сервиса.
220