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

В 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.

Продукт 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&lt;IActionResult&gt; для асинхронных операций). Кроме вспомогательных методов в ControllerBase, возвращающих специфические коды состояния HTTP методы действий способны возвращать содержимое как ответы в формате JSON (JavaScript Object Notation — запись объектов JavaScript).