WiRL

Wirl: Bibliothèque Delphi Restful

Commencer

Veuillez suivre la documentation sur wirl.delphiblocks.dev!

Qu'est-ce que Wirl?

Wirl a été créé pour simplifier la mise en œuvre des services RESTful dans Delphi, mais, plus important encore, pour permettre une interopérabilité maximale avec les clients REST écrits dans d'autres langues et outils.

Wirl prend les spécifications Java Jax-RS et essaie d'être conforme aux 6 contraintes de repos.

Wirl est un cadre de repos de haut niveau exposant les objets Delphi Plain (PODO) en tant que ressources Web RESTful en appliquant des attributs à ces 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 ;

Wirl a une forte négociation de contenu HTTP et définit des attributs pour lier des modèles URI spécifiques et des opérations HTTP aux méthodes individuelles de votre classe Delphi. Il a des attributs d'injection de paramètres afin que vous puissiez facilement extraire des informations de la demande HTTP. Il a des lecteurs de corps et des écrivains de messages qui vous permettent de découpler le format de données, le marshalling et le défaut de vos objets Delphi. Il a des mappeurs d'exception qui peuvent mapper une exception à un code de réponse HTTP et un message.

Wirl utilise 3 sous-modules:

1. Bibliothèque de Delphi Jose et JWT pour la création et la validation du jeton Web JSON
2. NEON - Bibliothèque de sérialisation pour Delphi pour convertir les types de Delphi, objets, enregistrements, tableaux, etc ... au format JSON
3. OpenAPI 3 pour Delphi pour la génération de documentation OpenAPI