Spring et JHipster

Introduction

Pour illustrer une utilisation avancée de Spring, nous regarderons quelques éléments de configuration d’un projet JHipster.

JHipster est un générateur d’application interactif. Il est basé sur Spring Boot et Angular avec Yeoman, Maven et/ou Gradle. Nous regarderons, dans ce chapitre, la partie back de l’application et la partie front avec Angular. JHipster évolue très rapidement, car il est très utilisé et a un très grand nombre de contributeurs.

La particularité principale de ce générateur est d’être en open source et que l’on peut assez facilement modifier les templates de génération pour générer ses propres applications. Il est très en vogue et les frameworks qu’il utilise en profitent pour s’améliorer en le prenant comme vecteur d’amélioration et comme démonstrateur. L’outil JHipster et ses templates sont écrits en JavaScript.

Nous ne verrons que quelques parties, car cet outil, qui est orienté DevOps, est très modulaire et couvre énormément de combinaisons de technologies.

L’outil JHipster est personnalisable, mais cette personnalisation n’est nécessaire que si on souhaite générer plusieurs applications. Pour un projet unique, deux points de vue s’opposent : partir...

Généralités

JHipster est un outil qui a été créé en 2014 par Julien DUBOIS, expert Spring et Java, entre autres.

Les statistiques indiquent plus de 168000 téléchargements par mois, 19335 étoiles sur GitHub et plus de 800 contributeurs. Plus de 300 entreprises utilisent officiellement JHipster. Le budget de sponsoring avoisine les 50k dollars par an et sert à financer les frais d’hébergement, les bugs Bounties, la correction de bugs ou des évolutions importantes et complexes.

Il est totalement déposé sous licence open source et collaboratif, l’URL du projet est https://www.jhipster.tech/. Il est composé d’un projet principal et de sous-projets.

Le but du projet est de nous aider à générer une application full stack, en un minimum de temps, avec un système de templates et de questions/réponses. Les aspects full stacks incluent le backend basé sur Springboot, la base de données et la partie front qui est basée sur les SPA (Single Page Applications) avec de l’Angular, du React, du Vue. Il inclut également le côté production avec la possibilité de préparer des environnements cloud et dockérisés. Il inclut aussi les tests et apporte ainsi une vision de bout en bout sur le projet.

L’adoption de l’outil par une grande communauté a permis de définir un certain nombre de bonnes pratiques. L’outil JHipster est disponible en ligne de commande et sous la forme d’une application web.

La ligne de commande permet de tout faire et il est possible de scripter. La version web est une version simplifiée qui est plutôt utilisée pour débuter.

1. JHipster web

Voici un exemple simple avec la version en ligne disponible à l’adresse : https://start.jhipster.tech/

Cette version est gratuite et open source. Il est tout à fait possible de la modifier pour la rendre disponible aux développeurs d’une société en personnalisant les modèles.

Il faut tout d’abord s’enregistrer, afin d’être dirigé sur la page principale.

La génération du projet s’effectue en deux étapes :

• Génération d’un squelette applicatif vide.

• Ajout...

Créer un blueprint

La documentation officielle est ici : https://www.jhipster.tech/modules/creating-a-blueprint

Un blueprint JHipster est un générateur Yeoman qui est composé à partir d’un sous-générateur JHipster spécifique pour étendre les fonctionnalités de ce dernier. Le blueprint peut remplacer tout getter défini du sous-générateur et fournir ses propres modèles et fonctionnalités. Les blueprints JHipster sont répertoriés sur le marketplace JHipster avec l’étiquette jhipster-blueprint. Cela permet de créer des blueprints tiers qui peuvent remplacer une partie spécifique de JHipster.

Pour utiliser un blueprint, exécutez la commande ci-dessous :

jhipster --blueprint <blueprint name> 

Il faut retenir qu’un blueprint JHipster possède les caractéristiques suivantes :

Un blueprint ne peut étendre que les sous-générateurs suivants (sous le dossier générateurs) :

Si on souhaite modifier un autre pack , il faut forker le générateur generator-jhipster. Un fork est plus complexe à maintenir par rapport aux évolutions des versions de JHipster.

JHipster comme outil multi-technologies

L’outil JHipster est un très bon outil pour essayer des technologies et voir comment elles s’articulent entre elles. Il essaie d’en montrer l’état de l’art et les bonnes pratiques JHipster supporte de nombreux frameworks et de nombreuses technologies.

Dans sa version 7, il gère les technologies suivantes :

Structure du projet

Nous allons illustrer l’architecture des applications générées avec JHipster via l’étude d’un cas de génération d’application simple Angular/Spring Boot simple.

JHipster et WebFlux

WebFlux a été intégré dans JHipster 6 et amélioré dans JHipster 7.

Cet ajout était très attendu par les utilisateurs. Il est déjà très complet et permet les expérimentations.

Au niveau des bases de données, il nous propose :

Si on choisit SQL, il propose alors en utilisant R2DBC :

Les couches domain, service, web sont conformes aux spécifications que nous avons vu dans le chapitre sur WebFlux.

Le fait d’avoir une application réactive change un peu certaines classes de configurations.

@Bean  
public R2dbcCustomConversions r2dbcCustomConversions(R2dbcDialect 
dialect) {  
 List<Object> converters = new ArrayList<>();  
 converters.add(InstantWriteConverter.INSTANCE);  
 converters.add(InstantReadConverter.INSTANCE);  
 converters.add(BitSetReadConverter.INSTANCE);  
 converters.add(DurationWriteConverter.INSTANCE);  
 converters.add(DurationReadConverter.INSTANCE);  
 converters.add(ZonedDateTimeReadConverter.INSTANCE);  ...