Acciones CRUD de ASP.NET Core

• 5 minutos

El servicio de pizzas admite operaciones C reate, R ead, U pdate, D elete (CRUD; Crear, Leer, Actualizar y Eliminar) en una lista de pizzas. Estas operaciones se realizan mediante verbos de acción HTTP, que se asignan por medio de atributos de ASP.NET Core. Como ha visto, el verbo de acción HTTP GET se usa para recuperar uno o más elementos de un servicio. Esta acción se anota con el atributo [HttpGet].

En la tabla siguiente se muestra la asignación de las cuatro operaciones que se están implementando para el servicio de pizzas:

Ya ha visto cómo funcionan las acciones GET. Vamos a obtener más información sobre las acciones POST, PUT y DELETE.

POST

Para dejar que el punto de conexión permita a los usuarios agregar un nuevo elemento, se debe implementar la acción POST mediante [HttpPost]. Al pasar el elemento (en este ejemplo, una pizza) al método como parámetro, ASP.NET Core convierte automáticamente cualquier aplicación o json enviado al punto de conexión en un objeto Pizza de .NET rellenado.

Esta es la firma del método Create que va a implementar en la sección siguiente:

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

El atributo [HttpPost] asigna a las solicitudes HTTP POST enviadas a http://localhost:5000/pizza el método Create(). En lugar de devolver una lista de pizzas, como se ha visto con el método Get(), este método devuelve una respuesta IActionResult, lo que permite al cliente saber si la solicitud se ha ejecutado correctamente y el identificador de la pizza recién creada. Esto se hace con códigos de estado HTTP estándar, por lo que se integra fácilmente con los clientes, independientemente del lenguaje o la plataforma en la que se ejecuten.

Afortunadamente, ControllerBase tiene métodos de utilidad que crean los mensajes y códigos de respuesta HTTP adecuados automáticamente. Va a ver cómo funcionan en el ejercicio siguiente.

PUT

La modificación o actualización de una pizza del inventario es similar al método POST que se ha implementado, aunque se va a usar el atributo [HttpPut] y a tomar el identificador además del objeto Pizza que se debe actualizar.

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

Cada valor ActionResult usado en la acción anterior se asigna al código de estado HTTP correspondiente en la tabla siguiente.

DELETE

Una de las acciones más fáciles de implementar es la acción DELETE, que toma solo el identificador de la pizza que se va a quitar de la caché en memoria.

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

Cada valor ActionResult usado en la acción anterior se asigna al código de estado HTTP correspondiente en la tabla siguiente.

En las siguientes secciones se muestra cómo admitir cada una de estas cuatro acciones en la API web.

Comprobación de conocimientos