在asp.net Core之前所有的Action返回值都是ActionResult,Json(),File()等方法返回的都是Action Result的子類。并且Core把MVC跟WebApi合并之后Action的返回值體系也有了很大的變化。
ActionResult類
ActionResult類是最常用的返回值類型。基本沿用了之前Asp.net MVC的那套東西,使用它大部分情況都沒問題。比如用它來返回視圖,返回json,返回文件等等。如果是異步則使用Task。
publicclassTestController:Controller
{
publicActionResultIndex()
{
returnView();
}
publicActionResultMyFile()
{
returnFile(newbyte[]{},"image/jpg");
}
publicActionResultMyJson()
{
returnJson(new{name="json"});
}
publicActionResultOk()
{
returnOk();
}
}
IActionResult接口
ActionResult類實(shí)現(xiàn)了IActionResult接口所以能用ActionResult的地方都可以使用IActionResult來替換。同樣異步的話使用Task包起來做為返回值。
publicclassITestController:Controller
{
publicIActionResultIndex()
{
returnView();
}
publicIActionResultMyFile()
{
returnFile(newbyte[]{},"image/jpg");
}
publicIActionResultMyJson()
{
returnJson(new{name="json"});
}
publicIActionResultHttpOk()
{
returnOk();
}
publicasyncTask
{
awaitTask.Delay(1000);
returnContent("ok");
}
}
直接返回POCO類
Asp.net Core的Controller的Action可以把POCO類型(其實(shí)不一定是POCO類,可以是任意類型,但是使用的時(shí)候一般都返回viwemodel等POCO類)當(dāng)做返回值,不一定非要是ActionResult或者IActionResult。Asp.net Core框架會幫我們自動序列化返回給前端,默認(rèn)使用json序列化。同樣異步的話使用Task包起來做為返回值。
publicclassPerson
{
publicstringName{get;set;}
publicstringSex{get;set;}
}
publicclassITestController:Controller
{
publicPersonGetPerson()
{
returnnewPerson{Name="abc",Sex="f"};
}
publicasyncTask>GetPersons()
{
awaitTask.Delay(1000);
returnnewList
newPerson{Name="abc",Sex="f"},
newPerson{Name="efg",Sex="m"}
};
}
}
ActionResult< T >泛型類
當(dāng)我們設(shè)計(jì)restful webapi系統(tǒng)的時(shí)候習(xí)慣使用POCO做為返回值。比如我們設(shè)計(jì)一個(gè)獲取Person的api。通過 /person/001 url獲取001號person。
[Route("[controller]")]
publicclassPersonController:Controller
{
IPersonRepository_repository;
PersonController(IPersonRepositoryrepository)
{
_repository=repository;
}
[HttpGet("{id}")]
publicPersonGet(stringid)
{
return_repository.Get(id);
}
}
這個(gè)方法看起來好像沒什么問題,但其實(shí)有個(gè)小問題。如果repository.Get方法沒有根據(jù)id查找到數(shù)據(jù),那么將會返回null。如果null做為Action的返回值,最后框架會轉(zhuǎn)換為204的http status code。
204表示No Content 。做為restful api,204的語義在這里會有問題,這里比較適合的status code是404 NOT FOUND 。那么我們來改一下:
[HttpGet("{id}")]
publicPersonGet(stringid)
{
varperson=_repository.Get(id);
if(person==null)
{
Response.StatusCode=404;
}
returnperson;
}
現(xiàn)在如果查找不到person數(shù)據(jù),則系統(tǒng)會返回404 Not Found 。
但是這看起來顯然不夠優(yōu)雅,因?yàn)镃ontrollerBase內(nèi)置了NotFoundResult NotFound() 方法。這使用這個(gè)方法代碼看起來更加清晰明了。繼續(xù)改:
[HttpGet("{id}")]
publicPersonGet(stringid)
{
varperson=_repository.Get(id);
if(person==null)
{
returnNotFound();
}
returnperson;
}
很不幸,這段代碼VS會提示錯(cuò)誤。因?yàn)榉祷刂殿愋筒灰恢隆7椒ê灻姆祷刂凳荘erson,但是方法內(nèi)部一會返回NotFoundResult,一會返回Person。
解決這個(gè)問題就該ActionResult< T >出場了。我們繼續(xù)改一下:
[HttpGet("{id}")]
publicActionResult
{
varperson=_repository.Get(id);
if(person==null)
{
returnNotFound();
}
returnperson;
}
現(xiàn)在VS已經(jīng)不會報(bào)錯(cuò)了,運(yùn)行一下也可以正常工作。但仔細(xì)想想也很奇怪,為什么返回值類型改成了ActionResult< Person >就不報(bào)錯(cuò)了呢?明明返回值類型跟方法簽名還是不一致啊?
深入ActionResult< T >
接上面的問題,讓我們看一下ActionResult的內(nèi)部:
看到這里就明白了原來ActionResult< T >里面內(nèi)置了2個(gè)implicit operator方法。implicit operator用于聲明隱式類型轉(zhuǎn)換。
publicstaticimplicitoperatorActionResult
表示ActionResult類型可以轉(zhuǎn)換為ActionResult< TValue >類型。
publicstaticimplicitoperatorActionResult
表示TValue類型可以轉(zhuǎn)換為ActionResult< TValue >類型。
因?yàn)橛辛诉@2個(gè)方法,當(dāng)ActionResult或者TValue類型往ActionResult< T >賦值的時(shí)候會進(jìn)行一次自動的類型轉(zhuǎn)換。所以VS這里不會報(bào)錯(cuò)。
總結(jié)
大部分時(shí)候Action的返回值可以使用ActionResult/IActionResult
設(shè)計(jì)restful api的時(shí)候可以直接使用POCO類作為返回值
如果要設(shè)計(jì)既支持POCO類返回值或者ActionResult類為返回值的action可以使用ActionResult< T >作為返回值
ActionResult< T >之所以能夠支持兩種類型的返回值類型,是因?yàn)槭褂昧薸mplicit operator內(nèi)置了2個(gè)隱式轉(zhuǎn)換的方法
到此這篇關(guān)于ASP.NET Core中的Action的返回值類型實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)ASP.NET Core Action的返回值類型內(nèi)容請搜索服務(wù)器之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持服務(wù)器之家!
原文鏈接:https://www.cnblogs.com/kklldog/p/aspnetcore-actionresult.html