重温ASP.NET WebAPI（一）初阶

前言

本文为个人对WebApi的回顾无参考价值。主要简单介绍WEB api和webapi项目的基本结构，并创建简单地webaapi项目实现CRUD操作。

在商业应用领域中，应用之间的关联是相当重要的，应用之间如移动应用或者单页应用的创建，都需要强大的后端服务提供相应的数据以便进行CRUD操作。

WCF and WebApi 的不同

WCF是基于SOAP协议，支持多种传输协议，多种编码，寄宿于.net framework下，需要生产WSDL代理类文件，更安全可靠。

WebApi是基于HTTP协议，支持XML和json，开源可独立出.net framework。REST风格更适合。

使用WCF创建可靠，安全的web服务，可以支持多种传输协议。使用WebAPI创建基于http协议的服务，服务更广的用户群。当创建和设计新的基于REST风格的服务是，采用webapi。虽然WCF也提供支持写REST风格的服务，但是Webapi的支持更好。

SOAP 和 ASP.NET  Web 服务

SOAP是基于标准XML的协议，能够与HTTP通讯。可以理解为程序之间通过以XML为格式的SOAP协议进行通讯。ASP.NET Web服务提供创建SOAP协议的web服务。

SOAP的问题

元数据metadata也会被传输，占用传输空间。
需要在客户端创建代理类。当服务端更新服务，客户端也要及时更新代理类。

REST

REST协议用于分布式环境的数据传输，它使我们能够将分布式服务当做一种资源，并通过简单的HTTP协议来操作这些资源。

REST对应数据库CRUD操作的方式，分为4种：

GET：相当于CRUD操作中的R，数据获取
PUT：相当于CRUD操作中的U，数据更改
POST：相当于CRUD操作中的C，数据创建
DELETE：相当于CRUD操作中的D，数据删除

举例说明

当站点为：www.cnblogs.com/blogs， 则代表获取博客列表数据

当站点为www.cnblogs.com/blogs/1,则取决于type类型，如果是put，则创建新的BLOG。

如果是post，则更新当前blog。如果是delete，则删除当前blog。

REST与SOAP对比

只有使用的数据被传输，而没有元数据。
省略了代理的创建。

WCF REST服务

WCF比web服务要晚出来。它提供更安全和成熟的方式去创建服务。通过WCF，我们可以定义自己的服务，并配置相关的协议如HTTP，TCP或者IPC甚至消息队列。WCF也可以创建REST服务。

WCF创建REST服务，需要我们做大量的配置工作。通常WCF适用于一些特殊场景，如单向消息传输，消息队列，双工通信。但是使用WCF创建REST服务过于复杂，而且局限于.net 3.5 framework。

ASP.NET Web API介绍

微软提出ASP.NET Web API可以理解为一个框架，用于快速简易的创建REST服务。

Web API的入门创建

我们可以点开Values的controller，它集成ApiController，实现的一般的Get,Post,Put,Delete的功能。并提供了响应的URL路径说明。

public class ValuesController : ApiController

    {

        // GET api/values

        public IEnumerable<string> Get()

        {

            return new string[] { "value1", "value2" };

        }

        // GET api/values/5

        public string Get(int id)

        {

            return "value";

        }

        // POST api/values

        public void Post([FromBody]string value)

        {

        }

        // PUT api/values/5

        public void Put(int id, [FromBody]string value)

        {

        }

        // DELETE api/values/5

        public void Delete(int id)

        {

        }

    }

打开App_Start文件下的RouteConfig.cs文件，可以看到完整的api路由设置。

public class RouteConfig

    {

        public static void RegisterRoutes(RouteCollection routes)

        {

            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

            routes.MapRoute(

                name: "Default",

                url: "{controller}/{action}/{id}",

                defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }

            );

        }

    }

实现自己的webapi

public class UserController : ApiController

    {

        public IHttpActionResult GetRead()

        {

            var employeeListViewModel = new EmployeeListViewModel();

            var empBal = new EmployeeBusinessLayer();

            var employees =  empBal.GetEmployees();

            var empViewModels = employees.Select(emp => new EmployeeViewModel

            {

                Name = emp.Name,

                Salary = emp.Salary.ToString(),

                SalaryColor = emp.Salary > 15000 ? "yellow" : "green"

            }).ToList();

            employeeListViewModel.Employees = empViewModels;

            employeeListViewModel.UserName = User.Identity.Name;

            return Ok(employees);

        }

}

以上是初阶的内容，进阶地址：

http://www.cnblogs.com/ruanyifeng/p/5455105.html

重温ASP.NET WebAPI（一）初阶的相关教程结束。