В 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 будут подробно исследованы в следующей главе.
(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})
Резюме
В главе была представлена инфраструктура 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.
Продукт ASP.NETWeb API с самого начала разрабатывался как основанная на службах инфраструктура для построения служб REST (REpresentational State Transfer — передача состояния представления), которая базируется на инфраструктуре MVC минус "V" (представление) с рядом оптимизаций, направленных на создание автономных служб. Такие службы могут вызываться с применением любой технологии, а не только тех, которые производит Microsoft. Обращения к службе Web API основаны на базовых HTTP-методах (GET, PUT, POST, DELETE) осуществляются через универсальный идентификатор ресурса (uniform resource identifier — URI), например:
http://www.skimedic.com:5001/api/cars
Он похож на унифицированный указатель ресурса (uniform resource locator — URL), поскольку таковым и является! Указатель URL — это просто идентификатор URI, который указывает на физический ресурс в сети.
При вызове служб Web API используется схема HTTP (Hypertext Transfer Protocol — протокол передачи гипертекста) на конкретном хосте (в приведенном выше примере www.skimedic.com) и специфическом порте (5001), за которыми указывается путь (api/cars), а также необязательные запрос и фрагмент (в примере отсутствуют). Обращение к службе Web API может также содержать текст в теле сообщения, как вы увидите далее в этой главе. Из предыдущей главы вы узнали, что ASP.NET Core объединяет Web API и MVC в одну инфраструктуру.
Создание действий контроллера с использованием служб REST
Вспомните, что действия возвращают тип IActionResult (или Task<IActionResult> для асинхронных операций). Кроме вспомогательных методов в ControllerBase, возвращающих специфические коды состояния HTTP методы действий способны возвращать содержимое как ответы в формате JSON (JavaScript Object Notation — запись объектов JavaScript).
