WiRL

WIRL: Delphi Restful Library

Começando

Siga a documentação em wirl.delphiblocks.dev!

O que é WIRL?

A WIRL foi criada para simplificar a implementação do serviço RESTful em Delphi, mas, mais importante, para permitir a interoperabilidade máxima com clientes de descanso escritos em outros idiomas e ferramentas.

Wirl leva as especificações de Java Jax-Rs e tenta estar em conformidade com as 6 restrições de descanso.

A WIRL é uma estrutura de REST de alto nível que expondo objetos Plain Delphi (PODO) como Recursos da Web RESTful, aplicando atributos a essas classes.

[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 ;

A WIRL possui uma forte negociação de conteúdo HTTP e define atributos para vincular padrões específicos de URI e operações HTTP a métodos individuais da sua classe Delphi. Possui atributos de injeção de parâmetros para que você possa facilmente obter informações da solicitação HTTP. Possui leitores e escritores do corpo de mensagens que permitem dissociar o formato de dados e o desbaste de seus objetos Delphi. Possui mapeadores de exceção que podem mapear uma exceção a um código e mensagem de resposta HTTP.

WIRL usa 3 submódulos:

1. Delphi Jose e JWT Library para a criação e validação do JSON Web Token
2. Néon - Biblioteca de Serialização para Delphi para converter Delphi simples tipos, objetos, registros, matrizes, etc ... para o formato JSON
3. OpenApi 3 para Delphi para a geração de documentação do OpenAPI