Export translations

Settings

Group
Language
Format	Export for off-line translation Export in native format

{{DISPLAYTITLE:Модули/Вычислитель похожий на Java}}<languages/>
{| class="wikitable"
|-
! Модуль !! Имя !! Версия !! Лицензия !! Источник !! Языки !! Платформы !! Тип !! Автор !! Описание
|-
<section begin=info />
| [[Special:MyLanguage/Modules/JavaLikeCalc|JavaLikeCalc]] || Вычислитель на Java-подобном языке.
| 5.6 || GPL2 || daq_JavaLikeCalc.so || en,uk,ru,de || x86,x86_64,ARM
<section end=info />
| DAQ || Роман Савоченко || Предоставляет вычислитель и движок библиотек, основанные на Java-подобном языке. Пользователь может создавать и модифицировать функции и их библиотеки.
|}

Модуль источника данных предоставляет в OpenSCADA механизм создания функций и их библиотек на Java-подобном языке. Описание функции на Java-подобном языке сводится к обвязке параметров функции алгоритмом. Кроме этого модуль наделён функциями непосредственных вычислений путём создания объектов вычислительных контроллеров.

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

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

Parameters of functions can be freely created, deleted or modified. The current version of the module supports up to 65535 parameters of the function, in the sum with the internal variables. The view of editing functions in the OpenSCADA configurator is shown in Figure 1. [[file:at.png]] The parameter name's rows after the first one treat as help.

[[File:JavaLikeCalc_funcedit_ru.png|center|frame|Рис.1. Вид редактирования функций в конфигураторе OpenSCADA.]]

После любого изменения текста программы или конфигурации параметров, выполняется перекомпиляция программы с уведомлением объектов значений ''TValCfg'', связанных с функцией. Компилятор языка построен с использованием известного генератора грамматики "Bison", который совместим с не менее известной утилитой "Yacc".

Язык использует неявное определение локальных переменных, которое заключается в определении новой переменной в случае присваивания ей значения. Причём тип локальной переменной устанавливается в соответствии с типом присваиваемого значения. Например, выражение '''Qr=Q0*Pi+0.01;''' определит переменную '''Qr''' с типом переменной '''Q0'''.

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

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

В процессе генерации кода, компилятор языка производит оптимизацию по константам и приведение типов констант к требуемому типу. Под оптимизацией констант подразумевается вычисление двух констант и вставка результата в код, в процессе построения байт-кода. Например, выражение '''y=pi*10;''' свернётся в простое присваивание '''y=31.4159;'''. Под приведением типов констант к требуемому типу подразумевается формирования константы в коде, которая исключает приведение типа в процессе исполнения. Например, выражение '''y=x*"10";''', в случае вещественного типа переменной '''x''', преобразуется в '''y=x*10;'''.

Выражения присваивания могут записываться через символ ',', например:
<syntaxhighlight lang="JavaScript">
var1 = 1, var2 = 3, var4 = var1+var2;
for(var1 = 0, var2 = 0, var3 = -1; var1 < 10; var1++, var2++) var3++;
</syntaxhighlight>

Язык поддерживает вызовы внешних и внутренних функций. Имя любой функции, вообще, воспринимается как символ, проверка которого на принадлежность к той или иной категории производится в следующем порядке:
* не начинается с точки:
** ключевые слова (if, else, while, ...);
** параметры-атрибуты данной функции;
** именованные-встроенные постоянные (EVAL, pi, e, ...) и постоянные-объекты (SYS, arguments)
** встроенные функции (sin, cos, ...);
** внутренние, внешние функции, функции объекта и [[Special:MyLanguage/Documents/User_API|узлов объектной модели OpenSCADA]];
** зарегистрированные ранее автоматические переменные;
** глобальные атрибуты параметров DAQ и свойства переменных;
** ключевые слова (in, var);
** создание новой автоматической переменной, имя которой не должно пересекаться с категориями выше, начинаться на цифру и содержать символы операций.
* начинается с точки:
** элементы пути к свойству и функции объекта, имена которых не должны начинаться на цифру и содержать символы операций.

Вызов внешней функции, как и глобального атрибута параметра DAQ, записывается в виде адреса к [[Special:MyLanguage/Documents/User_API|узлу объектной модели OpenSCADA]]: "DAQ.JavaLikeCalc.lib_techApp.klapNotLin". Для статических функций Вы можете следующим образом осуществлять динамическое подключение:
<syntaxhighlight lang="JavaScript">
function klapNotLin = "DAQ.JavaLikeCalc.lib_techApp.klapNotLin";
rez = klapNotLin(prm1, prm2, ..., prmN);</syntaxhighlight>

Для предоставления возможности написания пользовательских процедур управления различными компонентами OpenSCADA, этим модулем предоставляется реализация API прекомпиляции пользовательских процедур отдельных компонентов OpenSCADA на Java-подобном языке. Такими компонентами, например, являются: шаблоны параметров [[Special:MyLanguage/Documents/Program_manual#DAQ|подсистемы "Сбор данных"]] и [[Special:MyLanguage/Modules/VCAEngine|среда визуализации и управления (СВУ)]].

== Java-подобный язык ==
<section begin=LANG />
=== Элементы языка ===
''Ключевые слова:'' '''if''', '''else''', '''while''', '''for''', '''in''', '''break''', '''continue''', '''return''', '''function''', '''using'''.<br/>
''Постоянные:''
* десятичные: цифры '''0-9''' (12, 111, 678);
* восьмеричные: цифры '''0-7''' (012, 011, 076);
* шестнадцатеричные: цифры '''0-9''', буквы '''a-f''' или '''A-F''' (0x12, 0XAB);
* вещественные: '''345.23''', '''2.1e5''', '''3.4E-5''', '''3e6''';
* логические: '''true''', '''false''';
* строковые: '''"hello"''', без перехода на другую строку однако с поддержкой прямой конкатенации строковых констант.
''Типы переменных:''
* целое: '''-2<sup>63</sup>''' ... '''2<sup>63</sup>''', '''EVAL_INT'''(-9223372036854775807);
* вещественное: '''3.4*10<sup>308</sup>''', '''EVAL_REAL'''(-1.79E308);
* логическое: '''false''', '''true''', '''EVAL_BOOL'''(2);
* строка: последовательность символов-байтов (0...255) любой длины, ограниченной объёмом памяти и хранилищем в БД; '''EVAL_STR'''("<EVAL>").
''Встроенные константы:'' '''pi''' = 3.14159265..., '''e''' = 2.71828182..., '''EVAL_BOOL'''(2), '''EVAL_INT'''(-9223372036854775807), '''null''','''EVAL''','''EVAL_REAL'''(-1.79E308), '''EVAL_STR'''("<EVAL>")<br/>
''Глобальные атрибуты параметров DAQ (начиная с подсистемы "DAQ" и в виде '''{Тип модуля DAQ}.{Объект контроллера}.{Параметр}.{Атрибут}''').''<br/>
''Функции и параметры [[Special:MyLanguage/Documents/User_API|объектной модели OpenSCADA]].''

[[file:at.png]] The '''EVAL''' (Error VALue) variants and '''null''' are processed specially in conversion one to one depending on used the base type, that is you are free in use only '''null''' or '''EVAL''' for any cases.

=== Операции языка ===
Операции, поддерживаемые языком, представлены в таблице ниже. Приоритет операций уменьшается сверху вниз. Операции с одинаковым приоритетом входят в одну цветовую группу.
<table border="1" cellspacing="0" bgcolor="#FFFFF0">
<tr align="center" bgcolor="#83D8FF"><td><b>Символ</b></td><td><b>Описание</b></td></tr>
<tr bgcolor="#FFFFC0"><td>()</td><td>Вызов функции.</td></tr>
<tr><td>{}</td><td>Программные блоки.</td></tr>
<tr><td>++</td><td>Инкремент (пост и пре).</td></tr>
<tr><td>--</td><td>Декремент (пост и пре).</td></tr>
<tr bgcolor="#FFFFC0"><td>-</td><td>Унарный минус.</td></tr>
<tr bgcolor="#FFFFC0"><td>!</td><td>Логическое отрицание.</td></tr>
<tr bgcolor="#FFFFC0"><td>~</td><td>Побитовое отрицание.</td></tr>
<tr><td>*</td><td>Умножение.</td></tr>
<tr><td>/</td><td>Деление.</td></tr>
<tr><td>%</td><td>Остаток от целочисленного деления.</td></tr>
<tr bgcolor="#FFFFC0"><td>+</td><td>Сложение</td></tr>
<tr bgcolor="#FFFFC0"><td>-</td><td>Вычитание</td></tr>
<tr><td>&lt;&lt;</td><td>Поразрядный сдвиг влево</td></tr>
<tr><td>&gt;&gt;</td><td>Поразрядный сдвиг вправо</td></tr>
<tr bgcolor="#FFFFC0"><td>&gt;</td><td>Больше</td></tr>
<tr bgcolor="#FFFFC0"><td>&gt;=</td><td>Больше или равно</td></tr>
<tr bgcolor="#FFFFC0"><td>&lt;</td><td>Меньше</td></tr>
<tr bgcolor="#FFFFC0"><td>&lt;=</td><td>Меньше или равно</td></tr>
<tr bgcolor="#FFFFC0"><td>==</td><td>Равно</td></tr>
<tr bgcolor="#FFFFC0"><td>!=</td><td>Не равно</td></tr>
<tr><td>|</td><td>Поразрядное "ИЛИ"</td></tr>
<tr><td>&amp;</td><td>Поразрядное "И"</td></tr>
<tr><td>^</td><td>Поразрядное "Исключающее ИЛИ"</td></tr>
<tr bgcolor="#FFFFC0"><td>&amp;&amp;</td><td>Логический "И"</td></tr>
<tr bgcolor="#FFFFC0"><td>||</td><td>Логический "ИЛИ"</td></tr>
<tr><td>?:</td><td>Условная операция "i=(i<0)?0:i;"</td></tr>
<tr bgcolor="#FFFFC0"><td>=</td><td>Присваивание.</td></tr>
<tr bgcolor="#FFFFC0"><td>+=</td><td>Присваивание со сложением.</td></tr>
<tr bgcolor="#FFFFC0"><td>-=</td><td>Присваивание с вычитанием.</td></tr>
<tr bgcolor="#FFFFC0"><td>*=</td><td>Присваивание с умножением.</td></tr>
<tr bgcolor="#FFFFC0"><td>/=</td><td>Присваивание с делением.</td></tr>
</table>

=== Встроенные функции языка ===
Виртуальной машиной языка предусматривается следующий набор встроенных функций общего назначения:
* ''double max(double x, double x1)'' — максимальное значение из ''x'' и ''x1'';
* ''double min(double x, double x1)'' — минимальное значение из ''x'' и ''x1'';
* ''string typeof(ElTp vl)'' — тип значения ''vl'';
* ''string tr(string base)'' — перевод базового ''base'' сообщения.

Для обеспечения высокой скорости работы в математических вычислениях модуль предоставляет встроенные математические функции, которые вызываются на уровне команд виртуальной машины:
* ''double sin(double x)'' — синус ''x'';
* ''double cos(double x)'' — косинус ''x'';
* ''double tan(double x)'' — тангенс ''x'';
* ''double sinh(double x)'' — синус гиперболический от ''x'';
* ''double cosh(double x)'' — косинус гиперболический от ''x'';
* ''double tanh(double x)'' — тангенс гиперболический от ''x'';
* ''double asin(double x)'' — арксинус от ''x'';
* ''double acos(double x)'' — арккосинус от ''x'';
* ''double atan(double x)'' — арктангенс от ''x'';
* ''double rand(double x)'' — случайное число от 0 до ''x'';
* ''double lg(double x)'' — десятичный логарифм от ''x'';
* ''double ln(double x)'' — натуральный логарифм от ''x'';
* ''double exp(double x)'' — экспонента от ''x'';
* ''double pow(double x, double x1)'' — возведение ''x'' в степень ''x1'';
* ''double sqrt(double x)'' — корень квадратный от ''x'';
* ''double abs(double x)'' — абсолютное значение от ''x'';
* ''double sign(double x)'' — знак числа ''x'';
* ''double ceil(double x)'' — округление числа ''x'' до большего целого;
* ''double floor(double x)'' — округление числа ''x'' до меньшего целого.

=== Операторы языка ===
Общий перечень операторов языка:
* ''var'' — оператор инициализации переменной; указание переменной без присваивания значения резервирует её со значением '''null'''-'''EVAL''', что позволяет осуществлять одноразовую инициализацию сложных типов данных вроде объекта, через прямое сравнение и проверку на ''isEVal()'';
* ''if'' — оператор условия "ЕСЛИ";
* ''else'' — оператор условия "ИНАЧЕ";
* ''while'' — определение цикла "ПОКА";
* ''for'' — определение цикла "ДЛЯ";
* ''in'' — разделитель цикла "ДЛЯ" для перебора свойств объекта;
* ''break'' — прерывание выполнения цикла;
* ''continue'' — продолжить выполнение цикла с начала;
* ''function'' — определение внутренней функции;
* ''using'' — позволяет установить область видимости внешних функций часто используемой библиотеки ('''using Special.FLibSYS;''') для последующего обращения только по имени функции, не имеет эффекта для объектного доступа;
* ''return'' — прерывание функции и возврат результата, который копируется в атрибут с флагом возврата ('''return 123;'''); в середине внутренней функции осуществляется её завершение с указанным результатом;
* ''new'' — создание объекта, реализовано для: общий объект "Object", массив "Array" и регулярные выражения "RegExp";
* ''delete'' — удаление/освобождение объекта или его свойств, при этом: внутренние переменные устанавливаются в '''null'''-'''EVAL''', внешние заменяются пустым объектом, а свойства объекта очищаются.

==== Условные операторы ====
Языком поддерживаются два типа условий. Первый — это операции условия для использования внутри выражения, второй — глобальный, основанный на условных операторах.

Условие внутри выражения строится на операциях '?' и ':'. В качестве примера можно записать следующее практическое выражение:
<syntaxhighlight lang="JavaScript">st_open = (pos >= 100) ? true : false;</syntaxhighlight>
Что читается как — если переменная ''pos'' больше или равна '''100''', то переменной ''st_open'' присваивается значение '''true''', иначе — '''false'''.

Глобальное условие строится на основе условных операторов "if" и "else". В качестве примера можно привести тоже выражение, но записанное другим способом:
<syntaxhighlight lang="JavaScript">if(pos > 100) st_open = true; else st_open = false;</syntaxhighlight>

==== Циклы ====
Поддерживаются три типа циклов: '''while''', '''for''' и '''for-in'''. Синтаксис циклов соответствует языкам программирования: C++, Java и JavaScript.

Цикл '''while''', в общем, записывается следующим образом: '''while({условие}) {тело цикла};'''<br/>
Цикл '''for''' записывается следующим образом: '''for({пре-инициализ};{условие};{пост-вычисление}) {тело цикла};'''<br/>
Цикл '''for-in''' записывается следующим образом: '''for({переменная} in {объект}) {тело цикла};'''<br/>
Где:
:''{условие}'' — выражение, определяющее условие;
:''{тело цикла}'' — тело цикла множественного исполнения;
:''{пре-инициализ}'' — выражение предварительной инициализации переменных цикла;
:''{пост-вычисление}'' — выражение модификации параметров цикла после очередной итерации;
:''{переменная}'' — переменная, которая будет содержать имя свойства объекта при переборе;
:''{объект}'' — объект для которого осуществляется перебор свойств.

==== Внутренние функции ====
Язык поддерживает определение и вызов внутренних функций. Для определения внутренней функции используется ключевое слово "function" и в целом определение имеет синтаксис: '''function {имяФ} ({пер1}, {пер2}, ... {перN}) { {тело функции} }'''. Определение внутренней функции внутри другой недопустимо однако допустим вызов ранее определённой.

Вызов внутренней функции осуществляется в типовой способ, как процедура '''{имяФ}({var1}, {var2}, ... {varN});''' или как функция '''{перРез} = {имяФ}({пер1}, {пер2}, ... {перN});'''. Вызов внутренних функций допустим только после их декларации выше!

Все переменные, определённые в основном теле, недоступны в середине внутренних функций и могут быть переданы через двухсторонние аргументы вызываемой внутренней функции или через аргументы основной функции. Все переменные, определённые в середине внутренней функции, имеют собственную область имён и недоступны из основного тела, или любой другой внутренней функции, и могут быть переданы в основное тело через двухсторонние аргументы, результат вызываемой внутренней функции или через аргументы основной функции. Переменные внутренней функции регистрируются для сохранения/восстановления их контекста после второго и более входа в функцию, т.е. они целиком поддерживают рекурсивные вызовы!

Оператор "return", в середине внутренней функции, осуществляет контролируемое её завершение и помещение указанной переменной, или результата выражения, как результат вызываемой внутренней функции.

Пример типового определения и использования внутренней функции представлен далее:
<syntaxhighlight lang="JavaScript">
function sum(a, b, c, d) { return a + ((b==null)?0:b) + ((c==null)?0:c) + ((d==null)?0:d); }
rez = sum(1, 2);
</syntaxhighlight>

==== Специальные символы строковых переменных ====
Языком предусмотрена поддержка следующих специальных символов строковых переменных:
:"\n" — перевод строки;
:"\t" — символ табуляции;
:"\b" — забой;
:"\f" — перевод страницы;
:"\r" — возврат каретки;
:"\\" — сам символ '\';
:"\041" — символ '!', записанный восьмеричным числом;
:"\x21" — символ '!', записанный шестнадцатеричным числом.
<section end=LANG />

=== Объект ===
<section begin=OBJ />
JavaLikeCalc предоставляет поддержку типа данных объект "Object". Объект представляет собой ассоциативный контейнер свойств и функций. Свойства могут содержать как данные четырёх базовых типов, так и другие объекты. Доступ к свойствам объекта может осуществляться посредством записи имён свойств к объекту ''obj.prop'', через точку, а также посредством заключения имени свойства в квадратные скобки ''obj["prop"]''. Очевидно, что первый механизм статичен, а второй позволяет указывать имя свойства через переменную. Удалить свойство объекта можно директивой "delete". Имя свойства через точку не должно начинаться с цифры и содержать символы операций, иначе, для первой цифры, должен использоваться [[Special:MyLanguage/Documents/User_API|префикс объекта]] — '''SYS.BD.SQLite.db_1s''', или осуществляться запись в квадратных скобках — '''SYS.BD.SQLite["1+s"]''', для символов операций в названии. Чтение неопределённого свойства вернёт '''null'''-'''EVAL'''. Создание объекта осуществляется посредством ключевого слова ''new'': '''varO = new Object()'''. Базовое определение объекта не содержит функций. Операции копирования объекта, на самом деле, делают ссылку на исходный объект. При удалении объекта осуществляется уменьшение счётчика ссылок, а при достижении счётчика нуля, объект удаляется физически.

Разные компоненты OpenSCADA могут доопределять базовый объект особыми свойствами и функциями. Стандартным расширением объекта является массив "Array", который создаётся командой '''varO = new Array(prm1,prm2,prm3,...,prmN)'''. Перечисленные через запятую параметры помещаются в массив в исходном порядке. Если параметр только один то массив инициируется указанным количеством пустых элементов. Особенностью массива является то, что он работает со свойствами, как с индексами и основным механизмом обращения является заключение индекса в квадратные скобки ''arr[1]''. Массив хранит свойства в собственном контейнере одномерного массива. Цифровые свойства массива используются для доступа непосредственно к массиву, а символьные работают как свойства объекта. Детальнее про свойства и функции массива можно прочитать по [[Special:MyLanguage/Documents/User_API#Array|ссылке]].

Объект регулярного выражения "RegExp" создаётся командой '''varO = new RegExp(pat, flg)''', где ''pat'' — шаблон регулярного выражения, а ''flg'' — флаги поиска. Объект работы с регулярными выражениями основан на библиотеке "PCRE". При глобальном поиске устанавливается атрибут объекта "lastIndex", что позволяет продолжить поиск при следующем вызове функции. В случае неудачного поиска атрибут "lastIndex" сбрасывается в ноль. Детальнее про свойства и функции объекта регулярного выражения можно прочитать по [[Special:MyLanguage/Documents/User_API#RegExp|ссылке]].

Для произвольного доступа к аргументам функции предусмотрен объект аргументов, обратиться к которому можно посредством символа "arguments". Этот объект содержит свойство "length" с количеством аргументов у функции и позволяет обратиться к значению аргумента посредством его '''номера''' или '''идентификатора'''. Рассмотрим перебор аргументов по циклу:
<syntaxhighlight lang="JavaScript">
args = new Array();
for(var i = 0; i < arguments.length; i++)
  args[i] = arguments[i];
</syntaxhighlight>

Частичными свойствами объекта обладают и базовые типы. Свойства и функции базовых типов приведены ниже:
* Нулевой тип, функции:
** ''bool isEVal();'' — возвращает "true".

* Логический тип, функции:
** ''bool isEVal(); bool isNaN( );'' — проверяет значение на '''null'''-'''EVAL'''.
** ''string toString();'' — представляет значение в виде строки "true" или "false".
:* ''real toReal();'' — читает логическое значение как вещественное число.
:* ''int toInt();'' — читает логическое значение как целое число.

* Целое и вещественное число:
:; ''Свойства:''
:* ''MAX_VALUE'' — максимальное значение;
:* ''MIN_VALUE'' — минимальное значение;
:* ''NaN'' — недостоверное значение.
:; ''Функции:''
:* ''bool isEVal(); bool isNaN( );'' — проверяет значение на '''null'''-'''EVAL''', и не число для Вещественного.
:* ''string toExponential( int numbs = -1 );'' — возвращает строку отформатированного числа, в экспоненциальной нотации и количеством значащих цифр ''numbs''. Если ''numbs'' отсутствует то цифр будет столько сколько необходимо.
:* ''string toFixed( int numbs = 0, int len = 0, bool sign = false );'' — возвращает строку отформатированного числа в нотации с фиксированной точкой и количеством цифр после десятичной точки ''numbs'', с минимальной длиной ''len'' и обязательным знаком ''sign''. Если ''numbs'' отсутствует то количество цифр после десятичной точки равно нулю.
:* ''string toPrecision( int prec = -1 );'' — возвращает строку отформатированного числа с количеством значащих цифр ''prec''. 
:* ''string toString( int base = 10, int len = -1, bool sign = false );'' — возвращает строку отформатированного числа целого типа с базой представления ''base'' (2-36), с минимальной длиной ''len'' и обязательным знаком ''sign''.
:* ''real toReal();'' — читает целое-вещественное значение как вещественное число.
:* ''int toInt();'' — читает целое-вещественное значение как целое число.

* String: 
:; ''Properties:''
:* ''int length'' — string length. 
:; ''Functions:''
:* ''bool isEVal();'' — checks value to '''null'''-'''EVAL'''.
:* ''bool isNaN( bool whole = true );'' — checks the string to Not A Number and in whole for ''whole''. 
:* ''string charAt( int symb, string type = "" );'' — extracts from the string the symbol ''symb'' for the ''type''. These types of the symbol are supported: ""-ASCII and raw one byte code, UTF-8, UTF-16, UTF-32. In the case of UTF-8, the symbol position ''symb'' is changed to the next symbol position due to length of this symbols type is variable one.
:* ''int charCodeAt( int symb, string type = "" );'' — extracts from the string the symbol code ''symb'' for the ''type''. These types of the symbol are supported: ""-ASCII and raw one byte code, UTF-8, UTF-16, UTF-16LE, UTF-16BE, UTF-32, UTF-32LE, UTF-32BE. In the case of UTF-8, the symbol position ''symb'' is changed to the next symbol position due to length of this symbols type is variable one.
:* ''string concat( string val1, string val2, ... );'' — returns a new string formed by joining the values ''val1'' etc. to the original one.
:* ''int indexOf( string substr, int start = 0 );'' — returns the position of the required string ''substr'' in the original row from the position ''start''. If the initial position is not specified then the search starts from the beginning. If the search string is not found then "-1" is returned.
:* ''int lastIndexOf( string substr, int start = {end} );'' — returns the position of the search string ''substr'' in the original one beginning from the position of ''start'' when searching from the end. If the initial position is not specified then the search begins from the end. If the search string is not found then "-1" is returned.
:* ''int search( string pat, string flg = "" );'' — searches into the string by the pattern ''pat'' and pattern's flags ''flg''. Returns found substring position or "-1" for else.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
var rez = "Java123Script".search("script","i");  // rez = 7</syntaxhighlight>
:* ''int search( RegExp pat );'' — searches into the string by the "RegExp" pattern ''pat''. Returns found substring position or "-1" for else.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
var rez = "Java123Script".search(new RegExp("script","i"));  // rez = 7</syntaxhighlight>
:* ''Array match( string pat, string flg = "" );'' — calls match for the string by the pattern ''pat'' and flags ''flg''. Returns matched substring (0) and subexpressions (>0) array. Sets "index" attribute of the array to the substring position. Sets the "input" attribute to the source string. Sets the "err" attribute to the operation error code.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
var rez = "1 plus 2 plus 3".match("\\d+","g");  // rez = [1], [2], [3]</syntaxhighlight>
:* ''Array match( TRegExp pat );'' — calls match for the string and "RegExp" pattern ''pat''. Returns matched substring (0) and subexpressions (>0) array. Sets the "index" attribute of the array to substring position. Sets the "input" attribute to the source string. Sets the "err" attribute to the operation error code.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
var rez = "1 plus 2 plus 3".match(new RegExp("\\d+","g"));  // rez = [1], [2], [3]</syntaxhighlight>
:* ''string slice( int beg, int end ); string substring( int beg, int end );'' — returns the string extracted from the original one starting from the ''beg'' position and ending before the ''end'' (not included), numbering from zero. If the begin or end is negative, then the count is conducted from the end of the line. If the end is not specified, then the end is the end of the line. For example, the construction '''substring(-2)''' return two last symbols of the string.
:* ''Array split( string sep, int limit = 0 );'' — returns the array of strings separated by ''sep'' with the ''limit'' of the number of elements (0 for no limit).
:* ''Array split( RegExp pat, int limit = 0 );'' — returns the array of strings separated by the RegExp pattern ''pat'' with the ''limit'' of the number of elements (0 for no limit).
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
rez = "1,2, 3 , 4 ,5".split(new RegExp("\\s*,\\s*"));  // rez = [1], [2], [3], [4], [5]</syntaxhighlight>
:* ''string insert( int pos, string substr );'' — inserts the substring ''substr'' into this string's position ''pos''.
:* ''string replace( int pos, int n, string str );'' — replaces substring into the position ''pos'' and length ''n'' to the string ''str''.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
rez = "Javascript".replace(4,3,"67");  // rez = "Java67ipt"</syntaxhighlight>
:* ''string replace( string substr, string str );'' — replaces all the substrings ''substr'' to the string ''str''.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
rez = "123 321".replace("3","55");  // rez = "1255 5521"</syntaxhighlight>
:* ''string replace( RegExp pat, string str );'' — replaces substrings by the pattern ''pat'' to the string ''str''.
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
rez = "value = \"123\"".replace(new RegExp("\"([^\"]*)\"","g"),"``$1''"));  // rez = "value = ``123''"</syntaxhighlight>
:* ''real toReal();'' — converts this string to a real number.
:* ''int toInt( int base = 0 );'' — converts this string to an integer number in accordance with ''base'' (from 2 to 36). If the base is 0, then the prefix will be considered a prefix for determining the base (123-decimal; 0123-octal; 0x123-hex).
:* ''string {parse,parseEnd}( int pos, string sep = ".", int off = {0,{length}}, bool mergeSepSymb = false );'' — gets a token with the number ''pos'' from the string when separated by ''sep'' and from the offset ''off'' (stopping on the next token begin, end for ''parseEnd''). ''mergeSepSymb'' specifies of allowing of merging of the group of identical symbols to one separator. Result offset is returned back to ''off''. ''parseEnd()'' does the same but from the end.
:* ''string parseLine( int pos, int off = 0 );'' — gets a line with the number ''pos'' from the string and from the offset ''off''. Result offset is returned back to ''off'' (stopping on the next token begin).
:* ''string parsePath( int pos, int offCmptbl = 0, int off = 0 );'' — gets a path token with the number ''pos'' from the string and from the offset ''off'' (stopping on the next token begin) or ''offCmtbl'' (stopping on next symbol of the current token end — for compatibility). Result offset is returned back to ''off'' or ''offCmptbl''.
:* ''string parsePathEnd( int pos, int off = {length} );'' — gets a path token with the number ''pos'' from the string end and from the offset ''off'' (stopping on the next token end). Result offset is returned back to ''off''.
:* ''string path2sep( string sep = "." );'' — converts path into this string to separated by ''sep'' string.
:* ''string trim( string cfg = " \n\t\r" );'' — trims the string at the begin and the end for the symbols ''cfg''.
<section end=OBJ />

Для доступа к [[Special:MyLanguage/Documents/User_API|системным объектам(узлам) OpenSCADA]] предусмотрен соответствующий объект, который создаётся путём простого указания точки входа "SYS" корневого объекта OpenSCADA, а затем, через точку, указываются вложенные объекты, в соответствии с иерархией. Например, вызов функции запроса через исходящий транспорт осуществляется следующим образом: '''SYS.Transport.Sockets.out_testModBus.messIO(Special.FLibSYS.strEnc2Bin("15 01 00 00 00 06 01 03 00 00 00 05"));'''.

=== {{Anch|Examples|Примеры программы на этом языке}} ===
Приведём несколько примеров программ на Java-подобном языке:
<syntaxhighlight lang="JavaScript">
//Модель хода исполнительного механизма шарового крана
if(!(st_close && !com) && !(st_open && com))
{
  tmp_up = (pos>0&&pos<100) ? 0 : (tmp_up>0&&lst_com==com) ? tmp_up-1/frq : t_up;
  pos += (tmp_up>0) ? 0 : (100*(com?1:-1))/(t_full*frq);
  pos = (pos>100) ? 100 : (pos<0) ? 0 : pos;
  st_open = (pos>=100) ? true : false;
  st_close = (pos<=0) ? true : false;
  lst_com = com;
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
//Модель клапана
Qr = Q0 + Q0*Kpr*(Pi-1) + 0.01;
Sr = (S_kl1*l_kl1+S_kl2*l_kl2)/100;
Ftmp = (Pi>2*Po) ? Pi*pow(Q0*0.75/Ti,0.5) : (Po>2*Pi) ? Po*pow(Q0*0.75/To,0.5) : pow(abs(Q0*(pow(Pi,2)-pow(Po,2))/Ti),0.5);
Fi -= (Fi-7260*Sr*sign(Pi-Po)*Ftmp)/(0.01*lo*frq);
Po += 0.27*(Fi-Fo)/(So*lo*Q0*frq);
Po = (Po<0) ? 0 : (Po>100) ? 100 : Po;
To += (abs(Fi)*(Ti*pow(Po/Pi,0.02)-To)+(Fwind+1)*(Twind-To)/Riz)/(Ct*So*lo*Qr*frq);
</syntaxhighlight>

== {{Anch|Controller|Объект контроллера и его конфигурация}} ==
Объект контроллера этого модуля, для обеспечения непосредственных вычислений, связывается с функциями из библиотек, построенных с его помощью, или с [[Special:MyLanguage/Documents/DAQ#LogicLev|шаблоном сбора данных]]. В случае с шаблоном сбора данных, добавляется возможность внешнего связывания, с другими параметрами и атрибутами подсистемы "Сбор данных". Для предоставления вычисленных данных в OpenSCADA, в объекте контроллера могут создаваться параметры. Пример вкладки конфигурации объекта контроллера данного типа изображен на рисунке 2.

[[File:JavaLikeCalc_cntr.png|center|frame|Рис.2. Вкладка конфигурации объекта контроллера.]]

From this tab you can set:
* State of the controller object, as follows: status, "Enabled", "Running" and the storage name containing the configuration.
* Identifier, name and description of the controller.
* The state "Enabled" and "Running", in which the controller object must be translated at start up.
* Address of the computational function or [[Special:MyLanguage/Documents/Program_manual#DAQTmpl|the data acquisition template]].
* Policy of scheduling, priority of the data acquisition task and number of iterations in one cycle of calculation task.

Вкладка "Вычисления" объекта контроллера (Рис. 3) содержит параметры и текст программы, непосредственно выполняемой контроллером. Модулем предусмотрена обработка ряда специальных параметров, доступных в программе контроллера:
* ''f_frq'' — частота вычисления программы контроллера, только чтение.
* ''f_start'' — флаг первого выполнения программы контроллера — запуск, только чтение.
* ''f_stop'' — флаг последнего выполнения программы контроллера — останов, только чтение.
* ''this'' — объект данного контроллера.

[[File:JavaLikeCalc_cntr_calc_ru.png|center|frame|Рис.3. Вкладка "Вычисления" объекта контроллера.]]

== Parameter of the controller object and its configuration ==
The module provides only one the "Standard (std)" type of the parameters with the parameters table name "JavaLikePrm_{CntrId}".

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

== {{Anch|FuncsLibs|Библиотеки функций модуля}} ==
Модуль предоставляет механизм для создания библиотек пользовательских функций на Java-подобном языке. Пример вкладки конфигурации библиотеки изображен на рисунке 4. Вкладка содержит базовые поля: доступность, адрес таблицы БД библиотеки (с отслеживанием наличия данных в различных хранилищах и предоставлением последовательного удаления дубликатов), дата и время модификации, идентификатор, имя и описание.
: [[file:at.png]] Объект всё ещё поддерживает определение избыточного адреса хранилища с таблицей, до того момента как вы переименуете её в стандартную форму "'''flb_{ObjID}'''".

[[File:JavaLikeCalc_lib_ru.png|center|frame|Рис.4. Вкладка конфигурации библиотеки.]]

== Пользовательские функции модуля ==
Функция, также как и библиотека, содержит базовую вкладку конфигурации, вкладку формирования программы и параметров функции (Рис.1), а также вкладку исполнения созданной функции.

== API пользовательского программирования ==
Некоторые объекты модуля предоставляют функции пользовательского программирования.
<section begin=API />
[[File:Oscada UserOM JavaLikeCalc_ru.png|right|Объектная модель пользователя модуля JavaLikeCalc.]]
'''Объект "Библиотека функций" (SYS.DAQ.JavaLikeCalc["lib_Lfunc"])'''
* ''ElTp {funcID}(ElTp prm1, ...)'' — вызывает функцию "funcID" библиотеки "Lfunc" с параметрами ''prm{N}''. Возвращает результат вызываемой функции. Префикс "lib_" перед идентификатором библиотеки обязателен!

'''Объект "Пользовательская функция" (SYS.DAQ.JavaLikeCalc["lib_Lfunc"]["func"])'''
* ''ElTp call(ElTp prm1, ...)'' — вызывает функцию "func" библиотеки "Lfunc" с параметрами ''prm{N}''. Возвращает результат вызываемой функции. Префикс "lib_" перед идентификатором библиотеки обязателен!
<section end=API />

== Service commands-functions of the Control Interface ==
Service functions are an interface for accessing OpenSCADA from external systems through the [[Special:MyLanguage/Documents/API#CntrNode|Control Interface]]. This mechanism is the basis of all exchange within OpenSCADA, implemented through weak links and [[Special:MyLanguage/Modules/SelfSystem|OpenSCADA's own exchange protocol]].

<section begin=CntrServComs />
{{CntHdr|Getting for values of the function IO of the controller object}}
REQ: ''<get path="/DAQ/JavaLikeCalc/'''{CNTR}'''/%2fserv%2ffncAttr" />''
* ''CNTR'' — controller object.
RESP: ''<get path="/DAQ/JavaLikeCalc/{CNTR}/%2fserv%2ffncAttr" rez="'''0'''">'''{IOs}'''</get>''
* ''IOs'' — IOs of the function execution context in the tags "a": ''<a id="'''{ID}'''">'''{value}'''</a>''
** ''ID'' — identifier of the IO;
** ''value'' — value of the IO.
<syntaxhighlight lang="XML" style="margin-left: 10pt">
<get path="/DAQ/JavaLikeCalc/testCalc/%2fserv%2ffncAttr" rez="0" user="roman">
  <a id="f_frq">0.1</a>
  <a id="f_start">0</a>
  <a id="f_stop">0</a>
  <a id="this">&lt;TCntrNodeObj path="/sub_DAQ/mod_JavaLikeCalc/cntr_testCalc/"/&gt;</a>
  <a id="offset">100</a>
  <a id="out">50</a>
  <a id="test">1</a>
  <a id="rez" />
  <a id="inFarg">3</a>
</get>
</syntaxhighlight>

{{CntHdr|Setting for values of the function IO of the controller object}}
REQ['''root-DAQ''']: ''<set path="/DAQ/JavaLikeCalc/'''{CNTR}'''/%2fserv%2ffncAttr">'''{IOs}'''</set>''
* ''CNTR'' — controller object;
* ''IOs'' — IOs of the function execution context in the tags "a": ''<a id="'''{ID}'''">'''{value}'''</a>''
** ''ID'' — identifier of the IO;
** ''value'' — value of the IO.
<syntaxhighlight lang="XML" style="margin-left: 10pt">
<set path="/DAQ/JavaLikeCalc/testCalc/%2fserv%2ffncAttr">
  <a id="out">50</a>
  <a id="test">1</a>
</set>
</syntaxhighlight>
<section end=CntrServComs />

== {{Anch|Productivity|Производительность}} ==
Исходный текст процедур на языке этого модуля компилируются в байт-код, который впоследствии вычисляется виртуальной машиной. Байт-код это не машинный код и достичь производительности самой аппаратной архитектуры в виртуальной машине его исполняющего — теоретически нереально, если конечно код этой виртуальной машины не исполняет сам процессор. Т.е. производительность выполнения байт-кода примерно на порядок ниже аппаратной производительности за счёт накладных расходов команд виртуальной машины, разделения многопоточного доступа к данным, прозрачного приведения типов и отсутствия жёсткой типизации, а так-же динамической природы языка и наличия сложных типов "Строка" и "Объект".

'''28.01.2006:'''<br/>
''Description:'' Initial estimation of the productivity of the OpenSCADA virtual machine in example of the expression '''y=x1+x2''', where all the variables are global and in the float-point type.
{| class="wikitable"
|-
! Stage !! Action !! K7_1G-0, us
|-
| 1 || The registers list initialization || 2.3 
|-
| 2 || Entry to the function exec() || 3 
|-
| 3 || The commands coming || 4.4 
|-
| 4 || Reading || 9 
|-
| 5 || Full time || 10.2 
|}

'''17.07.2013:'''<br/>
''Description:'' Justification of the current performance evaluation and optimization. The measurements were made by sampling the minimum time from five calls to 1000 executions of the formula '''a -= b*(a-c)''' and its abbreviations in each call. All the variables are global and in the float-point type.
{| class="wikitable"
|-
! Formula !! Time on AMDGeode-500 (the operation time), us !! Notes
|-
| a -= b*(a-c) || 4.52 (0.74) || 
|-
| a -= b*c || 3.78 (0.72) || 
|-
| a -= b || 3.06 (0.56)
:=> full call: 3.06 (0.49): getValR() = 0.49/2 = 0.245
:=> only write const = 2.57 (0.17)
:=> pass.code = 2.4
|| 
|-
| a = b || 2.5 (1.21)
:!> using the unified TVariant function setVal() and getVal() = 7.6 (2.7 write only) => fix to 5.0 for prevent default setting to the string EVAL.
:=> full call: 2.5 (0.33)
:=> only write const: 2.17 (0.47)
:=> only check for type: 1.7 (0.3)
:=> pass code: 1.4 (0.11)
| Writing to the function IO is longer then reading from the local register for other context call and additional checking for NAN and real modification. 
|-
| Empty || 1.29 || the infrastructure and measurement method utilization time. 
|}

'''24.04.2016:'''<br/>
''Reason:'' Estimate performance of accessing to the low level IO lines on Raspberry Pi GPIO in different ways of the JavaLikeCalc language of OpenSCADA.<br/>
''Conditions:'' [[Special:MyLanguage/Using/Raspberry_Pi|Raspberry Pi 3]], GPIO40, [[Special:MyLanguage/Modules/GPIO|DAQ.GPIO]] (based on the library [http://www.airspayce.com/mikem/bcm2835 bcm2835])
{| class="wikitable"
|-
! Operation !! Result, us
|-
| colspan="2" | ''Sleep. Lag on sleep in 1ms measuring, which mostly limited by the realtime reaction about 100us.'' 
|-
| '''SYS.sleep();''' || +110 
|-
| '''Special.FLibSYS.fnc_tmSleep();''' || +70 
|-
| colspan="2" | ''Sleep. Lag on sleep in 100us measuring, which performs in the measuring cycle.'' 
|-
| '''SYS.sleep();''' || +17
|-
| '''Special.FLibSYS.fnc_tmSleep();''' || +2
|-
| colspan="2" | ''Get a level of the GPIO pin'' 
|-
| From an attribute '''res = GPIO.io.pi.gpio17;''' || 5.4 
|-
| By the static accessing function '''res = DAQ.GPIO.io.pi.fnc_get(17);''' || 1.6 
|-
| By the static accessing function with the link preparation '''function get = "DAQ.GPIO.io.pi.fnc_get"; for(i = 0; i < 10000; i++) res = get(17);''' || 1.7 
|-
| By the dynamic accessing function '''res = SYS.DAQ.GPIO.io.pi.fnc_get.call(17);''' || 80
|-
| By the dynamic accessing function with the end object preparation '''tO = SYS.DAQ.GPIO.io.pi.fnc_get; for(i = 0; i < 1000; i++) res = tO.call(17);''' || 14.3
|-
| colspan="2" | ''Put a level to the GPIO pin'' 
|-
| To an attribute '''GPIO.io.pi.gpio18 = true;''' || 2.1 
|-
| By the static accessing function '''DAQ.GPIO.io.pi.fnc_put(18, true);''' || 1.4 
|-
| By the static accessing function with the link preparation '''function put = "DAQ.GPIO.io.pi.fnc_put"; for(i = 0; i < 10000; i++) put(17, false);''' || 1.5 
|-
| By the dynamic accessing function '''SYS.DAQ.GPIO.io.pi.fnc_put.call(18, true);''' || 79 
|-
| By the dynamic accessing function with the end object preparation '''tO = SYS.DAQ.GPIO.io.pi.fnc_put; for(i = 0; i < 1000; i++) tO.call(18, true);''' || 14.3 
|}

== Ссылки ==
* [[:File:Oscada UserOM JavaLikeCalc_ru.odg|Диаграмма: Объектная модель пользователя модуля JavaLikeCalc.]]

Export translations

Views

Navigation menu

OpenSCADA

OpenSCADA Wiki

Search

Tools

MediaWiki

Personal tools