Les sources (démo, exercices, corrections) du module de formation API RESTful, ORM et GraphQL (4e année)
Voir les corrections du module Dev API RESTful
- Accéder aux démos sur la spécification OpenAPI
- Accéder aux démos sur GraphQL
- Accéder au projet de service de billeterie (live, en l'état)
Accéder au dépôt Starter pack: RESTful web API avec Node.js, Express.js, MySQL et Adminer. Suivre les instructions pour l'installer.
Voir les références du module Dev API RESTful
OpenAPI est une description standardisée d'API et un framework de développement d'API HTTP.
Elle ne s'intéresse pas à la sémantique des messages (vocabulaire, actions)
- La spécification OpenAPI est une description formelle et standardisée d'une web API au format texte (JSON ou Yaml). Elle est maintenue et développée par l'OpenAPI Initiative (OAI), un consortium ouvert d'experts de l'industrie. Ce projet collaboratif est porté par la Linux Foundation.
- La spécification ouverte OpenAPI a été crée à l'origine par Wordnik en 2010, sous le nom de Swagger specification. SmartBear Software et d'autres acteurs ont repris la spécification à partir de 2015. Le projet est devenu l'OpenAPI Specification.
- Swagger désigne aujourd'hui une suite d'outils pour le développement d'API, publiés par SmartBear Software. Cette enterprise est membre du comité de l'OpenAPI Initiative et maintient et développe plusieurs logiciels open source autour de la spécification, comme Swagger Editor. Il existe de nombreux autres outils développés par la communauté
- Le guide officiel pour démarrer avec OpenAPI ;
- OpenAPI tooling, liste tous les outils développés par la communauté pour travailler avec la spécification ;
- The OpenAPI Specification Explained, le guide
- OpenAPI Specification, la référence complète
- OpenAPI Best Practices, un guide de bonnes pratiques et de recommandations pour travailler avec la spécification OpenAPI
- OpenAPI Initiative, le site web officiel de la spécification OpenAPI, une description standardisée de web API;
- Les ORM (Object-Relational Mapping), de David Gayerie, avec exemple dans l'écosystème Java;
- Sequelize
- Sequelize v6
- Anemic Domain Model, de Martin Fowler. Utiliser des objets "anémiques", débarrassés de tout comportement délégués à une couche service est un anti-pattern. En POO, un objet métier (du domaine) devrait contenir toute la logique métier placée sous sa responsabilité. Le problème avec les ORMs c'est que la couche persistance est "confondue" avec les objets métier. Soit on les découple (et on "brise" la POO), soit on les maintient (et on couple la logique de persistance avec la logique métier, ce qui n'est pas désirable). Il faut donc faire des compromis entre les deux (ou ne pas utiliser d'ORM !) ;
- Anemic Domain Model vs. Rich Domain Model, billet de Matthias Schenk, synthèse sur ce problème discuté dans l'ouvrage Implementing Domain-Driven Design, d'Eric Evans;
- Adding behavior to Entities, discussion dans la documentation de l'ORM Doctrine sur la différence entre les entités anémiques (anemic entities) et les entités riches (rich entities).
- Your Database Skills Are Not 'Good to Have' And a hateful ode to Object-Relational Mappers, d'Andrei Taranchenko
- GraphQL, le site officiel
- Documentation officielle
- Getting Started With GraphQL.js, tutoriel basique issu de la documentation officielle. Recommandé mais limité
- The Fullstack Tutorial for GraphQL, du site howtographql. Recommandé
- Build your own GraphQL server, du site howtographql, tutoriel avec Node.js. Recommandé
- GraphQL Server Basics: GraphQL Schemas, TypeDefs & Resolvers Explained, bon article pour bien comprendre comment les résolveurs implémentent le schéma