Documentation / L’IDE

REST Client et diagrammes

Testez vos API à côté du code qui les appelle et comprenez le système grâce aux diagrammes d’architecture, de flux, métier et de base de données.

REST Client

Le REST Client est un onglet de l’éditeur, à côté du code appelant. Vous déboguez une requête et revenez au fichier en un clic.

L’ouvrir

  • Rail de droite → Plus d’outils → REST Client. Son icône remonte dans le rail tant qu’il est ouvert.
  • Alt+9.
  • Outils → REST Client, ou REST dans la palette (Ctrl+Shift+A).

Collections

  • Collections et dossiers enregistrés avec le projet, renommables.
  • Sélecteur de méthode, tableau des headers et des paramètres, corps et vue de la réponse.
  • Variables avec {{variable}}.
  • Requêtes générées à partir des endpoints Spring.
  • Déplacer / Copier vers un autre projet…
  • À côté du nom de chaque requête, le statut de sa dernière réponse.

Plusieurs hôtes par collection

Chaque requête peut cibler :

Destination Quand
L’URL telle quelle Une requête précise.
L’application locale du projet localhost avec le port sur lequel elle a démarré.
N’importe lequel des hôtes définis Développement, test, préproduction…

Choisissez un hôte par défaut par collection et changez-le par requête, sans modifier le chemin ni les paramètres.

Des accents sans caractères bizarres

Les headers accentués sont envoyés en ISO-8859-1 (comme les lisent Java, Node et la plupart des serveurs) ou en UTF-8 si vous le choisissez pour la collection. Les réponses sont lues avec le charset déclaré par le serveur.

Certificats

Pour les serveurs internes, accordez votre confiance à leur certificat. Yuli le demande toujours avec votre confirmation.

Contrats

Les réponses sont validées par rapport au contrat. Une règle qui ne s’applique pas peut être exclue pour un champ ou pour tout le contrat, puis restaurée depuis la liste des exclusions.

Performances

Le panneau Qualité, onglet Performances, affiche la latence p50, p95 et p99 des requêtes du REST Client.

L’agent peut créer, envoyer et examiner des requêtes avec yuli_rest_*. Demandez-lui « teste l’endpoint des commandes avec un id qui n’existe pas ».

Diagrammes

Les diagrammes du système s’ouvrent dans un onglet à côté de l’éditeur : rail de droite → Plus d’outils → Diagrammes, ou Ctrl+Alt+D.

Onglet Contenu
Système Le contexte : ce qu’il expose et ce dont il dépend.
Architecture Les couches et les dépendances entre composants.
Flux Le déroulé pas à pas de chaque cas d’utilisation.
Métier Les règles, les données consultées et les effets.
Code ↔ BD Quels DAO et repositories appellent quelles fonctions, quels paquets et quelles tables.

Applications Java classiques

Les servlets (web.xml), les actions Struts 1 et 2 et les contrôleurs Spring MVC sont pris en compte comme couche d’entrée. Vous voyez ainsi le flux complet : navigateur → action → service → DAO → base de données, avec les règles métier, y compris les filtres à l’intérieur des boucles et la valeur des constantes.

Diagrammes de méthode

  • Flux et trace de la méthode (Ctrl+Alt+F) : graphe de flux interactif.
  • Diagrammes de classes et de séquence de la méthode sous le curseur.
  • Ajustement à la vue, zoom centré sur le curseur et taille réelle.
  • Exportation des diagrammes.
  • Fond des diagrammes : automatique (selon le thème) ou blanc.

Mermaid dans le chat

Les diagrammes Mermaid écrits par l’agent sont dessinés directement dans le chat.

Exigences et traçabilité

Dans le rail de gauche, Plus d’outils → Exigences (Alt+Shift+R) :

  • Importe des documents d’exigences et en extrait les règles métier, par heuristique ou avec l’IA.
  • Traçabilité règle ↔ test : règles non couvertes et tests orphelins.
  • Alertes lorsqu’une règle déjà couverte change.
  • Marqueurs de règle visibles dans l’éditeur.