WiRL

Hirl: библиотека Delphi Restful

Начиная

Пожалуйста, следуйте документации на wirl.delphiblocks.dev!

Что такое hirl?

Hirl был создан для упрощения реализации обслуживания Restful в Delphi, но, что более важно, чтобы обеспечить максимальную совместимость с клиентами Rest, написанными на других языках и инструментах.

Girl принимает после спецификаций Java JAX-RS и пытается соответствовать 6-м ограничениям отдыха.

Wirl-это высокоуровневая структура REST, разоблачающая простые объекты Delphi (PODO) как Restful Web Resources, применяя атрибуты к этим классам.

[Path( ' customers ' )]
TCustomerResource = class
public
  [GET]
  [Produces( ' TMediaType.APPLICATION_JSON ' )]
  function SelectCustomers : TCustomerList;

  [POST]
  [Consumes( ' TMediaType.APPLICATION_JSON ' )]
  [Produces( ' TMediaType.APPLICATION_JSON ' )]
  function InsertCustomer (ACustomer: TCustomer): TCustomer;
end ;

Wirl имеет сильные переговоры о контенте HTTP и определяет атрибуты для связывания конкретных моделей URI и операций HTTP с отдельными методами вашего класса Delphi. Он имеет атрибуты впрыска параметров, чтобы вы могли легко извлечь информацию из HTTP -запроса. У него есть считыватели и писатели тела сообщений, которые позволяют вам отделять формат данных Marshalling и Unmarshalling от ваших объектов Delphi. У него есть Mappers, которые могут отобразить исключение из кода ответа HTTP и сообщения.

Hirl использует 3 подмодуля:

1. Библиотека Delphi Jose и JWT для создания и проверки веб -токена JSON
2. Библиотека Neon - сериализации для Delphi для преобразования простых типов Delphi, объектов, записей, массивов и т. Д. в формат JSON
3. OpenApi 3 для Delphi для генерации документации OpenAPI