.Net Core3.0 WebApi 项目框架搭建:目录 为什么使用Swagger 随着互联网技术的发展,现在的网站架构基本都由原来的后端渲染,变成了:前端渲染.后端分离的形态,而且前端技术和后端技术在各自的道路上越走越远. 前端和后端的唯一联系,变成了API接口:API文档变成了前后端开发人员联系的纽带,变得越来越重要,swagger就是一款让你更好的书写API文档的框架. 没有API文档工具之前,大家都是手写API文档的,在什么地方书写的都有,有在confluence上写的,有在对应的项目…

一.目录 .Net Core3.0 WebApi 项目框架搭建 一:实现简单的Resful Api .Net Core3.0 WebApi 项目框架搭建 二:API 文档神器 Swagger .Net Core3.0 WebApi 项目框架搭建 三:读取appsettings.json .Net Core3.0 WebApi 项目框架搭建 四:JWT权限验证 .Net Core3.0 WebApi 项目框架搭建 五:仓储模式 二.Git地址 https://github.com/huguodon…

.Net Core3.0 WebApi 项目框架搭建:目录 什么是JWT 根据维基百科定义,JWT(读作 [/dʒɒt/]),即JSON Web Tokens,是一种基于JSON的.用于在网络上声明某种主张的令牌(token).JWT通常由三部分组成: 头信息(header), 消息体(payload)和签名(signature).它是一种用于双方之间传递安全信息的表述性声明规范.JWT作为一个开放的标准(RFC 7519),定义了一种简洁的.自包含的方法,从而使通信双方实现以JSON对象的形式…

.Net Core3.0 WebApi 项目框架搭建:目录 SqlSugar介绍 SqlSugar是国人开发者开发的一款基于.NET的ORM框架,是可以运行在.NET 4.+ & .NET CORE的高性能.轻量级 ORM框架,众多.NET框架中最容易使用的数据库访问技术.官网http://www.codeisbug.com/Doc/8 SqlSugar的优点: 1.高性能 ,不夸张的说,去掉Sql在数据库执行的时间,SqlSugar是EF数倍性能,另外在批量操作和一对多查询上也有不错的SQL优…

.Net Core3.0 WebApi 项目框架搭建:目录 开发环境 Visual Studio 2019.net core 3.1 创建项目 新建.net core web项目,如果没有安装.net core sdk的使用vs2019的安装中心安装,这里默认已经安装了.net core 3.1 此处我们选择API(选择API系统会为我们自动创建WebApi需要的一些配置文件等),Https配置这一项我们暂时不勾选,目前我们不配置Https. 点创建以后的界面如下图: Program.cs 说明…

.Net Core3.0 WebApi 项目框架搭建:目录 appsettings.json 我们在写项目时往往会把一些经常变动的,可能会变动的参数写到配置文件.数据库中等可以存储数据且方便配置的地方,这样会方便我们在项目上线以后做相对应的配置工作. .Core WebApi项目中我们将把配置文件统一放在appsettings.json文件中,我们将将写一个读取配置文件的公用类. 新建公共类库 新建类库Webapi.Core.Common,用来存放一些公用的方法 我这里新建了一个Helper文件…

.Net Core3.0 WebApi 项目框架搭建:目录 理论介绍 仓储(Respository)是存在于工作单元和数据库之间单独分离出来的一层,是对数据访问的封装.其优点: 1)业务层不需要知道它的具体实现,达到了分离关注点. 2)提高了对数据库访问的维护,对于仓储的改变并不会改变业务的逻辑,数据库可以用Sql Server(该系列博客使用).MySql等. 基本项目架构 Common 公共组件层,存放一些公共的方法 Model 实体Model数据层,Enity文件夹中,存放的是整个项目的数…

前后端分离的工作模式于今是非常流行了,前后端工作的对接,就离开不了API文档的辅助. 根据自己以往的工作经历,以及了解的一些资讯,API文档的建立,无非以下几种方式: 1. word文档模板 2. 第三方平台,类如postman.showdoc等 3. 框架内单独自定义一套绑定路由的结构,再解析成html页面 4. 在框架内每个路由的方法的注释块里按照规则写注释,再解析生成api文档 5. 框架内直接编辑markdown文件,再转换成html页面 根据自己的使用心得,发表一下个人看法. 1.wo…

使用Swagger自动生成API文档,不仅增加了项目的可维护性,还提高了API的透明度更利于快速测试等工作,便于更快地发现和解决问题. 本篇文章只记录整合过程,关于Security Configuration等其他特性这里就不展开讲了,感兴趣的可以通过以下链接了解更多. 参考文档: https://howtodoinjava.com/swagger2/swagger-spring-mvc-rest-example/ http://www.baeldung.com/swagger-2-docume…

前言 运行环境: vagrant 2.2.4 virtualbox 6.0 box bento/ubuntu-16.04 (Apache 2.4.18 + Mysql 5.7.26 + PHP 5.6.40) phpDocumentor phpDocumentor 2 是一个尽可能的通过你的PHP源码来生成文档的工具. 通过 Codeigniter项目applicaiton下控制器和模型 2个文件夹的源码来生成 api文档 vagrant@vagrant:~$ phpdoc -V phpDocu…