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="*"全匹配
强制执行步骤:
- 识别通配符配置:
<action name="*_*" class="{1}Action" method="{2}"> - 反编译该 namespace 下所有 Action 类(排除 getter/setter、ActionSupport 继承方法)
- 输出模式族 + 实例列表:
=== 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 推断!
解析优先级(按顺序执行):
- 读取配置文件 - applicationContext.xml 或其他 Spring 配置
- 提取 address 属性 - 这是 Web Service 路径的唯一真实来源
- 验证 Servlet 映射 - 从 web.xml 获取 /ws/* 或 /services/*
- 组装完整 URL - 上下文路径 + Servlet映射 + address
- 反编译实现类 - 仅用于提取方法签名,不用于推断路径
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 服务
强制执行步骤:
-
从配置文件获取所有 endpoint
<jaxws:endpoint id="userService" implementor="#userServiceImpl" address="/UserService"/> -
反编译每个 Service 实现类
-
提取所有 public 方法 - 方法名、参数列表、返回类型
-
为每个方法记录完整的方法签名和参数列表
-
记录配置来源 - 配置文件路径、行号、address 属性值、implementor 类名
2.3 Axis/Axis2 服务
强制执行步骤:
-
读取 server-config.wsdd 或 services.xml
<service name="UserService" provider="java:RPC"> <parameter name="className" value="com.example.UserService"/> </service> -
提取服务名和实现类
-
反编译实现类获取方法列表
-
URL 组成:
/axis/services/{serviceName}
2.4 executeInterface 类型服务特殊处理
对于使用 interfaceId 参数路由的通用执行接口:
- 反编译实现类,查找所有 interfaceId 定义
- 为每个 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 验证不通过时的处理流程
- 停止当前输出
- 识别缺失的内容类型
- 执行反编译获取完整信息
- 补充缺失的接口和参数信息
- 重新执行验证