Added interface wrapper examples

Author: tshemsedinov

interfaceWrapper/en/README.md

@@ -0,0 +1,12 @@
+## Description
+
+* `framework.js` - small piece of the framework, just to demonstrate wrapper
+* `application.js` - small piece of the application for wrapper demonstration
+
+## How to execute
+
+From the command line, type: `node application` then `node framework`, compare
+output, read code in `framework.js` and `application.js`, try to understand
+how wrapper works for setTimeout
+
+## Tasks

interfaceWrapper/en/application.js

@@ -0,0 +1,10 @@
+// Print from the global context of application module
+console.log('From application global context');
+
+// Declare function for timer event
+function timerEvent() {
+  console.log('From application timer event');
+}
+
+// Set function to timer event for 1sec
+setTimeout(timerEvent, 1000);

interfaceWrapper/en/framework.js

@@ -0,0 +1,38 @@
+// Example: function wrapper in sandboxed context
+
+var fs = require('fs'),
+    vm = require('vm');
+
+// Declare dictionary to convert it into sandboxed context
+var context = {
+  module: {},
+  console: console,
+  // Declare wrapper function for setTimeout
+  setTimeout: function(callback, timeout) {
+    // Add some behaviour for setTimeout
+    console.log(
+      'Call: setTimeout, ' +
+      'callback function: ' + callback.name + ', ' +
+      'timeout: ' + timeout
+    );
+    setTimeout(function() {
+      // Add some behaviour on event
+      console.log('Event: setTimeout, before callback');
+      // Call of orignal user-defined callback, passed to wrapper
+      callback();
+      console.log('Event: setTimeout, after callback');
+    }, timeout);
+  }
+};
+
+// Convert collection into sandboxed context
+context.global = context;
+var sandbox = vm.createContext(context);
+
+// Read an application source code from the file
+var fileName = './application.js';
+fs.readFile(fileName, function(err, src) {
+  // Run an application in sandboxed context
+  var script = vm.createScript(src, fileName);
+  script.runInNewContext(sandbox);
+});

interfaceWrapper/ru/README.md

@@ -0,0 +1,12 @@
+## Описание
+
+* `framework.js` - кусочек фреймворка, демонстрирующий обертку (wrapper)
+* `application.js` - часть приложения для демонстрации обертки
+
+## Запуск
+
+Из командной строки пишем `node application`, а потом `node framework`,
+сравниваем вывод, смотрим код `framework.js` и `application.js`, понимаем
+как работает обертка вокруг setTimeout
+
+## Задания

interfaceWrapper/ru/application.js

@@ -0,0 +1,10 @@
+// Вывод из глобального контекста модуля
+console.log('From application global context');
+
+// Объявляем функцию для события таймера
+function timerEvent() {
+  console.log('From application timer event');
+}
+
+// Устанавливаем функцию на таймер
+setTimeout(timerEvent, 1000);

interfaceWrapper/ru/framework.js

@@ -0,0 +1,38 @@
+// Пример оборачивания функции в песочнице
+
+var fs = require('fs'),
+    vm = require('vm');
+
+// Объявляем хеш из которого сделаем контекст-песочницу
+var context = {
+  module: {},
+  console: console,
+  // Оборачиваем функцию setTimeout в песочнице
+  setTimeout: function(callback, timeout) {
+    // Добавляем поведение при вызове setTimeout
+    console.log(
+      'Call: setTimeout, ' +
+      'callback function: ' + callback.name + ', ' +
+      'timeout: ' + timeout
+    );
+    setTimeout(function() {
+      // Добавляем поведение при срабатывании таймера
+      console.log('Event: setTimeout, before callback');
+      // Вызываем функцию пользователя на событии таймера
+      callback();
+      console.log('Event: setTimeout, after callback');
+    }, timeout);
+  }
+};
+
+// Преобразовываем хеш в контекст
+context.global = context;
+var sandbox = vm.createContext(context);
+
+// Читаем исходный код приложения из файла
+var fileName = './application.js';
+fs.readFile(fileName, function(err, src) {
+  // Запускаем код приложения в песочнице
+  var script = vm.createScript(src, fileName);
+  script.runInNewContext(sandbox);
+});

sandboxedModule/ru/framework.js

@@ -7,7 +7,7 @@
 var fs = require('fs'),
     vm = require('vm');
 
-// Чоздаем контекст-песочницу, которая станет глобальным контекстом приложения
+// Создаем контекст-песочницу, которая станет глобальным контекстом приложения
 var context = { module: {}, console: console };
 context.global = context;
 var sandbox = vm.createContext(context);