Documentação / O IDE

REST Client e diagramas

Teste suas APIs ao lado do código que as chama e entenda o sistema com diagramas de arquitetura, fluxos, negócio e banco de dados.

REST Client

O REST Client é uma aba do editor, ao lado do código que faz a chamada. Você depura uma requisição e volta ao arquivo com um clique.

Como abrir

  • Barra lateral direita → Mais ferramentas → REST Client. O ícone sobe para a barra enquanto estiver aberto.
  • Alt+9.
  • Ferramentas → REST Client, ou REST na paleta (Ctrl+Shift+A).

Coleções

  • Coleções e pastas salvas com o projeto, que podem ser renomeadas.
  • Seletor de método, tabela de headers e parâmetros, corpo e visualização da resposta.
  • Variáveis com {{variable}}.
  • Requisições geradas a partir dos endpoints do Spring.
  • Mover / Copiar para outro projeto…
  • Ao lado do nome de cada requisição, o status da sua última resposta.

Vários hosts por coleção

Cada requisição pode ir para:

Destino Quando
A URL como está Uma requisição específica.
A aplicação local do projeto localhost com a porta em que ela iniciou.
Qualquer um dos hosts definidos Desenvolvimento, testes, pré-produção…

Escolha um host padrão por coleção e troque-o por requisição, sem editar o caminho nem os parâmetros.

Acentos sem símbolos estranhos

Os headers com acentos trafegam em ISO-8859-1 (como Java, Node e a maioria dos servidores os leem) ou em UTF-8, se você escolher isso por coleção. As respostas são lidas com o charset que o servidor declara.

Certificados

Para servidores internos, marque a confiança no certificado deles. O Yuli sempre pede isso com a sua confirmação.

Contratos

As respostas são validadas contra o contrato. Uma regra que não se aplica pode ser excluída para um campo ou para o contrato inteiro, e restaurada a partir da lista de excluídas.

Desempenho

O painel Qualidade, aba Desempenho, mostra a latência p50, p95 e p99 das requisições do REST Client.

O agente pode criar, enviar e revisar requisições com yuli_rest_*. Peça a ele: “teste o endpoint de pedidos com um id que não existe”.

Diagramas

Os diagramas do sistema abrem como uma aba ao lado do editor: barra lateral direita → Mais ferramentas → Diagramas, ou Ctrl+Alt+D.

Aba O que mostra
Sistema Contexto: o que expõe e do que depende.
Arquitetura Camadas e dependências entre componentes.
Fluxos O passo a passo de cada caso de uso.
Negócio Regras, dados consultados e efeitos.
Código ↔ BD Quais DAOs e repositórios chamam quais funções, pacotes e tabelas.

Aplicações Java clássicas

Servlets (web.xml), actions do Struts 1 e 2 e controllers do Spring MVC entram como camada de entrada. Assim você vê o fluxo completo: navegador → action → serviço → DAO → banco de dados, com as regras de negócio, incluindo os filtros dentro de laços e o valor das constantes.

Diagramas do método

  • Fluxo e rastreamento do método (Ctrl+Alt+F): grafo de fluxo interativo.
  • Diagramas de classe e de sequência do método sob o cursor.
  • Ajuste à visualização, zoom a partir do cursor e tamanho real.
  • Exportação de diagramas.
  • Fundo dos diagramas: automático (conforme o tema) ou branco.

Mermaid no chat

Os diagramas Mermaid que o agente escreve são desenhados dentro do chat.

Requisitos e rastreabilidade

Na barra lateral esquerda, Mais ferramentas → Requisitos (Alt+Shift+R):

  • Importa documentos de requisitos e extrai regras de negócio, por heurística ou com IA.
  • Rastreabilidade regra ↔ teste: regras sem cobertura e testes órfãos.
  • Alertas quando uma regra já coberta muda.
  • Marcações de regra visíveis no editor.