Потокобезопасный индекс параметров, версия 0.12.1

[sfaqer]

Проблема

ИндексЗначений.ИндексСформирован нигде не становился Истина, поэтому каждый вызов МенеджерПараметров.Параметр() заново строил весь плоский индекс в общее поле экземпляра. При параллельных вызовах из фоновых заданий потоки подменяли друг другу ИндексКоллекция и одновременно писали в один Соответствие (.NET Dictionary). Результат: InvalidOperationException, ArgumentException, NullReferenceException, пустые или чужие значения. Заодно это была проблема производительности: на каждое чтение перестраивался весь индекс, включая все переменные окружения у ENV-провайдера без префикса.

Решение

• ИндексЗначений.Коллекция() строит индекс в локальную карту и публикует его одним присваиванием поля. После публикации карта не меняется, поэтому Значение() и ПолучитьИндекс() читают её без блокировок. Отдельного флага нет: всё состояние хранится в одной ссылке (Неопределено значит «коллекция не установлена»), так что ни флаг, ни порядок его записи не нужны.
• МенеджерПараметров.Прочитать() больше не вызывает ИндексПараметров.Очистить(). Новый индекс строится полностью и только потом подменяет прежний, поэтому Параметр() можно вызывать параллельно с Прочитать(). Параллельные вызовы Прочитать() между собой не поддерживаются, это задокументировано.
• Исключение «Коллекция индекса не установлена» раньше не доходило до вызывающего: Новый ИнформацияОбОшибке(...) в 2.x падает с «Конструктор не найден». Исправлено.
• Документация: изменения соответствия из ПрочитанныеПараметры() не попадают в Параметр() до повторного Прочитать(). До 4103624 индекс тоже строился один раз при чтении, а видимость изменений появилась случайно вместе с пересборкой на каждый вызов.

Индекс строится один раз в Прочитать(), даже если Параметр() потом не вызывается.

Тесты

Новый файл tests/ИндексЗначений_test.os:

• индекс строится один раз: ПолучитьИндекс() возвращает тот же объект, а после Коллекция()/Прочитать() — новый;
• после Очистить() выдаётся корректное исключение;
• 32 фоновых задания × 200 вызовов Параметр(): ни одного исключения, все значения верные;
• то же параллельно с 50 вызовами Прочитать().

Без исправления падают все 5 тестов: в параллельных ошибки в 32 из 32 заданий. С исправлением на 2.3.0-dev и 2.2.0 все unit-тесты и BDD (14/14) проходят. Исключение — 2 теста Vault, которые так же падают на master локально: тестовый сервер на winow не стартует.

Вне рамок PR

• Прочитать() по-прежнему очищает и заполняет ПрочитанныеПараметры на месте.
• Коллекции, которые возвращает Параметр(), общие с исходными данными, и ОбъединитьПрочитанныеПараметры при нескольких провайдерах дописывает данные прямо в них.

🤖 Generated with Claude Code

[coveralls]

coverage: 81.484% (+0.3%) from 81.167% — fix/thread-safe-index into master

[sonar-openbsl-ru-qa-bot]

Quality Gate passed

Issues

• 0 New Issues
• 1 Fixed Issue
• 0 Accepted Issues

Measures

• 0 Security Hotspots
• 100.00% Coverage (81.50% Estimated after merge)
• 0.00% Duplicated Code (7.60% Estimated after merge)

Project ID: configor

View in SonarQube