WebApi是微軟在VS2012 MVC4版本中綁定發行的，WebApi是徹底基於Restful標準的框架。RestFul: （英文：Representational State Transfer，簡稱REST）網上關於Restful定義的資料不少，我我的理解的Restful api 是指基於資源的定義的接口,它的全部接口都是對資源的操做。REST的核心原則是將你的API拆分爲邏輯上的資源。這些資源經過http被操做（GET ,POST,PUT,DELETE).Restful Api接口標準的定義知足CURD，標準的接口定義以下：html
- Post:新增記錄
- Put:修改記錄
- Get:獲取數據
- Delete:刪除數據
webapi標準的定義形式爲：每一個controller都對應一個Model，controller中的接口都應該是對controller所對應的那個model進行的操做，因此上訴的post,get,put,delete都是對model所對應的資源操做。可是在實際的操做中，可能沒有辦法徹底知足這種定義的形式，力求儘可能知足。web
WebAPI項目和典型的MVC項目同樣，包含主要的Models，Views，Controllers等文件夾和Global.asax文件。Views對於WebAPI來講沒有太大的用途，Models中的Model主要用於保存Service和Client交互的對象，這些對象默認狀況下會被轉換爲Json格式的數據進行傳輸，Controllers中的Controller用於提供服務。和普通的MVC同樣，Global.asax用於配置路由規則。json
在實際應用中，Controller是WebAPI的連接服務器和客戶端的窗口。Controller的好壞影響整個系統的設計。Controller中是各類Action接口，對於Action接口，咱們有必要對其接收的參數和返回值瞭解。api
Action返回類型
WebAPI服務函數的返回值主要能夠分爲void、普通對象、HttpResponseMessag、IHttpActionResult 四種，這裏簡單的介紹一下。服務器
Void類型
通常來講，Delete和Put類型的求情返回void類型的值，如：架構
public class DepartmentController : ApiController
{
public void Delete(int id)
{
}
}
不過一個交互性好的接口，應該返回正確的Http status code,如返回200,對列子作修改：app
public class DepartmentController : ApiController
{
public HttpStatusCode Delete(int id)
{
return HttpStatusCode.OK;
}
}
普通對象
普通對象一般是由Get接口返回。例如：框架
public class CompanyController : ApiController
{
public Company Get(int id)
{
return CompanyInfo;
}
}
HttpResponseMessag
HttpResponseMessage是標準Http應答了，此時服務器並不作任何處理，能夠直接將HttpResponseMessage發送給客戶端。asp.net
public HttpResponseMessage Get()
{
var response = Request.CreateResponse(HttpStatusCode.OK);
response.Content = new StringContent("Success", Encoding.UTF8);
return response;
}
IHttpActionResult
IHttpActionResult是Web API 2中引入的一個接口，IHttpActionResult是HttpResponseMessage的一個工廠類。IHttpActionResult是WebAPI中推薦的標準返回值，ApiController類中也提供了很多標準的工廠函數方便咱們快速構建它們，如BadRequest，Conflict，Ok，NotFound等，一個簡單的示例以下：函數
public IHttpActionResult Get(int id)
{
var dto = new ProductDataDTO();
dto = AutoMapper.Mapper.Map<ProductDataDTO>(ProductDataService.QueryProductData (id));
return Ok(dto);
}
Action參數類型
Get請求的參數,均在URI中給出，比較簡單，不作過多說明。下面主要對POST請求的參數作一下說明。
POST請求
單一POST參數
單一的參數請求，須要使用[FromBody]標記參數，以下圖所示：
[AcceptVerbs("POST")]
public string Post([FromBody]string data)
{
return string.Format(@"Data:{1}", data);
}
除了使用[FromBody]標記參數外,也可使用dynamic關鍵字標記參數。
多個參數的POST請求
有了上面的經驗，多個參數的例子，按照常理來講，應該以下所示
[AcceptVerbs("POST")]
public string Post([FromBody]string data, [FromBody]string name)
{
return string.Format(@"Name:{0},Data:{1}", name, data);
}
但在實際調用中卻報錯，報錯以下：
查了資料，緣由是在一個接口中，被[FromBody]修飾的參數只能有一個。對此，咱們能夠將上面的兩個參數封裝爲一個對象傳遞。以下：
public class Person
{
public string name { set; get; }
public string message { set; get; }
}
......
[AcceptVerbs("POST")]
public string TEST4([FromBody]Person data)
{
return string.Format(@"Name:{0},Message:{1}", data.name, data.message);
}
除此以外，還有另一種方式實現，使用[FromURi]關鍵字,以下所示：
public string TEST2([FromUri]string data,[FromBody]string name)
{
return string.Format(@"Name:{0},Data:{1}",name,data);
}
須要說明的是，在WebApi的接口參數中，在沒有標記的狀況下，參數默認是[FromUri]形式，Get請求的接口的參數都是FromUri，顧名思議是從Uri獲取數據。一個接口能夠有多個FromUri參數(這些參數通常都是簡單參數)，可是隻能有一個FromBody的參數。
就剛纔的例子而言，data數據在Uri中獲取，而name數據則從body中獲取。
傳遞對象
有了上面的例子，其實傳遞對象在上面已經講過了，就是使用[FromBody]或dynamic標記參數。
傳遞不一樣的多個對象
這種狀況，最近打算寫這篇文章的時候，查找資料的時候，在其餘人的博文中看到的，地址以下：http://www.cnblogs.com/babycool/p/3922738.html，裏面提到了傳遞多個不一樣對象的狀況，我的也嘗試去試着調試，可是一直沒有成功，也就很差作過多的說明。後來想了下，其實能夠另闢蹊徑解決這個方法，新建一個對象，將要傳遞的對象作了屬性，這樣來傳遞給後臺接口。關於最後這種方式，你們感興趣能夠去看看原文。
