REST de bout en bout, du serveur au client

La conception et la consommation d'API Web sont simples, mais les API REST riches en hypermédias peuvent être décourageantes. À DevReach, Jimmy Bogard a abordé ce problème et démystifié la complexité de l'hypermédia.

La plupart des développeurs ont au moins consommé une API. Les concepts et l'exécution sont simples à la fois pour consommer et concevoir des API Web. Mais lorsque cette API nécessite plus qu'un simple message et qu'elle passe dans l'hypermédia, la complexité peut vous effrayer.

Cette présentation évite l'analyse approfondie des API REST, mais démystifie plutôt la complexité de l'hypermédia. Beaucoup de discussions creusent profondément dans les minuties REST, mais ce n'est pas très pratique pour la plupart des développeurs (

Démystifier Hypermedia

Lors de sa session pour DevReach, Jimmy Bogard a expliqué comment "les anciens objets JSON "sont fonctionnellement acceptables, et nous avons appris à travailler avec eux. Mais il n'y a pas de contexte, de typage fort ou d'autres indices pour faciliter le travail avec eux.

Quelle est la solution pour faciliter ce travail? Hypermedia, que Bogard définit aux fins de cette présentation en tant qu'objet JSON ainsi que des informations connexes superposées pour aider le client à effectuer des activités. Il exprime que, dans cette définition de travail, Hypermedia = JSON + Links + URL + Forms / Queries . Tout cela peut être contenu dans HTML.

Le côté serveur de votre API REST, explique-t-il, est relativement facile. C'est le côté consommateur qui peut être difficile à gérer avec l'hypermédia.

Il clarifie quand les développeurs devraient utiliser hypermédia avec leurs APIs: spécifiquement, pas dans la plupart des applications normales. Mais cela a du sens dans différents scénarios, y compris lorsque les développeurs ont besoin de s'adapter à des clients disparates ou si votre client a besoin de s'adapter à des serveurs disparates. Et, peut-être, même lorsque vous créez des applications mobiles.

Le scénario le plus courant où hypermédia a du sens est le suivant: où le client (s) et / ou serveur (s) sont développés et / ou déployés indépendamment. ] Premiers pas avec Hypermedia

Vous voulez maintenant utiliser une API REST hypermédia – par où commencer? Bogard décrit trois options, et recommande contre le premier: construire votre propre à partir de zéro. Au lieu de cela, il recommande la deuxième option: choisir une norme et travailler à partir de cela. La troisième option, choisir une norme et la prolonger, n'est vraiment viable que quand c'est absolument nécessaire.

Il reconnaît qu'aucune solution ou type hypermédia ne résoudra tous vos problèmes, mais les normes sont d'excellents points de départ.

Étant donné cette introduction, il plonge ensuite dans des exemples spécifiques, avec du code, pour vous montrer comment implémenter efficacement les API REST hypermédia dans vos projets.

À propos du présentateur

Grâce à Jimmy Bogard pour cette présentation perspicace. Il est l'architecte en chef de Headspring, l'auteur des livres MVC in Action, un conférencier international et un développeur open source prolifique. Vous pouvez le trouver à: https://jimmybogard.com/ .