Version imprimable
Bonjour,
L'article a pour but de présenter la conception, l'architecture et le développement full stack d'une application web en s'appuyant sur les technologies Java, Spring Boot et Angular. Plusieurs concepts sont abordés et expliqués dans l'article par la mise en oeuvre d'un exemple concret d'une application.
https://gkemayo.developpez.com/tutor...spring-boot-2/
Qu'en pensez-vous ?
:fleche:Retrouvez les meilleurs cours et tutoriels pour apprendre le développement Web avec Spring Boot
bravo pour le tutoriel
en couplant tes entités, tu brises un peu le concept de package by feature architecture
il aurait été possible de passer par des id, sinon de copier les données et de passer par un événèment pour les mettres à jour, suppression...
Bonjour
Très bon tutoriel, cependant je rencontre quelques problèmes lors de l'exécution du code source téléchargeable à la fin de l'article.
Après avoir installé les dépendances avec npm install, j'exécute ng serve --open. Et là je reçois le message d'erreur suivant:
Je ne sais pas si c'est une erreur de votre part, mais il a fallu que je change le chemin menant vers proxy.conf.json dans le fichier angular.json pour régler le problème:Citation:
Proxy config file D:\workspace-spring_tool_suite\library-ui-master\src\proxy.conf.json does not exist.
Error: Proxy config file D:\workspace-spring_tool_suite\library-ui-master\src\proxy.conf.json does not exist.
au lieu de:Code:
2
Ensuite lorsque j'accède à la page book-page, je reçois le message d'erreur suivant:Code:
2
Ci-dessous une capture d'écran:Code:An error occurs when retreiving categories data
Pièce jointe 518945
Voici l'erreur au niveau du log:
MerciCitation:
Error occurred while trying to proxy request /library/rest/category/api/allCategories from localhost:4200 to http://localhost:8082 (ECONNREFUSED) (https
://nodejs.org/api/errors.html#errors_common_system_errors)
finalement ça marche.
Je lançais le projet via l'option Spring Boot App, mais j'ai par la suite opté de le lancer via le server tomcat installé, tout en changer le port 8080 en 8082, et ça a marché.
Bonjour,
Le tuto est vraiment bien fait.
J'ai juste un petit soucis avec la base de données H2. J'ai fait toute la partie back et j'ai voulu tester.
Au premier démarrage de tomcat, pas de soucis.
J'ai fais des modifications et depuis impossible de relancer l'application :
Je n'arrive pas à drop les données de la table category :/ j'ai essayé d'ajouté la commandeCode:
2
3
dans le fichier sql chargé au début mais cela me retourne une exception ..Code:truncate table category;
Edit : j'ai augmenté le cache de la log et je vois qu'en fait le soucis provient d'un drop qui ne se fait pas sur mes tables à cause de FK qui ne sont pas supprimées...
Code:
2
Bonjour Marc.collin,Citation:
Envoyé par marc.collin
Tu as parfaitement raison, la contrainte du package by feature vient vraiment des "ressources" qui sont partagées entre domaines. J'étais bien conscient que je n'ai pas fait un aboutissement de cette architecture dans l'article. Le but est dans un premier temps de sensibiliser le lecteur sur cette architecture qui apporte son lot de concepts, d'avantages et d'inconvénients. Si le lecteur s'y intéresse, il ira chercher plus d'infos.
Les solutions que l'on peut proposer pour adresser ce problème sont multiples, chacune possédant ces avantages et inconvénients. Pour la solution que tu proposes de copier les données et de d'utiliser l'event sourcing pour les mettre à jour, c'est bien, mais ça passe par une duplication de données et la mise en place de l'event sourcing pour mettre à jour chaque domaine. C'est complexe et impossible d'expliquer tout cela dans un seul et même article :).
Je peux même aller plus loin en disant que l'on peut même mettre en place le pattern Capture Data Change couplé à Kafka qui se chargera de mettre à jour la/les tables de chaque domaine. Là encore c'est très complexe et trop de travail rien que pour respecter le principe du package by feature.
Il vaut mieux s'y investir sur tout ce que nous venons de citer lorsqu'on est vraiment en contexte Microservice ou une vraie architecture domaine driven.
D'autres son de cloche, disent de sortir exceptionnellement les "ressources" partagées (en veillant à ce que cela ne devienne pas un fourre tout) dans un package "common" afin que les différents domaines se les partagent. Ce n'est pas moins intelligible, après tout c'est une organisation dans un seul et unique projet.
Cordialement,
Georges
:ccool:Citation:
Envoyé par momjunior
Citation:
Envoyé par DarkChyper
Salut DarkChyper,
Normalement cela ne devrait pas poser de problème si tu arrêtais toute l'application via ton Tomcat en faisant un shutdown en invite de commande dans le dossier bin.
Puis en redémarrant avec start. Puisque l'appli utilise une base embarquée, tout devrait se réinitialiser au redemarrage.
Assures toi juste qu'aucun processus lié ne tourne au préalable sur ta machine.
Cordialement,
Georges
Bravo et merci pour cet excellent article
Bonjour,
Toujours admiratif du temps passé à écrire ce type de tutoriel surtout quand la qualité est au rendez vous.
Merci pour le partage.
Salut,
j'ai bien suivi toutes les étapes de ce tuto,mais j'ai des problèmes à la phase de déploie de déploiment !!
les erreurs sont indiquées aux pièces jointes.
Merci de me proposer une solution!
Salut,
tu effectues sans doute une Insertion avec la meme clé primaire dans la table Categorie. As tu declaré cette clé Auto_increment ?
Eric
J'ai suivi exactement le tuto: les données de la table Categorie sont nomrmalement insérés une seule fois grace à la fichier "categories.sql" (Citation:
Envoyé par jeffray03
insert into category values ('INF', 'Informatique');
insert into category values ('MAT', 'Mathématiques, Physiques et Chimie');
..)
l'utilisateur n'as pas besoin de changer les données!
(clé primaire n'est pas Auto_increment)
salut,
cela peut etre due, du fait qu´a chaque demarrage, tu fais un insertion dans la base de données sans l´avoir d´abord supprimmer et recréer.
montres nous le fichier de configuration.
Eric
Je suis en train de trouver une autre solution :
1)j'ai lancé le "Back-end" avec l'option Spring Boot App (port : 8082)
2)j'ai lancé le "Front-end" avec l'option npm start (port : 4200)
dans le navigateur je peux voir les 2 projets mais le problème est la connexion entres eux ! car j'ai obtenu cette erreur :
[HPM] Error occurred while trying to proxy request /library/rest/category/api/allCategories from localhost:4200 to http://localhost:8082 (ECONNREFUSED) (https://nodejs.org/api/errors.html#e..._system_errors)
Citation:
Envoyé par selmen95
Bonjour Selmen95,
Attention !!! Le problème peut provenir du fait que tu essais de lancer plusieurs instances du Back-End. Dans ce cas, tu rencontreras forcément une violation de clef primaire. Car les scripts SQL d'insertion au démarrage de l'application ne sont pas protégés. Peux-tu essayer de stopper toutes les instances de ton serveur Tomcat (commande shutdown) et même aller jusqu'à vérifier dans ton Gestionnaire de tâches que tu n'en a pas un rebelle qui continue de tourner en backoffice ? Tu peux aussi essayer la commande ps pour lister les processus en cours sur ta machine... Je te rappelle enfin que si tu as lancé aussi des traitements sur la Back-end/Front-end dans ton terminal Eclipse, cela peut être source de conflit également lorsque tu essais de les lancer via Tomcat.
Après avoir vérifié et fermé tous les processus liés, démarre une nouvelle instance de Tomcat et fais moi un retour.
Merci,
Georges
Merci, mais j'ai rencontré le même problème !Citation:
Envoyé par misterKool
Bonjour et Bravo pour ce tutoriel,
Voici quelques remarques:
- L'architecture que vous présentez me semble bonne, mais adaptée pour des applications ayant très peu de classes ou de fonctionnalités , qu'en dites-vous ?
- Par contre faites attention à vos contrôleurs. Car il y a du code métier dans vos contrôleurs puisque vous n'exploitez pas bien les réponses HttpStatus et ResponseEntity
Voici un exemple de votre contrôleur avec du traitement métier
Voici un exemple de solution pour le service que je propose (Classe de gestion des exceptions à créer CustomerResourceException):Code:
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17@PostMapping("/addCustomer") public ResponseEntity<CustomerDTO> createNewCustomer(@RequestBody CustomerDTO customerDTORequest) { //, UriComponentsBuilder uriComponentBuilder Customer existingCustomer = customerService.findCustomerByEmail(customerDTORequest.getEmail());//pas besoin if (existingCustomer != null) { //pas besoin return new ResponseEntity<CustomerDTO>(HttpStatus.CONFLICT); // pas besoin, ce traitement doit être fait par le service qui gère la sauvegarde, il faut renvoyer directement l'exception depuis le service } Customer customerRequest = mapCustomerDTOToCustomer(customerDTORequest); customerRequest.setCreationDate(LocalDate.now()); Customer customerResponse = customerService.saveCustomer(customerRequest); if (customerResponse != null) {//idem, pas besoin CustomerDTO customerDTO = mapCustomerToCustomerDTO(customerResponse); return new ResponseEntity<CustomerDTO>(customerDTO, HttpStatus.CREATED); } return new ResponseEntity<CustomerDTO>(HttpStatus.NOT_MODIFIED); }
Et voici ce que devient le contrôleur:Code:
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Voici un exemple du constructeur de ton ExceptionCode:
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19@PostMapping("/addCustomer") public ResponseEntity<CustomerDTO> createNewCustomer(@RequestBody CustomerDTO customerDTORequest) { //, UriComponentsBuilder uriComponentBuilder try{ Customer customerRequest = mapCustomerDTOToCustomer(customerDTORequest); customerRequest.setCreationDate(LocalDate.now()); Customer customerResponse = customerService.saveCustomer(customerRequest); CustomerDTO customerDTO = mapCustomerToCustomerDTO(customerResponse); return new ResponseEntity<CustomerDTO>(customerDTO, HttpStatus.CREATED); } catch (CustomerResourceException ex) { //Traitez vos erreurs ici par un log si nécessaire return new ResponseEntity<CustomerDTO>(ex.getHttpStatus()); //Ici tu gères à la fois plusieurs types d'erreurs comme HttpStatus.NOT_MODIFIED, HttpStatus.CONFLICT etc , au lieu de forcer la réponse à HttpStatus.NOT_MODIFIED uniquement } catch (Exception ex) { //Traiter les erreurs techniques ici par un log return new ResponseEntity<CustomerDTO>(HttpStatus.INTERNAL_SERVER_ERROR); // un cas typique d'erreur ici serait une erreur liée au mapping, ou autres erreurs non gérées par le service } }
Note: Penser aux getter/setter dans l'exceptionCode:
2
3
4
5
Au final, pas besoin d'une requête supplémentaire customerService.findCustomerByEmail(xxx) dans le createNewCustomer car, en cas conflit, le service sait le code d'erreur à retourner
Bon courage !!!!
Bonjour parchemal,
Je te remercie pour tes remarques.
Le package by feature est une architecture contraignante qui a ses avantages et ses inconvénients comme j'ai tenté d'en citer quelques uns dans l'article. Je ne peux pas trancher ta question, car elle est philosophique à mon sens. D'aucuns n'y verront aucun souci à tes réserves, d'autres diront autant mieux aller vers les microservices en cas d'un grand nombre de fonctionnalités.Citation:
Envoyé par parchemal
Pour ton deuxième point, tu as tout à fait raison, mais je dirai tout d'abord que tout code est perfectible. On pourrait même convoquer d'autres notions de clean code pour améliorer d'avantage. Cela dit, cet article ne porte pas sur le clean code ni sur la gestion optimale des exceptions. L'article se focalise sur l'initiation du lecteur à diverses notions et leurs mises en œuvre et non sur une démonstration du code parfait :). La revue de code et son optimisation est très important dans un projet professionnel, mais pas dans un cours à mon avis, sauf si cela fait partir des objectifs explicite du cours.Citation:
Envoyé par parchemal
Qu'à cela ne tienne, je te remercie encore une fois pour tes remarques pertinentes. Ceux qui réussiront à mettre en place les notions distillées dans mon article et qui veulent aller plus loin doivent s'inspirer de tes remarques.
Georges
Bonjour, et tout d'abord merci beaucoup pour ce tutoriel très bien réalisé au cours duquel j'apprends beaucoup.
Ayant un profil débutant junior en java/angular, je me suis attelé à ce tutoriel il y a quelques jours. Je rencontre un petit problème que je vais essayer de décrire au mieux :
En effet, arrivé à la finalisation du back end et au test des web services de l'API Rest, je n'arrive pas à lancer le serveur Tomcat (j'utilise la v.9), j'ai configuré le port en 8082.
Le problème vient (je suppose) du fait que je n'arrive pas à établir la connexion avec la BDD car je relève un message d'erreur qui jette une DbException avec la mention :
"Erreur du fichier journal C:/Windows/System32/src/main/resources/database/library-db.trace.db Erreur lors de la création du fichier ""C:/Windows/System32/src""
D'autre part j'ai une autre exception qui découle de la première du type :
"org.h2.jdbc.JdbcSQLNonTransientException: Erreur du fichier journal: "C:/Windows/System32/src/main/resources/database/library-db.trace.db"
Je suppose que j'ai un soucis au niveau de la gestion des ressources de la Database :
J'ai téléchargé le fichier "library-db.mv.db" dans le dossier database comme indiqué dans l'arborescence du projet, en revanche je n'utilise pas le fichier library-trace.trace.db.
Je ne sais pas comment me vérifier. Au départ, j'avais tapé tout le code moi-même, et j'ai créé un second projet où j'ai copié-collé les sources sur github et le résultat et le même.
Vous remerciant
Citation:
Envoyé par olivier252
Bonjour Olivier252,
Je ne crois pas avoir tout saisi dans vos explications, mais au regard de la stacktrace, le fait d'avoir le chemin C:/Windows/System32/src/main/resources/database/library-db.trace.db montre qu'il y a un problème de configuration. Tu as du faire une manipulation qui force l'application à rechercher ta base de données dans C:/Windows/System32/, ce qui n'est pas du tout cohérent.
Alors, ce qu'il faut savoir de façon générale, c'est que la base de données utilisée dans cette application exemple est une base de données embarquée. C'est-à-dire, une base régie par une dépendance (en l'occurrence H2) qui fait partir intégrante de ton application. Deux façons de la configurée :
- soit on la configure pour qu'elle stocke les données en mémoire, c'est-à-dire dans la RAM de ta machine pendant que l'application est en cours d'exécution,
- soit on la configure pour qu'elle stocke les données dans un fichier de façon plus durable, au délà de l'arrêt de l'appplication. Mais le point important dans ce cas est de savoir que pour une question de portabilité de ton application, il est nécessaire que ce fichier fasse également partir intégrante celle-ci. (Ce cas est celui choisi dans mon article).
C'est pourquoi tu verras que dans le fichier de configuration application.properties, on a : spring.datasource.url = jdbc:h2:file:./src/main/resources/database/library-db
Le "." après le ":" est très important. C'est le symbole du répertoire courant qui signale qu'il faut générer la base de données en partant de l'emplacement de l'application.properties jusqu'au répertoire ..../database. Quand tu as fini de faire ceci, c'est la dépendance H2 qui génère ta base de données (library-db.trace.db) pour toi. Cette génération affectera dans les propriétés du fichier résultat son chemin quasi absolu (notamment : /library/src/main/resources/database/library-db.trace.db et non pas C:/Windows/System32/src/main/resources/database/library-db.trace.db).
Je pense pour ma part qu'il ne faut pas que tu fasses de copier/coller du fichier library-db.trace.db et le déposer n'importe où sur ta machine, comme j'ai cru lire, et espérer que cela fonctionne. Si tu as bien configuré la propriété spring.datasource.url, fait un mvn clean package de ton projet et suit minutieusement l'étape sur le déploiement, ça devrait aller.
En espérant t'avoir éclairé.
Cordialement,
Georges
Bonjour et merci pour ton aide,
Le problème vient du fait que je ne suis pas encore à l'aise avec Tomcat. Je pense avoir compris en partie mon erreur car je lançais un serveur Tomcat que j'avais spécialement configuré pour l'appli "library" en allant
dans Windows->preferences->server...
J'avais omis le fait que spring boot embarque directement un serveur comme c'est précisé dans le pom.xml et dans tes explications d'ailleurs...
Du coup en lançant l'appli en "run as->spring boot app" directement je n'ai plus de stack d'erreur en sortie console. En revanche, l'url http://localhost:8082/library/swagger-ui.html#/ (port 8080 pour moi) conduit à une page blanche avec une erreur 404
Pièce jointe 565708
Je précise que swagger est bien configuré dans mon pom.xml comme ceci :
Pièce jointe 565718
D'autre part le fichier "library-db.trace.db" est bien généré mais il indique qu'il ne peut pas supprimer les tables Book, Customer, et Category à cause des clés étrangères qui unissent ces dernières entre elles (comme DarkShyper qui avait remonté cela).
Quoi qu'il en soit, merci encore pour ta réponse et ce tuto, j'arrive à faire tourner la partie AngularJs et j'ai compris la liaison d'un backend et d'un frontend dans les grandes lignes pour l'instant. Je vais me remettre au travail sur le backend, je devrais trouver à force de persévérance
Salut Olivier252,
Bravo pour ta détermination, tu vas y arriver.
Pour l'url http://localhost:8082/library/swagger-ui.html#/ qui ne fonctionne pas, c'est normal. En fait, cette url est celle qui fonctionnera quand tu auras déployé ton application dans un vrai Tomcat physique installé sur ta machine (pas celui embarqué dans le livrable par Spring Boot) (voir section XV-C).
Par contre, puisque tu exécutes l'application en t'appuyant sur le Tomcat embarqué, tu as deux solutions :
- Soit tu ne fais rien et tu recherches ton Swagger sur l'url suivante : http://localhost:8080/swagger-ui.html#/
- Soit tu ajoutes dans l'application.properties, les propriétés suivantes pour utiliser l'url http://localhost:8082/library/swagger-ui.html#/ :
Code:
2server.port=8082 server.servlet.context-path=/library
Bon courage à toi.
Georges
Merci beaucoup Georges, cette fois cela fonctionne !
En revanche tu précises l'url "http://localhost:8082/library/swagger-ui.html#/" dans le chapitre XI "Documenter et tester l'API REST avec Swagger". Je ne sais pas si c'est normal où si il s'agit d'une erreur et c'est sur cette incompréhension que je butais.
Merci encore pour ton aide précieuse et le partage de ce tuto au contenu pédagogique excellent.
Olivier
Merci à toi Olivier pour tes compliments.
Pour ta remarque sur l'url, je te comprends, mais dans l'esprit du tutoriel les sections contenant les configurations s'enchainent les unes après les autres avec pour but de pouvoir tester le TOUT à la fin (c'est-à-dire, la section consacrée à la démo donc). Cela veut dire naturellement que si tu t'arrêtes à une étape intermédiaire et tu veux faire fonctionner l'application, c'est normal que ça ne marche pas :D. Ce type de tutoriel est du tout ou rien, si tu passes à la pratique et veux avoir quelque chose de complètement fonctionnel à la fin. Ce qui n'est pas le cas lorsque tu veux juste t'enrichir des connaissances diffusées dans les différentes sections.
Bonne continuation.
Georges
Bonjour Georges,
Ok, bien compris ta réponse. Maintenant je vais repasser tout le code point par point pour assimiler certains concepts qui ne sont pas clairs pour moi comme certaines annotations JPA (@embeddable et @EmbeddedId par exemple) ou encore l'implémentation des webservices...
J'ai vu que tu avais le projet de sorti un tuto sur jenkins et l'intégration continue, sache que je suis preneur car je me rends compte qu'à l'école nous n'avons fait que créer de petits projets, mais la partie "mise en prod" a été très souvent occultée.
Bien à toi
Salut Olivier,
Oui l'article sur l'intégration continue avec Jenkins est dans mon bac à sable avec beaucoup d'autres sujets. Le seul problème c'est le temps. Je ne peux pas te dire aujourd'hui quand est-ce que cet article arrivera.
Bon courage à toi.
Cordialement,
Georges
Bonjour Georges,
Bien sûr, je comprends tout à fait. Le partage que tu as fait est déjà énorme. J'ai cherché des exos similaires, et je n'ai pas trouvé d'équivalent.
Pour tout t'avouer j'en ai parlé à un entretien d'embauche en présentant les différentes parties du code car je termine tout juste mes études (niv bac+2 analyste programmeur)
J'ai bien sûr fourni ta source, en précisant que je n'aurais pas pu fournir un tel travail seul.
Maintenant j'essaie de réaliser un petit logiciel de gestion des stocks par moi-même afin de grossir un peu mon portefeuille de réalisations.
Bonne continuation
Je t'en remercie Olivier.
Bonne chance et bonne continuation à toi. Surtout reste motivé, l'IT est un domaine passionnant.
Cordialement,
Georges
Merci pour le travail complet.
Je te felicite pour le travail qui est bien détaillé et bien expliaué srt pour un débutant.
Mais, je trouve de mal à le compiler.
Le Backend marche tres bien, j'ai même réusii à le refaire en suivant tes indications.
Par contre le front end me signale des erreurs de compilations.
même en compilant avec: ng serve sur Angular ca marche pas
Enfin ca marche. Il fallait que je change dans: proxy.conf.jsonCitation:
Envoyé par Aminou81
Ainsi ca marche et je ne sais par pouquoi;Code:
2
3
4
5
6
7
8
9
Merci une autre fois.
Salut Aminou81
Merci et bravo pour avoir réussi a régler ton problème.
Georges
Bonjour, je reçois cette erreur au niveau de mon mapping
Error creating bean with name 'ICustomerDao' defined in com.biblio.fr.biblio.repository.ICustomerDao defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Cannot resolve reference to bean 'jpaMappingContext' while setting bean property 'mappingContext'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'jpaMappingContext': Invocation of init method failed; nested exception is org.hibernate.AnnotationException: Use of @OneToMany or @ManyToMany targeting an unmapped class: com.biblio.fr.biblio.entite.Book.loans[com.biblio.fr.biblio.entite.Loan]
Et pourtant j'ai bien annoté mes classes d'entité.
Quelq'un a une idée
Bonjour lnquaidorsay,
Je vois que tu reprends la tuto en essayant de construire l'application avec tes packages à toi. C'est très bien, c'est comme cela que l'on apprivoise le truc.
Cependant pour ton problème, juste deverser la stacktrace ou un bout de stack trace ne suffit pas. Il aurait fallu un petit context aussi.
Mais vraisemblablement quand je regarde la dernière ligne de ta stack, je mise sur un mauvais mapping au niveau de ton entité Loan (qui est une classe-association !!!). Peut-être as-tu utiliser une autre approche ?
Cordialement,
Georges
