最近一直很迷茫,不知道学些什么,但是又有太多东西需要学习(我还是一个小白,不知道广大小白是否也有我这样的烦恼),于是先把以前用的东西和.Net core做下对比,不比不知道,一比把自己给整懵逼了,言归正传,接下来看看我踩的坑。。。 .Net Framework 使用WebAPI 还是比较简单的,之前 ...
1.1 介绍 Swagger是一个简单又强大的能为你的Restful风格的Api生成文档工具。在项目中集成这个工具,根据我们自己的配置信息能够自动为我们生成一个api文档展示页,可以在浏览器中直接访问查看项目中的接口信息,同时也可以测试每个api接口。Swagger生成的api文档是实时更新的,你写 ...
分类:
其他好文 时间:
2018-05-30 10:54:04
阅读次数:
223
1.swagger error 有详细的错误信息 自己根据详细信息找问题 2.swagger error 无详细的错误信息 Controller是否重名=》重名,指定不同的 [Route("*****")] Controller必须制定 [HttpPost] 或者 [HttpGet] 3.swagg ...
分类:
其他好文 时间:
2018-05-29 20:38:06
阅读次数:
776
package com.example.demo; import io.swagger.annotations.ApiOperation;import org.springframework.web.bind.annotation.GetMapping;import org.springframew ...
分类:
其他好文 时间:
2018-05-24 20:40:15
阅读次数:
557
通过Swagger 可以更好的将后台的RESTfull API文档化,如下图所示: 1. Swagger 主要依赖以下两个jar包: 2. 建立一个与Spring Boot的启动类同级的类:Swagger .class,在启动项目后,就会自动扫描com.example.demo下的api,到此这就可 ...
分类:
编程语言 时间:
2018-05-23 20:38:22
阅读次数:
179
@ApiOperation不是spring自带的注解,是swagger里的 com.wordnik.swagger.annotations.ApiOperation; @ApiOperation和@ApiParam为API生成做的注解,个参数说明如下: @ApiOperation(value = “ ...
今天被swagger给折腾死, 原来AddSwaggerGen里的两个v1一定要相同,不然就会报500错,吐血;其他的按网上标准配置,基本都没问题 PS:.AddJsonOptions(options => options.SerializerSettings.ContractResolver= n ...
分类:
其他好文 时间:
2018-05-22 20:47:14
阅读次数:
144
原文:浅析如何在Nancy中使用Swagger生成API文档前言 上一篇博客介绍了使用Nancy框架内部的方法来创建了一个简单到不能再简单的Document。但是还有许许多多的不足。 为了能稍微完善一下这个Document,这篇引用了当前流行的Swagger,以及另一个开源的Nancy.Swagge... ...
分类:
Windows程序 时间:
2018-05-21 17:57:34
阅读次数:
2085
最近开发webapi 时需要生成在线文档,发现文档里面没注释,在网上查找资料都不齐全,或者看起来很难看懂。 花了点时间搞出来了这个,很多都是借鉴网上资料整理的,通俗易懂小白专用。 最终效果如上图所示 1.定义一个SwaggerControllerDescProvider实现ISwaggerProvi ...
分类:
Windows程序 时间:
2018-05-21 16:05:54
阅读次数:
2991