跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
安全

java-route-mapper

Java Web 源码路由与参数映射分析工具。从源码中提取**所有** HTTP 路由和参数结构,并自动保存为 MD 文档。适用于:(1) 无 API 文档的项目完整接口梳理,(2) 下游漏洞审计 Skill 的路由数据源,(3) 源码端点完整分析。支持 Spring MVC、Servlet、JAX-RS、Struts 2、CXF Web Services 等框架。**必须输出所有接口,不省略任何内容,包括 Web Service 的完整 SOAP 方法**。

Dest1ny-Sec · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Dest1ny-Sec/Des-java-auto-skill --skill java-route-mapper

技能说明


name: java-route-mapper description: Java Web 源码路由与参数映射分析工具。从源码中提取所有 HTTP 路由和参数结构,并自动保存为 MD 文档。适用于:(1) 无 API 文档的项目完整接口梳理,(2) 下游漏洞审计 Skill 的路由数据源,(3) 源码端点完整分析。支持 Spring MVC、Servlet、JAX-RS、Struts 2、CXF Web Services 等框架。必须输出所有接口,不省略任何内容,包括 Web Service 的完整 SOAP 方法。

Java Source Route & Parameter Mapper

从 Java Web 项目源码中提取所有 HTTP 路由与请求参数结构,为下游漏洞审计 Skill 提供完整的路由数据。不进行安全漏洞评估、代码质量分析或任何路由提取范围之外的内容输出。

⚠️ 核心要求:完整输出

此技能必须输出所有发现的接口,不允许省略。

  • ✅ 每个接口都要有完整的参数分析
  • ✅ 输出接口总数和清单供核对
  • ❌ 禁止使用"..."、"等"、"其他"省略
  • ❌ 禁止只输出"关键接口"或"重要接口"
  • ❌ 禁止因为数量大而省略

⚠️ CRITICAL 规则汇总(强制执行)

以下规则为强制性要求,违反任何一条都会导致输出不合格。


CRITICAL 1: 通配符/动态路由强制展开(模式族 + URL 列表)

核心策略:通配符路由必须全部识别,但不重复完整模板。每个 namespace 的通配符配置只写一次模式族头部(含 HTTP 方法、Content-Type、参数结构来源),下方只列出 URL → 入口方法签名 的映射列表。下游 agent 需要参数结构时通过反编译自取。

不允许:每个展开后的 URL 都重复完整模板(HTTP方法、Content-Type、参数结构等)—— 这会造成数十倍的 token 浪费且无信息增益。

1.1 Struts2 通配符路由

适用场景(struts.xml 中存在):

  • name="*_*" 双通配 / name="user_*" 单通配 / name="*" 全匹配

强制执行步骤:

  1. 识别通配符配置:
    <action name="*_*" class="{1}Action" method="{2}">
    
  2. 反编译该 namespace 下所有 Action 类(排除 getter/setter、ActionSupport 继承方法)
  3. 输出模式族 + 实例列表:
    === Pattern: {action}_{method}.action (namespace: /admin) ===
    入口模板: {ActionClass}.{methodName}()
    HTTP 方法: POST
    Content-Type: application/x-www-form-urlencoded
    参数来源: 各 Action 类的字段(下游 agent-5 反编译时提取)
    
    展开实例(共 {N} 个):
    - /admin/user_login.action → UserAction.login()
    - /admin/user_logout.action → UserAction.logout()
    - /admin/user_register.action → UserAction.register()
    - ... [逐行列出全部 N 个,禁止省略,禁止用 "..." / "等" / "其余"]
    

1.2 Spring MVC 路径变量

路径变量({id}、/**)不属于通配符展开——同一 controller 方法处理全部路径变量值,无需展开实例。直接按普通路由格式输出,参数结构中标注 Path: {id}:Long。

1.3 JAX-RS 路径参数

同 1.2,路径参数(@PathParam)按普通路由格式输出,不展开实例。

1.4 Servlet URL Pattern 通配符

适用场景:/api/*、*.do 等。若 Servlet 使用 request.getPathInfo() 内部分发到不同方法,必须按模式族 + 实例列表输出(参考 1.1 格式);否则按普通路由处理。


CRITICAL 2: Web Service 方法完整输出规则

2.1 配置文件优先原则

Web Service 的 URL 路径必须从配置文件中读取,绝对不能根据类名或 endpoint id 推断!

解析优先级(按顺序执行):

  1. 读取配置文件 - applicationContext.xml 或其他 Spring 配置
  2. 提取 address 属性 - 这是 Web Service 路径的唯一真实来源
  3. 验证 Servlet 映射 - 从 web.xml 获取 /ws/* 或 /services/*
  4. 组装完整 URL - 上下文路径 + Servlet映射 + address
  5. 反编译实现类 - 仅用于提取方法签名,不用于推断路径

URL 组成公式:

完整URL = 上下文路径 + web.xml中的Servlet映射 + address属性值

示例: /myapp + /services/ + /UserApi = /myapp/services/UserApi

错误示例(必须避免):

  • ❌ 根据类名推断: UserServiceImpl → /UserService
  • ❌ 根据 id 推断: userWebService → /userWebService
  • ✅ 读取配置: address="/UserApi" → /myapp/services/UserApi

2.2 CXF/JAX-WS 服务

强制执行步骤:

  1. 从配置文件获取所有 endpoint

    <jaxws:endpoint id="userService"
                    implementor="#userServiceImpl"
                    address="/UserService"/>
    
  2. 反编译每个 Service 实现类

  3. 提取所有 public 方法 - 方法名、参数列表、返回类型

  4. 为每个方法记录完整的方法签名和参数列表

  5. 记录配置来源 - 配置文件路径、行号、address 属性值、implementor 类名

2.3 Axis/Axis2 服务

强制执行步骤:

  1. 读取 server-config.wsdd 或 services.xml

    <service name="UserService" provider="java:RPC">
      <parameter name="className" value="com.example.UserService"/>
    </service>
    
  2. 提取服务名和实现类

  3. 反编译实现类获取方法列表

  4. URL 组成: /axis/services/{serviceName}

2.4 executeInterface 类型服务特殊处理

对于使用 interfaceId 参数路由的通用执行接口:

  1. 反编译实现类,查找所有 interfaceId 定义
  2. 为每个 interfaceId 记录独立的参数结构

CRITICAL 3: 禁止的输出格式

以下输出格式绝对禁止使用:

禁止模式错误示例正确做法
使用"等"省略LoginAction, UserAction等列出全部 Action
使用"..."省略method1, method2, ...列出全部方法
使用"其他"省略以及其他20个方法列出全部20个方法
使用"更多"省略更多接口请查看源码直接列出所有接口
使用占位符{action}_{method}.action展开为实际 URL
使用范围表示001 ~ 050逐个列出 001, 002, ..., 050
描述替代列表方法列表: 用户管理相关列出具体方法名
只给 WSDL 地址请通过 WSDL 查看可用方法列出所有 SOAP 方法
只列类名不列方法UserAction 支持多个方法列出每个方法的完整模板

CRITICAL 4: 各框架必须的输出格式

4.1 Struts2 路由

=== [1] login_login.action ===
URL: `/admin/login_login.action`
方法: LoginAction.login()
HTTP 方法: POST
Content-Type: application/x-www-form-urlencoded

参数结构:
  Body: loginName (String), password (String)

4.2 Spring MVC 路由

=== [1] GET /api/users/{id} ===
位置: UserController.getUser (UserController.java:45)
HTTP 方法: GET
URL 路径: /api/users/{id}

参数结构:
  Path: {id} (Long) - 用户ID
  Header: Authorization - Bearer Token

4.3 JAX-RS 路由

=== [1] GET /rest/users/{userId} ===
位置: UserResource.getUser (UserResource.java:32)
HTTP 方法: GET
URL 路径: /rest/users/{userId}

参数结构:
  Path: {userId} (Long)
  Query: includeOrders (boolean, 可选)

4.4 Servlet 路由

=== [1] POST /api/upload ===
位置: UploadServlet.doPost (UploadServlet.java:28)
HTTP 方法: POST
URL 路径: /api/upload

参数结构:
  Body: multipart/form-data
    - file (File) - 上传文件
    - description (String) - 文件描述

4.5 Web Service (SOAP) 方法

### UserService (共 5 个方法)

- **配置文件**: applicationContext.xml:42
- **address 属性**: /UserApi
- **完整 URL**: /myapp/services/UserApi

=== [WS-1] login ===
方法签名: login(String loginName, String password)
返回类型: String

参数结构:
  Body: SOAP XML
    - loginName (String) - 登录名
    - password (String) - 密码

CRITICAL 5: 输出前强制验证

此验证必须通过才能写入文件,验证不通过时必须返回补充内容。

5.1 数量一致性检查

检查项计算公式通过条件
Struts2 路由实际接口数 ÷ Action类数≥ 3
Spring MVC 接口实际接口数 ÷ Controller类数≥ 2
JAX-RS 接口实际接口数 ÷ Resource类数≥ 2
Servlet 接口实际接口数 ÷ Servlet类数≥ 1
Web Service 方法实际接口数 ÷ 反编译获得的方法数= 100%

5.2 省略词检测

扫描输出内容,检测到任何省略标志时必须替换为完整内容。

5.3 文件完整性检查

  • 主索引中每个模块都有对应的详情文件
  • 每个详情文件都包含完整的路由和参数信息(不是摘要)
  • Web Service 索引中的每个服务都有完整的方法列表
  • 没有"详见xxx"但 xxx 文件不存在的情况

5.4 验证不通过时的处理流程

  1. 停止当前输出
  2. 识别缺失的内容类型
  3. 执行反编译获取完整信息
  4. 补充缺失的接口和参数信息
  5. 重新执行验证
阅读完整来源 ↗