这里局限于Asp.net core Web API。
简单一句话,就是webApi支持我们专注于数据,返回值可以直接返回对象。且支持RestFul风格的编程。RestFul编程就是
- 资源(Resource):将所有的数据和功能都视为资源,每个资源都有唯一的URL标识,客户端通过URL来访问资源。
- 统一接口(Uniform Interface):定义一组统一的接口规范,使得不同的资源可以通过相同的HTTP方法(GET、POST、PUT、DELETE等)来进行操作。
- 无状态(Stateless):每个请求都包含足够的信息,服务器不保存客户端的状态,即请求之间不会有依赖关系。
- 自描述(Self-descriptive):请求和响应的内容应该是自描述的,客户端通过响应内容中的数据格式(如JSON、XML等)来理解资源的表示。
- 按需请求(Client-Server):客户端和服务器之间的通信是独立的,客户端可以根据需求选择性地请求资源。
在VS中如何创建
1)打开vs2022,然后选择webapi项目
2)输入自己想要的项目名称
3)其他信息那边设置如下
如果这几个选项勾选是什么意思呢?
1)身份验证类型
身份验证有三个选项:无、Microsoft 标识平台、Windows。
Microsoft 标识平台:用于微软云服务器验证;
Windows:用于计算机策略标识验证。
这两个我们平常会用在公司内部的项目,限定特定计算机的访问,可以增加系统的安全性。
2)配置Https
在入口文件多了Https配置代码,这个配置作用:访问Http会自动重定向至Https
在program代码中会有
然后在调试配置软件中会增加https的配置信息
3)启动docker
这个就是用于docker配置部署用的。操作系统可以选择windows和linux
4)使用该控制器
项目会在启动后新建一个Controllers的文件夹,原本在入口文件的接口代码会迁移到控制器中。
----------------------------->
其他内容会在控制器中了。
5)启用openAPI
增加了Swagger的注入依赖。并启用了Swagger。
UseSwaggerUI是开启了Swagger为默认启动页面
6)顶级语句
勾选顶级语句后,创建后的代码,会增加Main方法
仅以上告诉初学者该怎么创建一个webapi,具体的使用后续会进行增加。