Рефакторинг и чистка

nixel2007 · Jan 12, 2025 · b4b6e2e · b4b6e2e
1 parent 6fe09c6
commit b4b6e2e
Show file tree

Hide file tree

Showing 9 changed files with 72 additions and 47 deletions.
diff --git a/docs/АбстрактныйКоннектор.md b/docs/АбстрактныйКоннектор.md
@@ -106,8 +106,13 @@
 //
 // Параметры:
 //   ОбъектМодели - ОбъектМодели - Объект, содержащий описание класса-сущности и настроек таблицы БД.
-//   Отбор - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена колонок.
+//   ОпцииПоиска - ОпцииПоиска - Опции поиска. Содержит следующие параметры:
+//     * Отборы - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
+//                         Каждый элемент отбора преобразуется к условию поиска.
+//                         В качестве "ПутьКДанным" указываются имена колонок.
+//     * Сортировки - Массив - Сортировка для результата поиска.
+//                             Каждый элемент массива должен иметь тип "ЭлементПорядка".
+//                             В качестве "ПутьКДанным" указываются имена колонок.
 //
 //  Возвращаемое значение:
 //   Массив - Массив, элементами которого являются "Соответствия". Ключом элемента соответствия является имя колонки,
@@ -123,8 +128,10 @@
 //
 // Параметры:
 //   ОбъектМодели - ОбъектМодели - Объект, содержащий описание класса-сущности и настроек таблицы БД.
-//   Отбор - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена колонок.
+//   ОпцииПоиска - ОпцииПоиска - Опции поиска. Содержит следующие параметры:
+//     * Отборы - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
+//                         Каждый элемент отбора преобразуется к условию поиска.
+//                         В качестве "ПутьКДанным" указываются имена колонок.
 //
 Процедура УдалитьСтрокиВТаблице(ОбъектМодели, Знач Отбор) Экспорт
 ```
diff --git a/docs/КоннекторJSON.md b/docs/КоннекторJSON.md
@@ -106,8 +106,13 @@
 //
 // Параметры:
 //   ОбъектМодели - ОбъектМодели - Объект, содержащий описание класса-сущности и настроек таблицы БД.
-//   Отбор - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена колонок.
+//   ОпцииПоиска - ОпцииПоиска - Опции поиска. Содержит следующие параметры:
+//     * Отборы - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
+//                         Каждый элемент отбора преобразуется к условию поиска.
+//                         В качестве "ПутьКДанным" указываются имена колонок.
+//     * Сортировки - Массив - Сортировка для результата поиска.
+//                             Каждый элемент массива должен иметь тип "ЭлементПорядка".
+//                             В качестве "ПутьКДанным" указываются имена колонок.
 //
 //  Возвращаемое значение:
 //   Массив - Массив, элементами которого являются "Соответствия". Ключом элемента соответствия является имя колонки,
@@ -123,8 +128,10 @@
 //
 // Параметры:
 //   ОбъектМодели - ОбъектМодели - Объект, содержащий описание класса-сущности и настроек таблицы БД.
-//   Отбор - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена колонок.
+//   ОпцииПоиска - ОпцииПоиска - Опции поиска. Содержит следующие параметры:
+//     * Отборы - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
+//                         Каждый элемент отбора преобразуется к условию поиска.
+//                         В качестве "ПутьКДанным" указываются имена колонок.
 //
 Процедура УдалитьСтрокиВТаблице(ОбъектМодели, Знач Отбор) Экспорт
 ```

diff --git a/docs/КоннекторSQLite.md b/docs/КоннекторSQLite.md
@@ -106,8 +106,13 @@
 //
 // Параметры:
 //   ОбъектМодели - ОбъектМодели - Объект, содержащий описание класса-сущности и настроек таблицы БД.
-//   Отбор - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена колонок.
+//   ОпцииПоиска - ОпцииПоиска - Опции поиска. Содержит следующие параметры:
+//     * Отборы - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
+//                         Каждый элемент отбора преобразуется к условию поиска.
+//                         В качестве "ПутьКДанным" указываются имена колонок.
+//     * Сортировки - Массив - Сортировка для результата поиска.
+//                             Каждый элемент массива должен иметь тип "ЭлементПорядка".
+//                             В качестве "ПутьКДанным" указываются имена колонок.
 //
 //  Возвращаемое значение:
 //   Массив - Массив, элементами которого являются "Соответствия". Ключом элемента соответствия является имя колонки,
@@ -123,8 +128,10 @@
 //
 // Параметры:
 //   ОбъектМодели - ОбъектМодели - Объект, содержащий описание класса-сущности и настроек таблицы БД.
-//   Отбор - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена колонок.
+//   ОпцииПоиска - ОпцииПоиска - Опции поиска. Содержит следующие параметры:
+//     * Отборы - Массив - Отбор для поиска. Каждый элемент массива должен иметь тип "ЭлементОтбора".
+//                         Каждый элемент отбора преобразуется к условию поиска.
+//                         В качестве "ПутьКДанным" указываются имена колонок.
 //
 Процедура УдалитьСтрокиВТаблице(ОбъектМодели, Знач Отбор) Экспорт
 ```

diff --git a/docs/МенеджерСущностей.md b/docs/МенеджерСущностей.md
@@ -65,20 +65,17 @@
 //
 // Параметры:
 //   ТипСущности - Тип - Тип искомой сущности.
-//   Отбор - Произвольный - Отбор для поиска.
+//   ОпцииПоиска - Произвольный - Опции поиска.
 //     Если параметр не задан или равен "Неопределено", то возвращаются все найденные сущности указанного типа.
 //     Если параметр имеет тип "Соответствие", то каждое значение соответствия преобразуется к условию поиска
 //      ИмяПоля = ЗначениеПоля, где ИмяПоля - ключ элемента соответствия, ЗначениеПоля - значение элемента соответствия.
-//     Если параметр имеет тип "Массив", то каждое элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена полей.
-//     Если параметр имеет тип "ЭлементОтбора", то элемент отбора преобразуется к условию поиска.
-//       В качестве "ПутьКДанным" указываются имена полей.
+//     Если параметр имеет тип "ОпцииПоиска", то опции передаются как есть.
 //
 //  Возвращаемое значение:
 //   Массив - Массив найденных сущностей. В качестве элементов массива выступают
 //     экземпляры класса с типом, равным переданному "ТипуСущности", с заполненными значениями полей.
 //
-Функция Получить(ТипСущности, Отбор = Неопределено) 
+Функция Получить(ТипСущности, Знач ОпцииПоиска = Неопределено) 
 ```
 
 ### ПолучитьОдно
@@ -88,21 +85,18 @@
 //
 // Параметры:
 //   ТипСущности - Тип - Тип искомой сущности.
-//   Отбор - Произвольный - Отбор для поиска.
+//   ОпцииПоиска - Произвольный - Опции поиска.
 //     Если параметр не задан или равен "Неопределено", то возвращаются все найденные сущности указанного типа.
-//     Если параметр имеет тип "Соответствие", то каждое значение соответствия преобразуется к условию поиска.
+//     Если параметр имеет тип "Соответствие", то каждое значение соответствия преобразуется к условию поиска
 //      ИмяПоля = ЗначениеПоля, где ИмяПоля - ключ элемента соответствия, ЗначениеПоля - значение элемента соответствия.
-//     Если параметр имеет тип "Массив", то каждое элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена полей.
-//     Если параметр имеет тип "ЭлементОтбора", то элемент отбора преобразуется к условию поиска.
-//       В качестве "ПутьКДанным" указываются имена полей.
+//     Если параметр имеет тип "ОпцииПоиска", то опции передаются как есть.
 //     Любой другой тип интерпретируется как поиск по &Идентификатору.
 //
 //  Возвращаемое значение:
 //   Произвольный - Если сущность была найдена, то возвращается экземпляр класса с типом, равным переданному
 //     "ТипуСущности", с заполненными значениями полей. Иначе возвращается "Неопределено".
 //
-Функция ПолучитьОдно(ТипСущности, Знач Отбор = Неопределено) 
+Функция ПолучитьОдно(ТипСущности, Знач ОпцииПоиска = Неопределено) 
 ```
 
 ### Удалить

diff --git a/docs/ХранилищеСущностей.md b/docs/ХранилищеСущностей.md
@@ -36,20 +36,17 @@
 // Осуществляет поиск сущностей типа, привязанного к ХранилищуСущностей, по идентификатору.
 //
 // Параметры:
-//   Отбор - Произвольный - Отбор для поиска.
+//   ОпцииПоиска - Произвольный - Опции поиска.
 //     Если параметр не задан или равен "Неопределено", то возвращаются все найденные сущности указанного типа.
 //     Если параметр имеет тип "Соответствие", то каждое значение соответствия преобразуется к условию поиска
 //      ИмяПоля = ЗначениеПоля, где ИмяПоля - ключ элемента соответствия, ЗначениеПоля - значение элемента соответствия.
-//     Если параметр имеет тип "Массив", то каждое элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена полей.
-//     Если параметр имеет тип "ЭлементОтбора", то элемент отбора преобразуется к условию поиска.
-//       В качестве "ПутьКДанным" указываются имена полей.
+//     Если параметр имеет тип "ОпцииПоиска", то опции передаются как есть.
 //
 //  Возвращаемое значение:
 //   Массив - Массив найденных сущностей. В качестве элементов массива выступают
 //     экземпляры класса с типом, привязанным к ХранилищуСущностей, с заполненными значениями полей.
 //
-Функция Получить(Отбор = Неопределено) Экспорт
+Функция Получить(Знач ОпцииПоиска = Неопределено) Экспорт
 ```
 
 ### ПолучитьОдно
@@ -58,21 +55,18 @@
 // Осуществляет поиск сущности типа, привязанного к ХранилищуСущностей, по идентификатору.
 //
 // Параметры:
-//   Отбор - Произвольный - Отбор для поиска.
+//   ОпцииПоиска - Произвольный - Опции поиска.
 //     Если параметр не задан или равен "Неопределено", то возвращаются все найденные сущности указанного типа.
-//     Если параметр имеет тип "Соответствие", то каждое значение соответствия преобразуется к условию поиска.
+//     Если параметр имеет тип "Соответствие", то каждое значение соответствия преобразуется к условию поиска
 //      ИмяПоля = ЗначениеПоля, где ИмяПоля - ключ элемента соответствия, ЗначениеПоля - значение элемента соответствия.
-//     Если параметр имеет тип "Массив", то каждое элемент массива должен иметь тип "ЭлементОтбора".
-//       Каждый элемент отбора преобразуется к условию поиска. В качестве "ПутьКДанным" указываются имена полей.
-//     Если параметр имеет тип "ЭлементОтбора", то элемент отбора преобразуется к условию поиска.
-//       В качестве "ПутьКДанным" указываются имена полей.
+//     Если параметр имеет тип "ОпцииПоиска", то опции передаются как есть.
 //     Любой другой тип интерпретируется как поиск по &Идентификатору.
 //
 //  Возвращаемое значение:
 //   Произвольный - Если сущность была найдена, то возвращается экземпляр класса с типом, 
 //     привязанным к ХранилищуСущностей, с заполненными значениями полей. Иначе возвращается "Неопределено".
 //
-Функция ПолучитьОдно(Знач Отбор = Неопределено) Экспорт
+Функция ПолучитьОдно(Знач ОпцииПоиска = Неопределено) Экспорт
 ```
 
 ### Удалить

diff --git a/docs/ЭлементОтбора.md b/docs/ЭлементОтбора.md
@@ -1,5 +1,13 @@
 ## ЭлементОтбора
 
+### Поля
+
+| Имя          | Тип          |
+| ------------ | ------------ |
+| ПутьКДанным  | Строка       |
+| ВидСравнения | ВидСравнения |
+| Значение     | Произвольный |
+
 ### ПриСозданииОбъекта
 
 ```bsl

diff --git a/docs/ЭлементПорядка.md b/docs/ЭлементПорядка.md
@@ -0,0 +1,16 @@
+## ЭлементПорядка
+
+### Поля
+
+| Имя          | Тип          |
+| ------------ | ------------ |
+| ПутьКДанным  | Строка       |
+| НаправлениеСортировки | НаправлениеСортировки |
+
+### ПриСозданииОбъекта
+
+```bsl
+
+Процедура ПриСозданииОбъекта(ППутьКДанным, ПНаправлениеСортировки = Неопределено)
+```
+