环境配置和第一个api的开发

59 阅读3分钟

环境配置

visual studio的安装

打开浏览器,下载visual studio社区版(不可商用)

需要选asp.net和web开发

选择开发模板时需要选择带有(MVC)框架的模板/或asp.net core empty模板 [VS官网](Visual Studio 2022 IDE - 适用于软件开发人员的编程工具 (microsoft.com))

.NETsdk的安装

[.net官网](下载 .NET(Linux、macOS 和 Windows) (microsoft.com))

主要文件的介绍

appsettings.json

此文件保存的信息是项目运行时设置,包括但不限于:数据库的连接信息,第三方的账号密码, token

properties/launchSettings.json

处理项目的启动信息,包含端口的设置等

program.cs

Program中定义了Main函数,所以ASP.NET Core的应用程序实际上就是一个console app。主函数只通过使用CreateDefaultBuilder方法,创建并且运行了一个虚拟网站托管主机WebHost,创建托管服务器时,CreateDefaultBuilder做了四件事:

  • 第一,加载主机和应用程序的配置表信息
  • 第二,配置日志记录
  • 第三,设置Web服务器
  • 第四,设置Asp.NetCore应用程序的托管形式。

program.cs的源码

github.com/aspnet/Meta…

  • 首先,查看运行环境,依照运行环境使用appsetting.json覆盖运行设置。
  • 然后,加载assembly程序集,运行系统所有的核心代码。
  • 接着,设置日志、以及系统的上下文对象信息context。最后,运行虚拟主机的创建程序

startup.cs

处理配置信息,如注入依赖、配置中间件、处理请求通道,都会使用startup文件来进行管理 主要有两个作用:

  • 第一,在ConfigureServices方法中,注入各种服务组件的依赖。
  • 第二,在Configure方法中,创建中间件middleware、设置请求通道request pipeline。

http请求通道

首先检查和处理请求(用户是否登录,请求是否正确等),然后交由中间件处理,

调用开始,loggin,static files,MVC,MVC中间件可以对请求进行短路处理(在MVC处处理并return) 请求通道通过IApplicationBuilder创建,每个中间件都可以截获、修改、传递请求对象,特定情况下,某些中间件可以对请求短路处理,直接向前端输出

环境变量

环境分为: 开发环境Development 集成环境Intergration 测试环境Testing 预发布环境Staging 生产环境Production 项目名称->properties->debug->environment variables

MVC的添加与第一个控制器的创建

添加中间件与服务依赖

首先,需要给项目注册mvc框架依赖,还要添加mvc中间件启动路由。
打开startup.cs,ConfigureServices,service.addControllers()

Config函数中,需要将mvc中间件加入请求通道,来处理http的请求的路由。endpoints中:endpoints.MapControllers();

创建API

创建controller文件夹,右键点击,new item,api controller 运行即可

手动创建API

创建文件,new item,class, 添加API路径[Route("api/shoudongAPI")],添加引用文件,选择MVC。 添加http get api接口 配置类,把普通的类转化为controller。通过三种方法 1.加上controller结尾 2.加上[controller] attribute 3.继承 : controller或controllerBase

注意:在controller中,控制器类本身,action函数,只要涉及到http请求的外部访问,则一定要使用public关键词。