swagger

使用 Postman 测试你的 API

南楼画角 提交于 2020-04-23 08:13:18
使用 Postman 测试你的 API Intro 最近想对 API 做一些自动化测试,看了几个工具,最后选择了 postman,感觉 postman 的设计更好一些,我们可以在请求发送之前和请求获取到响应之后都可以自定义脚本,很灵活。而且 postman 的支持直接导入 swagger 定义,这样我们就可以很容易的和接口的 swagger 文档结合起来,而且值得一提的是看了几个工具 postman 是看的几个工具里唯一一个支持 openapi 3.0 的文档导入的,其他工具只支持 swagger 2.0,openapi 3.0 是不支持的。 先来看一个 postman 测试的结果 下面就基于一个 swagger 文档来导入API并测试 API GetStarted postman 支持直接给出一个 swagger 的 json 描述文档可以是本地的也可以是在线的,这里我们以一个在线的swagger文档作为示例 打开左上角的 File => Import 打开 asp.net core 的 swagger 页面,如下图,使用的示例: https://reservation.weihanli.xyz/swagger/index.html 将 swagger 文档的地址 copy 到对应的 url 输入框中 导入之后可以得到类似下面的示例, API 对应着这个 Collection

SpringBoot系列(八)分分钟学会Springboot多种解决跨域方式

萝らか妹 提交于 2020-04-23 03:35:46
SpringBoot系列(八) 分分钟学会SpringBoot多种跨域解决方式 往期推荐 SpringBoot系列(一)idea新建Springboot项目 SpringBoot系列(二)入门知识 springBoot系列(三)配置文件详解 SpringBoot系列(四)web静态资源配置详解 SpringBoot系列(五)Mybatis整合完整详细版 SpringBoot系列(六)集成thymeleaf详解版 Springboot系列(七) 集成接口文档swagger,使用,测试 ** 目录 ** 1. 跨域怎么理解 2. SprinBoot中跨域的三种解决方法 1. CrossOrigin注解 2. 实现WebMvcConfigurer 3. 过滤器配置 3. 跨域测试 4.总结: 1. 跨域怎么理解 跨域是什么?  跨域是指不同域名之间的相互访问,这是由浏览器的同源策略决定的,是浏览器对JavaScript施加的安全措施,防止恶意文件破坏。 同源策略 :同源策略是一种约定,它是浏览器最核心的也是最基本的安全策略,如果缺少了同源策略,则浏览器的正常功能可能会受到影响。 所谓 同源 就是说 协议 , 域名 , 端口号 完全一致,有一个不一致就会造成跨域问题。 跨域原理: 跨域请求能正常发出去, 服务端能接受到请求并正常返回结果 ,只是结果被拦截了。 跨域只存在于浏览器

SpringBoot系列(八)分分钟学会Springboot多种解决跨域方式

一个人想着一个人 提交于 2020-04-23 01:43:31
SpringBoot系列(八) 分分钟学会SpringBoot多种跨域解决方式 往期推荐 SpringBoot系列(一)idea新建Springboot项目 SpringBoot系列(二)入门知识 springBoot系列(三)配置文件详解 SpringBoot系列(四)web静态资源配置详解 SpringBoot系列(五)Mybatis整合完整详细版 SpringBoot系列(六)集成thymeleaf详解版 Springboot系列(七) 集成接口文档swagger,使用,测试 ** 目录 ** 1. 跨域怎么理解 2. SprinBoot中跨域的三种解决方法 1. CrossOrigin注解 2. 实现WebMvcConfigurer 3. 过滤器配置 3. 跨域测试 4.总结: 1. 跨域怎么理解 跨域是什么?  跨域是指不同域名之间的相互访问,这是由浏览器的同源策略决定的,是浏览器对JavaScript施加的安全措施,防止恶意文件破坏。 同源策略 :同源策略是一种约定,它是浏览器最核心的也是最基本的安全策略,如果缺少了同源策略,则浏览器的正常功能可能会受到影响。 所谓 同源 就是说 协议 , 域名 , 端口号 完全一致,有一个不一致就会造成跨域问题。 跨域原理: 跨域请求能正常发出去, 服务端能接受到请求并正常返回结果 ,只是结果被拦截了。 跨域只存在于浏览器

【gin-vue-admin】 使用go和vue 快速搭建一个项目模板

孤街浪徒 提交于 2020-04-22 09:02:28
gin-vue-admin gin+vue开源快速项目模板 项目地址: https://github.com/piexlmax/gin-vue-admin 增加了 micro-service-test分支 提供了微服务解决方案 个人摸索 仅供参考 本模板使用前端ui框架为 element-ui https://element.eleme.cn/#/zh-CN 前端组件可查看elementUi文档使用 写在前面 本项目主要是小弟在接各种私活的时候发现频繁得书写CURD、权限管理、用户管理、列表、分页、上传下载、日志包封装、文档自动化等等功能 为了方方便各位个人开发者快速搭建项目基础模型,于是开发本模板,也为了以后自己可以剩下一些初期开发的功夫 本身是前端出身,所以对于后端的项目目录或者架构可能偏向前端思维,如果有什么地方需要改动感谢大家iss 强烈希望在各位的帮助下,此项目可以用于企业级项目的开发 环境搭建教学视频 腾讯视频: https://v.qq.com/x/page/e3008... 模板使用教学及展示视频 腾讯视频: https://v.qq.com/x/page/c3008... 技术选型 1.后端采用golang框架gin,快速搭建基础restful风格API 2.前端项目采用VUE框架,构建基础页面 3.数据库采用Mysql,可能会引用redis作为缓存数据库使用

新书上线:《Spring Boot+Spring Cloud+Vue+Element项目实战:手把手教你开发权限管理系统》,欢迎大家买回去垫椅子垫桌脚

ε祈祈猫儿з 提交于 2020-04-22 09:01:02
新书上线 大家好,笔者的新书《Spring Boot+Spring Cloud+Vue+Element项目实战:手把手教你开发权限管理系统》已上线,此书内容充实、材质优良,乃家中必备垫桌脚垫菜盘之良器,欢迎大家无情购买使用,欢迎大家共同学习交流,欢迎大家提出改进意见。 内容简介: 本书从项目实践出发,手把手、心贴心地带领读者从零开始,一步一步地开发出功能相对完整的权限管理系统,从而深入掌握当前主流的Spring Boot + Spring Cloud + Vue前后端集成开发技术。 全书分为三篇共32章。第一篇为系统介绍篇,对系统的功能、架构和界面进行介绍,对系统的安装运行给出指南,对涉及的关键技术进行简单介绍。第二篇为后端实现篇,从数据库设计和搭建开发环境开始,全面细致地讲解权限管理系统的后端实现全过程。第三篇为前端实现篇,从搭建开发环境开始,全面细致地讲解权限管理系统的前端实现全过程。 本书适合前后端开发人员和全栈工程师阅读,也适合高等院校和培训学校相关专业的师生教学参考。 购买途径 通过天猫、京东、当当等各大网站,搜索 “Spring Boot+Spring Cloud+Vue+Element” 或 “手把手教你开发权限管理系统” 等相关关键字,即可检索到相关图书购买链接,为方便大家查找,下面附上一些简单查找流程示例。 京东 参考链接: https://item.jd.com

java springboot 大文件分片上传处理

China☆狼群 提交于 2020-04-21 04:20:06
参考自: https://blog.csdn.net/u014150463/article/details/74044467 这里只写后端的代码,基本的思想就是,前端将文件分片,然后每次访问上传接口的时候,向后端传入参数:当前为第几块文件,和分片总数 下面直接贴代码吧,一些难懂的我大部分都加上注释了: 上传文件实体类: /** * 文件传输对象 * @ApiModel和@ApiModelProperty及Controller中@Api开头的注解 是swagger中的注解 用于项目Api的自动生成,如果有没接触过的同学,可以把他理解为一个注释 */ @ApiModel( "大文件分片入参实体" ) public class MultipartFileParam { @ApiModelProperty( "文件传输任务ID" ) private String taskId; @ApiModelProperty( "当前为第几分片" ) private int chunk; @ApiModelProperty( "每个分块的大小" ) private long size; @ApiModelProperty( "分片总数" ) private int chunkTotal; @ApiModelProperty( "主体类型--这个字段是我项目中的其他业务逻辑可以忽略" ) private

postman使用教程

雨燕双飞 提交于 2020-04-21 02:35:25
目前公司虽然也是前后端分离的项目,但是没有使用swagger,所以接口的测试使用的是postman,但是我关于postman的使用知道的比较少,将最近使用postman的内容总结下,如有不足希望大家帮我补充,提前谢过各位大佬。 1、注册postman账号,并注意留存。因为使用postman的记录都会保存到远端,更换机器后,利用账号信息可以快速找回之前的内容 2、设置环境变量,需要在不同环境下跑相同的测试,利用设置环境变量动态选择 新增环境变量 使用这些键值的时候只需要加上两个花括号引用key / / 建立多个环境时,key通常都是相同的,只是value不同 { { url } } / username 创建好所有环境后,在跑测试的时候在右上角下拉选择需要的环境即可 3、按模块管理请求 创建集合可以用于归纳每个模块 将创建的请求存在到对应集合中 4、headers信息批量填入 有时候发送请求的时候要在header中放入一些内容,但是header中大部分请求基本上都相似,可以利用Presets统一处理 使用的选择对应的header信息,header内容就会被自动填充 5、postman还是非常优秀的自动化接口测试工具,作为研发目前用的比较少,推荐大家看博文 自动化接口测试之Postman 总结 上述内容总结的个人目前在工作中使用postman比较顺手的地方,也会提高一些自测效率

grpc-gateway--支持grpc和restful

﹥>﹥吖頭↗ 提交于 2020-04-20 13:57:07
The grpc-gateway is a plugin of the Google protocol buffers compiler protoc . It reads protobuf service definitions and generates a reverse-proxy server which 'translates a RESTful HTTP API into gRPC. This server is generated according to the google.api.http annotations in your service definitions. grpc-gateway 是protoc的一个插件。它读取gRPC服务定义,并生成一个反向代理服务器,将RESTful JSON API转换为gRPC。此服务器是根据gRPC定义中的自定义选项生成的。 参考: 1. https://github.com/grpc-ecosystem/grpc-gateway https://grpc-ecosystem.github.io/grpc-gateway/ 2. grpc-gateway应用 煎鱼 grpc + grpc gateway 3. OpenNESS eaa.proto生成swagger yaml 4. gRPC 调试工具 gRPC

Swagger Parser does not get all the paths from swagger.json

牧云@^-^@ 提交于 2020-04-18 05:42:33
问题 Duplicate paths are not allowed by the Swagger 1.2 Specification: In the apis array, there MUST be only one API Object per path. The parser simply ignores the duplicates. and I have a swagger.json file and I want to extract all the paths and their methods from this file. I tried to use Json Parser but I have no idea how to use it. How can I do so? Here is my code : import java.util.Map; import java.util.Map.Entry; import org.json.simple.parser.JSONParser; import io.swagger.models.HttpMethod;

ASP.NET Core WebAPI中的分析工具MiniProfiler

坚强是说给别人听的谎言 提交于 2020-04-18 01:02:38
介绍 作为一个开发人员,你知道如何分析自己开发的Api性能么? 在Visual Studio和Azure中, 我们可以使用Application Insight来监控项目。除此之外我们还可以使用一个免费工具 Stackify Prefix ,它允许追踪所有的Http请求, 这里有一篇博客讲解了如何使用 Stackify Prefix ( Scalable and Performant ASP.NET Core Web APIs: Profiling and Monitoring )。 本文我将引入另外一个工具 MiniProfiler , 我将讲解如何将 MiniProfiler 集成到ASP.NET Core WebAPI中。 与 Stackify Prefix 相似, MiniProfiler 也是一款免费的工具(官网地址: https://miniprofiler.com/dotnet/ ),你可以使用它精确的分析ASP.NET和ASP.NET Core应用程序的任何代码。 Tips: MiniProfiler 在ASP.NET和控制台程序中也可以使用哦。 安装 我们可以使用Nuget来下载这个包。 PM> Install-Package MiniProfiler.AspNetCore.Mvc 配置<code>Startup.cs</code> MiniProfiler