Créer des API REST en Java avec une approche API-First : Mise en pratique et retours d'expérience Alexandre TOURET

Alexandre TOURET Architecte logiciel @touret.info blog.touret.info alexandre-touret Qui suis-je?

We design payments technology that powers the growth of millions of businesses around the world. 7000+ engineers in over 40 countries Managing 43+ billion transactions per year €250M spent in R&D every year Handling 150+ payment methods #1 European payment processor

Le workshop

Pré-requis github.com

https://blog.touret.info/api-first-workshop/ https://github.com/alexandre-touret/api-first-workshop Le workshop

Code-First vs API-First

Création de l’API • Spécifications • Création des controllers Java Documentation via des annotations • SpringDoc • Microprofile OpenAPI Génération de l’OPENAPI Code First

Création de l’API • Création d’un fichier de description OPENAPI qui sert de spécification Génération du code • Héritage pour specifier le code spécifique des controllers • Validation du contrat de service par la compilation Construction des livrables API First

Les limites du “Code First” ? Points négatifs • Les fichiers OpenAPI générés peuvent ne pas être valides • Nécessite un grand nombre d’annotations à ajouter • Définir une API en avance de phase peut être fastidieux Points positifs • La mise en oeuvre est simple pour des “petites” APIs

Guitar Heaven

Guitar Heaven Pro ides an API to mana e uitar sto Orders & uotes

Guitar Heaven

Don’t be a stran er! Follow & get in touch blog.worldline.tech @WorldlineTech Follow our tech team: Follow me: linkedin.com/in/atouret 14 | Feedback @touret.info

Explore our jobs in tech: careers.worldline.com Want to shape how the world pays and get paid?