vrack2-core 1.0.4 → 1.0.5

package/README.md

@@ -9,6 +9,14 @@ VRack2 Core
 
 --------
 
+### Последнее обновление 1.0.5
+ - В Container добавлена ошибка `CTR_IGNORE_SERVICE_AUTORELOAD` её можно использовать, когда не хочется что бы после завершения работы сервиса - сервис автоматически перезапускался
+ - В класс `Device` добавлены
+   - Свойство `works: boolean = true` - если `false` - устройство перестает принимать и отправлять данные через порты
+   - Метод `beforeTerminate(){ return }` - может вызываться перед завершением сервиса (зависит от реализации)
+ - Теперь бинд входящего порта осуществляется по другому. Теперь вместо замены `DevicePort.push` ссылка на хендлер складывается в `DevicePort.bind` и уже после этого происходит вызов `DevicePort.bind()` внутри `DevicePort.push`
+  
+
 ### Последнее обновление 1.0.4
 
  - `BasicType` (класс `Rule`) `require()` deprecated - используем `required()`
@@ -17,11 +25,6 @@ VRack2 Core
    - isCode(error: any, code: string) - Проверяет является ли ошибка VRack2 Error и соответсвует ли код переданной ошибке (проверяет vShort и vCode)
    - isError(error: any) - Проверяет - пренадлежит ли объект ошибки CoreError
 
-### Обновление 1.0.3
-
- - Теперь порты `DevicePort` имеют ссылки на устройство своего владельца `Device`
- - Добавлено свойство meta внутри контейнера для хранения дополнительной информации
-
 **Использовать эту документацию имеет смысл только для более глубокого изучения устройства VRack2 или для создания сервиса независимого от VRack2**
 
 -------

package/lib/Container.js

@@ -85,6 +85,7 @@ ErrorManager_1.default.register('Container', 'XR1K10R0OOUC', 'CTR_INCOMPATIBLE_P
 });
 ErrorManager_1.default.register('Container', 'MmVoDOQwaYkx', 'CTR_INCORRECT_BOOSTRAP', 'The required DeviceManager class is not specified correctly', {});
 ErrorManager_1.default.register('Container', 'e090R0MLyb7y', 'CTR_CONF_EXTENDS_PROBLEM', 'Problem with extending service configuration.', {});
+ErrorManager_1.default.register('Container', 'LYC0VA1AWYKU', 'CTR_IGNORE_SERVICE_AUTORELOAD', 'Error that ignores service restart flag', {});
 /**
  * Service Load Class. It loads all devices in the list,
  * establishes connections between them, and performs device startup.
@@ -373,8 +374,9 @@ class Container extends events_1.default {
                     // add structure device input ports
                     this.structure[dconf.id].inputs[subkey] = [];
                     this.structure[dconf.id].ports.push(Object.assign({ port: subkey, direct: 'input' }, pList[subkey]));
+                    // биндимся а не заменяем push для контроля внутри push
                     if (handler in dev)
-                        ndp.push = dev[handler].bind(dev);
+                        ndp.bind = dev[handler].bind(dev);
                 }
             }
             // make output ports

package/lib/service/Device.d.ts

@@ -40,6 +40,12 @@ export default class Device {
      * @example 'vrack.KeyManager'
     */
     type: string;
+    /**
+     * Флаг общей работы
+     * Если флаг === false = все порты перестают принимать или отправлять данные/события
+     *
+    */
+    works: boolean;
     /**
      * Allows access to port management.
     */
@@ -136,6 +142,11 @@ export default class Device {
      * @param data  data for action
     */
     beforeAction(action: string, data: any): boolean;
+    /**
+     * Должен вызываться перед завершением сервиса
+     * Но может не вызываться (зависит от реализации)
+    */
+    beforeTerminate(): void;
     /**
      * Prepare options
      *

package/lib/service/Device.js

@@ -58,6 +58,7 @@ class Device {
         this.id = id;
         this.type = type;
         this.Container = Container;
+        this.works = true;
         this.ports = {
             input: {},
             output: {}
@@ -118,6 +119,11 @@ class Device {
      * @param data  data for action
     */
     beforeAction(action, data) { return true; }
+    /**
+     * Должен вызываться перед завершением сервиса
+     * Но может не вызываться (зависит от реализации)
+    */
+    beforeTerminate() { return; }
     /**
      * Prepare options
      *
@@ -268,7 +274,8 @@ class Device {
     */
     addInputHandler(name, action) {
         name = ImportManager_1.default.camelize('input.' + name);
-        this[name] = action;
+        const a = this;
+        a[name] = action;
     }
     /**
      * Adding a handle for the action
@@ -278,7 +285,8 @@ class Device {
     */
     addActionHandler(name, action) {
         name = ImportManager_1.default.camelize('action.' + name);
-        this[name] = action;
+        const a = this;
+        a[name] = action;
     }
     /**
      * Informs the rack that the unit cannot continue to operate.

package/lib/service/DevicePort.d.ts

@@ -18,6 +18,7 @@ export default class DevicePort {
     required: boolean;
     /**  Ссылка на устройсто владельца */
     Device: Device;
+    bind: ((data: any) => {}) | null;
     /**
      * Список слушателей порта
      * Используется для захвата порта. Если какие либо данные будут проброшены

package/lib/service/DevicePort.js

@@ -18,6 +18,7 @@ class DevicePort {
         this.connected = false;
         /** Port connection list. One port can have multiple connections */
         this.connections = [];
+        this.bind = null;
         /**
          * Список слушателей порта
          * Используется для захвата порта. Если какие либо данные будут проброшены
@@ -40,6 +41,10 @@ class DevicePort {
      * Calling the incoming port when calling a connection
     */
     push(data) {
+        if (!this.Device.works)
+            return;
+        if (this.bind !== null)
+            return this.bind(data);
         // Если у нас есть слушатели порта
         // Передаем им данные и пересоздаем Map
         if (this.listens.size) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vrack2-core",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Фреймворк для создания событийно-ориентированных сервисов на JavaScript/TypeScript",
   "main": "./lib/index",
   "scripts": {},

package/src/Container.ts

@@ -107,6 +107,9 @@ ErrorManager.register('Container', 'XR1K10R0OOUC', 'CTR_INCOMPATIBLE_PORTS', 'In
 ErrorManager.register('Container', 'MmVoDOQwaYkx', 'CTR_INCORRECT_BOOSTRAP', 'The required DeviceManager class is not specified correctly', {})
 ErrorManager.register('Container', 'e090R0MLyb7y', 'CTR_CONF_EXTENDS_PROBLEM', 'Problem with extending service configuration.', {})
 
+ErrorManager.register('Container', 'LYC0VA1AWYKU', 'CTR_IGNORE_SERVICE_AUTORELOAD', 'Error that ignores service restart flag', {})
+
+
 
 /**
  * Contains the structure of the service
@@ -474,7 +477,9 @@ export default class Container extends EventEmitter {
                 this.structure[dconf.id].ports.push(
                     Object.assign({ port: subkey, direct: 'input' }, pList[subkey])
                 )
-                if (handler in dev) ndp.push = dev[handler].bind(dev)
+                
+                // биндимся а не заменяем push для контроля внутри push
+                if (handler in dev) ndp.bind = dev[handler].bind(dev)
             }
         }
 

package/src/service/Device.ts

@@ -54,6 +54,13 @@ export default class Device {
     */
     type: string;
 
+    /**
+     * Флаг общей работы
+     * Если флаг === false = все порты перестают принимать или отправлять данные/события
+     * 
+    */
+    works: boolean
+
     /**
      * Allows access to port management. 
     */
@@ -83,6 +90,7 @@ export default class Device {
         this.id = id
         this.type = type
         this.Container = Container
+        this.works = true
         this.ports = {
             input: {},
             output: {}
@@ -165,6 +173,12 @@ export default class Device {
      * @param data  data for action
     */
     beforeAction(action: string, data: any) { return true }
+    
+    /**
+     * Должен вызываться перед завершением сервиса
+     * Но может не вызываться (зависит от реализации)
+    */
+    beforeTerminate(){ return }
 
     /**
      * Prepare options 
@@ -330,7 +344,8 @@ export default class Device {
     */
     addInputHandler(name: string, action: (data: any) => any) {
         name = ImportManager.camelize('input.' + name)
-        this[name as keyof Device] = action
+        const a = this as any
+        a[name] = action
     }
 
     /**
@@ -341,7 +356,8 @@ export default class Device {
     */
     addActionHandler(name: string, action: (data: any) => any) {
         name = ImportManager.camelize('action.' + name)
-        this[name as keyof Device] = action
+        const a = this as any
+        a[name] = action
     }
 
     /**
@@ -353,4 +369,5 @@ export default class Device {
     terminate(error: Error, action: string) {
         return this.makeEvent('device.terminate', action, error, [])
     }
+    
 }

package/src/service/DevicePort.ts

@@ -30,6 +30,8 @@ export default class DevicePort {
     /**  Ссылка на устройсто владельца */
     Device: Device
 
+    bind: ((data: any) => {}) | null = null;
+
     /**
      * Список слушателей порта
      * Используется для захвата порта. Если какие либо данные будут проброшены 
@@ -56,6 +58,9 @@ export default class DevicePort {
      * Calling the incoming port when calling a connection 
     */
     push(data: any): any { 
+        if (!this.Device.works) return
+        if (this.bind !== null) return this.bind(data)
+
         // Если у нас есть слушатели порта
         // Передаем им данные и пересоздаем Map
         if (this.listens.size) {