最近发现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或者是作为一个独立的服务存在。

aspnet-webapi

时至今日,随着智能手机的飞速发展和普及,单页的应用程序猛增的趋势。使用一个轻量级的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.实现资源利用

备注:在本次系列中,我们不构建客户端应用程序,我们将使用Fiddler or Postman 来发送HTTP请求