Web Api返回值

時間 2019-11-08

標籤 web api 返回欄目 HTML 简体版

原文原文鏈接

首先：註明，我還沒這麼強的功力啦！這是我看的網上的，由於怕博主刪除就本身複製了一下html

博主的網址是：http://www.cnblogs.com/landeanfen/p/5501487.html 前端

使用過Webapi的園友應該都知道，Webapi的接口返回值主要有四種類型web

void無返回值
IHttpActionResult
HttpResponseMessage
自定義類型

此篇就圍繞這四塊分別來看看它們的使用。ajax

1、void無返回值

void關鍵字咱們都不陌生，它申明方法沒有返回值。它的使用也很簡單，咱們來看一個示例就能明白。bootstrap

 1 public class ORDER
 2     {
 3         public string ID { get; set; }
 4 
 5         public string NO { get; set; }
 6 
 7         public string NAME { get; set; }
 8 
 9         public string DESC { get; set; }
10     }

1 public class OrderController : ApiController
2     {
3         [HttpPost]
4         public void SaveOrder(ORDER name)
5         { 
6             //處理業務邏輯
7 
8         }
9     }

在Web裏面調用api

 1 $(function () {
 2     $.ajax({
 3         type: 'post',
 4         url: 'http://localhost:21528/api/Order/SaveOrder',
 5         data: { ID: "aaa", NAME: "test" },
 6         success: function (data, status) {
 7             alert(data);
 8         }
 9     });
10 });

獲得結果瀏覽器

能夠看到，使用void申明的方法，在success方法裏面得不到返回值，而且會返回http狀態碼204，告訴客戶端此請求沒有返回值。app

2、IHttpActionResult

IHttpActionResult類型是WebApi裏面很是重要的一種返回值類型。下面博主就根據平時在項目裏面使用最多的幾種方式來說解下這種類型的返回值的一些用法。異步

一、Json<T>(T content)

使用MVC開發過的朋友必定記得，在MVC裏面，請求數據的接口的返回值類型大部分使用的是JsonResult，在MVC裏面你必定也寫過相似這樣的接口：async

1  public JsonResult GetResult()
2         {
3             return Json(new { }, JsonRequestBehavior.AllowGet);
4         }

那麼，在WebAPI裏面是否也存在相似的用法呢。呵呵，在這點上面，微軟老是貼心的。在WebApi的ApiController這個抽象類裏面，爲咱們封裝了Json<T>(T content)這個方法，它的用法和MVC裏面的JsonResult基本相似。咱們經過一個例子來講明它的用法：

 1 [HttpGet]
 2         public IHttpActionResult GetOrder()
 3         {
 4             var lstRes = new List<ORDER>(); 
 5 
 6             //實際項目中，經過後臺取到集合賦值給lstRes變量。這裏只是測試。
 7             lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
 8             lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });
 9 
10             return Json<List<ORDER>>(lstRes);
11         }

看到這個代碼，有人就疑惑了，咱們定義的返回值類型是IHttpActionResult類型，直接返回Json<T>(T content)這樣可行麼？咱們將Json轉到定義看看：

1 protected internal JsonResult<T> Json<T>(T content);

咱們繼續將JsonResult<T>轉到定義

原來JsonResult<T>是實現了IHttpActionResult接口的，難怪能夠直接返回呢。

知道了這個，咱們直接在Web裏面經過ajax請求來調用：

 1 $(function () {
 2     $.ajax({
 3         type: 'get',
 4         url: 'http://localhost:21528/api/Order/GetOrder',
 5         data: {},
 6         success: function (data, status) {
 7             alert(data);
 8         }
 9     });
10 });

來看結果：

既然實體類能夠直接這樣傳遞，那麼若是咱們想要傳遞一些匿名類型呢，由於不少狀況下，咱們須要返回到前端的對象都沒有對應的實體來對應，若是咱們想要返回匿名對象怎麼辦呢？咱們知道，這裏的Json<T>(T content)必需要傳一個對應的泛型類型，若是是匿名類型這裏確定很差傳。還好有咱們的object類型，固然你可使用dynamic，咱們來試一把。

1   [HttpGet]
2         public IHttpActionResult GetOrder()
3         {
4           
5             return Json<dynamic>(new { AA = "", BB = "cc" });
6         }

一樣的來看測試結果：

二、Ok()、 Ok<T>(T content)

除了Json<T>(T content)，在ApiController裏面還有另一個比較經常使用的方法：Ok()。一樣，咱們將Ok()轉到定義

1 protected internal virtual OkResult Ok();

OkResult轉到定義

有了這個做爲基礎，咱們就能夠放心大膽的使用了。

1  [HttpGet]
2         public IHttpActionResult GetOKResult()
3         {
4             return Ok();
5         }

獲得結果

若是返回Ok()，就表示不向客戶端返回任何信息，只告訴客戶端請求成功。

除了Ok()以外，還有另一個重載Ok<T>(T content)。

1  [HttpGet]
2         public IHttpActionResult GetOKResult(string name)
3         {
4             return Ok<string>(name);
5         }

這種用法和Json<T>(T content)比較相似，若是你非要問這二者有什麼區別，或者說怎麼選擇二者。那麼個人理解是若是是返回實體或者實體集合，建議使用Json<T>(T content)，若是是返回基礎類型（如int、string等），使用Ok<T>(T content)。

三、NotFound()

當須要向客戶端返回找不到記錄時，有時須要用到NotFound()方法

1 protected internal virtual NotFoundResult NotFound();

來看看它的使用場景

 1 [HttpGet]
 2         public IHttpActionResult GetNotFoundResult(string id)
 3         {
 4             var lstRes = new List<ORDER>();
 5 
 6             //實際項目中，經過後臺取到集合賦值給lstRes變量。這裏只是測試。
 7             lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
 8             lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });
 9             var oFind = lstRes.FirstOrDefault(x => x.ID == id) ;
10             if (oFind == null)
11             {
12                 return NotFound();
13             }
14             else
15             {
16                 return Json<ORDER>(oFind);
17             }
18         }

 1 $(function () {
 2     $.ajax({
 3         type: 'get',
 4         url: 'http://localhost:21528/api/Order/GetNotFoundResult',
 5         data: { id :"cccc" },
 6         success: function (data, status) {
 7             alert(data);
 8         }
 9     });
10 });

獲得結果

NotFound()方法會返回一個404的錯誤到客戶端。

四、其餘

其餘還有一些方法，都有它特定的用途。在此貼出來。

4.一、Content<T>(HttpStatusCode statusCode, T value)

1   [HttpGet]
2         public IHttpActionResult GetContentResult()
3         {
4             return Content<string>(HttpStatusCode.OK, "OK");
5         }

向客戶端返回值和http狀態碼。

4.二、BadRequest()

1 [HttpGet]
2         public IHttpActionResult GetBadRequest(ORDER order)
3         {
4             if (string.IsNullOrEmpty(order.ID))
5                 return BadRequest();
6             return Ok();
7         }

向客戶端返回400的http錯誤。

4.三、Redirect(string location)

1   [HttpGet]
2         public IHttpActionResult RedirectResult()
3         {
4             return Redirect("http://localhost:21528/api/Order/GetContentResult");
5         }

將請求重定向到其餘地方。

五、自定義IHttpActionResult接口的實現

上面介紹了一些系統內置的經常使用的實現IHttpActionResult接口的方法。若是咱們須要自定義IHttpActionResult的返回呢？

在介紹以前，咱們有必要先來看看IHttpActionResult類型的定義，將IHttpActionResult轉到定義能夠看到：

 1 namespace System.Web.Http
 2 {
 3     // 摘要: 
 4     //     Defines a command that asynchronously creates an System.Net.Http.HttpResponseMessage.
 5     public interface IHttpActionResult
 6     {
 7         // 摘要: 
 8         //     Creates an System.Net.Http.HttpResponseMessage asynchronously.
 9         //
10         // 參數: 
11         //   cancellationToken:
12         //     The token to monitor for cancellation requests.
13         //
14         // 返回結果: 
15         //     A task that, when completed, contains the System.Net.Http.HttpResponseMessage.
16         Task<System.Net.Http.HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken);
17     }
18 }

這個接口包含惟一的一個方法ExecuteAsync()，此方法將以異步方式建立一個HttpResponseMessage實例返回給客戶端。

有了這個做爲基礎，下面，咱們自定義一個bootstrapTable服務端分頁的子類去展現自定義IHttpActionResult的用法。

首先，自定義一個實現類

 1 public class PageResult : IHttpActionResult
 2     {
 3         object _value;
 4         HttpRequestMessage _request;
 5 
 6         public PageResult(object value, HttpRequestMessage request)
 7         {
 8             _value = value;
 9             _request = request;
10         }
11 
12         public Task<HttpResponseMessage> ExecuteAsync(System.Threading.CancellationToken cancellationToken)
13         {
14             var response = new HttpResponseMessage()
15             {
16                 Content = new ObjectContent(typeof(object), _value, new JsonMediaTypeFormatter()),
17                 RequestMessage = _request
18             };
19             return Task.FromResult(response);
20         }
21     }

而後，在API接口裏面返回PageResult對象

 1 [HttpGet]
 2         public IHttpActionResult GetPageRow(int limit, int offset)
 3         {
 4             var lstRes = new List<ORDER>();
 5 
 6             //實際項目中，經過後臺取到集合賦值給lstRes變量。這裏只是測試。
 7             lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
 8             lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });
 9 
10             var oData = new { total = lstRes.Count, rows = lstRes.Skip(offset).Take(limit).ToList() };
11             return new PageResult(oData, Request);
12         }

最好，ajax調用

 1 $(function () {
 2     $.ajax({
 3         type: 'get',
 4         url: 'http://localhost:21528/api/Order/GetPageRow',
 5         data: { limit:1,offset:1},
 6         success: function (data, status) {
 7             alert(data);
 8         }
 9     });
10 });

獲得結果

3、HttpResponseMessage

在上文自定義IHttpActionResult返回類型的時候，提到過HttpResponseMessage這個對象。它表示向客戶端返回一個http響應的消息對象（包含http狀態碼和須要返回客戶端的消息）。這個對象也有它獨特的使用場景：須要向客戶端返回HttpResponse時就要用到這個對象。以導出爲例，因爲須要將導出的Excel文件輸出到客戶端瀏覽器，Webapi的服務端須要向Web的客戶端輸出文件流，這個時候通常的IHttpActionResult對象不方便解決這個問題，因而HttpReponseMessage派上了用場。咱們來看看它的使用示例。

 1 public HttpResponseMessage Export()
 2         {
 3             //取數據
 4             var lstRes = OrderBLL.Export();
 5 
 6             //向Excel裏面填充數據
 7             HSSFWorkbook workbook = new HSSFWorkbook();
 8             CreateAndFillSheet(workbook, lstRes);
 9             
10             //保存到服務
11             var fileName = "Excel" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xls";
12             var strPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, @"Data\" + fileName);
13             using (FileStream fs = new FileStream(strPath, FileMode.Create))
14             {
15                 workbook.Write(fs);
16                 using (MemoryStream ms = new MemoryStream())
17                 {
18                     workbook.Write(ms);
19                 }
20             }
21 
22             //輸出到瀏覽器
23             try
24             {
25                 var stream = new FileStream(strPath, FileMode.Open);
26                 HttpResponseMessage response = new HttpResponseMessage(HttpStatusCode.OK);
27                 response.Content = new StreamContent(stream);
28                 response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
29                 response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
30                 {
31                     FileName = fileName
32                 };
33 
34                 return response;
35             }
36             catch
37             {
38                 return new HttpResponseMessage(HttpStatusCode.NoContent);
39             }
40         }

將文件流保存在StreamContent對象裏面，而後輸出到瀏覽器。在瀏覽器端便可將Excel輸出。

4、自定義類型

以上幾種返回值類型能解決咱們大部分返回值的問題，固然，你也能夠將webapi的接口和普通方法同樣，返回任意的類型，WebApi會自動序列化你自定義任何返回類型，而後將序列化的值寫到響應正文裏，狀態碼統一返回200。好比：

 1 [HttpGet]
 2         public object GetOther()
 3         {
 4             var lstRes = new List<ORDER>();
 5 
 6             //實際項目中，經過後臺取到集合賦值給lstRes變量。這裏只是測試。
 7             lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
 8             lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });
 9 
10             return lstRes;
11         }

獲得結果

5、總結

以上經過四個方面詳細分享了下WebApi裏面返回值的常見用法，不能說哪一種方式最好，由於每種方式都有其特定的使用場景。博主以爲爲了規範WebApi接口，對於通常接口的返回值，儘可能使用IHttpActionResult類型做爲返回值，畢竟是微軟內置的東西，可能爲咱們考慮了不少咱們考慮不到的東西。固然，你可能會以爲麻煩，你可能會說直接和普通方法同樣來使用不是更爽，博主當初也有這種想法，但是學習微軟的東西多了以後發現不少東西仍是遵照必定的標準比較好，至少維護起來方便。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。