这篇做为这个系列的第一篇,做基本的介绍,有经验的人可以直接跳到第二部分创建 ProductController。
创建 Web API 项目
在这里我们使用VS2013, .NET 4.5.1创建一个Web API 2的项目
选择项目WEB API模板, 在最下方的MVC主要是默认会自带微软的API Helper, 使用MVC发布
在这里不实用安全
这样我们一个项目就初始化好了, 这都要归功于微软强大的VS
F5启动项目之后, 点击界面上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 PageGetProductList() { 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(); } }
添加之后启动程序,看到的结果如下
OK, 到这里大家加上自己的后端业务逻辑,完成业务层面的操作就可以发布使用了。
本章代码: 代码下载(代码托管在CSDN Code)