Сопоставление REST-операций с ABL-операциями
После создания REST-сервиса с помощью мастера создания интерфейса сервиса необходимо сопоставить REST-операции с ABL-операциями, для этого необходимо:
- Добавить REST-ресурсы к созданному REST-сервису.
- Для каждого ресурса сопоставить REST(HTTP) метод с операциями аннотированных ABL-классов (.cls) и/или процедурных файлов (.p).
- Для каждого REST-метода сопоставить параметры HTTP-запросов и ответов с параметрами интерфейса.
Далее вы узнаете, как выполнить эти три задачи с помощью редактора REST Resource URI Editor в Developer Studio.
В следующей таблице приведено описание действий процедуры добавления REST-ресурсов в REST-сервис:
Шаг |
Действие |
1. | В окне Project Explorer разверните узел Define Services и затем дважды щёлкните по REST-сервису чтобы открыть его в редакторе REST Resource URI. |
2. | В редакторе REST Resource URI на панели Resources щёлкните значок Add Resource. Откроется диалоговое окно New REST Resource. |
3. | В поле Resource URI введите URI для ресурса и нажмите кнопку OK.
Это создаст REST-ресурс и отобразит его в списке ресурсов. |
4. | Повторите шаги 2 и 3 для всех остальных REST-ресурсов, которые вы хотите добавить. |
Все REST-ресурсы, добавленные вами в определённый сервис, отображаются в разделе «Resources». Для каждого REST-ресурса вы должны сопоставить REST-методы c ABL-операциями, но каждый REST-метод REST-ресурса может быть связан только с одной операцией.
В нашем примере приложения есть ABL-операции ReadALL и Read1, которые доступны для использования через класс Customer. Мы должны связать эти две операции с методом GET.
Но поскольку в REST-ресурсе каждый REST-метод можно связать только с одной ABL-операцией, нам необходимо создать два REST-ресурса для доступа как к ReadALL, так и к Read1.
В примере приложения мы свяжем ReadAll с методом GET ресурса REST с URI /Customer, а Read1 с методом GET ресурса REST с URI /Customer/{custID}.
В следующей таблице приведено описание действий для связывания REST-метода с ABL-операцией:
Шаг |
Действие |
1. | В редакторе REST Resource URI выберите REST-ресурс из списка ресурсов. |
2. | В разделе Verb Association щёлкните по значку Select operation рядом с методом REST-ресурса.
Появится диалоговое окно Associate Operation With Verb со списком ABL-классов или файлов процедур. |
3. | В списке ресурсов выберите ABL-ресурс (файл процедуры или класса). Появится список доступных операций этого ABL-ресурса. |
4. | Выберите ABL-операцию, которую вы хотите связать с выбранным REST-методом, и нажмите кнопку OK.
Выбранная операция отобразится рядом со связанным методом в разделе Verb Association. |
5. | Повторите шаги 2 -4 для всех операций, которые вы хотите связать с методами выбранного ресурса. |
6. | Повторите шаги 1-6 для каждого ресурса в списке ресурсов.
Вам не обязательно задействовать все методы или внутренние процедуры, выбранного ресурса, в качестве REST-операций. |