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

a secret"

  }

}

Обновление Program.cs

Добавьте в файлы Program.cs в проектах AutoLot.Api и AutoLot.Mvc следующий оператор using:

using AutoLot.Services.Logging;

Модифицируйте метод CreateHostBuilder() в обоих проектах, как показано ниже:

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

  Host.CreateDefaultBuilder(args)

      .ConfigureWebHostDefaults(webBuilder =>

      {

        webBuilder.UseStartup<Startup>();

       }).ConfigureSerilog();

Обновление Startup.cs

Добавьте в файлы Startup.cs в проектах AutoLot.Api и AutoLot.Mvc следующий оператор using:

using AutoLot.Services.Logging;

Затем необходимо поместить новые интерфейсы ведения журнала в контейнер DI. Добавьте в метод ConfigureServices() в обоих проектах такой код:

services.AddScoped(typeof(IAppLogging<>), typeof(AppLogging<>));

Обновление контроллера

Следующее обновление связано с заменой ссылок на ILogger ссылками на IAppLogging. Начните с класса WeatherForecastController в проекте AutoLot.Api. Добавьте в класс следующий оператор using:

using AutoLot.Services.Logging;

Далее измените ILogger<T> на IAppLogging<T>:

[ApiController]

[Route("[controller]")]

public class WeatherForecastController : ControllerBase

{

  ...

  private readonly IAppLogging<WeatherForecastController> _logger;

  public WeatherForecastController(IAppLogging<WeatherForecastController> logger)

  {

    _logger = logger;

  }

  ...

}

Теперь модифицируйте HomeController в проекте AutoLot.Mvc. Добавьте в класс следующий оператор using:

using AutoLot.Services.Logging;

Измените ILogger<T> на IAppLogging<T>:

[Route("[controller]/[action]")]

public class HomeController : Controller

{

  private readonly IAppLogging<HomeController> _logger;

  public HomeController(IAppLogging<HomeController> logger)

  {

    _logger = logger;

  }

  ...

}

После этого регистрация в журнале выполняется в каждом контроллере простым обращением к средству ведения журнала, например:

// WeatherForecastController.cs (AutoLot.Api)

[HttpGet]

public IEnumerable<WeatherForecast> Get()

{

  _logger.LogAppWarning("This is a test");

  ...

}

// HomeController.cs (AutoLot.Mvc)

[Route("/")]

[Route("/[controller]")]

[Route("/[controller]/[action]")]

[HttpGet]

public IActionResult Index()

{

  _logger.LogAppWarning("This is a test");

  return View();

}

Испытание инфраструктуры ведения журнала

Имея установленную инфраструктуру Serilog, самое время протестировать ведение журналов для приложений. Если вы используете Visual Studio, тогда укажите AutoLot.Mvc в качестве стартового проекта (щелкните правой кнопкой мыши на имени проекта в окне Solution Explorer, выберите в контекстном меню пункт Set as Startup Project (Установить как стартовый проект) и щелкните на кнопке запуска с зеленой стрелкой или нажмите <F5>). В случае работы в VS Code откройте окно терминала (<Ctrl+'>), перейдите в каталог AutoLot.Mvc и введите команду dotnet run.

В Visual Studio автоматически запустится браузер с представлением Home/Index. Если вы применяете VS Code, то вам понадобится открыть браузер и перейти по ссылке https://localhost:5001. После загрузки вы можете закрыть браузер, поскольку обращение к средству ведения журнала произошло при загрузке домашней страницы. Закрытие браузера в случае использования Visual Studio останавливает отладку. Чтобы остановить отладку в VS Code, нажмите <Ctrl+C> в окне терминала.

В каталоге проекта вы увидите файл по имени ErrorLogГГГMMДД.txt, в котором обнаружите запись, похожую на показанную ниже:

[ГГ-ММ-ДД чч:мм:сс Warning]AutoLot.Mvc -

  Dev:AutoLot.Mvc.Controllers.HomeController

Message:This is a test

in method Index at

D:ProjectsBookscsharp9-wfCodeNewChapter_29AutoLot.MvcControllers

HomeController.cs:30

Для тестирования кода регистрации в журнале в проекте AutoLot.Api установите этот проект в качестве стартового (Visual Studio) или перейдите в каталог AutoLot.Api в окне терминала (VS Code). Нажмите <F5> или введите dotnet run и перейдите по ссылке https://localhost:44375/swagger/index.html. В итоге загрузится страница Swagger для приложения API (рис. 29.6).

Щелкните на кнопке GET для записи WeatherForecast. В результате откроется экран с деталями для этого метода действия, включая возможность Try it out (Опробовать), как видно на рис. 29.7.

После щелчка на кнопке Try it out щелкните на кнопке Execute (Выполнить), которая обеспечивает обращение к конечной точке (рис. 29.8).

В каталоге проекта AutoLot.Api вы снова увидите файл по имени ErrorLogГГГГММДД.txt и найдете в нем примерно такую запись:

[ГГ-ММ-ДД чч:мм:сс Warning]AutoLot.Api -

 Dev:AutoLot.Api.Controllers.

WeatherForecastController

Message:This is a test

in method Get at

D:ProjectsBookscsharp9-wfCodeNewChapter_29AutoLot.ApiControllers

WeatherForecastController.cs:30

На заметку! Нововведением в версии ASP.NET Core 5 является то, что Swagger по умолчанию включается в шаблон API. Инструменты Swagger будут подробно исследованы в следующей главе.

Резюме

В главе была представлена инфраструктура ASP.NET Core. Глава начиналась с краткого обзора истории появления ASP.NET, после чего были рассмотрены функциональные средства из классических инфраструктур ASP.NET MVC и ASP.NET Web API, которые присутствуют в ASP.NET Core.

Далее вы узнали о новых средствах ASP.NET Core и о том, как они работают. После изучения различных способов запуска и отладки приложений ASP.NET Core вы создали решение с двумя проектами ASP.NET Core — для общей библиотеки прикладных служб и для уровня доступа к данным AutoLot (из главы 23). Наконец, вы заменили в обоих проектах стандартное средство ведения журнала ASP.NET Core инфраструктурой Serilog.

В следующей главе приложение AutoLot.Api будет завершено.

Глава 30

Создание служб REST с помощью ASP.NET Core

 В предыдущей главе была представлена инфраструктура ASP.NET Core, обсуждались ее новые возможности, были созданы проекты, а также обновлен код в AutoLot.Mvc и AutoLot.Api для включения AutoLot.Dal и ведения журнала Serilog.

Внимание в текущей главе будет сосредоточено на завершении работы над REST-службой AutoLot.Api.

На заметку! Исходный код, рассматриваемый в этой главе, находится в папке Chapter_30 внутри хранилища GitHub для настоящей книги. Вы также можете продолжить работу с решением, начатым в главе 29.

Введение в REST-службы ASP.NET Core

Инфраструктура ASP.NET MVC начала набирать обороты почти сразу после своего выхода, а в составе версий ASP.NET MVC 4 и Visual Studio 2012 компания Microsoft выпустила ASP.NET Web API. Версия ASP.NET Web API 2 вышла вместе c Visual Studio 2013 и затем с выходом Visual Studio 2013 Update 1 была модернизирована до версии 2.2.