Documentație / IDE-ul

REST Client și diagrame

Testează-ți API-urile lângă codul care le apelează și înțelege sistemul cu diagrame de arhitectură, fluxuri, business și bază de date.

REST Client

REST Client este o filă a editorului, lângă codul care face apelul. Depanezi o cerere și revii la fișier dintr-un clic.

Deschidere

  • Șina din dreapta → Mai multe unelte → REST Client. Pictograma lui urcă pe șină cât timp este deschis.
  • Alt+9.
  • Instrumente → REST Client, sau REST în paletă (Ctrl+Shift+A).

Colecții

  • Colecții și foldere salvate împreună cu proiectul, care pot fi redenumite.
  • Selector de metodă, tabel de headere și parametri, corp și vizualizarea răspunsului.
  • Variabile cu {{variable}}.
  • Cereri generate pornind de la endpoint-urile Spring.
  • Mută / Copiază în alt proiect…
  • Lângă numele fiecărei cereri, starea ultimului ei răspuns.

Mai multe hosturi pe colecție

Fiecare cerere poate merge către:

Destinație Când
URL-ul exact O cerere anume.
Aplicația locală a proiectului localhost cu portul pe care a pornit.
Oricare dintre hosturile definite Dezvoltare, testare, preproducție…

Alege un host implicit pentru fiecare colecție și schimbă-l pentru fiecare cerere, fără să editezi calea sau parametrii.

Diacritice fără simboluri ciudate

Headerele cu diacritice circulă în ISO-8859-1 (așa cum le citesc Java, Node și majoritatea serverelor) sau în UTF-8 dacă alegi asta pentru colecție. Răspunsurile sunt citite cu charset-ul declarat de server.

Certificate

Pentru serverele interne, marchează încrederea în certificatul lor. Yuli o cere întotdeauna cu confirmarea ta.

Contracte

Răspunsurile sunt validate față de contract. O regulă care nu se aplică poate fi exclusă pentru un câmp sau pentru tot contractul și restaurată din lista celor excluse.

Performanță

Panoul Calitate, fila Performanță, arată latența p50, p95 și p99 a cererilor din REST Client.

Agentul poate crea, trimite și verifica cereri cu yuli_rest_*. Cere-i „testează endpoint-ul de comenzi cu un id care nu există”.

Diagrame

Diagramele sistemului se deschid ca filă lângă editor: șina din dreapta → Mai multe unelte → Diagrame, sau Ctrl+Alt+D.

Filă Ce arată
Sistem Contextul: ce expune și de ce depinde.
Arhitectură Straturile și dependențele dintre componente.
Fluxuri Pas cu pas, fiecare caz de utilizare.
Business Reguli, date interogate și efecte.
Cod ↔ BD Ce DAO-uri și repository-uri apelează ce funcții, pachete și tabele.

Aplicații Java clasice

Servlet-urile (web.xml), acțiunile Struts 1 și 2 și controllerele Spring MVC intră ca strat de intrare. Astfel vezi fluxul complet: browser → acțiune → serviciu → DAO → bază de date, cu regulile de business, inclusiv filtrele din bucle și valoarea constantelor.

Diagramele metodei

  • Fluxul și urma metodei (Ctrl+Alt+F): graf de flux interactiv.
  • Diagrame de clasă și de secvență pentru metoda de sub cursor.
  • Încadrare în vizualizare, zoom pe poziția cursorului și dimensiune reală.
  • Exportul diagramelor.
  • Fundalul diagramelor: automat (după temă) sau alb.

Mermaid în chat

Diagramele Mermaid scrise de agent sunt desenate direct în chat.

Cerințe și trasabilitate

În șina din stânga, Mai multe unelte → Cerințe (Alt+Shift+R):

  • Importă documente de cerințe și extrage reguli de business, euristic sau cu IA.
  • Trasabilitate regulă ↔ test: reguli neacoperite și teste orfane.
  • Alerte când se schimbă o regulă deja acoperită.
  • Marcaje de regulă vizibile în editor.