Rendu Webservice (Eliott CLAVIER / Maxime MARTIN / Florent CHABIN / Nathan PIGNON)

Ressources

• Dossiers du projet (dans ce repo Git)
• Collection de requêtes PostMan (à la racine de ce repository)
• ReadMe (Vous y êtes)
• Le Dump SQL est inclus dans le code source (cf 'Dump SQL / Gestion des données')

Mise en place de l'environnement

Importer le projet

Ouvrir un terminal dans le dossier où le projet sera importé

Écrire la commande suivante :

git clone https://github.com/Xamimus/Webservice.git

Ouvrir le projet dans un IDE

Mettre à jour les dépendances du projet (varie en fonction de l'IDE utilisé)

Clic droit sur 'pom.xml' :

-> "Update Project" (sous Visual Studio)

-> "Synchronize 'pom.xml'" (sous IntelliJ IDEA)

Base de données

Lancer Xampp ou Wampp ("Apache" et "MySQL")

Se rendre sur l'adresse suivante :

http://localhost/phpmyadmin/

Créer une nouvelle base de données se nommant :

webservice

Lancer le projet

Se mettre sur le fichier "ForumApplication.java" :

forum\src\main\java\com\b2dev\forum\ForumApplication.java

Lancer le projet

Tester le projet

Dump SQL / Gestion des données

Les tables ainsi que leur descriptions sont automatiquement importées dans la base de données "webservice"

Un jeu de fausses données est également importé, remplissant la base de données avec des entités semblant réalistes, à l'aide du composant Faker. A l'initialisaion du projet, la variable globale 'populateDb', se trouvant dans le fichier application.properties est réglé sur 'True', permettant ainsi cette génération.

Il est conseillé de le régler sur 'False' une fois les données générées.

Comptes mis à disposition

Des comptes pour les 4 niveaux de permissions sont mis à disposition, afin de tester facilement la gestion de ces dernières. Les mots de passes pour les 4 comptes sont : '1234'

• Anonyme : anonymous@test
• User : user@test
• Modérateur : moderator@test
• Admin : admin@test

Token JWT

La connexion vous mettra à disposition un Token JWT permettant l'authentification.

Pour les besoins du test, l'expiration des tokens a été considérablement rallongée, afin de faciliter les requêtes de notre collection Postman.

Importer un fichier JSON sur Postman

Cliquer sur "Import" (en haut à gauche)

Mettre le fichier JSON souhaité