Проектное переопределение#

Предисловие#

Стоит отдельно указать, что помимо проектного переопределения существует так же опция наследования базовых файлов в проектных модулях. Для того что бы выбрать нужный подход, следует понимать что требуется сделать:

Переопределить базовую логику так, что бы изменилось поведение этой логики в любом месте системы.

Например, если вы хотите во всей системе изменить выборку Bs_GoodsAvi#Card, добавить туда проектные атрибуты, изменить разметку выборки итд, и при этом вы хотите видеть эти изменения абсолютно во всех местах где вызывается эта выборка(аналогично с переопределением api и иных файлов).
Дополнить базовую логику работы и использовать её локально, в определенных ситуациях.

Например, если вы хотите дополнить вкладку Bs_GoodsAvi#Card проектными атрибутами, изменить её разметку итд, при этом измененную вкладку вы хотите видеть в каком то конкретном отображении, а в остальной системе оставить вид этой выборки базовым(аналогично с переопределением api и иных файлов).

В зависимости от этого и выбирается сценарий дополнения базовой логики:

Наследование базовой логики
Проектное переопределение

Наследование базовой логики#

Обычное наследование функционала. Реализуется с помощью ключевого слова extends. Определимся только с установленными практиками наименования и расположения наследующих файлов. В остальном работают обычные правила наследования. Рассмотрим пример наследования от Rpl_QueryAvi, и создание нового трейта с измененной логикой.

Расположение наследующего файла#

Наследующий файл в вашем проекте должен располагаться в соответствующем модуле для проектных переопределений. Так же желательно повторять структуру директорий базового модуля. Так, если Rpl_QueryAvi расположен по следующему пути:

ru.bitec.app.rpl.channel.intg.out.Rpl_QueryAvi,

то и наследующий его файл рекомендуется располагать в

ru.bitec.app.<Имя проектного модуля переопределений>.channel.intg.out.<Имя наследующего файла>

Наименование наследующего файла#

При наследовании базового файла в ваш имя наследующего файла рекомендуется формировать следующим образом:

<Имя проектного модуля переопределений>_<Имя базового класса БЕЗ имени базового модуля> Так например, для Rpl_QueryAvi имя наследующего файла будет выглядеть так - <Имя проектного модуля переопределений>_QueryAvi.

Пример наследующего файла#

    package ru.bitec.app.<Имя проектного модуля переопределений>.channel.intg.out

    import ru.bitec.app.rpl.channel.intg.out.Rpl_QueryAvi
    import ru.bitec.gtk.core.AvmFile

    @AvmFile(name = "Файл разметки.avm.xml")
    class <Имя проектного модуля переопределений>_QueryAvi extends Rpl_QueryAvi{

        override def card(): Card = {
            new Card {
                override def meta = this
            }
        }

        trait Card extends Default with super.Card {
            ...
        }

    }

В случае наследования вы получаете возможность дополнить базовую логику, при этом не изменив поведение соответствующих выборок ранее созданных и выведенных в вашей системе.

Проектные переопределения#

Рассмотрим проектное переопределение на примере класса. Проектное переопределение выборок без класса, pkg и lib файлов происходит аналогично.