CRUD-åtgärder i ASP.NET Core

Vår pizzatjänst stöder CRUD-åtgärder för en lista över pizzor. Dessa åtgärder utförs via HTTP-verb, som mappas via ASP.NET Core-attribut. Som du såg används HTTP-verbet GET för att hämta ett eller flera objekt från en tjänst. Den typen av åtgärd kommenteras med [HttpGet]-attributet.

I följande tabell visas mappningen av de fyra åtgärder som du implementerar för pizzatjänsten:

Du har redan sett hur GET åtgärder fungerar. Nu ska vi lära oss mer om POST, PUToch DELETE åtgärder.

POST

Om du vill göra det möjligt för användare att lägga till ett nytt objekt i slutpunkten måste du implementera POST åtgärden med hjälp av attributet [HttpPost] . När du skickar objektet (i det här exemplet en pizza) till metoden som en parameter konverterar ASP.NET Core automatiskt alla program/JSON som skickas till slutpunkten till ett ifyllt .NET-objekt Pizza .

Här är metodsignaturen för den Create metod som du implementerar i nästa avsnitt:

[HttpPost]
public IActionResult Create(Pizza pizza)
{            
    // This code will save the pizza and return a result
}

Attributet [HttpPost] mappar HTTP-begäranden POST som skickas till http://localhost:5000/pizza med hjälp Create() av -metoden. I stället för att returnera en lista över pizzor, som vi såg med Get()-metoden, returnerar denna metod ett IActionResult-svar.

IActionResult meddelar klienten om begäran lyckades och tillhandahåller ID:t för den nyligen skapade pizzan. IActionResult använder standard-HTTP-statuskoder, så att de enkelt kan integreras med klienter oavsett vilket språk eller vilken plattform de körs på.

Lyckligtvis ControllerBase har verktygsmetoder som skapar lämpliga HTTP-svarskoder och -meddelanden åt dig. Du ser hur dessa metoder fungerar i nästa övning.

PUT

Att ändra eller uppdatera en pizza i vårt lager liknar den POST-metod som du implementerade, men den använder attributet [HttpPut] och tar in parametern id, utöver det Pizza objekt som behöver uppdateras.

[HttpPut("{id}")]
public IActionResult Update(int id, Pizza pizza)
{
    // This code will update the pizza and return a result
}

Varje ActionResult instans som används i föregående åtgärd mappas till motsvarande HTTP-statuskod i följande tabell:

TA BORT

En av de enklaste åtgärderna att implementera är DELETE-åtgärden, som bara använder id-parametern för att ta bort en pizza från minnescachen.

[HttpDelete("{id}")]
public IActionResult Delete(int id)
{
    // This code will delete the pizza and return a result
}

Varje ActionResult instans som används i föregående åtgärd mappas till motsvarande HTTP-statuskod i följande tabell:

Övningen i nästa lektion visar hur du stöder var och en av de fyra åtgärderna i webb-API:et.