文档 / IDE

REST Client 与图表

在调用 API 的代码旁直接测试 API,并通过架构、流程、业务和数据库图表理解整个系统。

REST Client

REST Client 是一个编辑器标签页,就在调用它的代码旁边。调试完一个请求后,一键即可回到文件。

打开方式

  • 右侧边栏 → 更多工具 → REST Client。打开期间,它的图标会出现在侧边栏上。
  • Alt+9。
  • 工具 → REST Client,或在命令面板(Ctrl+Shift+A)中输入 REST。

集合

  • 集合和文件夹随项目一起保存,可重命名。
  • 方法选择器、headers 与参数表格、请求体和响应视图。
  • 使用 {{variable}} 定义变量。
  • 根据 Spring 端点自动生成请求。
  • 移动 / 复制到其他项目…
  • 每个请求名称旁显示其最近一次响应的状态。

一个集合,多个主机

每个请求可以发往:

目标 适用场景
原样使用 URL 某个具体请求。
项目的本地应用 localhost,使用应用启动时的端口。
任一已定义的主机 开发、测试、预生产……

为每个集合选择一个默认主机,并可按请求单独切换,无需修改路径或参数。

重音字符不再乱码

带重音字符的 headers 以 ISO-8859-1 传输(与 Java、Node 和大多数服务器的读取方式一致),也可以按集合选择 UTF-8。响应按服务器声明的 charset 读取。

证书

对于内部服务器,可以勾选信任其证书。Yuli 始终需要你的确认。

契约

响应会根据契约进行校验。不适用的规则可以针对某个字段或整个契约排除,也可以从已排除列表中恢复。

性能

质量面板的 性能 标签页显示 REST Client 请求的 p50、p95 和 p99 延迟。

智能体可以通过 yuli_rest_* 创建、发送和审查请求。试着对它说:“用一个不存在的 id 测试订单端点。”

图表

系统图表以标签页形式在编辑器旁打开:右侧边栏 → 更多工具 → 图表,或按 Ctrl+Alt+D。

标签页 显示内容
系统 上下文:系统对外暴露什么、依赖什么。
架构 各组件之间的分层和依赖关系。
流程 每个用例的逐步流程。
业务 规则、查询的数据及其影响。
代码 ↔ 数据库 哪些 DAO 和仓库调用了哪些函数、包和表。

经典 Java 应用

Servlet(web.xml)、Struts 1 和 2 的 action 以及 Spring MVC 控制器会作为入口层纳入。这样你就能看到完整流程:浏览器 → action → 服务 → DAO → 数据库,连同业务规则,包括循环内的过滤条件和常量的值。

方法图

  • 方法流程与调用追踪(Ctrl+Alt+F):交互式流程图。
  • 光标所在方法的类图和时序图。

浏览与导出

  • 适应视图、以光标为中心缩放和实际大小。
  • 导出图表。
  • 图表背景:自动(跟随主题)或白色。

聊天中的 Mermaid

智能体编写的 Mermaid 图会直接在聊天中渲染。

需求与可追溯性

在左侧边栏,更多工具 → 需求(Alt+Shift+R):

  • 导入需求文档并提取业务规则,可使用启发式方法或 AI。
  • 规则 ↔ 测试可追溯性:未覆盖的规则和孤立的测试。
  • 已覆盖的规则发生变化时发出警报。
  • 在编辑器中显示规则标记。