Manejo de rutas

Brian Steven Gonzalez Chavez

student•

Les recomiendo usar el comando:

dotnet watch run, en lugar de
dotnet run.

Lo que hace este comando es, compilar de forma automática cada vez que se modifica un archivo y no tener que estar bajando el servicio cada vez que modificamos algo.

Parecido al paquete de "Nodemon" de node.js

Luis Vargas

student•

Gracias por el dato

Dual.william.may

student•

Gracias

Diego Ferney Carrion Muñoz

student•

En mi caso al hacer paso a paso del video en el minuto 4:00 y querer agregar una ruta a la accion HttpGet me arrojaba el siguinete error: Failed to load API definition Errors Hide Fetch errorresponse status is 500

solución: no se si este bien?, pero me funciono :) !!, por consiguinete cambie en la linea 34 Name =[HttpGet("GetWeatherForecast")] y lo modifique solo a [HttpGet] sin llamar el nombre, debido a que si le colocaba el nombre me salía error

Platzi Team

student•

Manejo de rutas

En ***.NET***, puedes usar el enrutamiento para definir cómo deben estructurarse las URL de tu API y cómo deben asociarse con los métodos en los controladores.

Nuestra API de .Net nos permite personalizar la ruta desde la cual se prodra acceder a los servicio:

[ApiController]
[Route("api/[controller]")]

public class WeatherForecastController : ControllerBase {}

El atributo Route es un atributo de enrutamiento que se utiliza para definir la ruta base para las acciones en un controlador. En este caso, la ruta base para las acciones en este controlador será "api/[controller]", donde "[controller]" se reemplazará automáticamente con el nombre del controlador sin la palabra "Controller". Por ejemplo, si el nombre del controlador es "WeatherForecastController", la ruta base para las acciones será "api/WeatherForecast".

[Route("[action]")]
	public IEnumerable<WeatherForecast> Getw() {}

El atributo Route se utiliza para definir la ruta para la acción. En este caso, la ruta será "[action]", donde "[action]" se reemplazará automáticamente con el nombre del método de acción. Por ejemplo, si el nombre del método de acción es "Get", la ruta para esta acción será "Get".

Gerson Francisco Mendoza Carranza

student•

Cuando pongo el [Route("[action]")], el Swagger deja de funcionar y me arroja Failed to load API definition.

Miguel Teheran

teacher•

Sip, esto es por que Swagger sigue un estandar llamado OpenAPI si por alguna razon la configuración de la API viola el estandar entonces se genera el error. Para mas información: https://swagger.io/specification/

Juan Sebastian Ramirez Leyva

student•

Son necesarios la route, porque se podria enviar directemente con el verbo adjunto de esta manera

[HttpGet("listar")]
public IEnumerable<WeatherForecast> Get()
{
    return listWeatherForecast;
}

[HttpPost("guardar")]
public IActionResult Post(WeatherForecast weatherForecast){
    listWeatherForecast.Add(weatherForecast);
    return Ok();
}

[HttpDelete("eliminar/{id}")]
public IActionResult Delete(int index){
    listWeatherForecast.RemoveAt(index);
    return Ok();
}

Ayrton César La Madrid Martinez

student•

No son necesarios solo es una buena practica colocar en Route para tener el código estandarizado

Emerson Cedeño

student•

a fin de agregar la versión del API en las rutas, cómo se podría parametrizar este valor, digamos desde el appsettings.json?

Miguel Teheran

teacher•

Debe ser un nombre estatico lo que normalmente se hace es crear constantes con valores estaticos dentro del código. Existen librerias también que te permiten versionar de una manera mas elegante: https://docs.microsoft.com/en-us/shows/visual-studio-toolbox/versioning-aspnet-core-services

pero sigue quedando todo en el código no es algo configurable puede ser peligroso al pasar a producción.

Gaspar.meza

student•

HTTPGet(Name="nombreDelAction") ¿Para que nos sirve agregar un nombre al action?

Luis Cardona

student•

Tengo la misma duda.

Franklin Gil

student•

Investigando, vi que no tiene ninguna utilidad en el Routing, solo es para darle un nombre a la ruta y te puede servir para hacer referencia a una ruta por su nombre.

Ej:

var url = Url.Link("nombreDelAction", null);
return Ok(url);

Algo similar pasa en Laravel, donde puedes hacer: Route(...)->name('foo') y hacer referenca a ello por redirect()->route('foo')

Facundo Oubel

student•

No se considera una mala práctica poner la ruta más de una vez? Osea volver a asignarsela a un get como se muestra en el video, al menos a mi en el trabajo me dijeron eso...

Miguel Teheran

teacher•

Si es mala practica, la idea es tener solo una ruta por recurso, pero igual era importante mostrar que se puede hacer y coo se configura todo en .NET

Melissa González Nebrijo

student•

Tuve un error 500 al intentar añadir el Route en el controlador:

[HttpGet(Name = "GetWeatherForecast")]
[Route("Get/weatherForecast")]
public IEnumerable<WeatherForecast> Get() 
{
    return ListWeatherForecast;
}

Entonces lo solucioné de esta manera:

[HttpGet("Get/weatherforecast", Name = "GetWeatherForecast")]

Andres Gonzalez

student•

Sucede que ahora no toma el parámetro index del método Delete, tengo que especificar de la siguiente forma ?index=valor (no lo toma si solo hago /valor)

Andres Gonzalez

student•

Para arreglar esto, tuve que agregar la ruta al atributo http quedando así /{index}

Luis Eduardo Chaparro roa

student•

Me parece interactivo y amigable poder renombrar métodos dentro de una clase de controlador con [Route ...], pero veo que el costo es que se pierde la visualización del swagger dado que no se cumple el estándar. La pregunta es: 1. hay manera de poder renombrar métodos dentro de un controlador y conservar la funcionalidad del swagger? O 2. lo adecuado es no crear mas de un método del mismo verbo dentro de un controlador? y manejar el nombramiento a nivel de controlador? Agradezco la aclaración. Y 3. hay algún número de métodos adecuados por controlador ?

Miguel Teheran

teacher•

Lo normal es colocar el método en la definición del tipo de llamado [HttpGet("GetById/{id}")]
Realmente depende del escenario lo importante es que por ejemplo el POST general haga la inserción del registro que es lo que uno espera, metodos particupales deben tener su proposito particular
todos los que necesites de acuerdo a tu negocio, si se esta volviendo muy grande el controlador puedes separarlos en 2 (Siguiendo los principios SOLID y de buenas practicas)

Carlos Andres Bohorquez Duran

student•

Al dejar la ruta como esta el template: [Route("[controller]")], controller a que ahec referencia al nombre de la clase???

Miguel Teheran

teacher•

Al nombre del controlador por ejmplo, UserController la ruta seria api/user es el nombre que tiene sin la palabra Controller

Carlos Andres Bohorquez Duran

student•

Muchas gracias Miguel, entendido

Jose Jeisson Ceballos Leal

student•

comando especifico para que compile de manera automatica:

mi proyecto lo nombre webapi

dotnet watch run --webapi WebApp run

John Salcedo

student•

este video sirve o soy el único que no lo puedo ver ?

Sebastián Silva Hernández

student•

Si el controlador tiene la palabra Controller al final, por que esta ruta

[Route("[controller]")]

Nos permite solo contemplar WeatherForecast?

Daniel Valencia Alvarez

student•

Internamente C# dentro de su lógica toma dicha instrucción creando la ruta para el consumo de dicho recurso tomando el nombre del controlador pero obviando la palabra "controller" porque ese nombre es tan solo usado como estandar para la comunicación entre componentes, y sigue siendo transparente para el usuario, de hecho, la ruta final es en minúscula sostenida dado que la nomenclatura Pascal Case.

Emerson Cedeño

student•

Bajo qué escenarios o casos de uso es útil tener varias rutas para una misma acción?, se me ocurre marketing digital ...

Miguel Teheran

teacher•

Aveces se necesitan enlaces cortos y otro lado enlaces que siguen el patrón REST. En estos casos es bueno tener varias rutas.

Ricardo David

student•

Excelente aporte con el manejo de rutas.[HttpGet(Name = "GetWeatherForecast")] [Route("Get/weatherforecast")] [Route("[action]")]```js [HttpGet(Name = "GetWeatherForecast")] [Route("Get/weatherforecast")] [Route("[action]")]

Julian David Colorado Jaramillo

student•

Carlos Madrigal Ramos

student•

Pueden utilizar para tomar el nombre del metodo y un indice indicado en la ruta

[HttpDelete("[action]/{index}")]

Alejandro Molina Bastidas

student•

Existe alguna documentación mas reciente?, debido a que cuando creo el proyecto no me salen las mismas carpetas y archivos

Juan Camilo Salazar Serna

student•

cuando crees el proyecto, utiliza el siguiente comando dotnet new webapi --use-controllers

Me imagino que para el .net del profe (version 6), eso estaba por defecto, pero para la mia (version 8) hay que colocar eso.

[HttpGet("listar")]
public IEnumerable<WeatherForecast> Get()
{
    return listWeatherForecast;
}

[HttpPost("guardar")]
public IActionResult Post(WeatherForecast weatherForecast){
    listWeatherForecast.Add(weatherForecast);
    return Ok();
}

[HttpDelete("eliminar/{id}")]
public IActionResult Delete(int index){
    listWeatherForecast.RemoveAt(index);
    return Ok();
}

Manejo de rutas

Introducción a API en .NET

Domina las API con .NET

Prerrequisitos

¿Qué es una API?

¿Qué es REST?

Creando tu primera API con .NET

Funcionamiento de una API en .NET

Consumiendo API desde Postman

Análisis del template para APIs de .NET

Atributos para verbos HTTP

Manejo de rutas

Minimal API vs. Web API

Arquitectura y configuración

¿Qué son los middlewares?

Creando un nuevo middleware

Inyección de dependencias

Agregando Logging a API

Documentando API con Swagger

Manipulación de datos con Entity Framework

Agregando librerías para Entity Framework

Configuración de Entity framework y clases base

Creación de servicios

Inyectando servicios como dependencia

Creando controladores

Probando API con una base de datos SQL server

Outro

Retrospectiva: APIs con .NET