Extensible Object Script
|
Extensible Object Script | |
|---|---|
|
| |
| Designer | R. Clark, A. Zeneli et. al. |
| Type | Programming Language |
| Licenses | LGPL |
| Initial release |
2002 |
| Current Version | 2.10.2 (06/2021) |
| Platform | EOSRuntime (Java / Platform Independent) |
| Origin |
|
| Paradigm | Imperative Procedural |
| Typing | Dynamic, Weak |
| Influences | Java, ActionScript, JavaScript |
| Filename Extension | .eos |
Extensible Object Script (short "EOS") is the Scripting language used for Systems Based on the Extensible Services / Server for Automation family. Extensible Object Script features Object mixing, caching, lambda expressions and dynamic typing.
Extensible Object Script runs inside the ES/S-A Enviroment (Java-Based) using the he portable script engine EOSRuntime. It is compatble with Java Objects (Objects extending java.lang.Object). As Java-based Language (Heavily dependent on Java-API's and processed by JCC and Apache BCEL) it is theoretically plattform independent, as the runtime can be executed on any Java-capable platform.
Background
ExtensibleObjectScript is a general purpose object-oriented programming and scripting language. It is designed to be simple to learn, easy to use, yet still powerful enough to master complex automation processes. The main goals was combining the convenience of a just-in-time interpreter with the features and reliability of the surrounding Java virtual machine. Its origins trace to ObjectScript developed originally by R. Clark at Texas Instrument until the mid 2000s. Efforts were taken by Netroda Technolgies and A. Zeneli to modernize the language, optimize and modernize the runtime and to introduce new features like headless lambda functions, anonymous JSON deserialization and bundled application loading.
Introduction
Extensible Object Script is a full featured object oriented scripting language, which combines the powerful features of a full featured programming language such as Java with the ease of use of a scripting language. It supports functions (which can be closures), classes, inheritance, synchronization (for multi-threaded programs) and garbage collection. Also, an ObjectScript program can take advantage of exising Java APIs by creating instances of Java classes, calling methods of Java objects, and even implementing Java interfaces or extending Java classes. As the Core of Extensible Services / Server for Automation is java based, Extensible Object Script integrates seamlessly.
Uses
Scripts utilizing EOS are used to create Complex Typed System Assets (CTSA), Create and modify Area Service Controllers (ASXC) and to create user programs, like recurring tasks, automation routines and similar.
Integrated Types
| Name | Example | Description | Information |
|---|---|---|---|
| DiscreteNumber | 25 | A signed integer number up to 64 bits precision | Stores discrete numbers with exact precision and no decimal point, ranges from -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807 (inclusive) |
| FloatNumber | 4512.25 | A signed floating point number up to 64 bits precision | Stores floating decimal numbers with variable inexact precision, on most platforms also known as "Double" (double precision floating point). Ranges from -1.797693134862315E+308 to -2.225073858507201E-308 |
| Boolean | true | A boolean type, ie. true or false | Stores the two boolean states true and false |
| String | "Hello World" | A string of arbitrary length as set of chars combined creating text | Stores a String of arbitrary length. A string is immutable, but supports read-only array like access using the [] and [..] operators. The length() method returns the length of the string. |
| Array | ["Test",4,65.3,false] | An array of arbitrary length, whose members can be of arbitrary type | Stores Arrays of arbitrary type (and don't have to be of the same type). The length() method returns the current length of the array. An array will automatically grow to accomodate the n'th element. indices start at 0. |
| Object | new PersonDetail() | A Object of any type | In Object Script, everything (event the primitive types) are Objects. |
It is worth noting that, everything is just an object. The literal number 1 is an object, the statement (3 + "c") evaluates to an object. All objects define a getType() method, which returns the type of the object (which itself is an enumerative object.)
Arrays can be declared with the Array constructor, or with the more compact square bracket syntax: [1,2,3]. Arrays can be accessed using the [] or [..] operators, such as arr[0] which will evaluate to the first element in the array, or arr[0..5] which will return the sub-array containing the 0'th throughout 5'th (inclusive) elements of the array.
Examples
// A Simple While-Loop
var a = 0;
while(true)
{
a++;
if( a > 5 )
break;
else
continue;
a = 10; // this line is never evaluated
}
// Two For-Loops var arr = []; for( var i=0; i<10; i++ ) arr[i] = i; var sum = 0; for( var item : arr ) sum += item;
// Simple Recursion
function fib(n)
{
if( n == 0 )
throw new Exception("Invalid Input");
else if( n == 1 )
return 1;
else if( n == 2 )
return 1;
else
return fib(n-1) + fib(n-2);
}
Object-Oriented Examples
// Objects and Object-Mixing
function Color()
{
public function setRGB( r, g, b )
{
// ...
}
}
function Shape()
{
// ...
}
function Square() extends Shape()
{
public function setSize( w, h )
{
// ...
}
}
/* derived class created using mixins:
*/
function ColoredSquare()
{
mixin new Square();
mixin new Color();
}
var coloredSquare = new ColoredSquare();
coloredSquare.setRGB( 0xff, 0xff, 0xff );
coloredSquare.setSize( 25, 50 );
A Example complex program shown below, this snippets creates a Lighting theme for a residential or public building utilizing a Extensible Services / Server for Automation based system.
/*
Created on 09.01.2021
ALSC Setup - Extensible Object Script
----------------------------------------------------------------------------------------
The designated Area's Light Service Controller functions
and allocations.
----------------------------------------------------------------------------------------
Copyright (C), N.P.A.L. 2015, 2021 Netroda Technologies, all rights reserved.
this software can be reproduced, altered shared or distributed according to the terms of
the Netroda Parity Access License (N.P.A.L.)
See http://www.netroda.com/global/en/license/npal for further information
Hint: to work with features and structures provided use the following variables provided
*/
var inp1 = ESS.Services.PTSA.getAssetById("ASES_0F26A000001"); // input1 => mode(on/off/auto)
var highCeiling = ESS.Services.CTSA.getAssetById("CSES_0000P09F0E9A0"); // HIGH_CEILING_LAMP
var dev2 = ESS.Services.CTSA.getAssetById("CSES_0000P09F0EA81");
var dev3 = ESS.Services.CTSA.getAssetById("CSES_0000P09F0EA82");
const var HIGH_CEILING_LAMP = 0;
ALSC.primaryLights.createDevice(highCeiling,HIGH_CEILING_LAMP); // Reference Device 1 (high ceiling lamp)
ALSC.primaryLights.createDevice(dev2,2); // Reference Device 2
ALSC.primaryLights.createDevice(dev3,3); // Reference Device 3
ALSC.primaryLights.addModeEventHandler(
new (function() extends Lambda.ALSCModeEventHandler(){
var timer;
public function onModeChange(e){
debug("Mode Changed");
timer = ESS.Runtime.invokeLater(
new (function() extends EOSFoundation.ESSRunnable(){
public function run(){
debug("Mode Indication...");
debug(ESS.Services.DateTime.now());
var complexObject = ESS.Services.Complex.resolveArea("c0.b0.lv1.a001");
var currentMode = complexObject.lightsService.primaryLights.primaryMode.valueOf();
var modeIndicatorDevice = ESS.Services.PTSA.getAssetById("ASES_0FE00050001");
debug("Curr Mode (ext): " + currentMode);
debug("Curr Mode (int): " + currentMode);
if(currentMode == "ConstantOn"){
modeIndicatorDevice.inp(ContextAuthority,128);
}
else if(currentMode == "ConstantOff"){
modeIndicatorDevice.inp(ContextAuthority,0);
}
else if(currentMode == "Automatic"){
modeIndicatorDevice.inp(ContextAuthority,255);
}
}
})(),0
);
}
})()
);
ALSC.primaryLights.createInput(
inp1,
new (function() extends EOSFoundation.InputEventHandler(){
public function onChange(e){
debug("Changed: Input 1");
}
public function onHigh(e){
debug("High: Input 1, Cycling ALSC Mode...");
// this function is executed asynchronously in a new StackFrame,
// so it might be necessary to reallocate the base ALSC object
var complexObject = ESS.Services.Complex.resolveArea("c0.b0.lv1.a001");
complexObject.lightsService.primaryLights.cycleMode();
}
public function onLow(e){
debug("Low: Input 1");
}
})()
);
ALSC.primaryLights.addTheme(
new (function() extends Lambda.ALSCTheme(){
name = "Visitors";
allowModes = ["ConstantOn","ConstantOff","Automatic"];
public function onLoad(){
}
public function onUnload(newTheme){
debug("Theme \""+name+"\" has been unloaded, new: " + newTheme);
}
public function onManualActivation(){
}
public function onPresency(){
}
public function onModeChange(modeArgument){
}
public function onPanic() {
}
})()
);
ALSC.primaryLights.addTheme(
new (function() extends Lambda.ALSCTheme(){
name = "Cleaning Service";
allowModes = ["ConstantOn","ConstantOff"];
public function onLoad(){
//set the mode without invoking handlers [ changeMode(a,b) a=name b=silent ] because we just changed our theme
//to prevent detrimental effects on the lost theme.
var complexObject = ESS.Services.Complex.resolveArea("c0.b0.lv1.a001");
complexObject.lightsService.primaryLights.changeMode("ConstantOn",true);
debug("Theme \""+name+"\" has been loaded");
evaluate();
}
public function onUnload(newTheme){
debug("Theme \""+name+"\" has been unloaded, new: " + newTheme);
//unload components
if(highCeiling.isPoweredOn()){
highCeiling.requestPowerOffInstant();
}
}
public function onManualActivation(){
}
public function onPresency(){
}
public function onModeChange(modeArgument){
evaluate();
}
public function onPanic(){
}
private function evaluate(){
var complexObject = ESS.Services.Complex.resolveArea("c0.b0.lv1.a001");
var currentMode = complexObject.lightsService.primaryLights.primaryMode.valueOf();
if(currentMode == "ConstantOn"){
if(highCeiling.isPoweredOff()){
highCeiling.requestPowerOnInstant();
}
}
else if(currentMode == "ConstantOff"){
if(highCeiling.isPoweredOn()){
highCeiling.requestPowerOffInstant();
}
}
}
})()
);
