swagger

（1） 相关博文地址： SpringBoot + Vue + ElementUI 实现后台管理系统模板 -- 前端篇（一）：搭建基本环境：https: // www.cnblogs.com/l-y-h/p/12930895.html SpringBoot + Vue + ElementUI 实现后台管理系统模板 -- 前端篇（二）：引入 element-ui 定义基本页面显示：https: // www.cnblogs.com/l-y-h/p/12935300.html SpringBoot + Vue + ElementUI 实现后台管理系统模板 -- 前端篇（三）：引入 js-cookie、axios、mock 封装请求处理以及返回结果：https: // www.cnblogs.com/l-y-h/p/12955001.html SpringBoot + Vue + ElementUI 实现后台管理系统模板 -- 前端篇（四）：引入 vuex 进行状态管理、引入 vue-i18n 进行国际化管理：https: // www.cnblogs.com/l-y-h/p/12963576.html SpringBoot + Vue + ElementUI 实现后台管理系统模板 -- 前端篇（五）：引入 vue-router 进行路由管理、模块化封装 axios 请求、使用

目录 一、Spring起步 学习路线图 Spring的基础知识 什么是Spring Spring框架核心模块 SpringBoot 第一个Spring应用DEMO 编写自己的第一个SpringMVC例子 尝试使用Spring Boot DevTools Spring起步小结 二、基于SpringMVC开发web应用 创建数据模型 创建业务逻辑 创建控制器 设计视图模板 运行Web应用 表单校验 展现校验错误 基于SpringMVC开发web应用小结 三、实现数据持久化 数据库 建立用户信息登记表 Web应用项目集成mysql 使用JdbcTemplate实现数据持久化 再次运行Web应用 实现数据持久化小结 四、使用Spring Data实现数据持久化 Spring Data 四、使用Spring Data JPA持久化数据 添加JPA starter依赖 修改实体类，添加JPA映射注解 声明JPA repository接口 服务层repository 再次运行Web应用 自定义JPA repository 服务层增加查找接口 控制器增加用户查找功能 视图层增加用户查找页面 查找功能测试 使用Spring Data实现数据持久化小结 五、使用Spring Security安全框架保护web应用 启用Spring Security Spring Security的基本登录认证

springboot 版本 2.0.8.RELEASE <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>2.0.8.RELEASE</version> <type>pom</type> <scope>import</scope> </dependency> 参考文章： https://nacos.io/zh-cn/docs/quick-start-spring-cloud.html 是使用Nacos Spring Cloud方式配置的，为什么是不使用springboot ,因为springboot加代码，自己手动注册。 服务端用的是1.1.4，因为1.2.0要用户认证 1、配置 1.1添加依赖包 <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId> <version>0.2.1.RELEASE</version> </dependency> 1.2添加文件bootstrap.properties，内容

原文: ASP.NET Core 使用 AutoFac 注入 DbContext DI 1.0 —— 通过 RegisterInstance 注入 一开始，并不是很懂 AutoFac 的用法，又因为要使用特定的构造器和参数来初始化 DbContext ，所以我想到的办法就是使用 RegisterInstance ，代码如下： var optionsBuilder = new DbContextOptionsBuilder<BookListDbContext>(); optionsBuilder.UseMySql(connectionString, b => b.MigrationsAssembly( "BookList.Domain" )); // SingleInstance 就是单例模式，现在想起来当时写的好智障 containerBuilder.RegisterInstance( new BookListDbContext(optionsBuilder.Options)).SingleInstance(); 一开始在本地用 Swagger 一个一个的调试 api 的感觉还很好，没啥问题，后来前端同学把 js 加上，就会经常的出现 404。经过 debug 发现，是 DbContext 出现了冲突，多个请求同时访问同一个 DbContext 对象，造成异常

在实际开发过程中，前后端分离后，那么势必存在如何在多人协作中共享和及时更新API开发接口文档的问题，维护接口文档就变成了必不可少的工作，在初期开发的时候接口一直处在变化中，每次接口更新，都要去单独维护接口文档，做过的老铁都知道这是一件多么令人脑瓜子疼得事。使用swagger2集成文档，有多个优势: 功能丰富 ：支持多种注解，自动生成接口文档界面，支持在界面测试API接口功能； 及时更新 ：开发过程中养成写注释的习惯，就可以及时的更新API文档； 整合简单 ：通过添加pom依赖和简单配置，内嵌于应用中就可同时发布API接口文档界面，不需要部署独立服务。 引入依赖 首先是创建一个Spring Boot项目，引入web依赖，引入swagger2相关的依赖，如下： web依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> swagger2依赖 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency>

　　 引言 　　在 上一篇 中提到了 Swagger 的基本使用，仅限于没有参数，没有验证的那种api文档生成，那么这篇就连接上篇继续，在一般具有安全性、权限等验证的接口上， 　　都会在header/url中加上请求者的秘钥、签名等，当然也有可能添加到body等其它地方， Swashbuckle.AspNetCore 都支持这些写法。 　　 如何使用 -- 下面将介绍两种使用方式 两种方式参数设置到何处都是在 In 属性 上，属性对于值如下： 参考 https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#parameter-object query： 参数字段值对应放在url中 header： 参数值对应放在header param中 body： 参数对应放到请求体中 path： 参数应该对应放到请求路径 // 具体貌似没用 formData： 参数对应放到请求表单中 　　 第一种：将一个或多个参数保护API的“securityDefinitions”添加到生成的Swagger中。 这种是直接在文档的右上方添加一个 Authorize 按钮，设置了值后，每一个请求都会在设置的位置上加上相应的值，在 上一篇随笔中的 ConfigureServices 方法中， 对应位置 services

上一篇文章( https://www.cnblogs.com/meowv/p/12909558.html )完善了项目中的代码，接入了Swagger。本篇主要使用Entity Framework Core完成对数据库的访问，以及使用Code-First的方式进行数据迁移，自动创建表结构。 数据访问 在 .EntityFrameworkCore 项目中添加我们的数据访问上下文对象 MeowvBlogDbContext ，继承自 AbpDbContext<T> 。然后重写 OnModelCreating 方法。 OnModelCreating ：定义EF Core 实体映射。先调用 base.OnModelCreating 让 abp 框架为我们实现基础映射，然后调用 builder.Configure() 扩展方法来配置应用程序的实体。当然也可以不用扩展，直接写在里面，这样一大坨显得不好看而已。 在abp框架中，可以使用 [ConnectionStringName] Attribute 为我们的DbContext配置连接字符串名称。先加上，然后再在 appsettings.json 中进行配置，因为之前集成了多个数据库，所以这里我们也配置多个连接字符串，与之对应。 本项目默认采用MySql，你可以选择任意你喜欢的。 //MeowvBlogDbContext.cs using

@Api：用在请求的类上，表示对类的说明 tags="说明该类的作用，可以在UI界面上看到的注解" value="该参数没什么意义，在UI界面上也看到，所以不需要配置" @ApiOperation：用在请求的方法上，说明方法的用途、作用 value="说明方法的用途、作用" notes="方法的备注说明" @ApiImplicitParams：用在请求的方法上，表示一组参数说明 @ApiImplicitParam：用在@ApiImplicitParams注解中，指定一个请求参数的各个方面 name：参数名 value：参数的汉字说明、解释 required：参数是否必须传 paramType：参数放在哪个地方 · header --> 请求参数的获取：@RequestHeader · query --> 请求参数的获取：@RequestParam · path（用于restful接口）--> 请求参数的获取：@PathVariable · body（不常用） · form（不常用） dataType：参数类型，默认String，其它值dataType="Integer" defaultValue：参数的默认值 @ApiResponses：用在请求的方法上，表示一组响应 @ApiResponse：用在@ApiResponses中，一般用于表达一个错误的响应信息 code：数字

@ApiModel希望Swagger生成的文档出现返回的内容注释，发现需要用到@ApiModel注解到你需要返回的类上 @ApiModelProperty作为字段的描述 例如 之后文档还是不显示返回内容的注释， 原来是因为封装的返回类没做泛型 需要加入泛型 封装的返回类加入泛型之后，还需要在你Controller返回的数据也加上泛型，不然还是展示不出来的 这样，返回的数据就带上注释了 完美解决了返回内容不带注释的问题 来源： oschina 链接： https://my.oschina.net/u/4303238/blog/4439783

线下培训机构如何低成本实现在线知识付费,并拥有自主 独立域名的在线教育系统网站 ，领课在线教育系统支持PC端和移动端小程序播放,可满足各类在线教学需求。 领课教育系统 - 技术说明文档 1. 技术架构图 后台技术说明： 分布式微服务架构 注册中心： Netflix Eureka 配置中心： Spring Cloud Config 服务网关： Netflix Zuul 客服端负载均： Netflix Ribbon 数据库连接池： Alibaba Druid 链路追踪： Spring Cloud Sleuth + Zipkin 应用管理： Spring Boot Admin 文档框架： Swagger 持久层框架： Mybatis 模板引擎： Freemarker 注：列出主要组件，其他组件因太多，不一一列出 前台技术说明： 前后端分离架构 Vue.js： 渐进式技术栈，足以应付任何规模的应用。 Nuxt.js： 服务端渲染，有效地解决单页面应用的 SEO 的问题。 2. 应用架构图 来源： oschina 链接： https://my.oschina.net/u/4386758/blog/4277191