开源API文档工具- swagger2 与 smart-doc 比较 与 使用
工具开源地址 swagger2 : https://swagger.io/ smart-doc： https://www.oschina.net/p/smart-doc 国产 两者的比较 swagger2 和 smart-doc 两个开源工具 都可以 使用jar包 生成 api 文档 ...
原文：使用smart-doc ，放弃japidocs，更放弃 swagger
众所周知 真不是人云亦云 swagger强大吗 强大的。但是代码侵入性太强了 japidocs ,没有代码入侵问题，也很好 但是有个bug 没有办法传入接口泛型对象。 比如： public ApiOut lt User gt String ApiIn lt User gt 他无法解析ApiIn lt User gt , 但可以解析ApiOut lt User gt 上面两个我都试过了 最后，我选择 ...
2021-06-23 12:01 0 340 推荐指数：
相关推荐
Java Web接口文档——smart-doc
传统swagger（之前在用）接口文档的缺点： 1、代码侵入性太强。 2、写着麻烦。需要写大量的注解，太麻烦！ smart-doc的优点： 1、不需要注解，无侵入性。 2、只需要写好注释即可，界面也比较美观。 3、对一些常用的电话、地址之类的模拟的数据跟真的一样（哈哈哈 ...
smart-doc API文档生成工具
smart-doc是一款API文档生成工具，无需多余操作，只要你规范地写好代码注释，就能生成API文档。同时能直接生成Postman调试文件，一键导入Postman即可调试！ 在项目中添加smart-doc的Maven插件 在项目的resources目录下，添加配置文件 ...
smart-doc 生成接口文档
方式一 插件方式 springboot 启动类 运行生成接口文档 1.pom文件 导入插件 2.resource目录下 smart-doc.json 配置文件 方式二 jar包方式 1.pom 导入jar包 ...
smart-doc 代码逆向生成接口文档
最近领导分了一个调研smart-doc的任务，可以扫描项目中Controller类，生成接口文档，省去了人工手写文档的工作，而且随时生成，便于维护；缺点就在于，要用这个第三方工具来限制规范代码，例如方法、实体、控制层的注解编写规范，增大项目负荷。 建议刚接触的朋友根据场景，慎重考虑。 生成 ...
Spring Boot集成smart-doc生成接口文档
第一步： 添加plugin插件， 第二步： 新建smart-doc.json配置文件 第三步： 查看maven里面的plugins会出现smart-doc，会有生成接口文档的按钮。 ...
Swagger从入门到放弃
如何编写基于OpenAPI规范的API文档 简介 Swagger Swagger是一个简单但功能强大的API表达工具。支持的语言种类繁多 使用Swagger生成API，我们可以得到交互式文档，自动生成代码的SDK以及API的发现特性 OpenAPI规范 OpenAPI规范 ...
storm从入门到放弃(三)，放弃使用 StreamId 特性
序:StreamId是storm中实现DAG有向无环图的重要一个特性,但是从实际生产环境来看，这个功能其实蛮影响生产环境的稳定性的，我们系统在迭代时会带来整体服务的不可用。 StreamId ...