entity 5: пул соединений принадлежит ИсточникДанных, менеджер создается только из него

README.md

@@ -491,7 +491,7 @@
 
 ### МенеджерСущностей
 
-МенеджерСущностей предоставляет публичный интерфейс по чтению, сохранению, удалению данных. МенеджерСущностей создается из ИсточникДанных, который описывает тип *коннектора* к используемой базе данных, строку соединения и размер пула; создание менеджера напрямую по параметрам соединения устарело и сохранено для совместимости. Все операции по изменению данных МенеджерСущностей делегирует Коннектору. В зоне ответственности МенеджераСущностей находятся:
+МенеджерСущностей предоставляет публичный интерфейс по чтению, сохранению, удалению данных. МенеджерСущностей создается из ИсточникДанных, который задает тип *коннектора* к используемой базе данных, строку соединения и размер пула и владеет пулом соединений; других способов создать менеджер нет. Все операции по изменению данных МенеджерСущностей делегирует Коннектору. В зоне ответственности МенеджераСущностей находятся:
 
 * Создание и наполнение МоделиДанных
 * Трансляция запросов от прикладной логики к коннекторам
@@ -501,11 +501,13 @@
 
 ### ХранилищеСущностей
 
-ХранилищеСущностей предоставляет тот же интерфейс по работе с сущностями и транзакциями, но с глобальной привязкой к конкретному типу сущности. Для получения ХранилищаСущностей служит метод `МенеджерСущностей::ПолучитьХранилищеСущностей`.
+ХранилищеСущностей предоставляет тот же интерфейс по работе с сущностями и транзакциями, но с привязкой к конкретному типу сущности. Для получения ХранилищаСущностей служит метод `МенеджерСущностей::ПолучитьХранилищеСущностей`.
 
 В отличие от МенеджераСущностей, ХранилищеСущностей не требует передачи в методы параметра "ТипСущности".
 
-Хранилища сущностей и пулы сущностей совпадают в рамках одного типа сущности, типа коннектора и строки соединения. Другими словами, два менеджера сущности, инициализированные одним и тем же коннектором и строкой соединения, вернут одинаковые хранилища сущностей одного типа.
+Своей логики работы с БД у хранилища нет: оно подставляет свой тип сущности и делегирует операцию менеджеру, которому принадлежит. Поэтому поведение вызова через хранилище и через менеджер совпадает, в том числе для транзакций и прямого доступа к БД.
+
+Хранилища сущностей и пулы сущностей принадлежат менеджеру сущностей: хранилище работает с моделью данных того менеджера, который его создал, и закрывается вместе с ним. Один менеджер на один тип сущности всегда возвращает одно и то же хранилище, а два менеджера, созданные из одного источника данных, возвращают разные хранилища со своими пулами сущностей. Соединения при этом общие: их дает пул источника.
 
 <a id="library-structure-connectors" />
 
@@ -528,7 +530,7 @@
 
 > Важно!
 
-Каждое ХранилищеСущностей и МенеджерСущностей хранят в себе отдельные экземпляры Коннекторов. Тип, строка соединения и параметры коннектора определяются при создании МенеджераСущностей.
+Менеджеры и хранилища сущностей одного источника данных собственных коннекторов не держат: они берут соединения из общего пула этого источника. Тип, строка соединения и параметры коннектора задаются при создании ИсточникаДанных.
 
 <a id="library-structure-data-model" />
 
@@ -578,7 +580,7 @@
 
 Поэтому in-memory базу нельзя сочетать с **нулевым размером пула соединений**: при нулевом размере соединение открывается на операцию и закрывается сразу после нее, то есть между операциями открытых соединений не остается. Следующая операция откроет уже пустую базу и получит `no such table`. Переживет база такой промежуток или нет, зависит от внутреннего пулинга провайдера, то есть воспроизводится через раз.
 
-Для in-memory базы используйте ненулевой размер пула — тогда пул придерживает соединения открытыми и база живет, пока жив менеджер сущностей. Если нулевой размер нужен принципиально, держите отдельное соединение к той же базе на все время работы:
+Для in-memory базы используйте ненулевой размер пула — тогда пул придерживает соединения открытыми и база живет, пока не закрыт источник данных. Если нулевой размер нужен принципиально, держите отдельное соединение к той же базе на все время работы:
 
 ```bsl
 Держатель = Новый КоннекторSQLite;

docs/ИсточникДанных.md

@@ -1,10 +1,15 @@
 ## ИсточникДанных
 
-Описание источника данных: имя, тип коннектора, строка соединения, параметры коннектора
-и размер пула соединений одним объектом.
+Источник данных: имя, тип коннектора, строка соединения, параметры коннектора, размер пула
+и сам пул соединений одним объектом.
 
-Источник соединений не открывает, только описывает их. Тип коннектора проверяется при
-создании: тип без интерфейса `АбстрактныйКоннектор` отвергается с ошибкой.
+Пул создается вместе с источником и общий для всех, кто работает через источник; соединения
+пул открывает при первом обращении. Закрывает пул сам источник: методом `Закрыть()` или по
+завершению потока, в котором источник создан, если автозакрытие не выключено, см.
+`УстановитьАвтоЗакрытие`. Закрытие терминально: закрытый источник соединений больше не выдает,
+поэтому любая операция через него завершается ошибкой. Тип коннектора и размер пула
+проверяются при создании: тип без интерфейса `АбстрактныйКоннектор` и размер, не являющийся
+неотрицательным числом, отвергаются с ошибкой.
 
 ```bsl
 Источник = Новый ИсточникДанных("Основной", Тип("КоннекторPostgreSQL"), СтрокаСоединения, , 20);
@@ -84,3 +89,64 @@
 //
 Функция РазмерПула() Экспорт
 ```
+
+### УстановитьАвтоЗакрытие
+
+```bsl
+// Включает или выключает закрытие источника по завершению потока, в котором он создан.
+//
+// По умолчанию включено. Выключает тот, кто управляет временем жизни источника сам: контейнер
+// приложения или код, создающий источник в одном потоке для работы в других. Тогда источник
+// закрывается только явным Закрыть().
+//
+// Параметры:
+//   Значение - Булево - Истина - закрывать по завершению потока; Ложь - только явным Закрыть().
+//
+Процедура УстановитьАвтоЗакрытие(Знач Значение) Экспорт
+```
+
+### АвтоЗакрытие
+
+```bsl
+// Признак закрытия источника по завершению потока, см. УстановитьАвтоЗакрытие.
+//
+// Возвращаемое значение:
+//   Булево - Истина, если источник закрывается по завершению создавшего его потока.
+//
+Функция АвтоЗакрытие() Экспорт
+```
+
+### Закрыть
+
+```bsl
+// Закрывает пул соединений источника: все его соединения закрываются.
+//
+// Закрытие терминально: после него обращение через источник завершается ошибкой. Повторный
+// вызов ничего не делает. Если закрытие завершилось ошибкой, источник закрытым не считается,
+// и закрытие можно повторить: иначе оставшиеся соединения некому было бы закрыть.
+//
+Процедура Закрыть() Экспорт
+```
+
+### Закрыт
+
+```bsl
+// Источник закрыт, см. Закрыть.
+//
+// Возвращаемое значение:
+//   Булево - Истина после закрытия, явного или по завершению потока.
+//
+Функция Закрыт() Экспорт
+```
+
+### ПулСоединений
+
+```bsl
+// @internal
+// Пул соединений источника. Для закрытого источника завершается ошибкой.
+//
+// Возвращаемое значение:
+//   ПулСоединенийСБД - Пул соединений.
+//
+Функция ПулСоединений() Экспорт
+```

docs/МенеджерСущностей.md

@@ -5,27 +5,18 @@
 ```bsl
 // Конструктор объекта МенеджерСущностей.
 //
-// Менеджер создается из источника данных: из него берутся тип коннектора, строка соединения,
-// параметры коннектора и размер пула. Создание по параметрам соединения устарело и отмечается
-// предупреждением в логе, как и параметры, переданные вместе с источником.
+// Менеджер создается из источника данных и берет соединения из его пула: все менеджеры одного
+// источника делят соединения и транзакции потоков. Параметры соединения задает источник, а его
+// временем жизни управляет тот, кто источник создал.
 //
 // Параметры:
 //   ИсточникДанных - ИсточникДанных - Источник данных, из которого создается менеджер.
-//                  - Тип - Устарел. Тип класса, реализующего интерфейс Коннектор.
-//   УстарелСтрокаСоединения - Строка - Устарел. Строка соединения к БД, задается в источнике данных.
-//   УстарелПараметрыКоннектора - Массив - Устарел. Параметры коннектора, задаются в источнике данных.
-//   УстарелРазмерПулаСоединений - Число - Устарел. Размер пула соединений, задается в источнике данных.
 //
 // Пример:
 //   Источник = Новый ИсточникДанных("Основной", Тип("КоннекторSQLite"), СтрокаСоединения);
 //   МенеджерСущностей = Новый МенеджерСущностей(Источник);
 //
-Процедура ПриСозданииОбъекта(
-	Знач ИсточникДанных,
-	Знач УстарелСтрокаСоединения = "",
-	Знач УстарелПараметрыКоннектора = Неопределено,
-	Знач УстарелРазмерПулаСоединений = 10
-)
+Процедура ПриСозданииОбъекта(Знач ИсточникДанных)
 ```
 
 ### ДобавитьКлассВМодель
@@ -140,8 +131,9 @@
 ### Закрыть
 
 ```bsl
-// Выполняет очистку полную данных библиотеки.
-// Дополнительно посылает всем используемым коннекторам запросы на закрытие соединения.
+// Закрывает хранилища менеджера: после Закрыть() менеджер к работе непригоден. Закрытие
+// терминально - у закрытого менеджера работают только геттеры и повторное закрытие, любой
+// другой метод завершается ошибкой.
 //
 Процедура Закрыть() 
 ```
@@ -210,11 +202,29 @@
 Функция ВычислитьСКоннектором(Знач Алгоритм, Знач Контекст = Неопределено, Знач Объект = Неопределено) 
 ```
 
+### ИсточникДанных
+
+```bsl
+// Источник данных, из которого создан менеджер.
+//
+// Все обращения менеджера к БД идут через соединения этого источника.
+//
+// Возвращаемое значение:
+//   ИсточникДанных - Источник данных менеджера.
+//
+Функция ИсточникДанных() Экспорт
+```
+
 ### ПолучитьХранилищеСущностей
 
 ```bsl
 // Получает ХранилищеСущностей, привязанное к переданному типу сущности.
 //
+// Хранилище создается при первом обращении и живет до закрытия менеджера: на один тип сущности
+// менеджер всегда выдает одно и то же хранилище. Обращение к закрытому менеджеру завершается
+// ошибкой, как и обращение за типом, не зарегистрированным в модели: такой тип можно
+// зарегистрировать и получить хранилище снова.
+//
 // Параметры:
 //   ТипСущности - Тип - Тип сущности, зарегистрированный в Модели
 //

docs/МодельДанных.md

@@ -28,10 +28,3 @@
 Функция СоздатьОбъектМодели(ТипСущности) Экспорт
 ```
 
-### Очистить
-
-```bsl
-
-Процедура Очистить() Экспорт
-```
-