[OSS26] 按方法名读取方法源码 read_method_source_by_method_name

接口介绍

给定方法的全限定名(可选形参类型用于重载消歧),精准返回该方法的源码片段(可选携带 Javadoc 与注解),不带文件其他部分;有重载且未消歧时返回所有候选。

工具名

read_method_source_by_method_name

背景与目标

文件级读取(read_file_by_path)是文件级粒度,LLM Agent 拿到上百行整文件后还要自己定位方法,token 开销大。本工具按"方法"为单位返回源码,是程序分析的最小颗粒上下文。

输入参数

输出结构

{
  "method_full_name": "com.example.UserController.getUser",
  "method_signature": "getUser(HttpServletRequest, String): ResponseEntity<User>",
  "file_path": "src/main/java/com/example/UserController.java",
  "start_line": 87,
  "end_line": 105,
  "containing_class": "com.example.UserController",
  "source": "@GetMapping(\"/users/{id}\")\npublic ResponseEntity<User> getUser(HttpServletRequest req, @PathVariable String id) {\n    ...\n}",
  "javadoc": "/** Get a user by id */"
}

重载未消歧时:

{
  "method_full_name": "com.example.UserController.getUser",
  "found": false,
  "ambiguous": true,
  "candidates": [
    "getUser(HttpServletRequest, String): ResponseEntity<User>",
    "getUser(String): User"
  ]
}

验收标准

• 正确返回方法的完整源码,包括嵌套 lambda/匿名类
• 重载方法在不带 parameter_types 时返回 ambiguous + 候选
• 注解、Javadoc 控制开关生效
• 单元测试覆盖:重载、嵌套类方法、构造器、静态初始化块、抽象方法只声明
• 中等仓库响应 < 3s

预估工作量

3-4 人日

Start by locating the existing read_file_by_path implementation and the UAST method-resolution entry points. Add coverage for overloads, nested classes, constructors, static initialization blocks, abstract declarations, nested lambdas or anonymous classes, and Javadoc or annotation switches. Done means the specified response shapes are returned and medium repositories respond within 3 seconds.