Wb-rules 2.0: различия между версиями

В обновлённом движке правил wb-rules присутствует ряд важных нововведений, касающихся логики написания сценариев.

= Сценарии =

== Изоляция сценариев ==

Начиная с версии wb-rules 2.0, каждый файл сценария запускается в своём отдельном пространстве имён - '''контексте'''. Таким образом, каждый сценарий может определять

свои функции и глобальные переменные без риска изменить поведение других сценариев.

=== Пример ===

В качестве примера приведём два сценария, одновременно запускаемых в движке правил.

Каждый сценарий определяет глобальные переменные и функции.

}, 1000);

</syntaxhighlight>

=== Примечание ===

Начиная с версии 2.0, в подобной конструкции нет необходимости. Тем не менее, старые сценарии,

использующие эту конструкцию, продолжат работу без изменений в поведении.

=== Обходные пути ===

Если в вашей системе использовалось общее глобальное пространство для хранения общих данных и функций,

есть несколько способов реализации такого поведения:

==== Использование модулей ====

Можно написать модуль для организации взаимодействия. У модулей есть статическое хранилище,

==== Постоянное хранилище ====

ps.myvar = "value"; // это значение доступно для всех пользователей хранилища с именем "my-global-storage"

</syntaxhighlight>

==== Прототип глобального объекта ====

Таким образом, первый способ обращения будет работать только в том случае, если myVar не определена в верхних областях видимости.

== Анонимные правила ==

'''ВНИМАНИЕ:''' начиная с версии 2.0, при объявлении правил с одинаковыми

именами в одном файле теперь будет возвращаться ошибка.

=== Пример ===

});

</syntaxhighlight>

== Управление правилами ==

По умолчанию, все правила включены.

=== Пример ===

// на текущий момент не поддерживается передача аргументов в then

</syntaxhighlight>

== Постоянное хранилище данных ==

Если такое хранилище уже было создано когда-либо ранее, сценарий получит к нему доступ.

== Виртуальные устройства ==

Начиная с версии 2.0, в движке правил wb-rules появилась поддержка подключаемых JS-модулей (похожая по поведению на

аналогичную в Node.js, но с некоторыми особенностями).

== Расположение ==

Поиск модулей происходит по следующим путям (в заданном порядке):

...

</syntaxhighlight>

== Подключение модуля к сценарию ==

и заново выполнен весь код модуля. Если модулю требуется использовать данные, общие для всех файлов сценариев,

для хранения данных следует использовать объект module.static.

== Создание модуля ==

В этом файле будут доступны все стандартные функции wb-rules, а также набор специальных объектов, с помощью  

которого можно реализовать необходимый функционал модуля.

=== Объект exports ===

С помощью объекта exports можно передавать пользовательскому сценарию параметры и методы.

==== Пример ====

};

</syntaxhighlight>

=== Объект module ===

Объект module содержит параметры, относящиеся непосредственно к файлу модуля.

==== module.filename ====

Содержит полный путь до файла ''модуля''. Например, для модуля, сохранённого в /etc/wb-rules-modules/myModule.js:

log(module.filename); // выведет /etc/wb-rules-modules/myModule.js

</syntaxhighlight>

==== module.static ====

Объект, хранящий данные, общие для всех экземпляров данного модуля. Его следует использовать для тех данных,

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

Number of calls: 5

</syntaxhighlight>

=== __filename ===

= Замеры производительности =