小男孩‘自慰网亚洲一区二区,亚洲一级在线播放毛片,亚洲中文字幕av每天更新,黄aⅴ永久免费无码,91成人午夜在线精品,色网站免费在线观看,亚洲欧洲wwwww在线观看

分享

C#進階系列——WebApi 接口返回值不困惑:返回值類型詳解

 蕎麥888 2019-10-16

正文

前言:已經(jīng)有一個月沒寫點什么了,感覺心里空落落的。今天再來篇干貨,想要學習Webapi的園友們速速動起來,跟著博主一起來學習吧。之前分享過一篇 C#進階系列——WebApi接口傳參不再困惑:傳參詳解 ,這篇博文內(nèi)容本身很基礎(chǔ),沒想到引起很多園友關(guān)注,感謝大家的支持。作為程序猿,我們都知道參數(shù)和返回值是編程領(lǐng)域不可分割的兩大塊,此前分享了下WebApi的傳參機制,今天再來看看WebApi里面另一個重要而又基礎(chǔ)的知識點:返回值。還是那句話:本篇針對初初使用WebApi的同學們,比較基礎(chǔ),有興趣的且看看。

WebApi系列文章

使用過Webapi的園友應(yīng)該都知道,Webapi的接口返回值主要有四種類型

  • void無返回值

  • IHttpActionResult

  • HttpResponseMessage

  • 自定義類型

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

一、void無返回值

void關(guān)鍵字我們都不陌生,它申明方法沒有返回值。它的使用也很簡單,我們來看一個示例就能明白。

復(fù)制代碼
   public class ORDER
    {public string ID { get; set; }public string NO { get; set; }public string NAME { get; set; }public string DESC { get; set; }
    }
復(fù)制代碼
復(fù)制代碼
   public class OrderController : ApiController
    {
        [HttpPost]public void SaveOrder(ORDER name)
        { //處理業(yè)務(wù)邏輯
}}
復(fù)制代碼

在Web里面調(diào)用

復(fù)制代碼
$(function () {
    $.ajax({
        type: 'post',
        url: 'http://localhost:21528/api/Order/SaveOrder',
        data: { ID: "aaa", NAME: "test" },
        success: function (data, status) {
            alert(data);
        }
    });
});
復(fù)制代碼

得到結(jié)果

 

 可以看到,使用void申明的方法,在success方法里面得不到返回值,并且會返回http狀態(tài)碼204,告訴客戶端此請求沒有返回值。

二、IHttpActionResult

IHttpActionResult類型是WebApi里面非常重要的一種返回值類型。下面博主就根據(jù)平時在項目里面使用最多的幾種方式來講解下這種類型的返回值的一些用法。

1、Json<T>(T content)

使用MVC開發(fā)過的朋友一定記得,在MVC里面,請求數(shù)據(jù)的接口的返回值類型大部分使用的是JsonResult,在MVC里面你一定也寫過類似這樣的接口:

     public JsonResult GetResult()
        {return Json(new { }, JsonRequestBehavior.AllowGet);
        }

那么,在WebAPI里面是否也存在類似的用法呢。呵呵,在這點上面,微軟總是貼心的。在WebApi的ApiController這個抽象類里面,為我們封裝了Json<T>(T content)這個方法,它的用法和MVC里面的JsonResult基本類似。我們通過一個例子來說明它的用法:

復(fù)制代碼
     [HttpGet]public IHttpActionResult GetOrder()
        {var lstRes = new List<ORDER>(); //實際項目中,通過后臺取到集合賦值給lstRes變量。這里只是測試。lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
            lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });return Json<List<ORDER>>(lstRes);
        }
復(fù)制代碼

看到這個代碼,有人就疑惑了,我們定義的返回值類型是IHttpActionResult類型,直接返回Json<T>(T content)這樣可行么?我們將Json轉(zhuǎn)到定義看看:

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

我們繼續(xù)將JsonResult<T>轉(zhuǎn)到定義

原來JsonResult<T>是實現(xiàn)了IHttpActionResult接口的,難怪可以直接返回呢。

知道了這個,我們直接在Web里面通過ajax請求來調(diào)用:

復(fù)制代碼
$(function () {
    $.ajax({
        type: 'get',
        url: 'http://localhost:21528/api/Order/GetOrder',
        data: {},
        success: function (data, status) {
            alert(data);
        }
    });
});
復(fù)制代碼

來看結(jié)果:

 既然實體類可以直接這樣傳遞,那么如果我們想要傳遞一些匿名類型呢,因為很多情況下,我們需要返回到前端的對象都沒有對應(yīng)的實體來對應(yīng),如果我們想要返回匿名對象怎么辦呢?我們知道,這里的Json<T>(T content)必須要傳一個對應(yīng)的泛型類型,如果是匿名類型這里肯定不好傳。還好有我們的object類型,當然你可以使用dynamic,我們來試一把。

復(fù)制代碼
        [HttpGet]public IHttpActionResult GetOrder()
        {          return Json<dynamic>(new { AA = "", BB = "cc" });        }
復(fù)制代碼

同樣的來看測試結(jié)果:

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

除了Json<T>(T content),在ApiController里面還有另外一個比較常用的方法:Ok()。同樣,我們將Ok()轉(zhuǎn)到定義

protected internal virtual OkResult Ok();

OkResult轉(zhuǎn)到定義

有了這個作為基礎(chǔ),我們就可以放心大膽的使用了。

        [HttpGet]public IHttpActionResult GetOKResult()
        {return Ok();
        }

得到結(jié)果

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

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

        [HttpGet]public IHttpActionResult GetOKResult(string name)
        {return Ok<string>(name);
        }

這種用法和Json<T>(T content)比較類似,如果你非要問這兩者有什么區(qū)別,或者說怎么選擇兩者。那么我的理解是如果是返回實體或者實體集合,建議使用Json<T>(T content),如果是返回基礎(chǔ)類型(如int、string等),使用Ok<T>(T content)。

3、NotFound()

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

protected internal virtual NotFoundResult NotFound();

來看看它的使用場景

復(fù)制代碼
        [HttpGet]public IHttpActionResult GetNotFoundResult(string id)
        {var lstRes = new List<ORDER>();//實際項目中,通過后臺取到集合賦值給lstRes變量。這里只是測試。lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
            lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });var oFind = lstRes.FirstOrDefault(x => x.ID == id) ;if (oFind == null)
            {return NotFound();
            }else{return Json<ORDER>(oFind);
            }
        }
復(fù)制代碼
復(fù)制代碼
$(function () {
    $.ajax({
        type: 'get',
        url: 'http://localhost:21528/api/Order/GetNotFoundResult',
        data: { id :"cccc" },
        success: function (data, status) {
            alert(data);
        }
    });
});
復(fù)制代碼

得到結(jié)果

 

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

4、其他

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

4.1、Content<T>(HttpStatusCode statusCode, T value)

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

向客戶端返回值和http狀態(tài)碼。

4.2、BadRequest()

復(fù)制代碼
        [HttpGet]public IHttpActionResult GetBadRequest(ORDER order)
        {if (string.IsNullOrEmpty(order.ID))return BadRequest();return Ok();
        }
復(fù)制代碼

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

4.3、Redirect(string location)

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

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

5、自定義IHttpActionResult接口的實現(xiàn)

上面介紹了一些系統(tǒng)內(nèi)置的常用的實現(xiàn)IHttpActionResult接口的方法。如果我們需要自定義IHttpActionResult的返回呢?

在介紹之前,我們有必要先來看看IHttpActionResult類型的定義,將IHttpActionResult轉(zhuǎn)到定義可以看到:

復(fù)制代碼
namespace System.Web.Http
{// 摘要: //     Defines a command that asynchronously creates an System.Net.Http.HttpResponseMessage.public interface IHttpActionResult
    {// 摘要: //     Creates an System.Net.Http.HttpResponseMessage asynchronously.//// 參數(shù): //   cancellationToken://     The token to monitor for cancellation requests.//// 返回結(jié)果: //     A task that, when completed, contains the System.Net.Http.HttpResponseMessage.Task<System.Net.Http.HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken);
    }
}
復(fù)制代碼

這個接口包含唯一的一個方法ExecuteAsync(),此方法將以異步方式創(chuàng)建一個HttpResponseMessage實例返回給客戶端。

有了這個作為基礎(chǔ),下面,我們自定義一個bootstrapTable服務(wù)端分頁的子類去展示自定義IHttpActionResult的用法。

首先,自定義一個實現(xiàn)類

復(fù)制代碼
   public class PageResult : IHttpActionResult
    {object _value;
        HttpRequestMessage _request;public PageResult(object value, HttpRequestMessage request)
        {
            _value = value;
            _request = request;
        }public Task<HttpResponseMessage> ExecuteAsync(System.Threading.CancellationToken cancellationToken)
        {var response = new HttpResponseMessage()
            {
                Content = new ObjectContent(typeof(object), _value, new JsonMediaTypeFormatter()),
                RequestMessage = _request
            };return Task.FromResult(response);
        }
    }
復(fù)制代碼

然后,在API接口里面返回PageResult對象

復(fù)制代碼
     [HttpGet]public IHttpActionResult GetPageRow(int limit, int offset)
        {var lstRes = new List<ORDER>();//實際項目中,通過后臺取到集合賦值給lstRes變量。這里只是測試。lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
            lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });var oData = new { total = lstRes.Count, rows = lstRes.Skip(offset).Take(limit).ToList() };return new PageResult(oData, Request);
        }
復(fù)制代碼

最好,ajax調(diào)用

復(fù)制代碼
$(function () {
    $.ajax({
        type: 'get',
        url: 'http://localhost:21528/api/Order/GetPageRow',
        data: { limit:1,offset:1},
        success: function (data, status) {
            alert(data);
        }
    });
});
復(fù)制代碼

得到結(jié)果

三、HttpResponseMessage

在上文自定義IHttpActionResult返回類型的時候,提到過HttpResponseMessage這個對象。它表示向客戶端返回一個http響應(yīng)的消息對象(包含http狀態(tài)碼和需要返回客戶端的消息)。這個對象也有它獨特的使用場景:需要向客戶端返回HttpResponse時就要用到這個對象。以導(dǎo)出為例,由于需要將導(dǎo)出的Excel文件輸出到客戶端瀏覽器,Webapi的服務(wù)端需要向Web的客戶端輸出文件流,這個時候一般的IHttpActionResult對象不方便解決這個問題,于是HttpReponseMessage派上了用場。我們來看看它的使用示例。

復(fù)制代碼
    public HttpResponseMessage Export()
        {//取數(shù)據(jù)var lstRes = OrderBLL.Export();//向Excel里面填充數(shù)據(jù)HSSFWorkbook workbook = new HSSFWorkbook();
            CreateAndFillSheet(workbook, lstRes);            //保存到服務(wù)var fileName = "Excel" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xls";var strPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, @"Data\" + fileName);using (FileStream fs = new FileStream(strPath, FileMode.Create))
            {
                workbook.Write(fs);using (MemoryStream ms = new MemoryStream())
                {
                    workbook.Write(ms);
                }
            }//輸出到瀏覽器try{var stream = new FileStream(strPath, FileMode.Open);
                HttpResponseMessage response = new HttpResponseMessage(HttpStatusCode.OK);
                response.Content = new StreamContent(stream);
                response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
                response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
                {
                    FileName = fileName
                };return response;
            }catch{return new HttpResponseMessage(HttpStatusCode.NoContent);
            }
        }
復(fù)制代碼

將文件流保存在StreamContent對象里面,然后輸出到瀏覽器。在瀏覽器端即可將Excel輸出。

四、自定義類型

以上幾種返回值類型能解決我們大部分返回值的問題,當然,你也可以將webapi的接口和普通方法一樣,返回任意的類型,WebApi會自動序列化你自定義任何返回類型,然后將序列化的值寫到響應(yīng)正文里,狀態(tài)碼統(tǒng)一返回200。比如:

復(fù)制代碼
        [HttpGet]public object GetOther()
        {var lstRes = new List<ORDER>();//實際項目中,通過后臺取到集合賦值給lstRes變量。這里只是測試。lstRes.Add(new ORDER() { ID = "aaaa", NO = "111", NAME = "111", DESC = "1111" });
            lstRes.Add(new ORDER() { ID = "bbbb", NO = "222", NAME = "222", DESC = "2222" });return lstRes;
        }
復(fù)制代碼

得到結(jié)果

和上面的Json、Ok等用法在效果上面沒有太大區(qū)別。

五、總結(jié) 

以上通過四個方面詳細分享了下WebApi里面返回值的常見用法,不能說哪種方式最好,因為每種方式都有其特定的使用場景。博主覺得為了規(guī)范WebApi接口,對于一般接口的返回值,盡量使用IHttpActionResult類型作為返回值,畢竟是微軟內(nèi)置的東西,可能為我們考慮了很多我們考慮不到的東西。當然,你可能會覺得麻煩,你可能會說直接和普通方法一樣來使用不是更爽,博主當初也有這種想法,可是學習微軟的東西多了之后發(fā)現(xiàn)很多東西還是遵守一定的標準比較好,至少維護起來方便。這就像博主最近正在努力學習的WebApi+oData一樣,為什么要搞這么一套標準性的東西,還不是為了更加方便地規(guī)范Restful風格。如果本文能幫到你,不妨推薦下,您的推薦是博主繼續(xù)總結(jié)的動力!



    本站是提供個人知識管理的網(wǎng)絡(luò)存儲空間,所有內(nèi)容均由用戶發(fā)布,不代表本站觀點。請注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購買等信息,謹防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請點擊一鍵舉報。
    轉(zhuǎn)藏 分享 獻花(0

    0條評論

    發(fā)表

    請遵守用戶 評論公約

    類似文章 更多