ASP.NET Web API 2 入门教程

ASP.NET Web API 2 入门教程

作者：jiankunking

​​源码-​​

HTTP不仅提供web页面服务，在构建公开服务和数据api方面,它也是一个强大的平台。HTTP简单、灵活、无处不在。几乎你能想到的所有的平台,都有一个HTTP库,因此HTTP服务可以影响到广泛的客户端,包括浏览器、移动设备,和传统的桌面应用程序。

ASP.NET Web API是一个基于.NET框架用于构建Web API的框架。在本教程中，您将使用ASP.NET Web API创建一个Web API并返回一个产品列表。

本教程中开发工具及环境版本：

Visual Studio 2015 Update 2Web API 2

创建一个Web API项目

在本教程中，将使用 ASP.NET Web API 创建一个web API项目返回一个产品列表。前端Web页面使用jQuery来显示结果。

启动Visual Studio，在开始界面选择新建新项目或者从文件菜单选择：新建-项目。

在模板页选择：已安装-模板-Visual C#-Web。 在项目模板的列表中，选择ASP.NETWeb应用程序。 项目名称：“productsapp”并单击“确定”。

您也可以使用“Web API”模板创建一个Web API项目。 Web API模板使用ASP.NET MVC提供API帮助页面。在本教程中我用空模板,因为我不想使用MVC来演示Web API。一般来说,你使用MVC Web API不需要知道ASP.NET MVC。

添加Model

在“解决方案资源管理器”中，右键单击“Models ”文件夹。从上下文菜单中，选择“添加”然后选择“类”：

将类命名为：Product，添加以下属性到Product类中：

namespace ProductsApp.Models{ public class Product { public int Id { get; set; } public string Name { get; set; } public string Category { get; set; } public decimal Price { get; set; } }}

添加Controller

在Web API,控制器（Controller）是一个处理HTTP请求的对象。我们将添加一个可以返回产品列表或指定ID的单个产品的控制器。

如果你之前用过ASP.NET MVC,那么你应该已经熟悉了控制器。Web API控制器类似MVC控制器,但是继承ApiController类而不是Controller类。

在解决方案资源管理器中,右键单击Controllers 文件夹。选择Add然后选择控制器。

在添加基架对话框中,选择 Web API Controller - Empty。单击添加。

你不需要把你的控制器添加到一个命名为控制器文件夹。文件夹的名字仅仅是为了方便组织你的源文件。

如果这个文件没有打开,双击该文件以打开它。用以下代码替换该文件中的代码:

using productsapp.Models;using System;using System.Collections.Generic;using System.Linq;using System.Net;using System.Net.Http;using System.Web.Http;namespace productsapp.Controllers{ public class ProductsController : ApiController { Product[] products = new Product[] { new Product { Id = 1, Name = "Tomato Soup", Category = "Groceries", Price = 1 }, new Product { Id = 2, Name = "Yo-yo", Category = "Toys", Price = 3.75M }, new Product { Id = 3, Name = "Hammer", Category = "Hardware", Price = 16.99M } }; // GET api/products public IEnumerable GetAllProducts() { return products; } // GET api/products/id public IHttpActionResult GetProduct(int id) { var product = products.FirstOrDefault((p) => p.Id == id); if (product == null) { return NotFound(); } return

为了使示例尽量简单,产品存储在控制器类的一个固定的数组内。当然,在真实的应用程序中,您将查询数据库或使用其他一些外部数据源。 控制器定义了两个方法,该方法返回产品:

GetAllProducts方法返回 IEnumerable类型的整个产品 。GetProduct方法根据ID返回单个产品。

控制器上的每个方法对应于一个或多个uri:

有关如何使用Web API的HTTP请求路由到控制器方法的更多信息，参见ASP.NET Web API路由。

拓展： HTTP 的四个主要方法 （GET， PUT， POST， DELETE） 按照下列方式映射为 CURD 操作：

GET 用于获取 URI 资源的进行展示， GET 操作不应对服务端有任何影响；PUT 用于更新 URI 上的一个资源， 如果服务端允许， PUT 也可以用于新建一个资源；POST 用于新建 资源， 服务端在指定的 URI 上创建一个新的对象， 将新资源的地址作为响应消息的一部分返回；DELETE 用于删除指定的 URI 资源。

通过JavaScript和jQuery调用Web API

在这一部分中，我们将添加一个HTML页面，使用AJAX调用Web API。我们将使用jQuery的Ajax调用进行和更新结果页面。

在“解决方案资源管理器”中，右键单击该项目并选择“添加”，然后选择“新建项”。

在添加新项对话框中,选择Visual c#节点下的Web节点,然后选择HTML页面项。新建名字为“index . html”的页面。

将index . html文件中的内容用一下代码替换：