标签归档:doclet

openapi规范

【声明】本文为AdamsLee原创,转载请注明出自围炉网并保留本文有效链接:openapi规范, 转载请保留本声明!

    一直在考虑问道是否可以与其它接口测试平台对接,实现生成接口文档后自动生成一些测试用例。在研究过程中,发现了swagger推动的OpenAPI规范 https://github.com/OAI/OpenAPI-Specification 。如果大家的接口都通过OpenAPI来描述,那么就可以使用基于OpenAPI的各种工具。这个思路应该不错。[……]

Read more

继续阅读

发表在 未分类 | 标签为 | openapi规范已关闭评论

javadoc 抛 java.lang.IllegalArgumentException

【声明】本文为AdamsLee原创,转载请注明出自围炉网并保留本文有效链接:javadoc 抛 java.lang.IllegalArgumentException, 转载请保留本声明!

最近在机器上执行mvn javadoc:javadoc时,突然出现如下 IllegalArgumentException 的错误,但wrdoclet中运行Test.main() 来生成文档时没有抛错,非常诡异。[……]

Read more

继续阅读

发表在 未分类 | 标签为 | javadoc 抛 java.lang.IllegalArgumentException已关闭评论

告别手写 API文档生成工具推荐

告别手写 API文档生成工具推荐[……]

Read more

继续阅读

发表在 未分类 | 标签为 | 告别手写 API文档生成工具推荐已关闭评论

JDK6 javadoc处理注解bug

【声明】本文为AdamsLee原创,转载请注明出自围炉网并保留本文有效链接:JDK6 javadoc处理注解bug, 转载请保留本声明!

在我的 https://github.com/WinRoad-NET/wrdoclet 项目中,一开始一直是在JDK7上开发的。因为公司一直用的是JDK6,最近想完善一下,看看是否能够支持JDK6。却发现一直无法编译通过,绕过了各种兼容问题后,最后还是卡在了下面这个异常:[……]

Read more

继续阅读

发表在 未分类 | 标签为 , | JDK6 javadoc处理注解bug已关闭评论

通过自定义java doclet定制接口文档

【声明】本文为AdamsLee原创,转载请注明出自围炉网并保留本文有效链接:通过自定义java doclet定制接口文档, 转载请保留本声明!

当然我这边也尝试写了一个工具wrdoclet,它可以针对restful的HTTP接口以及WebService接口生成接口文档,而不必暴露内部实现所用到的类。这样接口调用者可以很方便的参阅接口文档。wrdoclet的源码地址在github上: https://github.com/WinRoad-NET/wrdoclet [……]

Read more

继续阅读

发表在 未分类 | 标签为 , | 通过自定义java doclet定制接口文档已关闭评论