James Hoffman

Techniques de l'Informatique - Cégep de Shawinigan

Menu

Échange de données 1

Recipeasy

Développer un service web permettant d'enregistrer des recettes.

  • Tester les fonctionnalités du serveur via des requêtes brutes dans un client Ruby

Ajout

  • Seul le nom est requis
  • Un id unique est généré pour la nouvelle recette
  • Les autres valeurs doivent avoir une valeur par défaut
  • La duration est un entier qui représente des minutes. ingredients et steps sont des tableaux de string.
http
Ajout
POST /recipes HTTP/1.1

{
name: ...,
?description: ...,
?ingredients: ...,
?steps: ...,
?duration: ...
}

===

201

{
id: ...
name: ...,
description: ...,
ingredients: ...,
steps: ...,
duration: ...
}

~~~ Validation

400

"Erreur..."
  • Formatter la duration au format XXhYY
http
Liste
GET /recipes HTTP/1.1

===

[
{
id: ...,
name: ...,
description: ...,
ingredients: [...],
steps: [...],
duration: "XXhYY"
},
...
]
http
Suppression
DELETE /recipes/:id HTTP/1.1

===

204

""

~~~ Id invalide

404

"Invalid id"

Recipeasy, suite

À partir de l'exercice Recipeasy précédent, ajouter la gestion de plusieurs usagers et l'authentification.

  • Chaque utilisateur ne doit pouvoir manipuler que les recettes qui lui appartiennent.
  • Toutes les routes demandent une authentification valide
  • On peut créer les utilisateurs manuellement via un tableau hard-codé pour tester
ROUTE
Authorization: Basic ...

...

~~~ Si authentification invalide

401
WWW-Authenticate: Basic
  • On peut également récupérer une recette, en précisant le format attendu.
http
Récupération
GET /recipes/:id HTTP/1.1
Accept: application/json | application/yaml

===

Content-Type: ...

...Données...

~~~ Format invalide

400

"Invalid format"

~~~ Id invalide

404

"Invalid id"

Converty

Développer une application Sinatra permettant de convertir du contenu json, xml ou yaml vers l'un ou l'autre de ces formats. Compléter ce client qui utilisera les informations de l'utilisateur pour envoyer la requête de conversion au serveur.

  • Le serveur reçoit les informations des formats à convertir dans les headers Content-Type et Accept
    • Valider que les formats sont supportés: application/json, application/xml, application/yaml
  • Le contenu à convertir est fourni via le body de la requète et retourné dans le body de la réponse
    • Le serveur doit préciser le format de la réponse via le header Content-Type
    • Si la conversion échoue, les méthodes fournies génèrent une exception que vous pouvez intercepter

Importer le fichier converty.rb dans votre application serveur et exploiter les fonctions de conversion fournies

rb
copier
Converty::Json::to_json("le contenu a convertir")
Converty::Json::to_xml("le contenu a convertir")
Converty::Json::to_yaml("le contenu a convertir")

Converty::Xml::to_json("le contenu a convertir")
Converty::Xml::to_xml("le contenu a convertir")
Converty::Xml::to_yaml("le contenu a convertir")

Converty::Yaml::to_json("le contenu a convertir")
Converty::Yaml::to_xml("le contenu a convertir")
Converty::Yaml::to_yaml("le contenu a convertir")

Ces fichiers vous permettront de tester vos programmes

http
Conversion
POST / HTTP/1.1
Content-Type: ...
Accept: ...

...Contenu a convertir...

===

200
Content-Type

...Contenu converti...

~~~

400

...Erreur...
bash
Utilisation du client interactif
Enter filename: airport.xml
Enter output type (json, xml, yaml): json
{"flight":[{"plane":"A380","number":"F9876","origin":"canada","destination":"usa","departure":"2022-03-12 11
:34","pilot":[{"firstname":"alice","lastname":"smith"}]},{"plane":"B737","number":"K2038","origin":"france",
"destination":"mexico","departure":"2020-09-21 17:35","pilot":[{"firstname":"bob","lastname":"jones"}]},{"pl
ane":"B747","number":"E3957","origin":"spain","destination":"france","departure":"2021-06-14 21:47","pilot":
[{"firstname":"charlie","lastname":"anderson"}]},{"plane":"A330","number":"M2775","origin":"usa","destinatio
n":"canada","departure":"2020-01-19 06:12","pilot":[{"firstname":"alice","lastname":"smith"}]},{"plane":"A38
0","number":"T3845","origin":"italy","destination":"france","departure":"2022-03-04 19:28","pilot":[{"firstn
ame":"bob","lastname":"jones"}]}]}
bash
Utilication du client CLI avec paramètres
etd@vm: ruby client.rb recipes.json xml
<opt>
<anon name="Club sandwich" description="Pain garni de poulet avec condiments" category="repas">
<ingredients>pain</ingredients>
<ingredients>poulet</ingredients>
<ingredients>bacon</ingredients>
<ingredients>laitue</ingredients>
<ingredients>tomate</ingredients>
<ingredients>mayonnaise</ingredients>
<steps>Cuire et couper le poulet</steps>
<steps>Assembler la sandwich</steps>
</anon>
<anon name="Fromage" description="Produit laitier" category="collation" />
<anon name="Canapé de saumon fumé" description="Biscuit de blé garni de saumon fumé" category="entrée">
<ingredients>Filet de saumon fumé</ingredients>
<ingredients>Biscuits de blé</ingredients>
<ingredients>Fromage Brie</ingredients>
<steps>Assembler le canapé</steps>
</anon>
<anon name="Crème de brocoli" description="Crème de brocoli cheddar bacon" category="entrée">
<ingredients>brocoli</ingredients>
<ingredients>crème</ingredients>
<ingredients>cheddar</ingredients>
<ingredients>bacon</ingredients>
<steps>Cuire le brocoli</steps>
<steps>Mélanger au robot avec la crème</steps>
<steps>Servir dans un bol</steps>
<steps>Garnir de minces tranches de cheddar et bacon haché</steps>
</anon>
</opt>