doclet – 围炉网

On 2018年2月5日

考虑问道集成openapi规范

【声明】Weirong Li原创，转载请通知作者并注明出处同时保留本文有效链接。

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

On 2017年4月19日

javadoc 抛 java.lang.IllegalArgumentException

【声明】Weirong Li原创，转载请通知作者并注明出处同时保留本文有效链接。

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

On 2016年2月15日

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

【说明】 本文转载自：http://www.csdn.net/article/2013-02-20/2814189-API_DOC_TOOLS

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

On 2015年8月29日

JDK6 javadoc处理注解bug

【声明】Weirong Li原创，转载请通知作者并注明出处同时保留本文有效链接。

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

On 2015年6月23日

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

【声明】Weirong Li原创，转载请通知作者并注明出处同时保留本文有效链接。

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

标签： doclet