La versión más básica que responde con a JsonResult es:
// GET: api/authors
[HttpGet]
public JsonResult Get()
{
return Json(_authorRepository.List());
}
Sin embargo, esto no ayudará con su problema porque no puede manejar explícitamente su propio código de respuesta
La forma de controlar los resultados del estado es devolver un, ActionResultque es donde puede aprovechar el StatusCodeResult tipo.
por ejemplo:
// GET: api/authors/search?namelike=foo
[HttpGet("Search")]
public IActionResult Search(string namelike)
{
var result = _authorRepository.GetByNameSubstring(namelike);
if (!result.Any())
{
return NotFound(namelike);
}
return Ok(result);
}
## Cosas extra
El problema con el que me encuentro con bastante frecuencia es que quería un control más granular sobre mi WebAPI en lugar de simplemente ir con la configuración predeterminada de la plantilla "Nuevo proyecto" en VS.
Asegurémonos de conocer algunos de los conceptos básicos ...
Paso 1: configura tu servicio
Para que su ASP.NET Core WebAPI responda con un objeto serializado JSON junto con el control total del código de estado, debe comenzar asegurándose de haber incluido el AddMvc()servicio en su ConfigureServicesmétodo que generalmente se encuentra en Startup.cs.
Es importante tener en cuenta que AddMvc()incluirá automáticamente el formateador de entrada / salida para JSON junto con la respuesta a otros tipos de solicitudes.
Si su proyecto requiere un control total y desea definir estrictamente sus servicios, por ejemplo, cómo se comportará su WebAPI ante varios tipos de solicitudes, incluidas application/json y no responder a otros tipos de solicitudes (como una solicitud estándar del navegador), puede definirlo manualmente con el siguiente código:
public void ConfigureServices(IServiceCollection services)
{
// Build a customized MVC implementation, without using the default AddMvc(), instead use AddMvcCore().
// https://github.com/aspnet/Mvc/blob/dev/src/Microsoft.AspNetCore.Mvc/MvcServiceCollectionExtensions.cs
services
.AddMvcCore(options =>
{
options.RequireHttpsPermanent = true; // does not affect api requests
options.RespectBrowserAcceptHeader = true; // false by default
//options.OutputFormatters.RemoveType<HttpNoContentOutputFormatter>();
//remove these two below, but added so you know where to place them...
options.OutputFormatters.Add(new YourCustomOutputFormatter());
options.InputFormatters.Add(new YourCustomInputFormatter());
})
//.AddApiExplorer()
//.AddAuthorization()
.AddFormatterMappings()
//.AddCacheTagHelper()
//.AddDataAnnotations()
//.AddCors()
.AddJsonFormatters(); // JSON, or you can build your own custom one (above)
}
Notará que también he incluido una forma de agregar sus propios formateadores de entrada / salida personalizados, en caso de que desee responder a otro formato de serialización (protobuf, thrift, etc.).
El fragmento de código anterior es principalmente un duplicado del AddMvc()método. Sin embargo, estamos implementando cada servicio "predeterminado" por nuestra cuenta definiendo todos y cada uno de los servicios en lugar de ir con el pre-enviado con la plantilla. He agregado el enlace del repositorio en el bloque de código, o puede consultarlo AddMvc() desde el repositorio de GitHub. .
Tenga en cuenta que hay algunas guías que intentarán resolver esto "deshaciendo" los valores predeterminados, en lugar de simplemente no implementarlo en primer lugar ... Si tiene en cuenta que ahora estamos trabajando con código abierto, este es un trabajo redundante. , mal código y francamente un viejo hábito que pronto desaparecerá.
La versión más básica que responde con a JsonResultes:
// GET: api/authors
[HttpGet]
public JsonResult Get()
{
return Json(_authorRepository.List());
}
Sin embargo, esto no ayudará con su problema porque no puede manejar explícitamente su propio código de respuesta.
La forma de controlar los resultados del estado es devolver un, ActionResultque es donde puede aprovechar el StatusCodeResulttipo.
por ejemplo:
// GET: api/authors/search?namelike=foo
[HttpGet("Search")]
public IActionResult Search(string namelike)
{
var result = _authorRepository.GetByNameSubstring(namelike);
if (!result.Any())
{
return NotFound(namelike);
}
return Ok(result);
}
Tenga en cuenta que los dos ejemplos anteriores provienen de una excelente guía disponible en la documentación de Microsoft: Formateo de datos de respuesta
Cosas extra
El problema con el que me encuentro con bastante frecuencia es que quería un control más granular sobre mi WebAPI en lugar de simplemente ir con la configuración predeterminada de la plantilla "Nuevo proyecto" en VS.
Asegurémonos de conocer algunos de los conceptos básicos ...
Paso 1: configura tu servicio
Para que su ASP.NET Core WebAPI responda con un objeto serializado JSON junto con el control total del código de estado, debe comenzar asegurándose de haber incluido el AddMvc()servicio en su ConfigureServicesmétodo que generalmente se encuentra en Startup.cs.
Es importante tener en cuenta que AddMvc()incluirá automáticamente el formateador de entrada / salida para JSON junto con la respuesta a otros tipos de solicitudes.
Si su proyecto requiere un control total y desea definir estrictamente sus servicios, por ejemplo, cómo se comportará su WebAPI ante varios tipos de solicitudes, incluidas application/jsony no responder a otros tipos de solicitudes (como una solicitud estándar del navegador), puede definirlo manualmente con el siguiente código:
public void ConfigureServices(IServiceCollection services)
{
// Build a customized MVC implementation, without using the default AddMvc(), instead use AddMvcCore().
// https://github.com/aspnet/Mvc/blob/dev/src/Microsoft.AspNetCore.Mvc/MvcServiceCollectionExtensions.cs
services
.AddMvcCore(options =>
{
options.RequireHttpsPermanent = true; // does not affect api requests
options.RespectBrowserAcceptHeader = true; // false by default
//options.OutputFormatters.RemoveType<HttpNoContentOutputFormatter>();
//remove these two below, but added so you know where to place them...
options.OutputFormatters.Add(new YourCustomOutputFormatter());
options.InputFormatters.Add(new YourCustomInputFormatter());
})
//.AddApiExplorer()
//.AddAuthorization()
.AddFormatterMappings()
//.AddCacheTagHelper()
//.AddDataAnnotations()
//.AddCors()
.AddJsonFormatters(); // JSON, or you can build your own custom one (above)
}
Notará que también he incluido una forma de agregar sus propios formateadores de entrada / salida personalizados, en caso de que desee responder a otro formato de serialización (protobuf, thrift, etc.).
El fragmento de código anterior es principalmente un duplicado del AddMvc()método. Sin embargo, estamos implementando cada servicio "predeterminado" por nuestra cuenta definiendo todos y cada uno de los servicios en lugar de ir con el pre-enviado con la plantilla. He agregado el enlace del repositorio en el bloque de código, o puede consultarlo AddMvc() desde el repositorio de GitHub. .
Tenga en cuenta que hay algunas guías que intentarán resolver esto "deshaciendo" los valores predeterminados, en lugar de simplemente no implementarlo en primer lugar ... Si tiene en cuenta que ahora estamos trabajando con código abierto, este es un trabajo redundante. , mal código y francamente un viejo hábito que pronto desaparecerá.
Paso 2: crea un controlador
Voy a mostrarte uno realmente sencillo solo para resolver tu pregunta.
public class FooController
{
[HttpPost]
public async Task<IActionResult> Create([FromBody] Object item)
{
if (item == null) return BadRequest();
var newItem = new Object(); // create the object to return
if (newItem != null) return Ok(newItem);
else return NotFound();
}
}
### Paso 3: revisa tu Content-TypeyAccept
Debe asegurarse de que sus encabezados Content-Typey Accepten su solicitud estén configurados correctamente. En su caso (JSON), querrá configurarlo para que sea application/json.
Si desea que su WebAPI responda como JSON de forma predeterminada, independientemente de lo que especifique el encabezado de la solicitud, puede hacerlo de varias maneras .
Forma 1 Como se muestra en el artículo que recomendé anteriormente ( Formateo de datos de respuesta ), puede forzar un formato particular en el nivel de Controlador / Acción. Personalmente no me gusta este enfoque ... pero aquí está para completar:
Forzar un formato particular Si desea restringir los formatos de respuesta para una acción específica, puede aplicar el filtro [Produce]. El filtro [Produce] especifica los formatos de respuesta para una acción específica (o controlador). Como la mayoría de los filtros, esto se puede aplicar en la acción, el controlador o el ámbito global.
[Produces("application/json")]
public class AuthorsController
El filtro [Produces] obligará a todas las acciones dentro del AuthorsControllera devolver respuestas con formato JSON, incluso si se configuraron otros formateadores para la aplicación y el cliente proporcionó un Acceptencabezado solicitando un formato diferente disponible.
Forma 2 Mi método preferido es que WebAPI responda a todas las solicitudes con el formato solicitado. Sin embargo, en el caso de que no acepte el formato solicitado, recurra a un formato predeterminado (es decir, JSON)
Primero, deberá registrar eso en sus opciones (necesitamos reelaborar el comportamiento predeterminado, como se señaló anteriormente)
options.RespectBrowserAcceptHeader = true; // false by default
Finalmente, simplemente reordenando la lista de los formateadores que se definieron en el generador de servicios, el servidor web tomará por defecto el formateador que usted coloca en la parte superior de la lista (es decir, la posición 0).
return OK(return await _context.Clientes.ToListAsync());