文档 / 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。
- 规则 ↔ 测试可追溯性:未覆盖的规则和孤立的测试。
- 已覆盖的规则发生变化时发出警报。
- 在编辑器中显示规则标记。