使用ASP.NET Web API构建Restful API

更新时间：2022年04月26日 10:16:16 作者：農碼一生

这篇文章介绍了使用ASP.NET Web API构建Restful API的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下

一、前言

RESTful API 是基于HTTP协议产生的一种相对简单的API设计方案；

RESTful 的核心是 everything is a “resource”，所有的HTTP action，都应该是相应resource上可以被操作和处理的，而API 就是对资源的管理操作，而这个具体操作是由 HTTP action 指定的。

使用HTTP的GET、POST、DELETE、PUT来表示对于资源的增删改查。

GET：读取（Read）
POST：新建（Create）
PUT：更新（Update）
DELETE：删除（Delete）

学习资料准备：

（1）用于测试的实体类：

public class Student
{
    public string StuNo { get; set; }    //学号
    public string StuName { get; set; }  //姓名
    public string StuSex { get; set; }   //性别
}

（2）模拟的测试数据（编写在webapi类的构造函数中）：

public static List<Student> StuList { get; set; }
public ServerController()
{
    StuList = new List<Student>();
    StuList.Add(new Student { StuNo = "001", StuName = "孙悟空", StuSex = "男" });
    StuList.Add(new Student { StuNo = "002", StuName = "猪八戒", StuSex = "男" });
    StuList.Add(new Student { StuNo = "003", StuName = "白骨精", StuSex = "女" });
}

二、获取所有数据

API接口：

[HttpGet]
public List<Student> GetList([FromBody]dynamic obj)
{
	return StuList;
}

三、获取详情

API接口：

[HttpGet]
public Student GetDetail(string id)
{
	Student stu = StuList.SingleOrDefault(p => p.StuNo.Equals(id));
	return stu;
}

四、新增数据

API接口：

[HttpPost]
public IHttpActionResult Add([FromBody] Student stu)
{
    StuList.Add(stu);
    return Json(new { msg = "添加成功!",data=StuList });
}

五、修改数据

API接口：

[HttpPut]
public IHttpActionResult Update(string id, [FromBody] Student stu)
{
    Student model = StuList.SingleOrDefault(p => p.StuNo.Equals(id));
    if (model == null)
    	return Json(new { msg = "修改的数据不存在!" });
    model.StuNo = stu.StuNo;
    model.StuName = stu.StuName;
    model.StuSex = stu.StuSex;
    return Json(new { msg = "修改成功!", data = model });
}

六、删除数据

API接口：

[HttpDelete]
public IHttpActionResult Delete(string id)
{
    Student model = StuList.SingleOrDefault(p => p.StuNo.Equals(id));
    if (model == null)
    	return Json(new { msg = "删除的数据不存在!" });
    StuList.Remove(model);
    return Json(new { msg = "删除成功!", data = StuList });
}

七、特性路由

(1) 基本路由映射

API接口：

[HttpGet]
[Route("api/Route/Basic")]
public IHttpActionResult GetBasic()
{
	return Json(new { msg = "测试基本的特性路由!" });
}

接口访问地址：

http://localhost:60650/api/Route/Basic

(2) 路由映射参数

API接口：

[HttpGet]
[Route("api/Route/Param/{id}/{name}")]
public IHttpActionResult Get2(string id,string name)
{
	return Json(new { msg = "测试路由映射参数!",data = new { id= id,name=name } });
}

接口访问地址：

http://localhost:60650/api/Route/Param/001/孙悟空

(3) 多重特性路由

API接口：

[HttpGet]
[Route("api/Route/Multiple1/{id}/{name}")]
[Route("api/Route/Multiple2/{id}/{name}")]
public IHttpActionResult Get3(string id,string name)
{
	return Json(new { msg = "测试多重特性路由!",data = new { id= id,name=name } });
}

接口访问地址：

http://localhost:60650/api/Route/Multiple1/001/孙悟空

或

http://localhost:60650/api/Route/Multiple2/001/孙悟空

(4) 缺省参数路由

API接口：

[HttpGet]
[Route("api/Route/Default/{id}/{name?}")]
public IHttpActionResult Get4(string id, string name="孙悟空")
{
    return Json(new { msg = "测试缺省参数路由!", data = new { id = id, name = name } });
}

或

[HttpGet]
[Route("api/Route/Default/{id}/{name=孙悟空}")]
public IHttpActionResult Get4(string id, string name)
{
	return Json(new { msg = "测试缺省参数路由!", data = new { id = id, name = name } });
}

接口访问地址：

http://localhost:60650/api/Route/Default/001

(5) 参数约束路由

ASP.NET Web API内置约束有下面这些：

{x:alpha} 约束大小写英文字母
{x:bool}
{x:datetime}
{x:decimal}
{x:double}
{x:float}
{x:guid}
{x:int}
{x:length(6)}
{x:length(1,20)} 约束长度范围
{x:long}
{x:maxlength(10)}
{x:min(10)}
{x:range(10,50)} //约束值的范围
{x:regex(正则表达式)}

可以设置多个约束：

[Route("api/Route/orders/{id:int:min(1)}")]

API接口：

[HttpGet]
[Route("api/Route/Check/{id:range(1,100)}/{name}")]
public IHttpActionResult Get5(int id, string name)
{
	return Json(new { msg = "测试参数约束路由!", data = new { id = id, name = name } });
}

接口访问地址：（以下地址可以正常访问接口）

http://localhost:60650/api/Route/Check/11/孙悟空

接口访问地址：（以下地址无法访问接口）

http://localhost:60650/api/Route/Check/101/孙悟空

(6) 通配符(*)路由变量

API接口：

[HttpGet]
[Route("api/Route/Date/{id:range(1,100)}/{name}/{*birthday}")]
public IHttpActionResult Get6(int id, string name,DateTime birthday)
{
	return Json(new { msg = "*使用!", data = new { id = id, name = name,birthday = birthday.ToString("yyyy年MM月dd日") } });
}

接口访问地址：

http://localhost:60650/api/Route/Date/1/jack/1988-8-8

接口访问地址：（此地址如果在路由中没有*则无法访问，因为程序会认为“1988/8/8”是三个参数，而不是一个参数）

http://localhost:60650/api/Route/Date/1/jack/1988/8/8

(7) 路由映射复杂参数

给实体类添加特性使其支持绑定：

[ModelBinder]
public class Student
{
	public string StuNo { get; set; }    //学号
	public string StuName { get; set; }  //姓名
	public string StuSex { get; set; }   //性别
}

方案一API接口：

[HttpGet]
[Route("api/Route/Class/{stu.StuNo}/{stu.StuName}/{stu.StuSex}")]
public IHttpActionResult Get7(Student stu)
{
	return Json(new { msg = "路由映射复杂参数!", data = stu });
}

方案一接口访问地址：

http://localhost:60650/api/Route/Class/001/jack/man

方案二API接口：

[HttpGet]
[Route("api/Route/Class")]
public IHttpActionResult Get7(Student stu)
{
	return Json(new { msg = "路由映射复杂参数!", data = stu });
}

方案二接口访问地址：

http://localhost:60650/api/Route/Class?stu.StuNo=001&stu.StuName=jack&stu.StuSex=man

(8) 路由前缀

在控制器类上定义路由前缀：

[RoutePrefix("api/Prefix")]
public class PrefixController : ApiController
{

}

路由前缀API接口：

[Route("Basic")]
public IHttpActionResult Get1()
{
	return Json(new { msg = "测试路由前缀!" });
}

接口访问地址：

http://localhost:60650/api/Prefix/Basic

取消路由前缀API接口：

[Route("~/api/Cancel/Basic")]  //通过~/取消路由前缀
public IHttpActionResult Get2()
{
	return Json(new { msg = "取消路由前缀!" });
}

接口访问地址：

http://localhost:60650/api/Cancel/Basic

到此这篇关于使用ASP.NET Web API构建Restful API的文章就介绍到这了。希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

.NET Core 实现微信小程序支付功能（统一下单）
最近公司研发了几个电商小程序，还有一个核心的电商直播，只要是电商一般都会涉及到交易信息，离不开支付系统，这里我们统一实现小程序的支付流程。感兴趣的朋友跟随小编一起看看吧
2019-09-09
ASP.NET环境下为网站增加IP过滤功能
通过深入的交流和沟通，确认了该发电厂在企业网站用户访问控制方面的改进要求
2009-06-06
asp.net 弹出警告窗口实现代码
提供一个可选“是”“否”的弹出窗口，若选是，则跳到url1,选否则跳到url2
2009-07-07
Asp.net cookie的处理流程深入分析
一说到Cookie我想大家都应该知道它是一个保存在客户端，当浏览器请求一个url时，浏览器会携带相关的Cookie达到服务器端,需要的朋友可以了解下
2012-12-12
获取Repeter的Item和ItemIndex/CommandArgument实现思路与代码
Repeater控件，放在ItemTemplate内的铵钮OnClick之后，获取Repeater的Item，ItemIndex，CommandArgument，CommandName以及绑定的字段值附演示动画感兴趣的朋友可以了解下
2013-01-01
asp.net的公共变量声明问题（解决）
前段时间有个项目中登录的时候碰到了声明公共变量的情况，用户类型分为二种类型，所以不同类型用户登录的时候所走的情况不一样，目前用AB分别代表二类用户。
2013-03-03
.NET Core 实现缓存的预热的方式
本文介绍了缓存预热在.NETCore应用中的重要性以及如何实现缓存预热,缓存预热可以提升用户体验、降低数据库压力、提高系统稳定性,感兴趣的朋友一起看看吧
2025-03-03
SqlDataSource 链接Access 数据
如何用AccessDataSource链接有密码的access数据库总是会报错，替代方法是用SqlDataSource 链接Access 数据。
2009-04-04
.net core EF Core调用存储过程的方式
这篇文章主要给大家介绍了关于.net core EF Core调用存储过程的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用.net core EF Core具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-05-05
.net 弹出消息框后导致页面样式变乱解决方法
点击按钮，执行提交操作，弹出消息框后，页面的样式变乱，已经确定了不是css样式的问题，接下来与大家共同探讨下究竟是什么问题导致页面变乱
2013-04-04