RESTful架构中的webapi

通过webAPI在server端开发一个借口，在client端调用此借口的完整过程。

(VS2010版本如果包括MVC4也可以创建webAPI，或者vs2012及以上版本）

运行环境：VS2017

开发语言：c#

一、server端

1.创建webapi项目，打开vs2017-文件-新建-项目。

2.在项目中添加Controllers和Models两个文件夹，分别用于存放控制器类和实体类。

在Controllers文件夹中添加API控制器类。

控制类添加完成后，会自动生成，GET,POST,PUT,DELETE四个方法。

通过地址确定方法：

get方式：http://IP地址：端口号/api/控制器名称

post方式：[HttpGet("方法标识名称")] http://IP地址：端口号/api/控制器名称/方法标识名称

添加一个方法，在方法中描述接口需要完成的 *** 作以及返回值。

需要注意事项：

1）传进来参数的数据类型必须与接收的数据类型相同。

二、client端

1.添加控制台应用程序用来测试调用接口是否成功。

2.定义一个方法用来调用接口并返回数据。

3.定义一个restful接口帮助类。

先定义一个简单的webapi，简单到差不多直接用vs2010自动生成的webapi代码。

其中的TestModle是一个简单的class，如下

public class TestModle

{

public string a { getset}

public string b { getset}

public string c { getset}

}

前端页面放四个代表get，post，put，delete的按钮，在加一个div显示返回值

前端代码中加载jquery，在定义四个按钮的click事件

get和post，我习惯用$.get和$.post，当然也能用$.ajax.

get直接返回webapi get的return值，post的话我就不在后端做处理了直接返回传入的值，这里只做示范

put和delete，只能用$.ajax来处理。

put的话一般用于update某个id的数据信息

delete用于删除某个id的数据，如下图所示

点击每个按钮，可以在页面上看到相应的效果

Visual Studio 2019

.net core 3.0

具体步骤如下图：

此处我们选择API(新手不推荐选择空项目，选择API系统会为我们自动创建WebApi需要的一些配置文件等)，Https配置这一项我们暂时不勾选，目前我们不配置Https。

F5运行项目，然后就可以看到微软为我们写好的一个天气预报示例webapi了，这里只有一个Get请求示例，返回值为json格式。

注意： services.AddControllers()和 endpoints.MapControllers() 方法成对出现, 这是.net core3.0中的最新写法

ConfigureServices方法

用来向容器中注册服务,注册好的服务可以在其他地方进行调用.

Configure方法

用来配置中间件管道,即如何响应http请求.

1 右键删除系统默认创建的 WeatherForecastController.cs 和 WeatherForecast.cs

2 新建一个控制器，命名： UserController.cs

问题来了，为啥直接给打开 weatherforecast ，而且还404了，别急，往下看。

(┬＿┬)怎么还是404？别急继续往下看

上面增加 action 虽然能达到想要的结果，但是每次新建一个 Controller 都有写个 action 万一要是忘记了又要忙乎半天，有没有一劳永逸的办法呢？

继续往下看：

1.首先去掉Controller里的 Route 和 ApiController

2.修改 Startup.cs ，增加路由模版：

今天就到这里，后期继续完善我们的webapi。

https://github.com/xiaxiaoqian/NetCore3.0-WebApi

---