首页
在线工具
搜索
1
Kuboard与KubeSphere的区别:Kubernetes管理平台对比
2
ShardingSphere使用中的重点问题剖析
3
Flowable工作流引擎源码深度解析
4
用AI生成的原型设计稿效果还可以
5
如何将Virtualbox和VMware虚拟机相互转换
杂谈与随笔
工具与效率
源码阅读
技术管理
运维
数据库
前端开发
后端开发
Search
标签搜索
Angular
Docker
Phabricator
SpringBoot
Java
Chrome
SpringSecurity
SpringCloud
DDD
Git
Mac
K8S
Kubernetes
ESLint
SSH
高并发
Eclipse
Javascript
Vim
Centos
Jonathan
累计撰写
86
篇文章
累计收到
0
条评论
首页
栏目
杂谈与随笔
工具与效率
源码阅读
技术管理
运维
数据库
前端开发
后端开发
页面
搜索到
1
篇与
的结果
2017-04-28
笔记Swagger2 Api文档生成工具
Swagger2 Api文档生成工具笔记 Swagger2提供在线的html文档ui测试,如果想生成markdown文档或者alidoc格式文档需要依赖于第三方插件来做 https://github.com/Swagger2Markup/swagger2markup 第三方api文档生成工具 https://github.com/Swagger2Markup/spring-swagger2markup-demo D:/gems/addressable-2.3.8/data/unicode.data 在跑官方DEMO的时候如果报这个错误(issues上说mac下正常)在pom加上org.jruby 依赖 <dependencies> <dependency> <groupId>org.asciidoctor</groupId> <artifactId>asciidoctorj-pdf</artifactId> <version>1.5.0-alpha.10.1</version> </dependency> <dependency> <groupId>org.jruby</groupId> <artifactId>jruby-complete</artifactId> <version>1.7.21</version> </dependency> </dependencies> demo 需要注意:整合项目时,API接口编写需要根据官方提供的规范编写,不然会空指针异常,比如 @RequestMapping(value = "/object", method = POST) @ApiOperation(value = "请输入一个实体类对应的参数", response = User.class)//必须要respone @ApiResponses({@ApiResponse(code = 400, message = "Invalid Order")}) public ResponseEntity<String> placeOrder( @ApiParam(value = "传入一个实体类", required = true) User user) { return ok(""); } 如上是一个demo,但是在Controller只有一个时依然报空指针,需要加上两个DEMO或者想官方demo那样加更多Controller接口。因为还未详细查看api文档,所有后续需要进一步研究
2017年04月28日