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

Принадлежащий сущностный класс Person

Сущности Customer и CreditRisk имеют свойства FirstName и LastName. Если в каждой сущности присутствуют одни и те же свойства, тогда можно извлечь выгоду от перемещения этих свойств в принадлежащие классы. Пример с двумя свойствами тривиален, но принадлежащие сущностные классы помогают сократить дублирование кода и повысить согласованность. В дополнение к двум свойствам внутри классов определяется еще одно свойство, отображаемое на вычисляемый столбец SQL Server.

Создайте в каталоге Entities проекта AutoLot.Models новый каталог по имени Owned и добавьте в него новый файл Person.cs, содержимое которого показано ниже:

using System.ComponentModel.DataAnnotations;

using System.ComponentModel.DataAnnotations.Schema;

using Microsoft.EntityFrameworkCore;

namespace AutoLot.Models.Entities.Owned

{

  [Owned]

  public class Person

  {

    [Required, StringLength(50)]

    public string FirstName { get; set; } = "New";

    [Required, StringLength(50)]

    public string LastName { get; set; } = "Customer";

    [DatabaseGenerated(DatabaseGeneratedOption.Computed)]

    public string? FullName { get; set; }

  }

}

Свойство FullName допускает null, т.к. до сохранения в базе данных новые сущности не будут иметь установленных значений. Финальная конфигурация свойства Fullname обеспечивается с использованием Fluent API.

Сущность Car(Inventory)

Для таблицы Inventory был создан шаблон сущностного класса по имени Inventory, но имя Car предпочтительнее. Исправить ситуацию легко: измените имя файла на Car.cs и имя класса на Car. Атрибут [Table] применяется корректно, так что нужно просто добавить схему dbo. Обратите внимание, что параметр Schema необязателен, поскольку по умолчанию для SQL Server принимается dbo, но он был включен ради полноты:

[Table("Inventory", Schema = "dbo")]

[Index(nameof(MakeId), Name = "IX_Inventory_MakeId")]

public partial class Car : BaseEntity

{

  ...

}

Обновите операторы using следующим образом:

using System;

using System.Collections.Generic;

using System.ComponentModel;

using System.ComponentModel.DataAnnotations;

using System.ComponentModel.DataAnnotations.Schema;

using System.Text.Json.Serialization;

using AutoLot.Models.Entities.Base;

using Microsoft.EntityFrameworkCore;

Унаследуйте класс Car от BaseEntity, после чего удалите свойства Id и TimeStamp, конструктор и директиву #pragma nullable disable. Вот как выглядит код класса после таких изменений:

namespace AutoLot.Models.Entities

{

  [Table("Inventory", Schema = "dbo")]

  [Index(nameof(MakeId), Name = "IX_Inventory_MakeId")]

  public partial class Car : BaseEntity

  {

    public int MakeId { get; set; }

    [Required]

    [StringLength(50)]

    public string Color { get; set; }

    [Required]

    [StringLength(50)]

    public string PetName { get; set; }

    [ForeignKey(nameof(MakeId))]

    [InverseProperty("Inventories")]

    public virtual Make Make { get; set; }

    [InverseProperty(nameof(Order.Car))]

    public virtual ICollection<Order> Orders { get; set; }

  }

}

В коде все еще присутствуют проблемы, которые необходимо устранить. Свойства Color и PetName определены как не допускающие null, но их значения не устанавливаются в конструкторе или не инициализируются в определении свойств. Проблема решается с помощью инициализаторов свойств. Кроме того, добавьте к свойству PetName атрибут [DisplayName], чтобы сделать название свойства более удобным для восприятия человеком. Обновите свойства, как показано ниже (изменения выделены полужирным):

[Required]

[StringLength(50)]

public string Color { get; set; } = "Gold";

[Required]

[StringLength(50)]

[DisplayName("Pet Name")]

public string PetName { get; set; } = "My Precious";

На заметку! Атрибут [DisplayName] используется инфраструктурой ASP.NET Core и будет описан в части VIII.

Навигационное свойство Make потребуется переименовать в MakeNavigation и сделать допускающим null, а в обратном навигационном свойстве вместо "магической" строки должно применяться выражение nameof языка С#. Наконец, нужно удалить модификатор virtual. После всех модификаций свойство приобретает следующий вид:

[ForeignKey(nameof(MakeId))]

[InverseProperty(nameof(Make.Cars))]

public Make? MakeNavigation { get; set; }

На заметку! Модификатор virtual необходим для ленивой загрузки. Поскольку ленивая загрузка в примерах книги не используется, модификатор virtual будет удаляться из всех свойств внутри уровня доступа к данным.

Для навигационного свойства Orders требуется атрибут [Jsonlgnore], чтобы предотвратить циклические ссылки JSON при сериализации объектной модели. В шаблонном коде обратное навигационное свойство задействует выражение nameof, но его понадобится обновить, т.к. имена всех навигационных свойств типа ссылок будут содержать суффикс Navigation. Последнее изменение связано с тем, что свойство должно иметь тип IEnumerable<Order>, а не ICollection<Order>, и инициализироваться с применением нового экземпляра List<Order>. Изменение не является обязательным, потому что ICollection<Order> тоже будет работать. Более низкоуровневый тип IEnumerable<T> предпочтительнее использовать с навигационными свойствами типа коллекций IEnumerable<T> (поскольку интерфейсы IQueryable<T> и ICollection<T> унаследованы от IEnumerable<T>). Модифицируйте код, как показано далее:

[JsonIgnore]

[InverseProperty(nameof(Order.CarNavigation))]

public IEnumerable<Order> Orders { get; set; } = new List<Order>();

Затем добавьте свойство NotMapped, которое будет отображать значение Make экземпляра Car, устранив необходимость в классе CarViewModel из главы 21. Если связанная информация Make была извлечена из базы данных с записью Car, то значение MakeName отображается. Если связанные данные не были извлечены, тогда для свойства отображается строка Unknown (т.е. производитель не известен). Как вы должны помнить, свойства с атрибутом [NotMapped] не относятся к базе данных и существуют только внутри сущности. Добавьте следующий код:

[NotMapped]

public string MakeName => MakeNavigation?.Name ?? "Unknown";

Переопределите ToString() для отображения информации о транспортном средстве:

public override string ToString()

{

  // Поскольку столбец PetName может быть пустым,.

  // определить стандартное имя **No Name**

  return $"{PetName ?? "**No Name**"} is a {Color} {MakeNavigation?.Name}

    with ID {Id}.";

}

Добавьте к свойству MakeId атрибуты [Required] и [DisplayName]. Несмотря на то что инфраструктура EF Core считает свойство MakeId обязательным, т.к. оно не допускает значение null, механизму проверки