WIP: Использование репозиториев

.gitignore

@@ -1,2 +1,5 @@
 *.db
 *.ospx
+
+coverage/
+tests.xml

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "language-1c-bsl.linterEntryPoint": "./src/fake-entrypoint.os"
+}

README.md

@@ -1,6 +1,5 @@
 # entity - OneScript Persistence API
 
-
 [![GitHub release](https://img.shields.io/github/release/nixel2007/entity.svg?style=flat-square)](https://github.com/nixel2007/entity/releases)
 [![GitHub license](https://img.shields.io/github/license/nixel2007/entity.svg?style=flat-square)](https://github.com/nixel2007/entity/blob/develop/LICENSE.md)
 
@@ -139,7 +138,7 @@
 // В метод можно передать отбор в виде соответствия, аналогично методу Получить()
 СохраненноеФизЛицо = МенеджерСущностей.ПолучитьОдно(Тип("ФизическоеЛицо"), Отбор);
 
-// Если вызвать метод с параметром не-соответствием, то будет осуществлен поиск по идентификатору сущности.
+// Если вызвать метод "ПолучитьОдно" с параметром не-соответствием, то будет осуществлен поиск по идентификатору сущности.
 Идентификатор = 123;
 СохраненноеФизЛицо = МенеджерСущностей.ПолучитьОдно(Тип("ФизическоеЛицо"), Идентификатор);
 ```
@@ -162,13 +161,45 @@
 ## Удаление сущностей
 
 ```bsl
-
 // Допустим имеется сущность, которую надо удалить.
 
 МенеджерСущностей.Удалить(СущностьФизическоеЛицо);
 
 // После выполнения метода в БД не останется строки с идентификатором, равным идентификатору сущности
+```
+
+## Работа через ХранилищеСущностей
+
+Для упрощения взаимодействия с библиотекой помимо МенеджераСущностей, подразумевающего постоянную передачу *типа сущности*, осуществлять операции над сущностями можно через ХранилищеСущностей. 
+Хранилище сущностей предоставляет тот же базовый интерфейс, что и МенеджерСущности, но не требует передачи типа сущности как параметра.
+
+```bsl
+// Получение хранилища сущностей
+ХранилищеФизЛиц = МенеджерСущностей.ПолучитьХранилищеСущностей(Тип("ФизическоеЛицо"));
+
+// Поиск сущностей
+Идентификатор = 1;
+ФизЛицо = ХранилищеФизЛиц.ПолучитьОдно(Идентификатор);
+
+ФизЛицо.Имя = "Петр";
+
+ХранилищеФизЛиц.Сохранить(ФизЛицо);
+```
+
+### Работа с транзакциями
+
+Методы по работе с транзакциями есть как в Менеджере сущностей, так и в Хранилище сущностей.
+
+Транзакционность поддерживается в рамках экземпляра менеджера сущностей или хранилища сущностей. При необходимости работы с транзакциями с несколькими типами сущностей следует использовать методы работы с транзакциями в Менеджере сущностей и модифицировать сущности через него же.
+
+```bsl
+МенеджерСущностей.НачатьТранзацию();
+
+// Объекты ФизическоеЛицо и СтранаМира из примеров выше:
+МенеджерСущностей.Сохранить(СтранаМира);
+МенеджерСущностей.Сохранить(СохраняемоеФизЛицо);
 
+МенеджерСущностей.ЗафиксироватьТранзакцию();
 ```
 
 ## Система аннотаций для сущностей
@@ -239,7 +270,15 @@
 * Трансляция запросов от прикладной логики к коннекторам
 * Конструирование найденных сущностей по данным, возвращаемым коннекторами
 
-### Коннекторы
+### ХранилищеСущностей
+
+ХранилищеСущностей предоставляет тот же интерфейс по работе с сущностями и транзакциями, но с глобальной привязкой к конкретному типу сущности. Для получения ХранилищаСущностей служит метод `МенеджерСущностей::ПолучитьХранилищеСущностей`.
+
+В отличие от МенеджераСущностей, ХранилищеСущностей не требует передачи в методы параметра "ТипСущности".
+
+Хранилища сущностей и пулы сущностей совпадают в рамках одного типа сущности, типа коннектора и строки соединения. Другими словами, два менеджера сущности, проинициализированные одним и тем же коннектором и строкой соединения, вернут одинаковые хранилища сущностей одного типа.
+
+### Коннекторы (АбстрактныйКоннектор)
 
 Коннектор содержит в себе логику по работе с конкретной СУБД. Например, `КоннекторSQLite` служит для оперирования СУБД SQLite. В зоне ответственности коннектора находятся:
 
@@ -256,6 +295,10 @@
 
 Например, `КоннекторJSON` не умеет работать с транзакциями, однако, он имеет соответствующие методы, выводящие диагностические сообщения при их вызове.
 
+> Важно!
+
+Каждое ХранилищеСущностей и МенеджерСущностей хранят в себе отдельные экземпляры Коннекторов. Тип, строка соединения и параметры коннектора определяются при создании МенеджераСущностей.
+
 ### МодельДанных
 
 Модель данных хранит в себе список всех зарегистрированных классов-сущности в виде ОбъектовМодели
@@ -277,6 +320,16 @@
 
 Помимо мета-информации ОбъектМодели позволяет получать значения колонок таблицы на основании имен полей сущности (и наоборот), вычислять значение идентификатора сущности, выполнять приведение типов и установку значений полей сущности.
 
+### КоннекторSQLite
+
+В состав библиотеки входит референсная реализация интерфейса коннектора в виде коннектора к СУБД SQLite. Реализация базируется на библиотеке [sql](https://github.com/oscript-library/sql).
+
+Коннектор поддерживает все CRUD-операции над сущностями, простой и сложный поиск, работу с транзакциями.
+
+> Внимание!
+
+При использовании in-memory базы данных в моделях больше, чем с одним типом сущности, строка соединения должна выглядеть так: `"FullUri=file::memory:?cache=shared"`
+
 ## Версионирование и обратная совместимость
 
 Библиотека `entity` в целом следует концепции [семантического версионирования](https://semver.org/) со следующими изменениями в правилах нумерации версий:
@@ -294,13 +347,24 @@
 Под контроль и обязательство соблюдения обратной совместимости попадают:
 
 * для Major.Entity:
-  * все публичные методы классов "МенеджерСущности", "МодельДанных", "ОбъектМодели", "ЭлементОтбора", непомеченные как нестабильные (`@unstable`) в описании метода;
-  * значения модулей-перечислений "ТипыКолонок" и "ВидСравнения";
+  * все публичные непомеченные как "нестабильные" (`@unstable`) или "для служебного использования" (`@internal`) методы классов:
+    * [`МенеджерСущности`](src/Классы/МенеджерСущностей.os),
+    * [`ХранилищеСущностей`](src/Классы/ХранилищеСущностей.os),
+    * [`МодельДанных`](src/Классы/МодельДанных.os),
+    * [`ОбъектМодели`](src/Классы/ОбъектМодели.os),
+    * [`ЭлементОтбора`](src/Классы/ЭлементОтбора.os);
+  * значения модулей-перечислений:
+    * [`ТипыКолонок`](src/Модули/ТипыКолонок.os),
+    * [`ВидСравнения`](src/Модули/ВидСравнения.os);
   * состав и параметры аннотаций сущностей;
 * для Major.Connector:
-  * все публичные методы класса "АбстрактныйКоннектор" и их сигнатуры;
-  * все публичные методы классов "МодельДанных", "ОбъектМодели", "ЭлементОтбора", непомеченные как нестабильные 
-  (`@unstable`) в описании метода.
-  * значения модулей-перечислений "ТипыКолонок" и "ВидСравнения";
+  * все публичные методы класса [`АбстрактныйКоннектор`](src/Классы/АбстрактныйКоннектор.os) и их сигнатуры;
+  * все публичные непомеченные как "нестабильные" (`@unstable`) методы классов:
+    * [`МодельДанных`](src/Классы/МодельДанных.os),
+    * [`ОбъектМодели`](src/Классы/ОбъектМодели.os),
+    * [`ЭлементОтбора`](src/Классы/ЭлементОтбора.os);
+  * значения модулей-перечислений:
+    * [`ТипыКолонок`](src/Модули/ТипыКолонок.os),
+    * [`ВидСравнения`](src/Модули/ВидСравнения.os).
 
 > To be continued...

lib.config

@@ -5,6 +5,7 @@
     <class name="МодельДанных" file="src/Классы/МодельДанных.os"/>
     <class name="ОбъектМодели" file="src/Классы/ОбъектМодели.os"/>
     <class name="ЭлементОтбора" file="src/Классы/ЭлементОтбора.os"/>
+    <class name="ХранилищеСущностей" file="src/Классы/ХранилищеСущностей.os"/>
     <module name="ТипыКолонок" file="src/Модули/ТипыКолонок.os"/>
     <module name="ВидСравнения" file="src/Модули/ВидСравнения.os"/>
 </package-def>

packagedef

@@ -3,7 +3,6 @@
 // Полную документацию см. на hub.oscript.io/packaging
 //
 
-
 Описание.Имя("entity")
         .Версия("2.2.0.0")
         .Автор("Nikita Gryzlov")
@@ -18,9 +17,7 @@
         .ЗависитОт("asserts", "1.1.1")
         .ЗависитОт("logos", "1.2.0")
         .ЗависитОт("reflector", "0.6.0")
+        .ЗависитОт("semaphore", "1.0.1")
         .ЗависитОт("sql", "1.1.0.0")
         .ЗависитОт("strings", "0.4.1")
-        //.ЗависитОт("package2", ">=1.1", "<2.0")
-        //.ОпределяетКласс("УправлениеВселенной", "src/universe-mngr.os")
-        //.ОпределяетМодуль("ПолезныеФункции", "src/tools.os")
         ;

src/fake-entrypoint.os

@@ -0,0 +1 @@
+#Использовать ".."