liuhuagui / smalldoc Goto Github PK

配置截图如上

spring.profiles=dev
smalldoc.source-paths[0]=D:\hhz\hhz-platform\src\main\java
smalldoc.packages[0]=com.cheng.hhz.controller.hello
smalldoc.project-name=mydoc
smalldoc.enabled=true
smalldoc.url-pattern=/smalldoc/*

建议添加一个可以运行的springboot demo，目前集成路径访问不到，资源文件映射都不知道怎么写了

2019-12-18 18:01:24.282 WARN 25068 --- [onPool-worker-4] c.g.l.s.core.storer.ParamTagStorer : Method: com.guwukeji.snowucenter.controller.AuthController.getAuthList(AuthListSearchFEO), The param tag @{f1[],[f2[],...]} is expected when parameter authListSearchFEO is an entity type.

我通过注解RequestBody的对象AuthListSearchFEO警告日志如上，我在配置文件中已经加上了当前对象所在的包和源码路径，可在UI上没有显示出来

我是用的时maven 3.6.2
执行maven install时会提示以下错误：
Failed to execute goal org.apache.maven.plugins:maven-gpg-plugin:1.6:sign (sign-artifacts) on project smalldoc: Unable to execute gpg command

试了一下可以加入pluginManagement解决，但我没有测试其他maven版本




...

macOS Catalina 10.15.3
Cannot resolve com.github.smalldoc:tools:yours

我使用自己习惯的几个文档注释感觉生成的api文档并不是很友好，能给一个使用注释生成文档的例子大全吗？或者您私人微信能加一下吗？我有几个用法的问题想问您

表示同样忍受不了Swagger的界面，具体问题使用后再提

处理某个接口时有以下提示，不确定是什么问题。
com.github.liuhuagui.smalldoc.util.Assert$AssertException: Method: com.dhcloud.avap.domain.modules.domain.rest.DomainRestController.listByPage(DomainEntity, HttpServletRequest), This param model doesn't exist.
at com.github.liuhuagui.smalldoc.util.Assert.notNull(Assert.java:30) ~[smalldoc-core-2.3.1.jar:na]
at com.github.liuhuagui.smalldoc.core.storer.MethodParamsStorer.getParam(MethodParamsStorer.java:36) ~[smalldoc-core-2.3.1.jar:na]
at com.github.liuhuagui.smalldoc.core.DefaultSmallDocletImpl.getParamDocsInfo(DefaultSmallDocletImpl.java:232) [smalldoc-core-2.3.1.jar:na]
at com.github.liuhuagui.smalldoc.core.DefaultSmallDocletImpl.handleMethodDoc(DefaultSmallDocletImpl.java:133) [smalldoc-core-2.3.1.jar:na]
at com.github.liuhuagui.smalldoc.core.DefaultSmallDocletImpl.getMehodDocsInfo(DefaultSmallDocletImpl.java:103) [smalldoc-core-2.3.1.jar:na]
at com.github.liuhuagui.smalldoc.core.DefaultSmallDocletImpl.handleClassDoc(DefaultSmallDocletImpl.java:71) [smalldoc-core-2.3.1.jar:na]
at com.github.liuhuagui.smalldoc.core.DefaultSmallDocletImpl.handleClassDocs(DefaultSmallDocletImpl.java:54) [smalldoc-core-2.3.1.jar:na]

比如参数为A a；其中 A extend B《C》 ，此时a这个参数中不会解析到C的属性

Factory method 'smallDocServletRegistrationBean' threw exception; nested exception is java.lang.NullPointerException

这个依赖是下载问题还是maven仓库上没有上传

见文档中强烈推荐，将maven坐标scope设置为test，我按着这种方式设置完之后，访问网址，404，请问是什么原因

当前文档是按controller来展示的，我有好多个包，这样都展示在同一级的话不好区分具体是哪个包的了。