RESTRequest4Delphi

Restrequest4delphi - это API для потребления услуг REST , написанных на любом языке программирования.
Разработанный для облегчения разработки, простым и минималистским способом.
Купите наше официальное обучение, нажав здесь !

Установка

• Ручная установка : добавьте следующие папки в ваш проект, в проекте> Параметры> Строительство> Delphi Compiler> Поиск

 ../RESTRequest4Delphi/src

• Установка с использованием босса :

 boss install github.com/viniciussanchez/RESTRequest4Delphi

? Двигатели

По умолчанию компоненты Trestrequest , Trestresponse и TrestClient используются для выполнения запросов при использовании Delphi. Если вы используете Lazarus, компоненты fphttpclient используются по умолчанию. Restrequest4delphi обладает поддержкой пяти двигателей для выполнения запросов: RestClient, Synapse , ICS Overbyte , Indy и Nethttp. Вы можете изменить двигатель, чтобы сделать запросы. Чтобы сделать это, просто определите в: Project> Options> Delphi Compiler> Conditanal определяет директиву компилятора RR4D_INDY , RR4D_SYNAPSE , RR4D_ICS или RR4D_NETHTTP

Примечание . Для Lazarus двигатель fphttpclient - это по умолчанию. Но вы можете переключиться на настройку директивы RR4D_INDY или на установку Synapse Directive RR4D_SYNAPSE .

? Адаптеры

Адаптеры позволяют вам расширить функциональность Restrequest4delphi, не изменяя ядро проекта. Смотрите список адаптеров, доступных сообществом:

• DataSet-Serialize-Adapter-Restrequest4delphi -Адаптер для загрузки набора данных с использованием библиотеки набора данных, серии Serialize во время запроса;
• CSV-Adapter-Restrequest4delphi -позволяет генерировать текст или файл CSV с содержанием запроса;

⚡ QuickStart

Вам нужно использовать RestRequest4d

 uses RESTRequest4D;

• ПОЛУЧАТЬ

 var
  LResponse: IResponse;
begin
  LResponse := TRequest.New.BaseURL( ' http://localhost:8888/users ' )
    .AddHeader( ' HeaderName ' , ' HeaderValue ' )
    .AddParam( ' ParameterName ' , ' ParameterValue ' )
    .Accept( ' application/json ' )
    .Get;
  if LResponse.StatusCode = 200 then
    ShowMessage(LResponse.Content);
end ;

• Получить набор данных, используя адаптеры

 begin
  TRequest.New.BaseURL( ' http://localhost:8888/users ' )
    .Adapters(TDataSetSerializeAdapter.New(FDMemTable))
    .Accept( ' application/json ' )
    .Get;
end ;

• ПОЧТА

 begin
  TRequest.New.BaseURL( ' http://localhost:8888/users ' )
    .ContentType( ' application/json ' )
    .AddBody( ' {"name":"Vinicius","lastName":"Sanchez","email":"[email protected]"} ' )
    .Post;
end ;

• ПОМЕЩАТЬ

 begin
  TRequest.New.BaseURL( ' http://localhost:8888/users/1 ' )
    .ContentType( ' application/json ' )
    .AddBody( ' {"name":"Vinicius","lastName":"Scandelai Sanchez","email":"[email protected]"} ' )
    .Put;
end ;

• УДАЛИТЬ

 begin
  TRequest.New.BaseURL( ' http://localhost:8888/users/1 ' )
    .Accept( ' application/json ' )
    .Delete;
end ;

Аутентификация

Вы можете установить учетные данные, используя метод BasicAuthentication , Token или TokenBearer прежде чем сделать первый запрос:

 begin
  Request.BasicAuthentication( ' username ' , ' password ' );
  Request.Token( ' token-type ' + token);
  Request.TokenBearer(token);
end ;

Вы можете установить его один раз, и он будет использоваться для каждого запроса.

Образцы

В папке примеров были разработаны два проекта:

• Клиент : приложение Windows VCL, потребляющее API REST, разработанный в node.js

Чтобы запустить проект, вам необходимо установить его зависимости ( наборы данных, сериализуйте ). Чтобы установить с помощью босса , откройте терминал и тип:

 boss install

Если вы предпочитаете, вы можете вручную загрузить DataSet-Serialize и добавить его в Search Path .

• Сервер-узлы : REST Server разработан с помощью Node.js и Express .

Чтобы запустить сервер, вам понадобятся node.js и npm . Со всем установленным, откройте терминал, установите зависимости и запустите сервер:

 npm install
node server.js

Кодовые участники

️ Лицензия

RESTRequest4Delphi -это бесплатное и программное обеспечение с открытым исходным кодом, лицензированное по лицензии MIT.