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

символов), или именем, начинающимся с буквы "H" (нечувствительно к регистру символов):

[Fact]

public void ShouldGetCustomersWithLastNameWOrH()

{

  IQueryable<Customer> query = Context.Customers

    .Where(x => x.PersonalInformation.LastName.StartsWith("W") ||

                x.PersonalInformation.LastName.StartsWith("H"));

  var qs = query.ToQueryString();

  List<Customer> customers = query.ToList();

  Assert.Equal(3, customers.Count);

}

Запрос LINQ транслируется в следующий код SQL:

SELECT [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],

       [c].[LastName] FROM [Dbo].[Customers] AS [c]

WHERE ([c].[LastName] IS NOT NULL AND ([c].[LastName] LIKE N'W%'))

OR ([c].[LastName] IS NOT NULL AND ([c].[LastName] LIKE N'H%'))

Показанный далее тест возвращает заказчиков с фамилией, начинающейся с буквы "W" (нечувствительно к регистру символов), или именем, начинающимся с буквы "Н" (нечувствительно к регистру символов), и демонстрирует использование метода EF.Functions.Like(). Обратите внимание, что включать групповой символ (%) вы должны самостоятельно.

[Fact]

public void ShouldGetCustomersWithLastNameWOrH()

{

  IQueryable<Customer> query = Context.Customers

    .Where(x => EF.Functions.Like(x.PersonalInformation.LastName, "W%") ||

                EF.Functions.Like(x.PersonalInformation.LastName, "H%"));

  var qs = query.ToQueryString();

  List<Customer> customers = query.ToList();

  Assert.Equal(3, customers.Count);

}

Запрос LINQ транслируется в следующий код SQL (обратите внимание, что проверка на null не делается):

SELECT [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],

       [c].[LastName] FROM [Dbo].[Customers] AS [c]

WHERE ([c].[LastName] LIKE N'W%') OR ([c].[LastName] LIKE N'H%')

В приведенном ниже тесте из класса CarTests.cs применяется [Theory] для проверки количества записей Car в таблице Inventory на основе MakeId (метод IgnoreQueryFilters() рассматривался в разделе "Глобальные фильтры запросов" главы 22):

[Theory]

[InlineData(1, 2)]

[InlineData(2, 1)]

[InlineData(3, 1)]

[InlineData(4, 2)]

[InlineData(5, 3)]

[InlineData(6, 1)]

public void ShouldGetTheCarsByMake(int makeId, int expectedCount)

{

  IQueryable<Car> query =

    Context.Cars.IgnoreQueryFilters().Where(x => x.MakeId == makeId);

  var qs = query.ToQueryString();

  var cars = query.ToList();

  Assert.Equal(expectedCount, cars.Count);

}

Каждая строка [InlineData] становится уникальным тестом в средстве запуска тестов. В этом примере обрабатываются шесть тестов и в отношении базы данных выполняются шесть запросов. Вот как выглядит код SQL для одного из тестов (единственным отличием в запросах для других тестов в [Theory] будет значение MakeId):

DECLARE @__makeId_0 int = 1;

SELECT [i].[Id], [i].[Color], [i].[IsDrivable], [i].[MakeId], [i].[PetName],

       [i].[TimeStamp] FROM [dbo].[Inventory] AS [i]

WHERE [i].[MakeId] = @__makeId_0

Следующий тест [Theory] показывает фильтрованный запрос с CustomerOrderViewModel (поместите тест в файл класса OrderTests.cs):

[Theory]

[InlineData("Black",2)]

[InlineData("Rust",1)]

[InlineData("Yellow",1)]

[InlineData("Green",0)]

[InlineData("Pink",1)]

[InlineData("Brown",0)]

public void ShouldGetAllViewModelsByColor(string color, int expectedCount)

{

    var query = _repo.GetOrdersViewModel().Where(x=>x.Color == color);

    var qs = query.ToQueryString();

    var orders = query.ToList();

    Assert.Equal(expectedCount,orders.Count);

}

Для первого теста [InlineData] генерируется такой запрос:

DECLARE @__color_0 nvarchar(4000) = N'Black';

SELECT [c].[Color], [c].[FirstName], [c].[IsDrivable], [c].[LastName],

       [c].[Make], [c].[PetName] FROM [dbo].[CustomerOrderView] AS [c]

WHERE [c].[Color] = @__color_0

Сортировка записей

Методы OrderBy() и OrderByDescending() устанавливают для запроса сортировку (сортировки) по возрастанию и по убыванию. Если требуются дальнейшие сортировки, тогда используйте методы ThenBy() и ThenByDescending(). Сортировка демонстрируется в тесте ниже:

[Fact]

public void ShouldSortByLastNameThenFirstName()

{

  // Сортировать по фамилии, затем по имени.

  var query = Context.Customers

    .OrderBy(x => x.PersonalInformation.LastName)

    .ThenBy(x => x.PersonalInformation.FirstName);

  var qs = query.ToQueryString();

  var customers = query.ToList();

  // Если есть только один пользователь, то проверять нечего.

  if (customers.Count <= 1) { return; }

  for (int x = 0; x < customers.Count - 1; x++)

  {

    var pi = customers[x].PersonalInformation;

    var pi2 = customers[x + 1].PersonalInformation;

    var compareLastName = string.Compare(pi.LastName,

        pi2.LastName, StringComparison.CurrentCultureIgnoreCase);

    Assert.True(compareLastName <= 0);

    if (compareLastName != 0) continue;

    var compareFirstName = string.Compare(pi.FirstName,

        pi2.FirstName, StringComparison.CurrentCultureIgnoreCase);

    Assert.True(compareFirstName <= 0);

  }

}

Предыдущий запрос LINQ транслируется следующим образом:

SELECT [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],

       [c].[LastName]FROM [Dbo].[Customers] AS [c]

ORDER BY [c].[LastName], [c].[FirstName]

Сортировка записей в обратном порядке

Метод Reverse() меняет порядок сортировки на противоположный, как видно в представленном далее тесте:

[Fact]

public void ShouldSortByFirstNameThenLastNameUsingReverse()

{

  // Сортировать по фамилии, затем по имени,

  // и изменить порядок сортировки на противоположный.

  var query = Context.Customers

    .OrderBy(x => x.PersonalInformation.LastName)

    .ThenBy(x => x.PersonalInformation.FirstName)

    .Reverse();

  var qs = query.ToQueryString();

  var customers = query.ToList();

  // Если есть только один пользователь, то проверять нечего.

  if (customers.Count <= 1) { return; }

  for (int x = 0; x < customers.Count - 1; x++)

  {

    var pi1 = customers[x].PersonalInformation;

    var pi2 = customers[x + 1].PersonalInformation;

    var compareLastName = string.Compare(pi1.LastName,

    pi2.LastName, StringComparison.CurrentCultureIgnoreCase);

    Assert.True(compareLastName >= 0);

    if (compareLastName != 0) continue;

    var compareFirstName = string.Compare(pi1.FirstName,

    pi2.FirstName, StringComparison.CurrentCultureIgnoreCase);

    Assert.True(compareFirstName >= 0);

  }

}

Вот во что транслируется предыдущий запрос LINQ:

SELECT [c].[Id], [c].[TimeStamp], [c].[FirstName], [c].[FullName],

       [c].[LastName] FROM [Dbo].[Customers] AS [c]

ORDER BY [c].[LastName] DESC, [c].[FirstName] DESC

Извлечение одиночной записи

Существуют три главных метода для возвращения одиночной записи посредством запроса: First()/FirstOrDefault(), Last()/LastOrDefault() и Single()/SingleOrDefault(). Хотя все они возвращают одиночную запись, принятые в них подходы отличаются. Методы и их варианты более подробно описаны ниже.

• Метод First() возвращает первую запись, которая соответствует условию запроса и любым конструкциям упорядочения. Если конструкции упорядочения не указаны, то возвращаемая запись основывается на порядке, установленном в базе данных. Если запись не возвращается, тогда генерируется исключение.

• Поведение метода FirstOrDefault() совпадает с поведением First(), но