Контроллеры веб-API в ASP.NET Core

В предыдущем упражнении вы создали веб-приложение, которое предоставляет примеры данных прогноза погоды, а затем взаимодействуете с ним в цикле ЧТЕНИЯ-Eval-Print (REPL).

Прежде чем переходить к написанию собственного класса PizzaController, давайте взглянем на код в примере WeatherController и разберемся, как это работает. В этом уроке вы узнаете, как WeatherController использовать базовый ControllerBase класс и несколько атрибутов .NET для создания функционального веб-API в нескольких десятках строк кода. После того как вы понимаете эти понятия, вы готовы написать собственный PizzaController класс.

Ниже приведен полный код класса WeatherController. Не беспокойтесь, если пока ничего не понятно. Давайте рассмотрим его пошаговые шаги.

using Microsoft.AspNetCore.Mvc;

namespace ContosoPizza.Controllers;

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
    private static readonly string[] Summaries = new[]
    {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet(Name = "GetWeatherForecast")]
    public IEnumerable<WeatherForecast> Get()
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

Базовый класс: ControllerBase

Контроллер — это открытый класс с одним или несколькими общедоступными методами, известными как действия. По соглашению контроллер помещается в каталог контроллеров корневого проекта. Эти действия предоставляются в виде конечных точек HTTP через механизм маршрутизации. Поэтому HTTP-запрос GET к https://localhost:{PORT}/weatherforecast вызывает выполнение метода Get() из класса WeatherForecastController.

Первое, что можно отметить: этот класс наследует от базового класса ControllerBase. Этот базовый класс предоставляет много стандартных функций для обработки HTTP-запросов, поэтому вы можете сосредоточиться на конкретной бизнес-логике приложения.

Атрибуты класса для контроллера API

К WeatherForecastController применяются два важных атрибута, которые представлены в следующем коде:

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase

[ApiController] позволяет использовать предопределенные подходы, которые упрощают создание веб-API. Некоторые действия включают вывод источника параметров, маршрутизацию атрибутов в качестве требования и улучшения обработки ошибок проверки модели*.

[Route] определяет шаблон маршрутизации [controller]. Имя контроллера (регистр игнорируется, без суффикса Controller) заменяет токен [controller]. Этот контроллер обрабатывает запросы к https://localhost:{PORT}/weatherforecast.

Предоставление прогноза погоды с помощью метода Get()

WeatherForecastController включает одно действие контроллера, которое обозначено атрибутом [HttpGet(Name = "GetWeatherForecast")]. Этот атрибут направляет HTTP-запросы GET в метод public IEnumerable<WeatherForecast> Get(). Как вы видели в предыдущем упражнении, запросы на https://localhost:{PORT}/weatherforecast возвращение результатов погоды.

Как вы узнаете позже в этом модуле, другие распространенные действия связаны с веб-API, выполняющим операции CRUD (GET, PUT, , POST). DELETE Но контроллер API должен реализовывать только одно действие контроллера.

В этом случае вы получаете полный WeatherForecast список возвращаемых элементов. Операция GET также позволяет получить один элемент путем передачи идентификатора. В ASP.NET можно получить один элемент с помощью атрибута [HttpGet("{id}")] . Этот атрибут вы реализуете в следующем упражнении.

Теперь, когда вы знаете основные компоненты контроллера веб-API, вы готовы создать собственный PizzaController класс.