RESTRequest4Delphi

RestRequest4Delphi est une API pour consommer des services de repos écrits dans n'importe quel langage de programmation.
Conçu pour faciliter le développement, de manière simple et minimaliste .
Achetez notre formation officielle en cliquant ici !

Installation

• Installation manuelle : Ajoutez les dossiers suivants à votre projet, dans le projet> Options> Building> Compiler Delphi> Chemin de recherche

 ../RESTRequest4Delphi/src

• Installation à l'aide du boss :

 boss install github.com/viniciussanchez/RESTRequest4Delphi

? Moteurs

Par défaut, les composants TresterRequest , TrestResponse et TrestClient sont utilisés pour faire des demandes lorsque vous utilisez Delphi. Si vous utilisez Lazarus, les composants FPHTTPClient sont utilisés par défaut. Le RestRequest4Delphi prend en charge cinq moteurs pour faire des demandes: RestClient, Synapse , Ics OverByte , Indy et NetHTTP. Vous pouvez modifier le moteur pour faire des demandes. Pour ce faire, définissez simplement dans: Project> Options> Delphi Compiler> Conditional Définit la directive du compilateur RR4D_INDY , RR4D_SYNAPSE , RR4D_ICS ou RR4D_NETHTTP

Remarque : Pour Lazarus, le moteur FPHTTPClient est la valeur par défaut. Mais vous pouvez passer à la directive RR4D_INDY Indy ou sur RR4D_SYNAPSE .

? Adaptateurs

Les adaptateurs vous permettent d'étendre la fonctionnalité de RestRequest4Delphi sans modifier le cœur du projet. Voir la liste des adaptateurs disponibles par la communauté:

• Dataset-Serialize-adapter-reStrequest4Delphi - Adaptateur pour charger un ensemble de données à l'aide de la bibliothèque de sérialisation de DataSet au moment de la demande;
• CSV-adapter-reStrequest4Delphi - vous permet de générer un fichier texte ou CSV avec le contenu d'une demande;

⚡️ QuickStart

Vous devez utiliser RestRequest4d

 uses RESTRequest4D;

• OBTENIR

 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 ;

• Obtenez un ensemble de données à l'aide d'adaptateurs

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

• POSTE

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

• METTRE

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

• SUPPRIMER

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

Authentification

Vous pouvez définir des informations d'identification à l'aide de la méthode BasicAuthentication , Token ou TokenBearer avant de faire la première demande:

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

Vous pouvez le définir une fois et il sera utilisé pour chaque demande.

Échantillons

Deux projets ont été développés dans le dossier Exemples:

• Client : Application Windows VCL Consommant une API REST développée dans Node.js

Pour exécuter le projet, vous devez installer ses dépendances ( DataSet Serialize ). Pour installer à l'aide de boss , ouvrez un terminal et type:

 boss install

Si vous préférez, vous pouvez télécharger manuellement le DataSet-Serialize et l'ajouter au Search Path .

• Node de serveur : serveur de repos développé avec Node.js et Express .

Pour exécuter le serveur, vous aurez besoin de node.js et npm . Avec tout installé, ouvrez un terminal, installez les dépendances et exécutez le serveur:

 npm install
node server.js

Contributeurs de code

️ Licence

RESTRequest4Delphi est un logiciel gratuit et licencié en vertu de la licence MIT.