Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

как ожидалось. Редактировать и продолжать выполнение не удастся; чтобы изменения отразились в функционирующем приложении, придется отсоединиться от процесса.

Присоединение с помощью Visual Studio Code

После запуска приложения (командой dotnet run или dotnet watch run) щелкните на кнопке запуска с зеленой стрелкой и выберите .NET Core Attach (Присоединение .NET Core) вместо .NET Core Launch (web) (Запуск .NET Core (веб)), как показано на рис. 29.5.

Когда вы щелкнете на кнопке запуска, вам будет предложено выбрать процесс для присоединения к нему. Выберите свое приложение. Затем можете устанавливать точки останова обычным образом.

Преимущество использования среды VS Code заключается в том, что после ее присоединения (и применения команды dotnet watch run) вы можете обновлять свой код во время выполнения (без необходимости в отсоединении) и вносимые изменения будут отражаться в функционирующем приложении.

Обновление портов AutoLot.Api

Вы могли заметить, что приложения AutoLot.Api и AutoLot.Mvc имеют разные порты, указанные для их профилей IIS Express, но для обоих приложений порты Kestrel установлены в 5000 (HTTP) и 5001 (HTTPS), что вызовет проблемы, когда вы попытаетесь запустить приложения вместе. Измените порты для AutoLot.Api на 5020 (HTTP) и 5021 (HTTPS), например:

"AutoLot.Api": {

  "commandName": "Project",

  "launchBrowser": true,

  "launchUrl": "api/values",

  "applicationUrl": "https://localhost:5021;http://localhost:5020",

  "environmentVariables": {

  "ASPNETCORE_ENVIRONMENT": "Development"

  }

}

Создание и конфигурирование экземпляра WebHost

В отличие от классических приложений ASP.NET MVC или ASP.NET Web API приложения ASP.NET Core — это просто консольные приложения .NET Core, которые создают и конфигурируют экземпляр WebHost. Создание экземпляра WebHost и его последующее конфигурирование обеспечивают настройку приложения на прослушивание (и реагирование) на запросы HTTP. Экземпляр WebHost создается в методе Main() внутри файла Program.cs. Затем экземпляр WebHost конфигурируется для вашего приложения в файле Startup.cs.

Файл Program.cs

Откройте файл класса Program.cs в приложении AutoLot.Api и просмотрите его содержимое, которое для справки приведено ниже:

namespace AutoLot.Api

{

  public class Program

  {

    public static void Main(string[] args)

    {

      CreateHostBuilder(args).Build().Run();

    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>

      Host.CreateDefaultBuilder(args)

        .ConfigureWebHostDefaults(webBuilder =>

          {

            webBuilder.UseStartup<Startup>();

          });

  }

}

Метод CreateDefaultBuilder() ужимает наиболее типовую настройку приложения в один вызов. Он конфигурирует приложение (используя переменные среды и JSON-файлы appsettings), настраивает стандартный поставщик ведения журнала и устанавливает контейнер DI. Такая настройка обеспечивается шаблонами ASP.NET Core для приложений API и MVC.

Следующий метод, ConfigureWebHostDefaults(), тоже является мета-методом, который добавляет поддержку для Kestrel, IIS и дополнительные настройки. Финальный шаг представляет собой установку класса конфигурации, специфичной для приложения, который в данном примере (и по соглашению) называется Startup. Наконец, вызывается метод Run() для активизации экземпляра WebHost.

Помимо экземпляра WebHost в предыдущем коде создается экземпляр реализации IConfiguration, который добавляется внутрь контейнера DI.

Файл Startup.cs

Класс Startup конфигурирует то, как приложение будет обрабатывать запросы и ответы HTTP, настраивает необходимые службы и добавляет службы в контейнер DI. Имя класса может быть любым, если оно соответствует строке UseStartup<T>() в конфигурации метода CreateHostBuilder(), но по соглашению класс именуется как Startup.

Доступные службы для класса Startup

Процессу запуска требуется доступ к инфраструктуре, а также к службам и настройкам среды, которые внедряются в класс инфраструктурой. Классу Startup доступно пять служб для конфигурирования приложения, которые кратко описаны в табл. 29.11.

Конструктор принимает экземпляр реализации IConfiguration и необязательный экземпляр реализации IWebHostEnvironment/IHostEnvironment. Метод ConfigureServices() запускается до того, как метод Configure() получает экземпляр реализации IServiceCollection. Метод Configure() должен принимать экземпляр реализации IApplicationBuilder, но может принимать экземпляры реализаций IWebHostEnvironment/IHostEnvironment, ILoggerFactory и любых интерфейсов, которые были добавлены внутрь контейнера DI в методе ConfigureServices(). Все перечисленные компоненты обсуждаются в последующих разделах.

Конструктор

Конструктор принимает экземпляр реализации интерфейса IConfiguration, который был создан методом Host.CreateDefaultBuilder в файле класса Program.cs, и присваивает его свойству Configuration для использования где-то в другом месте внутри класса. Конструктор также может принимать экземпляр реализации IWebHostEnvironment и/или ILoggerFactory, хотя он не добавляется в стандартном шаблоне.

Добавьте в конструктор параметр для IWebHostEnvironment и присвойте его локальной переменной уровня класса. Это понадобится в методе ConfigureServices(). Проделайте такую же работу для приложений AutoLot.Api и AutoLot.Mvc.

private readonly IWebHostEnvironment _env;

public Startup(

  IConfiguration configuration, IWebHostEnvironment env)

{

  _env = env;

  Configuration = configuration;

}

Метод ConfigureServices()

Метод ConfigureServices() применяется для конфигурирования любых служб, необходимых приложению, и вставки их в контейнер DI. Сюда входят службы, требуемые для поддержки приложений MVC и служб API.

AutoLot.Api

Метод ConfigureServices() для API-интерфейса AutoLot по умолчанию конфигурируется с только одной службой, которая добавляет поддержку контроллеров. Благодаря этому мета-методу добавляется множество дополнительных служб, в том числе маршрутизация, авторизация, привязка моделей и все элементы, не относящиеся к пользовательскому интерфейсу, которые уже обсуждались в настоящей главе.

public void ConfigureServices(IServiceCollection services)

{

  services.AddControllers();

}

Метод AddControllers() может быть расширен, например, для настройки обработки JSON. По умолчанию для ASP.NET Core используется "верблюжий" стиль при обработке JSON (первая буква в нижнем регистре, а каждое последующее слово начинается с буквы верхнего регистра, скажем, carRepo). Это соответствует большинству инфраструктур производства не Microsoft, которые применяются для разработки веб-приложений. Однако в предшествующих версиях ASP.NET использовался стиль Pascal (например, CarRepo). Переход на "верблюжий" стиль был критическим изменением для многих приложений, которые ожидали стиля Pascal. Чтобы вернуть стиль Pascal при обработке JSON приложением (и улучшить форматирование разметки JSON), модифицируйте метод AddControllers() следующим образом:

public void ConfigureServices(IServiceCollection services)

{

  services.AddControllers()

    .AddJsonOptions(options =>

    {

      options.JsonSerializerOptions.PropertyNamingPolicy = null;