Язык программирования C#9 и платформа .NET5
Часть 587 из 642 Информация о книге
public static void Main(string[] args){CreateHostBuilder(args).Build().Run();}public static IHostBuilder CreateHostBuilder(string[] args) =>Host.CreateDefaultBuilder(args).ConfigureWebHostDefaults(webBuilder =>{webBuilder.UseStartup<Startup>();});}}Метод
ужимает наиболее типовую настройку приложения в один вызов. Он конфигурирует приложение (используя переменные среды и JSON-файлыCreateDefaultBuilder()), настраивает стандартный поставщик ведения журнала и устанавливает контейнер DI. Такая настройка обеспечивается шаблонами ASP.NET Core для приложений API и MVC.appsettingsСледующий метод,
, тоже является мета-методом, который добавляет поддержку для Kestrel, IIS и дополнительные настройки. Финальный шаг представляет собой установку класса конфигурации, специфичной для приложения, который в данном примере (и по соглашению) называетсяConfigureWebHostDefaults(). Наконец, вызывается методStartupдля активизации экземпляраRun().WebHostПомимо экземпляра
в предыдущем коде создается экземпляр реализацииWebHost, который добавляется внутрь контейнера DI.IConfigurationФайл Startup.cs
Класс
конфигурирует то, как приложение будет обрабатывать запросы и ответы HTTP, настраивает необходимые службы и добавляет службы в контейнер DI. Имя класса может быть любым, если оно соответствует строкеStartupв конфигурации методаUseStartup<T>(), но по соглашению класс именуется какCreateHostBuilder().StartupДоступные службы для класса Startup
Процессу запуска требуется доступ к инфраструктуре, а также к службам и настройкам среды, которые внедряются в класс инфраструктурой. Классу
доступно пять служб для конфигурирования приложения, которые кратко описаны в табл. 29.11.StartupКонструктор принимает экземпляр реализации
и необязательный экземпляр реализацииIConfiguration. МетодIWebHostEnvironment/IHostEnvironmentзапускается до того, как методConfigureServices()получает экземпляр реализацииConfigure(). МетодIServiceCollectionдолжен принимать экземпляр реализацииConfigure(), но может принимать экземпляры реализацийIApplicationBuilder,IWebHostEnvironment/IHostEnvironmentи любых интерфейсов, которые были добавлены внутрь контейнера DI в методеILoggerFactory. Все перечисленные компоненты обсуждаются в последующих разделах.ConfigureServices()Конструктор
Конструктор принимает экземпляр реализации интерфейса
, который был создан методомIConfigurationв файле классаHost.CreateDefaultBuilder, и присваивает его свойствуProgram.csдля использования где-то в другом месте внутри класса. Конструктор также может принимать экземпляр реализацииConfigurationи/илиIWebHostEnvironment, хотя он не добавляется в стандартном шаблоне.ILoggerFactoryДобавьте в конструктор параметр для
и присвойте его локальной переменной уровня класса. Это понадобится в методеIWebHostEnvironment. Проделайте такую же работу для приложенийConfigureServices()иAutoLot.Api.AutoLot.Mvcprivate readonly IWebHostEnvironment _env;public Startup(IConfiguration configuration, IWebHostEnvironment env){_env = env;Configuration = configuration;}Метод ConfigureServices()
Метод
применяется для конфигурирования любых служб, необходимых приложению, и вставки их в контейнер DI. Сюда входят службы, требуемые для поддержки приложений MVC и служб API.ConfigureServices()AutoLot.Api
Метод
для API-интерфейсаConfigureServices()по умолчанию конфигурируется с только одной службой, которая добавляет поддержку контроллеров. Благодаря этому мета-методу добавляется множество дополнительных служб, в том числе маршрутизация, авторизация, привязка моделей и все элементы, не относящиеся к пользовательскому интерфейсу, которые уже обсуждались в настоящей главе.AutoLotpublic void ConfigureServices(IServiceCollection services){services.AddControllers();}Метод
может быть расширен, например, для настройки обработки JSON. По умолчанию для ASP.NET Core используется "верблюжий" стиль при обработке JSON (первая буква в нижнем регистре, а каждое последующее слово начинается с буквы верхнего регистра, скажем,AddControllers()). Это соответствует большинству инфраструктур производства не Microsoft, которые применяются для разработки веб-приложений. Однако в предшествующих версиях ASP.NET использовался стиль Pascal (например,carRepo). Переход на "верблюжий" стиль был критическим изменением для многих приложений, которые ожидали стиля Pascal. Чтобы вернуть стиль Pascal при обработке JSON приложением (и улучшить форматирование разметки JSON), модифицируйте методCarRepoследующим образом:AddControllers()
