Подготовка к созданию приложения REST WEB

Перед созданием REST WEB приложения из существующего ABL-приложения необходимо:

• убедиться в том, что ваше ABL-приложение работает в режиме state-free;
• собрать информацию об ABL-ресурсах, которые вы хотите представить в качестве REST-ресурсов.

Приложение REST WEB может использовать сервисы только из одного проекта OpenEdge. Поэтому необходимо определить проект, который будет использоваться для создания REST WEB приложения.

Приложения REST WEB всегда работают в режиме state-free. Поэтому программный код должен соответствовать следующим требованиям:

• Для процедурных файлов, содержащих внутренние процедуры:
  • Процедура верхнего уровня не должна иметь параметров.
  • Состояние (контекст) не должно поддерживаться между вызовами внутренних процедур и функций.
• Каждый класс должен быть спроектированы для работы в качестве синглтона.

Вы должны создать список ресурсов ABL, которые хотите представить в качестве ресурсов REST. В этих ресурсах ABL обратите внимание на:

• Входные и выходные параметр ABL-операций. Операции ABL – это методы, процедуры и функции в приложении, которые должны быть представлены как часть REST-сервиса.
• Соглашение об именовании URI в сервисе REST.
• Метод HTTP, который будет связан с каждой операцией.

При определении соглашений об именовании URI следуйте рекомендациям:

• URI чувствительны к регистру.
• Имя должно начинаться с символа “/”. Например, /Customer/{custID}.
• В URI не допускается использование зарезервированных для Java слов, таких как int, char или boolean.
• Имя ресурса URI должно представлять ресурс, с которым работает приложение. Например, предположим, что вы добавили ресурс для метода Read1 в Customer.cls. Так как это работа с клиентской записью, то сервисный URI должен быть /Customers, а не /readcustomer или /read