ASP.NETWEBAPI的使用示例

这篇文章主要介绍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谓词。代码示例如下：

/// 


    /// Person 为资源，对Person进行的一组操作    /// 

    public class PersonController : ApiController

    {        private static List _personLst = new List();       

        /// 


        /// 获取一个Person        /// 

        /// Person的ID

        /// Person

        public Person GetPerson(long id)

        {            return _personLst.Find(x => x.Id == id);

        } 

        /// 


        /// 添加一个Person        /// 

        /// Person

        public void PostAddPerson(Person person)

        {

            _personLst.Add(person);

        } 

        /// 


        /// 修改一个        /// 

        /// Person Id

        /// 新

        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;

        } 

        /// 


        /// 删除一个Person        /// 

        /// Person ID

        public void DeletePerson(long id)

        {

            _personLst.RemoveAll(x => x.Id == id);

        }

}

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

发送请求：谓词为POST，语义创建Person，Person描述在Body里，head中声明了Body通过Json序列化。

收到响应：响应码204，属于2XX类型执行成功，Body里没有数据

发送请求：谓词为GET，语义为查询Person资源，Id为1的，head中声明希望接收使用XML序列化的数据

收到响应：响应码为200，执行成功，Body中有数据，数据使用XML序列化

发送请求：谓词为PUT，语义为修改ID为1的Person资源，修改内容在Body中，Content-Type标明Body使用Json序列化，在Body中我们将Name修改为Test1Changed

收到响应，响应码为204，执行成功

发送请求：谓词为GET，语义为查询ID为1的Person资源，Accept标明希望接收到Json数据

收到响应：可以看到Body为使用Json序列化的内容，Name属性已经变更为Test1Changed

发送请求：谓词为DELETE，语义为删除ID为1的Person资源

收到响应：响应码204，执行成功

发送请求：谓词为GET，语义为查询ID为1的Person资源，Accept标明希望接收到Json数据

收到响应：响应码为200，执行成功，响应内容为null，资源已删除

这就是我用Fiddler来发送、调用的一组RestFul接口，大家可以看到，整个调用过程使用到了HTTP的语义，用到了谓词路由、内容协商。在增、删、改操作中，我都是使用void作为返回值，根据HTTP Code 判断，大家也可以自定义一些返回数据来做出更进一步的操作描述。

在写了这些API后，我们需要在程序中调用，我以C#为例写一组对这些接口调用的实现。在C#中，传统调用HTTP接口一般有两种办法： WebRequest/WebResponse组合的方法调用和WebClient类进行调用。第一种方法抽象程度较低，使用较为繁琐；而WebClient主要面向了WEB网页场景，在模拟Web操作时使用较为方便，但用在RestFul场景下却比较麻烦，在Web API发布的同时，.NET提供了两个程序集：System.Net.Http和System.Net.Http.Formatting。这两个程序集中最核心的类是HttpClient。在.NET4.5中带有这两个程序集，而.NET4需要到Nuget里下载Microsoft.Net.Http和Microsoft.AspNet.WebApi.Client这两个包才能使用这个类，更低的.NET版本就只能表示遗憾了只能用WebRequest/WebResponse或者WebClient来调用这些API了。

在使用中，System.Net.Http这个程序集提供了HttpClient类以及相关的HTTP调用，而System.Net.Http.Formatting提供了一些针对HttpClient的帮助扩展，更好地支持了内容协商、Content创建等功能。下面我就和大家一起写一下这个例子：

我们新建一个控制台程序：

代码如下：

public class Person

    {        public long Id { get; set; }        public string Name { get; set; } 

        public int Age { get; set; } 

        public string Sex { get; set; } 

        public override string ToString()

        {            return $"Id={Id} Name={Name} Age={Age} Sex={Sex}";

        }

    } 

    class Program

    {        static void Main(string[] args)

        {            var client = new HttpClient();

 

            client.BaseAddress = new Uri("http://localhost:22658/"); //基本的API URL
            client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); //默认希望响应使用Json序列化
 

 

            Run(client);

 

            Console.ReadLine();

 

        } 

        static async void Run(HttpClient client)

        {            var result = await AddPerson(client);

            Console.WriteLine($"添加结果：{result}"); //添加结果：true

 

            var person = await GetPerson(client);

            Console.WriteLine($"查询结果：{person}"); //查询结果：Id=1 Name=test Age=10 Sex=F
 

            result = await PutPerson(client);

            Console.WriteLine($"更新结果：{result}"); //更新结果：true
 

            result = await DeletePerson(client);

            Console.WriteLine($"删除结果：{result}"); //删除结果：true
        } 

        static async Task AddPerson(HttpClient client)

        {            return await client.PostAsJsonAsync("api/Person", new Person() { Age = 10, Id = 1, Name = "test", Sex = "F" }) //向Person发送POST请求，Body使用Json进行序列化
                                     .ContinueWith(x => x.Result.IsSuccessStatusCode);  //返回请求是否执行成功，即HTTP Code是否为2XX
        } 

        static async Task GetPerson(HttpClient client)

        {            return await await client.GetAsync("api/Person/1") //向Person发送GET请求
                .ContinueWith(x => x.Result.Content.ReadAsAsync(                              //获取返回Body，并根据返回的Content-Type自动匹配格式化器反序列化Body

                    new List() {new JsonMediaTypeFormatter()/*这是Json的格式化器*/

                                                    ,new XmlMediaTypeFormatter()/*这是XML的格式化器*/}));

 

        } 

        static async Task PutPerson(HttpClient client)

        {            return await client.PutAsJsonAsync("api/Person/1", new Person() { Age = 10, Id = 1, Name = "test1Change", Sex = "F" }) //向Person发送PUT请求，Body使用Json进行序列化
                                    .ContinueWith(x => x.Result.IsSuccessStatusCode);  //返回请求是否执行成功，即HTTP Code是否为2XX
        } 

        static async Task DeletePerson(HttpClient client)

        {            return await client.DeleteAsync("api/Person/1") //向Person发送DELETE请求
                .ContinueWith(x => x.Result.IsSuccessStatusCode); //返回请求是否执行成功，即HTTP Code是否为2XX
        }

}

这就完成了这组API的调用，是不是非常简单方便？HTTPClient使用全异步的方法，并且他有良好的扩展性，我会在之后的博客中再聊这个问题。

以上是ASP.NET WEB API的使用示例的所有内容，感谢各位的阅读！希望分享的内容对大家有帮助，更多相关知识，欢迎关注创新互联行业资讯频道！

网站标题：ASP.NETWEBAPI的使用示例
网站网址：http://cdiso.cn/article/pigdpg.html