Репозиторий с шаблоном разработки «Прикладной HTTP клиент».
Для реализации интеграций со стороними системами на проектах часто требуется вызывать методы сторонних веб сервисов, например, при интеграции с SAP PO/PI. В рамках шаблона разработки реализована библиотека для отправки сообщений в сторонние системы.
Библиотека позволяет отправлять HTTP запросы, для взаимодействия с веб сервисами построеными как по технологии REST API, так и использующими протокол SOAP.
Реализованы методы Get, Post, Put, Delete.
Методы аутентификации:
- Basic
- Bearer
- Ntlm
Типы тела запроса:
- Json
- Xml
- Загрузка файла
Для обработки результата запроса определено 2 метода:
- OnSuccess – выполняется в случае успешного выполнения запроса. Данный метод в себе содержит структуру ответа из следующих свойств: o StatusCode – статус код запроса; o Headers – заголовки ответа; o Response – ответ на запрос в виде потока.
- OnFail - выполняется в случае ошибки при выполнении запроса.
Пример подключения библиотеки и вызовов методов см. в Инструкция по использованию.docx
Note
Замечания и пожеланию по развитию шаблона разработки фиксируйте через Issues. При оформлении ошибки, опишите сценарий для воспроизведения. Для пожеланий приведите обоснование для описываемых изменений - частоту использования, бизнес-ценность, риски и/или эффект от реализации.
Внимание! Изменения будут вноситься только в новые версии.
- Создание своего HTTP клиента под разные нужды
- Добавление метода аутентификации
- Добавление методов загрузки файла
Для работы требуется установленный Directum RX версии 4.0 и выше
- Склонировать репозиторий с rx-template-appliedhttpclient в папку
Возможные варианты
- Сделать fork репозитория rx-template-appliedhttpclient для своей учетной записи.
- Открыть созданный в п. 1 репозиторий в среде разработки Visual Studio.
- Для сборки библиотеки и подключения в прикладном решении Directum RX, необходимо скачать библиотеку с репозитория и выполнить сборку решения. Решение, скачанное с репозитория необходимо открыть в Visual Studio, после выполнить сборку. Для сборки решения необходимо выбрать зеленую стрелку «Запуск» и имя проекта на панели инструментов Visual Studio. В данном примере выбран проект AppliedHttpClientApp.
- Подключить собранную библиотку в требуемый модуль системы Directum RX. Добавление сторонней библиотеки в Directum RX описано в справке. При добавление сторонней библиотеки необходимо добавить файл с расширением dll. Файлы с расширением pdb, в случае если такие имеются, добавлять не стоит, т.к они нужны для отладки решения в Visual Studio.
Рекомендуемый вариант для проектов внедрения.
- В системе контроля версий с поддержкой git создать новый репозиторий.
- Склонировать репозиторий rx-template-appliedhttpclient в папку с ключом --mirror.
- Перейти в папку из п. 2.
- Импортировать клонированный репозиторий в систему контроля версий командой: git push –mirror <Адрес репозитория из п. 1>