Про ORM

Сегодня я расскажу про такую составляющую системы "1С-Битрикс: Управление сайтом ASP.NET", как сущности. Этот механизм - один из основополагающих механизмов системы, претерпел значительные изменения к 4-й версии.

В отличие от динамического PHP, большинство языков под .NET CLR 2.0 - языки со статической типизацией. Статическая типизация вкупе с метаданными типов .NET позволяет организовать хорошую поддержку Code Completion (IntelliSense) в среде разработки, проверку ошибок на этапе компиляции и т.д. Чтобы использовать эти преимущества необходим другой подход к сущностям.

Немного истории

Сначала были просто классы и классы-менеджеры, т.е. каждая сущность, например, "Пользователь" представляла собой класс, ее олицетворяющий - BXUser с полями и свойствами, а к нему в нагрузку шел глобальный BXUserManager - у которого были методы по сохранению, обновлению, выборке - все методы содержали прямые вызовы SQL запросов и для каждой новой сущности приходилось писать все с нуля.

Поэтому в недрах отдела зародилась идея сделать единый механизм выполнения типовых запросов к БД, чтобы разработчик тратил меньше время на декларацию сущностей, а пользователь API мог комфортно работать, используя стандартизованные методы и использовать в полной мере IntelliSense в Visual Studio.

Первая версия ORM просуществовала до последнего обновления 3-ей версии, и обкатывалась на инфоблоках. Существенные изменения и дополнения механизм претерпел к версии 4 - теперь это полноценная ORM поверх слоя базы данных.

Что собственно есть

API сущностей решает 2 задачи:

• Отображает слой базы данных на уровень .NET кода
• Автоматизирует решение типовых задач: сохранение сущностей, выборки, фильтрация

Таким образом, для каждой записи в БД мы имеем .NET обертку, со свойствами и методами, а ля ActiveRecord. Свойства и методы могут скрывать различные аспекты бизнес-логики, будь то автоматический расчет дополнительных значений, верификация пользовательского ввода, запуск различных механизмов. Например, сущность "комментарий блога" представлена классом BXBlogComment, у которого, как подсказывает IntelliSense



есть свойства Author, AuthorBlog, AuthorBlogId, AuthorName, ... , причем свойство Author имеет тип BXBlogUser и тоже в свою очередь имеет разные свойства. Кстати, значение свойства AuthorName автоматически вычисляется при указания идентификатора пользователя через AuthorId



но может быть и задано вручную. Удобно, не правда ли?

Заглядывая внутрь BXBlogComment можно найти метод GetList. Этот могущественный метод - основа всей ORM, который опирается на механизм фильтрации и выборки, но об этом чуть позже. Рассмотрим типовой пример из модуля "Блоги":

BXBlogCommentCollection commentCollection = BXBlogComment.GetList(
	new BXFilter(
		new BXFilterItem(BXBlogComment.Fields.Post.Id, BXSqlFilterOperators.Equal, 256),
		new BXFilterItem(BXBlogComment.Fields.LiveRootNodeIndex, BXSqlFilterOperators.Greater, 3),
		new BXFilterItem(BXBlogComment.Fields.LiveRootNodeIndex, BXSqlFilterOperators.LessOrEqual, 7)
	),
	new BXOrderBy(new BXOrderByPair(BXBlogComment.Fields.LeftMargin, BXOrderByDirection.Asc)),
	new BXSelectAdd(
		BXBlogComment.Fields.AuthorBlog.Id,
		BXBlogComment.Fields.AuthorBlog.Slug,
		BXBlogComment.Fields.AuthorBlog.Categories.Category.Sites.SiteId,
		BXBlogComment.Fields.Author,
		BXBlogComment.Fields.Author.User,
		BXBlogComment.Fields.Author.User.Image
	),
	null
);

здесь мы выбираем комментарии для поста в блоге в определенном интервале и сортируем их в нужном порядке.

Первым аргументом GetList'а идет фильтр. Фильтры бывают разными. Атомарным фильтром является является фильтр "поле равно значение" - он олицетворен классом BXFilterItem. Еще есть фильтр AND (BXFilter) и OR (BXFilterOr). В этом примере мы выбираем те комментарии, у которых LiveRootNodeIndex лежит в диапазоне от 4 до 7, а идентификатор связанной сущности BXBlogPost равен 256.

Второй аргумент - это порядок сортировки - тут все просто, задаем парами вида поле-направление.

Третий аргумент - еще одна мощная вещь - это выборка. При помощи BXSelect можно указать список полей, которые нужно выбрать в запросе, а также полей связанных сущностей (API автоматически сделает нужные JOIN'ы). Таким образом мы, например, для каждого комментария можем выбрать дополнительно нужную информацию о его авторе и о блоге автора. Все это будет сделано в рамках одного запроса. Конечно, мы можем не указывать дополнительных сущностей в выборке - к ним все равно можно будет обратиться через свойства комментария, но уже с дополнительным запросом по требованию. В нашем случае мы дополнительно выбираем (BXSelectAdd означает, что перечисленные поля и сущности будут выбраны дополнительно к основной) 2 поля из связанной сущности AuthorBlog (блог автора) - идентификатор и адрес, и список идентификаторов сайтов, к которым принадлежат категории, к которым принадлежит все тот же блог автора комментария. Т.е. API позволяет нам сделать глубокую выборку связанных данных. Даже множественных. Ну и в добавок нам понадобится информация об авторе комментария и его аватар - это уже конкретные сущности (BXBlogUser, BXUser, BXFile) - они будут выбраны полностью, со всеми полями.

Обратите внимание, что поля сущности задаются не строками, а свойствами объекта BXBlogComment.Fields - схемы сущности. Схема сущности описывается отдельным классом и содержит поля сущности и их привязку к базе данных. Поля могут описывать простые свойства, имеющие прямые прототипы в базе данных (BXTableField), выражения, чья логика отображения задается кодом (BXCalculatedField), одиночные и множественные связки с другими сущностями (BXSchemeField, BXLinkedField).

Таким образом общение с сущностями происходит на уровне .NET кода, а не SQL - тем самым минимизируется вероятность ошибки, ведь корректность синтаксиса теперь за нас проверяет компилятор, а отсутствие прямых вставок SQL-кода защищает нас от различных дыр в безопасности.

Как с этим работать

В ходе разработки сайта или модуля разработчикам, возможно, придется столкнуться со следующими задачами:

• Описание сущностей
• Использование сущностей

Описание сущности сводится к объявлению 3-х классов: схемы сущности, собственно сущности и класса коллекции

Класс схемы сущности наследуется от BXScheme и содержит в своем статическом конструкторе (на данный момент это особенность API) описания полей, а также предоставляет доступ к полям через свойства. Например, схема Вашей сущности может выглядеть следующим образом:

public class CustomerScheme : BXScheme<CustomerScheme> 
{
	static CustomerScheme() 
	{
		SetTable("customer", "cm");
 
		AddField("Id", new BXTableField("id", SqlDbType.Int, 0, false, true, true));
		AddField("Name", new BXTableField("name", SqlDbType.NVarChar, 256, false, ""));
		AddField("Birthday", new BXTableField("birthday", SqlDbType.DateTime, true, x => DateTime.Now));
	}
 
	public BXSchemeFieldBase Id { get { return GetField("Id"); } }
	public BXSchemeFieldBase Name { get { return GetField("Name"); } }
	public BXSchemeFieldBase Birthday { get { return GetField("Birthday"); } }
}

Класс сущности наследуется от BXEntity и содержит в себе описание свойств сущности и пользовательскую бизнес-логику. В самом простом случае это будет выглядеть так:

public class Customer : BXEntity<Customer, CustomerCollection, CustomerScheme>
{
	public override string EntityId { get { return "Customer"; } }
	public override string ModuleId { get { return "MyModule"; } }
 
	public int Id
	{
		get { return GetValue<int>("Id"); }
	}
	public string Name
	{
		get { return GetValue<string>("Name") ?? ""; }
		set { SetValue("Name", value ?? ""); }
	}
	public DateTime Birthday
	{
		get { return GetValue<DateTime>("Birthday"); }
		set { SetValue("Birthday", value != DateTime.MinValue ? (object)value : null); }
	}
}

Класс коллекции - на данном этапе это просто обертка и описывается одной строкой:

public class CustomerCollection : BXEntityCollection<Customer, CustomerCollection, CustomerScheme> {}

Таким образом для типовых сущностей задача описания носит действительно описательный характер. А с написанием кода может справиться, например, какой-нибудь кодогенератор.

Для более сложной логики класс сущности содержит набор виртуальных и шаблонных методов, которые можно переопределить в зависимости от сложности встраиваемого поведения.

Для критичных операций можно написать методы с прямыми SQL запросами - API сущностей позволяет создать сущность из голой SQL выборки SqlDataReader'ом.

В конечном итоге мы получаем унифицированный механизм для доступа к данным - все сущности имеют метод GetList, набор полей и типизированные свойства. Т.е. нам не придется задумываться, а как выбрать тот или иной объект по такому-то условию - методы выборки одинаковы для всех сущностей, а Visual Studio подскажет, какие поля или свойства есть у сущности.

Заключение

API сущностей - это уже сложившийся механизм, который прошел \"боевое крещение\" инфоблоками, форумами и блогами, и призван избавить разработчика от необходимости писать рутинные SQL запросы для типовых задач, задействовать особенности статической типизации и использовать удобные средства, которые нам предлагает IDE.