发帖
雷达卡
1. 项目 GitHub 地址
https://github.com/Adrninistrator/java-all-call-graph
2. 使用案例展示
以下内容整理自通过微信公众号、搜索引擎等公开渠道获取的技术文章，其中明确提到了对 java-all-call-graph 或 java-callgraph2 的实际应用。若作者不希望相关信息被列出，可联系进行移除。
2.1 vivo 千镜 —— 调用图构建及其在代码安全扫描中的实践
链接：https://mp.weixin.qq.com/s/pNhYzGoeCqp_zkOcNf0xgg
使用工具：java-all-call-graph、java-callgraph2
2.2 自如技术团队 —— 探索代码瘦身的设计理念与实现细节
链接：https://mp.weixin.qq.com/s/ovzhSasR6QL7L5vlFILDgw
使用工具：java-callgraph2
2.3 携程技术 —— 实现精准测试和应用瘦身的代码分析平台揭秘
链接：https://mp.weixin.qq.com/s/p9BcfNqLk2ZDUNcXukqXpg
使用工具：java-callgraph2
3. 项目核心功能概述
3.1 总体目标定位
本项目致力于利用 Java 技术对 Java 应用进行自动化静态分析，将原本非结构化的代码信息转化为结构化数据，并存储至关系型数据库中，为开发、测试、安全审计等多个环节提供可靠的数据支持。
3.2 支持 SQL 查询的静态代码分析能力
系统可对编译后的 Java 字节码执行静态解析，提取关键元素并写入数据库表，用户可通过标准 SQL 进行灵活查询。
支持识别的数据类型包括但不限于：
- 类、方法、字段
- 注解、泛型定义
- 方法调用关系
- 枚举类型
同时兼容部分主流框架的信息提取，例如：
- MyBatis 映射操作
- Spring AOP 切面逻辑
- Spring Bean 管理
- Controller 接口映射
- Scheduled Task 定时任务
具体使用方式详见文档：
对 Java 代码静态分析并支持 SQL 查询
3.3 方法完整调用链生成
支持从指定入口方法出发，向上追溯调用者或向下追踪被调用者，生成完整的正向或反向调用路径。
详细说明及使用方法见：
静态分析生成 Java 代码方法完整调用链
3.4 方法调用堆栈路径生成
在生成完整调用链的基础上，进一步筛选出从起始方法到包含特定关键字方法之间的调用路径，模拟运行时堆栈行为，便于问题排查与流程理解。
详细说明及使用方法见：
静态分析生成 Java 代码方法调用堆栈
3.5 从调用堆栈文件中提取关键信息
系统可在生成调用堆栈的同时，附加展示具有业务意义的上下文信息，如：
- 方法调用中传入的常量值
- 参数的具体类型
- 泛型参数或返回值的实际类型
- MyBatis 操作涉及的数据库表名
并支持基于这些信息从堆栈文件中提取关注点。
详细说明及使用方法见：
从方法调用堆栈文件提取关注的信息
3.6 解析 MyBatis 数据库表操作（MySQL 兼容）
当分析调用链或调用堆栈时，能够自动识别 MyBatis Mapper 方法所操作的 MySQL 数据库表名称，并将其作为上下文信息一并呈现。
3.7 JarDiff：对比 JAR 包版本差异与影响范围分析
支持对不同版本的 JAR 文件进行比对，识别出发生变更的方法集合，并基于此生成向上/向下的完整调用链，从而评估代码修改的影响边界。
此外，还可根据 MyBatis Mapper XML 中 SQL 语句的变化，定位到关联的 Mapper 方法，进而构建调用路径，辅助评估变更影响。
详细说明及使用方法见：
JarDiff 比较 jar 文件版本差异及代码影响范围
3.8 JDK 与依赖库兼容性问题检测
针对 Java 应用在升级 JDK 版本或第三方依赖库后可能出现的类、方法、字段缺失等问题，提供扫描机制以提前发现潜在的运行时异常风险。同时也支持检查命名高度相似但可能引发混淆的类。
详细说明及使用方法见：
Java 应用 JDK 及依赖库兼容问题扫描工具
3.9 获取方法调用时的参数类型与常量值
能够在静态分析过程中，提取方法调用时传递的对象实例或参数所使用的具体常量值，以及参数的类型信息，增强调用上下文的理解能力。
详细说明及使用方法见：
静态分析获取 Java 代码方法调用参数类型或值
3.10 字符串拼接逻辑解析
支持对由字符串常量、枚举常量、方法返回值等参与的字符串拼接表达式进行拆解，还原拼接前的各项输入内容，并推断最终拼接结果。
详细说明及使用方法见：
静态分析解析 Java 代码字符串拼接
建议先在 GitHub 上提交 issue 再展开讨论，以便更好地整理相关议题内容。后续具有参考价值且不重复的讨论内容将被汇总至正式文档中。
5. 利用大模型对项目进行问答分析
5.1 DeepWiki
支持无需注册即可提问，但系统不会自动检索项目的最新代码内容。
网址：
https://deepwiki.com/Adrninistrator/java-all-call-graph
该平台通过大模型对项目源码进行深度解析，用户可就项目相关问题进行咨询，包括但不限于功能使用方式、调用逻辑等。
5.2 zread.ai
使用前需完成注册流程。
网址：
https://zread.ai/Adrninistrator/java-all-call-graph
功能与 DeepWiki 类似，均基于大模型实现对项目代码的理解与问答支持。
6. 核心概念定义
6.1 方法调用关系
指一个方法（调用方）对另一个方法（被调方）的调用行为，包含以下信息：调用方法和被调方法的包名、类名、方法名、参数类型、返回值类型以及调用类型（如静态调用或实例调用）。
示例：
a.b.c.Caller:f1() 调用 a.b.c.Callee:f2(int, java.lang.String)
此类关系可视为由调用方法与被调方法构成的二元组，对应存储于数据库中的 method_call 表中。
6.2 方法调用信息
描述在方法调用过程中涉及的具体上下文数据，例如：被调用对象或参数所使用的常量值、变量类型、变量对应的方法参数索引、其他方法调用的返回结果、类成员变量等。
这些信息写入数据库的 method_call_info 表。
6.3 所有方法的调用图
针对某一 Java 项目，其全部方法之间形成的调用网络构成一个高度复杂的图结构。下图展示了一个简化的调用图示例：
6.4 方法完整调用链
从某个指定方法出发，向下延伸至所有直接或间接被其调用的方法，直到末端无进一步调用的方法为止，称为“向下完整调用链”；反之，从该方法向上追溯所有可能调用它的方法路径，直至没有上级调用者的方法，称为“向上完整调用链”。
完整调用链呈现树状结构，例如：
com.example.Main:main(String[]) ├─ com.example.service.UserService:getUserById(Long) │ ├─ com.example.repository.UserRepository:findById(Long) │ │ ├─ com.example.mapper.UserMapper:toEntity(ResultSet) │ │ └─ com.example.validator.IdValidator:validate(Long) │ └─ com.example.cache.UserCache:get(String) └─ com.example.util.Logger:info(String)
如下图所示：
无论是向上还是向下的完整调用链，均可视为整个项目调用图中的一个子图（虽以树形呈现，但由于可能存在循环调用，实际为图结构）。
6.5 方法调用堆栈
在方法完整调用链的基础上，提取从起始方法到某一特定调用/被调方法之间的具体执行路径，即为方法调用堆栈。
调用堆栈为线性链表结构，例如：
com.example.Main:main(String[]) └─ com.example.service.UserService:getUserById(Long) └─ com.example.repository.UserRepository:findById(Long) └─ com.example.mapper.UserMapper:toEntity(ResultSet) com.example.Main:main(String[]) └─ com.example.util.Logger:info(String)
如下图中红色路径所示：
可以理解为，方法调用堆栈是完整调用链中的一条具体路径分支。
7. 项目依赖关系说明
各组件之间的依赖结构如下：
- java-all-call-graph 依赖 java-callgraph2，用于对 Java 源码或字节码进行静态分析；
- java-callgraph2 依赖 bcel，用于解析 Java 字节码信息；
- java-all-call-graph 依赖 druid，作为数据源管理工具；
- java-all-call-graph 依赖 mybatis-mysql-table-parser，用于解析 MyBatis XML 文件中的 MySQL SQL 语句；
- mybatis-mysql-table-parser 依赖 druid，用于 SQL 语句的语法解析；
- mybatis-mysql-table-parser 依赖 jdom2，用于 XML 文件的读取与解析；
- java-all-call-graph 依赖 java-text-to-excel，用于将文本格式的内容转换生成 Excel 文件。
本项目基于 java-text-to-excel 工具，并依赖 fastexcel 实现 Excel 文件的生成功能。
8. 核心处理流程
8.1 代码解析与数据库写入
该阶段主要完成对 Java 字节码文件（如 JAR 包）的静态分析，并将分析结果持久化至数据库中。具体步骤如下：
- 通过
java-all-call-graph模块中的RunnerWriteDb类调用java-callgraph2库进行底层操作； java-callgraph2负责读取待分析的 JAR 等二进制文件，执行静态代码分析，输出中间结果到文本文件；- 随后，
RunnerWriteDb类读取上述生成的文本数据，并将其结构化地写入数据库。
关于 RunnerWriteDb 的详细使用说明，请参见“当前项目能够做什么”章节中“对代码静态分析并支持 SQL 查询”的相关内容。
当前项目在执行时，首先需要解析代码并写入数据库当被解析的代码发生变化时，需要重新执行当前步骤，使数据库中写入最新代码对应的数据8.2 数据读取与结果生成
在完成数据入库后，系统进入第二阶段：从数据库提取所需信息，并按需生成各类分析报告或数据文件。
java-all-call-graph中的不同类负责从数据库查询相关信息；- 根据业务需求，可生成包括完整方法调用链、方法调用堆栈等在内的多种输出文件。
9. 使用指南
9.1 运行环境要求
- 需使用 JDK 8 或更高版本；
- 若计划通过 IDE 打开并运行项目源码，建议配置 Gradle 构建工具以管理依赖项。
9.2 参数配置机制
9.2.1 配置方式支持情况
项目支持两种参数设定途径：通过外部配置文件定义，或直接在代码中编程式指定。两种方式效果一致，且所有配置项均在代码中有明确映射。
通过配置文件指定
通过代码指定9.2.2 配置参数格式类型
9.2.2.1 Map 格式 — 键值对参数
适用于单值配置项，分为两类：
- 与数据库无关的通用配置；
- 涉及数据库连接或操作的相关参数。
每项配置由枚举常量表示，对应唯一的键值对，且每个参数仅允许设置一个确定值。
com.adrninistrator.jacg.conf.enums.ConfigKeyEnum
com.adrninistrator.jacg.conf.enums.ConfigDbKeyEnum_jacg_config/config.properties
_jacg_config/config_db.properties9.2.2.2 List 格式 — 有序列表参数
用于需要保持顺序的多值参数。对应的枚举类为：
com.adrninistrator.jacg.conf.enums.OtherConfigFileUseListEnum
每个枚举实例代表一个参数，关联一个独立的配置文件，其值可包含多个条目，并严格保留输入顺序。
9.2.2.3 Set 格式 — 无序集合参数
适用于不关心顺序的多值参数。对应枚举类为：
com.adrninistrator.jacg.conf.enums.OtherConfigFileUseSetEnum
每个枚举常量标识一个参数，对应一个配置文件，允许设置多个值，但不保证顺序。
9.2.2.4 EL 表达式参数
用于动态逻辑判断的表达式配置。对应枚举类为：
com.adrninistrator.jacg.el.enums.ElConfigEnum
每个参数值为一条完整的 EL 表达式字符串，用于条件计算或规则匹配。
9.2.3 配置参数示例参考
详见“配置参数示例”文档部分。
9.2.4 EL 表达式通用使用说明
详情请查阅“EL 表达式使用通用说明文档”。
9.2.5 EL 表达式中字符串比较说明
具体规则见“EL 表达式字符串比较说明文档”。
9.2.6 通过代码设置配置参数
可通过 com.adrninistrator.jacg.conf.ConfigureWrapper 类在程序中动态设置各类参数。常用方法如下：
| 方法名称 | 功能描述 |
|---|---|
| setMainConfig | 设置键值对形式的主配置参数（Map 格式） |
| setOtherConfigList | 设置有序的多值参数（List 格式） |
| setOtherConfigSet | 设置无序的多值参数（Set 格式） |
| setElConfigText | 设置 EL 表达式内容 |
9.3 运行模式说明
9.3.1 支持的运行方式概览
通过 IDE 打开项目源码运行
在其他项目中引用当前项目的库运行
使用项目源码构建后运行9.3.2 不同运行方式下的参数配置支持
| 运行方式 | 支持的参数配置方式 |
|---|---|
| 通过 IDE 打开项目源码运行 | 支持通过配置文件指定、也支持通过代码指定 |
| 在其他项目中引用当前项目的库运行 | 支持通过配置文件指定、也支持通过代码指定 |
| 使用项目源码构建后运行 | 仅支持通过配置文件指定 |
9.3.3 在 IDE 中打开并运行项目
9.3.3.1 使用配置文件传参
若选择通过配置文件设定参数，可修改项目中相关配置文件内容，然后运行对应场景的入口类。这些入口类位于 test 模块下的 test.jacg 包内。
注意：应将运行模块设为 test，以便使 test 模块中的 log4j2 配置生效。
9.3.3.2 使用代码传参
若希望在代码中直接指定参数，可直接调用各使用场景提供的示例方法，或以其为基础进行自定义修改。
9.3.4 在其他项目中作为依赖库引入运行
可在第三方项目中使用 Maven 或 Gradle 引入本项目作为依赖库。
Maven 依赖配置示例如下：
<dependency> <groupId>com.github.adrninistrator</groupId>
使用 Gradle 进行依赖管理时，可参考以下配置：
<artifactId>java-all-call-graph</artifactId> <version>版本号</version> <type>pom</type>
implementation("com.github.adrninistrator:java-all-call-graph: 版本号")最新版本信息可通过以下链接查看：
https://mvnrepository.com/artifact/com.github.adrninistrator/java-all-call-graph
本工具仅引入了 slf4j-api 组件，在引入本工具组件的项目中，还需要引入 log4j2、logback 等日志组件，且保证配置正确，能够在本地正常运行由于 Maven 间接依赖的组件版本不会自动使用最大的版本号，因此可能需要在项目中手工指定 java-all-call-graph 依赖组件的版本号，避免因为依赖组件版本不一致导致问题，可通过 java-all-call-graph 与 java-callgraph2 的 pom 文件的 dependencies 元素查看依赖组件版本9.3.4.1 通过配置文件设置参数并运行
运行 java-all-call-graph 库中提供的类 com.adrninistrator.jacg.unzip.UnzipFile，执行时请选择当前项目中引入该库的模块。
此步骤仅需执行一次即可完成初始化。
但假如 java-all-call-graph 升级后，若对配置文件有新增或修改，则需要再执行当前步骤，否则可能会因为缺少配置文件导致执行失败该类的作用是将 java-all-call-graph 项目的入口类和相关配置文件，以及 java-callgraph2 项目的配置文件解压释放到指定目录。
释放根目录的选择遵循以下优先级顺序：
- src/test：当该目录存在时，作为首选路径；
- src/unit.test：若 src/test 不存在而 src/unit.test 存在，则使用此目录；
- _jacg-{时间戳}：当前两者均不存在时，自动创建以 _jacg- 开头并附加时间戳的目录作为根路径。
java-all-call-graph 的入口类会被写入释放根目录下的 java/test/jacg 路径中，其配置文件则保存至根目录下的 resources/ 目录，子目录名称为：
_el_example或以以下形式命名的子目录：
_jacg_而 java-callgraph2 项目的配置文件同样存放在 resources/ 目录下，子目录名为：
_el_example或以如下前缀开头的目录：
_javacg2_完成配置文件的参数修改后，即可运行相应的入口类来启动程序。
9.3.4.2 通过代码方式设定参数运行
此方式的操作说明与“通过 IDE 打开项目源码运行”部分一致，可参照相同流程进行处理。
9.3.5 使用项目源码构建后再运行
9.3.5.1 构建方法
进入项目根目录，并执行如下命令进行构建：
gradlew gen_run_jar9.3.5.2 构建输出内容
构建成功后，将在项目根目录生成名为 jar_output_dir 的文件夹，其中包含以下子目录与文件：
| 目录/文件名 | 用途说明 |
|---|---|
| _el_example | 存放表达式相关的示例及说明文档 |
| _javacg2_xxx | 用于保存当前项目所使用的配置文件 |
| config | log4j2 日志框架的配置文件存储位置 |
| jar | 存放项目编译后生成的 jar 文件 |
| lib | 项目依赖的第三方库 jar 文件所在目录 |
| log | 日志文件存储目录，运行后会自动生成日志内容 |
| xxx.bat | 适用于不同场景的 Windows 执行脚本 |
| xxx.sh | 适用于不同场景的 Linux/Unix 执行脚本 |
9.3.5.3 通过配置文件设定参数运行
在完成对配置文件中的各项参数调整后，可通过执行对应的 xxx.bat（Windows）或 xxx.sh（Linux/Unix）脚本来调用指定的入口类，从而启动应用。
9.3.6 通过代码调用的其他使用示例
更多关于通过编码方式调用的使用案例，请参见：
通过代码执行的其他示例
10. 更新日志
更新说明
京公网安备 11010802022788号
