Documentación / El IDE

REST Client y diagramas

Prueba tus APIs junto al código que las llama y entiende el sistema con diagramas de arquitectura, flujos, negocio y base de datos.

REST Client

El REST Client es una pestaña del editor, junto al código que llama. Depuras una petición y vuelves al archivo en un clic.

Abrirlo

  • Riel derecho → Más herramientas → REST Client. Su icono sube al riel mientras está abierto.
  • Alt+9.
  • Herramientas → REST Client, o REST en la paleta (Ctrl+Shift+A).

Colecciones

  • Colecciones y carpetas guardadas con el proyecto, renombrables.
  • Selector de método, tabla de headers y parámetros, cuerpo y vista de respuesta.
  • Variables con {{variable}}.
  • Peticiones generadas a partir de los endpoints de Spring.
  • Mover / Copiar a otro proyecto…
  • Junto al nombre de cada petición, el estado de su última respuesta.

Varios hosts por colección

Cada petición puede ir a:

Destino Cuándo
La URL tal cual Una petición concreta.
La aplicación local del proyecto localhost con el puerto en que arrancó.
Cualquiera de los hosts definidos Desarrollo, pruebas, preproducción…

Elige un host predeterminado por colección y cámbialo por petición, sin editar la ruta ni los parámetros.

Acentos sin símbolos raros

Los headers con acentos viajan en ISO-8859-1 (como los leen Java, Node y la mayoría de servidores) o en UTF-8 si lo eliges por colección. Las respuestas se leen con el charset que declara el servidor.

Certificados

Para servidores internos, marca la confianza en su certificado. Yuli lo pide siempre con tu confirmación.

Contratos

Las respuestas se validan contra el contrato. Una regla que no aplica se excluye para un campo o para todo el contrato, y se restaura desde la lista de excluidas.

Rendimiento

El panel Calidad, pestaña Rendimiento, muestra la latencia p50, p95 y p99 de las peticiones del REST Client.

El agente puede crear, enviar y revisar peticiones con yuli_rest_*. Pídele «prueba el endpoint de órdenes con un id que no existe».

Diagramas

Los diagramas del sistema se abren como pestaña junto al editor: riel derecho → Más herramientas → Diagramas, o Ctrl+Alt+D.

Pestaña Qué muestra
Sistema Contexto: qué expone y de qué depende.
Arquitectura Capas y dependencias entre componentes.
Flujos Paso a paso de cada caso de uso.
Negocio Reglas, datos consultados y efectos.
Código ↔ BD Qué DAO y repositorios llaman a qué funciones, paquetes y tablas.

Aplicaciones Java clásicas

Servlets (web.xml), acciones de Struts 1 y 2 y controladores Spring MVC entran como capa de entrada. Así ves el flujo completo: navegador → acción → servicio → DAO → base de datos, con las reglas de negocio, incluidos los filtros dentro de ciclos y el valor de las constantes.

Diagramas del método

  • Flujo y traza del método (Ctrl+Alt+F): grafo de flujo interactivo.
  • Diagramas de clase y de secuencia del método bajo el cursor.
  • Ajuste a la vista, zoom sobre el cursor y tamaño real.
  • Exportación de diagramas.
  • Fondo de diagramas: automático (según el tema) o blanco.

Mermaid en el chat

Los diagramas Mermaid que escribe el agente se dibujan dentro del chat.

Requisitos y trazabilidad

En el riel izquierdo, Más herramientas → Requisitos (Alt+Shift+R):

  • Importa documentos de requisitos y extrae reglas de negocio, por heurística o con IA.
  • Trazabilidad regla ↔ prueba: reglas sin cubrir y pruebas huérfanas.
  • Alertas cuando cambia una regla ya cubierta.
  • Marcas de regla visibles en el editor.