VERSION DU CODE SOURCE

TP : CRÉER LE CODE SOURCE JAVA (SPRING BOOT)

Par BOUMO Marius Landry

Qualité du code source : Code source et importance du test

Dans cet exercice, nous allons créer un projet JAVA utilisant le framework
Spring Boot.
Ce framework nous permettra d'avoir un ensemble de fonctionnalités déjà
prêtes à l'utilisation. Nous prendrons donc un petit temps pour le
configurer et nous allons prendre le reste du temps nous concentrer sur le
code.

(1) Création du projet Java Spring Boot :

Aller sur le site de Spring à l'adresse https://start.spring.io/ et configurons

notre projet comme suit :

cocher :
- Maven Project (pour la gestion des dépendances) dans le groupe
d'option "Project"
- Java dans le groupe dóption "Language"
- 2.7.5 dans le groupe d'option "Spring Boot"
Dans "Project Metadata" définir:
- com.irc dans "Group"

Par BOUMO Marius Landry

1
Qualité du code source : Code source et importance du test

- vcs dans "Artifact"

- "Projet visant à définir des fonctionnalités et à les tester dans la
description.
Ensuite, cocher "Jar" dans le groupe d'option "Packaging", puis la version 11
dans le groupe d'option Java.

Nous allons ensuite ajouter des dépendances qui vont nous permettre
d'augmenter nos fonctionnalités dans notre projet.

Saisir "web" dans la barre de recherche et sélectionner "Spring Web";

Ensuite, saisir "jpa" dans cette même barre et sélectionner "Spring Data
JPA" et enfin, saisir "h2" dans cette même barre et sélectionner "H2
Database". L'image ci-dessous montre le rendu après avoir choisi toutes
ces dépendances.

Par BOUMO Marius Landry

2
Qualité du code source : Code source et importance du test

Maintenant nous allons générer notre projet en cliquant sur le bouton

"Generate" situé en bas de la page.
Cette action va créer un fichier compressé (.zip) portant le nom de l'artefact
de votre projet. (vcs.zip)

(2) Décompresser le projet dans un répertoire :

Aller dans le répertoire des projets de votre machine, créer un répertoire

nommé "repositories" et décompresser votre fichier "vcs.zip" à l'intérieur.
Il créera un repertoire nommé "vcs"; ce repertoire représente votre projet
Java Spring Boot.

(3) Ouvrir votre projet avec INTELLIJ :

Lancer le logiciel INTELLIJ installé dans votre machine; Allez dans la barre
de menu et sélectionnez: Fichier > Ouvrir… et aller sélectionner le dossier
"cvs" que vous avez décompressé dans le répertoire "repositories";

Par BOUMO Marius Landry

3
Qualité du code source : Code source et importance du test

Vous obtiendrez ce résultat:

Nous avons la structure de notre projet représentée dans le panneau à

gauche.

Double Cliquez sur le fichier "pom.xml" pour voir son contenu sur le
panneau du milieu. à ce stade, Maven est en train de vouloir installer les
dépendances, vous devez vous rassurer que vous êtes connecté à internet.
Si vous remarquez des lignes rouges dans votre fichier pom.xml, c'est que
ces dépendances ne sont pas encore installées (ou pas fini d'être
téléchargées)

Par BOUMO Marius Landry

4
Qualité du code source : Code source et importance du test

Si vous souhaitez télécharger les dépendances (manquantes ou non), vous

sélectionnez le fichier pom.xml et n'importe où à l'intérieur, faites un clic
droit et allez sur : maven > recharger le projet.

Par BOUMO Marius Landry

5
Qualité du code source : Code source et importance du test

Aller dans src > main > ressources > application.properties et entrez les
configurations suivantes:
Application.properties:

#Global configuration
spring.application.name=vcs
server.port=8000
#Tomcat configuration
server.error.include-message=always

Par BOUMO Marius Landry

6
Qualité du code source : Code source et importance du test

#Log level configuration

logging.level.org.springframework.boot.web.embedded.t
omcat=INFO
#H2 Database
# H2 Database
spring.h2.console.enabled=true
spring.datasource.url=jdbc:h2:mem:vcs_db
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2
Dialect
spring.jpa.open-in-view=false

Ça y est, notre application est prête à être lancée. Cliquez sur le triangle
vert situé à la ligne 9 pour lancer l'application.

Structure des dossiers d'un projet Java Spring Boot:

Nous allons voir par la suite l'ensemble des dossiers et fichiers et leur
objectifs.

Par BOUMO Marius Landry

7
Qualité du code source : Code source et importance du test

1 : Répertoire Source du projet qui

contient toutes les sources du
projet.

2 : Répertoir principale du projet

dans lequel l'on trouve le code
Java et les ressources

3 : classe principale du projet qui

exécute l'application.

4 : Fichier de configuration de
l'application

5 : Répertoire dans lequel réside

les fichiers compilés pour lancer
l'application

6 : Fichier XML de gestion de

dépendances utilisé par MAVEN

Par BOUMO Marius Landry

8
Qualité du code source : Code source et importance du test

CONTEXT DE L'APPLICATION
Nous souhaitons concevoir une application qui va manager les produits
d'une boutique.
Le MLDR suivant définit les entitées du système et leur relation:

PRODUCT_CATEGORY (id, name, description)

PRODUCT (id, matricule, name, description, created_at,
#product_categori_id)

Le principe ici est de pouvoir créer des catégories et des produits

appartenant à ces catégories.
- plusieurs produits peuvent appartenir à une et une seule catégories
- les champs id et name sont obligatoire dans la table
PRODUCT_CATEGORY
- les champs id, name, et product_categori_id sont obligatoires dans la
table PRODUCT
- le matricule du projet est auto généré par le système selon le format
suivant : PDT.20221114.1 (où PDT représente le prefix, 20221114
représente la date au format YMD et 1 représente son identifiant)

Dans un projet Java Spring Boot, Nous commencerons par créer les entités
métier qui vont manipuler nos données.

ENTITÉS :
Nous allons créer un package nommé "entity" qui comportera toutes nos
entités.

Par BOUMO Marius Landry

9
Qualité du code source : Code source et importance du test

Faites un clic droit sur le package "com.irc.vcs" > nouveau > package et
créer un package nommé : com.irc.cvs.entity

Créons ensuite une classe java dans le package entity qui va représenter
l'entité PRODUCT_CATEGORY; pour cela faire un clic droit sur le package
entity > nouveau > classe Java et nommer cette classe en
ProductCategory.

Double Cliquer sur cette classe et là modifier comme suit :

Par BOUMO Marius Landry

10
Qualité du code source : Code source et importance du test

Inspections un peu ce code :

- @Entity est une annotation que précise à spring que celle classe
représente une entité
- @Id précise que la propriété id de la classe représente l'identifiant de
l'entité

Par BOUMO Marius Landry

11
Qualité du code source : Code source et importance du test

- @GeneratedValue(strategy = GenerationType.AUTO) représente la

stratégie de génération d'identifiant de la table; dans ce cas, l'id sera
AUTO_INCREMENT (auto incrémenté)
- @Column(nullable = false) permet de donner des indications
particulières pour une propriété (une colonne au niveau de la base
de donnée); ici l'on veut que cette colonne soit obligatoire;

De la même façon, nous allons créer l'entité "Product" qui représentera la

table des "produits":

Par BOUMO Marius Landry

12
Qualité du code source : Code source et importance du test

Maintenant définissons les relations entre ces 2 entités:

de PRODUCT_CATEGORY → PRODUCT il y a une relation de ONE To MANY
et de PRODUCT → PRODUCT_CATEGORY il y a une relation de MANY To
ONE.

Allons dans la classe "Product" et ajoutons les la relation avec l'entité

ProductCategory:

Par BOUMO Marius Landry

13
Qualité du code source : Code source et importance du test

dans la classe "ProductCategory" et ajoutons les la relation avec l'entité

Product:

Par BOUMO Marius Landry

14