今天在写swagger的注释的时候，发现我写的实体类，有一些类，在swagger-ui.html中的Models里面居然找不到，真是日了狗了。重启、对比pojo代码过后，发现并没有什么卵用。最后静下来想了下，会不会是因为controller的原因，因为我发现有些用到了@RequestBody的，都能 ...
1.创建一个Core APi项目 2.引用nuget包：Swashbuckle.AspNetCore 3.注册中间件 services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new OpenApiInfo { Title = "Test API", Desc ...
分类：
其他好文 时间：
2020-11-26 15:20:28
阅读次数：
15
OpenAPI 是一个规范的名称。 3.0版本的对RESTful API方面做得很好。 Swagger 是一个 API文档维护组织，后来成为了 Open API 标准的主要定义者。现在最新的版本为17年发布的 Swagger3（Open Api3）。 是一个Open API规范实现工具包，由于Swa ...
介绍： 前后端分离开发模式中，api文档是最好的沟通方式。 Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。 总结： 目前使用到swagger的测试功能，可以替代postman进行 各种请求方式 的api接口测试 项目中使用： 1 引入依赖 ...
分类：
其他好文 时间：
2020-11-17 12:24:31
阅读次数：
4
Swagger-UI简介 Swagger-UI Swagger-UI是HTML, Javascript, CSS的一个集合，可以动态地根据注解生成在线API文档。 常用注解 @Api：用于修饰Controller类，生成Controller相关文档信息 @ApiOperation：用于修饰Contr ...
分类：
编程语言 时间：
2020-11-16 13:40:39
阅读次数：
13
一.整合swagger2 1. 加依赖 <!-- 引入swagger2 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</ver ...
分类：
编程语言 时间：
2020-11-16 12:58:29
阅读次数：
17
因为公司流程的需要，需要给每个API的Request 和Response 模型及属性加上注解，发现Api项目依赖的Model 类库中的/// Summy的注解并没有作用。 通过翻资料和实践。发现借助 Swashbuckle.AspNetCore.Annotations 包可以实现。 步骤： 在模型字 ...
分类：
Web程序 时间：
2020-11-12 14:12:28
阅读次数：
12
目录 1 安装 2 修改名称和版本号 3 显示说明 4 显示控制器注释及汉化 5 路由相同，查询参数不同的方法 6 忽略 Model 中的某些字段 7 传递 header 8 出错时的 HTTP 状态码 开发 web api 的时候，写文档是个痛苦的事情，而没有文档别人就不知道怎么调用，所以又不得不 ...
SpringBoot整合Swagger-ui实现在线API文档 Swagger是一款功能强大的api框架，支持在线接口文档的ui界面，还提供了在线测试功能，此外，它还支持流行的Restful风格接口。 本篇要点 简单介绍restful风格。 介绍SpringBoot与Swagger-ui快速整合。 ...
分类：
编程语言 时间：
2020-11-08 17:45:00
阅读次数：
28
原文链接: https://www.changxuan.top/?p=1161 起因 昨天的时候，同事遇到了一个问题需要访问一个 nginx 部署的项目的 swagger 文档，但是在路由转发规则那里加上了 swagger-ui.html 之后仍不能访问。平时我们在内网开发，可以直接访问 后端项目i ...
分类：
其他好文 时间：
2020-11-01 10:16:48
阅读次数：
31
