Partie back de l’application

Description de la problématique

Ce chapitre présente la partie arrière d’une application avec une base SQL. Un chapitre dédié traitera de l’équivalent avec les bases NoSQL. Nous utilisons SQL avec des applications qui s’appuient sur une base de données historiquement SQL ou avec des applications qui changeront peu. En effet, la complexification d’une application basée sur une base de données relationnelle est à mettre en regard avec l’utilisation directe d’une base NoSQL.

Pour une base SQL, un ORM (Object Relational Mapping) est un outil qui permet de passer d’un modèle logique objet vers un modèle physique relationnel. Il en existe plusieurs comme Hibernate, MyBatis mais le plus utilisé est Hibernate qui est souvent couplé avec JPA.

JPA est une API Java qui s’appuie sur une implémentation d’un ORM, nous utilisons JPA avec Hibernate. Hibernate apporte des fonctionnalités supplémentaires. Les annotations et API Hibernate ne sont utilisées que si les fonctionnalités dont on a besoin ne sont pas disponibles par JPA.

L’ORM fait le lien entre la base de données et les objets Java de plus bas niveaux que l’on regroupe dans la couche dite « couche de domaine métier ».

Pour les cas simples, l’ORM gère le SQL pour...

Mise en œuvre

@Entity 
@Table(name = "table_book") 
public class Livre implements Serializable {  
@Id 
@Column(name = "id") 
   private String auteur; 
   private int nbPage; 
   private String titre; 
   // getters et setters 
  [...] 

@Entity 
public class Book implements Serializable { 
    @Id 
    private String title; 
    private int nbPage;  
 
 @OneToMany 
 private Set<Chapter> chapters = 
 new HashSet<Chapter>(); 
     // getters et setters 

Utilisation de MapStruct

Nous avons vu que notre code est organisé en couches. Nous pouvons utiliser le modèle DTO, qui consiste à définir des classes simples pour transférer des données entre les couches. Un des principaux problèmes que l’on rencontre réside dans l’écriture d’une grande quantité de code de mappage. Il existe une bibliothèque Java MapStruct qui permet d’automatiser, via de la génération de code, la phase de mapping à travers la description de celle-ci par des interfaces simples et des annotations sur les classes. MapStruct peut s’utiliser avec le CDI de Spring conjointement avec Lombok en créant sous la forme d’un bean le Mapper. La documentation se trouve ici : https://mapstruct.org/documentation/spring-extensions/reference/html/

Les générateurs de code

Swagger et OpenAPI ont tous les deux une suite d’outils qui permettent, entre autres, de générer du code depuis une description d’API et réciproquement. Nous avons déjà vu le plugin Springfox pour générer la description de l’API depuis le code, à la compilation et au runtime. Ils ont aussi des outils pour générer du code à partir de la descripion de l’API.

La description de l’API se fait à travers un fichier JSON ou un fichier YAML. À partir de ce fichier, il est possible de générer du code dans différents langages et pour différents serveurs. Nous nous concentrons sur la génération de code client et serveur avec les technologies Java et Spring Boot. Le générateur est polymorphe. Il existe sous la forme d’une CLI (Command Line Interface) dans un JAR, d’un paquet npm et d’un plugin maven.

La version maven est la plus simple pour pouvoir apporter des modifications. Nous avons en effet le même "problème" qu’avec les générateurs de code comme jHipster pour lesquels le modèle utilisé pour la génération ne correspond pas exactement aux fichiers que l’on souhaiterait. Les générateurs Swagger et OpenAPI n’ont pas les mêmes jeux de templates et ont chacun...

Utilisation du plugin

<plugin>  
<groupId>io.swagger</groupId>  
<artifactId>swagger-codegen-maven-plugin</artifactId>  
<version>3.8.1</version>  
<executions>  
 <execution>  
  <goals>  
   <goal>generate</goal>  
  </goals>  
  <configuration>  
   <inputSpec>swagger.yaml</inputSpec>  
   <language>java</language>  
   <library>resttemplate</library>  
  </configuration>  
 </execution>  
</executions>  
</plugin> 

<plugin>  
<groupId>org.openapitools</groupId>  
<artifactId>openapi-generator-maven-plugin</artifactId>  
<version>5.4.0</version>  
<executions>  
 <execution>  
  <goals>  
<goal>generate</goal>  
  </goals>  
  <configuration>  
<inputSpec>  
 ${project.basedir}/src/main/resources/petstore.yml  
</inputSpec>  
<generatorName>spring</generatorName>  
<apiPackage>fr.eni.openapi.api</apiPackage>  
<modelPackage>fr.eni.openapi.model</modelPackage>...

Spring Actuator

Spring Boot Actuator est un module qui permet d’obtenir des informations opérationnelles sur notre application.

Pour l’utiliser avec Spring Boot, il suffit d’ajouter la dépendance maven :

<dependency>  
   <groupId>org.springframework.boot</groupId>  
   <artifactId>spring-boot-starter-actuator</artifactId>  
</dependency> 

Le module fonctionne avec les applications Spring MVC et Spring Webflux et il utilise les endpoints HTTP et JMX pour exposer les informations.

Avec Spring Boot 2, seuls les endpoints /health et /info sont exposés pour limiter les problèmes de sécurité.

La configuration de la sécurité peut être faite via un bean de configuration :

@Bean  
public SecurityWebFilterChain securityWebFilterChain(  
 ServerHttpSecurity http) {  
   return http.authorizeExchange()  
     .pathMatchers("/actuator/**").permitAll()  
     .anyExchange().authenticated()  
     .and().build();  
}