Akce CRUD v ASP.NET Core

• 5 min

Naše služba pizzy podporuje operace C reate, R ead, U pdate, D elete (CRUD) pro seznam pizz. Tyto operace se provádějí pomocí operací akcí HTTP, které se mapují pomocí ASP.NET Core atributů. Jak jste viděli, příkaz akce HTTP GET slouží k načtení jedné nebo více položek ze služby. Taková akce je anotována atributem [HttpGet].

Následující tabulka ukazuje mapování čtyř operací, které pro naši pizzerii provádíme:

Už jste viděli, jak fungují akce GET. Pojďme se dozvědět více o akcích POST, PUT a DELETE.

POST

Aby měl koncový bod možnost přidat novou položku, musíme implementovat akci POST pomocí [HttpPost]. Předáním položky (v tomto příkladu Pizza) do metody jako parametru převede ASP.NET Core automaticky všechny aplikace/json odeslané do koncového bodu na naplněný objekt .NET Pizza.

Tady je podpis metody, Create kterou budete implementovat v další části:

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

Atribut [HttpPost] bude mapovat požadavky HTTP POST odeslané http://localhost:5000/pizza do metody Create() . Místo vrácení seznamu pizz, jak jsme viděli pomocí metody , tato metoda vrátí odpověď, která klientovi umožní vědět, jestli byla žádost úspěšná, a ID nově Get() IActionResult vytvořené pizzy. To se provádí pomocí standardních stavových kódů HTTP, takže se snadno integruje s klienty bez ohledu na jazyk nebo platformu, na které běží.

Naštěstí má nástrojové metody, které pro nás vytvoří odpovídající kódy odpovědí ControllerBase a zprávy HTTP. V dalším cvičení uvidíte, jak tyto postupy fungují.

PUT

Úprava nebo aktualizace pizzy v inventáři se podobá metodě POST, kterou jsme implementovali, ale použije atribut [HttpPut] a kromě objektu Pizza, který je potřeba aktualizovat, použije atribut [HttpPut].

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

Každý výsledek akce (ActionResult) použitý v předchozí akci se namapuje k odpovídajícímu stavovému kódu HTTP v následující tabulce.

DELETE

Jednou z jednodušších akcí, které je možné implementovat, je akce DELETE, která provede odebrání z mezipaměti v paměti pouze ID pizzy.

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

Každý výsledek akce (ActionResult) použitý v předchozí akci se namapuje k odpovídajícímu stavovému kódu HTTP v následující tabulce.

V následujících částech se dozvíte, jak každou z těchto čtyř akcí podporovat ve webovém rozhraní API.

Prověřte své znalosti