swagger

.netcore 3.1 swagger使用

ぐ巨炮叔叔 提交于 2020-05-02 02:04:38
网上的swagger教程很多,配置一堆东西,很容易跑不通,看公司同事搞得用法挺精简,适合入门使用 1、nuget安装下面的包 2、增加如下#region区域代码 public void ConfigureServices(IServiceCollection services) { services.AddControllers(); #region swagger services.AddSwaggerGen(c => { c.SwaggerDoc( " v1 " , new Microsoft.OpenApi.Models.OpenApiInfo { Title = " TEST API " , Version = " v1 " }); }); #endregion } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseHttpsRedirection(); app.UseRouting(); app.UseAuthorization(); #region swagger app.UseSwagger(); app.UseSwaggerUI(c

How to access application run on local mashine from container?

坚强是说给别人听的谎言 提交于 2020-04-30 07:13:28
问题 I have an application run locally and I have a docker container run via docker compose : swagger: image: swaggerapi/swagger-ui:v3.23.5 ports: - "7171:8080" networks: - dockernet expose: - 8080 environment: - URL=http://192.168.10.20:8080/actions/v3/api-docs 192.168.10.20 is my localhost. if I access http://192.168.10.20:8080/actions/v3/api-docs via browser I see the response but swagger service can't access it. How to fix it ? 来源: https://stackoverflow.com/questions/61322256/how-to-access

[Abp vNext 入坑分享]

走远了吗. 提交于 2020-04-29 09:32:40
一、感想 在写这一系列文章之前,本来以为写这个之前已经搭建好的框架描述会比较简单,但是慢慢写下来才发现。写这个真的不简单额,本来以为图文一起,一个晚上应该能输出一篇吧。。。结果:现实真的骨感,一个星期能输出两篇都不错了。。 1.之前没有写过整体系列类的文章,从高考之后就基本上没有写长篇的文章了。 2.本系列文章主要定位面向是初中级的开发可以根据步骤来搭建,高级与架构主要是相互讨论一下借鉴,所以很多东西写得很简单,基本上相当于是手把手教搭建的了 3.虽然自己之前的搭建已经完成了,但是从新来的时候好像有一些之前没有考虑到的东西又要重新考虑一下加深了理解,从第4篇开始已经慢慢到了应用的层面,虽然基于abpvnext,但是并没有完全基于。要写这些的时候又要想着怎么写得比较清晰,或者又怕自己理解不够搞错了。 4.现在大多数分享都是写demo类,像这种直接拿整个解决方案的很少,同时架构这种又是不同的team有不同的解决方案。我只能写我自己的用法,供参考吧。。 总知一句话:好难啊!!尽量坚持写完整个框架搭建吧!! 搞完之后看下要不要基于这个架构再开个持续集成的新坑:k8s,jenkins,docker之类的持续集成方面的。 唉!慢慢写吧。 二、简要说明 源码: https://github.com/lcjyslqyy/AbpVnext.Learn 《章节目录》 由于我们在前面已经说明了

[Abp vNext 入坑分享]

北慕城南 提交于 2020-04-29 09:02:23
一、感想 在写这一系列文章之前,本来以为写这个之前已经搭建好的框架描述会比较简单,但是慢慢写下来才发现。写这个真的不简单额,本来以为图文一起,一个晚上应该能输出一篇吧。。。结果:现实真的骨感,一个星期能输出两篇都不错了。。 1.之前没有写过整体系列类的文章,从高考之后就基本上没有写长篇的文章了。 2.本系列文章主要定位面向是初中级的开发可以根据步骤来搭建,高级与架构主要是相互讨论一下借鉴,所以很多东西写得很简单,基本上相当于是手把手教搭建的了 3.虽然自己之前的搭建已经完成了,但是从新来的时候好像有一些之前没有考虑到的东西又要重新考虑一下加深了理解,从第4篇开始已经慢慢到了应用的层面,虽然基于abpvnext,但是并没有完全基于。要写这些的时候又要想着怎么写得比较清晰,或者又怕自己理解不够搞错了。 4.现在大多数分享都是写demo类,像这种直接拿整个解决方案的很少,同时架构这种又是不同的team有不同的解决方案。我只能写我自己的用法,供参考吧。。 总知一句话:好难啊!!尽量坚持写完整个框架搭建吧!! 搞完之后看下要不要基于这个架构再开个持续集成的新坑:k8s,jenkins,docker之类的持续集成方面的。 唉!慢慢写吧。 二、简要说明 源码: https://github.com/lcjyslqyy/AbpVnext.Learn 《章节目录》 由于我们在前面已经说明了

SpringBoot整合系列-整合MyBatis

北战南征 提交于 2020-04-28 21:49:50
原创作品,可以转载,但是请标注出处地址: https://www.cnblogs.com/V1haoge/p/9971036.html SpringBoot整合Mybatis 步骤 第一步:添加必要的jar包 <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.1</version> </dependency> 第二步:添加必要的配置 application.properties ##配置数据源 spring.datasource.url = jdbc:h2:mem:dbtest spring.datasource.username = sa spring.datasource.password = sa spring.datasource.driverClassName =org.h2.Driver 第三步:添加配置类 // 该配置类用于配置自动扫描器,用于扫描自定义的mapper接口,MyBatis会针对这些接口生成代理来调用对应的XMl中的SQL @Configuration @MapperScan("com.example.springbootdemo.mapper") public

SpringBoot系列(十一)拦截器与拦截器链的配置与使用详解,你知道多少?

半腔热情 提交于 2020-04-28 16:14:08
往期推荐 SpringBoot系列(一)idea新建Springboot项目 SpringBoot系列(二)入门知识 springBoot系列(三)配置文件详解 SpringBoot系列(四)web静态资源配置详解 SpringBoot系列(五)Mybatis整合完整详细版 SpringBoot系列(六)集成thymeleaf详解版 Springboot系列(七) 集成接口文档swagger,使用,测试 SpringBoot系列(八)分分钟学会Springboot多种解决跨域方式 SpringBoot系列(九)单,多文件上传的正确姿势 SpringBoot系列(十)优雅的处理统一异常处理与统一结果返回 目录 1. 拦截器介绍 2.自定义拦截器 3.拦截器注入适配器 4.controller测试 5. 测试 6. 扩展内容:拦截器链 7. 总结 1. 拦截器介绍  拦截器是在servlet执行之前执行的程序(这里就是controller代码执行之前),它主要是用于拦截用户请求并作相应的处理,比如说可以判断用户是否登录,做相关的日志记录,也可以做权限管理。  SpringBoot中的拦截器实现和spring mvc 中是一样的,它的大致流程是,先自己定义一个拦截器类,并将这个类实现一个 HandlerInterceptor 类,或者是继承

从0开始学习接口自动化测试(一)

烂漫一生 提交于 2020-04-28 12:49:25
从0开始学习接口自动化测试 感兴趣的小伙伴可以加入QQ群:556029945 前言  最近项目空档期,寻思着反正没什么事情,不如把自己做过的东西做一些总结,然后找个地方记录一下,给测试行业的入门的小伙伴们看一下,点点点到了一定的时候,就想做点觉得高大上的技术(自动化测试),但是会很懵逼,不知道从何开始,就想如果有个人带带就不错,所以希望这些总结能够给你们一些启示。<br>  说明一下,本文是讲述如何开展自动化测试,更多的一个自动化测试实践,而不是框架,如果是框架学习的同行或爱好者,请私下联系交流。本文主要是讲的接口相关的,不是属于UI的,所以如果想了解UI自动化测试的,也可以私下交流,主要是考虑到点点点都是UI的,想必大家都不陌生。 什么是接口  原谅我也要百度一发,接口的概念,百度百科里面说: 接口(硬件类接口)是指同一计算机不同功能层之间的通信规则称为接口。 接口(软件类接口)是指对协定进行定义的引用类型。其他类型实现接口,以保证它们支持某些操作。接口指定必须由类提供的成员或实现它的其他接口。与类相似,接口可以包含方法、属性、索引器和事件作为成员。 看完之后不经说一声,我还是不懂,到底什么事接口。<br> 我们来看一下开发同事提供的接口文档,看能不能知道什么是接口,最后发现公司业务属于机密,不便公开,脱敏有需要修改数据,挺麻烦,还好网上有人分享了一个swagger的

试试使用 eolinker 扫描 GitLab 代码注释自动生成 API 文档?

泄露秘密 提交于 2020-04-28 05:12:51
前言: 一般写完代码之后,还要将各类参数注解写入API文档,方便后续进行对接和测试,这个过程通常都很麻烦,如果有工具可以读取代码注释直接生成API文档的话,那会十分方便。 此前一直都是在使用eolinker的,但自从去年他们家“注释生成文档”的功能下线后,我就一直活在水深火热当中——真的不想写文档啊,真的好累啊。 然而这两天上线后,突然发现这个功能重新上线了!必须给大家安利一波! 官网地址: https://www.eolinker.com 根据官方的解释,这个功能简单来说就是读取 gitlab(以前应该还能读本地代码) 的 php 代码(截至发文增加支持读取java,更方便了)注释生成 API 文档。 下面是官方的操作介绍: 1.先在EOLINKER新建项目,随后进入项目概况页,可以在概况页中找到“扫描代码注解生成文档”模块。 2.在同步之前我们打开设置看下需要填写什么信息。 总共是10个选项,我们来分别看下需要怎么填写: 1.代码仓库类型,现在默认只有gitlab,在官方群问了他们的PM,后面应该还会支持github。 2.代码仓库地址,gitlab有线上版本和用户自己搭建私有云版本,线上版本可以填写 https://gitlab.com,如果是自己部署的gitlab写域名或者IP端口。 3.项目ID,gitlab中新建项目后会有一个project ID,填入即可。 4

SpringBoot系列(十)优雅的处理统一异常处理与统一结果返回

≯℡__Kan透↙ 提交于 2020-04-27 12:41:56
SpringBoot系列(十)统一异常处理与统一结果返回 往期推荐 SpringBoot系列(一)idea新建Springboot项目 SpringBoot系列(二)入门知识 springBoot系列(三)配置文件详解 SpringBoot系列(四)web静态资源配置详解 SpringBoot系列(五)Mybatis整合完整详细版 SpringBoot系列(六)集成thymeleaf详解版 Springboot系列(七) 集成接口文档swagger,使用,测试 SpringBoot系列(八)分分钟学会Springboot多种解决跨域方式 SpringBoot系列(九)单,多文件上传的正确姿势 目录 1. 全局异常捕获与处理 2. 统一结果返回与统一异常 3. controller代码测试与结果 4. 404异常特殊处理。 5. 总结 引言 :  日常开发过程中,难免有的程序会因为某些原因抛出异常,而这些异常一般都是利用try ,catch的方式处理异常或者throw,throws的方式抛出异常不管。这种方法对于程序员来说处理也比较麻烦,对客户来说也不太友好,所以我们希望既能方便程序员编写代码,不用过多的自己去处理各种异常编写重复的代码又能提升用户的体验,这时候全局异常处理就显得很重要也很便捷了,是一种不错的选择。 1. 全局异常捕获与处理  因为现在主流的都是 前后端分离 的项目

SpringBoot系列(十)优雅的处理统一异常处理与统一结果返回

☆樱花仙子☆ 提交于 2020-04-27 11:10:40
SpringBoot系列(十)统一异常处理与统一结果返回 往期推荐 SpringBoot系列(一)idea新建Springboot项目 SpringBoot系列(二)入门知识 springBoot系列(三)配置文件详解 SpringBoot系列(四)web静态资源配置详解 SpringBoot系列(五)Mybatis整合完整详细版 SpringBoot系列(六)集成thymeleaf详解版 Springboot系列(七) 集成接口文档swagger,使用,测试 SpringBoot系列(八)分分钟学会Springboot多种解决跨域方式 SpringBoot系列(九)单,多文件上传的正确姿势 目录 1. 全局异常捕获与处理 2. 统一结果返回与统一异常 3. controller代码测试与结果 4. 404异常特殊处理。 5. 总结 引言 :  日常开发过程中,难免有的程序会因为某些原因抛出异常,而这些异常一般都是利用try ,catch的方式处理异常或者throw,throws的方式抛出异常不管。这种方法对于程序员来说处理也比较麻烦,对客户来说也不太友好,所以我们希望既能方便程序员编写代码,不用过多的自己去处理各种异常编写重复的代码又能提升用户的体验,这时候全局异常处理就显得很重要也很便捷了,是一种不错的选择。 1. 全局异常捕获与处理  因为现在主流的都是 前后端分离 的项目