<aside> 📌

Objectif : installer le framework SAF, créer un microservice, configurer Maven et comprendre la communication entre acteurs (local et réseau).

</aside>

1. Prérequis et guide d’installation

1.1 Prérequis

Avant de commencer, assurez-vous d'avoir :

• Java 21 ou supérieur.
• IntelliJ d’installé, ainsi que spring-boot
• Maven (pour la gestion des dépendances).

1.2 Installation

Étape 1 — Cloner le framework

La première étape est de cloner le framework à partir du git

Afin de faire tourner nos 2 micros services, on va d’abord devoir rendre le framework accessible à tous les projets intelliJ sous la forme d’un .jar, pour ça au lieu de s’embeter à nous même faire un jar, on va utiliser Maven.

La première étape consiste à clôner le framework présent sur le git sur notre machine, git clone…[mettre la commande] vous verrez alors que vous aurez un package ou dossier nommé saf-framework, et dans ce package, on retrouve 2 autres packages :

• saf-core → package qui gère toute la partie acteur au sein d’un microservice, il n’a rien à voir avec spring en lui même. Il définit donc ce qu’est un acteur, les interfaces de Message, Acteur, et les méthodes tells etc..Il contient la classe ActorSystem qui est au coeur de notre microservice, elle a la double casquette de gérant de tous les acteurs du MS, elle les stocke basiquement avec une hashmap, mais elle a également le rôle de superviseur et donc toutes les x seconde, aller regarder chaque mailbox de chaque acteur pour voir si elle contient un message, et si oui dit à l’acteur “hey, t’as un message à lire”.
• saf-spring → package qui lui gère comment on va utiliser saf-core dans le cadre de micro service, via REST, donc sur spring. C’est lui qui sait comment utiliser un acteur d’un autre micro service (RestRemoteActorRef), et sait gérer la mailbox des acteurs via ActorSupervisor qui utilise le ActorSystem du package d’avant ! C’est également la classe qui gère donc les endpoints REST comme /messages par exemple ou /actors.

Étape 2 — Recharger Maven (pom.xml)

Puis, aller dans le pom.xml de chaque package, et à droite dans le logiciel cliquez sur le M

et sur les 2 flèches qui tournent pour Reload, faites le sur chaque pom.xml, celui de saf-framework, celui de saf-core, celui de saf-spring. Y’aura une barre bleu en bas à droite faut attendre qu’elle finisse de charger.

Étape 3 — Vérifier le JDK / SDK