使用ASP.NET WEB API构建基于REST风格的服务实战系列教程【开篇】
最近发现web api很火,园内也有各种大神已经在研究,本人在asp.net官网上看到一个系列教程,原文地址:http://bitoftech.net/2013/11/25/detailed-tutorial-building-asp-net-web-api-restful-service/。于是打算跟着学一下,把学习过程记录在博客园的同时也分享给大家。
每一篇结束后我都会把代码共享
由于我也是刚开始入门技术能力有限,有问题大家一起讨论下吧
系列导航
一.使用Entity Framework Code First构建数据库模型(一)
二.使用Repository模式构建数据库访问层(二)
三.ASP.NET Web Api入门(三)
四.实现模型工厂,依赖注入以及配置格式(四)
五.在Web Api中实现HTTP的PUT,POST,GET和DELETE方法(五)
六.实现资源间的联系(六)
七.实现资源的分页(七)
八.Web Api中的安全问题(八)
九.版本变化的前奏(九)
十.多种技术实现版本变化(十)
十一.使用ETag兑现资源(十一)
待续。。。。。。
基于REST风格服务的简介
REST表示表述性状态转移,它代表的是运行在HTTP上的一个简单的无状态的架构,每一个唯一URL代表一个资源。在创建RESTful服务时,应遵循四个基本的设计原则:
1.使用HTTP方法(动词),使用统一的方式来获取资源(交互的统一接口),即检索资源使用GET,创建资源使用POST, 更新资源使用PUT / PATCH,删除资源使用DELETE。
2.与资源的交互是无状态的, 因此由客户端发起的每个请求应当包括HTTP请求的所有参数,上下文信息和所需服务器返回数据数据类型等。
3.资源标识应通过URI来定义,简单来说应该是只使用URI来完成服务器与客户端和资源之间的交互。这些URI可以看作一个RESTful服务提供的接口。
4.支持JSON或/和XML等多种格式作为数据传输格式。
关于RESTful服务的更多信息,你可以参考:http://www.cnblogs.com/light169/archive/2007/12/31/1021814.html
ASP.NET Web Api简介
ASP.NET WEb Api首次出现是在ASP.NET MVC4的时候,到目前为止已经有一年半的历史了(对我来说还是新知识o(╯□╰)o)。它用于建立一个HTTP服务可以被各种客户端(例如:浏览器,智能手机终端,桌面客户端等)来调用的框架。它并不是ASP.NET MVC框架的一部分,它作为ASP.NET平台的一部分可以用于MVC,Web Form或者是作为一个独立的服务存在。
时至今日,随着智能手机的飞速发展和普及,单页的应用程序猛增的趋势。使用一个轻量级的Web Api来把你的服务暴露给客户端就显得极其重要。ASP.NET Web Api 将使用很多HTTP的特征(URIs,请求/相应的处理模型,标题部分,版本控制以及各种传输数据的格式)带你一起走进基于REST风格服务的精彩世界。
本次系列简介
我们秉持简单,易于理解的原则,同时覆盖了ASP.NET Web Api很多不同的特性来构建我们的项目:
我们将创建一个培训系统,这个系统对外提供一些简单的API,该API允许学生报名参加不同的课程,让老师查看登记在每个课程的学生,在课程和学生之间实现CRUD以及更多的操作。在下一章我会把具体的用到数据库模型展示给大家。
本次系列将会涉及一下的一些知识:
1.采用不同的路由配置,控制器,资源间的关联,格式的响应,和过滤器
2.使用NInject实现依赖注入
3.应用不同的格式响应分页结果
4.在多个资源实现复杂的CRUD操作
5.使用SSL确保安全性
6.使用不同的技术实现API的版本(URL的版本 :查询字符串,版本头部,接受头部)
7.实现资源利用