AsyncTest

Appearance

模块扫描机制说明 ​

本章节将详细说明 AsyncTest Caller 中「模块扫描」的工作方式、刷新规则以及需要特别注意的行为原则，帮助你在使用前对扫描逻辑有一个清晰、可预期的认知。

📦 模块列表与扫描入口 ​

在插件面板中，你会看到一个 模块下拉列表：

  • 下拉列表中展示的是：
    👉 当前工程中已被扫描识别到的所有代码模块
  • 这些模块来源于项目结构（通常基于 pom.xml 的模块定义）

📸 示例界面：

模块下拉列表与刷新按钮

🔄 刷新按钮的作用 ​

在模块选择区域旁，会提供一个 刷新按钮：

  • 点击后将会：
    • 重新扫描 整个工程
    • 包括 所有模块
    • 以及 所有模块下的代码

📌 重要说明：

  • ✔️ 首次打开插件面板时，会自动进行一次扫描
  • ❌ 此后不会再有任何隐式 / 自动扫描
  • 所有重新扫描行为，必须由你显式触发（点击刷新）

📸 示例界面：

模块下拉列表与刷新按钮

🌳 树状结构的构建规则 ​

当你选择某个模块后，插件会以 树状结构 的形式展示扫描结果，其构建规则如下：

目录忽略规则 ​

  • 插件会 自动忽略：

src/main/java

  • 不会将该目录作为树的一级或二级节点直接展示

二级目录的确定方式 ​

插件会继续向下查找：

  • 第一个实际包含 Java 文件的目录
  • 该目录将作为：
  • 树状结构中的 二级目录
  • 其下的所有子目录，也会一并纳入树结构展示

📌 这样设计的目的：

  • 避免冗余、无意义的目录层级
  • 更贴近实际 Java 包结构
  • 提升接口与代码定位的效率

🖱️ 节点级别操作（右键菜单） ​

在树状结构中：

  • 每一个节点（模块 / 目录 / 子目录）
  • 都支持 右键单击操作

可用操作包括： ​

  • 刷新节点
  • 上传到 AsyncTest

📸 示例界面：

模块下拉列表与刷新按钮

刷新节点的含义 ​

当你对某个节点执行 刷新节点 操作时：

  • 会重新扫描：
  • 当前节点
  • 以及该节点下的 所有子节点
  • 等价于对该节点范围内的代码执行一次 局部重新扫描

上传到 AsyncTest ​

  • 该操作会基于 当前扫描结果
  • 将节点及其子节点下识别到的接口数据
  • 同步上传到 AsyncTest 平台

⚠️ 上传本身 不会触发任何隐式扫描

⚠️ 非常重要的行为原则 ​

除非界面上明确出现「刷新」字样的操作，插件不会进行任何主动扫描。

这包括但不限于：

  • ❌ 打开插件面板（首次除外）
  • ❌ 上传到 AsyncTest
  • ❌ 切换模块
  • ❌ 切换节点

使用前请确认 ​

在执行 上传到 AsyncTest 之前，请务必确认：

  • 当前扫描结果是：
  • 最新的
  • 符合你期望的
  • 如代码有改动：
  • 请先 手动刷新模块或节点
  • 再执行上传操作

📌 这是为了保证：

  • 插件行为可控、可预期
  • 避免因隐式扫描导致的数据不同步或误上传

✅ 小结 ​

  • 模块与代码的扫描 完全由你控制
  • 插件不会在后台进行任何“偷偷扫描”
  • 刷新即扫描，不刷新即不变
  • 上传前请始终确认当前扫描状态

理解这一点，将极大提升你在使用 AsyncTest Caller 时的安全感与确定性。