上一次我们分享了关于 gRPC-Gateway 快速实战 ,可以查看地址来进行回顾 :也可以查看关于 gRPC 的历史文章:gRPC介绍gRPC 客户端调用服务端需要连接池吗?gRPC的拦截器gRPC的认证分享一下 gRPC- HTTP网关 I今天主要是分享关于 gRPC-Gateway Swagger 的实战部分,文章大体分为如下几个部分:基本环境补充gR ......
112
0
0
2024-02-03
目录一、项目描述二、简介三、Swagger2.X和Swagger3.0.0 的对比1)SpringFox 2.x 发布2)SpringFox 3.0.0 发布3)swagger3.0 与2.xx配置差异:四、注解说明@Api@ApiOperation@ApiImplicitParams@ApiImplicitParam@ApiResponses@ApiMod ......
255
0
0
2023-06-17
目录一、Swagger简介二、Springboot整合swagger1、添加swagger坐标2、Swagger Helloword 实现2.1、创建springboot项目2.2、写一个接口2.3、访问地址三、常用的配置注解1、Api 注解和 ApiOperation 注解2、ApiImplicitParams 注解 ......
238
0
0
2023-05-06
目录一、关于 Swagger二、Swagger 的安装1、下载 Swagger2、安装 Swagger三、Swagger 的使用1、编写接口2、启用 Swagger3、查看接口文档四、Swagger 的高级使用1、描述数据模型2、描述枚举类型3、描述响应参数五、Swagger 的进阶使用1、配置全局参数2、配置安全协议3、配置安全上下文4、配置忽略参数六、总 ......
269
0
0
2023-05-06
导读:Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。由于Spring Boot能够快速开发、便捷部署等特性,相信有很大一部分Spring Boot的用户会用来构建RESTful API。而我们构建RESTful API的目的通常都是由于多终 ......
263
0
0
2022-10-29
go swagger 自动生成文档前言在写完代码或者正在写代码的时候,如果要与前端进行同步开发文档是必须的,但是如果在写代码的时候发现接口要改,这个时候为了确保前端能够理解又要修改开发文档,万一忘记改了,可能无法面对前端的质问这个时候一个实时同步的开发文档就很重要了学习使用1.安装# 安装 swag 如果不行直接上二进制文件 (国内的连接问题 -- 直接用二 ......
407
0
0
2022-08-05
最近在新项目开发的过程中我发现 swagger-php 升级了版本,而且和以前的文档注释写法有了蛮多的差别。官方文档也写的不是很详细,在这里我将结合自己封装的案例将 Swagger-PHP v3.x 的一些用法分享给大家。 升级后的区别 Swagger-PHP v3.x Specification Swagger-PHP v3.x 官方文档 介绍 ......
417
0
0
2022-06-29
1.引入依赖,版本3.0.0只引入一个即可 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> ......
311
0
0
2022-06-19
1.引入依赖,版本3.0.0只引入一个即可 <dependency><groupId>io.springfox</groupId><artifactId>springfox-boot-starter</artifactId><version>3.0.0</versio ......
295
0
0
2022-05-05
介绍swagger使我们在api开发中常用到的技术,其解决了web api文档生成的问题。它具有诸多交互式文档、客户端SDK生成和api可发现性等优点。由于笔者是从事.net core方向的开发,所以咱们就聊一聊在.net core web api的项目中集成swagger或者redoc。NSwag.NET本文主要讲的是使用NSwag.NET来将swagge ......
413
0
0
2022-04-13
简介api文档是个比较重要的话题,每个团队都有自己的api习惯,比如我们目前用的apizza来管理接口,也可以用postman。但是不管用什么感觉前端对后端的接口都不是很满意:)(手动狗头),这个问题不过多讨论,下面介绍一种比较强大的swagger,集成到laravel中的一些用法。swagger集成分为swagger-php 和 swagger-ui,可以 ......
369
0
0
2022-04-12
Swagger的 官网 上有一个在线的demo,可以在线体验。我们也可以下载其 源码 ,执行dist\index.html文件,即可得到和官网一样功能的demo,不需要架设服务器就能使用。从网络请求中查看,发现它请求了一个名为swagger.json的文件。而这个json文件里面定义的基本就是文档的scheme。从这个页面我们基本上可以发现swagger的原 ......
311
0
0
2022-04-07
前言本来在Swagger的基础上,前后端开发人员在开发生产期间,可以借此进行更加便捷的沟通交流。可是总有些时候,遇到一些难缠的,又不讲道理,偏偏觉得将Swagger文档地址丢给客户会不够正式!死活要一份word文档。可是这个时候,如果接口数量上百个,甚至更多,一个一个手动输入word,那将是一笔耗时的工作。但却有什么办法可以解决呢?对了,利用Swagge生成 ......
342
0
0
2022-04-06