Общая конфигурация плагинов и модулей

Плагины и модули

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

Плагин - это подключаемый jar-файл, хранящийся по умолчанию в jar/plugin. При запуске jar/core/jroboplc.jar выполняется проверка доступных к использованию плагинов, загрузка плагинов и создание модулей.

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

Конфигурационные файлы

Конфигурация проекта может состоять из одного и более yml-файлов, которые хранятся в каталоге проекта. Данный каталог указывается параметром -cfg при запуске приложения. При загрузке сканируется весь каталог (без вложенных каталогов), и загружаются все найденные yml-файлы (кроме скрытых, начинающихся с точки).

Конфигурация записывается в YAML-формате.

Внимание! В YAML отступы имеют значение. Для отступов используется пробел. TAB'ы использовать запрещено.
https://www.youtube.com/watch?v=AXLoRpKnK8U

Общий формат конфигурационного файла:

param1: value
param2: value

plugin.pluginA:
  enable: on
  module.moduleA1
    modprm1: value
    modprm2: value
  module.moduleA2
    modprm1: value
    modprm2: value

plugin.pluginB:
  enable: off
  module.moduleB1
    modprm1: value
    
  tag.values:
    tagname: value
    regex:   value
    
  tag.flags:
    tagname1: none
    tagname2: autosave
    regex:    autosave hidden

Общие настройки для плагинов

plugin.name	название плагина (Правила именования модулей)
enable	разрешение работы плагина
	off - плагин отключен и не загружается при старте приложения
	on - плагин включен

Общие настройки для модулей

module.name	название модуля
enable	разрешение работы модуля
	off - модуль загружается при старте приложения, но не выполняется в runtime
	on - модуль выполняется в runtime
tag.values	переопределение значений тегов, где tagname имя тега модуля, либо regex-выражение
tag.flags	переопределение флагов тегов, где tagname имя тега модуля, либо regex-выражение. Флаги указываются через пробел или запятую:
	none
	autosave - значение тега сохраняется (необходимо использовать модуль tagsaver
	hidden - тег не предназначен для показа удаленным клиентам
	external - тег содержит значение, запрошенное с удаленного сервера
	status - тег может изменять свой статус `GOOD`/`BAD`

Настройка логирования

В файле conf.yml указывается путь (относительно каталога конфигурации) до каталога с лог-файлами.

log.dir:      log