Les TP successifs ont pour objectif de gérer des articles de blogs, sous la forme d'une API RPC (Remote Procedure Call, qui repose sur le protocole HTTP)
- L’authentification des utilisateurs souhaitant interagir avec les articles. Cette fonctionnalité devra s’appuyer sur les JSON Web Token (JWT). Un utilisateur est caractérisé, a minima, par un nom d’utilisateur, un mot de passe et un rôle (moderator ou publisher)
- La publication, la consultation, la modification et la suppression des articles de blogs. Un article est caractérisé, a minima, par sa date de publication, son auteur et son contenu
- La possibilité de liker/disliker un article. La solution doit permettre de retrouver quel(s) utilisateur(s) a liké/disliké un article
Un utilisateur authentifié avec le rôle "moderator" peut :
- consulter n’importe quel article. Un utilisateur moderator doit accéder à l’ensemble des informations décrivant un article : auteur, date de publication, contenu, liste des utilisateurs ayant liké l’article, nombre total de like, liste des utilisateurs ayant disliké l’article, nombre total de dislike
- supprimer n’importe quel article
Un utilisateur authentifié avec le rôle "publisher" peut :
- poster un nouvel article
- consulter ses propres articles
- consulter les articles publiés. Un utilisateur publisher doit accéder aux informations suivantes relatives à un article : auteur, date de publication, contenu, nombre total de like, nombre total de dislike
- modifier les articles dont il est l’auteur
- supprimer les articles dont il est l’auteur
- liker/disliker les articles publiés par les autres utilisateurs
Un utilisateur non authentifié peut :
- consulter les articles existants. Seules les informations suivantes doivent être disponibles : auteur, date de publication, contenu
Objectif
Comprendre le rôle d'un framework et s'en servir pour initialiser un projet en complétant le guide QuickStart de Spring
Ressources:
- Présentation de Spring: https://spring.io/
- Choisir les bons outils: https://spring.io/tools
- Un environnement de développement adapté
- Un gestionnaire de version: https://gitlab.com
- Documentation Git: https://git-scm.com/docs
Livrable attendu
Un repo Git contenant au moins les commits suivants :
- tag hello-world: votre projet s'exécute, et retourne un Body contenant "Bonjour le monde !" à l'adresse http://localhost:8080/bonjour
Indications
- Configuration Spring Initializer :
- Type de projet: Maven
- Langage: Java
- Version de Spring Boot: 2.7.17
- Packaging: Jar
- Version de java: 17
- Dépendances à sélectionner lors de l'initialisation du projet Spring :
- Spring Boot DevTools
- Spring Web
- Spring Data JPA
- MySQL Driver
- Ajouter cette ligne dans le fichier @/src/resources/application.properties:
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration. Elle permet de ne pas configurer de base de données pour l'instant - Commande pour télécharger/mettre à jour les dépendances:
mvn clean install -U, puis recharger le projet dans votre IDE avant de ré-executer le projet
Erreurs fréquentes
- Failed to determine a suitable driver class: https://www.baeldung.com/spring-boot-failed-to-configure-data-source
- Attention à la version de Java installé sur votre poste/configurer dans votre IDE
Objectif
Configurer la base de données, ajouter des controllers, et comprendre comment mettre à profit le framework pour produire de nouvelles fonctionnalités rapidement
Ressources:
- Spring: Accessing data with Mysql
- Créer des relations entre mes entités en JPA
- Pour aller plus loin concernant RESTful : Spring: Building REST services with Spring
Livrable attendu
Un repo Git contenant au moins les commits suivants :
- un tag 'db-ready' pour l'ajout de la connexion à la base de données
- un commit par fonctionnalité ajouté à votre API. Il ne s'agit pas de gérer les authorisations pour le moment. Votre projet doit être et rester fonctionnel à chaque étape.
Indications
- Attention à la documentation fournie en ressource. Il ne s'agit pas d'appliquer à la lettre les étapes proposées, mais plutôt de s'en inspirer pour l'appliquer au contexte fonctionnel du TP
- Penser à créer une base de données et ajouter un utilisateur exprès pour ce projet.
- Commande pour télécharger/mettre à jour les dépendances:
mvn clean install -U, puis recharger le projet dans votre IDE avant de ré-executer le projet - Lisez les logs de lancement de l'application. Ils vous en disent beaucoup sur les configurations détectées/chargées par Spring
- Avant de créer vos tables en SQL, écrivez votre entité java, executez à nouveau votre projet, et jetez à nouveau un oeil à votre BDD
Erreurs fréquentes
Objectif
Comprendre comment paramétrer un framework, surcharger ses comportements par défaut, et y intégrer nos propres besoins sans tout ré-inventer.
Ressources:
Livrable attendu
Un repo Git contenant au moins les commits suivants :
- tag authentification : vous avez ajouté l'obligation de s'authentifier pour accéder aux différentes fonctionnalités"
- tag autorisations : Vous avez adapté le comportement des différentes fonctionnalités en fonction de l'identité et des roles de l'utilisateur connecté
Indications
- Commande pour télécharger/mettre à jour les dépendances:
mvn clean install -U, puis recharger le projet dans votre IDE avant de ré-executer le projet - Après l'ajout de la dépendance de sécurité, rendez-vous à nouveau sur http://localhost:8080 avant d'aller plus loin. Vous devriez constater qu'une page de login vous est maintenant proposée
Erreurs fréquentes