---

[I128-2759] Контракты возможностей и конкурентной записи в модуле DP_Irbis64Native

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2759] Контракты возможностей и конкурентной записи в модуле DP_Irbis64Native📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Новые возможности	2026.3	🔘 Завершено	Средний	Ilya Mikhaylenko

Компоненты: ИРБИС 128. Модуль DP_Irbis64Native - Нативный провайдер данных к файлам СУБД ИРБИС 64/64+

Завершено: 24.08.2026 15:19

Ценность для модуля DP_Irbis64Native Модуль DP_Irbis64Native предоставляет явный набор поддерживаемых операций и безопасные контракты чтения, изменения и удаления записей с учётом их версии.

Что меняется

• модуль объявляет доступные возможности провайдера, чтобы вызывающий код мог выбирать только поддерживаемые операции;
• добавляется пакетное чтение записей с единым контрактом результата;
• изменение и удаление выполняются с проверкой ожидаемой версии записи;
• конкурентное изменение обнаруживается до перезаписи данных и возвращается как диагностируемый конфликт;
• повреждённые или неполные данные отклоняются до частичной записи.

Результат Клиенты DP_Irbis64Native могут заранее определить возможности провайдера, эффективно читать наборы записей и выполнять оптимистичные изменения без потери параллельных обновлений.

Совместимость Существующие операции DP_Irbis64Native сохраняются. Новые методы возможностей, пакетного чтения и контроля версии дополняют текущий API.

-

Задача I1282759 расширяет DP*Irbis64Native контрактами конкурентной записи, пакетной обработки и объявления возможностей провайдера. PR предназначен для develop, содержит доставленную зависимость I1282746 и только изменения DP*Irbis64Native.

Куда смотреть:

• В интерфейсе изменений не видно. Техническая точка: API провайдера DP_Irbis64Native, методы GetCapabilities, DeleteRecIfVersion, ReorganizeExcludeDeleted, импорт, сортировка и пакетное обновление записей. Эффект: вызывающий модуль может определить возможности провайдера, выполнять условную запись/удаление и безопасно обрабатывать конкурентные изменения БД. Chrome: не подтверждено, потому что изменение относится к внутреннему провайдеру данных.
• Настройки для сценария: новые настройки не требуются; используются существующие PAR-файлы и параметры нативной БД.
• Help: Help не применим: пользовательский и административный интерфейс не меняются.
• Для PRволны: ветка уже содержит текущий develop и mergedзависимость I1282746; можно переключаться прямо на PRветку.

Изменения по файлам:

modules/DP_Irbis64Native/Tests/Contracts/DatabaseWriteAtomicityContract.php

• Проверяет атомарность записи и откат при ошибках.

modules/DP_Irbis64Native/Tests/Contracts/DatabaseWriteConcurrencyContract.php

• Проверяет конкурентную запись и контроль версий.

modules/DP_Irbis64Native/Tests/Contracts/MstAutoExtendContract.php

• Новый файл. Проверяет автоматическое расширение MST при записи за текущей границей файла.

modules/DP_Irbis64Native/Tests/NativeTestSupport.php

• Добавляет вспомогательные операции для новых контрактных сценариев.

modules/DP*Irbis64Native/*_call/DeleteRecIfVersion.inc

• Новый файл. Удаляет запись только при совпадении ожидаемой версии.

modules/DP*Irbis64Native/*_call/GetCapabilities.inc

• Новый файл. Возвращает поддерживаемые провайдером операции и контракты.

modules/DP*Irbis64Native/*_call/GetTermList.inc

• Усиливает обработку границ и ошибок чтения терминов.

modules/DP*Irbis64Native/*_call/ImportFromFile.inc

• Согласует импорт с блокировками и жизненным циклом БД.

modules/DP*Irbis64Native/*_call/RecIfUpdateAll.inc

• Поддерживает контролируемое пакетное обновление записей.

modules/DP*Irbis64Native/*_call/ReorganizeExcludeDeleted.inc

• Новый файл. Выполняет нативную реорганизацию без физически удалённых записей.

modules/DP*Irbis64Native/*_call/SortMfnByPref.inc

• Делает сортировку MFN устойчивой к граничным данным.

modules/DP*Irbis64Native/*_call/prvGetDbCtx.inc

• Формирует согласованный контекст нативной БД для операций провайдера.

modules/DP_Irbis64Native/api.php

• Публикует новые capability и version-aware контракты.

modules/DP_Irbis64Native/include/IrbisDatabaseLock.php

• Расширяет управление блокировкой БД для конкурентных операций.

modules/DP_Irbis64Native/include/IrbisDbLifecycle.php

• Координирует открытие, запись, реорганизацию и закрытие БД.

modules/DP_Irbis64Native/include/IrbisSpaceNative.php

• Поддерживает новые операции нативного пространства данных.

modules/DP_Irbis64Native/include/MstFile.php

• Добавляет безопасное расширение и контроль границ MST.

modules/DP_Irbis64Native/include/MstSpace.php

• Согласует размещение записей с обновлённым MST-контрактом.

modules/DP_Irbis64Native/include/N01File.php

• Усиливает проверки структуры и границ N01.

modules/DP_Irbis64Native/include/XrfFile.php

• Согласует XRF-ссылки и версии записей при конкурентной записи.

1. Связанные задачи

1.1. 🔗 blocks: I128-2755

1.2. 🔗 blocks: I128-2760

1.3. 🔗 blocks: I128-2753

1.4. 🔗 blocks: I128-2761

1.5. 🔗 blocks: I128-2746