9 секретов ASP.NET Core

Совсем недавно мы обновили ASP.NET Core до версии 2.1. Один из создателей платформы, наш коллега Дэвид Фоулер поделился некоторыми её полезными особенностями, о которых мало кто знает. Кроме того, помимо 9 секретных фич ASP.NET Core, под катом вы найдете и список основных нововведений со всеми полезными ссылками. Присоединяйтесь!

Вышла версия 2.1 открытой платформы ASP.NET Core, и разработчик Дэвид Фоулер (David Fowler) поделился в «Твиттере» ^[1] ее некоторыми полезными особенностями, о которых мало кто знает. Безусловно, теперь платформа работает быстрее, но также появился ряд новых возможностей и передовых методов, которые стоит рассмотреть подробнее.

Универсальный узел .NET generic host ^[2]

ASP.NET Core теперь работает с новой хостинговой моделью. Приложения .NET формируют и запускают хост ^[3].

Хост отвечает за запуск приложений и управление их жизненным циклом. Задача узла Generic Host состоит в том, чтобы отделить конвейерную обработку HTTP от API веб-хоста для того, чтобы иметь возможность создавать на хосте больше сценариев. Отправка сообщений, фоновые и другие задачи, не относящиеся к HTTP, работают лучше благодаря сквозным функциям Generic Host, таким как конфигурирование, внедрение зависимостей (DI) и логирование.

Это означает, что теперь для сценариев без веб-хостинга есть не только WebHost, но и Generic Host. При этом работа будет такой же удобной, как и с ASP.NET Core, но еще у вас появятся новые возможности, такие как DI, логирование и конфигурирование. Пример кода для Generic Host можно найти на GitHub ^[4].

Интерфейс IHOSTEDSERVICE ^[5]

С его помощью можно запускать длинные фоновые операции как в универсальном хосте, так и в ваших веб-приложениях. В ASP.NET Core 2.1 появилась поддержка ^[6] базового класса BackgroundService, который значительно облегчает создание длинного асинхронного цикла. Пример кода для Hosted Service также находится на GitHub ^[7].

Создавать ^[8] простую временную фоновую задачу:

public Task StartAsync(CancellationToken cancellationToken)
{
   _logger.LogInformation("Timed Background Service is starting.");
 
   _timer = new Timer(DoWork, null, TimeSpan.Zero, 
        TimeSpan.FromSeconds(5));
 
   return Task.CompletedTask;
}

легко!

Службы windows на .NET Core ^[9]

Теперь можно размещать ASP.NET Core внутри службы Windows! Многие пользователи просили добавить данную функцию. IIS вам больше не нужен, чтобы размещать все, что пожелаете. Взгляните на Microsoft.AspNetCore.Hosting.WindowsServices ^[10] на NuGet и подробную документацию ^[3] по размещению собственного приложения ASP.NET Core в Windows в качестве службы Windows без IIS.

public static void Main(string[] args)
{
    var pathToExe = Process.GetCurrentProcess().MainModule.FileName;
    var pathToContentRoot = Path.GetDirectoryName(pathToExe);
 
    var host = WebHost.CreateDefaultBuilder(args)
        .UseContentRoot(pathToContentRoot)
        .UseStartup<Startup>()
        .Build();
 
    host.RunAsService();
}

IHOSTINGSTARTUP ^[11] — конфигурация IWEBHOSTBUILDER с атрибутом сборки

Как всегда, простая и точная реализация с использованием источника на GitHub.

[assembly: HostingStartup(typeof(SampleStartups.StartupInjection))]

Пакеты SHARED SOURCE ^[1]

Это будет вам интересно, обязательно обратите на них внимание. Можно создавать пакеты, которые используются в качестве вспомогательных средств для исходного кода, распространяемого через shared source. Между собой мы называем их «пакеты shared source». Они используются в ASP.NET Core повсюду ^[12], когда к чему-то необходимо предоставить общий доступ, но при этом оно не должно быть общедоступно через API. Тогда ваш код будет использоваться, но не будет появляться зависимостей от конечного пакета.

Они используются в CSPROJ таким образом ^[13]. Обратите внимание на атрибут PrivateAssets ^[14]:

<PackageReference Include="Microsoft.Extensions.ClosedGenericMatcher.Sources" PrivateAssets="All" Version="" />
<PackageReference Include="Microsoft.Extensions.ObjectMethodExecutor.Sources" PrivateAssets="All" Version="" />

OBJECTMETHODEXECUTOR ^[15]

Если вам необходимо задействовать метод в типе через отражение, и этот метод может быть асинхронным, то вам поможет оптимизированная и гибкая функция ObjectMethodExecutor ^[16], которую мы используем повсеместно в кодовой базе ASP.NET Core.

Команда использует этот код в MVC, чтобы задействовать ваши методы контроллера. Они используют этот код в SignalR для задействования методов хаба. Она работает с синхронными и асинхронными методами. Она также может работать с пользовательскими ожидаемыми объектами и асинхронными рабочими процессами F#.

SUPPRESSSTATUSMESSAGES ^[17]

Небольшой и часто запрашиваемый метод. Если вам не нравится то, что выдается после запуска драйвера dotnet, когда вы размещаете веб-приложение (распечатываете информацию привязки), то вы можете использовать новый метод расширения SuppressStatusMessages.

WebHost.CreateDefaultBuilder(args)
    .SuppressStatusMessages(true)
    .UseStartup<Startup>();

ADDOPTIONS ^[18]

В версии 2.1 стало проще настраивать параметры, для работы которых требуются сервисы. Раньше приходилось создавать тип, полученный с помощью IConfigureOptions , теперь можно сделать все это в ConfigureServices с помощью AddOptions ‹TOptions›

public void ConfigureServicdes(IServiceCollection services)
{
    services.AddOptions<MyOptions>()
        .Configure<IHostingEnvironment>((o,env) =>
        {
            o.Path = env.WebRootPath;
        });
}    

IHTTPCONTEXT с ADDHTTPCONTEXTACCESSOR ^[19]

Обычно нет необходимости настраивать IHttpContext, но многие хотят знать, как это сделать ^[20], а некоторые считают, что это должно осуществляться автоматически. Он не регистрируется по умолчанию, так как его наличие приводит к снижению производительности. Однако в ASP.NET Core 2.1 был добавлен PR ^[21] для метода расширения, что облегчит процесс ^[22], если вы этого захотите.

services.AddHttpContextAccessor ();

Итак, ASP.NET Core 2.1 готова к выпуску ^[23].

Новые функции в этой версии:

• SignalR ^[24] — добавляет инструменты в ваши приложения ASP.NET Core для работы в реальном времени.
• Библиотеки класса Razor ^[25] — используйте Razor для создания видов и страниц в библиотеках классов многократного использования.
• Библиотека идентификаторов пользовательских интерфейсов и автоматическая кодогенерация ^[26] — добавляет идентификатор в любое приложение и настраивает его под любые ваши цели.
• HTTPS ^[27]— работает по умолчанию и легко настраивается в процессе разработки.
• Добавление шаблонов для обеспечения соответствия некоторым требованиям общего положения о защите данных ^[28] предоставляет пользователям возможность контролировать свои личные данные и давать согласие на использование cookies.
• Функциональная тестовая инфраструктура MVC ^[29] — создавайте функциональные тесты для вашего приложения, обрабатываемого в оперативной памяти.
• [ApiController] ^[30], ActionResult<Т> ^[31] — создавайте точные и подробные API.
• IHttpClientFactory ^[32] — HttpClient клиент как услуга, который предоставляет большие возможности для его настройки и централизованного управления.
• Kestrel в Sockets ^[33] — управляемые сокеты заменяют libuv в качестве транспорта Kestrel по умолчанию.
• Унифицированный хостинг-строитель ^[34] — унифицированная инфраструктура хоста, отвязанная от HTTP и с поддержкой DI, логирования и конфигурирования.
• Обновленные шаблоны SPA ^[35] — шаблоны Angular, React, и React + Redux были обновлены, чтобы можно было использовать стандартные структуры проектов и создавать системы для каждой структуры (Angular CLI и create-react-app).

Посмотрите список изменений в ASP.NET Core 2.1 ^[36] в документах ASP.NET Core, чтобы узнать больше об этих функциях. Полный список всех изменений в новой версии представлен в примечаниях к выпуску ^[37].

Попробуйте! Пройдите курс QuickStart ^[38]— и вы сможете создавать базовые веб-приложения за 10 минут.

Автор: sahsAGU

Источник ^[39]