Публикация и тестирование REST-сервиса
После сопоставления REST-операций с ABL-операциями вы можете протестировать REST-сервис в среде разработки с помощью любого REST-клиента на ваш выбор. Но перед этим его необходимо опубликовать на сервере приложений.
Публикация REST-сервиса включает в себя:
- Экспорт пакета REST-приложения из Developer Studio.
- Развёртывание пакет REST-приложения на экземпляре PAS.
В наших примерах мы развернём REST-сервис на экземпляре oepas1, который является экземпляром PAS по умолчанию, и который устанавливается вместе с Developer Studio.
Процедура экспорта пакета REST-приложения
Во время экспорта REST-приложения из Developer Studio, оно упаковывается в виде zip-архива. Для экспорта REST-приложения необходимо выполнить следующие действия:
|
Шаг |
Действие |
| 1. | В окне Project Explorer разверните узел Define Services и правой кнопкой мыши щёлкните по экспортируемому сервису. |
| 2. | Из контекстного меню выберите Export Services Incrementally. Откроется окно Export REST Application. |
| 3. | Выберите Progress Application Server for OpenEdge в качестве типа сервера. Примечание: флаг Export services incrementally уже должен быть выбран. |
| 4. | Укажите расположение сохраняемого zip-пакета для REST-приложения. Используйте кнопку Browse для этого. |
| 5. | Щёлкните по кнопке Finish. |
Процедура развёртывания пакета REST-приложения
Для развёртывания пакета REST-приложения применяется утилита командной строки deployREST, которая находится в каталоге bin экземпляра PAS for OpenEdge. В случае oepas1 это каталог C:\OpenEdge\WRK\oepas1\bin.
Выполните следующие действия для развёртывания пакета REST-приложения:
| Шаг | Действие |
| 1. | Перейдите к расположению пакета REST-приложения. |
| 2. | Запустите утилиту deployREST. Например, если вы разворачиваете файл на oepas1, используйте следующую команду: C:\OpenEdge\WRK\oepas1\bin\deployREST <Sample.zip> ROOT |
| 3. | Выполните рестарт PAS for OpenEdge в OpenEdge Explorer. |
Тестирование REST-сервиса
Вы можете протестировать ваш сервис с помощью любого REST-клиента.
Во время проверки REST-сервиса обязательно проверьте все настроенные для него HTTP-методы. При получении ответа от сервиса убедитесь, что получен правильный HTTP-ответ.
Примеры некоторых REST-клиентов для тестирования REST-сервисов:
- HTTP4e
- Postman
- Advanced REST client
- Telerik Fiddler
Перед тестирование REST-сервиса:
- Убедитесь в том, что экземпляр PAS for OpenEdge стартован.
- Если приложению необходимо подключение к базе данных, то убедитесь в том, что эта база данных стартована.
Примечание: помните, что при изменении REST-сервиса, его необходимо повторно опубликовать, экспортировав обновлённый пакет REST-приложения из среды Developer Studio.