ASP.NET WEB API的使用示例

这篇文章主要介绍ASP.NET WEB API的使用示例，文中介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们一定要看完！

在我前一篇博客中已经给各位简单介绍了HTTP协议与RestFul API的关系，以及一些基本的HTTP协议知识，在这些知识的铺垫下，今天，我们一起来讨论一下WEB API的适用场景，然后写我们第一个WEB API接口，并演示如何对其进行简单调用。

很多人都很迷惑，既然有了WCF为什么还要有WEB API？WEB API会不会取代WCF？

就我的看法，WCF提供的是一种RPC实现的集合，WCF的设计更多地考虑了SOA的场景，以及各种RPC的问题。很多人也会说，RestFul API也是一种RPC啊，并且WCF中也有关于RestFul 的实现啊。很多资料中RPC和RestFul在风格概念上是有一些区别的，其实我觉得这两者的区别比较主观，过度纠结这些就学院派了；我主要关注了实际使用上的一些问题，在WCF中，支持的协议很多，WS-*系列协议，以及一些更简洁的协议，其中提供了一些专用通信协议的性能是非常高的，并且WCF还提供了服务发现等功能，我认为WCF更适合内部系统间的高性能调用，社区中也有其他一些RPC方案可以选择，例如gRPC，Avor，thrift都是和WCF定位相同的产品；而WEB API是关注于HTTP RestFul风格的产品，在此基础上，任何语言、任何终端都能非常容易地进行对接，并且能利用非常成熟的各种HTTP基础设施和解决方案来进行开发、调试、负载均衡、内容分发。所以，WEB API是一种针对HTTP的，偏重于快速开发RestFul风格开放式API的开发框架。目前看来，他并不能取代WCF，他们各有适合的场景，不能认为WEB API是WCF的替代产品。

OK，现在我们来开发第一组WEB API接口！使用VS2012以后的版本都有现成的WEB API创建模板，大家跟着创建就好了，创建出来后，项目中会有MVC、WEB API的项目，WEB API对MVC有依赖，不能单独创建！而WEB API和MVC都是利用类似的路由机制，所以在默认路由中，WEB API 使用

/api/{controller}/{id}

作为路由，添加了/api/节以区分MVC和web api。

接下来，我们添加一个WEB API的Controller，取名为PersonController，他继承于ApiController；在创建这个Controller的时候，我们就定义了一种资源：Person，在PersonController里的所有操作均围绕着Person这个资源来的。接下来我们开始定义一组增删改查操作。

在Web API中，默认路由采用了一种约定：根据谓词来进行路由，而方法名的前缀就是调用该方法对应使用的HTTP谓词。代码示例如下：

/// <summary> /// Person 为资源，对Person进行的一组操作 /// </summary> public class PersonController : ApiController { private static List<Person> _personLst = new List<Person>(); /// <summary> /// 获取一个Person /// </summary> /// <param name="id">Person的ID</param> /// <returns>Person</returns> public Person GetPerson(long id) { return _personLst.Find(x => x.Id == id); } /// <summary> /// 添加一个Person /// </summary> /// <param name="person">Person</param> public void PostAddPerson(Person person) { _personLst.Add(person); } /// <summary> /// 修改一个 /// </summary> /// <param name="id">Person Id</param> /// <param name="person">新</param> public void PutModifyPerson(long id, Person person) { var p = _personLst.Find(x => x.Id == id); p.Age = person.Age; p.Name = person.Name; p.Sex = person.Sex; } /// <summary> /// 删除一个Person /// </summary> /// <param name="id">Person ID</param> public void DeletePerson(long id) { _personLst.RemoveAll(x => x.Id == id); } }

一个简单的针对资源的CRUD操作的API就好了，不用解析输入，不用拼接输出，就是那么简单！让我们来遛一遛！

ASP.NET WEB API的使用示例