nixel2007 / entity Goto Github PK

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

public class EntityManager {
  ...
  getRepository(entityType: T): Repository<T>
  ...
}

public class Repository<T> {
  get(id: any): T[],
  get(filter: Map<string, any>): T[],
  get(filter: Filter[]): T[], 
  save(entity: T): void
}

https://postgrespro.ru/docs/postgresql/10/runtime-config-preset

Хотелось бы видеть функционал создания sql запросов в виде конструктора в fluent стиле.
Примеры:
Дано:

• Сущность Автор с полями: Код, Имя, Почта, Роль. Таблица бд называется Авторы.
• Сущность Роль с полями: Код, Имя. Таблица бд называется Роли.

Конструктор = МенеджерСущностей.КонструкторЗапросов();

Выборка = Конструктор.Из("Автор") .Где("Код", 1).Выполнить();
Для Каждого ЭлементВыборки Из Выборка Цикл
    Сообщить(ЭлементВыборки.Имя);
КонецЦикла;

Возможности:

• Из(ИмяСущности) - метод FROM
• Где(ИмяПоля, Значение), Где(Соответствие), Где(Массив) - метод WHERE
• Выбрать(), Выбрать("ИмяСущности.Поле1, ИмяСущности.Поле2, ИмяСущности.Поле3"), Выбрать(Массив) - указание выбора определенных полей из запроса
• Ограничить(НомерЗаписи, КоличествоЗаписей) - метод LIMIT
• ЛевоеСоединение(Условие), ПравоеСоединение(Условие), ВнутренееСоединение(Условие), ВнешнееСоединение(Условие) - методы LEFT JOIN, RIGHT JOIN, INNER JOIN, OUTER JOIN
• Упорядочить(Поле, ПорядокСортировки), Упорядочик(Массив) - метод ORDER BY
• Выполнить() - выполнить запрос

Еще пример (дано такое же):

Выборка = Конструктор
    .Из("Автор")
    .Выбрать("Автор.Имя, Автор.Почта")
    .ЛевоеСоединение("Роль", "Автор.Роль=Роль.Код")
    .Выбрать("Роль.Имя")
    .Упорядочить("Автор.Имя", ПорядокСортировки.Убывание);
    .Выполнить();

Как пример всего этого в других языках: fluentPDO

ОШИБКА - {Модуль lib\entity\src\Классы\ОбъектМодели.os / Ошибка в строке: 357 / Свойство недоступно для записи}

Ругается на Карта https://github.com/nixel2007/entity/blob/master/src/Классы/ОбъектМодели.os#L357

Конфликт с библиотекой https://github.com/sfaqer/collectionos

https://t.me/oscript_library/115519

@nixel2007: Задачу миграции я бы разделил на две больших подзадачи.

2. разработка способа работы с DML в виде объектной модели. Для этого можно завести новый интерфейс для коннектора с методами ДобавитьКолонку, ПереименоватьКолонку, ДобавитьИндекс и такое все. Чтобы можно было во fluent режиме в виде билдера описать изменение схемы, а на выходе получить текст запроса для alter table, который опять таки можно пихнуть в коннектор и выполнить.

С точки зрения разработчика нужно будет класть дто с миграциями в спец папочку и указать в конфиге/коде приложения текущую версию. Всё остальное брал бы на себя энтити.

Над версионированием самой схемы и построения версия-специфичных объектов модели я думал, но кажется это можно отложить на третью очередь разработки, ближе к механизму генерации миграций, но возможно оно понадобится уже на втором шаге, надо побольше покурить.

Расширить типы для колонки:

1. Тип &Колонка(Тип = "Тип") - чтобы в поле можно было положить например Тип("Строка")
2. ДвоичныеДанные &Колонка(Тип = "ДвоичныеДанные ")

Что-то среднее между багом и улучшением.

Две таблицы с FK друг на друга не могут быть последовательно созданы - от СУБД придет эксепшен при накладывании констрэйта FK.
Инициализация должна идти по принципу создания таблиц с типами, без контстрейта FK, а потом через ALTER COLUMN уже проставлять FK.

В ТипыКолонок добавить поддержку типа uuid, типа первичный ключ, автогенерируемый.
Цели:

1. При загрузке данных из 1С чтобы элемент таблицы имел ровно тот же тип и значение ссылки что и в самой 1С.
2. Если первичный источник данных - веб-приложение, и затем данные уходят в 1С - чтобы в 1С можно было создать ссылку с тем же идентификатором что и в самом веб-приложении.

• Массивы
• Структуры
• Таблицы

Через соединение entity формировать сложные sql запросы.
Варианты от @nixel2007:

• Получить коннектор и вызвать у него unstable метод ВыполнитьЗапрос()
• Можно ввести в интерфейс коннектора
• Можно ввести в интерфейс менеджера
• Можно в менеджер добавить ряд популярных запросов
• Объектный флюент-построитель запросов. Например:

Авторы.Выбрать().Где("а = 0").Упорядочить()

Перейти на апт-аддон вместо явного добавления репозитория через командную строку

https://docs.travis-ci.com/user/installing-dependencies/#adding-apt-sources

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

Вынести в отдельную функцию, принимающую в себя текст запроса и необязательное соответствие параметров.
Возвращает ТЗ.

Поскольку в Оскрипт.WEB своя реализация SQLLite, то и коннектор нужен свой.

Внутри файла c сущностью:

{
    "1": {
        "Целое": 1,
        "Дробное": 1.2,
        "Строка": "Строка",
        "БулевоИстина": true,
        "БулевоЛожь": false,
        "Дата": "2018-01-01T00:00:00Z",
        "Время": "1-01-01T10:53:20Z",
        "ДатаВремя": "2018-01-01T10:53:20Z",
        "Ссылка": 2
    }
}

Нужен некий класс, который позволит описать все поля и допустимые типы полей аннотации, а так же "контракты" - обработчики проверки корректности значений полей аннотации.

Инициализация модели аннотированной сущностью должна выполнять проверку заполнения аннотаций и выдавать внятные исключения при ошибках.

На уровне менеджера просто преобразовывать соответствие в массив ЭлементовОтбора

При использовании автоинкремента в идентификаторах и ПодчиненнаяТаблица, сохранение "главной" сущности выкидывает исключение Внешнее исключение (Microsoft.Data.Sqlite.SqliteException): SQLite Error 19: 'FOREIGN KEY constraint failed'.

Пример кода:

//Файл Источник.os
&ПодчиненнаяТаблица(Тип = "Массив", ТипЭлемента = "ОписаниеПараметра")
Перем Параметры Экспорт;

МенеджерСущностей.ДобавитьКлассВМодель(Тип("ОписаниеПараметра"));
МенеджерСущностей.ДобавитьКлассВМодель(Тип("ОписаниеИсточника"));
МенеджерСущностей.Инициализировать();

Параметр = Параметры.Создать();
Параметр.Имя = "Тест";
Параметр.Значение = "фывыфв";
Параметр.Сохранить();

Источник = Источники.Создать();
Источник.Наименование = "Тест";
Источник.Тип = "Файл";
Источник.Параметры.Добавить(Параметр);
Источник.Сохранить();

В коннекторе SQL Lite нет обработки особождения семафора если Запрос.ВыполнитьКоманду() выкидывает исключение:

https://github.com/nixel2007/entity/blob/develop/src/%D0%9A%D0%BB%D0%B0%D1%81%D1%81%D1%8B/%D0%9A%D0%BE%D0%BD%D0%BD%D0%B5%D0%BA%D1%82%D0%BE%D1%80SQLite.os#L175-L189

@nixel2007: Задачу миграции я бы разделил на две больших подзадачи.

1. создание интерфейса/дто миграции с методами Вверх() и необязательным Вниз(), принимающими в себя коннектор/какой-то новый обьект для выполнения миграций и просто выполняющие субд-специфичную строку с текстом запроса миграции (из этого механизма несколько выпадает коннектор json, но с ним отдельно надо думать). Возможно ещё и с какими-то метаданными миграции, типа версии, чтобы можно было указывать миграцию/откат до какой-то версии. Менеджер миграции, который находил бы все дто миграции из определённой папки, сортировал бы их и выполнял нужные. Таблица в бд для учёта миграций - статус, версия, время выполнения.

Вводная

Коннектор состоит из двух реализаций:

• Через sql библиотеку OneScript
• Через ИнформационнаяБаза для OneScript.Web

src\oscript_modules\entity\src\Классы\КоннекторPostgreSQL.os

Процедура Сохранить()
...

Запрос.ВыполнитьКоманду();

Если ОбъектМодели.Идентификатор().ГенерируемоеЗначение Тогда

	Если ЭтоВставкаОбъекта Тогда

...

ЗАМЕНИТЬ НА:

Запрос.ВыполнитьКоманду();

Если ОбъектМодели.Идентификатор().ГенерируемоеЗначение И НЕ ЗначениеЗаполнено(ОбъектМодели.ПолучитьЗначениеИдентификатора(Сущность)) Тогда

	Если ЭтоВставкаОбъекта Тогда

...

• в этой же процедуре убрать:
  Сообщить(ТекстЗапроса);

Возможность через сущность создавать произвольные индексы таблиц. Например:

Дана сущность Автор

&Идентификатор
&ГенерируемоеЗначение
&Колонка(Тип = "Целое")
Перем Код Экспорт;

Перем УчетнаяЗапись Экспорт;

Перем Имя Экспорт;

Перем ЭлектроннаяПочта Экспорт;

&Сущность(ИмяТаблицы = "Авторы")
Процедура ПриСозданииОбъекта(пКод = Неопределено)

	Если ЗначениеЗаполнено(пКод) Тогда
		Объект = МенеджерБазыДанных.АвторыМенеджер.ПолучитьОдно(пКод);	
		Если ЗначениеЗаполнено(Объект) Тогда
			ЗаполнитьЗначенияСвойств(ЭтотОбъект, Объект);
		КонецЕсли;
	КонецЕсли;

КонецПроцедуры

Мы хотим создать произвольный индекс по колонке ЭлектроннаяПочта. Добавляем аннотацию:

&Индекс(Имя = "ПроизвольныйИндекс", Колонки = "ЭлектроннаяПочта")

Подумать над большей потокобезопасностью менеджера сущностей в плане работы с коннектором субд.

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

Дано

РандомнаяСущность.os - сущность, где идентификатор:

...
&Идентификатор
&ГенерируемоеЗначение
&Колонка(Тип = "Целое")
Перем Код Экспорт;
...

Какая-то еще НоваяСущность.os с переменной:

...
&ПодчиненнаяТаблица (Тип = "Массив", ТипЭлемента = "РандомнаяСущность")
Перем Коллекция Экспорт;
...

Добавляем в нее через

НоваяСущность.Коллекция  = Новый Массив;
НоваяСущность.Добавить(РандомнаяСущность);

После записи НоваяСущность и ее повторного чтения имеем:

НоваяСущность.Коллекция[0] // Значение = 1

Вызвать исключение не меняет код возврата выполнения скрипта:

В данном случае будет код возврата = 0.