Язык программирования C#9 и платформа .NET5

 {
  "Logging": {
  "MSSqlServer": {
  "schema": "Logging",
  "tableName": "SeriLogs",
  "restrictedToMinimumLevel": "Warning"
  }
  },
  "RebuildDataBase": false,
  "ApplicationName": "AutoLot.Mvc - Dev",
  "ConnectionStrings": {
  "AutoLot": "Server=.,5433;Database=AutoLot;User ID=sa;Password=P@ssw0rd;"
  },
  "ApiServiceSettings": {
   "Uri": "https://localhost:5021/",
   "CarBaseUri": "api/Cars",
   "MakeBaseUri": "api/Makes"
   }
 }

На заметку! Удостоверьтесь, что номер порта соответствует вашей конфигурации для AutoLot.Api.

За счет использования конфигурационной системы ASP.NET Core и обновления файлов, специфичных для среды (например, appsettings.staging.json и appsettings.production.json), ваше приложение будет располагать надлежащими значениями без необходимости в изменении кода.

Создание класса ApiServiceSettings

Настройки службы будут заполняться из настроек таким же способом, как и информация об автодилере. Создайте в проекте AutoLot.Services новый каталог по имени ApiWrapper и добавьте в него файл класса ApiServiceSettings.cs. Имена свойств класса должны совпадать с именами свойств в разделе ApiServiceSettings файла appsettings.Development.json. Код класса показан ниже:

 namespace AutoLot.Services.ApiWrapper
 {
  public class ApiServiceSettings
  {
  public ApiServiceSettings { }
  public string Uri { get; set; }
  public string CarBaseUri { get; set; }
  public string MakeBaseUri { get; set; }
  }
 }

Оболочка службы API

В версии ASP.NET Core 2.1 появился интерфейс IHTTPClientFactory, который позволяет конфигурировать строго типизированные классы для вызова внутри служб REST. Создание строго типизированного класса дает возможность инкапсулировать все обращения к API в одном месте. Это централизует взаимодействие со службой, конфигурацию клиента HTTP, обработку ошибок и т.д. Затем класс можно добавить в контейнер DI для дальнейшего применения в приложении. Контейнер DI и реализация IHTTPClientFactory обрабатывают создание и освобождение HTTPClient.

Интерфейс IApiServiceWrapper

Интерфейс оболочки службы AutoLot содержит методы для обращения к службе AutoLot.Api. Создайте в каталоге ApiWrapper новый файл интерфейса IApiServiceWrapper.cs и приведите операторы using к следующему виду:

 using System.Collections.Generic;
 using System.Threading.Tasks;
 using AutoLot.Models.Entities;

Модифицируйте код интерфейса, как показано ниже:

 namespace AutoLot.Services.ApiWrapper
 {
  public interface IApiServiceWrapper
  {
  Task<IList<Car>> GetCarsAsync;
  Task<IList<Car>> GetCarsByMakeAsync(int id);
  Task<Car> GetCarAsync(int id);
  Task<Car> AddCarAsync(Car entity);
  Task<Car> UpdateCarAsync(int id, Car entity);
  Task DeleteCarAsync(int id, Car entity);
  Task<IList<Make>> GetMakesAsync;
  }
 }

Класс ApiServiceWrapper

Создайте в каталоге ApiWrapper проекта AutoLot.Services новый файл класса по имени ApiServiceWrapper.cs и модифицируйте его операторы using следующим образом:

 using System;
 using System.Collections.Generic;
 using System.Net.Http;
 using System.Net.Http.Json;
 using System.Text;
 using System.Text.Json;
 using System.Threading.Tasks;
 using AutoLot.Models.Entities;
 using Microsoft.Extensions.Options;

Сделайте класс открытым и добавьте конструктор, который принимает экземпляр HttpClient и экземпляр реализации IOptionsMonitor<ApiServiceSettings>. Создайте закрытую переменную типа ServiceSettings и присвойте ей значение с использованием свойства CurrentValue параметра IOptionsMonitor<Service Settings>. Код показан ниже:

 public class ApiServiceWrapper : IApiServiceWrapper
 {
  private readonly HttpClient _client;
  private readonly ApiServiceSettings _settings;
  public ApiServiceWrapper(HttpClient client,
  IOptionsMonitor<ApiServiceSettings> settings)
  {
  _settings = settings.CurrentValue;
  _client = client;
  _client/BaseAddress = new Uri(_settins.Uri);
  }
 }

На заметку! В последующих разделах содержится много кода без какой-либо обработки ошибок. Поступать так настоятельно не рекомендуется! Обработка ошибок здесь опущена из-за экономии пространства.

Внутренние поддерживающие методы

Класс содержит четыре поддерживающих метода, которые применяются открытыми методами.