支持使用本地文件形式的H2数据库，可不依赖外部的其他数据库，可在无法连接其他数据库（如MySQL）的环境中运行
H2数据库使用说明可参考https://blog.csdn.net/a82514921/article/details/108029222
本工具生成的H2数据库中，schema为“jacg”
除了支持对jar/war包进行处理外，也支持对目录中的class、jar/war文件进行处理
支持指定一个或多个jar/war包，或一个或多个目录，或jar/war包与目录混合进行处理
该功能在java-callgraph2中实现，通过本工具的config.properties配置文件中的call.graph.jar.list参数进行配置
可参考https://github.com/Adrninistrator/java-callgraph2
提供用于生成Java方法UML时序图的插件功能
| 增加或修改文件 | 文件路径 | 文件作用 |
|---|---|---|
| 增加 | resources/_jacg_extensions/method_annotation_handler.properties | 定义用于对方法上的注解进行处理的类完整类名 |
| 增加 | resources/_jacg_sql/class_annotation.sql | 用于保存类上的注解信息数据库表 |
| 修改 | resources/_jacg_sql/method_annotation.sql | 增加了保存注解属性的字段 |
在method_annotation_handler.properties配置文件中，可以定义用于对方法上的注解进行处理的类完整类名，该文件每行指定一项配置，可指定多行
对方法上的注解进行处理的类需要继承自com.adrninistrator.jacg.extensions.annotation_handler.AbstractAnnotationHandler，并实现以下方法
| 方法名 | 方法作用 |
|---|---|
| checkHandleAnnotation | 判断当前类是否处理对应的注解 |
| handleAnnotation | 返回方法上的注解处理后的结果 |
本工具在生成方法完整调用链时，会先遍历method_annotation_handler.properties配置文件中指定所有的AbstractAnnotationHandler子类，即对方法上的注解进行处理的类，调用checkHandleAnnotation判断当前类是否会处理的注解，若是则调用handleAnnotation方法获取处理后的注解信息。
最后会调用默认的方法注解处理类com.adrninistrator.jacg.extensions.annotation_handler.DefaultAnnotationHandler进行处理，该类会处理所有的注解，生成的注解信息格式为“@注解类名”，例如“@org.aspectj.lang.annotation.Around”
假如一个方法上存在多个注解，则每个注解的信息会按照注解类名升序排序后，依次拼接在方法信息后
DefaultAnnotationHandler类不需要在method_annotation_handler.properties配置文件中指定
本工具提供了获取Spring MVC的@RequestMapping等注解中的路径信息的处理类，为com.adrninistrator.jacg.extensions.annotation_handler.SpringMvcRequestMappingHandler，该类已在method_annotation_handler.properties配置文件中指定
SpringMvcRequestMappingHandler类会获取类及方法上的@RequestMapping注解（或包含了该注解的其他注解）的路径信息，生成的注解信息格式为“@注解类名("/类注解中的path/方法注解中的path")”
@Controller
@RequestMapping("test")
public class TestController {
@RequestMapping(value = "test1", method = RequestMethod.POST)
public void test1() {
logger.info("");
}
}例如存在以上方法，则在生成的向上方法完整调用链中，TestController.test1()方法及相关的注解信息输出内容如下：
[0]#org.slf4j.Logger:info
[1]# com.test.controller.TestController:[email protected]("/test/test1") (TestController:57) !entry!
@RestController
@RequestMapping("testrest2")
public class TestRest2Controller {
@PostMapping(value = "post")
@TestAttributeAnnotation
public String post(HttpServletRequest httpRequest, @RequestBody final String req) {
logger.info("");
}
}例如存在以上方法，则在生成的向上方法完整调用链中，TestRest2Controller.post()方法及相关的注解信息输出内容如下：
[0]#org.slf4j.Logger:info
[1]# com.test.controller.TestRest2Controller:[email protected]@org.springframework.web.bind.annotation.PostMapping("/testrest2/post") (TestRest2Controller:42) !entry!
支持通过Java代码对参数配置进行设置，可覆盖配置文件中的参数（或仅使用Java代码中设置的参数，不使用配置文件中的参数）
可通过以下类的方法对参数配置进行设置
com.adrninistrator.jacg.conf.ConfigureWrapper在执行释放到项目中的test.jacg包中的入口类（如TestRunnerWriteDb），或执行jar包中com.adrninistrator.jacg.runner包中的入口类（如RunnerWriteDb）之前，需要先调用ConfigureWrapper类的方法设置参数配置
以下可参考test.run_by_code包中的测试代码，在TestRunByCodeBase类中调用了ConfigureWrapper类的方法
ConfigureWrapper.addConfig(ConfigKeyEnum configKeyEnum, String value);对于app.name参数，在以上方法中会将参数值中的-替换为_
ConfigKeyEnum枚举类中定义了_jacg_config/config.properties配置文件中的参数key
通过value参数指定需要设置的参数值
示例如下：
ConfigureWrapper.addConfig(ConfigKeyEnum.CKE_APPNAME, "test_rbc");ConfigureWrapper.addOtherConfigSet(OtherConfigFileUseSetEnum otherConfigFileUseSetEnum, Set<String> configSet);OtherConfigFileUseSetEnum枚举类中定义了_jacg_config目录中其他配置文件的文件名，以及_jacg_extensions目录中的配置文件名
通过configSet参数指定需要设置的Set类型的参数值
示例如下：
ConfigureWrapper.addOtherConfigSet(OtherConfigFileUseSetEnum.OCFUSE_IN_ALLOWED_CLASS_PREFIX, new HashSet<>(Arrays.asList(
"test.call_graph.method_call",
"test.call_graph.argument",
"java.")));ConfigureWrapper.addOtherConfigList(OtherConfigFileUseListEnum otherConfigFileUseListEnum, List<String> configList);OtherConfigFileUseListEnum枚举类中定义了_jacg_find_keyword目录中配置文件的文件名
通过configList参数指定需要设置的List类型的参数值
示例如下：
ConfigureWrapper.addOtherConfigList(OtherConfigFileUseListEnum.OCFULE_FIND_KEYWORD_4CALLEE, Arrays.asList("!entry!", "<init>"));- 支持人工添加缺失的方法调用关系（定制化代码开发）
请查看extensions.md，搜索“人工添加缺失的方法调用关系（定制化代码开发）”
| 文件路径 | 文件作用 |
|---|---|
| resources/_jacg_sql/method_line_number.sql | 方法代码行号信息表 |
在_jacg_config/o_g4callee_class_name.properties配置文件中，支持指定类名+方法名前缀，代表需要处理指定类的对应方法
格式如下：
[类名]:[方法名]
[类名]:[方法名+参数]
示例如下：
Test1:test
Test1:test(
Test1:test(java.lang.String)
配置文件_jacg_config/config.properties中的参数gen.upwards.methods.file不再使用
在_jacg_config/o_g4callee_class_name.properties配置文件中，支持指定类名+代码行号，代表需要处理指定类的对应方法
格式如下：
[类名]:[代码行号]
[代码行号]可指定某个方法对应的任意代码行号，如C:f1()方法代码起止行号范围为[100,203]，则可指定以上范围的任意数字代表需要处理C:f1()方法
示例如下：
Test1:234
在_jacg_config/o_g4caller_entry_method.properties配置文件中，支持指定类名+代码行号，代表需要处理指定类的对应方法
说明同上
每次生成方法调用链后，会在本次生成的目录中创建_mapping.txt文件，在该文件中记录了配置文件中的任务信息与结果文件的映射关系
该文件内容包含两列，以“\t”进行分隔，第1列为配置文件中指定的任务信息，第2列为生成结果文件路径，内容如下所示：
# 配置文件中指定的任务信息 生成结果文件路径
DbOperator:batchInsert( _jacg_o_ee\20220505-211209.427\methods\DbOperator@batchInsert@PVuwu2XS1Fvxj_FQA1Ekog#056.txt
DbOperator:getInstance( _jacg_o_ee\20220505-211209.427\methods\DbOperator@getInstance@Fg85cQ0J0brkEXpMPCoHUA#037.txt
DbOperator:268 _jacg_o_ee\20220505-211209.427\methods\DbOperator@batchInsert@PVuwu2XS1Fvxj_FQA1Ekog#056.txt
DbOperator:close(java.sql.Connection,java.sql.PreparedStatement) _jacg_o_ee\20220505-211209.427\methods\DbOperator@close@9e5dsbPVD8648nV8on9Efw#05f.txt
RunnerGenAllGraph4Callee:101 101-101 _jacg_o_er\20220505-211230.131\RunnerGenAllGraph4Callee@doOperate@HommTjLUWABHR5l7RkDZkQ#[email protected]
RunnerGenAllGraph4Callee:doOperate _jacg_o_er\20220505-211230.131\RunnerGenAllGraph4Callee@doOperate@HommTjLUWABHR5l7RkDZkQ#043.txt
以上文件仅包含成功生成了调用链的任务及结果文件信息
假如在生成向上方法调用链时，在配置文件中指定了生成某个类的全部方法的调用链，也不会出现在以上文件中
生成向下方法完整调用链的配置文件_jacg_config/o_g4caller_entry_method.properties中，支持指定类名，代表需要处理对应类的所有方法
修复处理类或方法上注解信息时的bug
- 支持指定生成向下的调用链时是否忽略出现多次的被调用方法
该参数在以前的版本（0.6.0）已添加，但未进行说明
在配置文件_jacg_config/o_g4caller_entry_method.properties中增加了参数ignore.dup.callee.in.one.caller
生成向下的调用链时，在一个调用方法中出现多次的被调用方法（包含自定义数据），是否需要忽略，值为true/false
仅当开关为开时会忽略
默认值为关
- 支持不释放配置文件
尝试读取jar包中的配置文件，相关的配置文件可以不释放到项目中，可以通过Java代码对配置参数进行设置（进行二次开发时可能需要使用）。
- 支持指定存在多个实现类时是否当前文件中继续生成调用链
在配置文件_jacg_config/o_g4caller_entry_method.properties中增加了参数multi.impl.gen.in.current.file
生成向下的调用链时，若接口或父类存在多个实现类或子类，对于接口或父类方法调用多个实现类或子类方法的调用关系，是否需要在当前文件中继续生成，值为true/false
当开关为开时，以上调用关系会在当前文件中继续生成
当开关为关时，以上调用关系会在单独的目录中生成，目录名格式为“[接口或父类名]@[方法名]@[完整方法名HASH+长度]”，文件名格式为“[实现类或子类名]@[方法名]@[完整方法名HASH+长度].txt”；原始方法调用链对应的文件中，会记录当前方法调用接口或父类方法的调用关系，使用特殊的标记，格式为“!ext_data!JUMP_MULTI_IMPL@[接口或父类名]@[方法名]@[完整方法名HASH+长度]”
默认值为开
例如TestMulti.test1()方法中调用了Interface1接口的f1()方法，Interface1接口存在实现类ImplClass1、ImplClass2；
当以上开关为开时，Interface1.f1()方法调用ImplClass1.f1()、ImplClass2.f1()方法的调用关系会继续在TestMulti.test1()方法对应文件中生成；
当以上开关为关时，生成文件情况如下
TestMulti.test1()方法对应文件中调用Interface1.f1()方法的信息如下：
[1]# [TestMulti:22] test.call_graph.implement.Interface1:f1 !ext_data!JUMP_MULTI_IMPL@Interface1@f1@ix-_NHnAUilDstHxNyrtxQ#029
生成Interface1.f1()方法对应的目录，目录名为“Interface1@f1@ix-_NHnAUilDstHxNyrtxQ#029”
在以上目录中，分别生成ImplClass1.f1()、ImplClass2.f1()方法对应的保存调用链的文件，文件名为“ImplClass1@f1@28XJlqE5etyRh1WH_e_DLQ#029.txt”、“ImplClass2@f1@FixDUSOINEA0qji9Np3baA#029.txt”
- 支持指定配置文件路径
支持通过JVM参数"input.root.path"指定"_jacg_config"、"_jacg_extensions"、"_jacg_find_keyword"、"_jacg_sql"等配置文件目录所在的路径，参数结尾可不指定目录分隔符"/"或""
例如以上配置文件目录均在"C:/test"目录中，则可在JVM参数中通过以下方式指定
-Dinput.root.path=C:/test
- 支持处理没有被其他类调用的类
在以前的版本中，假如某个类的方法没有被其他类调用，则不支持为其生成向上或向下的方法完整调用链；在当前版本中进行了支持
- 方法循环调用Bug处理
在以前的版本中，生成向上或向下的方法完整调用链时，假如出现方法循环调用，在方法循环调用之后的方法调用可能不会生成出来；在当前版本进行了处理
- 支持指定指定批量写入数据库时每次插入的数量
支持通过JVM参数"db.insert.batch.size"指定批量向数据库写入数据时，每次执行插入操作时的记录数量；可用于查找出现重复的注解信息
- 超长注解属性进行截取
在向数据库注解信息表写入数据时，假如注解属性太长，会进行截止，最多保留3000字符，避免写入数据库失败
- 支持在MySQL中保留多个版本的表
在创建数据库表的sql语句中，将索引名称修改为增加了app.name参数（需要重新释放相关文件到项目中）
假如需要在MySQL中保留多个版本的数据库表，可在每次执行时使用不同的app.name参数，使创建的数据库表名不同，能够保留多个版本的表（以前的版本索引名称使用固定值，在MySQL中不能重复创建）
- 一些内部优化
对二次开发时进行优化与功能增加
- 支持人工向数据库方法调用表增加数据
只支持增加已经存在的类之间的方法调用
需要先禁止数据源自动关闭
- 根据关键字生成到起始方法的调用链优化
根据关键字生成到起始方法的调用链，减少生成文件耗时
- 注解属性处理优化
对类、方法上的注解属性进行处理时，支持全部类型的注解属性，包括数组、注解嵌套等使用方式
- 删除一些类
删除以下不需要使用的类
TestGenSingleCallGraph4ee
TestGenSingleCallGraph4er
GenSingleCallGraph
- 支持提取向上调用链的入口方法信息
支持获取指定方法的向上的调用链，并获取每个调用的对应的入口方法信息
- 修改目录开头的字符
由于字符“~”在Excel中会被显示为-，因此将目录开头的，以及其他配置文件中的字符从“~”修改为“_”
- 一些内部优化
注解处理类、数据库操作类增加方法
- 支持每次执行任务使用独立的配置信息
支持通过Java代码调用时，每次执行任务使用独立的配置信息（ConfigureWrapper类变成非静态方式使用），可支持多个任务并行执行（适用于在Web项目中使用java-all-call-graph的场景）
参数信息在数据库表method_call_info
假如需要使方法完整调用链文件中显示方法调用的参数信息，可修改配置文件_jacg_config/config.properties，指定caller.show.raw.method.call.info参数值为true
在方法完整调用链最后一列（使用"\t"分隔），为方法调用中使用的参数值、被调用对象类型等信息，以!ext_data!method_call_info@开头，为JSON字符串格式，各个key说明如下：
| key | 含义 |
|---|---|
| obj | 被调用对象的信息 |
| args | 参数的信息 |
| t | 可能的类型列表 |
| v | 可能的值列表 |
| sf | 可能的静态字段列表 |
| sfm | 可能的静态字段的方法列表 |
- 代码
public static void test() {
logger.info("test\ra");
System.out.println("test\ra");
System.out.println("test\nb");
System.out.println("test\r\nc");
System.out.println("test\tc");
testBigDecimal(BigDecimal.ONE);
...
}
public static void testBigDecimal(BigDecimal arg) {
System.out.println(arg);
}- 解析结果
[0]#test.call_graph.argument.TestArgument1:test()
[1]# [TestArgument1:18] java.io.PrintStream:println(java.lang.String) !ext_data!method_call_info@{"obj":{"sf":["java.lang.System:out"]},"args":{"0":{"v":["test\ra"]}}}
[1]# [TestArgument1:19] java.io.PrintStream:println(java.lang.String) !ext_data!method_call_info@{"obj":{"sf":["java.lang.System:out"]},"args":{"0":{"v":["test\nb"]}}}
[1]# [TestArgument1:20] java.io.PrintStream:println(java.lang.String) !ext_data!method_call_info@{"obj":{"sf":["java.lang.System:out"]},"args":{"0":{"v":["test\r\nc"]}}}
[1]# [TestArgument1:21] java.io.PrintStream:println(java.lang.String) !ext_data!method_call_info@{"obj":{"sf":["java.lang.System:out"]},"args":{"0":{"v":["test\tc"]}}}
[1]# [TestArgument1:22] test.call_graph.argument.TestArgument1:testBigDecimal(java.math.BigDecimal) !ext_data!method_call_info@{"args":{"0":{"sf":["java.math.BigDecimal:ONE"]}}}
[2]# [TestArgument1:37] java.io.PrintStream:println(java.lang.Object) !ext_data!method_call_info@{"obj":{"sf":["java.lang.System:out"]},"args":{"0":{"t":["java.math.BigDecimal"]}}}- 代码
int i = (int) System.currentTimeMillis() % 10;
String s1 = (i == 7 ? "a" : "b");
String s2 = "aa";
int ii = 1;
if (i == 7) {
s2 = "bb";
}
testString(s1);
testString(s2);- 解析结果
[0]#test.call_graph.argument.TestArgument2:test()
[1]# [TestArgument2:10] java.lang.System:currentTimeMillis()
[1]# [TestArgument2:19] test.call_graph.argument.TestArgument2:testString(java.lang.String) !ext_data!method_call_info@{"args":{"0":{"v":["a","b"]}}}
[1]# [TestArgument2:20] test.call_graph.argument.TestArgument2:testString(java.lang.String) !ext_data!method_call_info@{"args":{"0":{"v":["bb","aa"]}}}- 数据源修改
使用的数据源由c3p0修改为druid
- 新增依赖组件
com.github.adrninistrator:mybatis-mysql-table-parser
删除配置文件o_g4caller_entry_method_ignore_prefix.properties，该文件的作用可以通过其他方式替代，且该文件的存在容易造成误导，因此删除
删除配置文件_jacg_config/config.properties中的参数input.ignore.other.package
默认支持忽略，相关配置文件为空时不忽略
删除配置文件_jacg_config/config.properties中的参数call.graph.jar.list，使用新的配置文件i_jar_dir.properties
删除RunnerGenAllGraph4CallerSupportIgnore相关类，固定支持忽略特定的调用关系
数据库相关配置文件拆分，config_db.properties
删除配置文件_jacg_config/config.properties中的参数show.method.annotation、gen.combined.output、show.caller.line.num
在配置文件``中增加以下参数
| 参数名称 | 参数作用 |
|---|---|
| output.root.path | 生成文件的根目录 |
| db.insert.batch.size | 批量写入数据库时每次插入的数量 |
| check.jar.file.updated | 检查jar包文件是否有更新 |
| caller.show.raw.method.call.info | 生成向下的方法完整调用链时，是否显示原始方法调用信息 |
删除参数PROPERTY_OUTPUT_ROOT_PATH，改到配置文件中 以上参数的说明需要删除
删除参数write.config.in.result
为了使_jacg_config目录的配置文件名更容易理解，对相关配置文件进行改名：
| 修改前 | 修改后 |
|---|---|
| i_allowed_class_prefix.properties | allowed_class_prefix.properties |
| i_jar_dir.properties | jar_dir.properties |
| o_g4callee_class_name.properties | method_class_4callee.properties |
| o_g4caller_entry_method.properties | method_class_4caller.properties |
| o_g4caller_ignore_class_keyword.properties | ignore_class_keyword.properties |
| o_g4caller_ignore_full_method_prefix.properties | ignore_full_method_prefix.properties |
| o_g4caller_ignore_method_prefix.properties | ignore_method_prefix.properties |
ignore_class_keyword.properties、ignore_full_method_prefix.properties、ignore_method_prefix.properties，这三个配置文件，支持在生成向上/向下的方法完整调用链时忽略指定的类或方法（以前的配置文件只支持生成向下的方法完整调用链时忽略）
假如以依赖jar包形式使用java-all-call-graph，可不再执行UnzipFile类释放配置文件到项目中，会使用jar包中配置文件的默认参数值，可通过Java代码对配置参数进行修改
释放java-callgraph2配置文件_javacg_config/config.properties
为了使方法名称更能体现实际作用，将ConfigureWrapper类的以下方法名称进行修改：
| 修改前的方法名称 | 修改后的方法名称 |
|---|---|
| addConfig | setConfig |
| addOtherConfigSet | setOtherConfigSet |
| addOtherConfigList | setOtherConfigList |
不再生成_mapping.txt文件（删除说明）
增加数据库表
长度修改
数据库表加前缀"jacg_"
配置文件_jacg_config/config.properties参数call.graph.output.detail增加0: 最详细 完整类名+方法名+方法参数+返回类型，可以在生成的方法完整调用链结果文件中显示方法的返回类型
配置文件_jacg_business_data_type/business_data_type_show_4ee.properties、_jacg_business_data_type/business_data_type_show_4er.properties增加可以使用的参数method_return_generics_type，指定以上参数时，在生成向上/向下的方法完整调用链结果文件时，显示方法返回类型中涉及集合的泛型类型
支持Spring Controller类上只有@Controller类注解，没有@RequestMapping类注解情况的情况
支持识别通过dto的get/set方法关联的字段关联关系
支持处理类的签名中的泛型信息
支持处理类的签名中继承或实现的泛型关系
支持将java-callgraph2生成的文件的数据保存到Neo4j图数据库
支持读取Neo4j保存的方法调用数据，生成向下的完整方法调用链
增加数据库表记录类之间的引用关系
增加说明文档，增加示例
支持将代码解析数据写入Neo4j时同时写入数据库中
同上
java-callgraph2 使用 2.0.8 版本
为了使 java-callgraph2 的代码及配置文件与“jacg”更容易区分，对代码及配置文件进行以下名称修改
| 内容 | 修改前的名称 | 修改后的名称 |
|---|---|---|
| 包名 | com.adrninistrator.javacg | com.adrninistrator.javacg2 |
| 主类 | com.adrninistrator.javacg.stat.JCallGraph | com.adrninistrator.javacg2.entry.JavaCG2Entry |
| 目录、文件名称 | javacg | javacg2 |
| 类名前缀 | JavaCG | JavaCG2 |
当升级到该版本时，假如之前有对目录进行过分析，则相关目录中的“-javacg_merged.jar”文件需要删除
java-callgraph2 组件升级版本为 2.0.8
_jacg_config/config.properties 配置文件增加参数
- drop.or.truncate.table
在插入数据库表前，对表执行 DROP(false) 还是 TRUNCATE(true) 操作
- gen.call.graph.num.limit
生成向上/向下的完整方法调用链时，每个方法允许生成的方法调用数量限制，默认为0，小于等于0代表不限制
jacg_class_ext_impl_generics_type 类的继承或实现的泛型信息
jacg_class_signature_generics_type 类的签名中的泛型信息
jacg_javacg2_config java-callgraph2组件使用的配置参数信息表
jacg_class_sig_ext_impl_generics 类的签名中继承或实现的泛型关系
jacg_class_signature_ei1 类的签名中涉及继承与实现的信息表1
jacg_class_signature_generics 类的签名中的泛型信息
主要涉及内容：是否数组、泛型相关的数据、Spring Controller方法是否可能用于文件/上传下载
jacg_field_generics_type 非静态字段中涉及的泛型类型
jacg_field_info 字段信息表
jacg_get_method dto的get方法及字段
jacg_method_arg_generics_type 方法参数泛型类型
jacg_method_argument 方法参数类型
jacg_method_info 方法的信息表
jacg_method_return_generics_type 方法返回泛型类型
jacg_set_method dto的set方法及字段
jacg_sf_field_method_call static、final字段初始化方法信息表
jacg_spring_controller Spring Controller信息表