【WEB API项目实战干货系列】- WEB API入门(一)

这篇做为这个系列的第一篇，做基本的介绍，有经验的人可以直接跳到第二部分创建 ProductController。

创建 Web API 项目

在这里我们使用VS2013, .NET 4.5.1创建一个Web API 2的项目

选择项目WEB API模板, 在最下方的MVC主要是默认会自带微软的API Helper, 使用MVC发布

在这里不实用安全

这样我们一个项目就初始化好了, 这都要归功于微软强大的VS

F５启动项目之后, 点击界面上API按钮可以看到默认创建的API

这时就可以用上面的地址通过一些测试工具来测试了. 这里推荐使用fiddler, 后面我们也将广泛使用这款工具来做调试.

创建我们自己的API-Products API

添加ProductController

在这里我们设计产品相关的API URL如下, 虽然这个不完全符合RESTFul标准，如有纠结的人直接忽略，这里主要介绍如何把我们的URL定制成下面这个样子(也是我们项目中的样子):

当然这里的API URL还有其他写法，这个有兴趣的后面章节可以再讨论。

我们的 Product API简单的设计为下面格式:

添加获取产品分页API: api/products/product/getList
添加获取单个产品API: api/products/product/get?productId=产品ID
添加产品新增API: api/products/product/add?productId=产品ID
添加产品更新API: api/products/product/update?productId=产品ID
添加产品删除API: api/products/product/delete?productId=产品ID

在这里我们在刚才新添加的ProductController里中实现上面的API

[RoutePrefix("api/products")]public class ProductController : ApiController{[HttpGet, Route("product/getList")]public Page<Product> GetProductList(){throw new NotImplementedException();}[HttpGet, Route("product/get")]public Product GetProduct(Guid productId){throw new NotImplementedException();}[HttpPost, Route("product/add")]public Guid AddProduct(Product product){throw new NotImplementedException();}[HttpPost, Route("product/update")]public void UpdateProduct(Guid productId, Product product){throw new NotImplementedException();}[HttpDelete, Route("product/delete")]public void DeleteProduct(Guid productId){throw new NotImplementedException();}}