发现一款比swagger还好用的工具，支持导出成PDF文档

首先希望webapi支持多版本，swagger针对不同的版本可进行交互。这种方式很直观，但如果原有项目没有使用多版本控制不建议用，可采用header的方式更为合理一些，增加多个 [ApiVersion]即可。但是两个相同的版本中Controller不能有相

在 asp.net core 中，存在着中间件这一概念，在中间件中，我们可以比过滤器更早的介入到 http 请求管道，从而实现对每一次的 http 请求、响应做切面处理，从而实现一些特殊的功能。在使用中间件时，我们经常实现的是鉴权、请求日志记录、全局异常处

建立一个全新的项目，或者把旧的庞大的项目，进行拆分成多个项目。在建立新的项目中，经常需要做一些重复的工作，比如说拷贝一下常用的工具类，通用代码等等。所以就可以做一个基础的项目方便使用，在经历新项目的时候，直接在基础项目上进行简单配置就可以开发业务代码了。基

Swagger本质上是一种用于描述使用JSON表示的RESTful API的接口描述语言。Swagger与一组开源软件工具一起使用，以设计、构建、记录和使用RESTful Web服务。Swagger包括自动文档，代码生成和测试用例生成。可是编写接口文档历来

swagger报错No operations defined in spec!一般有2个原因：。其中第2个path错误，path要是全匹配url，url是完整的，包含方法的url，本人因为path只写controller上的url，没写方法上的url，找了

每个服务都有自己的接口，通过Swagger来管理接口文档。在服务较多的时候我们希望有一个统一的入口来进行文档的查看，这个时候可以在Zuul中进行文档的聚合显示。下面来看下具体的整合步骤以及采坑记录。Cloud版本：Finchley.SR2， Boot版本：

/ 只要扫描的接口中存在实体类，它就会被扫描到swagger中。@ApiModelpublic class Userinfo { @ApiModelProperty private int id;

wagger-ui有非常多的版本，觉得不太好用，用postman，每个接口都要自己进行录入。所以在基于think-vuele进行了swagger格式json的解析，自己实现了一套swaggerui界面。swagger分为后端数据提供方方和前端页面展示请求方

我们在使用Swagger生成.NET Core Web Api 项目接口文档时候，发现接口的入参和出参的注释是看不见的，如下：。为什么没有显示注释呢，注释确实写了呀？如果你的入参和出参的实体不在当前项目文件下,而是在Model层或者领域层创建的，肯定是没有

在pom.xml文件中添加web、swagger、common依赖包。// | | \\\ - /// | | //. // | \

　　Spring Boot 框架是目前非常流行的微服务框架，我们很多情况下使用它来提供 Rest API。而对于 Rest API 来说很重要的一部分内容就是文档，Swagger 为我们提供了一套通过代码和注解自动生成文档的方法，这一点对于保证 API 文

Swagger每一个@ApiModelProperty注解里example属性都会进行非空判断.但是,它在判断的语句里只判断了null的情况,没有判断是空字符串的情况,所以解析数字的时候就会报这个异常。swagger-models 默认是1.5.20，这个

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。接口的文档在线自动生成。@ApiImplicitParam(name = "te

@ApiModel(value = "商品类", description = "用于存储商品对象的字段",@ApiModelProperty(name = "类型主键", dataType = &

Swagger 是一个规范且完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。Swagger 的目标是对 REST API 定义一个标准且和语言无关的接口，可以让人和计算机拥有无须访问源码、文档或网络流量监测就可以发现和理解服

404页面，以前在netframework里，需要在iis上配置，或者在web.config里配置，在netcore mvc里，则可以用中间件来实现，非常简单！上面的是Action，再创建对应的View页面，View页面我就不贴代码了。

在应用开发过程中经常需要对其他应用或者客户端提供 RESTful API 接口，尤其是在版本快速迭代的开发过程中，修改接口的同时还需要同步修改对应的接口文档，这使我们总是做着重复的工作，并且如果忘记修改接口文档，就可能造成不必要的麻烦。为了解决这些问题，S

为了支持WebAPI，我们需要把当前的MVC项目改造一下，右键项目，通过 Nuget添加WebAPI的支持。接下来，我们解决备注不显示的问题，项目右键-->属性，在 生成 选项卡中勾选 xml文档文件选项。添加汉化支持，添加自定义汉化脚本，右键项目，

他掉着头发走来了。今天的重点是React或React Native如何高效管理调用后端接口，和上篇讲到Vue管理后端接口一样，它们有很多相似性，也有不同之处，因为我们知道它们开发模式和方法有些不同。而在Redux中主要有Reducer和Action，Re

通过代理转发后，webapi的swagger无法访问，本质原因是代理后url路径发生变化导致swagger无法定位到json。proxy_set_header Host $http_host; # 使用http_host而非host以满足带有端口号的情