当前位置: 首页 > 工具软件 > JApiDocs > 使用案例 >

JApiDocs 命令行执行生成文档

尉迟鑫鹏
2023-12-01

JApiDocs  的1.4.4的版本中,用命令行执行

java -jar japidocs-1.4.4.jar

会抛出异常信息

Exception in thread "main" io.github.yedaxia.apidocs.exception.ConfigException: api version cannot be null
        at io.github.yedaxia.apidocs.DocContext.init(DocContext.java:40)
        at io.github.yedaxia.apidocs.Docs.buildHtmlDocs(Docs.java:27)
        at io.github.yedaxia.apidocs.Docs.main(Docs.java:20)

经代码分析,在 https://github.com/YeDaxia/JApiDocs/blob/master/library/src/main/java/io/github/yedaxia/apidocs/DocContext.java第40行会抛出异常,代码在初始化的时候并未将apiVersion 从配置文件中取值

在         https://github.com/YeDaxia/JApiDocs/blob/master/library/src/main/java/io/github/yedaxia/apidocs/Docs.java第69行添加

config.apiVersion = properties.getProperty("apiVersion", null);

即可解决此问题

配置文件为 docs.config ,代码中写死了,必须为这个,以下为config的配置:

projectPath = E:\\project\\xxx\\trunk\\admin
docsPath = E:\\project\\test_doc\\api_v1.0
apiVersion = api_v1.0

附上改好的jar包,在mvn引用中我用的还是1.4.4,在springboot中使用不会有问题,只是在命令行执行的时候会有问题,所以就不用改mvn的引用了

https://download.csdn.net/download/zlongxiao/87438484

 类似资料: