[OSS26] 按签名模式搜代码 search_code_by_signature_pattern

[ponyha]

接口介绍

用正则模式匹配代码元素(方法/类/字段)的签名,例如"所有形参含 HttpServletRequest 的 public 方法"或"所有以 query、select、load 开头的方法",返回命中位置和签名片段。

工具名

search_code_by_signature_pattern

背景与目标

普通关键词搜只能匹配字符串本身,常被注释、字符串字面量、变量名干扰。本工具收紧到"代码元素签名级别":

• 找所有形如 public ResponseEntity<*> *(...HttpServletRequest...) 的 Controller 方法
• 找所有继承 Abstract*Filter 的类
• 找所有以 query、select、load 开头的方法

适合作为入门级"结构化搜索"工具。

输入参数

参数	类型	必填	说明
pattern	string	是	正则模式,如 public\s+\w+\s+\w+\s*\([^)]*HttpServletRequest
element_kind	enum(method, class, field, any)	是	匹配的代码元素类型
repository_path	string	是	仓库本地绝对路径
language	string	否	默认 java
max_results	int	否	默认 100

输出结构

{
  "pattern": "public\\s+\\w+\\s+\\w+\\s*\\([^)]*HttpServletRequest",
  "element_kind": "method",
  "total_matches": 18,
  "results": [
    {
      "file_path": "src/main/java/com/example/UserController.java",
      "line_number": 87,
      "matched_signature": "public ResponseEntity<User> getUser(HttpServletRequest req, @PathVariable String id)",
      "containing_class": "com.example.UserController"
    }
  ]
}

验收标准

• 在 Java 项目上能匹配方法、类、字段三种签名
• 跳过注释、字符串字面量内的伪命中(基础版可不做,加分项)
• 单元测试覆盖:方法/类/字段三种 element_kind、找不到、大量结果截断
• 中等仓库响应 < 3s

预估工作量

1-2 人日(line-based 实现可控)